@agent-proxy/zcode 0.0.0-stage → 0.11.1

package/dist/response.d.ts

@@ -0,0 +1,27 @@
+import { type ZcodeToolMap } from "./wire.ts";
+import { type ZcodeGatewayCall } from "./vision.ts";
+/** 网关代执行工具（analyze_image）的驱动层钩子：执行调用并按需发起上游续跑。 */
+export interface ZcodeGatewayToolsHook {
+    /** 执行一次被吸收的调用；返回作为 tool_result 呈给上游的文本。抛错时降级为错误说明文本。 */
+    execute: (call: ZcodeGatewayCall) => Promise<string>;
+    /** 追加 tool_use/tool_result 消息后发起下一次上游请求；失败应抛错（整条响应转 failed）。 */
+    nextUpstream: (calls: Array<{
+        call: ZcodeGatewayCall;
+        result: string;
+    }>) => Promise<Response>;
+    /** 续跑上限（防止模型循环调用）。 */
+    maxContinuations: number;
+}
+export interface ZcodeResponseOptions {
+    model: string;
+    tools: ZcodeToolMap;
+    stream: boolean;
+    signal?: AbortSignal;
+    abort?: () => void;
+    onComplete?: (response: Record<string, unknown>) => void;
+    onChunk?: (chunk: string) => void;
+    sanitizeError?: (error: Record<string, unknown>) => Record<string, unknown>;
+    /** 声明了网关代执行工具时必须提供；否则吸收到相关调用会让响应失败。 */
+    gatewayTools?: ZcodeGatewayToolsHook;
+}
+export declare function createZcodeResponse(upstream: Response, options: ZcodeResponseOptions): Promise<Response>;