/**
 * AI element — reaching machine intelligence.
 *
 * Physics: inference · prompts · embeddings · agents.
 * Drivers: `mock` (dev) · `anthropic` · `openai-compatible` · `bedrock` ·
 * `vertex`. No production default — prod must declare.
 *
 * Prompts are versioned artifacts with validated output shapes and eval sets
 * (`oke eval` gates CI). Agents' tools are the app's own flows (gates apply).
 * PII fields cannot reach a third-party model without explicit `allowPii`.
 * Nondeterministic ⇒ journaling forced for Console, auto-cache disabled.
 * Replay belongs to a durable run's journal, not this process-wide log.
 * @module
 */

export { ai, listAiDecls, resetAiDecls } from "./ai/declare.ts";
export type {
  AiAgentDecl,
  AiBooleanQuestion,
  AiChoiceQuestion,
  AiDeciderDecl,
  AiDecisionDecl,
  AiDecisionOptions,
  AiDecisionQuestion,
  AiScoreQuestion,
  AiAgentApprovalDecl,
  AiAgentOptions,
  AiAgentToolOptions,
  AiToolApproval,
  AiBudgetDecl,
  AiEmbedDecl,
  AiEmbedOptions,
  AiMcpServerAuthOptions,
  AiMcpServerDecl,
  AiMcpServerOptions,
  AiMcpToolRef,
  AiModelDecl,
  AiModelOptions,
  AiPromptDecl,
  AiPromptOptions,
  AiTimeout,
} from "./ai/declare.ts";

export {
  aiHttpError,
  isRetryableAiError,
  mergeAskAbortSignal,
  outExpectsVia,
  resolveTimeoutMs,
} from "./ai/errors.ts";
export type { AiErrorFields } from "./ai/errors.ts";

export type { AgentEventEmit, AgUiEvent, AgUiUsage } from "./ai/events.ts";
export { createEventQueue, emitAssistantText } from "./ai/events.ts";

export {
  createAiRuntime,
  parsePromptRef,
  AiSchemaValidationError,
  promptContentFromInput,
  AI_DEFAULT_MAX_STEPS,
  AI_OBSERVABILITY_LIMIT,
} from "./ai/runtime.ts";
export type {
  AgentDenial,
  AgentRunRecord,
  AgentStopReason,
  AgentToolEffect,
  AgentToolStep,
  AiAgentRunOptions,
  AiAskOptions,
  AiAskOutcome,
  AiFallbackAttempt,
  AiJournalEntry,
  AiRuntime,
  AiSchemaMismatch,
  AiStreamOptions,
  CreateAiRuntimeOptions,
} from "./ai/runtime.ts";

export { createMcpClient } from "./ai/mcp-client.ts";
export type { CreateMcpClientOptions, McpClient, McpResolvedTool } from "./ai/mcp-client.ts";
export { createMockMcpTransport } from "./ai/mcp-mock.ts";
export type { CreateMockMcpTransportOptions, MockMcpTool } from "./ai/mcp-mock.ts";
export {
  MCP_CLIENT_PROTOCOL_VERSION,
  MCP_LEGACY_PROTOCOL_VERSION,
  mcpClientMeta,
  parseJsonRpcResponse,
} from "./ai/mcp-protocol.ts";
export type { McpListedTool, McpProtocolEra } from "./ai/mcp-protocol.ts";

export { AI_RATE_PRESETS, aiRateGate, createAiRateGates } from "./ai/rate.ts";
export type { AiRatePreset } from "./ai/rate.ts";

export { assertAllowPiiForAsk, AiPiiBuildError, type PiiAskCheckInput } from "./ai/pii.ts";

export {
  AI_NATIVE_DRIVER_IDS,
  AI_OPENAI_COMPAT_PROVIDERS,
  AI_PROVIDER_BASEURL_EXEMPT,
  formatAiProviderTier2Warn,
  getAiProviderEntry,
  resolveAiModelBaseUrl,
  unknownAiProviderBaseUrlError,
} from "./ai/providers.ts";
export type {
  AiProviderEntry,
  AiProviderTier,
  ResolveAiModelBaseUrlInput,
  ResolveAiModelBaseUrlResult,
} from "./ai/providers.ts";

export {
  runPromptEvals,
  parseEvalJsonl,
  type EvalCase,
  type EvalCaseResult,
  type EvalSuiteResult,
  type RunPromptEvalsOptions,
} from "./ai/eval.ts";