orbitx 0.2.5 → 0.2.7

package/dist/core/agent-providers.d.ts

@@ -1,16 +1,21 @@
-import type { AIProvider } from "./ai-provider.js";
-export type AgentProviderRole = "main" | "image";
+import type { AIProvider, ProviderType } from "./ai-provider.js";
 export interface AgentProviderEntry {
-    aiProvider: AIProvider;
-    type: AgentProviderRole;
+    type: ProviderType;
+    provider: AIProvider | AIProvider[];
+    default?: number;
 }
 export type AgentProvidersInput = AIProvider | AgentProviderEntry[];
-export interface ResolvedAgentProviders {
-    main: AIProvider;
-    /** Present only if a provider was assigned the "image" role, or (single-provider case) the one provider supports images. */
-    image?: AIProvider;
+interface ProviderPool {
+    providers: AIProvider[];
+    default: number;
 }
-/** Only two provider roles exist: "main" (the agent loop itself) and "image" (describing/handling image tool output). There is no separate "utils" provider — all skills and tools are always included in the system prompt from the start, so there's nothing left for a utils pass to decide. */
-export declare function resolveAgentProviders(input: AgentProvidersInput): ResolvedAgentProviders;
+export declare class ProviderRegistry {
+    #private;
+    constructor(byType: Map<ProviderType, ProviderPool>);
+    getMain(): AIProvider;
+    getProvider(type: ProviderType): AIProvider | undefined;
+    getProviders(type: ProviderType): AIProvider[] | undefined;
+}
+export declare function resolveAgentProviders(input: AgentProvidersInput): ProviderRegistry;
 export default resolveAgentProviders;
 //# sourceMappingURL=agent-providers.d.ts.map

package/dist/core/agent-providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-providers.d.ts","sourceRoot":"","sources":["../../src/core/agent-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,kBAAkB,EAAE,CAAC;AAEpE,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,4HAA4H;IAC5H,KAAK,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,mSAAmS;AACnS,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,sBAAsB,CAoBxF;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"agent-providers.d.ts","sourceRoot":"","sources":["../../src/core/agent-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAwB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,kBAAkB,EAAE,CAAC;AAEpE,UAAU,YAAY;IAClB,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACnB;AAwBD,qBAAa,gBAAgB;;gBAGb,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC;IAInD,OAAO,IAAI,UAAU;IAIrB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS;IAkBvD,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,EAAE,GAAG,SAAS;CAG7D;AAWD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,gBAAgB,CAclF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/core/agent-providers.js

@@ -1,21 +1,71 @@
-/** Only two provider roles exist: "main" (the agent loop itself) and "image" (describing/handling image tool output). There is no separate "utils" provider — all skills and tools are always included in the system prompt from the start, so there's nothing left for a utils pass to decide. */
-export function resolveAgentProviders(input) {
-    if (!Array.isArray(input)) {
-        const caps = input.getCapabilities();
-        return {
-            main: input,
-            image: caps.supportsImages ? input : undefined,
-        };
+/**
+ * Maps the well-known `ProviderType` role names onto the `ProviderCapabilities`
+ * flag that actually describes that ability — used only as a fallback when
+ * nothing is registered under the role itself (see `getProvider` below).
+ * Role names with no capability equivalent (`main`, `llm-low`/`medium`/`high`,
+ * any custom string) simply aren't listed here, so the fallback never applies
+ * to them.
+ */
+const CAPABILITY_BY_TYPE = {
+    "image-describer": "supportsImages",
+    "image-generation": "supportsImageGeneration",
+    "image-editing": "supportsImageEditing",
+    "video-describer": "supportsVideo",
+    "video-generation": "supportsVideoGeneration",
+    "video-editing": "supportsVideoEditing",
+    "audio-describer": "supportsAudio",
+    "audio-generation": "supportsAudioGeneration",
+    "audio-design": "supportsAudioDesign",
+    "audio-clone": "supportsAudioClone",
+    "3d-model-generator": "supports3DModelGeneration",
+};
+export class ProviderRegistry {
+    #byType;
+    constructor(byType) {
+        this.#byType = byType;
+    }
+    getMain() {
+        return this.#byType.get("main").providers[this.#byType.get("main").default];
+    }
+    getProvider(type) {
+        const pool = this.#byType.get(type);
+        if (pool)
+            return pool.providers[pool.default];
+        const capabilityKey = CAPABILITY_BY_TYPE[type];
+        if (!capabilityKey)
+            return undefined;
+        for (const otherPool of this.#byType.values()) {
+            for (const provider of otherPool.providers) {
+                if (provider.getCapabilities()[capabilityKey]) {
+                    return provider;
+                }
+            }
+        }
+        return undefined;
     }
-    const mainEntry = input.find(e => e.type === "main");
-    if (!mainEntry) {
+    getProviders(type) {
+        return this.#byType.get(type)?.providers;
+    }
+}
+function toPool(entry) {
+    const providers = Array.isArray(entry.provider) ? entry.provider : [entry.provider];
+    const defaultIndex = entry.default ?? 0;
+    if (defaultIndex < 0 || defaultIndex >= providers.length) {
+        throw new Error(`resolveAgentProviders: entry "${entry.type}" has default=${defaultIndex}, out of range for its ${providers.length}-provider pool.`);
+    }
+    return { providers, default: defaultIndex };
+}
+export function resolveAgentProviders(input) {
+    const entries = Array.isArray(input) ? input : [{ type: "main", provider: input }];
+    const mainEntries = entries.filter(e => e.type === "main");
+    if (mainEntries.length === 0) {
         throw new Error("resolveAgentProviders: a provider with type \"main\" is required when passing an array of providers.");
     }
-    const imageEntry = input.find(e => e.type === "image");
-    return {
-        main: mainEntry.aiProvider,
-        image: imageEntry?.aiProvider,
-    };
+    const byType = new Map();
+    for (const entry of entries) {
+        byType.set(entry.type, toPool(entry));
+    }
+    return new ProviderRegistry(byType);
 }
 export default resolveAgentProviders;
 //# sourceMappingURL=agent-providers.js.map

package/dist/core/agent-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-providers.js","sourceRoot":"","sources":["../../src/core/agent-providers.ts"],"names":[],"mappings":"AAiBA,mSAAmS;AACnS,MAAM,UAAU,qBAAqB,CAAC,KAA0B;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;QACrC,OAAO;YACH,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACjD,CAAC;IACN,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;IAC5H,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAEvD,OAAO;QACH,IAAI,EAAE,SAAS,CAAC,UAAU;QAC1B,KAAK,EAAE,UAAU,EAAE,UAAU;KAChC,CAAC;AACN,CAAC;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"agent-providers.js","sourceRoot":"","sources":["../../src/core/agent-providers.ts"],"names":[],"mappings":"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"}

package/dist/core/ai-provider.d.ts

@@ -31,6 +31,20 @@ export type MessageContentPart = {
     image: string;
     mimeType?: string;
 };
+export type ProviderType = "main" | "image-describer" | "image-generation" | "image-editing" | "video-describer" | "video-generation" | "video-editing" | "audio-describer" | "audio-generation" | "audio-design" | "audio-clone" | "3d-model-generator" | "llm-low" | "llm-medium" | "llm-high" | (string & {});
+export interface MessageUsageTokens {
+    type: ProviderType;
+    unit: "tokens";
+    inputMissTokens: number;
+    inputCacheTokens: number;
+    outputTokens: number;
+}
+export interface MessageUsageCost {
+    type: ProviderType;
+    unit: "cost";
+    cost: number;
+}
+export type MessageUsage = MessageUsageTokens | MessageUsageCost;
 export interface Message {
     role: "user" | "system" | "assistant" | "tool";
     content?: string;
@@ -52,11 +66,17 @@ export interface Message {
      * untouched; only the provider that produced it interprets it.
      */
     providerThinking?: any[];
+    timestamp?: number;
+    /** True on messages BaseAgent injects itself rather than ones a human or the model produced (e.g. the forced-compaction nudge) — a hint for UI code to filter out of what's shown to an end user. Defaults to false/absent; purely a display hint, not sent to any provider. */
+    hidden?: boolean;
+    usage?: MessageUsage[];
 }
 export interface ChatResponse {
     content: string;
-    inputTokens: number;
-    outputTokens: number;
+    inputMissTokens?: number;
+    inputCacheTokens?: number;
+    outputTokens?: number;
+    cost?: number;
     /** Native tool calls requested by the model, when the provider supports native tool-calling and tools were supplied. */
     toolCalls?: ToolCallRequest[];
     /** Accumulated reasoning/thinking text produced this turn, when thinking was requested and the provider can surface it. See `Message.thinking`. */
@@ -88,6 +108,13 @@ export type StreamCallback = (chunk: {
     toolName?: string;
     /** Reasoning/thinking text delta for this chunk, mirroring `content` — present only while the model is thinking, absent (or empty) once it moves on to its actual answer. Only ever set on non-`done` assistant chunks. Never set unless the provider was configured with `thinkEffort` and can stream thinking (see `ProviderCapabilities.supportsThinking`); when a thinking chunk is emitted, `content` on that same chunk is empty. */
     thinking?: string;
+    /** Mirrors `Message.hidden` — true on chunks for a message BaseAgent injected itself (e.g. the forced-compaction nudge), so a live-streaming UI can filter it out the same way it would filter the persisted Message. */
+    hidden?: boolean;
+    usage?: {
+        inputMissTokens: number;
+        inputCacheTokens: number;
+        outputTokens: number;
+    };
 }) => Promise<void> | void;
 /**
  * Static capability + limits description for a provider/model pair. This
@@ -103,15 +130,46 @@ export interface ProviderCapabilities {
     supportsImages: boolean;
     /** The model's total context window, in tokens. Used to derive a safe default for when to trigger a memory-compaction event, without needing a hardcoded per-agent constant. */
     contextWindow: number;
+    /** The model's maximum output tokens per response, when known. Not yet enforced anywhere — reserved for the agent loop to size/guard its own output budgeting in a future release. Undefined where not confirmed for a given provider/model. */
+    maxOutputTokens?: number;
     /** Fraction of the context window (0-1) that's safe to fill before compacting; leaves headroom for the system prompt, tool schema, and the model's own output. Defaults applied by callers if not specified. */
     safeUsageRatio?: number;
     /** Whether this provider can surface the model's reasoning/thinking text (streamed via the `thinking` chunk field, and returned as `ChatResponse.thinking`) when constructed with `thinkEffort`. A provider may still accept/honor `thinkEffort` server-side (e.g. it changes response quality/latency) while reporting `false` here, if its API never exposes the reasoning text itself. */
     supportsThinking?: boolean;
+    /** Whether this provider/model accepts video content in messages. */
+    supportsVideo?: boolean;
+    /** Whether this provider/model accepts audio content in messages. */
+    supportsAudio?: boolean;
+    /** Whether this provider/model can generate new images. */
+    supportsImageGeneration?: boolean;
+    /** Whether this provider/model can edit an existing image. */
+    supportsImageEditing?: boolean;
+    /** Whether this provider/model can generate new video. */
+    supportsVideoGeneration?: boolean;
+    /** Whether this provider/model can edit existing video. */
+    supportsVideoEditing?: boolean;
+    /** Whether this provider/model can generate new audio (speech, music, sound effects). */
+    supportsAudioGeneration?: boolean;
+    /** Whether this provider/model can design/produce sound effects or soundscapes. */
+    supportsAudioDesign?: boolean;
+    /** Whether this provider/model can clone a voice from a reference sample. */
+    supportsAudioClone?: boolean;
+    /** Whether this provider/model can generate a new 3D model. */
+    supports3DModelGeneration?: boolean;
 }
 export declare abstract class AIProvider {
-    abstract chat(messages: Message[], streamCallback?: StreamCallback, tools?: ToolSchema[]): Promise<ChatResponse>;
+    /**
+     * @param signal When provided and later aborted, the in-flight request to the underlying
+     * provider API is cancelled immediately (not just abandoned client-side) — used by
+     * `BaseAgent.immediateStop()` to cut off a call's cost/token usage right away instead of
+     * waiting for it to finish. Providers built on fetch-based SDKs (Anthropic, OpenAI,
+     * DeepSeek) honor this for both streaming and non-streaming calls; Ollama's client only
+     * supports it for streaming calls (see ollama-provider.ts).
+     */
+    abstract chat(messages: Message[], streamCallback?: StreamCallback, tools?: ToolSchema[], signal?: AbortSignal): Promise<ChatResponse>;
     /** Describe what this provider/model can do — used by BaseAgent to pick the native-tools vs. legacy-JSON path and to size the memory-compaction threshold. */
     abstract getCapabilities(): ProviderCapabilities;
+    abstract setOption(key: string, value: unknown): void;
 }
 export default AIProvider;
 //# sourceMappingURL=ai-provider.d.ts.map

package/dist/core/ai-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC3D,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,GAAG,CAAC;KACjB,EAAE,CAAC;CACP;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,2FAA2F;AAC3F,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAwC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gPAAgP;IAChP,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,sEAAsE;IACtE,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mRAAmR;IACnR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,wHAAwH;IACxH,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,mJAAmJ;IACnJ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE;IACjC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2aAA2a;IAC3a,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACjC,qMAAqM;IACrM,aAAa,EAAE,OAAO,CAAC;IACvB,qEAAqE;IACrE,cAAc,EAAE,OAAO,CAAC;IACxB,gLAAgL;IAChL,aAAa,EAAE,MAAM,CAAC;IACtB,gNAAgN;IAChN,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6XAA6X;IAC7X,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,8BAAsB,UAAU;IAC5B,QAAQ,CAAC,IAAI,CACT,QAAQ,EAAE,OAAO,EAAE,EACnB,cAAc,CAAC,EAAE,cAAc,EAC/B,KAAK,CAAC,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,YAAY,CAAC;IAExB,8JAA8J;IAC9J,QAAQ,CAAC,eAAe,IAAI,oBAAoB;CACnD;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.ts"],"names":[],"mappings":"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"}

package/dist/core/ai-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider.js","sourceRoot":"","sources":["../../src/core/ai-provider.ts"],"names":[],"mappings":"AAgHA,MAAM,OAAgB,UAAU;CAS/B;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ai-provider.js","sourceRoot":"","sources":["../../src/core/ai-provider.ts"],"names":[],"mappings":"AAqLA,MAAM,OAAgB,UAAU;CAoB/B;AAED,eAAe,UAAU,CAAC"}

package/dist/core/anthropic-provider.d.ts

@@ -8,9 +8,14 @@ export declare class AnthropicProvider extends AIProvider {
         contextWindow?: number;
         maxTokens?: number;
         thinkEffort?: number;
+        userId?: string;
+        disablePromptCaching?: boolean;
+        extendedContext?: boolean | string;
     });
     getCapabilities(): ProviderCapabilities;
-    chat(messages: Message[], streamCallback?: StreamCallback, tools?: ToolSchema[]): Promise<ChatResponse>;
+    /** Settable without reconstructing this provider: `thinkEffort`, `userId`, `disablePromptCaching`, `maxTokens`, `supportsTools` — every one of these is read fresh from the corresponding private field on every `chat()` call, never baked into derived state at construction (unlike `contextWindow`/`extendedContext`, which are out of scope here). */
+    setOption(key: string, value: unknown): void;
+    chat(messages: Message[], streamCallback?: StreamCallback, tools?: ToolSchema[], signal?: AbortSignal): Promise<ChatResponse>;
 }
 export default AnthropicProvider;
 //# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/core/anthropic-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../src/core/anthropic-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAmB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACjI,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAyH1C,qBAAa,iBAAkB,SAAQ,UAAU;;gBAUjC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAA0B,EAAE,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;IAWpM,eAAe,IAAI,oBAAoB;IAUjC,IAAI,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,cAAc,CAAC,EAAE,cAAc,EAC/B,KAAK,CAAC,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,YAAY,CAAC;CAgJ3B;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../src/core/anthropic-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAmB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACjI,OAAO,UAAU,MAAM,kBAAkB,CAAC;AA0J1C,qBAAa,iBAAkB,SAAQ,UAAU;;gBAcjC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAA0B,EAAE,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;KAAO;IAazR,eAAe,IAAI,oBAAoB;IAqBvC,2VAA2V;IAC3V,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAWtC,IAAI,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,cAAc,CAAC,EAAE,cAAc,EAC/B,KAAK,CAAC,EAAE,UAAU,EAAE,EACpB,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,YAAY,CAAC;CAwK3B;AAED,eAAe,iBAAiB,CAAC"}

package/dist/core/anthropic-provider.js

@@ -3,13 +3,33 @@ import AIProvider from "./ai-provider.js";
 import { toAnthropicTools } from "./tool-schema-translator.js";
 import { withRetry } from "./retry.js";
 const MODEL_CONTEXT_WINDOWS = {
-    "claude-opus-4-8": 200_000,
-    "claude-sonnet-5": 200_000,
+    "claude-opus-5": 1_000_000,
+    "claude-sonnet-5": 1_000_000,
+    "claude-fable-5": 1_000_000,
+    "claude-opus-4-8": 1_000_000,
+    "claude-opus-4-7": 1_000_000,
+    "claude-opus-4-6": 1_000_000,
+    "claude-sonnet-4-6": 1_000_000,
+    "claude-opus-4-5": 200_000,
+    "claude-sonnet-4-5": 200_000,
     "claude-haiku-4-5-20251001": 200_000,
-    "claude-fable-5": 200_000,
-    "claude-mythos-5": 200_000,
+    "claude-mythos-5": 1_000_000,
 };
 const DEFAULT_CONTEXT_WINDOW = 200_000;
+const MODEL_MAX_OUTPUT_TOKENS = {
+    "claude-fable-5": 128_000,
+    "claude-mythos-5": 128_000,
+    "claude-opus-5": 128_000,
+    "claude-sonnet-5": 128_000,
+    "claude-opus-4-8": 128_000,
+    "claude-opus-4-7": 128_000,
+    "claude-opus-4-6": 128_000,
+    "claude-sonnet-4-6": 128_000,
+    "claude-opus-4-5": 64_000,
+    "claude-sonnet-4-5": 64_000,
+    "claude-haiku-4-5-20251001": 64_000,
+};
+const DEFAULT_MAX_OUTPUT_TOKENS = 128_000;
 // Anthropic's extended thinking takes a numeric token budget rather than a
 // low/medium/high enum, so the universal 0-1 `thinkEffort` is mapped onto a
 // budget range instead of going through resolveThinkEffortLevel(). The
@@ -82,6 +102,19 @@ function toAnthropicMessages(messages) {
     }
     return { system: systemParts.join("\n\n"), messages: out };
 }
+function withCacheControl(messages) {
+    if (messages.length === 0)
+        return messages;
+    const last = messages[messages.length - 1];
+    const content = typeof last.content === "string"
+        ? [{ type: "text", text: last.content }]
+        : [...last.content];
+    if (content.length === 0)
+        return messages;
+    const lastIndex = content.length - 1;
+    content[lastIndex] = { ...content[lastIndex], cache_control: { type: "ephemeral" } };
+    return [...messages.slice(0, -1), { ...last, content }];
+}
 function fromAnthropicToolCalls(content) {
     if (!content)
         return undefined;
@@ -123,30 +156,71 @@ export class AnthropicProvider extends AIProvider {
     #maxTokens;
     /** Universal 0-1 thinking effort — see src/core/think-effort.ts. Mapped onto Anthropic's numeric thinking-token budget in #chat. */
     #thinkEffort;
+    /** Opaque end-user identifier forwarded as `metadata.user_id` on every request, for Anthropic's own abuse-monitoring — see docs/providers.md#user-tracking. */
+    #userId;
+    /** Ephemeral cache_control breakpoint on by default (see withCacheControl) — set true to send every request uncached. */
+    #disablePromptCaching;
     constructor(apiKey, model = "claude-sonnet-5", options = {}) {
         super();
         this.#client = new Anthropic({ apiKey });
         this.#model = model;
         this.#supportsTools = options.supportsTools ?? true;
         this.#supportsImages = options.supportsImages ?? true;
-        this.#contextWindow = options.contextWindow ?? MODEL_CONTEXT_WINDOWS[model] ?? DEFAULT_CONTEXT_WINDOW;
+        this.#contextWindow = options.contextWindow ?? (MODEL_CONTEXT_WINDOWS[model] ?? DEFAULT_CONTEXT_WINDOW);
         this.#maxTokens = options.maxTokens ?? 4096;
         this.#thinkEffort = options.thinkEffort;
+        this.#userId = options.userId;
+        this.#disablePromptCaching = options.disablePromptCaching ?? false;
     }
     getCapabilities() {
         return {
             supportsTools: this.#supportsTools,
             supportsImages: this.#supportsImages,
             contextWindow: this.#contextWindow,
-            safeUsageRatio: 0.5,
+            safeUsageRatio: 0.7,
             supportsThinking: true,
+            maxOutputTokens: MODEL_MAX_OUTPUT_TOKENS[this.#model] ?? DEFAULT_MAX_OUTPUT_TOKENS,
+            supportsVideo: false,
+            supportsAudio: false,
+            supportsImageGeneration: false,
+            supportsImageEditing: false,
+            supportsVideoGeneration: false,
+            supportsVideoEditing: false,
+            supportsAudioGeneration: false,
+            supportsAudioDesign: false,
+            supportsAudioClone: false,
+            supports3DModelGeneration: false,
         };
     }
-    async chat(messages, streamCallback, tools) {
-        const { system, messages: formattedMessages } = toAnthropicMessages(messages);
+    /** Settable without reconstructing this provider: `thinkEffort`, `userId`, `disablePromptCaching`, `maxTokens`, `supportsTools` — every one of these is read fresh from the corresponding private field on every `chat()` call, never baked into derived state at construction (unlike `contextWindow`/`extendedContext`, which are out of scope here). */
+    setOption(key, value) {
+        switch (key) {
+            case "thinkEffort":
+                this.#thinkEffort = value;
+                return;
+            case "userId":
+                this.#userId = value;
+                return;
+            case "disablePromptCaching":
+                this.#disablePromptCaching = value;
+                return;
+            case "maxTokens":
+                this.#maxTokens = value;
+                return;
+            case "supportsTools":
+                this.#supportsTools = value;
+                return;
+            default: throw new Error(`AnthropicProvider does not support setting option "${key}"`);
+        }
+    }
+    async chat(messages, streamCallback, tools, signal) {
+        const { system, messages: rawFormattedMessages } = toAnthropicMessages(messages);
+        const formattedMessages = this.#disablePromptCaching ? rawFormattedMessages : withCacheControl(rawFormattedMessages);
         const formattedTools = tools && tools.length > 0 && this.#supportsTools
             ? toAnthropicTools(tools)
             : undefined;
+        const metadataParam = this.#userId ? { metadata: { user_id: this.#userId } } : {};
+        const requestOptions = { signal };
         const thinkingBudget = this.#thinkEffort !== undefined
             ? resolveThinkingBudget(this.#thinkEffort, this.#maxTokens)
             : undefined;
@@ -168,97 +242,113 @@ export class AnthropicProvider extends AIProvider {
                     messages: formattedMessages,
                     ...(formattedTools ? { tools: formattedTools } : {}),
                     ...thinkingParam,
+                    ...metadataParam,
                     stream: true,
-                });
+                }, requestOptions);
                 let fullContent = "";
-                let inputTokens = 0;
+                let inputMissTokens = 0;
+                let inputCacheTokens = 0;
                 let outputTokens = 0;
                 // Anthropic streams tool_use blocks as a start event (with
                 // id/name) followed by incremental input_json_delta chunks,
                 // so the partial JSON has to be accumulated per block index
                 // the same way OpenAI's function-call arguments are.
                 const toolBlocks = {};
+                // Only blocks that reached content_block_stop land here — if the stream is
+                // aborted mid-block (see the catch below), that block is still open in
+                // toolBlocks above but deliberately left out of the response: its JSON may be
+                // truncated mid-argument, and dispatching a tool call built from garbage input
+                // would be worse than just not surfacing it.
+                const finishedToolCalls = [];
                 // Thinking blocks stream the same way: a start event, then
                 // incremental thinking_delta (text) and signature_delta
                 // (the cryptographic signature Anthropic requires replayed
                 // verbatim alongside a tool_use in the same turn).
                 const thinkingBlocks = {};
-                for await (const event of stream) {
-                    if (event.type === "content_block_start") {
-                        if (event.content_block?.type === "tool_use") {
-                            toolBlocks[event.index] = {
-                                id: event.content_block.id,
-                                name: event.content_block.name,
-                                inputJson: "",
-                            };
+                try {
+                    for await (const event of stream) {
+                        if (event.type === "content_block_start") {
+                            if (event.content_block?.type === "tool_use") {
+                                toolBlocks[event.index] = {
+                                    id: event.content_block.id,
+                                    name: event.content_block.name,
+                                    inputJson: "",
+                                };
+                            }
+                            if (event.content_block?.type === "thinking") {
+                                thinkingBlocks[event.index] = { type: "thinking", thinking: "", signature: "" };
+                            }
                         }
-                        if (event.content_block?.type === "thinking") {
-                            thinkingBlocks[event.index] = { type: "thinking", thinking: "", signature: "" };
+                        if (event.type === "content_block_delta") {
+                            if (event.delta?.type === "text_delta" && event.delta.text) {
+                                fullContent += event.delta.text;
+                                await streamCallback({ role: "assistant", content: event.delta.text, done: false, usage: { inputMissTokens, inputCacheTokens, outputTokens } });
+                            }
+                            if (event.delta?.type === "input_json_delta" && toolBlocks[event.index]) {
+                                toolBlocks[event.index].inputJson += event.delta.partial_json || "";
+                            }
+                            if (event.delta?.type === "thinking_delta" && thinkingBlocks[event.index]) {
+                                thinkingBlocks[event.index].thinking += event.delta.thinking || "";
+                                await streamCallback({ role: "assistant", content: "", done: false, thinking: event.delta.thinking || "", usage: { inputMissTokens, inputCacheTokens, outputTokens } });
+                            }
+                            if (event.delta?.type === "signature_delta" && thinkingBlocks[event.index]) {
+                                thinkingBlocks[event.index].signature += event.delta.signature || "";
+                            }
                         }
-                    }
-                    if (event.type === "content_block_delta") {
-                        if (event.delta?.type === "text_delta" && event.delta.text) {
-                            fullContent += event.delta.text;
-                            await streamCallback({ role: "assistant", content: event.delta.text, done: false });
+                        // A tool_use block is fully formed the moment Anthropic
+                        // closes it — unlike OpenAI/DeepSeek there's no need to
+                        // infer completion from the next block starting.
+                        if (event.type === "content_block_stop" && toolBlocks[event.index]) {
+                            const tb = toolBlocks[event.index];
+                            let inputs = {};
+                            try {
+                                inputs = JSON.parse(tb.inputJson || "{}");
+                            }
+                            catch {
+                                inputs = {};
+                            }
+                            const finished = { id: tb.id || "", name: tb.name || "", inputs };
+                            finishedToolCalls.push(finished);
+                            await streamCallback({ role: "assistant", content: "", done: false, toolCalls: [finished], usage: { inputMissTokens, inputCacheTokens, outputTokens } });
                         }
-                        if (event.delta?.type === "input_json_delta" && toolBlocks[event.index]) {
-                            toolBlocks[event.index].inputJson += event.delta.partial_json || "";
-                        }
-                        if (event.delta?.type === "thinking_delta" && thinkingBlocks[event.index]) {
-                            thinkingBlocks[event.index].thinking += event.delta.thinking || "";
-                            await streamCallback({ role: "assistant", content: "", done: false, thinking: event.delta.thinking || "" });
-                        }
-                        if (event.delta?.type === "signature_delta" && thinkingBlocks[event.index]) {
-                            thinkingBlocks[event.index].signature += event.delta.signature || "";
-                        }
-                    }
-                    // A tool_use block is fully formed the moment Anthropic
-                    // closes it — unlike OpenAI/DeepSeek there's no need to
-                    // infer completion from the next block starting.
-                    if (event.type === "content_block_stop" && toolBlocks[event.index]) {
-                        const tb = toolBlocks[event.index];
-                        let inputs = {};
-                        try {
-                            inputs = JSON.parse(tb.inputJson || "{}");
+                        if (event.type === "message_start") {
+                            const usage = event.message?.usage;
+                            inputMissTokens = (usage?.input_tokens || 0) + (usage?.cache_creation_input_tokens || 0);
+                            inputCacheTokens = usage?.cache_read_input_tokens || 0;
+                            await streamCallback({ role: "assistant", content: "", done: false, usage: { inputMissTokens, inputCacheTokens, outputTokens } });
                         }
-                        catch {
-                            inputs = {};
-                        }
-                        await streamCallback({ role: "assistant", content: "", done: false, toolCalls: [{ id: tb.id || "", name: tb.name || "", inputs }] });
-                    }
-                    if (event.type === "message_start") {
-                        inputTokens = event.message?.usage?.input_tokens || 0;
-                    }
-                    if (event.type === "message_delta") {
-                        if (event.usage?.output_tokens !== undefined) {
-                            outputTokens = event.usage.output_tokens;
+                        if (event.type === "message_delta") {
+                            if (event.usage?.output_tokens !== undefined) {
+                                outputTokens = event.usage.output_tokens;
+                                await streamCallback({ role: "assistant", content: "", done: false, usage: { inputMissTokens, inputCacheTokens, outputTokens } });
+                            }
                         }
                     }
                 }
-                const toolCalls = Object.keys(toolBlocks).length > 0
-                    ? Object.values(toolBlocks).map(tb => {
-                        let inputs = {};
-                        try {
-                            inputs = JSON.parse(tb.inputJson || "{}");
-                        }
-                        catch {
-                            inputs = {};
-                        }
-                        return { id: tb.id || "", name: tb.name || "", inputs };
-                    })
-                    : undefined;
+                catch (err) {
+                    // A signal we were handed ourselves (see immediateStop() in BaseAgent)
+                    // aborted the underlying request mid-stream. Treat this like a naturally
+                    // truncated turn rather than a failure: fall through and return whatever
+                    // text/tool-calls/tokens were accumulated above, instead of throwing away
+                    // content the caller already saw via streamCallback. A genuine network/API
+                    // error (signal not aborted) still propagates so withRetry can retry it.
+                    if (!signal?.aborted)
+                        throw err;
+                }
+                const toolCalls = finishedToolCalls.length > 0 ? finishedToolCalls : undefined;
                 const providerThinking = Object.keys(thinkingBlocks).length > 0 ? Object.values(thinkingBlocks) : undefined;
                 const thinkingText = providerThinking?.map(b => b.thinking).join("");
-                await streamCallback({ role: "assistant", content: "", done: true });
+                await streamCallback({ role: "assistant", content: "", done: true, usage: { inputMissTokens, inputCacheTokens, outputTokens } });
                 return {
                     content: fullContent,
-                    inputTokens,
+                    inputMissTokens,
+                    inputCacheTokens,
                     outputTokens,
                     ...(toolCalls ? { toolCalls } : {}),
                     ...(thinkingText ? { thinking: thinkingText } : {}),
                     ...(providerThinking ? { providerThinking } : {}),
                 };
-            });
+            }, signal);
         }
         else {
             return withRetry(async () => {
@@ -269,18 +359,20 @@ export class AnthropicProvider extends AIProvider {
                     messages: formattedMessages,
                     ...(formattedTools ? { tools: formattedTools } : {}),
                     ...thinkingParam,
-                });
+                    ...metadataParam,
+                }, requestOptions);
                 const toolCalls = fromAnthropicToolCalls(response.content);
                 const { text: thinkingText, blocks: providerThinking } = thinkingFromAnthropicContent(response.content);
                 return {
                     content: textFromAnthropicContent(response.content),
-                    inputTokens: response.usage?.input_tokens || 0,
+                    inputMissTokens: (response.usage?.input_tokens || 0) + (response.usage?.cache_creation_input_tokens || 0),
+                    inputCacheTokens: response.usage?.cache_read_input_tokens || 0,
                     outputTokens: response.usage?.output_tokens || 0,
                     ...(toolCalls ? { toolCalls } : {}),
                     ...(thinkingText ? { thinking: thinkingText } : {}),
                     ...(providerThinking ? { providerThinking } : {}),
                 };
-            });
+            }, signal);
         }
     }
 }