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

package/src/runtime-assembler.ts

@@ -61,6 +61,10 @@ import { skillPiToolCandidates } from "./pi/tool/skill";
 import { createWebSearch } from "./pi/tool/web-search";
 import { subagentPiToolCandidates } from "./pi/tool/subagent";
 import { resolvePiModel } from "./pi/runtime-adapter/models";
+import {
+  normalizeAgentTelemetryBinding,
+  type AgentTelemetryBinding,
+} from "./telemetry/contract";
 
 /** Runtime Assembler：校验一份扁平输入并生成可原子提交的 Snapshot。 */
 
@@ -92,6 +96,7 @@ export interface RuntimeAssemblyInput {
   readonly subagents?: RuntimeSubagentPort;
   readonly schedule?: RuntimeSchedulePort;
   readonly turnEvents?: RuntimeTurnEventsPort;
+  readonly telemetry?: AgentTelemetryBinding;
   readonly commitGuards: readonly (() => Promise<void>)[];
   readonly degradations: readonly RuntimeDegradation[];
 }
@@ -120,6 +125,7 @@ export interface RuntimeCandidate {
   readonly commitGuards: readonly (() => Promise<void>)[];
   readonly hooks?: RuntimeAgentHooks<Cloudflare.Env, unknown, never, never>;
   readonly turnEvents?: RuntimeTurnEventsPort;
+  readonly telemetry?: AgentTelemetryBinding;
 }
 
 const DISABLED_MEMORY: RuntimeMemoryProfile = Object.freeze({
@@ -244,21 +250,21 @@ async function createToolSurface(
         }
         const mergeable = finalized.filter(
           (candidate) =>
+            !candidate.direct &&
             !candidate.interaction &&
             typeof candidate.tool.execute === "function",
         );
-        const direct = finalized.filter(
-          (candidate) =>
-            candidate.interaction ||
-            typeof candidate.tool.execute !== "function",
-        );
+        const codeExecutionTools = Object.freeze([...mergeable]);
         return Object.freeze([
-          Object.freeze(codeExecutionPiToolCandidate(
-            input.codeExecution.create(
-              toolRegistryFromPiCandidates(mergeable),
+          Object.freeze({
+            ...codeExecutionPiToolCandidate(
+              input.codeExecution.create(
+                toolRegistryFromPiCandidates(codeExecutionTools),
+              ),
             ),
-          )),
-          ...direct,
+            codeExecutionTools,
+          }),
+          ...finalized,
         ]);
       },
     }),
@@ -300,6 +306,7 @@ class RuntimeBuilder {
   private readonly enabledSubagents = new Set<string>();
   private subagents?: RuntimeSubagentPort;
   private turnEvents?: RuntimeTurnEventsPort;
+  private telemetry?: AgentTelemetryBinding;
   private readonly commitGuards: Array<() => Promise<void>> = [];
   private readonly degradations: RuntimeDegradation[] = [];
 
@@ -332,6 +339,9 @@ class RuntimeBuilder {
     }
     this.subagents = input.subagents;
     this.turnEvents = input.turnEvents;
+    this.telemetry = input.telemetry
+      ? normalizeAgentTelemetryBinding(input.telemetry)
+      : undefined;
     this.commitGuards.push(...input.commitGuards);
   }
 
@@ -528,6 +538,7 @@ class RuntimeBuilder {
     const bindings: RuntimeBindings = Object.freeze({
       provider,
       platform: Object.freeze({ ...this.platform }),
+      ...(this.codeExecution ? { codeExecution: this.codeExecution } : {}),
       ...(this.gateway ? { gateway: this.gateway } : {}),
       ...(this.workspace ? { workspace: this.workspace } : {}),
       ...(this.memoryProfile.enabled && this.memory
@@ -559,6 +570,7 @@ class RuntimeBuilder {
       commitGuards: Object.freeze([
         ...this.commitGuards,
       ]),
+      ...(this.telemetry ? { telemetry: this.telemetry } : {}),
     });
   }
 
@@ -616,23 +628,28 @@ export function toolRegistryPiToolCandidates(
     if (deny.has(name)) continue;
     if (allowsTool?.(name) === false) continue;
     const normalized = requiredName(name, "Platform Tool");
+    const {
+      label,
+      description,
+      parameters,
+      execute,
+      owner = "platform",
+      ...metadata
+    } = spec;
     candidates.push(Object.freeze({
-      owner: "platform",
-      requiredExecutionLevel: spec.requiredExecutionLevel,
-      ...(spec.alwaysRequiresApproval
-        ? { alwaysRequiresApproval: true }
-        : {}),
+      ...metadata,
+      owner,
       tool: Object.freeze({
         name: normalized,
-        label: spec.label,
-        description: spec.description,
-        parameters: spec.parameters,
+        label,
+        description,
+        parameters,
         async execute(
           toolCallId: string,
           input: unknown,
           signal?: AbortSignal,
         ) {
-          const result = await spec.execute(input, {
+          const result = await execute(input, {
             toolCallId,
             signal: signal ?? new AbortController().signal,
           });
@@ -817,6 +834,7 @@ export async function assembleRuntimeSnapshot<
       : {}),
     extensions: resources.extensions,
     ...(turnEvents ? { turnEvents } : {}),
+    ...(input.telemetry ? { telemetry: input.telemetry } : {}),
     commitGuards: [],
     degradations: [
       ...(toolAssembly.degradations ?? []),
@@ -843,6 +861,7 @@ export async function assembleRuntimeSnapshot<
         }
       : {}),
     ...(turnEvents ? { turnEvents } : {}),
+    ...(candidate.telemetry ? { telemetry: candidate.telemetry } : {}),
   });
 }
 

package/src/runtime-definition.ts

@@ -27,6 +27,7 @@ import type {
   RuntimeAssemblyContext,
   RuntimeAgentPlanningContext,
 } from "./runtime-agent-context";
+import type { AgentTelemetryBinding } from "./telemetry/contract";
 
 export interface RuntimeProfileContribution {
   readonly model: string;
@@ -184,4 +185,5 @@ export interface AssembleRuntimeSnapshotInput<
   readonly tools: import("./tool-registry").ToolAssemblyResult;
   readonly resources: ResolvedResources;
   readonly hooks?: RuntimeAgentHooks<Env, Config, Command, Change>;
+  readonly telemetry?: AgentTelemetryBinding;
 }