@opencow-ai/opencow-agent-sdk 0.4.29 → 0.4.30

package/dist/cli.mjs

@@ -86737,7 +86737,7 @@ function printStartupScreen() {
   const sLen = ` ● ${sL}    Ready — type /help to begin`.length;
   out.push(boxRow(sRow, W, sLen));
   out.push(`${rgb(...BORDER)}╚${"═".repeat(W - 2)}╝${RESET}`);
-  out.push(`  ${DIM}${rgb(...DIMCOL)}opencow ${RESET}${rgb(...ACCENT)}v${"0.4.29"}${RESET}`);
+  out.push(`  ${DIM}${rgb(...DIMCOL)}opencow ${RESET}${rgb(...ACCENT)}v${"0.4.30"}${RESET}`);
   out.push("");
   process.stdout.write(out.join(`
 `) + `
@@ -138409,16 +138409,17 @@ function getAssistantMessageFromError(error, model, options) {
       error: "rate_limit"
     });
   }
-  if (error instanceof APIError && error.status === 429 && shouldProcessRateLimits(isClaudeAISubscriber())) {
-    const rateLimitType = error.headers?.get?.("anthropic-ratelimit-unified-representative-claim");
-    const overageStatus = error.headers?.get?.("anthropic-ratelimit-unified-overage-status");
+  if (error instanceof APIError && error.status === 429) {
+    const quotaHeaders = shouldProcessRateLimits(isClaudeAISubscriber()) ? error.headers : undefined;
+    const rateLimitType = quotaHeaders?.get?.("anthropic-ratelimit-unified-representative-claim");
+    const overageStatus = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-status");
     if (rateLimitType || overageStatus) {
       const limits = {
         status: "rejected",
         unifiedRateLimitFallbackAvailable: false,
         isUsingOverage: false
       };
-      const resetHeader = error.headers?.get?.("anthropic-ratelimit-unified-reset");
+      const resetHeader = quotaHeaders?.get?.("anthropic-ratelimit-unified-reset");
       if (resetHeader) {
         limits.resetsAt = Number(resetHeader);
       }
@@ -138428,11 +138429,11 @@ function getAssistantMessageFromError(error, model, options) {
       if (overageStatus) {
         limits.overageStatus = overageStatus;
       }
-      const overageResetHeader = error.headers?.get?.("anthropic-ratelimit-unified-overage-reset");
+      const overageResetHeader = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-reset");
       if (overageResetHeader) {
         limits.overageResetsAt = Number(overageResetHeader);
       }
-      const overageDisabledReason = error.headers?.get?.("anthropic-ratelimit-unified-overage-disabled-reason");
+      const overageDisabledReason = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-disabled-reason");
       if (overageDisabledReason) {
         limits.overageDisabledReason = overageDisabledReason;
       }
@@ -138573,6 +138574,13 @@ Run /share and post the JSON file to ${MACRO.FEEDBACK_CHANNEL}.`;
       error: "billing_error"
     });
   }
+  if (error instanceof APIError && (error.status === 402 || error.message.includes('"type":"billing_error"'))) {
+    const detail = error.message.match(/"message"\s*:\s*"([^"]*)"/)?.[1];
+    return createAssistantAPIErrorMessage({
+      content: `${API_ERROR_MESSAGE_PREFIX}: ${detail || error.message}`,
+      error: "billing_error"
+    });
+  }
   if (error instanceof APIError && error.status === 400 && error.message.toLowerCase().includes("organization has been disabled")) {
     const { source } = getAnthropicApiKeyWithSource();
     if (source === "ANTHROPIC_API_KEY" && process.env.ANTHROPIC_API_KEY && !isClaudeAISubscriber()) {
@@ -234417,7 +234425,6 @@ async function* queryLoop(params, consumedCommandUuids) {
         exceeds200kTokens: permissionMode === "plan" && doesMostRecentAssistantMessageExceed200k(messagesForQuery)
       });
       queryCheckpoint("query_setup_end");
-      const dumpPromptsFetch = undefined;
       let collapseOwnsIt = false;
       if (false) {}
       const mediaRecoveryEnabled = reactiveCompact?.isReactiveCompactEnabled() ?? false;
@@ -234470,7 +234477,7 @@ async function* queryLoop(params, consumedCommandUuids) {
                 hasAppendSystemPrompt: !!toolUseContext.options.appendSystemPrompt,
                 maxOutputTokensOverride,
                 maxOutputTokensLimitOverride: params.maxOutputTokensLimitOverride,
-                fetchOverride: dumpPromptsFetch,
+                fetchOverride: toolUseContext.options.fetchOverride,
                 mcpTools: appState.mcp.tools,
                 hasPendingMcpServers: appState.mcp.clients.some((c) => c.type === "pending"),
                 queryTracking,
@@ -235183,7 +235190,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-11-03T08:26:22.842Z").getTime();
+  const buildTime = new Date("2026-11-04T12:30:46.458Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -239056,6 +239063,7 @@ async function* runAgent({
       mcpResources: toolUseContext.options.mcpResources,
       agentDefinitions: toolUseContext.options.agentDefinitions,
       subagentDisallowedTools: toolUseContext.options.subagentDisallowedTools,
+      fetchOverride: toolUseContext.options.fetchOverride,
       ...useExactTools && { querySource }
     };
     agentToolRuntimeContext = createSubagentContext(toolUseContext, {
@@ -480216,7 +480224,7 @@ function buildPrimarySection() {
   }, undefined, false, undefined, this);
   return [{
     label: "Version",
-    value: "0.4.29"
+    value: "0.4.30"
   }, {
     label: "Session name",
     value: nameValue
@@ -528296,7 +528304,7 @@ var init_bridge_kick = __esm(() => {
 var call58 = async () => {
   return {
     type: "text",
-    value: `${"99.0.0"} (built ${"2026-11-03T08:26:22.842Z"})`
+    value: `${"99.0.0"} (built ${"2026-11-04T12:30:46.458Z"})`
   };
 }, version2, version_default;
 var init_version = __esm(() => {
@@ -545975,7 +545983,7 @@ function WelcomeV2() {
             dimColor: true,
             children: [
               "v",
-              "0.4.29",
+              "0.4.30",
               " "
             ]
           }, undefined, true, undefined, this)
@@ -546175,7 +546183,7 @@ function WelcomeV2() {
           dimColor: true,
           children: [
             "v",
-            "0.4.29",
+            "0.4.30",
             " "
           ]
         }, undefined, true, undefined, this)
@@ -546401,7 +546409,7 @@ function AppleTerminalWelcomeV2(t0) {
         dimColor: true,
         children: [
           "v",
-          "0.4.29",
+          "0.4.30",
           " "
         ]
       }, undefined, true, undefined, this);
@@ -546655,7 +546663,7 @@ function AppleTerminalWelcomeV2(t0) {
       dimColor: true,
       children: [
         "v",
-        "0.4.29",
+        "0.4.30",
         " "
       ]
     }, undefined, true, undefined, this);
@@ -557387,6 +557395,7 @@ class QueryEngine {
         maxOutputTokensLimit,
         contextWindow,
         modelProviders: this.config.modelProviders,
+        fetchOverride: this.config.fetchOverride,
         subagentDisallowedTools: this.config.subagentDisallowedTools,
         preDecidePermissions
       },
@@ -557486,6 +557495,7 @@ class QueryEngine {
         maxOutputTokensLimit,
         contextWindow,
         modelProviders: this.config.modelProviders,
+        fetchOverride: this.config.fetchOverride,
         subagentDisallowedTools: this.config.subagentDisallowedTools,
         preDecidePermissions
       },
@@ -557995,6 +558005,7 @@ async function* ask({
   userSpecifiedModel,
   fallbackModel,
   modelProviders,
+  fetchOverride,
   jsonSchema,
   getAppState,
   setAppState,
@@ -558025,6 +558036,7 @@ async function* ask({
     userSpecifiedModel,
     fallbackModel,
     modelProviders,
+    fetchOverride,
     thinkingConfig,
     maxTurns,
     maxBudgetUsd,
@@ -567412,7 +567424,7 @@ Usage: claude --remote "your task description"`, () => gracefulShutdown(1));
         pendingHookMessages
       }, renderAndRun);
     }
-  }).version("0.4.29 (OpenCow)", "-v, --version", "Output the version number");
+  }).version("0.4.30 (OpenCow)", "-v, --version", "Output the version number");
   program.option("-w, --worktree [name]", "Create a new git worktree for this session (optionally specify a name)");
   program.option("--tmux", "Create a tmux session for the worktree (requires --worktree). Uses iTerm2 native panes when available; use --tmux=classic for traditional tmux.");
   if (canUserConfigureAdvisor()) {
@@ -568007,7 +568019,7 @@ if (false) {}
 async function main2() {
   const args = process.argv.slice(2);
   if (args.length === 1 && (args[0] === "--version" || args[0] === "-v" || args[0] === "-V")) {
-    console.log(`${"0.4.29"} (OpenCow)`);
+    console.log(`${"0.4.30"} (OpenCow)`);
     return;
   }
   if (args.includes("--provider")) {
@@ -568107,4 +568119,4 @@ async function main2() {
 }
 main2();
 
-//# debugId=3D4AFE0926C15EE564756E2164756E21
+//# debugId=350424289A5BE31764756E2164756E21

package/dist/client.js

@@ -122191,16 +122191,17 @@ function getAssistantMessageFromError(error, model, options) {
       error: "rate_limit"
     });
   }
-  if (error instanceof APIError && error.status === 429 && shouldProcessRateLimits(isClaudeAISubscriber())) {
-    const rateLimitType = error.headers?.get?.("anthropic-ratelimit-unified-representative-claim");
-    const overageStatus = error.headers?.get?.("anthropic-ratelimit-unified-overage-status");
+  if (error instanceof APIError && error.status === 429) {
+    const quotaHeaders = shouldProcessRateLimits(isClaudeAISubscriber()) ? error.headers : undefined;
+    const rateLimitType = quotaHeaders?.get?.("anthropic-ratelimit-unified-representative-claim");
+    const overageStatus = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-status");
     if (rateLimitType || overageStatus) {
       const limits = {
         status: "rejected",
         unifiedRateLimitFallbackAvailable: false,
         isUsingOverage: false
       };
-      const resetHeader = error.headers?.get?.("anthropic-ratelimit-unified-reset");
+      const resetHeader = quotaHeaders?.get?.("anthropic-ratelimit-unified-reset");
       if (resetHeader) {
         limits.resetsAt = Number(resetHeader);
       }
@@ -122210,11 +122211,11 @@ function getAssistantMessageFromError(error, model, options) {
       if (overageStatus) {
         limits.overageStatus = overageStatus;
       }
-      const overageResetHeader = error.headers?.get?.("anthropic-ratelimit-unified-overage-reset");
+      const overageResetHeader = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-reset");
       if (overageResetHeader) {
         limits.overageResetsAt = Number(overageResetHeader);
       }
-      const overageDisabledReason = error.headers?.get?.("anthropic-ratelimit-unified-overage-disabled-reason");
+      const overageDisabledReason = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-disabled-reason");
       if (overageDisabledReason) {
         limits.overageDisabledReason = overageDisabledReason;
       }
@@ -122355,6 +122356,13 @@ Run /share and post the JSON file to ${MACRO.FEEDBACK_CHANNEL}.`;
       error: "billing_error"
     });
   }
+  if (error instanceof APIError && (error.status === 402 || error.message.includes('"type":"billing_error"'))) {
+    const detail = error.message.match(/"message"\s*:\s*"([^"]*)"/)?.[1];
+    return createAssistantAPIErrorMessage({
+      content: `${API_ERROR_MESSAGE_PREFIX}: ${detail || error.message}`,
+      error: "billing_error"
+    });
+  }
   if (error instanceof APIError && error.status === 400 && error.message.toLowerCase().includes("organization has been disabled")) {
     const { source } = getAnthropicApiKeyWithSource();
     if (source === "ANTHROPIC_API_KEY" && process.env.ANTHROPIC_API_KEY && !isClaudeAISubscriber()) {
@@ -176405,6 +176413,7 @@ async function* runAgent({
       mcpResources: toolUseContext.options.mcpResources,
       agentDefinitions: toolUseContext.options.agentDefinitions,
       subagentDisallowedTools: toolUseContext.options.subagentDisallowedTools,
+      fetchOverride: toolUseContext.options.fetchOverride,
       ...useExactTools && { querySource }
     };
     agentToolRuntimeContext = createSubagentContext(toolUseContext, {
@@ -226651,7 +226660,6 @@ async function* queryLoop(params, consumedCommandUuids) {
         exceeds200kTokens: permissionMode === "plan" && doesMostRecentAssistantMessageExceed200k(messagesForQuery)
       });
       queryCheckpoint("query_setup_end");
-      const dumpPromptsFetch = undefined;
       let collapseOwnsIt = false;
       if (false) {}
       const mediaRecoveryEnabled = reactiveCompact?.isReactiveCompactEnabled() ?? false;
@@ -226704,7 +226712,7 @@ async function* queryLoop(params, consumedCommandUuids) {
                 hasAppendSystemPrompt: !!toolUseContext.options.appendSystemPrompt,
                 maxOutputTokensOverride,
                 maxOutputTokensLimitOverride: params.maxOutputTokensLimitOverride,
-                fetchOverride: dumpPromptsFetch,
+                fetchOverride: toolUseContext.options.fetchOverride,
                 mcpTools: appState.mcp.tools,
                 hasPendingMcpServers: appState.mcp.clients.some((c) => c.type === "pending"),
                 queryTracking,
@@ -227383,7 +227391,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-11-03T08:26:22.842Z").getTime();
+  const buildTime = new Date("2026-11-04T12:30:46.458Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -271008,6 +271016,7 @@ class QueryEngine {
         maxOutputTokensLimit,
         contextWindow,
         modelProviders: this.config.modelProviders,
+        fetchOverride: this.config.fetchOverride,
         subagentDisallowedTools: this.config.subagentDisallowedTools,
         preDecidePermissions
       },
@@ -271107,6 +271116,7 @@ class QueryEngine {
         maxOutputTokensLimit,
         contextWindow,
         modelProviders: this.config.modelProviders,
+        fetchOverride: this.config.fetchOverride,
         subagentDisallowedTools: this.config.subagentDisallowedTools,
         preDecidePermissions
       },
@@ -271616,6 +271626,7 @@ async function* ask({
   userSpecifiedModel,
   fallbackModel,
   modelProviders,
+  fetchOverride,
   jsonSchema,
   getAppState,
   setAppState,
@@ -271646,6 +271657,7 @@ async function* ask({
     userSpecifiedModel,
     fallbackModel,
     modelProviders,
+    fetchOverride,
     thinkingConfig,
     maxTurns,
     maxBudgetUsd,
@@ -279288,6 +279300,7 @@ function runSdkQueryRuntime(params) {
           fallbackModel: typeof options.fallbackModel === "string" && options.fallbackModel.length > 0 ? options.fallbackModel : undefined,
           jsonSchema: options.jsonSchema && typeof options.jsonSchema === "object" ? options.jsonSchema : undefined,
           modelProviders: options.modelProviders && typeof options.modelProviders === "object" ? options.modelProviders : undefined,
+          fetchOverride: typeof options.fetchOverride === "function" ? options.fetchOverride : undefined,
           getAppState: appStateStore.getAppState,
           setAppState: appStateStore.setAppState,
           abortController: runtimeState.abortController,
@@ -280615,4 +280628,4 @@ export {
   watchScheduledTasks
 };
 
-//# debugId=0DC7328726EDA85F64756E2164756E21
+//# debugId=B13AF4A366BF432D64756E2164756E21

package/dist/entrypoints/sdk/runtimeTypes.d.ts

@@ -483,6 +483,13 @@ export type Options = {
      * the catalog use the session provider config as before.
      */
     modelProviders?: ModelProviders;
+    /**
+     * Host fetch for this session's model requests (main loop and subagents).
+     * Lets the host attach per-request headers or observe responses (e.g. surface
+     * a billing rejection in its own UI). Return the response unchanged unless the
+     * host deliberately alters retry semantics. Absent → global fetch.
+     */
+    fetchOverride?: typeof globalThis.fetch;
     /**
      * Per-protocol passthrough channel for fields the wire supports but the
      * SDK does not surface as first-class options. The shim merges these

package/dist/sdk.js

@@ -122191,16 +122191,17 @@ function getAssistantMessageFromError(error, model, options) {
       error: "rate_limit"
     });
   }
-  if (error instanceof APIError && error.status === 429 && shouldProcessRateLimits(isClaudeAISubscriber())) {
-    const rateLimitType = error.headers?.get?.("anthropic-ratelimit-unified-representative-claim");
-    const overageStatus = error.headers?.get?.("anthropic-ratelimit-unified-overage-status");
+  if (error instanceof APIError && error.status === 429) {
+    const quotaHeaders = shouldProcessRateLimits(isClaudeAISubscriber()) ? error.headers : undefined;
+    const rateLimitType = quotaHeaders?.get?.("anthropic-ratelimit-unified-representative-claim");
+    const overageStatus = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-status");
     if (rateLimitType || overageStatus) {
       const limits = {
         status: "rejected",
         unifiedRateLimitFallbackAvailable: false,
         isUsingOverage: false
       };
-      const resetHeader = error.headers?.get?.("anthropic-ratelimit-unified-reset");
+      const resetHeader = quotaHeaders?.get?.("anthropic-ratelimit-unified-reset");
       if (resetHeader) {
         limits.resetsAt = Number(resetHeader);
       }
@@ -122210,11 +122211,11 @@ function getAssistantMessageFromError(error, model, options) {
       if (overageStatus) {
         limits.overageStatus = overageStatus;
       }
-      const overageResetHeader = error.headers?.get?.("anthropic-ratelimit-unified-overage-reset");
+      const overageResetHeader = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-reset");
       if (overageResetHeader) {
         limits.overageResetsAt = Number(overageResetHeader);
       }
-      const overageDisabledReason = error.headers?.get?.("anthropic-ratelimit-unified-overage-disabled-reason");
+      const overageDisabledReason = quotaHeaders?.get?.("anthropic-ratelimit-unified-overage-disabled-reason");
       if (overageDisabledReason) {
         limits.overageDisabledReason = overageDisabledReason;
       }
@@ -122355,6 +122356,13 @@ Run /share and post the JSON file to ${MACRO.FEEDBACK_CHANNEL}.`;
       error: "billing_error"
     });
   }
+  if (error instanceof APIError && (error.status === 402 || error.message.includes('"type":"billing_error"'))) {
+    const detail = error.message.match(/"message"\s*:\s*"([^"]*)"/)?.[1];
+    return createAssistantAPIErrorMessage({
+      content: `${API_ERROR_MESSAGE_PREFIX}: ${detail || error.message}`,
+      error: "billing_error"
+    });
+  }
   if (error instanceof APIError && error.status === 400 && error.message.toLowerCase().includes("organization has been disabled")) {
     const { source } = getAnthropicApiKeyWithSource();
     if (source === "ANTHROPIC_API_KEY" && process.env.ANTHROPIC_API_KEY && !isClaudeAISubscriber()) {
@@ -176405,6 +176413,7 @@ async function* runAgent({
       mcpResources: toolUseContext.options.mcpResources,
       agentDefinitions: toolUseContext.options.agentDefinitions,
       subagentDisallowedTools: toolUseContext.options.subagentDisallowedTools,
+      fetchOverride: toolUseContext.options.fetchOverride,
       ...useExactTools && { querySource }
     };
     agentToolRuntimeContext = createSubagentContext(toolUseContext, {
@@ -226651,7 +226660,6 @@ async function* queryLoop(params, consumedCommandUuids) {
         exceeds200kTokens: permissionMode === "plan" && doesMostRecentAssistantMessageExceed200k(messagesForQuery)
       });
       queryCheckpoint("query_setup_end");
-      const dumpPromptsFetch = undefined;
       let collapseOwnsIt = false;
       if (false) {}
       const mediaRecoveryEnabled = reactiveCompact?.isReactiveCompactEnabled() ?? false;
@@ -226704,7 +226712,7 @@ async function* queryLoop(params, consumedCommandUuids) {
                 hasAppendSystemPrompt: !!toolUseContext.options.appendSystemPrompt,
                 maxOutputTokensOverride,
                 maxOutputTokensLimitOverride: params.maxOutputTokensLimitOverride,
-                fetchOverride: dumpPromptsFetch,
+                fetchOverride: toolUseContext.options.fetchOverride,
                 mcpTools: appState.mcp.tools,
                 hasPendingMcpServers: appState.mcp.clients.some((c) => c.type === "pending"),
                 queryTracking,
@@ -227383,7 +227391,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-11-03T08:26:22.842Z").getTime();
+  const buildTime = new Date("2026-11-04T12:30:46.458Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -271008,6 +271016,7 @@ class QueryEngine {
         maxOutputTokensLimit,
         contextWindow,
         modelProviders: this.config.modelProviders,
+        fetchOverride: this.config.fetchOverride,
         subagentDisallowedTools: this.config.subagentDisallowedTools,
         preDecidePermissions
       },
@@ -271107,6 +271116,7 @@ class QueryEngine {
         maxOutputTokensLimit,
         contextWindow,
         modelProviders: this.config.modelProviders,
+        fetchOverride: this.config.fetchOverride,
         subagentDisallowedTools: this.config.subagentDisallowedTools,
         preDecidePermissions
       },
@@ -271616,6 +271626,7 @@ async function* ask({
   userSpecifiedModel,
   fallbackModel,
   modelProviders,
+  fetchOverride,
   jsonSchema,
   getAppState,
   setAppState,
@@ -271646,6 +271657,7 @@ async function* ask({
     userSpecifiedModel,
     fallbackModel,
     modelProviders,
+    fetchOverride,
     thinkingConfig,
     maxTurns,
     maxBudgetUsd,
@@ -279288,6 +279300,7 @@ function runSdkQueryRuntime(params) {
           fallbackModel: typeof options.fallbackModel === "string" && options.fallbackModel.length > 0 ? options.fallbackModel : undefined,
           jsonSchema: options.jsonSchema && typeof options.jsonSchema === "object" ? options.jsonSchema : undefined,
           modelProviders: options.modelProviders && typeof options.modelProviders === "object" ? options.modelProviders : undefined,
+          fetchOverride: typeof options.fetchOverride === "function" ? options.fetchOverride : undefined,
           getAppState: appStateStore.getAppState,
           setAppState: appStateStore.setAppState,
           abortController: runtimeState.abortController,
@@ -280615,4 +280628,4 @@ export {
   watchScheduledTasks
 };
 
-//# debugId=461FB770EF3F268264756E2164756E21
+//# debugId=12B4F50CE40DB29164756E2164756E21

package/dist/types/toolRuntime.d.ts

@@ -124,6 +124,8 @@ export type ToolRuntimeContext = {
          * wire/endpoint than the main session gets its own provider override.
          */
         modelProviders?: ModelProviders;
+        /** Host fetch for model requests (see Options.fetchOverride); propagated to subagents. */
+        fetchOverride?: typeof globalThis.fetch;
         /**
          * Tool names excluded from sub-agents only (see Options.subagentDisallowedTools).
          * Applied by runAgent via filterSubagentDisallowedTools and propagated to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencow-ai/opencow-agent-sdk",
-  "version": "0.4.29",
+  "version": "0.4.30",
   "description": "Claude Code opened to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
   "type": "module",
   "main": "./dist/sdk.js",