@springbrand/agent-runtime 0.2.0-alpha.15 → 0.2.0-alpha.17

package/src/tool-registry.ts

@@ -8,6 +8,7 @@ import type {
 import type { RuntimeExtensionConfig } from "./kernel/extensions";
 import type { RuntimeDegradation } from "./kernel/degradation";
 import type { PiToolCandidate } from "./pi/tool/compiler";
+import { validateToolArguments } from "@earendil-works/pi-ai";
 
 /** Tool Surface 筛选策略（不含 Manifest deny 列表）。 */
 export interface ToolSurfaceSelectionPolicy {
@@ -22,7 +23,9 @@ export interface ToolContext {
 }
 
 /** Definition 作者声明的一个 Tool。 */
-export interface ToolSpec {
+export interface ToolSpec extends Partial<
+  Omit<PiToolCandidate, "tool" | "requiredExecutionLevel">
+> {
   readonly label: string;
   readonly description: string;
   readonly parameters: unknown;
@@ -80,23 +83,27 @@ export function toolRegistryFromPiCandidates(
 }
 
 export function piCandidateToToolSpec(candidate: PiToolCandidate): ToolSpec {
-  const name = candidate.tool.name;
+  const { tool, ...metadata } = candidate;
+  const name = tool.name;
   return {
-    label: candidate.tool.label ?? name,
-    description: candidate.tool.description,
-    parameters: candidate.tool.parameters,
-    requiredExecutionLevel: candidate.requiredExecutionLevel,
-    ...(candidate.alwaysRequiresApproval
-      ? { alwaysRequiresApproval: true }
-      : {}),
+    ...metadata,
+    label: tool.label ?? name,
+    description: tool.description,
+    parameters: tool.parameters,
     execute: async (input, ctx) => {
-      const execute = candidate.tool.execute;
+      const execute = tool.execute;
       if (typeof execute !== "function") {
         throw new Error(`Tool "${name}" is not executable`);
       }
+      const validated = validateToolArguments(tool, {
+        type: "toolCall",
+        id: ctx.toolCallId,
+        name,
+        arguments: input as Record<string, unknown>,
+      });
       const result = await execute(
         ctx.toolCallId,
-        input,
+        validated,
         ctx.signal,
         undefined,
       );

package/src/lib/telemetry-dev.ts

@@ -1,47 +0,0 @@
-/**
- * 观测降级:把 observability 事件打到 console,让 `wrangler dev` / `wrangler tail` 里能实时看到埋点,
- * 并且(生产上开了 `observability.logs` 时)进 Workers Logs 供事后查询。
- * 不装它,事件就 publish 到零订阅 channel = 静默 no-op。
- *
- * 由 onStart 在 env `TELEMETRY_CONSOLE==="1"` 时装载 —— `.dev.vars` 和 `wrangler.jsonc` 的 vars 里都开着。
- * 注意:上游注释宣称"生产上所有 channel 事件自动转发 Tail Worker",那条路径需要 `tail_consumers`,
- * 本仓没有配,所以生产**不能**指望它;这个 console sink 就是生产的唯一消费面(2026-08-06 实测:
- * 未开启前 Observability API 查 universal-agent 24h 事件 count=0)。
- *
- * 用 `agents/observability` 的类型化 `subscribe`(按 channel key 订阅),避免引 `node:diagnostics_channel`
- * 与 `@types/node`(tsconfig 只带 workers-types)。
- */
-import { subscribe } from "agents/observability";
-
-// Covers chat events, Runtime lifecycle events and tool messages.
-const CHANNEL_KEYS = ["chat", "lifecycle", "message", "schedule", "mcp"] as const;
-
-// Module state is isolate-wide, so multiple DO instances share one subscription.
-let installed = false;
-
-/**
- * 在当前 Worker isolate 中安装一次把观测事件打到 console 的订阅。
- *
- * @remarks
- * Runtime `onStart` 只在 `telemetryConsole` 开启时调用，用于 `wrangler dev` 和日志调试。
- *
- * `installed` 是 isolate 级模块状态，因此多个 Durable Object 实例共享一组订阅；不做幂等检查会让每个事件重复输出。
- *
- * 使用 `agents/observability` 的 channel 订阅而不是 Node.js `diagnostics_channel`，保持当前 Workers TypeScript 环境不需要 Node 类型。
- *
- * Runtime 的术语见 `src/index.ts`。
- */
-export function installConsoleSink(): void {
-  if (installed) return;
-  installed = true;
-  for (const key of CHANNEL_KEYS) {
-    subscribe(key, (event) => {
-      const e = event as { type?: string; payload?: unknown };
-      try {
-        console.log(`[obs] ${e.type}`, JSON.stringify(e.payload ?? {}));
-      } catch {
-        console.log(`[obs] ${e?.type} (payload 不可序列化)`);
-      }
-    });
-  }
-}