@springbrand/agent-runtime 0.1.3-alpha.10 → 0.1.3-alpha.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/agent-runtime",
-  "version": "0.1.3-alpha.10",
+  "version": "0.1.3-alpha.12",
   "type": "module",
   "files": [
     "src",

package/src/kernel/bindings.ts

@@ -194,6 +194,7 @@ export interface WorkspacePort {
  * Workspace；Tool Surface 只把这个已授权 Port 转成 `execute` Tool。
  */
 export interface RuntimeCodeExecutionPort {
+  readonly description: string;
   execute(input: { code: string }): Promise<unknown>;
 }
 

package/src/lib/prompt.ts

@@ -63,6 +63,9 @@ export const TOOLS =
   "raw or customized network cases described above; every response and failure it sees is visible to you. " +
   "bash is a shell over the workspace filesystem only " +
   "(no network, no system utilities) and is approval-gated — don't reach for it to read files or fetch. " +
+  "For more than three related changes in one file, use one write or bash operation instead of serial edits; " +
+  "do not re-plan or explain between consecutive tool calls. When a run is within the last five model turns, stop expanding scope and " +
+  "prioritize verification, saving durable results, and the final response. " +
   "When tool calls are independent, issue them in one turn so they run in parallel. When you reference " +
   "code, cite it as file_path:line_number.";
 

package/src/pi/tool/core-host.ts

@@ -36,11 +36,15 @@ export function createWorkspaceCodeExecutionPort(options: {
     ),
     name: "execute",
   });
-  const execute = tool.execute;
+  const { description, execute } = tool;
+  if (typeof description !== "string" || description.length === 0) {
+    throw new Error("Think createExecuteRuntime returned a tool without a description");
+  }
   if (typeof execute !== "function") {
     throw new Error("Think createExecuteRuntime returned a non-executable tool");
   }
   return {
+    description,
     execute: (input) => Promise.resolve(execute(input, {
       toolCallId: "execute",
       messages: [],

package/src/pi/tool/core.ts

@@ -125,16 +125,7 @@ export function codeExecutionPiToolCandidate(
   const tool: AgentTool<typeof executeParameters> = {
     name: "execute",
     label: "Execute JavaScript",
-    description:
-      "Run JavaScript in a short-lived Code Mode Dynamic Worker and return a value. This is your " +
-      "raw-network and tool-composition instrument, not a general web-search tool. Call fetch directly " +
-      "when you need a raw response, custom headers/method/body, a structured API, or content that " +
-      "web_search could not retrieve. Check res.status; when several known endpoints are necessary, " +
-      "fetch them in one invocation. Also available: " +
-      "state.* for your workspace filesystem (readFile/writeFile/glob/searchFiles/replaceInFiles, " +
-      "each taking one object argument), and codemode.step(name, fn) to run a side-effecting block " +
-      "exactly once so it survives replay. Write plain JavaScript — TypeScript type annotations are " +
-      "a syntax error. Use return for the result and console.log for notes.",
+    description: runtime.description,
     parameters: executeParameters,
     // 把模型提供的 JavaScript 交给 Codemode Runtime 执行。
     // Pi 工具循环在模型选择 `execute` 时调用，调用前允许 Turn 取消。