@opencow-ai/opencow-agent-sdk 0.4.24 → 0.4.26

package/dist/constants/envVars.d.ts

@@ -235,6 +235,11 @@ 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 SKILL_LISTING: 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/entrypoints/sdk/runtimeTypes.d.ts

@@ -149,6 +149,12 @@ export type SdkManagedPlugin = {
     contentHash: string;
     dataPath: string;
     permissionGrant: SdkPluginPermissionGrant;
+    /**
+     * Host-supplied runtime environment values for this plugin's components
+     * (e.g. a third-party token the user entered in the host UI). Values take
+     * precedence over the ambient process env and stay scoped to this plugin.
+     */
+    env?: Record<string, string>;
 };
 export type SdkPluginSnapshot = {
     revision: string;
@@ -362,6 +368,16 @@ export type Options = {
      * query startup never blocks on host skill resolution.
      */
     skillCommandsProvider?: () => Promise<readonly unknown[]>;
+    /**
+     * 技能清单附件（`skill_listing`）总开关，默认 `true`（行为与未加开关前一致）。
+     *
+     * 置 `false` 后 SDK 不再把技能清单作为附件挂到用户消息上——用于 host 自己在
+     * 系统提示里维护技能目录、并自行通知技能增删变化的场景。技能正文仍走 Skill
+     * 工具按名加载，不受影响。
+     *
+     * 进程级等价物为 `OPENCOW_SKILL_LISTING=0`；per-query 的显式选项优先于进程环境。
+     */
+    skillListing?: boolean;
     /**
      * Phase 1B.11d — host-provided agent definitions. Each entry is merged
      * into the internal agent list used by the built-in AgentTool. Type is

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;