@opencow-ai/opencow-agent-sdk 0.4.24 → 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/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/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;