@runtypelabs/sdk 4.8.0 → 4.9.0

package/dist/index.mjs

@@ -6217,6 +6217,8 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     }
     let currentBody = response.body;
     let accumulatedOutput = "";
+    let lastKnownCost = 0;
+    let lastKnownTokens;
     let pauseCount = 0;
     let discoveryPauseCount = 0;
     let consecutiveDiscoveryPauseCount = 0;
@@ -6234,6 +6236,15 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           }
           callbacks?.onTurnDelta?.(event);
         },
+        onTurnComplete: (event) => {
+          if (typeof event.cost === "number") {
+            lastKnownCost = event.cost;
+          }
+          if (event.tokens) {
+            lastKnownTokens = event.tokens;
+          }
+          callbacks?.onTurnComplete?.(event);
+        },
         onAgentPaused: (event) => {
           pausedEvent = event;
           callbacks?.onAgentPaused?.(event);
@@ -6363,6 +6374,39 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           callbacks?.onAgentComplete?.(forcedCompleteEvent);
           return { completeEvent: forcedCompleteEvent, toolMessages };
         }
+        if (options?.shouldInterrupt?.()) {
+          callbacks?.onLocalToolExecutionComplete?.({
+            executionId,
+            toolCallId: toolId,
+            toolName,
+            parameters: parsedParams,
+            result: toolResult,
+            success: true,
+            completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            durationMs: Date.now() - localExecutionStartedAtMs
+          });
+          const interruptCompleteEvent = {
+            type: "agent_complete",
+            executionId,
+            seq: 0,
+            agentId: id,
+            success: true,
+            iterations: 1,
+            stopReason: "end_turn",
+            completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            // Carry the spend observed so far so the interrupted session's
+            // cost still lands in marathon totals and budget accounting
+            totalCost: lastKnownCost,
+            ...lastKnownTokens ? { totalTokens: lastKnownTokens } : {},
+            finalOutput: [
+              accumulatedOutput.trim(),
+              "Session ended early: user steering was queued and will be delivered at the start of the next session."
+            ].filter(Boolean).join("\n\n"),
+            duration: 0
+          };
+          callbacks?.onAgentComplete?.(interruptCompleteEvent);
+          return { completeEvent: interruptCompleteEvent, toolMessages };
+        }
         const resumeResponse = await this.client.requestStream(`/agents/${id}/resume`, {
           method: "POST",
           body: JSON.stringify({
@@ -7428,6 +7472,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       if (session === 0 && !options.previousMessages) {
         state.originalMessage = options.message;
       }
+      const queuedSteeringMessages = options.getQueuedUserMessages?.() ?? [];
       const preparedSession = await this.prepareSessionContext(
         options.message,
         state,
@@ -7447,7 +7492,8 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           builtinToolSchemas,
           onContextCompaction: options.onContextCompaction,
           onContextNotice: options.onContextNotice
-        }
+        },
+        queuedSteeringMessages
       );
       const { messages, requestContextManagement, pendingNativeCompactionEvent } = preparedSession;
       let sessionResult;
@@ -7474,7 +7520,8 @@ var _AgentsEndpoint = class _AgentsEndpoint {
             sessionLocalTools || options.localTools,
             sessionCallbacks,
             {
-              onLocalToolResult: this.createLocalToolLoopGuard(state, sessionTrace, workflow)
+              onLocalToolResult: this.createLocalToolLoopGuard(state, sessionTrace, workflow),
+              shouldInterrupt: options.hasQueuedUserMessages
             },
             state.taskName
           );
@@ -8150,7 +8197,7 @@ Do NOT redo any of the above work.`
     );
     return prepared.messages;
   }
-  async prepareSessionContext(originalMessage, state, sessionIndex, maxSessions, localToolNames, continuationContext, workflow, builtinToolIds, compactionOptions) {
+  async prepareSessionContext(originalMessage, state, sessionIndex, maxSessions, localToolNames, continuationContext, workflow, builtinToolIds, compactionOptions, steeringMessages) {
     const wf = workflow ?? defaultWorkflow;
     const compactInstructions = compactionOptions?.compactInstructions;
     const resolvedStrategy = continuationContext?.compact ? "summary_fallback" : this.resolveCompactStrategy(compactionOptions?.compactStrategy, compactionOptions?.model);
@@ -8235,6 +8282,11 @@ Do NOT redo any of the above work.`
     const phaseBlock = ["", this.buildPhaseInstructions(state, wf)].join("\n");
     const candidateBlock = wf.buildCandidateBlock?.(state) ?? "";
     const multiSessionInstruction = `This is a multi-session task (session ${sessionIndex + 1}/${maxSessions}). When you have fully completed the task, end your response with TASK_COMPLETE on its own line.`;
+    const steeringLines = steeringMessages && steeringMessages.length > 0 ? [
+      "--- User steering (queued during the previous session) ---",
+      ...steeringMessages,
+      ""
+    ] : [];
     if (continuationContext && sessionIndex === 0) {
       const replayHistoryMessages = this.sanitizeReplayHistoryMessages(
         continuationContext.previousMessages
@@ -8245,6 +8297,7 @@ Do NOT redo any of the above work.`
       const userContent = [
         continuationGuardrail,
         "",
+        ...steeringLines,
         userMessage,
         phaseBlock,
         toolsBlock,
@@ -8347,6 +8400,7 @@ Do NOT redo any of the above work.`
       const recoveryMessage2 = this.buildStuckTurnRecoveryMessage(state, wf);
       const rejectionNotice = state.lastCompletionRejectionReason ? `TASK_COMPLETE was rejected because: ${state.lastCompletionRejectionReason}. Address this before signaling completion again.` : void 0;
       const continuationContent = [
+        ...steeringLines,
         "Continue the task.",
         phaseBlock,
         toolsBlock,
@@ -8420,6 +8474,7 @@ Do NOT redo any of the above work.`
     const recoveryMessage = this.buildStuckTurnRecoveryMessage(state, wf);
     const fallbackRejectionNotice = state.lastCompletionRejectionReason ? `TASK_COMPLETE was rejected because: ${state.lastCompletionRejectionReason}. Address this before signaling completion again.` : void 0;
     const content = [
+      ...steeringLines,
       originalMessage,
       phaseBlock,
       toolsBlock,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "4.8.0",
+  "version": "4.9.0",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",