adonis-ai-kit 0.0.0-stage → 1.2.0

package/dist/src/types.d.ts

@@ -0,0 +1,340 @@
+import type { z } from 'zod';
+import type { LanguageModel, ModelMessage, StepResult, StopCondition, StreamTextResult as AiStreamTextResult, TextStreamPart, ToolSet } from 'ai';
+import type { ModelPricing } from './budget/types.js';
+import type { ActionGuard, ToolPermission } from './guard/types.js';
+import type { ConfirmationService } from './guard/confirmation.js';
+import type { AcpProviderConfig } from './acp/types.js';
+import type { ModelResolver } from './models/catalog_resolver.js';
+import type { LanguageModelFactory } from './models/language_model_factory.js';
+import type { FallbackEvent } from './models/model_chain.js';
+import type { ResolvedModel } from './models/types.js';
+export type CircuitBreakerState = 'closed' | 'open' | 'half_open';
+export interface CircuitBreakerConfig {
+    /**
+     * Number of consecutive failures before opening the circuit breaker.
+     * Default: 5
+     */
+    failureThreshold?: number;
+    /**
+     * Cooldown period in milliseconds before attempting recovery.
+     * Default: 30000 (30 seconds)
+     */
+    recoveryTimeoutMs?: number;
+    /**
+     * Number of SUCCESSFUL probe requests in half-open state required to close the circuit.
+     * Default: 2
+     */
+    halfOpenMaxAttempts?: number;
+    /**
+     * Maximum number of probe requests allowed in flight at the same time while half-open.
+     * Further requests are rejected until a probe finishes. Default: 1
+     */
+    halfOpenMaxConcurrent?: number;
+    /**
+     * Optional callback when circuit breaker state changes. Errors thrown here are swallowed.
+     * The first argument is the breaker key (`provider:model`).
+     */
+    onStateChange?: (key: string, from: CircuitBreakerState, to: CircuitBreakerState) => void;
+}
+export interface CircuitBreakerStats {
+    state: CircuitBreakerState;
+    failures: number;
+    successes: number;
+    lastFailureTime: number | null;
+    nextAttemptAllowedAt: number | null;
+}
+export interface BaseProviderConfig {
+    defaultModel?: string;
+    headers?: Record<string, string>;
+    baseURL?: string;
+}
+export interface OpenAIProviderConfig extends BaseProviderConfig {
+    driver: 'openai';
+    apiKey?: string;
+    organization?: string;
+    project?: string;
+}
+export interface AnthropicProviderConfig extends BaseProviderConfig {
+    driver: 'anthropic';
+    apiKey?: string;
+}
+export interface GoogleProviderConfig extends BaseProviderConfig {
+    driver: 'google' | 'gemini';
+    apiKey?: string;
+}
+export interface GroqProviderConfig extends BaseProviderConfig {
+    driver: 'groq';
+    apiKey?: string;
+}
+export interface OllamaProviderConfig extends BaseProviderConfig {
+    driver: 'ollama';
+    baseURL?: string;
+}
+export interface CustomProviderConfig extends BaseProviderConfig {
+    driver: 'custom';
+    /** Returns an AI SDK language model, or a function `(modelId) => LanguageModel`. */
+    factory: (config: CustomProviderConfig) => Promise<LanguageModel | ((modelId: string) => LanguageModel)> | LanguageModel | ((modelId: string) => LanguageModel);
+}
+export type { AcpProviderConfig, AcpMcpServerConfig, AcpAgentConfig, AcpAgentRuntimeConfig, AcpPermissionPolicy, } from './acp/types.js';
+export type ProviderConfig = OpenAIProviderConfig | AnthropicProviderConfig | GoogleProviderConfig | GroqProviderConfig | OllamaProviderConfig | AcpProviderConfig | CustomProviderConfig;
+export interface BudgetConfig {
+    maxTokensPerRequest?: number;
+    maxCostPerRequestUsd?: number;
+    defaultAgentName?: string;
+    pricing?: Record<string, ModelPricing>;
+}
+export interface CatalogConfig {
+    /**
+     * Whether to prefer cached models.dev catalog if available.
+     * Default: true
+     */
+    preferCache?: boolean;
+    /**
+     * Custom path to models.dev.json cache file.
+     */
+    cachePath?: string;
+    /**
+     * Custom path to override models catalog json file.
+     */
+    overridePath?: string;
+    /**
+     * Which system providers to inject into the catalog when missing: built-in
+     * `fallback` providers (openai / anthropic / google) and `acp` agents (`acp-<id>`).
+     * Both default to true.
+     */
+    systemProviders?: {
+        fallback?: boolean;
+        acp?: boolean;
+    };
+    /**
+     * Whether to automatically fetch and update model pricing from models.dev into the budget tracker.
+     * Default: true
+     */
+    autoPricing?: boolean;
+    /**
+     * How long a cached catalog (memory and disk) stays fresh before it is refreshed, in ms.
+     * Default: 24 hours
+     */
+    ttlMs?: number;
+}
+export interface AiConfig {
+    /**
+     * Default provider key (e.g. 'openai')
+     */
+    default: string;
+    /**
+     * Configured providers
+     */
+    providers: Record<string, ProviderConfig>;
+    /**
+     * Ordered list of provider keys to try if the primary provider fails.
+     * Only providers listed here are used as fallbacks; ACP agents (local CLIs with shell/file
+     * access) are never added automatically.
+     */
+    fallbackCascade?: string[];
+    /**
+     * Model to use on a given fallback provider. When absent, the fallback provider's own
+     * `defaultModel` is used; the model requested for the primary provider is never forwarded.
+     */
+    fallbackModels?: Record<string, string>;
+    /**
+     * Resilience circuit breaker configuration
+     */
+    circuitBreaker?: CircuitBreakerConfig;
+    /**
+     * Token and cost budget configuration
+     */
+    budget?: BudgetConfig;
+    /**
+     * models.dev catalog discovery & metadata caching configuration
+     */
+    catalog?: CatalogConfig;
+    /**
+     * Path to agent configuration markdown files directory (defaults to resources/agent-configs)
+     */
+    agentConfigsDir?: string;
+    /**
+     * Path to agent skills markdown files directory (defaults to resources/agent-skills)
+     */
+    agentSkillsDir?: string;
+    /**
+     * Whether to log detailed AI calls
+     */
+    logging?: boolean;
+    /** Resolves string entries of a call's `models` chain. Required to use model references there. */
+    resolver?: ModelResolver;
+    /** Builds language models for `models` chains. Defaults to a `LanguageModelFactory` created lazily. */
+    languageModels?: LanguageModelFactory;
+}
+/** Options shared by calls that can run over a dynamic model chain. */
+export interface ModelChainCallOptions {
+    /**
+     * Ordered chain of models (resolved models or references). When non-empty, the provider cascade
+     * is not used: each entry is tried in order with its own per-credential circuit breaker.
+     */
+    models?: Array<ResolvedModel | string>;
+    /** Called when a model failed with a retryable error, or could not be attempted (missing provider package, config error, open breaker), and the next entry is about to be tried. */
+    onFallback?: (event: FallbackEvent) => unknown;
+}
+export interface AiDriver {
+    readonly name: string;
+    readonly defaultModel: string;
+    getModel(modelName?: string): LanguageModel | Promise<LanguageModel>;
+    ping?(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        error?: string;
+    }>;
+    /** Releases resources held by the driver (e.g. child processes). */
+    shutdown?(): Promise<void> | void;
+}
+export type ChatRole = 'system' | 'user' | 'assistant' | 'tool';
+/** Chat messages use the AI SDK's `ModelMessage` shape. */
+export type ChatMessage = ModelMessage;
+/**
+ * Token usage normalized from AI SDK v7 (`inputTokens` / `outputTokens` / `*TokenDetails`).
+ * `inputTokens` includes cached tokens; `outputTokens` includes reasoning tokens.
+ */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    reasoningTokens: number;
+    /** @deprecated Alias of `inputTokens` (AI SDK v4 name). */
+    promptTokens: number;
+    /** @deprecated Alias of `outputTokens` (AI SDK v4 name). */
+    completionTokens: number;
+}
+export interface ToolGuardOptions {
+    guard?: ActionGuard;
+    confirmation?: ConfirmationService;
+    sessionId?: string;
+    /** Confirmation timeout for `ask` tools, in ms. */
+    timeoutMs?: number;
+}
+export interface GenerateTextOptions extends ModelChainCallOptions {
+    prompt?: string;
+    messages?: ModelMessage[];
+    system?: string;
+    provider?: string;
+    model?: string;
+    temperature?: number;
+    /** Maximum number of tokens to generate (AI SDK v7 `maxOutputTokens`). */
+    maxOutputTokens?: number;
+    /** @deprecated Use `maxOutputTokens`. */
+    maxTokens?: number;
+    topP?: number;
+    tools?: ToolSet;
+    /**
+     * Per-tool permissions applied by the manager. `deny` tools are dropped, `ask` tools need a
+     * human confirmation, tools not listed are `allow`.
+     */
+    toolPermissions?: Record<string, ToolPermission>;
+    /** Maximum number of model steps in a tool loop (mapped to `stopWhen: stepCountIs(n)`). */
+    maxSteps?: number;
+    /** Custom stop condition(s) for the tool loop. Takes precedence over `maxSteps`. */
+    stopWhen?: StopCondition<ToolSet> | StopCondition<ToolSet>[];
+    /** Structured output schema; the parsed value is exposed as `output`. Works together with `tools`. */
+    schema?: z.ZodType;
+    /** Provider call retries performed by the AI SDK (SDK default applies when omitted). */
+    maxRetries?: number;
+    /** Called after every model step. Callback errors are logged and ignored. */
+    onStepFinish?: (step: StepResult<ToolSet>) => void | Promise<void>;
+    agentName?: string;
+    abortSignal?: AbortSignal;
+    metadata?: Record<string, unknown>;
+    toolGuard?: ToolGuardOptions;
+}
+export interface GenerateTextResult {
+    text: string;
+    usage: TokenUsage;
+    costUsd?: number;
+    finishReason: string;
+    provider: string;
+    model: string;
+    toolCalls?: unknown[];
+    toolResults?: unknown[];
+    steps?: unknown[];
+    /** Parsed structured output, present when `schema` was given. */
+    output?: unknown;
+    /** Provider response metadata (`result.response` of the AI SDK). */
+    rawResponse?: unknown;
+    durationMs: number;
+}
+export interface StreamTextOptions extends GenerateTextOptions {
+    /** Called for every text delta once the stream is consumed. */
+    onChunk?: (chunk: string) => void;
+    onFinish?: (result: {
+        text: string;
+        usage: TokenUsage;
+        costUsd?: number;
+    }) => void;
+}
+export type AiStreamPart = TextStreamPart<ToolSet>;
+export interface StreamTextResult {
+    textStream: AsyncIterable<string>;
+    fullStream: AsyncIterable<AiStreamPart>;
+    provider: string;
+    model: string;
+    /** Resolves when the stream ends, is aborted, or fails (never rejects, never hangs forever). */
+    usage: Promise<TokenUsage>;
+    /**
+     * Parsed structured output. Resolves to `undefined` when no `schema` was given; may reject when the
+     * stream fails or is aborted, or when the output does not match the schema. With `schema`, the stream
+     * is consumed to completion in the background so this settles even if nothing else reads the stream.
+     */
+    output: Promise<unknown>;
+    toTextStreamResponse(headers?: Record<string, string>): Response;
+    /** AI SDK UI message stream (compatible with `useChat`). */
+    toUIMessageStreamResponse(options?: Parameters<AiStreamTextResult<ToolSet, any, any>['toUIMessageStreamResponse']>[0]): Response;
+    /** @deprecated `toDataStreamResponse` was removed in AI SDK v5; alias of `toUIMessageStreamResponse`. */
+    toDataStreamResponse(headers?: Record<string, string>): Response;
+    consume(): Promise<GenerateTextResult>;
+    /** Cancels the underlying generation (e.g. when the HTTP client disconnected). */
+    abort(reason?: unknown): void;
+    rawStream: AiStreamTextResult<ToolSet, any, any>;
+}
+export interface GenerateObjectOptions<T> extends ModelChainCallOptions {
+    prompt?: string;
+    messages?: ModelMessage[];
+    system?: string;
+    provider?: string;
+    model?: string;
+    schema: z.ZodType<T>;
+    schemaName?: string;
+    schemaDescription?: string;
+    agentName?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+    /** @deprecated Use `maxOutputTokens`. */
+    maxTokens?: number;
+    abortSignal?: AbortSignal;
+}
+export interface GenerateObjectResult<T> {
+    object: T;
+    usage: TokenUsage;
+    costUsd?: number;
+    provider: string;
+    model: string;
+    durationMs: number;
+}
+export interface StreamAIOptions {
+    /**
+     * `sse`  - legacy `event: message` frames with JSON `{type:'chunk',text}` and a `[DONE]` sentinel
+     * `ui`   - AI SDK UI message stream (use with `useChat`)
+     * `text` - raw text chunks
+     */
+    mode?: 'sse' | 'ui' | 'text';
+    event?: string;
+    onChunk?: (chunk: string) => void;
+    onFinish?: (fullText: string) => void;
+    onError?: (error: Error) => void;
+    headers?: Record<string, string>;
+    /** Interval of SSE keep-alive comments in ms. 0 disables. Default: 15000 */
+    heartbeatMs?: number;
+    /** Include `error.message` in SSE error events. Default: false (generic message). */
+    exposeErrors?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/src/usage.d.ts

@@ -0,0 +1,13 @@
+import type { TokenUsage } from './types.js';
+export declare const EMPTY_USAGE: Readonly<TokenUsage>;
+/**
+ * Normalizes AI SDK usage into `TokenUsage`.
+ *
+ * Reads the v7 shape (`inputTokens`, `outputTokens`, `inputTokenDetails.cacheReadTokens`,
+ * `outputTokenDetails.reasoningTokens`) and falls back to the legacy v4 names
+ * (`promptTokens`, `completionTokens`, `cachedInputTokens`, `reasoningTokens`).
+ */
+export declare function normalizeUsage(raw: unknown): TokenUsage;
+/** Sums usage over several steps (used when a stream is aborted before the final total exists). */
+export declare function sumUsage(items: unknown[]): TokenUsage;
+//# sourceMappingURL=usage.d.ts.map

package/dist/src/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAU5C,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,UAAU,CAS3C,CAAA;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAuBvD;AAED,mGAAmG;AACnG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,CAcrD"}

package/dist/src/usage.js

@@ -0,0 +1,61 @@
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0;
+}
+function obj(value) {
+    return value !== null && typeof value === 'object' ? value : {};
+}
+export const EMPTY_USAGE = Object.freeze({
+    inputTokens: 0,
+    outputTokens: 0,
+    totalTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0,
+    reasoningTokens: 0,
+    promptTokens: 0,
+    completionTokens: 0,
+});
+/**
+ * Normalizes AI SDK usage into `TokenUsage`.
+ *
+ * Reads the v7 shape (`inputTokens`, `outputTokens`, `inputTokenDetails.cacheReadTokens`,
+ * `outputTokenDetails.reasoningTokens`) and falls back to the legacy v4 names
+ * (`promptTokens`, `completionTokens`, `cachedInputTokens`, `reasoningTokens`).
+ */
+export function normalizeUsage(raw) {
+    const u = obj(raw);
+    const inputDetails = obj(u.inputTokenDetails);
+    const outputDetails = obj(u.outputTokenDetails);
+    const inputTokens = num(u.inputTokens) || num(u.promptTokens);
+    const outputTokens = num(u.outputTokens) || num(u.completionTokens);
+    const cacheReadTokens = num(inputDetails.cacheReadTokens) || num(u.cacheReadTokens) || num(u.cachedInputTokens);
+    const cacheWriteTokens = num(inputDetails.cacheWriteTokens) || num(u.cacheWriteTokens);
+    const reasoningTokens = num(outputDetails.reasoningTokens) || num(u.reasoningTokens);
+    const totalTokens = num(u.totalTokens) || inputTokens + outputTokens;
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens,
+        cacheReadTokens,
+        cacheWriteTokens,
+        reasoningTokens,
+        promptTokens: inputTokens,
+        completionTokens: outputTokens,
+    };
+}
+/** Sums usage over several steps (used when a stream is aborted before the final total exists). */
+export function sumUsage(items) {
+    const total = { ...EMPTY_USAGE };
+    for (const item of items) {
+        const u = normalizeUsage(item);
+        total.inputTokens += u.inputTokens;
+        total.outputTokens += u.outputTokens;
+        total.totalTokens += u.totalTokens;
+        total.cacheReadTokens += u.cacheReadTokens;
+        total.cacheWriteTokens += u.cacheWriteTokens;
+        total.reasoningTokens += u.reasoningTokens;
+    }
+    total.promptTokens = total.inputTokens;
+    total.completionTokens = total.outputTokens;
+    return total;
+}
+//# sourceMappingURL=usage.js.map

package/dist/src/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/usage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,210 @@
 {
   "name": "adonis-ai-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.0",
+  "description": "Production-ready AI & Agentic workflow kit for AdonisJS 7 (Vercel AI SDK v7, multi-provider fallbacks, ACP & token budget enforcement)",
+  "keywords": [
+    "adonisjs",
+    "adonisjs-7",
+    "ai",
+    "llm",
+    "prism",
+    "laravel-ai",
+    "models-dev",
+    "acp",
+    "agent-client-protocol",
+    "mcp",
+    "skills",
+    "agents",
+    "streaming",
+    "sse",
+    "circuit-breaker",
+    "token-budget",
+    "tool-guard",
+    "hitl",
+    "guardrails"
+  ],
+  "author": "Ivan Glazyrin <glazrus97@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./guard": {
+      "types": "./dist/src/guard/index.d.ts",
+      "import": "./dist/src/guard/index.js"
+    },
+    "./budget": {
+      "types": "./dist/src/budget/index.d.ts",
+      "import": "./dist/src/budget/index.js"
+    },
+    "./services/main": {
+      "types": "./dist/services/main.d.ts",
+      "import": "./dist/services/main.js"
+    },
+    "./providers/ai_provider": {
+      "types": "./dist/providers/ai_provider.d.ts",
+      "import": "./dist/providers/ai_provider.js"
+    },
+    "./commands": {
+      "types": "./dist/commands/main.d.ts",
+      "import": "./dist/commands/main.js"
+    },
+    "./types": {
+      "types": "./dist/src/types.d.ts",
+      "import": "./dist/src/types.js"
+    },
+    "./catalog": {
+      "types": "./dist/src/catalog/index.d.ts",
+      "import": "./dist/src/catalog/index.js"
+    },
+    "./acp": {
+      "types": "./dist/src/acp/index.d.ts",
+      "import": "./dist/src/acp/index.js"
+    },
+    "./agents": {
+      "types": "./dist/src/agents/index.d.ts",
+      "import": "./dist/src/agents/index.js"
+    },
+    "./models": {
+      "types": "./dist/src/models/index.d.ts",
+      "import": "./dist/src/models/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepack": "npm run clean && npm run build",
+    "watch": "tsc --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json",
+    "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
+    "test:regression": "node tests/regression.mjs && node tests/regression_adonis.mjs",
+    "test": "node --import=@poppinss/ts-exec bin/test.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IvanGlazyrin/adonis-ai-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/IvanGlazyrin/adonis-ai-kit/issues"
+  },
+  "homepage": "https://github.com/IvanGlazyrin/adonis-ai-kit#readme",
+  "peerDependencies": {
+    "@adonisjs/core": "^7.0.0",
+    "@ai-sdk/amazon-bedrock": "*",
+    "@ai-sdk/anthropic": "^1.0.0 || ^2.0.0 || ^3.0.0 || ^4.0.0",
+    "@ai-sdk/azure": "*",
+    "@ai-sdk/cerebras": "*",
+    "@ai-sdk/cohere": "*",
+    "@ai-sdk/deepinfra": "*",
+    "@ai-sdk/gateway": "*",
+    "@ai-sdk/google": "^1.0.0 || ^2.0.0 || ^3.0.0 || ^4.0.0",
+    "@ai-sdk/google-vertex": "*",
+    "@ai-sdk/groq": "^1.0.0 || ^2.0.0 || ^3.0.0 || ^4.0.0",
+    "@ai-sdk/mistral": "*",
+    "@ai-sdk/openai": "^1.0.0 || ^2.0.0 || ^3.0.0 || ^4.0.0",
+    "@ai-sdk/openai-compatible": "^1.0.0 || ^2.0.0 || ^3.0.0 || ^4.0.0",
+    "@ai-sdk/perplexity": "*",
+    "@ai-sdk/togetherai": "*",
+    "@ai-sdk/vercel": "*",
+    "@ai-sdk/xai": "*",
+    "@gitlab/gitlab-ai-provider": "*",
+    "@mcpc-tech/acp-ai-provider": ">=0.1.0",
+    "@openrouter/ai-sdk-provider": "*",
+    "ai": "^7.0.0"
+  },
+  "dependencies": {
+    "yaml": "^2.7.0",
+    "zod": "^3.25.76 || ^4.1.8"
+  },
+  "devDependencies": {
+    "@adonisjs/core": "^7.4.0",
+    "@ai-sdk/anthropic": "^4.0.0",
+    "@ai-sdk/openai": "^4.0.0",
+    "@japa/assert": "^4.2.0",
+    "@japa/runner": "^5.4.0",
+    "@poppinss/ts-exec": "^1.5.1",
+    "@types/node": "^22.0.0",
+    "ai": "^7.0.0",
+    "typescript": "^5.0.0 || ^6.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "sideEffects": [
+    "./dist/services/main.js"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/amazon-bedrock": {
+      "optional": true
+    },
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/azure": {
+      "optional": true
+    },
+    "@ai-sdk/cerebras": {
+      "optional": true
+    },
+    "@ai-sdk/cohere": {
+      "optional": true
+    },
+    "@ai-sdk/deepinfra": {
+      "optional": true
+    },
+    "@ai-sdk/gateway": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/google-vertex": {
+      "optional": true
+    },
+    "@ai-sdk/groq": {
+      "optional": true
+    },
+    "@ai-sdk/mistral": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "@ai-sdk/openai-compatible": {
+      "optional": true
+    },
+    "@ai-sdk/perplexity": {
+      "optional": true
+    },
+    "@ai-sdk/togetherai": {
+      "optional": true
+    },
+    "@ai-sdk/vercel": {
+      "optional": true
+    },
+    "@ai-sdk/xai": {
+      "optional": true
+    },
+    "@gitlab/gitlab-ai-provider": {
+      "optional": true
+    },
+    "@mcpc-tech/acp-ai-provider": {
+      "optional": true
+    },
+    "@openrouter/ai-sdk-provider": {
+      "optional": true
+    }
+  }
+}