@kenkaiiii/gg-agent 5.29.0 → 5.30.0

package/dist/index.d.cts

@@ -20,6 +20,13 @@ interface AgentTool<T extends z.ZodType = z.ZodType> extends Tool {
      * batch runs in source order so stateful mutations cannot race each other.
      */
     executionMode?: ToolExecutionMode;
+    /**
+     * Overrides the loop's default per-tool timeout. A tool that owns a longer
+     * internal budget than the default must declare it here, or the loop cancels
+     * it first and the tool's own timeout — with its specific, actionable error
+     * message — becomes unreachable.
+     */
+    timeoutMs?: number;
     execute: (args: z.infer<T>, context: ToolContext) => ToolExecuteResult | Promise<ToolExecuteResult>;
 }
 interface AgentTextDeltaEvent {

package/dist/index.d.ts

@@ -20,6 +20,13 @@ interface AgentTool<T extends z.ZodType = z.ZodType> extends Tool {
      * batch runs in source order so stateful mutations cannot race each other.
      */
     executionMode?: ToolExecutionMode;
+    /**
+     * Overrides the loop's default per-tool timeout. A tool that owns a longer
+     * internal budget than the default must declare it here, or the loop cancels
+     * it first and the tool's own timeout — with its specific, actionable error
+     * message — becomes unreachable.
+     */
+    timeoutMs?: number;
     execute: (args: z.infer<T>, context: ToolContext) => ToolExecuteResult | Promise<ToolExecuteResult>;
 }
 interface AgentTextDeltaEvent {

package/dist/index.js

@@ -35,6 +35,7 @@ function isLocalBackendUrl(baseUrl) {
 
 // src/agent-loop.ts
 var DEFAULT_MAX_TURNS = 300;
+var DEFAULT_TOOL_TIMEOUT_MS = 3e5;
 var _diagFn = null;
 function setStreamDiagnostic(fn) {
   _diagFn = fn;
@@ -704,7 +705,15 @@ async function* agentLoop(messages, options) {
               role: "assistant",
               content: [{ type: "text", text: attemptText }]
             });
-            messages.push({ role: "user", content: PARTIAL_CONTINUATION_PROMPT });
+            messages.push({
+              role: "user",
+              content: PARTIAL_CONTINUATION_PROMPT,
+              provenance: {
+                source: "runtime",
+                kind: "continuation",
+                visibility: "hidden"
+              }
+            });
             preservedChars = attemptText.length;
           }
           diag("retry", {
@@ -874,7 +883,15 @@ async function* agentLoop(messages, options) {
               model: options.model
             });
             yield { type: "truncated", reason: "max_tokens", continued: true };
-            messages.push({ role: "user", content: MAX_TOKENS_CONTINUATION_PROMPT });
+            messages.push({
+              role: "user",
+              content: MAX_TOKENS_CONTINUATION_PROMPT,
+              provenance: {
+                source: "runtime",
+                kind: "continuation",
+                visibility: "hidden"
+              }
+            });
             continue;
           }
           yield { type: "truncated", reason: "max_tokens", continued: false };
@@ -1015,7 +1032,12 @@ async function* agentLoop(messages, options) {
             };
             messages.push({
               role: "user",
-              content: turnBudgetContinuationPrompt()
+              content: turnBudgetContinuationPrompt(),
+              provenance: {
+                source: "runtime",
+                kind: "continuation",
+                visibility: "hidden"
+              }
             });
           }
         }
@@ -1081,7 +1103,7 @@ async function executeSingleToolCall(toolCall, options, pushEvent) {
     try {
       const parsed = tool.parameters.parse(toolCall.args);
       const callerSignal = options.signal;
-      const toolTimeout = AbortSignal.timeout(3e5);
+      const toolTimeout = AbortSignal.timeout(tool.timeoutMs ?? DEFAULT_TOOL_TIMEOUT_MS);
       const ctx = {
         signal: callerSignal ? AbortSignal.any([callerSignal, toolTimeout]) : toolTimeout,
         toolCallId: toolCall.id,