@prestyj/agent 4.2.77 → 4.3.15

package/dist/index.cjs

@@ -25,7 +25,8 @@ __export(index_exports, {
   agentLoop: () => agentLoop,
   isAbortError: () => isAbortError,
   isBillingError: () => isBillingError,
-  isContextOverflow: () => isContextOverflow
+  isContextOverflow: () => isContextOverflow,
+  setStreamDiagnostic: () => setStreamDiagnostic
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -34,7 +35,14 @@ var import_ai2 = require("@prestyj/ai");
 
 // src/agent-loop.ts
 var import_ai = require("@prestyj/ai");
-var DEFAULT_MAX_TURNS = 100;
+var DEFAULT_MAX_TURNS = 200;
+var _diagFn = null;
+function setStreamDiagnostic(fn) {
+  _diagFn = fn;
+}
+function diag(phase, data) {
+  _diagFn?.(phase, data);
+}
 function isAbortError(err) {
   if (!(err instanceof Error)) return false;
   if (err.name === "AbortError") return true;
@@ -49,7 +57,12 @@ function isContextOverflow(err) {
 function isBillingError(err) {
   if (!(err instanceof Error)) return false;
   const msg = err.message.toLowerCase();
-  return msg.includes("insufficient balance") || msg.includes("no resource package") || msg.includes("quota exceeded") || msg.includes("billing") || msg.includes("recharge");
+  return msg.includes("insufficient balance") || msg.includes("no resource package") || msg.includes("quota exceeded") || msg.includes("billing") || msg.includes("recharge") || msg.includes("subscription plan") || msg.includes("does not yet include access");
+}
+function isToolPairingError(err) {
+  if (!(err instanceof Error)) return false;
+  const msg = err.message.toLowerCase();
+  return msg.includes("tool_use") && msg.includes("tool_result") || msg.includes("unexpected `tool_use_id`") || msg.includes("tool_use ids found without");
 }
 function isOverloaded(err) {
   if (!(err instanceof Error)) return false;
@@ -65,18 +78,45 @@ async function* agentLoop(messages, options) {
   let turn = 0;
   let firstTurn = true;
   let consecutivePauses = 0;
+  let toolPairingRepaired = false;
   let overflowRetries = 0;
   let overloadRetries = 0;
   let emptyResponseRetries = 0;
+  let stallRetries = 0;
   const MAX_OVERFLOW_RETRIES = 3;
   const MAX_OVERLOAD_RETRIES = 10;
-  const MAX_EMPTY_RESPONSE_RETRIES = 3;
+  const MAX_EMPTY_RESPONSE_RETRIES = 2;
+  const MAX_STALL_RETRIES = 5;
+  const STALL_DELAY_MS = 1e3;
   const OVERLOAD_BASE_DELAY_MS = 2e3;
   const OVERLOAD_MAX_DELAY_MS = 3e4;
+  const STREAM_FIRST_EVENT_TIMEOUT_MS = 45e3;
+  const STREAM_IDLE_TIMEOUT_MS = 3e4;
+  const STREAM_HARD_TIMEOUT_MS = 9e4;
+  const STREAM_OUTPUT_HARD_TIMEOUT_MS = 3e5;
+  const STREAM_THINKING_IDLE_TIMEOUT_MS = 3e5;
+  const STREAM_THINKING_HARD_TIMEOUT_MS = 6e5;
   try {
     while (turn < maxTurns) {
       options.signal?.throwIfAborted();
       turn++;
+      let msgChars = 0;
+      for (const m of messages) {
+        if (typeof m.content === "string") msgChars += m.content.length;
+        else if (Array.isArray(m.content)) {
+          for (const p of m.content) {
+            if ("text" in p && typeof p.text === "string") msgChars += p.text.length;
+            if ("content" in p && typeof p.content === "string") msgChars += p.content.length;
+          }
+        }
+      }
+      diag("turn_start", {
+        turn,
+        messages: messages.length,
+        chars: msgChars,
+        provider: options.provider,
+        model: options.model
+      });
       if (firstTurn && options.getSteeringMessages) {
         const steering = await options.getSteeringMessages();
         if (steering && steering.length > 0) {
@@ -88,14 +128,62 @@ async function* agentLoop(messages, options) {
       }
       firstTurn = false;
       if (options.transformContext) {
+        diag("transform_start");
         const transformed = await options.transformContext(messages);
         if (transformed !== messages) {
+          diag("transform_compacted", {
+            before: messages.length,
+            after: transformed.length
+          });
           messages.length = 0;
           messages.push(...transformed);
         }
+        diag("transform_end");
       }
+      repairToolPairingAdjacent(messages);
       let response;
+      const streamController = new AbortController();
+      let idleTimer = null;
+      let hardTimer = null;
+      let idleTimedOut = false;
+      let streamEventCount = 0;
+      let lastEventTime = Date.now();
+      let streamCallStart = Date.now();
+      const eventTypeCounts = {};
+      let lastEventType = "";
+      let lastYieldEndTime = Date.now();
+      let maxConsumerLagMs = 0;
+      const forwardAbort = () => streamController.abort();
+      options.signal?.addEventListener("abort", forwardAbort, { once: true });
+      let hasReceivedEvent = false;
+      let hasReceivedThinking = false;
+      const resetIdleTimer = () => {
+        if (idleTimer) clearTimeout(idleTimer);
+        const timeoutMs = hasReceivedEvent ? STREAM_IDLE_TIMEOUT_MS : hasReceivedThinking ? STREAM_THINKING_IDLE_TIMEOUT_MS : STREAM_FIRST_EVENT_TIMEOUT_MS;
+        idleTimer = setTimeout(() => {
+          diag("idle_timeout_fired", {
+            events: streamEventCount,
+            sinceLastEventMs: Date.now() - lastEventTime,
+            lastEventType,
+            maxConsumerLagMs,
+            phase: hasReceivedEvent ? "mid_stream" : hasReceivedThinking ? "post_thinking" : "first_event",
+            eventTypes: eventTypeCounts
+          });
+          idleTimedOut = true;
+          streamController.abort();
+        }, timeoutMs);
+      };
+      let hardTimeoutMs = STREAM_HARD_TIMEOUT_MS;
+      hardTimer = setTimeout(() => {
+        diag("hard_timeout_fired", {
+          events: typeof streamEventCount !== "undefined" ? streamEventCount : 0
+        });
+        idleTimedOut = true;
+        streamController.abort();
+      }, hardTimeoutMs);
       try {
+        diag("stream_call");
+        streamCallStart = Date.now();
         const result = (0, import_ai.stream)({
           provider: options.provider,
           model: options.model,
@@ -108,15 +196,63 @@ async function* agentLoop(messages, options) {
           thinking: options.thinking,
           apiKey: options.apiKey,
           baseUrl: options.baseUrl,
-          signal: options.signal,
+          signal: streamController.signal,
           accountId: options.accountId,
           cacheRetention: options.cacheRetention,
           compaction: options.compaction,
           clearToolUses: options.clearToolUses
         });
+        diag("stream_created", { setupMs: Date.now() - streamCallStart });
         result.response.catch(() => {
         });
+        streamEventCount = 0;
+        hasReceivedEvent = false;
+        lastEventTime = Date.now();
+        streamCallStart = Date.now();
+        resetIdleTimer();
         for await (const event of result) {
+          const pullTime = Date.now();
+          const consumerLag = pullTime - lastYieldEndTime;
+          if (consumerLag > maxConsumerLagMs) maxConsumerLagMs = consumerLag;
+          streamEventCount++;
+          eventTypeCounts[event.type] = (eventTypeCounts[event.type] ?? 0) + 1;
+          lastEventType = event.type;
+          if ((event.type === "text_delta" || event.type === "server_toolcall" || event.type === "toolcall_delta") && !hasReceivedEvent) {
+            hasReceivedEvent = true;
+            if (hardTimer && hardTimeoutMs < STREAM_OUTPUT_HARD_TIMEOUT_MS) {
+              clearTimeout(hardTimer);
+              hardTimeoutMs = STREAM_OUTPUT_HARD_TIMEOUT_MS;
+              hardTimer = setTimeout(() => {
+                diag("hard_timeout_fired", { events: streamEventCount });
+                idleTimedOut = true;
+                streamController.abort();
+              }, hardTimeoutMs);
+            }
+          }
+          if (event.type === "thinking_delta" && !hasReceivedThinking) {
+            hasReceivedThinking = true;
+            if (hardTimer) clearTimeout(hardTimer);
+            hardTimeoutMs = STREAM_THINKING_HARD_TIMEOUT_MS;
+            hardTimer = setTimeout(() => {
+              diag("hard_timeout_fired", { events: streamEventCount });
+              idleTimedOut = true;
+              streamController.abort();
+            }, hardTimeoutMs);
+          }
+          const now = Date.now();
+          const gap = now - lastEventTime;
+          if (streamEventCount === 1) {
+            diag("first_event", { type: event.type, ttfMs: now - streamCallStart });
+          } else if (gap > 3e3) {
+            diag("slow_gap", {
+              type: event.type,
+              gapMs: gap,
+              eventNum: streamEventCount,
+              sinceStartMs: now - streamCallStart
+            });
+          }
+          lastEventTime = now;
+          resetIdleTimer();
           if (event.type === "text_delta") {
             yield { type: "text_delta", text: event.text };
           } else if (event.type === "thinking_delta") {
@@ -135,12 +271,40 @@ async function* agentLoop(messages, options) {
               resultType: event.resultType,
               data: event.data
             };
+          } else if (event.type === "toolcall_delta") {
+            yield {
+              type: "toolcall_delta",
+              chars: event.argsJson?.length ?? 0
+            };
           }
+          lastYieldEndTime = Date.now();
         }
+        diag("stream_done", {
+          events: streamEventCount,
+          totalMs: Date.now() - streamCallStart,
+          maxConsumerLagMs,
+          eventTypes: eventTypeCounts
+        });
         response = await result.response;
       } catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        diag("stream_error", {
+          error: errMsg.slice(0, 200),
+          events: streamEventCount,
+          totalMs: Date.now() - streamCallStart,
+          idleTimedOut,
+          aborted: !!options.signal?.aborted,
+          eventTypes: eventTypeCounts,
+          provider: options.provider,
+          model: options.model
+        });
         if (overflowRetries < MAX_OVERFLOW_RETRIES && isContextOverflow(err) && options.transformContext) {
           overflowRetries++;
+          diag("retry", {
+            reason: "context_overflow",
+            attempt: overflowRetries,
+            maxAttempts: MAX_OVERFLOW_RETRIES
+          });
           yield {
             type: "retry",
             reason: "context_overflow",
@@ -162,6 +326,12 @@ async function* agentLoop(messages, options) {
             OVERLOAD_BASE_DELAY_MS * 2 ** (overloadRetries - 1),
             OVERLOAD_MAX_DELAY_MS
           );
+          diag("retry", {
+            reason: "overloaded",
+            attempt: overloadRetries,
+            maxAttempts: MAX_OVERLOAD_RETRIES,
+            delayMs
+          });
           yield {
             type: "retry",
             reason: "overloaded",
@@ -173,16 +343,83 @@ async function* agentLoop(messages, options) {
           turn--;
           continue;
         }
+        if (idleTimedOut && !options.signal?.aborted && stallRetries < MAX_STALL_RETRIES) {
+          stallRetries++;
+          const delayMs = Math.min(STALL_DELAY_MS * 2 ** (stallRetries - 1), 8e3);
+          diag("retry", {
+            reason: "stream_stall",
+            attempt: stallRetries,
+            maxAttempts: MAX_STALL_RETRIES,
+            delayMs,
+            events: streamEventCount
+          });
+          yield {
+            type: "retry",
+            reason: "stream_stall",
+            attempt: stallRetries,
+            maxAttempts: MAX_STALL_RETRIES,
+            delayMs,
+            silent: stallRetries <= 2
+          };
+          await new Promise((r) => setTimeout(r, delayMs));
+          turn--;
+          continue;
+        }
+        if (idleTimedOut && !options.signal?.aborted) {
+          diag("stall_exhausted", {
+            stallRetries: MAX_STALL_RETRIES,
+            provider: options.provider,
+            model: options.model
+          });
+          yield {
+            type: "error",
+            error: new Error(
+              `The API provider's stream stalled ${MAX_STALL_RETRIES} times \u2014 the provider may be experiencing capacity issues. Your conversation is preserved. Send another message to retry.`
+            )
+          };
+          break;
+        }
+        if (isToolPairingError(err) && !toolPairingRepaired) {
+          toolPairingRepaired = true;
+          diag("tool_pairing_repair", { error: errMsg.slice(0, 200) });
+          repairToolPairingAdjacent(messages);
+          turn--;
+          continue;
+        }
         if (isAbortError(err) || options.signal?.aborted) {
+          diag("aborted", { turn, provider: options.provider, model: options.model });
           break;
         }
+        diag("unhandled_error", {
+          error: errMsg.slice(0, 500),
+          turn,
+          provider: options.provider,
+          model: options.model
+        });
         throw err;
+      } finally {
+        if (idleTimer) clearTimeout(idleTimer);
+        if (hardTimer) clearTimeout(hardTimer);
+        options.signal?.removeEventListener("abort", forwardAbort);
       }
       overflowRetries = 0;
       overloadRetries = 0;
-      if (response.usage.outputTokens === 0 && (response.message.content === "" || Array.isArray(response.message.content) && response.message.content.length === 0)) {
+      stallRetries = 0;
+      const contentArr = Array.isArray(response.message.content) ? response.message.content : null;
+      const hasActionableContent = response.message.content !== "" && contentArr !== null && contentArr.some(
+        (p) => p.type === "text" || p.type === "tool_call" || p.type === "server_tool_call"
+      );
+      if (!hasActionableContent) {
         if (emptyResponseRetries < MAX_EMPTY_RESPONSE_RETRIES) {
           emptyResponseRetries++;
+          diag("retry", {
+            reason: "empty_response",
+            attempt: emptyResponseRetries,
+            maxAttempts: MAX_EMPTY_RESPONSE_RETRIES,
+            provider: options.provider,
+            model: options.model,
+            contentTypes: contentArr?.map((p) => p.type).join(",") ?? "empty"
+          });
           yield {
             type: "retry",
             reason: "empty_response",
@@ -442,6 +679,59 @@ function sanitizeOrphanedServerTools(messages) {
     break;
   }
 }
+function repairToolPairingAdjacent(messages) {
+  for (let i = 0; i < messages.length; i++) {
+    const msg = messages[i];
+    if (msg.role !== "assistant") continue;
+    if (typeof msg.content === "string" || !Array.isArray(msg.content)) continue;
+    const toolCallIds = msg.content.filter((p) => p.type === "tool_call").map((p) => p.id);
+    if (toolCallIds.length === 0) continue;
+    const next = messages[i + 1];
+    if (next?.role === "tool" && Array.isArray(next.content)) {
+      const existingIds = new Set(next.content.map((r) => r.toolCallId));
+      const missing = toolCallIds.filter((id) => !existingIds.has(id));
+      if (missing.length > 0) {
+        for (const id of missing) {
+          next.content.push({
+            type: "tool_result",
+            toolCallId: id,
+            content: "Tool execution was interrupted.",
+            isError: true
+          });
+        }
+      }
+    } else {
+      messages.splice(i + 1, 0, {
+        role: "tool",
+        content: toolCallIds.map((id) => ({
+          type: "tool_result",
+          toolCallId: id,
+          content: "Tool execution was interrupted.",
+          isError: true
+        }))
+      });
+    }
+  }
+  const toolCallIdSet = /* @__PURE__ */ new Set();
+  for (let i = 0; i < messages.length; i++) {
+    const msg = messages[i];
+    if (msg.role === "assistant" && Array.isArray(msg.content)) {
+      for (const p of msg.content) {
+        if (p.type === "tool_call") toolCallIdSet.add(p.id);
+      }
+    }
+    if (msg.role === "tool" && Array.isArray(msg.content)) {
+      const results = msg.content;
+      const filtered = results.filter((r) => toolCallIdSet.has(r.toolCallId));
+      if (filtered.length === 0) {
+        messages.splice(i, 1);
+        i--;
+      } else if (filtered.length < results.length) {
+        msg.content = filtered;
+      }
+    }
+  }
+}
 
 // src/agent.ts
 var AgentStream = class {
@@ -548,6 +838,7 @@ var Agent = class {
   agentLoop,
   isAbortError,
   isBillingError,
-  isContextOverflow
+  isContextOverflow,
+  setStreamDiagnostic
 });
 //# sourceMappingURL=index.cjs.map