@springbrand/agent-runtime 0.2.0-alpha.34 → 0.2.0-alpha.38

package/src/tool-registry.ts

@@ -1,142 +0,0 @@
-import type {
-  RuntimeCodeExecutionFactory,
-  RuntimeMemoryPort,
-  RuntimeSubagentPort,
-  WorkspacePort,
-} from "./kernel/bindings";
-import type { RuntimeExtensionConfig } from "./kernel/extensions";
-import type { RuntimeDegradation } from "./kernel/degradation";
-import type {
-  ToolContext,
-  ToolRegistry,
-  ToolSpec,
-} from "./kernel/tool-surface";
-import type { PiToolCandidate } from "./pi/tool/compiler";
-import { validateToolArguments } from "@earendil-works/pi-ai";
-
-// Tool Surface 的形状类型住在 `kernel/tool-surface.ts`：bindings 也要用它们，放在这里
-// 会让 `bindings → tool-registry → bindings` 成环。这里继续导出是为了保持调用方不变。
-export type {
-  RuntimeCodeExecutionFactory,
-  ToolContext,
-  ToolRegistry,
-  ToolSpec,
-};
-
-/** Tool Surface 筛选策略（不含 Manifest deny 列表）。 */
-export interface ToolSurfaceSelectionPolicy {
-  readonly allowsTool?: (name: string) => boolean;
-  readonly allowsExtension?: (extension: RuntimeExtensionConfig) => boolean;
-  readonly defersTool?: (name: string) => boolean;
-}
-
-export function emptyToolRegistry(): ToolRegistry {
-  return {};
-}
-
-export function mergeToolRegistries(...registries: ToolRegistry[]): ToolRegistry {
-  const merged: ToolRegistry = {};
-  for (const registry of registries) {
-    for (const [name, spec] of Object.entries(registry)) {
-      if (name in merged) {
-        throw new Error(`Duplicate Runtime Tool: ${name}`);
-      }
-      merged[name] = spec;
-    }
-  }
-  return merged;
-}
-
-export function toolRegistryFromPiCandidates(
-  candidates:
-    | readonly PiToolCandidate[]
-    | Record<string, PiToolCandidate>,
-): ToolRegistry {
-  const list = Array.isArray(candidates)
-    ? candidates
-    : Object.values(candidates);
-  const registry: ToolRegistry = {};
-  for (const candidate of list) {
-    const name = candidate.tool.name;
-    if (!name.trim()) {
-      throw new Error("SpringBrand Tool name must not be empty");
-    }
-    registry[name] = piCandidateToToolSpec(candidate);
-  }
-  return registry;
-}
-
-export function piCandidateToToolSpec(candidate: PiToolCandidate): ToolSpec {
-  const { tool, ...metadata } = candidate;
-  const name = tool.name;
-  return {
-    ...metadata,
-    label: tool.label ?? name,
-    description: tool.description,
-    parameters: tool.parameters,
-    execute: async (input, ctx) => {
-      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>,
-      });
-      return execute(
-        ctx.toolCallId,
-        validated,
-        ctx.signal,
-        undefined,
-      );
-    },
-  };
-}
-
-/** Kernel 绑定仍需要的执行后端；不出现在 Definition 公开类型里。 */
-export interface RuntimeToolBindings {
-  readonly workspace?: WorkspacePort;
-  readonly codeExecution?: RuntimeCodeExecutionFactory;
-  readonly memory?: RuntimeMemoryPort;
-  readonly subagents?: RuntimeSubagentPort;
-}
-
-/**
- * Worker `tools()` 可返回纯注册表，或附带 Kernel 绑定与降级信息。
- */
-export interface ToolAssemblyResult {
-  readonly tools: ToolRegistry;
-  readonly bindings?: RuntimeToolBindings;
-  readonly memoryProfile?: import("./kernel/profile").RuntimeMemoryProfile;
-  readonly enabledSubagents?: readonly string[];
-  readonly degradations?: readonly RuntimeDegradation[];
-  readonly surfacePolicy?: ToolSurfaceSelectionPolicy;
-  readonly commitGuard?: () => Promise<void>;
-  /** 释放本次装配创建的外部资源；临时 Agent 终止后由 Runtime 调用。 */
-  readonly dispose?: () => Promise<void>;
-}
-
-export function normalizeToolAssembly(
-  input: ToolRegistry | ToolAssemblyResult,
-): ToolAssemblyResult {
-  if ("tools" in input && typeof input.tools === "object" && input.tools !== null) {
-    return input as ToolAssemblyResult;
-  }
-  return { tools: input as ToolRegistry };
-}
-
-/** @deprecated 使用 `ToolSpec`。 */
-export type PlatformToolSpec = ToolSpec;
-
-/** @deprecated 使用 `ToolContext`。 */
-export type PlatformToolContext = ToolContext;
-
-/** @deprecated 使用 `ToolRegistry`。 */
-export type PlatformToolRegistry = ToolRegistry;
-
-/** @deprecated 使用 `emptyToolRegistry`。 */
-export function emptyPlatformToolRegistry(): ToolRegistry {
-  return emptyToolRegistry();
-}