@runtypelabs/sdk 1.9.0 → 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}`] : [],
       "",
@@ -6240,10 +6292,14 @@ Do NOT redo any of the above work.`
     ].join("\n");
   }
   isAssistantToolCallMessage(message) {
-    return Boolean(message?.role === "assistant" && message.toolCalls && message.toolCalls.length > 0);
+    return Boolean(
+      message?.role === "assistant" && message.toolCalls && message.toolCalls.length > 0
+    );
   }
   isToolResultMessage(message) {
-    return Boolean(message?.role === "tool" && message.toolResults && message.toolResults.length > 0);
+    return Boolean(
+      message?.role === "tool" && message.toolResults && message.toolResults.length > 0
+    );
   }
   /**
    * Replay only complete adjacent tool-call/result pairs so provider validation
@@ -6391,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 ? [
@@ -6500,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
@@ -6551,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(