@runtypelabs/sdk 1.8.2 → 1.9.0

package/dist/index.d.cts

@@ -871,6 +871,33 @@ interface FetchUrlStepConfig$1 {
     streamOutput?: boolean;
     enabled?: boolean;
 }
+interface CrawlStepConfig {
+    name: string;
+    url: string;
+    limit?: number;
+    depth?: number;
+    source?: string;
+    formats?: string[];
+    render?: boolean;
+    maxAge?: number;
+    modifiedSince?: string;
+    options?: Record<string, unknown>;
+    authenticate?: Record<string, unknown>;
+    cookies?: Array<Record<string, unknown>>;
+    setExtraHTTPHeaders?: Record<string, string>;
+    gotoOptions?: Record<string, unknown>;
+    waitForSelector?: string;
+    rejectResourceTypes?: string[];
+    rejectRequestPattern?: string | string[];
+    userAgent?: string;
+    jsonOptions?: Record<string, unknown>;
+    outputVariable?: string;
+    streamOutput?: boolean;
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    pollIntervalMs?: number;
+    completionTimeoutMs?: number;
+    enabled?: boolean;
+}
 interface TransformDataStepConfig$1 {
     name: string;
     script: string;
@@ -1297,6 +1324,10 @@ declare class FlowBuilder {
      * Add a prompt step
      */
     prompt(config: PromptStepConfig$1): this;
+    /**
+     * Add a crawl step
+     */
+    crawl(config: CrawlStepConfig): this;
     /**
      * Add a fetch URL step
      */
@@ -4686,6 +4717,18 @@ declare class AgentsEndpoint {
      * Used when compact mode is enabled to keep token usage low.
      */
     private generateCompactSummary;
+    private isAssistantToolCallMessage;
+    private isToolResultMessage;
+    /**
+     * Replay only complete adjacent tool-call/result pairs so provider validation
+     * never sees an orphaned tool result after history trimming or resume.
+     */
+    private sanitizeReplayHistoryMessages;
+    /**
+     * 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.
+     */
+    private trimReplayHistoryMessages;
     /**
      * Build messages for a session, injecting progress context for continuation sessions.
      * Optionally accepts continuation context for marathon resume scenarios.

package/dist/index.d.ts

@@ -871,6 +871,33 @@ interface FetchUrlStepConfig$1 {
     streamOutput?: boolean;
     enabled?: boolean;
 }
+interface CrawlStepConfig {
+    name: string;
+    url: string;
+    limit?: number;
+    depth?: number;
+    source?: string;
+    formats?: string[];
+    render?: boolean;
+    maxAge?: number;
+    modifiedSince?: string;
+    options?: Record<string, unknown>;
+    authenticate?: Record<string, unknown>;
+    cookies?: Array<Record<string, unknown>>;
+    setExtraHTTPHeaders?: Record<string, string>;
+    gotoOptions?: Record<string, unknown>;
+    waitForSelector?: string;
+    rejectResourceTypes?: string[];
+    rejectRequestPattern?: string | string[];
+    userAgent?: string;
+    jsonOptions?: Record<string, unknown>;
+    outputVariable?: string;
+    streamOutput?: boolean;
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    pollIntervalMs?: number;
+    completionTimeoutMs?: number;
+    enabled?: boolean;
+}
 interface TransformDataStepConfig$1 {
     name: string;
     script: string;
@@ -1297,6 +1324,10 @@ declare class FlowBuilder {
      * Add a prompt step
      */
     prompt(config: PromptStepConfig$1): this;
+    /**
+     * Add a crawl step
+     */
+    crawl(config: CrawlStepConfig): this;
     /**
      * Add a fetch URL step
      */
@@ -4686,6 +4717,18 @@ declare class AgentsEndpoint {
      * Used when compact mode is enabled to keep token usage low.
      */
     private generateCompactSummary;
+    private isAssistantToolCallMessage;
+    private isToolResultMessage;
+    /**
+     * Replay only complete adjacent tool-call/result pairs so provider validation
+     * never sees an orphaned tool result after history trimming or resume.
+     */
+    private sanitizeReplayHistoryMessages;
+    /**
+     * 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.
+     */
+    private trimReplayHistoryMessages;
     /**
      * Build messages for a session, injecting progress context for continuation sessions.
      * Optionally accepts continuation context for marathon resume scenarios.

package/dist/index.js

@@ -6169,6 +6169,75 @@ 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.
@@ -6271,6 +6340,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 = [
@@ -6283,7 +6355,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."
@@ -6295,7 +6367,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 || [],
@@ -6385,16 +6457,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({
@@ -6656,6 +6731,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
    */
@@ -6998,7 +7109,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;