@springbrand/agent-runtime 0.1.3-alpha.8 → 0.2.0-alpha.14

package/src/tool-registry.ts

@@ -1,6 +1,8 @@
 import type { ExecutionLevel } from "./lib/execution-level";
 import type {
+  RuntimeCodeExecutionPort,
   RuntimeMemoryPort,
+  RuntimeSubagentPort,
   WorkspacePort,
 } from "./kernel/bindings";
 import type { RuntimeExtensionConfig } from "./kernel/extensions";
@@ -36,6 +38,11 @@ export interface ToolSpec {
 /** 一次装配声明的全部 Tool，键即模型可见的工具名。 */
 export type ToolRegistry = Record<string, ToolSpec>;
 
+/** 延迟到最终 Tool Surface 完成后再创建 Code Mode 执行能力。 */
+export interface RuntimeCodeExecutionFactory {
+  create(tools: ToolRegistry): RuntimeCodeExecutionPort;
+}
+
 export function emptyToolRegistry(): ToolRegistry {
   return {};
 }
@@ -65,7 +72,7 @@ export function toolRegistryFromPiCandidates(
   for (const candidate of list) {
     const name = candidate.tool.name;
     if (!name.trim()) {
-      throw new Error("Pi Tool name must not be empty");
+      throw new Error("SpringBrand Tool name must not be empty");
     }
     registry[name] = piCandidateToToolSpec(candidate);
   }
@@ -101,7 +108,9 @@ export function piCandidateToToolSpec(candidate: PiToolCandidate): ToolSpec {
 /** Kernel 绑定仍需要的执行后端；不出现在 Definition 公开类型里。 */
 export interface RuntimeToolBindings {
   readonly workspace?: WorkspacePort;
+  readonly codeExecution?: RuntimeCodeExecutionFactory;
   readonly memory?: RuntimeMemoryPort;
+  readonly subagents?: RuntimeSubagentPort;
 }
 
 /**

package/src/workspace-versioning.ts

@@ -0,0 +1,46 @@
+export type WorkspaceRevision = {
+  revision: string;
+  treeHash: string;
+  reason: string;
+  createdAt: number;
+};
+
+export type WorkspaceRevisionManifest = {
+  revision: string;
+  treeHash: string;
+  files: readonly {
+    path: string;
+    size: number;
+  }[];
+};
+
+export interface WorkspaceVersionPort {
+  current(): Promise<WorkspaceRevision | null>;
+  checkpoint(input: { reason: string }): Promise<{
+    revision: string | null;
+    treeHash: string | null;
+    changed: boolean;
+  }>;
+  list(input?: { limit?: number }): Promise<readonly WorkspaceRevision[]>;
+  manifest(revision: string): Promise<WorkspaceRevisionManifest>;
+  readFile(revision: string, path: string): Promise<Uint8Array>;
+  restore(input: { revision: string; reason: string }): Promise<{
+    revision: string;
+    treeHash: string;
+  }>;
+}
+
+/** Host-scoped restore action exposed to the Agent Runtime. */
+export interface WorkspaceRevisionRestorePort {
+  restore(target: string): Promise<{
+    restoredFrom: string;
+    revision: string;
+    treeHash: string;
+  }>;
+}
+
+export class WorkspaceRevisionNotFoundError extends Error {
+  constructor() {
+    super("workspace_revision_not_found");
+  }
+}