@runtypelabs/sdk 1.8.2 → 1.9.1

package/dist/index.cjs

@@ -3084,7 +3084,9 @@ var deployPhase = {
       "  4. If the deploy fails, read the error output, fix the code, and call deploy_sandbox again.",
       "  5. The sandbox is persistent \u2014 subsequent calls reuse the same sandbox.",
       "  6. When the deploy succeeds and the preview URL is live, tell the user and end with TASK_COMPLETE.",
-      "  7. For apps with HTML frontends, use the `files` parameter to write HTML/CSS/JS to separate files and serve them with express.static, rather than embedding HTML in template literals."
+      "  7. For apps with HTML frontends, use the `files` parameter to write HTML/CSS/JS to separate files and serve them with express.static, rather than embedding HTML in template literals.",
+      "  8. If the prompt asks for a multi-route app or names concrete output paths (for example `public/v1/index.html`), mirror that structure in the `files` payload.",
+      "  9. If the prompt asks you to verify specific routes after deploy, check those paths against the preview URL before TASK_COMPLETE and iterate until they work."
     ].join("\n");
   },
   buildToolGuidance(_state) {
@@ -3092,6 +3094,7 @@ var deployPhase = {
       "Your primary tool is deploy_sandbox. Call it with code, packageJson, language, and port.",
       "Do NOT use write_file, read_file, search_repo, glob_files, tree_directory, or list_directory \u2014 you are deploying to a sandbox, not editing local files.",
       "You may use run_sandbox_code for quick one-off script execution if needed.",
+      "For static or multi-page sites, use `files` to create the requested folder structure and have the server expose those routes.",
       "When deploy_sandbox returns successfully with a previewUrl, tell the user the URL and end with TASK_COMPLETE."
     ];
   },
@@ -3141,34 +3144,7 @@ var deployPhase = {
     return void 0;
   }
 };
-function classifyVariant2(message) {
-  const lower = message.toLowerCase();
-  const deployPatterns = [
-    /\bdeploy\b/,
-    /\bsandbox\b/,
-    /\bpreview\s*url\b/,
-    /\blive\s*preview\b/,
-    /\bhost\b.*\b(?:app|server|api|site)\b/,
-    /\b(?:app|server|api|site)\b.*\bhost\b/,
-    /\brun\b.*\b(?:server|web\s*app)\b/,
-    /\blaunch\b.*\b(?:app|server|api|site)\b/,
-    /\bstart\b.*\b(?:server|web\s*app)\b/
-  ];
-  if (deployPatterns.some((p) => p.test(lower))) {
-    return "deploy";
-  }
-  const webAppPatterns = [
-    /\bbuild\b.*\b(?:web\s*app|website|api|server|express|hono|fastify)\b/,
-    /\bcreate\b.*\b(?:web\s*app|website|api|server|express|hono|fastify)\b/,
-    /\bmake\b.*\b(?:web\s*app|website|api|server|express|hono|fastify)\b/
-  ];
-  const repoPatterns = [
-    /\b(?:file|repo|repository|codebase|project|directory|folder)\b/,
-    /\b(?:edit|modify|update|fix|refactor|change)\b/
-  ];
-  if (webAppPatterns.some((p) => p.test(lower)) && !repoPatterns.some((p) => p.test(lower))) {
-    return "deploy";
-  }
+function classifyVariant2(_message) {
   return "deploy";
 }
 var deployWorkflow = {
@@ -4280,6 +4256,12 @@ function dispatchAgentEvent(event, callbacks) {
     case "agent_tool_delta":
       callbacks.onToolDelta?.(typedData);
       break;
+    case "agent_tool_input_delta":
+      callbacks.onToolInputDelta?.(typedData);
+      break;
+    case "agent_tool_input_complete":
+      callbacks.onToolInputComplete?.(typedData);
+      break;
     case "agent_tool_complete":
       callbacks.onToolComplete?.(typedData);
       break;
@@ -4663,6 +4645,15 @@ var _AgentsEndpoint = class _AgentsEndpoint {
             String(current).slice(0, 200)
           );
         }
+        const localExecutionStartedAt = (/* @__PURE__ */ new Date()).toISOString();
+        const localExecutionStartedAtMs = Date.now();
+        callbacks?.onLocalToolExecutionStart?.({
+          executionId,
+          toolCallId: toolId,
+          toolName,
+          parameters: parsedParams,
+          startedAt: localExecutionStartedAt
+        });
         let toolResult;
         try {
           toolResult = await toolDef.execute(parsedParams);
@@ -4672,20 +4663,24 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         toolMessages.push({
           role: "assistant",
           content: "",
-          toolCalls: [{
-            toolCallId: toolId,
-            toolName,
-            args: parsedParams
-          }]
+          toolCalls: [
+            {
+              toolCallId: toolId,
+              toolName,
+              args: parsedParams
+            }
+          ]
         });
         toolMessages.push({
           role: "tool",
           content: "",
-          toolResults: [{
-            toolCallId: toolId,
-            toolName,
-            result: toolResult
-          }]
+          toolResults: [
+            {
+              toolCallId: toolId,
+              toolName,
+              result: toolResult
+            }
+          ]
         });
         pauseCount += 1;
         const toolNameCount = (toolNameCounts[toolName] || 0) + 1;
@@ -4717,6 +4712,16 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           recentActionKeys
         });
         if (forcedCompleteEvent) {
+          callbacks?.onLocalToolExecutionComplete?.({
+            executionId,
+            toolCallId: toolId,
+            toolName,
+            parameters: parsedParams,
+            result: toolResult,
+            success: true,
+            completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            durationMs: Date.now() - localExecutionStartedAtMs
+          });
           if (!forcedCompleteEvent.finalOutput && accumulatedOutput) {
             forcedCompleteEvent.finalOutput = accumulatedOutput;
           }
@@ -4736,6 +4741,16 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           const error = await resumeResponse.json().catch(() => ({ error: "Unknown error" }));
           throw new Error(error.error || `HTTP ${resumeResponse.status}`);
         }
+        callbacks?.onLocalToolExecutionComplete?.({
+          executionId,
+          toolCallId: toolId,
+          toolName,
+          parameters: parsedParams,
+          result: toolResult,
+          success: true,
+          completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          durationMs: Date.now() - localExecutionStartedAtMs
+        });
         currentBody = resumeResponse.body;
         continue;
       }
@@ -4958,7 +4973,10 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     }
     const currentPhase = workflow.phases.find((p) => p.name === state.workflowPhase);
     if (currentPhase?.canAcceptCompletion) {
-      return currentPhase.canAcceptCompletion(state, sessionTrace);
+      return currentPhase.canAcceptCompletion(
+        state,
+        sessionTrace
+      );
     }
     return true;
   }
@@ -5030,7 +5048,10 @@ var _AgentsEndpoint = class _AgentsEndpoint {
   compactOneResult(tr, taskName, mode) {
     if (typeof tr.result === "string" && tr.result.startsWith("[")) return tr;
     if (mode === "hot-tail") {
-      return { ...tr, result: this.offloadToolResult(taskName, tr.toolCallId, tr.toolName, tr.result) };
+      return {
+        ...tr,
+        result: this.offloadToolResult(taskName, tr.toolCallId, tr.toolName, tr.result)
+      };
     }
     return { ...tr, result: `[Output from ${tr.toolName} masked \u2014 re-run the tool if needed]` };
   }
@@ -5129,7 +5150,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       }
     };
     const baseDir = sourcePath ? this.dirnameOfCandidatePath(sourcePath) : "";
-    for (const match of text.matchAll(/(?:href|src)=["']([^"']+\.(?:html|tsx|ts|jsx|js|md|json))["']/gi)) {
+    for (const match of text.matchAll(
+      /(?:href|src)=["']([^"']+\.(?:html|tsx|ts|jsx|js|md|json))["']/gi
+    )) {
       const target = match[1] || "";
       const resolved = baseDir ? this.joinCandidatePath(baseDir, target) : target;
       add(resolved, `linked from ${sourcePath || "discovery result"} via ${target}`);
@@ -5169,7 +5192,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     if (!bootstrapContext) return void 0;
     const candidates = this.parseSearchRepoResultForCandidates(bootstrapContext);
     if (candidates.length === 0) return void 0;
-    return candidates.sort((a, b) => this.scoreCandidatePath(b.path) - this.scoreCandidatePath(a.path))[0];
+    return candidates.sort(
+      (a, b) => this.scoreCandidatePath(b.path) - this.scoreCandidatePath(a.path)
+    )[0];
   }
   sanitizeResumeState(resumeState, taskName) {
     if (!resumeState) return void 0;
@@ -5276,10 +5301,17 @@ var _AgentsEndpoint = class _AgentsEndpoint {
               isArtifactPath: this.isMarathonArtifactPath.bind(this),
               isDiscoveryTool: this.isDiscoveryToolName.bind(this)
             };
-            const blockedMessage = currentPhase.interceptToolCall(toolName, args, ctx);
+            const blockedMessage = currentPhase.interceptToolCall(
+              toolName,
+              args,
+              ctx
+            );
             if (blockedMessage) {
               if (isWriteLikeTool) trace.attemptedWrite = true;
-              this.pushToolTraceEntry(trace, `${toolName}${pathArg}${queryArg}${patternArg} -> ${blockedMessage}`);
+              this.pushToolTraceEntry(
+                trace,
+                `${toolName}${pathArg}${queryArg}${patternArg} -> ${blockedMessage}`
+              );
               return blockedMessage;
             }
           }
@@ -5336,7 +5368,10 @@ var _AgentsEndpoint = class _AgentsEndpoint {
             verificationResult.error || verificationResult.output
           ].filter(Boolean).join(" | ").slice(0, 240) : this.summarizeTextBlockForTrace(result);
           const resultSuffix = summarizedResult ? ` -> ${summarizedResult}` : "";
-          this.pushToolTraceEntry(trace, `${toolName}${pathArg}${queryArg}${patternArg}${resultSuffix}`);
+          this.pushToolTraceEntry(
+            trace,
+            `${toolName}${pathArg}${queryArg}${patternArg}${resultSuffix}`
+          );
           const textResult = typeof result === "string" ? result : "";
           if (toolName === "read_file" && normalizedPathArg && normalizedBestCandidatePath && normalizedPathArg === normalizedBestCandidatePath && (trace.bestCandidateWritten || state.bestCandidateNeedsVerification)) {
             trace.bestCandidateVerified = true;
@@ -5427,7 +5462,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     return [
       "Session working memory:",
       ...flags.length > 0 ? [`- ${flags.join("; ")}`] : [],
-      ...trace.bestCandidatePath ? [`- best candidate: ${trace.bestCandidatePath}${trace.bestCandidateReason ? ` (${trace.bestCandidateReason})` : ""}`] : [],
+      ...trace.bestCandidatePath ? [
+        `- best candidate: ${trace.bestCandidatePath}${trace.bestCandidateReason ? ` (${trace.bestCandidateReason})` : ""}`
+      ] : [],
       ...lines
     ].join("\n").slice(0, 1200);
   }
@@ -5501,12 +5538,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       }
     };
     const lowerMessage = message.toLowerCase();
-    const phraseHints = [
-      "agent editor",
-      "theme.html",
-      "/theme.html",
-      "style it visually"
-    ];
+    const phraseHints = ["agent editor", "theme.html", "/theme.html", "style it visually"];
     for (const hint of phraseHints) {
       if (lowerMessage.includes(hint.toLowerCase())) push(hint);
     }
@@ -5533,7 +5565,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     for (const match of message.matchAll(/\b([a-z0-9]+(?:\s+[a-z0-9]+){1,2})\b/gi)) {
       const phrase = (match[1] || "").toLowerCase();
       const words = phrase.split(" ");
-      if (words.some((word) => ["editor", "page", "screen", "view", "route", "component"].includes(word))) {
+      if (words.some(
+        (word) => ["editor", "page", "screen", "view", "route", "component"].includes(word)
+      )) {
         push(match[1] || "");
       }
     }
@@ -5563,7 +5597,11 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       }
       if (globTool && /\./.test(query)) {
         try {
-          const result = await globTool.execute({ pattern: `**/${query}`, path: ".", maxResults: 5 });
+          const result = await globTool.execute({
+            pattern: `**/${query}`,
+            path: ".",
+            maxResults: 5
+          });
           const summary = this.summarizeTextBlockForTrace(result, 3);
           if (summary && !summary.startsWith("No files matched")) {
             lines.push(`glob_files "**/${query}": ${summary}`);
@@ -5664,7 +5702,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           state.isCreationTask || state.workflowVariant === "external"
         );
       }
-      const bootstrapCandidate = this.extractBestCandidateFromBootstrapContext(state.bootstrapContext);
+      const bootstrapCandidate = this.extractBestCandidateFromBootstrapContext(
+        state.bootstrapContext
+      );
       if (bootstrapCandidate) {
         state.bestCandidatePath = bootstrapCandidate.path;
         state.bestCandidateReason = bootstrapCandidate.reason;
@@ -5673,7 +5713,12 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     }
     for (let session = 0; session < maxSessions; session++) {
       const sessionTrace = this.createEmptyToolTrace();
-      const sessionLocalTools = this.wrapLocalToolsForTrace(options.localTools, sessionTrace, state, workflow);
+      const sessionLocalTools = this.wrapLocalToolsForTrace(
+        options.localTools,
+        sessionTrace,
+        state,
+        workflow
+      );
       const sessionCallbacks = this.createTraceCallbacks(options.streamCallbacks, sessionTrace);
       const continuationContext = session === 0 && options.previousMessages ? {
         previousMessages: options.previousMessages,
@@ -5704,11 +5749,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           onContextNotice: options.onContextNotice
         }
       );
-      const {
-        messages,
-        requestContextManagement,
-        pendingNativeCompactionEvent
-      } = preparedSession;
+      const { messages, requestContextManagement, pendingNativeCompactionEvent } = preparedSession;
       let sessionResult;
       const sessionData = {
         messages,
@@ -5831,7 +5872,10 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         ).slice(-20);
       }
       if (sessionTrace.actionKeys.length > 0) {
-        state.recentActionKeys = [...state.recentActionKeys || [], ...sessionTrace.actionKeys].slice(-20);
+        state.recentActionKeys = [
+          ...state.recentActionKeys || [],
+          ...sessionTrace.actionKeys
+        ].slice(-20);
       }
       if (sessionTrace.planWritten) {
         state.planWritten = true;
@@ -5860,7 +5904,11 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         const latestSession = state.sessions[state.sessions.length - 1];
         if (latestSession) {
           latestSession.outputPreview = [phaseTransitionSummary, "", latestSession.outputPreview].join("\n").slice(0, 300);
-          latestSession.toolTraceSummary = [phaseTransitionSummary, "", latestSession.toolTraceSummary || ""].join("\n").trim().slice(0, 1200);
+          latestSession.toolTraceSummary = [
+            phaseTransitionSummary,
+            "",
+            latestSession.toolTraceSummary || ""
+          ].join("\n").trim().slice(0, 1200);
         }
       }
       if (!state.messages) state.messages = [];
@@ -6097,7 +6145,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       details.builtinToolSchemas
     );
     const reservedOutputTokens = this.resolveReservedOutputTokens(details.contextLimitTokens);
-    const effectiveInputBudgetTokens = this.resolveEffectiveInputBudgetTokens(details.contextLimitTokens);
+    const effectiveInputBudgetTokens = this.resolveEffectiveInputBudgetTokens(
+      details.contextLimitTokens
+    );
     const summaryTokens = details.summaryText ? this.estimateTextTokens(
       `${_AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX}
 
@@ -6218,7 +6268,9 @@ Do NOT redo any of the above work.`
       "",
       "Changed Files / Candidate Paths",
       ...candidatePaths.length > 0 ? candidatePaths.map((candidatePath) => `- ${candidatePath}`) : ["- No candidate paths recorded yet."],
-      ...state.planPath ? [`- ${state.workflowVariant === "external" ? "Report path" : "Plan path"}: ${state.planPath}`] : [],
+      ...state.planPath ? [
+        `- ${state.workflowVariant === "external" ? "Report path" : "Plan path"}: ${state.planPath}`
+      ] : [],
       ...state.planWritten ? ["- Planning artifact has been written."] : [],
       ...state.bestCandidateReason ? [`- Best candidate rationale: ${state.bestCandidateReason}`] : [],
       "",
@@ -6239,6 +6291,79 @@ Do NOT redo any of the above work.`
       (state.lastOutput || "").slice(0, 1800) || "- No final output recorded yet."
     ].join("\n");
   }
+  isAssistantToolCallMessage(message) {
+    return Boolean(
+      message?.role === "assistant" && message.toolCalls && message.toolCalls.length > 0
+    );
+  }
+  isToolResultMessage(message) {
+    return Boolean(
+      message?.role === "tool" && message.toolResults && message.toolResults.length > 0
+    );
+  }
+  /**
+   * Replay only complete adjacent tool-call/result pairs so provider validation
+   * never sees an orphaned tool result after history trimming or resume.
+   */
+  sanitizeReplayHistoryMessages(messages) {
+    const sanitized = [];
+    for (let index = 0; index < messages.length; index++) {
+      const message = messages[index];
+      if (this.isAssistantToolCallMessage(message)) {
+        const nextMessage = messages[index + 1];
+        if (!this.isToolResultMessage(nextMessage)) {
+          continue;
+        }
+        const matchedResultIds = new Set(
+          nextMessage.toolResults.filter(
+            (toolResult) => message.toolCalls.some((toolCall) => toolCall.toolCallId === toolResult.toolCallId)
+          ).map((toolResult) => toolResult.toolCallId)
+        );
+        if (matchedResultIds.size === 0) {
+          continue;
+        }
+        const matchedToolCalls = message.toolCalls.filter(
+          (toolCall) => matchedResultIds.has(toolCall.toolCallId)
+        );
+        const matchedToolResults = nextMessage.toolResults.filter(
+          (toolResult) => matchedResultIds.has(toolResult.toolCallId)
+        );
+        sanitized.push(
+          matchedToolCalls.length === message.toolCalls.length ? message : { ...message, toolCalls: matchedToolCalls }
+        );
+        sanitized.push(
+          matchedToolResults.length === nextMessage.toolResults.length ? nextMessage : { ...nextMessage, toolResults: matchedToolResults }
+        );
+        index += 1;
+        continue;
+      }
+      if (this.isToolResultMessage(message)) {
+        continue;
+      }
+      sanitized.push(message);
+    }
+    return sanitized;
+  }
+  /**
+   * Keep replay trimming on a pair boundary. If the trim cut would start on a
+   * tool-result message, slide back to include the matching assistant tool call.
+   */
+  trimReplayHistoryMessages(messages, maxMessages) {
+    if (messages.length <= maxMessages) {
+      return {
+        historyMessages: messages,
+        trimmedCount: 0
+      };
+    }
+    let startIndex = messages.length - maxMessages;
+    while (startIndex > 0 && messages[startIndex]?.role === "tool") {
+      startIndex -= 1;
+    }
+    return {
+      historyMessages: messages.slice(startIndex),
+      trimmedCount: startIndex
+    };
+  }
   /**
    * Build messages for a session, injecting progress context for continuation sessions.
    * Optionally accepts continuation context for marathon resume scenarios.
@@ -6322,7 +6447,9 @@ Do NOT redo any of the above work.`
         "Use these tools to inspect the existing repository and make real file edits \u2014 not just code in your response."
       ],
       ...toolGuidanceLines,
-      ...isDeployWorkflow ? [] : isExternalTask2 ? ["Use write_file only if you want to save the final deliverable into the workspace."] : ["Always use write_file to save your output so the user can run it immediately."]
+      ...isDeployWorkflow ? [] : isExternalTask2 ? [
+        "Use write_file only if you want to save the final deliverable into the workspace."
+      ] : ["Always use write_file to save your output so the user can run it immediately."]
     ].join("\n") : "";
     const builtinToolNames = builtinToolIds?.map((id) => id.replace(/^builtin:/, ""));
     const builtinToolsBlock = builtinToolNames?.length ? [
@@ -6341,6 +6468,9 @@ Do NOT redo any of the above work.`
     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.`;
     if (continuationContext && sessionIndex === 0) {
+      const replayHistoryMessages = this.sanitizeReplayHistoryMessages(
+        continuationContext.previousMessages
+      );
       const defaultContinueMessage = "Continue the task. Review your prior work above and proceed with any remaining work. If everything is already complete, respond with TASK_COMPLETE.";
       const userMessage = continuationContext.newUserMessage || defaultContinueMessage;
       const userContent = [
@@ -6353,7 +6483,7 @@ Do NOT redo any of the above work.`
         multiSessionInstruction
       ].join("\n");
       const fullHistoryMessages = [
-        ...continuationContext.previousMessages,
+        ...replayHistoryMessages,
         {
           role: "system",
           content: "IMPORTANT: You are continuing a previously completed task. The conversation above shows your prior work. Do NOT redo any of it. Build on what was already accomplished. If there is nothing new to do, respond with TASK_COMPLETE."
@@ -6365,7 +6495,7 @@ Do NOT redo any of the above work.`
       ];
       const summaryText = this.generateCompactSummary(state, compactInstructions);
       const breakdown = this.buildContextBudgetBreakdown({
-        historyMessages: continuationContext.previousMessages,
+        historyMessages: replayHistoryMessages,
         currentTurnContent: userContent,
         localTools: compactionOptions?.localTools,
         builtinToolSchemas: compactionOptions?.builtinToolSchemas || [],
@@ -6428,7 +6558,15 @@ Do NOT redo any of the above work.`
       };
     }
     if (sessionIndex === 0) {
-      const content2 = [originalMessage, phaseBlock, toolsBlock, bootstrapBlock, candidateBlock, "", multiSessionInstruction].join("\n");
+      const content2 = [
+        originalMessage,
+        phaseBlock,
+        toolsBlock,
+        bootstrapBlock,
+        candidateBlock,
+        "",
+        multiSessionInstruction
+      ].join("\n");
       return {
         messages: [{ role: "user", content: content2 }],
         requestContextManagement
@@ -6455,16 +6593,19 @@ Do NOT redo any of the above work.`
         "Do not redo previous work. If the task is already complete, respond with TASK_COMPLETE."
       ].join("\n");
       const MAX_HISTORY_MESSAGES = 60;
-      let historyMessages = state.messages;
+      let historyMessages = this.sanitizeReplayHistoryMessages(state.messages);
       if (historyMessages.length > MAX_HISTORY_MESSAGES) {
-        const trimmedCount = historyMessages.length - MAX_HISTORY_MESSAGES;
-        historyMessages = [
-          {
-            role: "system",
-            content: `[${trimmedCount} earlier messages trimmed to stay within context limits. Original task: ${(state.originalMessage || originalMessage).slice(0, 500)}]`
-          },
-          ...historyMessages.slice(-MAX_HISTORY_MESSAGES)
-        ];
+        const trimmedHistory = this.trimReplayHistoryMessages(historyMessages, MAX_HISTORY_MESSAGES);
+        historyMessages = trimmedHistory.historyMessages;
+        if (trimmedHistory.trimmedCount > 0) {
+          historyMessages = [
+            {
+              role: "system",
+              content: `[${trimmedHistory.trimmedCount} earlier messages trimmed to stay within context limits. Original task: ${(state.originalMessage || originalMessage).slice(0, 500)}]`
+            },
+            ...historyMessages
+          ];
+        }
       }
       const summaryText = this.generateCompactSummary(state, compactInstructions);
       const breakdown = this.buildContextBudgetBreakdown({
@@ -6476,10 +6617,7 @@ Do NOT redo any of the above work.`
         contextLimitTokens: compactionOptions?.contextLimitTokens
       });
       await maybeEmitToolDefinitionWarning(breakdown);
-      const messages = [
-        ...historyMessages,
-        { role: "user", content: continuationContent }
-      ];
+      const messages = [...historyMessages, { role: "user", content: continuationContent }];
       if (resolvedStrategy === "summary_fallback" && typeof compactionOptions?.autoCompactTokenThreshold === "number" && compactionOptions.autoCompactTokenThreshold > 0 && breakdown.estimatedInputTokens >= compactionOptions.autoCompactTokenThreshold) {
         return {
           messages: await this.buildCompactHistoryMessagesWithLifecycle(
@@ -6726,6 +6864,42 @@ var FlowBuilder = class {
     );
     return this;
   }
+  /**
+   * Add a crawl step
+   */
+  crawl(config) {
+    this.addStep(
+      "crawl",
+      config.name,
+      {
+        url: config.url,
+        limit: config.limit,
+        depth: config.depth,
+        source: config.source,
+        formats: config.formats,
+        render: config.render,
+        maxAge: config.maxAge,
+        modifiedSince: config.modifiedSince,
+        options: config.options,
+        authenticate: config.authenticate,
+        cookies: config.cookies,
+        setExtraHTTPHeaders: config.setExtraHTTPHeaders,
+        gotoOptions: config.gotoOptions,
+        waitForSelector: config.waitForSelector,
+        rejectResourceTypes: config.rejectResourceTypes,
+        rejectRequestPattern: config.rejectRequestPattern,
+        userAgent: config.userAgent,
+        jsonOptions: config.jsonOptions,
+        outputVariable: config.outputVariable,
+        errorHandling: config.errorHandling,
+        streamOutput: config.streamOutput,
+        pollIntervalMs: config.pollIntervalMs,
+        completionTimeoutMs: config.completionTimeoutMs
+      },
+      config.enabled
+    );
+    return this;
+  }
   /**
    * Add a fetch URL step
    */
@@ -7068,7 +7242,7 @@ var ClientFlowBuilder = class extends FlowBuilder {
     this.boundClient = client;
     this.createFlow({ name });
   }
-  async run(arg1, arg2, arg3, arg4) {
+  async run(arg1, arg2, arg3, _arg4) {
     const config = this.build();
     let runOptions;
     let runCallbacks;