@springbrand/agent-runtime 0.1.3-alpha.0 → 0.1.3-alpha.1

package/src/pi/tool/core.ts

@@ -3,7 +3,6 @@ import type {
   AgentToolResult,
 } from "@earendil-works/pi-agent-core";
 import { Type } from "@earendil-works/pi-ai";
-import type { CodemodeRuntimeHandle } from "@cloudflare/codemode";
 import {
   browserExtract,
   browserLinks,
@@ -11,7 +10,10 @@ import {
   browserScrape,
   type QuickActionPage,
 } from "agents/browser";
-import type { RuntimeBrowserPort } from "../../kernel/bindings";
+import type {
+  RuntimeBrowserPort,
+  RuntimeCodeExecutionPort,
+} from "../../kernel/bindings";
 import { serializeOutput } from "../../lib/artifacts";
 import type { PiLoadedExtension } from "../assembly/extensions";
 import type { PiToolCandidate } from "./compiler";
@@ -210,12 +212,13 @@ const CODEMODE_EXECUTE_TIMEOUT_MS = 60_000;
 /**
  * 把 Cloudflare Codemode Runtime handle 包装为高风险 Pi 代码执行工具候选项。
  *
- * Worker 宿主用 `workspaceCodeExecutionPiToolCandidate()` 组装好持久化 Codemode Runtime 后调用，模型再通过 `execute` 运行代码。
+ * Tool Surface 收到 Host 已组装的 Code Execution Port 后调用，
+ * 模型再通过 `execute` 运行代码。
  *
  * Codemode 代码可访问出站网络和已配置 connector，因此必须保留 high 档和 codemode source 标记，不能降级成普通本地计算工具。
  */
 export function codeExecutionPiToolCandidate(
-  runtime: Pick<CodemodeRuntimeHandle, "execute">,
+  runtime: RuntimeCodeExecutionPort,
 ): PiToolCandidate {
   const tool: AgentTool<typeof executeParameters> = {
     name: "execute",

package/src/pi/tool/mcp.ts

@@ -12,7 +12,7 @@ interface McpCallResult {
 /**
  * Pi 的 MCP 适配器所需的最小 Host 能力。
  *
- * `PreparedAssembly` 在收集本轮工具时传入真正的 Agent Host；其他调用方只应
+ * Tool Surface 在收集本轮工具时传入真正的 Agent Host；其他调用方只应
  * 提供同样的服务器状态快照、工具目录和调用能力，不要在这里复制连接状态。
  *
  * 这里沿用 MCP 的官方术语：Host 是承载 Agent 的应用，Client 是 Host 内连接
@@ -203,7 +203,7 @@ function errorMessage(result: McpCallResult): string {
 /**
  * 把当前已连接且获授权的 MCP 工具转换成 Pi 候选工具。
  *
- * `PreparedAssembly.toolCandidates()` 在每次收集本轮工具时调用它。调用方应传入
+ * Tool Surface 在 Runtime 准备时调用它。调用方应传入
  * Agent Host，以及同一 Runtime 快照中的 MCP 配置；未就绪、未配置或重复 URL
  * 的连接不会进入模型工具目录。
  *

package/src/pi/tool/schedule.ts

@@ -71,6 +71,14 @@ const updateScheduleParameters = Type.Object({
   label: Type.Optional(Type.String()),
   timezone: Type.Optional(Type.String()),
 });
+const changeScheduleAgentParameters = Type.Object({
+  id: Type.String({
+    description: "The exact schedule id returned by `list_schedules`.",
+  }),
+  userAgentId: Type.String({
+    description: "The exact User Agent id selected by the user.",
+  }),
+});
 
 function result<T>(details: T): AgentToolResult<T> {
   return {
@@ -82,11 +90,11 @@ function result<T>(details: T): AgentToolResult<T> {
 function candidate<T extends TSchema>(
   tool: AgentTool<T>,
   options: Partial<
-    Pick<PiToolCandidate, "requiredExecutionLevel" | "summary">
+    Pick<PiToolCandidate, "owner" | "requiredExecutionLevel" | "summary">
   > = {},
 ): PiToolCandidate {
   return {
-    owner: "runtime-base",
+    owner: options.owner ?? "runtime-base",
     authorized: true,
     requiredExecutionLevel: options.requiredExecutionLevel ?? "safe",
     source: "action",
@@ -194,5 +202,41 @@ export function schedulePiToolCandidates(
         summary: "Cancel a scheduled task",
       },
     ),
+    candidate(
+      {
+        name: "list_user_agents",
+        label: "List User Agents",
+        description:
+          "List the enabled User Agents available for scheduled tasks. " +
+          "Use this before changing a schedule Agent.",
+        parameters: noParameters,
+        async execute(_toolCallId, _input, signal) {
+          signal?.throwIfAborted();
+          return result({ agents: await schedule.listAgents() });
+        },
+      },
+      { owner: "schedule-host" },
+    ),
+    candidate(
+      {
+        name: "change_schedule_agent",
+        label: "Change schedule Agent",
+        description:
+          "Change which User Agent executes one scheduled task without " +
+          "changing its id or history. Call `list_schedules` and " +
+          "`list_user_agents` first and use exact ids; ask the user when " +
+          "the target is ambiguous.",
+        parameters: changeScheduleAgentParameters,
+        async execute(_toolCallId, input, signal) {
+          signal?.throwIfAborted();
+          const { ok } = await schedule.changeAgent(
+            input.id,
+            input.userAgentId,
+          );
+          return result({ updated: ok, id: input.id });
+        },
+      },
+      { owner: "schedule-host" },
+    ),
   ];
 }

package/src/pi/tool/skill.ts

@@ -242,7 +242,7 @@ function resourceResult(
 /**
  * 为已启用的 Skill 创建按需加载说明、资源和可选脚本的 Pi 候选工具。
  *
- * Worker 的 Skill Plugin 在贡献 Runtime 能力时调用它。调用方只传入已授权绑定；
+ * Worker 的 Skill Plugin 在准备 Runtime 能力时调用它。调用方只传入已授权绑定；
  * 没有绑定时不公开工具，没有 Worker Loader 或脚本策略时不公开脚本执行工具。
  *
  * 这里的 “Skill” 是按需加载的任务说明包，“Source” 负责列出和读取包，“资源”