@springbrand/agent-runtime 0.1.3-alpha.7 → 0.2.0-alpha.13

package/src/tool-registry.ts

@@ -1,6 +1,7 @@
 import type { ExecutionLevel } from "./lib/execution-level";
 import type {
   RuntimeMemoryPort,
+  RuntimeSubagentPort,
   WorkspacePort,
 } from "./kernel/bindings";
 import type { RuntimeExtensionConfig } from "./kernel/extensions";
@@ -102,6 +103,7 @@ export function piCandidateToToolSpec(candidate: PiToolCandidate): ToolSpec {
 export interface RuntimeToolBindings {
   readonly workspace?: WorkspacePort;
   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");
+  }
+}