@od-oneapp/ai-platform 0.1.0

package/dist/catalog.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.mjs","names":[],"sources":["../src/catalog.ts"],"sourcesContent":["/**\n * @fileoverview Pattern catalog for the ai-platform package.\n *\n * Machine-readable registry of every public module, pattern, and capability\n * exposed by this package. Designed for both human developers and AI agents\n * to discover what's available and when to use each piece.\n *\n * Import the catalog and search/filter programmatically:\n * ```ts\n * import { PATTERN_CATALOG } from '@od-oneapp/ai-platform/catalog';\n *\n * // Find all RAG-related patterns\n * const ragPatterns = PATTERN_CATALOG.filter(p => p.tags.includes('rag'));\n *\n * // Find patterns for a use case\n * const streaming = PATTERN_CATALOG.filter(p => p.domain === 'streaming');\n * ```\n *\n * @module @od-oneapp/ai-platform/catalog\n */\n\n// ---------------------------------------------------------------------------\n// Schema\n// ---------------------------------------------------------------------------\n\n/** A single entry in the pattern catalog. */\nexport interface CatalogEntry {\n  /** Unique kebab-case identifier. */\n  id: string;\n  /** Human-readable name. */\n  name: string;\n  /** Package subpath export (e.g. `'./agents/triage'`). */\n  module: string;\n  /** Top-level domain grouping. */\n  domain:\n    | 'agents'\n    | 'models'\n    | 'streaming'\n    | 'grounding'\n    | 'tools'\n    | 'sdk'\n    | 'security'\n    | 'governance'\n    | 'observability'\n    | 'hitl'\n    | 'output'\n    | 'prompts'\n    | 'pipelines'\n    | 'caching'\n    | 'shared'\n    | 'integrations'\n    | 'generative-ui';\n  /** One-sentence description of what this module provides. */\n  description: string;\n  /** Searchable tags for filtering. */\n  tags: readonly string[];\n  /** When you should reach for this pattern. */\n  useCase: string;\n}\n\n// ---------------------------------------------------------------------------\n// Catalog\n// ---------------------------------------------------------------------------\n\n/**\n * Complete catalog of public patterns and modules in `@od-oneapp/ai-platform`.\n *\n * Every entry maps to a `package.json` subpath export.\n * Use `domain` or `tags` to filter programmatically.\n */\nexport const PATTERN_CATALOG: readonly CatalogEntry[] = [\n  // ===========================================================================\n  // MODELS\n  // ===========================================================================\n  {\n    id: 'models',\n    name: 'Model Registry',\n    module: './models',\n    domain: 'models',\n    description:\n      'LLM provider integration with model registry, metadata, tier routing, and cost estimation.',\n    tags: ['model', 'registry', 'routing', 'cost'],\n    useCase: 'When you need to select, configure, or route between LLM providers.',\n  },\n\n  // ===========================================================================\n  // AGENTS\n  // ===========================================================================\n  {\n    id: 'agents',\n    name: 'Agent Framework',\n    module: './agents',\n    domain: 'agents',\n    description:\n      'Multi-faceted AI agent framework with core types, routing, coordination, patterns, and workflows.',\n    tags: ['agent', 'orchestration', 'framework'],\n    useCase: 'Top-level import when you need any agent capability.',\n  },\n  {\n    id: 'agents-base',\n    name: 'Agent Base',\n    module: './agents/base',\n    domain: 'agents',\n    description: 'Base agent types, schemas, and default agent implementation.',\n    tags: ['agent', 'base', 'types', 'schemas'],\n    useCase: 'When building a custom agent from scratch or extending base types.',\n  },\n  {\n    id: 'agents-coordinator',\n    name: 'Coordinator Agent',\n    module: './agents/coordinator',\n    domain: 'agents',\n    description:\n      'Multi-agent orchestration with task planning, delegation, and result aggregation.',\n    tags: ['agent', 'coordinator', 'orchestration', 'planning'],\n    useCase: 'When you need a lead agent that plans and delegates work to sub-agents.',\n  },\n  {\n    id: 'agents-swarm',\n    name: 'Swarm Agent',\n    module: './agents/multi/swarm',\n    domain: 'agents',\n    description: 'Agent swarm coordination with parallel task execution and result aggregation.',\n    tags: ['agent', 'swarm', 'parallel', 'multi-agent'],\n    useCase: 'When you need many agents working in parallel on independent tasks.',\n  },\n  {\n    id: 'agents-multi',\n    name: 'Multi-Agent System',\n    module: './agents/multi',\n    domain: 'agents',\n    description: 'Multi-agent coordination, supervision, and state management.',\n    tags: ['agent', 'multi-agent', 'coordination', 'supervision'],\n    useCase: 'When you need agents that communicate, delegate, and share state.',\n  },\n  {\n    id: 'agents-persistence',\n    name: 'Agent Persistence',\n    module: './agents/persistence',\n    domain: 'agents',\n    description:\n      'Durable state management with checkpoint/restore for crash recovery and resumable workflows.',\n    tags: ['agent', 'persistence', 'checkpoint', 'recovery'],\n    useCase: 'When agent state must survive restarts or be resumed later.',\n  },\n  {\n    id: 'agents-control-flow',\n    name: 'Agent Control Flow',\n    module: './agents/control-flow',\n    domain: 'agents',\n    description:\n      'Control patterns for agent execution: abort signals, stops, timeouts, and manual intervention.',\n    tags: ['agent', 'control-flow', 'abort', 'timeout'],\n    useCase: 'When you need to cancel, timeout, or manually intervene in agent execution.',\n  },\n  {\n    id: 'agents-fallback',\n    name: 'Agent Fallback',\n    module: './agents/fallback',\n    domain: 'agents',\n    description: 'Model fallback strategies, circuit breakers, and resilience patterns.',\n    tags: ['agent', 'fallback', 'resilience', 'circuit-breaker'],\n    useCase: 'When you need automatic model failover or rate-limit recovery.',\n  },\n  {\n    id: 'agents-patterns',\n    name: 'Agent Patterns',\n    module: './agents/patterns',\n    domain: 'agents',\n    description: 'Reusable agent architectures like evaluator-optimizer feedback loops.',\n    tags: ['agent', 'patterns', 'evaluator-optimizer', 'feedback'],\n    useCase: 'When you need a documented, reusable agent architecture pattern.',\n  },\n  {\n    id: 'agents-experimental',\n    name: 'Experimental Agents',\n    module: './agents/experimental',\n    domain: 'agents',\n    description: 'AI SDK v6 agent patterns with prepareStep hook and phased tools (unstable).',\n    tags: ['agent', 'experimental', 'prepareStep'],\n    useCase: 'When you want to test new agent capabilities before they stabilize.',\n  },\n  {\n    id: 'agents-observability',\n    name: 'Agent Observability',\n    module: './agents/observability',\n    domain: 'agents',\n    description:\n      'Step-by-step execution tracing and debugging for agents with decision logs and metrics.',\n    tags: ['agent', 'observability', 'tracing', 'debugging'],\n    useCase: 'When you need detailed visibility into agent decision-making.',\n  },\n  {\n    id: 'agents-workflows',\n    name: 'Agent Workflows',\n    module: './agents/workflows',\n    domain: 'agents',\n    description:\n      'Workflow definition and execution interfaces for Vercel Workflows (WDK) integration.',\n    tags: ['agent', 'workflow', 'wdk'],\n    useCase: 'When agents need to execute as durable Vercel Workflows.',\n  },\n\n  // ===========================================================================\n  // STREAMING\n  // ===========================================================================\n  {\n    id: 'streaming',\n    name: 'Streaming',\n    module: './streaming',\n    domain: 'streaming',\n    description:\n      'Unified streaming utilities for AI responses with transforms and control patterns.',\n    tags: ['streaming', 'response', 'transform'],\n    useCase: 'Top-level import when you need any streaming capability.',\n  },\n  {\n    id: 'streaming-core',\n    name: 'Streaming Core',\n    module: './streaming/core',\n    domain: 'streaming',\n    description: 'Core artifact and data streaming with writer utilities for streaming protocols.',\n    tags: ['streaming', 'core', 'artifact', 'writer'],\n    useCase: 'When building custom stream writers or artifact streams.',\n  },\n  {\n    id: 'streaming-control',\n    name: 'Streaming Control',\n    module: './streaming/control',\n    domain: 'streaming',\n    description: 'Composable streaming patterns: budget guards, step limits, stream smoothing.',\n    tags: ['streaming', 'control', 'budget', 'throttle'],\n    useCase: 'When you need to limit, smooth, or guard streaming output.',\n  },\n  {\n    id: 'streaming-infra',\n    name: 'Streaming Infrastructure',\n    module: './streaming/infra',\n    domain: 'streaming',\n    description: 'Infrastructure: transforms, metrics, backpressure, multiplexing.',\n    tags: ['streaming', 'infra', 'transform', 'metrics'],\n    useCase: 'When you need low-level stream processing or metrics collection.',\n  },\n  {\n    id: 'streaming-resilience',\n    name: 'Streaming Resilience',\n    module: './streaming/infra/resilience',\n    domain: 'streaming',\n    description:\n      'Stream recovery and resumption from Redis checkpoints for fault-tolerant operations.',\n    tags: ['streaming', 'resilience', 'checkpoint', 'recovery'],\n    useCase: 'When long-running streams must survive disconnections.',\n  },\n  {\n    id: 'streaming-transport',\n    name: 'Streaming Transport',\n    module: './streaming/infra/transport',\n    domain: 'streaming',\n    description: 'Transport adapters for SSE, WebSocket, and HTTP streaming protocols.',\n    tags: ['streaming', 'transport', 'sse', 'websocket'],\n    useCase: 'When you need to expose streams over different transport protocols.',\n  },\n\n  // ===========================================================================\n  // TOOLS\n  // ===========================================================================\n  {\n    id: 'tools',\n    name: 'Tool System',\n    module: './tools',\n    domain: 'tools',\n    description:\n      'Tool execution patterns including core definitions, computer use, MCP, and specialized capabilities.',\n    tags: ['tool', 'execution', 'framework'],\n    useCase: 'Top-level import when you need any tool capability.',\n  },\n  {\n    id: 'tools-core',\n    name: 'Tool Core',\n    module: './tools/core',\n    domain: 'tools',\n    description:\n      'Core tool utilities: factory methods, abort signal handling, validation wrappers.',\n    tags: ['tool', 'core', 'factory', 'validation'],\n    useCase: 'When building or wrapping custom tools.',\n  },\n  {\n    id: 'tools-computer',\n    name: 'Computer Use',\n    module: './tools/computer',\n    domain: 'tools',\n    description: 'Browser automation and computer use for agent interaction with web interfaces.',\n    tags: ['tool', 'computer-use', 'browser', 'automation'],\n    useCase: 'When agents need to interact with web UIs or take screenshots.',\n  },\n  {\n    id: 'tools-mcp',\n    name: 'MCP Integration',\n    module: './tools/mcp',\n    domain: 'tools',\n    description:\n      'Model Context Protocol integration with client, connection management, and tool caching.',\n    tags: ['tool', 'mcp', 'protocol', 'external'],\n    useCase: 'When integrating external tool servers via MCP protocol.',\n  },\n  {\n    id: 'tools-superpowers',\n    name: 'Superpowers Tools',\n    module: './tools/superpowers',\n    domain: 'tools',\n    description:\n      '20 engineering-focused tools that enforce planning, testing, and validation patterns.',\n    tags: ['tool', 'superpowers', 'engineering', 'planning'],\n    useCase: 'When agents need structured engineering workflows (plan → implement → test).',\n  },\n  {\n    id: 'tools-approval',\n    name: 'Tool Approval',\n    module: './tools/approval',\n    domain: 'tools',\n    description: 'HITL approval system: tool wrappers, middleware chain, pluggable queue backends.',\n    tags: ['tool', 'approval', 'hitl', 'middleware'],\n    useCase: 'When tool execution needs human approval before proceeding.',\n  },\n  {\n    id: 'tools-compliance',\n    name: 'Tool Compliance',\n    module: './tools/compliance',\n    domain: 'tools',\n    description:\n      'Tool compliance wrappers for ABAC, approval workflows, timeouts, and retry patterns.',\n    tags: ['tool', 'compliance', 'abac', 'wrapper'],\n    useCase: 'When tools must enforce access control or compliance policies.',\n  },\n\n  // ===========================================================================\n  // GROUNDING\n  // ===========================================================================\n  {\n    id: 'grounding',\n    name: 'Grounding',\n    module: './grounding',\n    domain: 'grounding',\n    description:\n      'RAG, embeddings, and response verification: citation, hallucination detection, source attribution.',\n    tags: ['grounding', 'rag', 'citation', 'verification'],\n    useCase: 'Top-level import when you need any grounding capability.',\n  },\n  {\n    id: 'grounding-rag',\n    name: 'Research Pipeline',\n    module: './grounding/rag',\n    domain: 'grounding',\n    description:\n      'Three-stage research pipeline (context expansion → reasoning → verification) with configurable models.',\n    tags: ['grounding', 'rag', 'research', 'pipeline', 'multi-model'],\n    useCase: 'When you need citation-backed, verified research answers.',\n  },\n  {\n    id: 'grounding-embed',\n    name: 'Embeddings',\n    module: './grounding/embed',\n    domain: 'grounding',\n    description: 'Text chunking, embedding generation, similarity search, and reranking.',\n    tags: ['grounding', 'embedding', 'search', 'reranking'],\n    useCase: 'When you need vector-based retrieval for RAG.',\n  },\n  {\n    id: 'grounding-citation',\n    name: 'Citations',\n    module: './grounding/citation',\n    domain: 'grounding',\n    description: 'Citation generation from retrieved sources with verification and formatting.',\n    tags: ['grounding', 'citation', 'source'],\n    useCase: 'When AI responses need inline citations referencing source material.',\n  },\n  {\n    id: 'grounding-hallucination',\n    name: 'Hallucination Detection',\n    module: './grounding/hallucination',\n    domain: 'grounding',\n    description: 'Identifies claims in AI output that are unsupported by source documents.',\n    tags: ['grounding', 'hallucination', 'detection', 'verification'],\n    useCase: 'When you need post-generation truthfulness checking.',\n  },\n  {\n    id: 'grounding-attribution',\n    name: 'Source Attribution',\n    module: './grounding/attribution',\n    domain: 'grounding',\n    description: 'Tracks which sources contributed to AI-generated content for transparency.',\n    tags: ['grounding', 'attribution', 'transparency', 'audit'],\n    useCase: 'When you need an audit trail of which sources informed each claim.',\n  },\n  {\n    id: 'grounding-verification',\n    name: 'Fact Verification',\n    module: './grounding/verification',\n    domain: 'grounding',\n    description: 'Fact verification against knowledge sources with confidence scoring.',\n    tags: ['grounding', 'verification', 'fact-check', 'confidence'],\n    useCase: 'When individual claims must be verified against authoritative sources.',\n  },\n  {\n    id: 'grounding-context',\n    name: 'Request Context',\n    module: './grounding/context',\n    domain: 'grounding',\n    description: 'Identity and request context management with permission checking.',\n    tags: ['grounding', 'context', 'identity', 'permissions'],\n    useCase: 'When you need request-scoped context propagation through the pipeline.',\n  },\n  {\n    id: 'grounding-proof-map',\n    name: 'Proof Maps',\n    module: './grounding/proof-map',\n    domain: 'grounding',\n    description:\n      'Multi-model proof loops and patch application for structured verification of AI outputs.',\n    tags: ['grounding', 'proof', 'verification', 'patch'],\n    useCase: 'When you need structured, multi-step verification of complex AI outputs.',\n  },\n\n  // ===========================================================================\n  // SDK\n  // ===========================================================================\n  {\n    id: 'sdk',\n    name: 'SDK Extensions',\n    module: './sdk',\n    domain: 'sdk',\n    description:\n      'Vercel AI SDK v6 extensions: error hierarchy, stop conditions, and middleware patterns.',\n    tags: ['sdk', 'extension', 'middleware'],\n    useCase: 'Top-level import when you need any SDK extension.',\n  },\n  {\n    id: 'sdk-errors',\n    name: 'Error Hierarchy',\n    module: './sdk/errors',\n    domain: 'sdk',\n    description: 'Unified error hierarchy with error codes, retry info, and structured metadata.',\n    tags: ['sdk', 'errors', 'retry', 'hierarchy'],\n    useCase: 'When you need typed, classifiable errors with retry semantics.',\n  },\n  {\n    id: 'sdk-stop-conditions',\n    name: 'Stop Conditions',\n    module: './sdk/stop-conditions',\n    domain: 'sdk',\n    description: 'Utilities for controlling agentic loop termination with condition evaluation.',\n    tags: ['sdk', 'stop', 'termination', 'control'],\n    useCase: 'When you need custom logic for when an agent should stop iterating.',\n  },\n  {\n    id: 'sdk-experimental',\n    name: 'SDK Experimental',\n    module: './sdk/experimental',\n    domain: 'sdk',\n    description: 'Experimental SDK v6 features using experimental_ prefix (unstable).',\n    tags: ['sdk', 'experimental'],\n    useCase: 'When you want to test new SDK capabilities before they stabilize.',\n  },\n\n  // ===========================================================================\n  // SECURITY\n  // ===========================================================================\n  {\n    id: 'security',\n    name: 'Security',\n    module: './security',\n    domain: 'security',\n    description: 'Guardrails, injection detection, and PII filtering for secure AI applications.',\n    tags: ['security', 'guardrails', 'pii', 'injection'],\n    useCase: 'Top-level import when you need any security capability.',\n  },\n  {\n    id: 'security-guardrails',\n    name: 'Guardrails',\n    module: './security/guardrails',\n    domain: 'security',\n    description: 'PII filtering and content filtering middleware for response security.',\n    tags: ['security', 'guardrails', 'pii', 'filter'],\n    useCase: 'When AI responses must be scrubbed of PII or harmful content.',\n  },\n  {\n    id: 'security-injection',\n    name: 'Injection Defense',\n    module: './security/injection',\n    domain: 'security',\n    description: 'Prompt injection detection and defense mechanisms.',\n    tags: ['security', 'injection', 'defense', 'detection'],\n    useCase: 'When user input must be screened for prompt injection attacks.',\n  },\n\n  // ===========================================================================\n  // GOVERNANCE\n  // ===========================================================================\n  {\n    id: 'governance',\n    name: 'Governance',\n    module: './governance',\n    domain: 'governance',\n    description:\n      'Enterprise compliance, audit, policy, and multi-tenant management for AI systems.',\n    tags: ['governance', 'compliance', 'audit', 'policy'],\n    useCase: 'Top-level import when you need any governance capability.',\n  },\n  {\n    id: 'governance-compliance',\n    name: 'Compliance',\n    module: './governance/compliance',\n    domain: 'governance',\n    description: 'ABAC policy engine, PHI detection, redaction, and approval workflows.',\n    tags: ['governance', 'compliance', 'abac', 'phi', 'redaction'],\n    useCase: 'When you need access control policies or PHI handling.',\n  },\n  {\n    id: 'governance-audit',\n    name: 'Audit',\n    module: './governance/audit',\n    domain: 'governance',\n    description: 'Audit logging and schema for tracking AI system operations.',\n    tags: ['governance', 'audit', 'logging', 'tracking'],\n    useCase: 'When you need a tamper-evident audit trail of AI operations.',\n  },\n  {\n    id: 'governance-policies',\n    name: 'Policies',\n    module: './governance/policies',\n    domain: 'governance',\n    description:\n      'Policy definitions for guardrails, loop controls, and telemetry governing agent behavior.',\n    tags: ['governance', 'policy', 'guardrails', 'rules'],\n    useCase: 'When you need to define declarative rules that constrain agents.',\n  },\n  {\n    id: 'governance-tenancy',\n    name: 'Multi-Tenancy',\n    module: './governance/tenancy',\n    domain: 'governance',\n    description: 'Tenant isolation, quota management, and per-tenant configuration.',\n    tags: ['governance', 'tenancy', 'isolation', 'quota'],\n    useCase: 'When you need to isolate AI resources across tenants with quotas.',\n  },\n\n  // ===========================================================================\n  // OBSERVABILITY\n  // ===========================================================================\n  {\n    id: 'observability',\n    name: 'Observability',\n    module: './observability',\n    domain: 'observability',\n    description:\n      'Monitoring, tracing, and cost management with telemetry, analytics, and budget tracking.',\n    tags: ['observability', 'monitoring', 'tracing', 'cost'],\n    useCase: 'Top-level import when you need any observability capability.',\n  },\n  {\n    id: 'observability-telemetry',\n    name: 'Telemetry',\n    module: './observability/telemetry',\n    domain: 'observability',\n    description:\n      'AI SDK v6 telemetry: span tracing, token usage, cost estimation, and latency metrics.',\n    tags: ['observability', 'telemetry', 'spans', 'tokens'],\n    useCase: 'When you need fine-grained span-level metrics for AI calls.',\n  },\n  {\n    id: 'observability-tracing',\n    name: 'Distributed Tracing',\n    module: './observability/tracing',\n    domain: 'observability',\n    description:\n      'OpenTelemetry-compatible instrumentation with multiple exporters (Langfuse, Axiom, Datadog).',\n    tags: ['observability', 'tracing', 'otel', 'langfuse', 'axiom'],\n    useCase: 'When you need distributed tracing exported to external APM tools.',\n  },\n  {\n    id: 'observability-analytics',\n    name: 'Analytics',\n    module: './observability/analytics',\n    domain: 'observability',\n    description:\n      'AI usage analytics with token tracking, cost estimation, and performance metrics.',\n    tags: ['observability', 'analytics', 'usage', 'performance'],\n    useCase: 'When you need aggregate analytics over AI usage patterns.',\n  },\n  {\n    id: 'observability-cost',\n    name: 'Cost Tracking',\n    module: './observability/cost',\n    domain: 'observability',\n    description:\n      'Cost tracking middleware for enforcing budgets and attributing costs to users/teams/features.',\n    tags: ['observability', 'cost', 'budget', 'attribution'],\n    useCase: 'When you need to enforce spend limits or attribute AI costs.',\n  },\n\n  // ===========================================================================\n  // HITL\n  // ===========================================================================\n  {\n    id: 'hitl',\n    name: 'Human-in-the-Loop',\n    module: './hitl',\n    domain: 'hitl',\n    description:\n      'Human-in-the-loop integration: approval queues, review triggers, and escalation handling.',\n    tags: ['hitl', 'human', 'review', 'approval'],\n    useCase: 'Top-level import when you need any HITL capability.',\n  },\n  {\n    id: 'hitl-feedback',\n    name: 'Feedback Collection',\n    module: './hitl/feedback',\n    domain: 'hitl',\n    description:\n      'User feedback collection and aggregation for quality monitoring and model improvement.',\n    tags: ['hitl', 'feedback', 'quality', 'rating'],\n    useCase: 'When you need thumbs-up/down or free-text feedback on AI responses.',\n  },\n  {\n    id: 'hitl-annotation',\n    name: 'Annotation',\n    module: './hitl/annotation',\n    domain: 'hitl',\n    description: 'Human annotation tools for labeling and correcting AI outputs as training data.',\n    tags: ['hitl', 'annotation', 'labeling', 'training'],\n    useCase: 'When humans need to label AI outputs for fine-tuning or evaluation.',\n  },\n  {\n    id: 'hitl-active-learning',\n    name: 'Active Learning',\n    module: './hitl/active-learning',\n    domain: 'hitl',\n    description: 'Intelligent sample selection for human annotation to maximize model improvement.',\n    tags: ['hitl', 'active-learning', 'sampling', 'optimization'],\n    useCase: 'When you want to pick the most informative samples for human review.',\n  },\n  {\n    id: 'hitl-approval',\n    name: 'HITL Approval',\n    module: './hitl/approval',\n    domain: 'hitl',\n    description: 'Approval queue for human review gates on sensitive AI outputs.',\n    tags: ['hitl', 'approval', 'queue', 'gate'],\n    useCase: 'When AI outputs must be approved by a human before being used.',\n  },\n  {\n    id: 'hitl-review',\n    name: 'Review Triggers',\n    module: './hitl/review',\n    domain: 'hitl',\n    description: 'Human review workflow triggers based on confidence, risk, and content analysis.',\n    tags: ['hitl', 'review', 'trigger', 'confidence'],\n    useCase: 'When you need automatic escalation to humans based on risk signals.',\n  },\n\n  // ===========================================================================\n  // OUTPUT\n  // ===========================================================================\n  {\n    id: 'output',\n    name: 'Output',\n    module: './output',\n    domain: 'output',\n    description:\n      'Output API factories for structured generation: objects, arrays, choices, and streaming.',\n    tags: ['output', 'structured', 'generation', 'factory'],\n    useCase: 'When you need typed, validated structured output from models.',\n  },\n  {\n    id: 'output-multimodal',\n    name: 'Multimodal Output',\n    module: './output/multimodal',\n    domain: 'output',\n    description: 'Image generation, audio, and speech/transcription for multimodal AI output.',\n    tags: ['output', 'multimodal', 'image', 'audio'],\n    useCase: 'When agents need to produce images, audio, or other non-text output.',\n  },\n\n  // ===========================================================================\n  // PROMPTS\n  // ===========================================================================\n  {\n    id: 'prompts',\n    name: 'Prompt Management',\n    module: './prompts',\n    domain: 'prompts',\n    description:\n      'Centralized system prompt management with model-specific composition and variants.',\n    tags: ['prompt', 'template', 'composition', 'model-specific'],\n    useCase: 'When you need reusable, model-optimized prompt templates.',\n  },\n\n  // ===========================================================================\n  // PIPELINES\n  // ===========================================================================\n  {\n    id: 'pipelines',\n    name: 'Pipelines',\n    module: './pipelines',\n    domain: 'pipelines',\n    description: 'Multi-step pipeline execution with resumption, compliance checking, and tracing.',\n    tags: ['pipeline', 'multi-step', 'orchestration', 'resumption'],\n    useCase: 'When you need a sequence of AI steps with built-in compliance and tracing.',\n  },\n\n  // ===========================================================================\n  // CACHING\n  // ===========================================================================\n  {\n    id: 'caching',\n    name: 'Caching',\n    module: './caching',\n    domain: 'caching',\n    description:\n      'Response caching middleware with multiple storage backends and eviction strategies.',\n    tags: ['caching', 'middleware', 'storage'],\n    useCase: 'Top-level import when you need any caching capability.',\n  },\n  {\n    id: 'caching-adapters',\n    name: 'Cache Adapters',\n    module: './caching/adapters',\n    domain: 'caching',\n    description: 'Cache adapter implementations for memory and Redis storage backends.',\n    tags: ['caching', 'adapter', 'memory', 'redis'],\n    useCase: 'When you need to plug in a specific cache storage backend.',\n  },\n  {\n    id: 'caching-strategies',\n    name: 'Cache Strategies',\n    module: './caching/strategies',\n    domain: 'caching',\n    description: 'Pluggable eviction strategies: LRU, LFU, TTL, FIFO, Adaptive.',\n    tags: ['caching', 'strategy', 'lru', 'lfu', 'ttl', 'eviction'],\n    useCase: 'When you need a specific eviction policy for your cache.',\n  },\n\n  // ===========================================================================\n  // SHARED\n  // ===========================================================================\n  {\n    id: 'shared',\n    name: 'Shared SDK Layer',\n    module: './shared',\n    domain: 'shared',\n    description:\n      'Centralized SDK types and runtime exports — canonical import path for all AI SDK usage.',\n    tags: ['shared', 'sdk', 'types', 'runtime'],\n    useCase: 'When importing AI SDK types or runtime functions (instead of directly from \"ai\").',\n  },\n\n  // ===========================================================================\n  // INTEGRATIONS\n  // ===========================================================================\n  {\n    id: 'integrations',\n    name: 'Integrations',\n    module: './integrations',\n    domain: 'integrations',\n    description:\n      'Third-party runtime adapter interfaces: Redis, Blob Storage, Rate Limit, Stream, Notifications.',\n    tags: ['integrations', 'adapter', 'third-party'],\n    useCase: 'Top-level import when you need any integration adapter.',\n  },\n  {\n    id: 'integrations-redis',\n    name: 'Redis Integration',\n    module: './integrations/redis',\n    domain: 'integrations',\n    description: 'RedisClient/RedisClientExtended interfaces with Upstash adapter implementation.',\n    tags: ['integrations', 'redis', 'upstash', 'cache'],\n    useCase: 'When you need Redis KV or extended commands (lists, hashes, sorted sets).',\n  },\n  {\n    id: 'integrations-blob-storage',\n    name: 'Blob Storage Integration',\n    module: './integrations/blob-storage',\n    domain: 'integrations',\n    description: 'BlobStorageClient interface with Vercel Blob adapter implementation.',\n    tags: ['integrations', 'blob', 'storage', 'vercel'],\n    useCase: 'When you need to store/retrieve files or large objects.',\n  },\n  {\n    id: 'integrations-rate-limit',\n    name: 'Rate Limit Integration',\n    module: './integrations/rate-limit',\n    domain: 'integrations',\n    description: 'RateLimiter interface with Upstash rate-limit adapter.',\n    tags: ['integrations', 'rate-limit', 'upstash', 'throttle'],\n    useCase: 'When you need distributed rate limiting for API calls.',\n  },\n  {\n    id: 'integrations-stream',\n    name: 'Stream Integration',\n    module: './integrations/stream',\n    domain: 'integrations',\n    description: 'ResumableStreamContext interface with resumable stream adapter.',\n    tags: ['integrations', 'stream', 'resumable'],\n    useCase: 'When you need streams that survive disconnections and resume.',\n  },\n  {\n    id: 'integrations-notifications',\n    name: 'Notifications Integration',\n    module: './integrations/notifications',\n    domain: 'integrations',\n    description:\n      'Notifier interface with log adapter (replaces sonner for server-side notifications).',\n    tags: ['integrations', 'notifications', 'toast', 'log'],\n    useCase: 'When you need to emit notifications from AI pipeline events.',\n  },\n\n  // ===========================================================================\n  // GENERATIVE UI\n  // ===========================================================================\n  {\n    id: 'generative-ui',\n    name: 'Generative UI',\n    module: './generative-ui',\n    domain: 'generative-ui',\n    description:\n      'AI-driven dynamic interface generation with enterprise catalog, streaming, and governance.',\n    tags: ['generative-ui', 'dynamic', 'catalog', 'streaming', 'json-render'],\n    useCase: 'Top-level import when you need AI to generate dynamic user interfaces.',\n  },\n  {\n    id: 'generative-ui-catalog',\n    name: 'UI Catalog',\n    module: './generative-ui/catalog',\n    domain: 'generative-ui',\n    description:\n      'Enterprise component catalog with entitlement-based filtering and prompt generation.',\n    tags: ['generative-ui', 'catalog', 'entitlements', 'prompt'],\n    useCase: 'When defining which UI components AI can use, filtered by user tier.',\n  },\n  {\n    id: 'generative-ui-registry',\n    name: 'UI Registry',\n    module: './generative-ui/registry',\n    domain: 'generative-ui',\n    description: 'Zod schema registry for runtime validation of AI-generated component props.',\n    tags: ['generative-ui', 'registry', 'validation', 'zod', 'schema'],\n    useCase: 'When you need to validate AI-generated UI trees before rendering.',\n  },\n  {\n    id: 'generative-ui-stream',\n    name: 'UI Stream',\n    module: './generative-ui/stream',\n    domain: 'generative-ui',\n    description:\n      'Streaming configuration for generative UI with budget guards, audit logging, and validation.',\n    tags: ['generative-ui', 'stream', 'budget', 'audit', 'streaming'],\n    useCase: 'When streaming AI-generated UI trees with cost control and audit.',\n  },\n] as const;\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/** All unique domain names in the catalog. */\nexport const CATALOG_DOMAINS = [...new Set(PATTERN_CATALOG.map(e => e.domain))] as const;\n\n/** All unique tags used in the catalog. */\nexport const CATALOG_TAGS = [\n  ...new Set(PATTERN_CATALOG.flatMap(e => e.tags)),\n].sort() as readonly string[];\n\n/**\n * Find catalog entries matching a query.\n *\n * Searches id, name, description, tags, and useCase fields (case-insensitive).\n *\n * @param query - Search string.\n * @returns Matching catalog entries.\n * @example\n * ```ts\n * import { searchCatalog } from '@od-oneapp/ai-platform/catalog';\n *\n * searchCatalog('approval');\n * // → [tools-approval, hitl-approval, governance-compliance, ...]\n *\n * searchCatalog('circuit breaker');\n * // → [agents-fallback, grounding-rag]\n * ```\n */\nexport function searchCatalog(query: string): readonly CatalogEntry[] {\n  const q = query.toLowerCase();\n  return PATTERN_CATALOG.filter(\n    e =>\n      e.id.includes(q) ||\n      e.name.toLowerCase().includes(q) ||\n      e.description.toLowerCase().includes(q) ||\n      e.tags.some(t => t.includes(q)) ||\n      e.useCase.toLowerCase().includes(q),\n  );\n}\n\n/**\n * Get all catalog entries for a given domain.\n *\n * @param domain - Domain to filter by.\n * @returns Catalog entries in that domain.\n */\nexport function getCatalogByDomain(domain: CatalogEntry['domain']): readonly CatalogEntry[] {\n  return PATTERN_CATALOG.filter(e => e.domain === domain);\n}\n\n/**\n * Get all catalog entries that include a specific tag.\n *\n * @param tag - Tag to filter by.\n * @returns Catalog entries with that tag.\n */\nexport function getCatalogByTag(tag: string): readonly CatalogEntry[] {\n  return PATTERN_CATALOG.filter(e => e.tags.includes(tag));\n}\n"],"mappings":"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"}

package/dist/chunk-CkzbjWQW.mjs

@@ -0,0 +1,20 @@
+import "node:module";
+
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll as t };

package/dist/circuit-breaker-DoKWPORd.mjs

@@ -0,0 +1,262 @@
+import { p as createLanguageModel } from "./xai-CbV_dCnP.mjs";
+
+//#region src/agents/fallback/types.ts
+/**
+* All models failed error
+*/
+var AllModelsFailedError = class AllModelsFailedError extends Error {
+	constructor(message, failures) {
+		super(message);
+		this.failures = failures;
+		this.name = "AllModelsFailedError";
+		Object.setPrototypeOf(this, AllModelsFailedError.prototype);
+	}
+};
+/**
+* Circuit open error
+*/
+var CircuitOpenError = class CircuitOpenError extends Error {
+	constructor(model, resetTime) {
+		super(`Circuit open for model ${model}, resets at ${resetTime.toISOString()}`);
+		this.model = model;
+		this.resetTime = resetTime;
+		this.name = "CircuitOpenError";
+		Object.setPrototypeOf(this, CircuitOpenError.prototype);
+	}
+};
+
+//#endregion
+//#region src/agents/fallback/strategies/model-fallback.ts
+/**
+* Model fallback strategy
+* Automatically falls back to alternative models on failure
+*/
+/**
+* Sleep utility
+*/
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+* Execute with model fallback
+*
+* @example
+* ```ts
+* const result = await executeWithFallback(
+*   {
+*     primary: Model.SONNET,
+*     fallbacks: [Model.HAIKU, Model.GPT_4O_MINI],
+*     maxRetries: 2,
+*   },
+*   async (model) => {
+*     return generateText({ model, prompt: "Hello" });
+*   }
+* );
+*
+* console.log(`Succeeded with ${result.model} after ${result.attempts} attempts`);
+* ```
+*/
+async function executeWithFallback(config, execute) {
+	const { primary, fallbacks, maxRetries = 3, retryDelay = 1e3, exponentialBackoff = true } = config;
+	const resolveModel = config.resolveModel ?? createLanguageModel;
+	const allModels = [primary, ...fallbacks];
+	const failedModels = [];
+	let totalAttempts = 0;
+	for (const model of allModels) {
+		let attempts = 0;
+		let lastError = null;
+		while (attempts < maxRetries) {
+			attempts++;
+			totalAttempts++;
+			try {
+				return {
+					result: await execute(resolveModel(model)),
+					model,
+					attempts: totalAttempts,
+					failedModels
+				};
+			} catch (error) {
+				lastError = error;
+				if (!isRetryableError(error)) break;
+				if (attempts < maxRetries) await sleep(exponentialBackoff ? retryDelay * Math.pow(2, attempts - 1) : retryDelay);
+			}
+		}
+		if (lastError) failedModels.push({
+			model,
+			error: lastError,
+			attempts
+		});
+	}
+	throw new AllModelsFailedError(`All models failed after ${totalAttempts} total attempts`, failedModels.map((f) => ({
+		model: f.model,
+		error: f.error
+	})));
+}
+/**
+* Check if an error is retryable
+*/
+function isRetryableError(error) {
+	if (!(error instanceof Error)) return false;
+	const message = error.message.toLowerCase();
+	if (message.includes("rate limit") || message.includes("429")) return true;
+	if (message.includes("timeout") || message.includes("timed out")) return true;
+	if (message.includes("500") || message.includes("502") || message.includes("503")) return true;
+	if (message.includes("network") || message.includes("connection")) return true;
+	return false;
+}
+/**
+* Create fallback middleware for AI SDK
+*/
+function createFallbackMiddleware(config) {
+	const asLanguageModelV3 = (model, modelName) => {
+		if (typeof model === "string") throw new Error(`Fallback middleware requires LanguageModelV3 instances, got '${modelName}'.`);
+		if (model.specificationVersion !== "v3") throw new Error(`Fallback middleware requires LanguageModelV3 instances, got '${model.specificationVersion}'.`);
+		return model;
+	};
+	const isSameModel = (candidate, current) => candidate.provider === current.provider && candidate.modelId === current.modelId;
+	const describeModel = (model) => {
+		if (typeof model === "string") return model;
+		return `${model.provider}:${model.modelId}`;
+	};
+	return {
+		specificationVersion: "v3",
+		wrapGenerate: async ({ doGenerate, params, model }) => {
+			return (await executeWithFallback(config, async (providerModel) => {
+				const provider = asLanguageModelV3(providerModel, describeModel(providerModel));
+				if (isSameModel(provider, model)) return await doGenerate();
+				return await provider.doGenerate(params);
+			})).result;
+		},
+		wrapStream: async ({ doStream, params, model }) => {
+			return (await executeWithFallback(config, async (providerModel) => {
+				const provider = asLanguageModelV3(providerModel, describeModel(providerModel));
+				if (isSameModel(provider, model)) return await doStream();
+				return await provider.doStream(params);
+			})).result;
+		}
+	};
+}
+
+//#endregion
+//#region src/agents/fallback/recovery/circuit-breaker.ts
+/**
+* Circuit breaker for model reliability
+*/
+/**
+* Circuit breaker for model reliability
+*
+* Prevents cascading failures by temporarily blocking
+* calls to failing models.
+*
+* @example
+* ```ts
+* const breaker = new CircuitBreaker({
+*   failureThreshold: 5,
+*   resetTimeout: 30000, // 30 seconds
+* });
+*
+* try {
+*   breaker.checkCircuit(Model.SONNET);
+*   const result = await generateText({ model, prompt });
+*   breaker.recordSuccess(Model.SONNET);
+* } catch (error) {
+*   breaker.recordFailure(Model.SONNET);
+*   throw error;
+* }
+* ```
+*/
+var CircuitBreaker = class {
+	circuits = /* @__PURE__ */ new Map();
+	config;
+	constructor(config) {
+		this.config = {
+			failureThreshold: config.failureThreshold,
+			resetTimeout: config.resetTimeout,
+			successThreshold: config.successThreshold ?? 2
+		};
+	}
+	/**
+	* Get or create circuit state for a model
+	*/
+	getCircuit(model) {
+		const existing = this.circuits.get(model);
+		if (existing) return existing;
+		const created = {
+			state: "closed",
+			failures: 0,
+			successes: 0,
+			lastFailure: null,
+			nextRetry: null
+		};
+		this.circuits.set(model, created);
+		return created;
+	}
+	/**
+	* Check if circuit allows request
+	* @throws CircuitOpenError if circuit is open
+	*/
+	checkCircuit(model) {
+		const circuit = this.getCircuit(model);
+		if (circuit.state === "closed") return;
+		if (circuit.state === "open") {
+			if (circuit.nextRetry && /* @__PURE__ */ new Date() >= circuit.nextRetry) {
+				circuit.state = "half-open";
+				circuit.successes = 0;
+				return;
+			}
+			throw new CircuitOpenError(model, circuit.nextRetry ?? new Date(Date.now() + this.config.resetTimeout));
+		}
+	}
+	/**
+	* Record a successful request
+	*/
+	recordSuccess(model) {
+		const circuit = this.getCircuit(model);
+		if (circuit.state === "half-open") {
+			circuit.successes++;
+			if (circuit.successes >= this.config.successThreshold) {
+				circuit.state = "closed";
+				circuit.failures = 0;
+				circuit.successes = 0;
+				circuit.nextRetry = null;
+			}
+		} else if (circuit.state === "closed") circuit.failures = 0;
+	}
+	/**
+	* Record a failed request
+	*/
+	recordFailure(model) {
+		const circuit = this.getCircuit(model);
+		circuit.failures++;
+		circuit.lastFailure = /* @__PURE__ */ new Date();
+		if (circuit.state === "half-open") {
+			circuit.state = "open";
+			circuit.nextRetry = new Date(Date.now() + this.config.resetTimeout);
+		} else if (circuit.state === "closed" && circuit.failures >= this.config.failureThreshold) {
+			circuit.state = "open";
+			circuit.nextRetry = new Date(Date.now() + this.config.resetTimeout);
+		}
+	}
+	/**
+	* Get current circuit state
+	*/
+	getState(model) {
+		return this.getCircuit(model).state;
+	}
+	/**
+	* Manually reset a circuit
+	*/
+	reset(model) {
+		this.circuits.delete(model);
+	}
+	/**
+	* Reset all circuits
+	*/
+	resetAll() {
+		this.circuits.clear();
+	}
+};
+
+//#endregion
+export { CircuitOpenError as a, AllModelsFailedError as i, createFallbackMiddleware as n, executeWithFallback as r, CircuitBreaker as t };
+//# sourceMappingURL=circuit-breaker-DoKWPORd.mjs.map

package/dist/circuit-breaker-DoKWPORd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker-DoKWPORd.mjs","names":[],"sources":["../src/agents/fallback/types.ts","../src/agents/fallback/strategies/model-fallback.ts","../src/agents/fallback/recovery/circuit-breaker.ts"],"sourcesContent":["/**\n * Fallback and recovery types\n */\n\nimport type { Model } from '../../models/registry';\nimport type { SDKLanguageModel } from '../../shared';\n\n/**\n * Fallback strategy configuration\n */\nexport interface FallbackConfig {\n  /** Primary model to use */\n  primary: Model;\n  /** Fallback models in order of preference */\n  fallbacks: Model[];\n  /** Optional model resolver override for testing or advanced routing */\n  resolveModel?: (model: Model) => SDKLanguageModel;\n  /** Maximum retries per model */\n  maxRetries?: number;\n  /** Delay between retries in ms */\n  retryDelay?: number;\n  /** Whether to use exponential backoff */\n  exponentialBackoff?: boolean;\n}\n\n/**\n * Fallback result with metadata\n */\nexport interface FallbackResult<T> {\n  /** The result from successful model */\n  result: T;\n  /** Which model succeeded */\n  model: Model;\n  /** Number of attempts before success */\n  attempts: number;\n  /** Models that failed */\n  failedModels: Array<{\n    model: Model;\n    error: Error;\n    attempts: number;\n  }>;\n}\n\n/**\n * Circuit breaker state\n */\nexport type CircuitState = 'closed' | 'open' | 'half-open';\n\n/**\n * Circuit breaker configuration\n */\nexport interface CircuitBreakerConfig {\n  /** Number of failures before opening circuit */\n  failureThreshold: number;\n  /** Time in ms before trying again (half-open) */\n  resetTimeout: number;\n  /** Number of successes in half-open to close */\n  successThreshold?: number;\n}\n\n/**\n * All models failed error\n */\nexport class AllModelsFailedError extends Error {\n  constructor(\n    message: string,\n    public readonly failures: Array<{ model: Model; error: Error }>,\n  ) {\n    super(message);\n    this.name = 'AllModelsFailedError';\n    Object.setPrototypeOf(this, AllModelsFailedError.prototype);\n  }\n}\n\n/**\n * Circuit open error\n */\nexport class CircuitOpenError extends Error {\n  constructor(\n    public readonly model: Model,\n    public readonly resetTime: Date,\n  ) {\n    super(`Circuit open for model ${model}, resets at ${resetTime.toISOString()}`);\n    this.name = 'CircuitOpenError';\n    Object.setPrototypeOf(this, CircuitOpenError.prototype);\n  }\n}\n","/**\n * Model fallback strategy\n * Automatically falls back to alternative models on failure\n */\n\nimport { createLanguageModel } from '../../../models';\nimport { AllModelsFailedError } from '../types';\n\nimport type { WrapGenerateArgs, WrapStreamArgs } from '../../../sdk/middleware/model-middleware';\nimport type { SDKLanguageModel , SDKLanguageModelV3, SDKLanguageModelV3Middleware } from '../../../shared';\nimport type { FallbackConfig, FallbackResult } from '../types';\n\n\n/**\n * Sleep utility\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Execute with model fallback\n *\n * @example\n * ```ts\n * const result = await executeWithFallback(\n *   {\n *     primary: Model.SONNET,\n *     fallbacks: [Model.HAIKU, Model.GPT_4O_MINI],\n *     maxRetries: 2,\n *   },\n *   async (model) => {\n *     return generateText({ model, prompt: \"Hello\" });\n *   }\n * );\n *\n * console.log(`Succeeded with ${result.model} after ${result.attempts} attempts`);\n * ```\n */\nexport async function executeWithFallback<T>(\n  config: FallbackConfig,\n  execute: (model: SDKLanguageModel) => Promise<T>,\n): Promise<FallbackResult<T>> {\n  const {\n    primary,\n    fallbacks,\n    maxRetries = 3,\n    retryDelay = 1000,\n    exponentialBackoff = true,\n  } = config;\n\n  const resolveModel = config.resolveModel ?? createLanguageModel;\n  const allModels = [primary, ...fallbacks];\n  const failedModels: FallbackResult<T>['failedModels'] = [];\n  let totalAttempts = 0;\n\n  for (const model of allModels) {\n    let attempts = 0;\n    let lastError: Error | null = null;\n\n    while (attempts < maxRetries) {\n      attempts++;\n      totalAttempts++;\n\n      try {\n        const provider = resolveModel(model);\n        const result = await execute(provider);\n\n        return {\n          result,\n          model,\n          attempts: totalAttempts,\n          failedModels,\n        };\n      } catch (error) {\n        lastError = error as Error;\n\n        // Check if error is retryable\n        if (!isRetryableError(error)) {\n          break; // Move to next model\n        }\n\n        // Wait before retry\n        if (attempts < maxRetries) {\n          const delay = exponentialBackoff ? retryDelay * Math.pow(2, attempts - 1) : retryDelay;\n          await sleep(delay);\n        }\n      }\n    }\n\n    // Record failure for this model\n    if (lastError) {\n      failedModels.push({\n        model,\n        error: lastError,\n        attempts,\n      });\n    }\n  }\n\n  throw new AllModelsFailedError(\n    `All models failed after ${totalAttempts} total attempts`,\n    failedModels.map(f => ({ model: f.model, error: f.error })),\n  );\n}\n\n/**\n * Check if an error is retryable\n */\nfunction isRetryableError(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n\n  const message = error.message.toLowerCase();\n\n  // Rate limit errors are retryable\n  if (message.includes('rate limit') || message.includes('429')) return true;\n\n  // Timeout errors are retryable\n  if (message.includes('timeout') || message.includes('timed out')) return true;\n\n  // Server errors are retryable\n  if (message.includes('500') || message.includes('502') || message.includes('503')) {\n    return true;\n  }\n\n  // Network errors are retryable\n  if (message.includes('network') || message.includes('connection')) return true;\n\n  return false;\n}\n\n/**\n * Create fallback middleware for AI SDK\n */\nexport function createFallbackMiddleware(config: FallbackConfig): SDKLanguageModelV3Middleware {\n  const asLanguageModelV3 = (model: SDKLanguageModel, modelName: string): SDKLanguageModelV3 => {\n    if (typeof model === 'string') {\n      throw new Error(\n        `Fallback middleware requires LanguageModelV3 instances, got '${modelName}'.`,\n      );\n    }\n\n    if (model.specificationVersion !== 'v3') {\n      throw new Error(\n        `Fallback middleware requires LanguageModelV3 instances, got '${model.specificationVersion}'.`,\n      );\n    }\n\n    return model;\n  };\n\n  const isSameModel = (candidate: SDKLanguageModelV3, current: SDKLanguageModelV3): boolean =>\n    candidate.provider === current.provider && candidate.modelId === current.modelId;\n\n  const describeModel = (model: SDKLanguageModel): string => {\n    if (typeof model === 'string') {\n      return model;\n    }\n\n    return `${model.provider}:${model.modelId}`;\n  };\n\n  return {\n    specificationVersion: 'v3',\n    wrapGenerate: async ({ doGenerate, params, model }: WrapGenerateArgs) => {\n      const result = await executeWithFallback(config, async providerModel => {\n        const provider = asLanguageModelV3(providerModel, describeModel(providerModel));\n\n        if (isSameModel(provider, model)) {\n          return await doGenerate();\n        }\n\n        return await provider.doGenerate(params);\n      });\n\n      return result.result;\n    },\n    wrapStream: async ({ doStream, params, model }: WrapStreamArgs) => {\n      const result = await executeWithFallback(config, async providerModel => {\n        const provider = asLanguageModelV3(providerModel, describeModel(providerModel));\n\n        if (isSameModel(provider, model)) {\n          return await doStream();\n        }\n\n        return await provider.doStream(params);\n      });\n\n      return result.result;\n    },\n  };\n}\n","/**\n * Circuit breaker for model reliability\n */\n\nimport { CircuitOpenError } from '../types';\n\nimport type { Model } from '../../../models/registry';\nimport type { CircuitBreakerConfig, CircuitState } from '../types';\n\n/**\n * Circuit state for a single model\n */\ninterface CircuitModelState {\n  state: CircuitState;\n  failures: number;\n  successes: number;\n  lastFailure: Date | null;\n  nextRetry: Date | null;\n}\n\n/**\n * Circuit breaker for model reliability\n *\n * Prevents cascading failures by temporarily blocking\n * calls to failing models.\n *\n * @example\n * ```ts\n * const breaker = new CircuitBreaker({\n *   failureThreshold: 5,\n *   resetTimeout: 30000, // 30 seconds\n * });\n *\n * try {\n *   breaker.checkCircuit(Model.SONNET);\n *   const result = await generateText({ model, prompt });\n *   breaker.recordSuccess(Model.SONNET);\n * } catch (error) {\n *   breaker.recordFailure(Model.SONNET);\n *   throw error;\n * }\n * ```\n */\nexport class CircuitBreaker {\n  private circuits = new Map<Model, CircuitModelState>();\n  private config: Required<CircuitBreakerConfig>;\n\n  constructor(config: CircuitBreakerConfig) {\n    this.config = {\n      failureThreshold: config.failureThreshold,\n      resetTimeout: config.resetTimeout,\n      successThreshold: config.successThreshold ?? 2,\n    };\n  }\n\n  /**\n   * Get or create circuit state for a model\n   */\n  private getCircuit(model: Model): CircuitModelState {\n    const existing = this.circuits.get(model);\n    if (existing) {\n      return existing;\n    }\n\n    const created: CircuitModelState = {\n      state: 'closed',\n      failures: 0,\n      successes: 0,\n      lastFailure: null,\n      nextRetry: null,\n    };\n\n    this.circuits.set(model, created);\n    return created;\n  }\n\n  /**\n   * Check if circuit allows request\n   * @throws CircuitOpenError if circuit is open\n   */\n  checkCircuit(model: Model): void {\n    const circuit = this.getCircuit(model);\n\n    if (circuit.state === 'closed') {\n      return; // Allow request\n    }\n\n    if (circuit.state === 'open') {\n      // Check if we should transition to half-open\n      if (circuit.nextRetry && new Date() >= circuit.nextRetry) {\n        circuit.state = 'half-open';\n        circuit.successes = 0;\n        return; // Allow test request\n      }\n\n      throw new CircuitOpenError(\n        model,\n        circuit.nextRetry ?? new Date(Date.now() + this.config.resetTimeout),\n      );\n    }\n\n    // half-open: allow request\n  }\n\n  /**\n   * Record a successful request\n   */\n  recordSuccess(model: Model): void {\n    const circuit = this.getCircuit(model);\n\n    if (circuit.state === 'half-open') {\n      circuit.successes++;\n\n      if (circuit.successes >= this.config.successThreshold) {\n        // Close the circuit\n        circuit.state = 'closed';\n        circuit.failures = 0;\n        circuit.successes = 0;\n        circuit.nextRetry = null;\n      }\n    } else if (circuit.state === 'closed') {\n      // Reset failure count on success\n      circuit.failures = 0;\n    }\n  }\n\n  /**\n   * Record a failed request\n   */\n  recordFailure(model: Model): void {\n    const circuit = this.getCircuit(model);\n    circuit.failures++;\n    circuit.lastFailure = new Date();\n\n    if (circuit.state === 'half-open') {\n      // Failed during half-open, re-open circuit\n      circuit.state = 'open';\n      circuit.nextRetry = new Date(Date.now() + this.config.resetTimeout);\n    } else if (circuit.state === 'closed' && circuit.failures >= this.config.failureThreshold) {\n      // Threshold reached, open circuit\n      circuit.state = 'open';\n      circuit.nextRetry = new Date(Date.now() + this.config.resetTimeout);\n    }\n  }\n\n  /**\n   * Get current circuit state\n   */\n  getState(model: Model): CircuitState {\n    return this.getCircuit(model).state;\n  }\n\n  /**\n   * Manually reset a circuit\n   */\n  reset(model: Model): void {\n    this.circuits.delete(model);\n  }\n\n  /**\n   * Reset all circuits\n   */\n  resetAll(): void {\n    this.circuits.clear();\n  }\n}\n"],"mappings":"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"}

package/dist/circuit-breaker-Mey3E7tW.d.mts

@@ -0,0 +1,64 @@
+import { Nr as SDKLanguageModel, Ur as SDKLanguageModelV3Middleware } from "./ai-runtime-DIwOEc6g.mjs";
+import { n as Model } from "./registry-DVPWzkXR.mjs";
+
+//#region src/agents/fallback/types.d.ts
+interface FallbackConfig {
+  primary: Model;
+  fallbacks: Model[];
+  resolveModel?: (model: Model) => SDKLanguageModel;
+  maxRetries?: number;
+  retryDelay?: number;
+  exponentialBackoff?: boolean;
+}
+interface FallbackResult<T> {
+  result: T;
+  model: Model;
+  attempts: number;
+  failedModels: Array<{
+    model: Model;
+    error: Error;
+    attempts: number;
+  }>;
+}
+type CircuitState = 'closed' | 'open' | 'half-open';
+interface CircuitBreakerConfig {
+  failureThreshold: number;
+  resetTimeout: number;
+  successThreshold?: number;
+}
+declare class AllModelsFailedError extends Error {
+  readonly failures: Array<{
+    model: Model;
+    error: Error;
+  }>;
+  constructor(message: string, failures: Array<{
+    model: Model;
+    error: Error;
+  }>);
+}
+declare class CircuitOpenError extends Error {
+  readonly model: Model;
+  readonly resetTime: Date;
+  constructor(model: Model, resetTime: Date);
+}
+//#endregion
+//#region src/agents/fallback/strategies/model-fallback.d.ts
+declare function executeWithFallback<T>(config: FallbackConfig, execute: (model: SDKLanguageModel) => Promise<T>): Promise<FallbackResult<T>>;
+declare function createFallbackMiddleware(config: FallbackConfig): SDKLanguageModelV3Middleware;
+//#endregion
+//#region src/agents/fallback/recovery/circuit-breaker.d.ts
+declare class CircuitBreaker {
+  private circuits;
+  private config;
+  constructor(config: CircuitBreakerConfig);
+  private getCircuit;
+  checkCircuit(model: Model): void;
+  recordSuccess(model: Model): void;
+  recordFailure(model: Model): void;
+  getState(model: Model): CircuitState;
+  reset(model: Model): void;
+  resetAll(): void;
+}
+//#endregion
+export { CircuitBreakerConfig as a, FallbackConfig as c, AllModelsFailedError as i, FallbackResult as l, createFallbackMiddleware as n, CircuitOpenError as o, executeWithFallback as r, CircuitState as s, CircuitBreaker as t };
+//# sourceMappingURL=circuit-breaker-Mey3E7tW.d.mts.map

package/dist/circuit-breaker-Mey3E7tW.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker-Mey3E7tW.d.mts","names":[],"sources":["../src/agents/fallback/types.ts","../src/agents/fallback/strategies/model-fallback.ts","../src/agents/fallback/recovery/circuit-breaker.ts"],"mappings":";;;;UAUiB,cAAA;EAEf,OAAA,EAAS,KAAA;EAET,SAAA,EAAW,KAAA;EAEX,YAAA,IAAgB,KAAA,EAAO,KAAA,KAAU,gBAAA;EAEjC,UAAA;EAEA,UAAA;EAEA,kBAAA;AAAA;AAAA,UAMe,cAAA;EAEf,MAAA,EAAQ,CAAA;EAER,KAAA,EAAO,KAAA;EAEP,QAAA;EAEA,YAAA,EAAc,KAAA;IACZ,KAAA,EAAO,KAAA;IACP,KAAA,EAAO,KAAA;IACP,QAAA;EAAA;AAAA;AAAA,KAOQ,YAAA;AAAA,UAKK,oBAAA;EAEf,gBAAA;EAEA,YAAA;EAEA,gBAAA;AAAA;AAAA,cAMW,oBAAA,SAA6B,KAAA;EAAA,SAGtB,QAAA,EAAU,KAAA;IAAQ,KAAA,EAAO,KAAA;IAAO,KAAA,EAAO,KAAA;EAAA;cADvD,OAAA,UACgB,QAAA,EAAU,KAAA;IAAQ,KAAA,EAAO,KAAA;IAAO,KAAA,EAAO,KAAA;EAAA;AAAA;AAAA,cAW9C,gBAAA,SAAyB,KAAA;EAAA,SAElB,KAAA,EAAO,KAAA;EAAA,SACP,SAAA,EAAW,IAAA;cADX,KAAA,EAAO,KAAA,EACP,SAAA,EAAW,IAAA;AAAA;;;iBCzCT,mBAAA,GAAA,CACpB,MAAA,EAAQ,cAAA,EACR,OAAA,GAAU,KAAA,EAAO,gBAAA,KAAqB,OAAA,CAAQ,CAAA,IAC7C,OAAA,CAAQ,cAAA,CAAe,CAAA;AAAA,iBA4FV,wBAAA,CAAyB,MAAA,EAAQ,cAAA,GAAiB,4BAAA;;;cC3FrD,cAAA;EAAA,QACH,QAAA;EAAA,QACA,MAAA;cAEI,MAAA,EAAQ,oBAAA;EAAA,QAWZ,UAAA;EAsBR,YAAA,CAAa,KAAA,EAAO,KAAA;EA2BpB,aAAA,CAAc,KAAA,EAAO,KAAA;EAsBrB,aAAA,CAAc,KAAA,EAAO,KAAA;EAmBrB,QAAA,CAAS,KAAA,EAAO,KAAA,GAAQ,YAAA;EAOxB,KAAA,CAAM,KAAA,EAAO,KAAA;EAOb,QAAA,CAAA;AAAA"}

package/dist/citation-generator-C-9RpbHq.mjs

@@ -0,0 +1,103 @@
+//#region src/grounding/citation/citation-generator.ts
+/**
+* Generate citations for grounded text
+*
+* @example
+* ```ts
+* const citations = generateCitations(
+*   "AI is powerful [1]. It transforms industries [2].",
+*   sources,
+*   { format: "footnote" }
+* );
+* ```
+*/
+function generateCitations(text, sources, options = {}) {
+	const format = options.format ?? "inline";
+	const citations = [];
+	const markerPattern = /\[(\d+)\]/g;
+	let match;
+	while ((match = markerPattern.exec(text)) !== null) {
+		const token = match[1];
+		if (!token) continue;
+		const index = parseInt(token, 10) - 1;
+		if (index >= 0 && index < sources.length) {
+			const source = sources[index];
+			if (!source) continue;
+			const citedText = extractCitedText(text, match.index);
+			citations.push({
+				id: `cite-${citations.length + 1}`,
+				sourceId: source.id,
+				citedText,
+				position: {
+					start: match.index,
+					end: match.index + match[0].length
+				}
+			});
+		}
+	}
+	if (citations.length === 0 && format !== "inline" && sources.length > 0) {
+		const endPosition = text.length;
+		const citedText = extractCitedText(text, endPosition);
+		sources.forEach((source, index) => {
+			citations.push({
+				id: `cite-${index + 1}`,
+				sourceId: source.id,
+				citedText,
+				position: {
+					start: endPosition,
+					end: endPosition
+				}
+			});
+		});
+	}
+	return citations;
+}
+/**
+* Extract the text being cited (preceding content)
+*/
+function extractCitedText(text, citationPos) {
+	const beforeCitation = text.slice(0, citationPos);
+	const sentenceMatch = beforeCitation.match(/[.!?]\s*([^.!?]+)$/);
+	if (sentenceMatch?.[1]) return sentenceMatch[1].trim();
+	return beforeCitation.slice(-100).trim();
+}
+/**
+* Format citations as footnotes
+*/
+function formatAsFootnotes(text, sources, options = {}) {
+	const { includeUrls = true, template } = options;
+	let footnotes = "\n\n---\n";
+	sources.forEach((source, index) => {
+		const num = index + 1;
+		if (template) footnotes += `[${num}] ${template(source, index)}\n`;
+		else {
+			let citation = `[${num}] ${source.title || source.id}`;
+			if (includeUrls && source.url) citation += ` - ${source.url}`;
+			footnotes += `${citation}\n`;
+		}
+	});
+	return text + footnotes;
+}
+/**
+* Verify that all claims in text are grounded in sources
+*/
+function verifyClaims(text, sources) {
+	const sentences = text.split(/[.!?]+/).filter((s) => s.trim());
+	const ungroundedClaims = [];
+	const sourceText = sources.map((s) => s.content.toLowerCase()).join(" ");
+	for (const sentence of sentences) {
+		const trimmed = sentence.trim();
+		if (trimmed.length < 20) continue;
+		const keyPhrases = trimmed.toLowerCase().split(/\s+/).filter((w) => w.length > 4);
+		const matchCount = keyPhrases.filter((phrase) => sourceText.includes(phrase)).length;
+		if ((keyPhrases.length > 0 ? matchCount / keyPhrases.length : 0) < .3) ungroundedClaims.push(trimmed);
+	}
+	return {
+		verified: ungroundedClaims.length === 0,
+		ungroundedClaims
+	};
+}
+
+//#endregion
+export { generateCitations as n, verifyClaims as r, formatAsFootnotes as t };
+//# sourceMappingURL=citation-generator-C-9RpbHq.mjs.map

package/dist/citation-generator-C-9RpbHq.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-generator-C-9RpbHq.mjs","names":[],"sources":["../src/grounding/citation/citation-generator.ts"],"sourcesContent":["/**\n * Citation generation utilities\n */\n\nimport type { Citation, GroundingSource } from '../types';\n\n/**\n * Citation format options\n */\nexport type CitationFormat = 'inline' | 'footnote' | 'endnote';\n\n/**\n * Citation generator options\n */\nexport interface CitationGeneratorOptions {\n  /** Citation format */\n  format?: CitationFormat;\n  /** Whether to include source URLs */\n  includeUrls?: boolean;\n  /** Custom citation template */\n  template?: (source: GroundingSource, index: number) => string;\n}\n\n/**\n * Generate citations for grounded text\n *\n * @example\n * ```ts\n * const citations = generateCitations(\n *   \"AI is powerful [1]. It transforms industries [2].\",\n *   sources,\n *   { format: \"footnote\" }\n * );\n * ```\n */\nexport function generateCitations(\n  text: string,\n  sources: GroundingSource[],\n  options: CitationGeneratorOptions = {},\n): Citation[] {\n  const format = options.format ?? 'inline';\n  const citations: Citation[] = [];\n\n  // Find citation markers [1], [2], etc.\n  const markerPattern = /\\[(\\d+)\\]/g;\n  let match;\n\n  while ((match = markerPattern.exec(text)) !== null) {\n    const token = match[1];\n    if (!token) {\n      continue;\n    }\n    const index = parseInt(token, 10) - 1;\n    if (index >= 0 && index < sources.length) {\n      const source = sources[index];\n      if (!source) {\n        continue;\n      }\n\n      // Find the text being cited (preceding sentence or clause)\n      const citedText = extractCitedText(text, match.index);\n\n      citations.push({\n        id: `cite-${citations.length + 1}`,\n        sourceId: source.id,\n        citedText,\n        position: {\n          start: match.index,\n          end: match.index + match[0].length,\n        },\n      });\n    }\n  }\n\n  if (citations.length === 0 && format !== 'inline' && sources.length > 0) {\n    const endPosition = text.length;\n    const citedText = extractCitedText(text, endPosition);\n\n    sources.forEach((source, index) => {\n      citations.push({\n        id: `cite-${index + 1}`,\n        sourceId: source.id,\n        citedText,\n        position: {\n          start: endPosition,\n          end: endPosition,\n        },\n      });\n    });\n  }\n\n  return citations;\n}\n\n/**\n * Extract the text being cited (preceding content)\n */\nfunction extractCitedText(text: string, citationPos: number): string {\n  // Look back for sentence boundary\n  const beforeCitation = text.slice(0, citationPos);\n  const sentenceMatch = beforeCitation.match(/[.!?]\\s*([^.!?]+)$/);\n\n  if (sentenceMatch?.[1]) {\n    return sentenceMatch[1].trim();\n  }\n\n  // If no sentence boundary, take last 100 characters\n  return beforeCitation.slice(-100).trim();\n}\n\n/**\n * Format citations as footnotes\n */\nexport function formatAsFootnotes(\n  text: string,\n  sources: GroundingSource[],\n  options: CitationGeneratorOptions = {},\n): string {\n  const { includeUrls = true, template } = options;\n\n  let footnotes = '\\n\\n---\\n';\n\n  sources.forEach((source, index) => {\n    const num = index + 1;\n    if (template) {\n      footnotes += `[${num}] ${template(source, index)}\\n`;\n    } else {\n      let citation = `[${num}] ${source.title || source.id}`;\n      if (includeUrls && source.url) {\n        citation += ` - ${source.url}`;\n      }\n      footnotes += `${citation}\\n`;\n    }\n  });\n\n  return text + footnotes;\n}\n\n/**\n * Verify that all claims in text are grounded in sources\n */\nexport function verifyClaims(\n  text: string,\n  sources: GroundingSource[],\n): { verified: boolean; ungroundedClaims: string[] } {\n  // Simple heuristic: check if key phrases appear in sources\n  const sentences = text.split(/[.!?]+/).filter(s => s.trim());\n  const ungroundedClaims: string[] = [];\n\n  const sourceText = sources.map(s => s.content.toLowerCase()).join(' ');\n\n  for (const sentence of sentences) {\n    const trimmed = sentence.trim();\n    if (trimmed.length < 20) continue; // Skip short fragments\n\n    // Extract key phrases (nouns and noun phrases)\n    const words = trimmed.toLowerCase().split(/\\s+/);\n    const keyPhrases = words.filter(w => w.length > 4);\n\n    // Check if at least half of key phrases appear in sources\n    const matchCount = keyPhrases.filter(phrase => sourceText.includes(phrase)).length;\n\n    const matchRatio = keyPhrases.length > 0 ? matchCount / keyPhrases.length : 0;\n\n    if (matchRatio < 0.3) {\n      ungroundedClaims.push(trimmed);\n    }\n  }\n\n  return {\n    verified: ungroundedClaims.length === 0,\n    ungroundedClaims,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAmCA,SAAgB,kBACd,MACA,SACA,UAAoC,EAAE,EAC1B;CACZ,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,YAAwB,EAAE;CAGhC,MAAM,gBAAgB;CACtB,IAAI;AAEJ,SAAQ,QAAQ,cAAc,KAAK,KAAK,MAAM,MAAM;EAClD,MAAM,QAAQ,MAAM;AACpB,MAAI,CAAC,MACH;EAEF,MAAM,QAAQ,SAAS,OAAO,GAAG,GAAG;AACpC,MAAI,SAAS,KAAK,QAAQ,QAAQ,QAAQ;GACxC,MAAM,SAAS,QAAQ;AACvB,OAAI,CAAC,OACH;GAIF,MAAM,YAAY,iBAAiB,MAAM,MAAM,MAAM;AAErD,aAAU,KAAK;IACb,IAAI,QAAQ,UAAU,SAAS;IAC/B,UAAU,OAAO;IACjB;IACA,UAAU;KACR,OAAO,MAAM;KACb,KAAK,MAAM,QAAQ,MAAM,GAAG;KAC7B;IACF,CAAC;;;AAIN,KAAI,UAAU,WAAW,KAAK,WAAW,YAAY,QAAQ,SAAS,GAAG;EACvE,MAAM,cAAc,KAAK;EACzB,MAAM,YAAY,iBAAiB,MAAM,YAAY;AAErD,UAAQ,SAAS,QAAQ,UAAU;AACjC,aAAU,KAAK;IACb,IAAI,QAAQ,QAAQ;IACpB,UAAU,OAAO;IACjB;IACA,UAAU;KACR,OAAO;KACP,KAAK;KACN;IACF,CAAC;IACF;;AAGJ,QAAO;;;;;AAMT,SAAS,iBAAiB,MAAc,aAA6B;CAEnE,MAAM,iBAAiB,KAAK,MAAM,GAAG,YAAY;CACjD,MAAM,gBAAgB,eAAe,MAAM,qBAAqB;AAEhE,KAAI,gBAAgB,GAClB,QAAO,cAAc,GAAG,MAAM;AAIhC,QAAO,eAAe,MAAM,KAAK,CAAC,MAAM;;;;;AAM1C,SAAgB,kBACd,MACA,SACA,UAAoC,EAAE,EAC9B;CACR,MAAM,EAAE,cAAc,MAAM,aAAa;CAEzC,IAAI,YAAY;AAEhB,SAAQ,SAAS,QAAQ,UAAU;EACjC,MAAM,MAAM,QAAQ;AACpB,MAAI,SACF,cAAa,IAAI,IAAI,IAAI,SAAS,QAAQ,MAAM,CAAC;OAC5C;GACL,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,SAAS,OAAO;AAClD,OAAI,eAAe,OAAO,IACxB,aAAY,MAAM,OAAO;AAE3B,gBAAa,GAAG,SAAS;;GAE3B;AAEF,QAAO,OAAO;;;;;AAMhB,SAAgB,aACd,MACA,SACmD;CAEnD,MAAM,YAAY,KAAK,MAAM,SAAS,CAAC,QAAO,MAAK,EAAE,MAAM,CAAC;CAC5D,MAAM,mBAA6B,EAAE;CAErC,MAAM,aAAa,QAAQ,KAAI,MAAK,EAAE,QAAQ,aAAa,CAAC,CAAC,KAAK,IAAI;AAEtE,MAAK,MAAM,YAAY,WAAW;EAChC,MAAM,UAAU,SAAS,MAAM;AAC/B,MAAI,QAAQ,SAAS,GAAI;EAIzB,MAAM,aADQ,QAAQ,aAAa,CAAC,MAAM,MAAM,CACvB,QAAO,MAAK,EAAE,SAAS,EAAE;EAGlD,MAAM,aAAa,WAAW,QAAO,WAAU,WAAW,SAAS,OAAO,CAAC,CAAC;AAI5E,OAFmB,WAAW,SAAS,IAAI,aAAa,WAAW,SAAS,KAE3D,GACf,kBAAiB,KAAK,QAAQ;;AAIlC,QAAO;EACL,UAAU,iBAAiB,WAAW;EACtC;EACD"}

package/dist/citation-generator-CDSymDs_.d.mts

@@ -0,0 +1,18 @@
+import { i as GroundingSource, t as Citation } from "./types-D3zJb59_.mjs";
+
+//#region src/grounding/citation/citation-generator.d.ts
+type CitationFormat = 'inline' | 'footnote' | 'endnote';
+interface CitationGeneratorOptions {
+  format?: CitationFormat;
+  includeUrls?: boolean;
+  template?: (source: GroundingSource, index: number) => string;
+}
+declare function generateCitations(text: string, sources: GroundingSource[], options?: CitationGeneratorOptions): Citation[];
+declare function formatAsFootnotes(text: string, sources: GroundingSource[], options?: CitationGeneratorOptions): string;
+declare function verifyClaims(text: string, sources: GroundingSource[]): {
+  verified: boolean;
+  ungroundedClaims: string[];
+};
+//#endregion
+export { verifyClaims as a, generateCitations as i, CitationGeneratorOptions as n, formatAsFootnotes as r, CitationFormat as t };
+//# sourceMappingURL=citation-generator-CDSymDs_.d.mts.map

package/dist/citation-generator-CDSymDs_.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-generator-CDSymDs_.d.mts","names":[],"sources":["../src/grounding/citation/citation-generator.ts"],"mappings":";;;KASY,cAAA;AAAA,UAKK,wBAAA;EAEf,MAAA,GAAS,cAAA;EAET,WAAA;EAEA,QAAA,IAAY,MAAA,EAAQ,eAAA,EAAiB,KAAA;AAAA;AAAA,iBAevB,iBAAA,CACd,IAAA,UACA,OAAA,EAAS,eAAA,IACT,OAAA,GAAS,wBAAA,GACR,QAAA;AAAA,iBA0Ea,iBAAA,CACd,IAAA,UACA,OAAA,EAAS,eAAA,IACT,OAAA,GAAS,wBAAA;AAAA,iBAyBK,YAAA,CACd,IAAA,UACA,OAAA,EAAS,eAAA;EACN,QAAA;EAAmB,gBAAA;AAAA"}