@opencow-ai/opencow-agent-sdk 0.4.23 → 0.4.25

package/dist/constants/envVars.d.ts

@@ -235,6 +235,10 @@ export declare const ENV_VARS: {
     readonly DEBUG_INPUT: EnvVarSpec;
     readonly DISABLE_EARLY_INPUT: EnvVarSpec;
     readonly ENABLE_EXTENDED_KEYS: EnvVarSpec;
+    readonly ENABLE_STREAM_WATCHDOG: EnvVarSpec;
+    readonly STREAM_IDLE_TIMEOUT_MS: EnvVarSpec;
+    readonly UNBOUNDED_CONNECTION_RETRY: EnvVarSpec;
+    readonly STREAM_REPLAY_RETRIES: EnvVarSpec;
     readonly USE_READABLE_STDIN: EnvVarSpec;
 };
 export type EnvVarKey = keyof typeof ENV_VARS;

package/dist/controller/dispatch/permissionPreDecision.d.ts

@@ -0,0 +1,22 @@
+import type { CanonicalToolUseBlock as ToolUseBlock } from '../../session/canonical/index.js';
+import { type CanUseToolFn, type ToolRuntimeContext } from '../../types/toolRuntime.js';
+import type { AssistantMessage } from '../../types/message.js';
+import type { PermissionResult } from '../../types/permissions.js';
+/**
+ * 权限决策前置：runTools() 入口对同批全部 tool_use 并发预调 canUseTool，把
+ * 决策 promise 缓存到 toolUseContext.permissionPreDecisions；工具仍按原顺序
+ * 独占执行，执行时经 consumePermissionPreDecision 消费缓存，避免串行批里
+ * host 审批逐个阻塞弹出。
+ *
+ * 与执行期（checkPermissionsAndCallTool）对齐的规范化：找不到 tool runtime、
+ * zod 校验失败的块跳过（执行期走各自的内联错误路径，本就不该有预决策）；
+ * backfillObservableInput 在浅克隆上调用，与执行期 backfill 后的 observable
+ * input 保持一致，保证消费时深比较有命中机会。
+ */
+export declare function startPermissionPreDecisions(blocks: ToolUseBlock[], assistantMessages: AssistantMessage[], canUseTool: CanUseToolFn, toolUseContext: ToolRuntimeContext): void;
+/**
+ * 一次性消费预决策：无缓存 / input 与执行期不一致（hook 改写等）时回退
+ * fallback 内联询问；命中则返回缓存 promise。无论命中与否，条目取出即删——
+ * 后续同名 tool_use（如 forceDecision 场景）必须重新询问。
+ */
+export declare function consumePermissionPreDecision(toolUseContext: ToolRuntimeContext, toolUseID: string, input: Record<string, unknown>, fallback: () => Promise<PermissionResult>): Promise<PermissionResult>;

package/dist/controller/loop.d.ts

@@ -26,6 +26,11 @@ export declare function adjustParamsForNonStreaming<T extends {
  * tool schemas, session identity, caching strategy, and host callbacks.
  */
 export type Options = {
+    /**
+     * 内部：由 replayStreamOnTransportError 置位。为 true 时，读流阶段的可重放传输错误
+     * （且尚无完整消息送出）作为异常抛给调用方重放，而不是转成 assistant 错误消息。
+     */
+    streamReplayEscape?: boolean;
     getToolPermissionContext: () => Promise<ToolPermissionContext>;
     model: string;
     toolChoice?: BetaToolChoiceTool | BetaToolChoiceAuto | undefined;

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

@@ -287,6 +287,17 @@ export type Options = {
     replayUserMessages?: boolean;
     permissionMode?: string;
     canUseTool?: SdkCanUseTool;
+    /**
+     * 权限决策前置。开启后，同一批 queued tool_use 的 canUseTool 会在工具调度
+     * 入口并发预调并缓存结果；工具仍按原顺序独占执行（串行语义、context
+     * modifier 顺序、级联取消均不变），执行时消费缓存决策，不再逐个阻塞等待
+     * host 审批。PreToolUse hook 改写 input 或给出 ask 消息时缓存自动 miss，
+     * 回退执行期内联询问。
+     *
+     * mechanism / policy 分层：SDK 只提供预决策机制，默认 false，是否开启由
+     * host 决定（host 需接受 canUseTool 被并发调用）。
+     */
+    preDecidePermissions?: boolean;
     mcpServers?: Record<string, McpServerConfig>;
     /**
      * Selects the SDK-owned built-in tool set for this query.

package/dist/lib/toolInputNullCoercion.d.ts

@@ -20,4 +20,4 @@ import type { z } from 'zod/v4';
  * 习惯性回传 `null`，只剥顶层会漏掉它们、导致整个阻塞工具因校验失败被跳过（handler
  * 不执行、不阻塞，对话直接溜到下一轮）。
  */
-export declare function safeParseToolInputWithNullCoercion<T extends z.ZodType>(schema: T, input: unknown): ReturnType<T['safeParse']>;
+export declare function safeParseToolInputWithNullCoercion<T extends z.ZodType>(schema: T, input: unknown, unknownKeys?: 'strip' | 'reject'): ReturnType<T['safeParse']>;

package/dist/providers/shared/retry.d.ts

@@ -1,16 +1,48 @@
 import type Anthropic from '@anthropic-ai/sdk';
-import { APIError } from '@anthropic-ai/sdk';
+import { APIConnectionError, APIError } from '@anthropic-ai/sdk';
 import type { QuerySource } from 'src/constants/querySource.js';
 import type { SystemAPIErrorMessage } from 'src/types/message.js';
 import type { ThinkingConfig } from '../../lib/thinking.js';
 export declare const BASE_DELAY_MS = 500;
+/**
+ * 200 头已到、读 body 时连接被切断，Anthropic SDK 抛的是原始 TypeError，
+ * 不经过它自己的连接错误包装；不补包装就会落入下方「非 APIError 不重试」。
+ * 只认传输特征（cause 带系统错误码或固定文案），普通 TypeError 仍按程序错误处理。
+ */
+export declare function wrapBodyTransportError(error: unknown): unknown;
+/** 读流阶段的传输中断（对端关闭、socket 断开、空闲看门狗中止）可以整条请求重放；其余不行。 */
+export declare function toReplayableStreamError(error: unknown): APIConnectionError | null;
+/**
+ * 流式响应读到一半断开、且还没有任何完整消息送出时，整个流式请求重放。
+ * 只在宿主显式给出重放次数时启用（默认 0 = 关闭，行为不变）。
+ * `run(escapable)`：前 maxReplays 次尝试 escapable=true，允许 queryModel 把可重放的流错误
+ * 作为异常抛出（否则它会把错误转成一条 assistant 错误消息）；最后一次 escapable=false，
+ * 错误照常转成消息，所以总尝试次数是 maxReplays + 1，最终报错文案与不开启时一致。
+ * 已有完整 assistant 消息送出（工具可能已在执行）则不重放，避免重复执行；
+ * 重放前送出的 stream_event 半截内容由新的 message_start 取代。
+ * 建立连接阶段的失败由 withRetry 处理，这里只管读流阶段。
+ */
+export declare function replayStreamOnTransportError<T extends {
+    type: string;
+}>(run: (escapable: boolean) => AsyncGenerator<T, void>, options: {
+    maxReplays: number;
+    signal?: AbortSignal;
+    delayMs?: (replay: number) => number;
+}): AsyncGenerator<T | SystemAPIErrorMessage, void>;
+export declare function getConnectionWaitDelay(attempt: number, backoff?: ConnectionWaitBackoff, random?: () => number): number;
 export interface RetryContext {
     maxTokensOverride?: number;
     model: string;
     thinkingConfig: ThinkingConfig;
     fastMode?: boolean;
 }
+export interface ConnectionWaitBackoff {
+    initialMs: number;
+    maxMs: number;
+}
 interface RetryOptions {
+    /** 连接错误等待的退避节奏，默认 5s 起翻倍、上限 60s；主要供测试缩短等待。 */
+    connectionWaitBackoff?: ConnectionWaitBackoff;
     maxRetries?: number;
     model: string;
     fallbackModel?: string;