@xioflow/kernel 0.2.0 → 0.4.0

package/dist/supervisor/supervisor.d.ts

@@ -1,12 +1,16 @@
 import { ExecutionDomain } from '../domain.js';
 import { PlatformDriver, StructuredCommand, StopProcessResult } from '../driver/types.js';
-import { ProcessOperationResult, TerminationReason, ResourceBudget } from '../types.js';
+import { ProcessOperationResult, TerminationReason, ResourceBudget, ServiceSpec, ServiceHandle, SnapshotDriver, SnapshotOperationResult, RollbackOperationResult, ConfinementDriver } from '../types.js';
 export interface ExecuteProcessOptions {
     runId: string;
     opId: string;
     name: string;
     command: StructuredCommand;
-    requiredResources: string[];
+    requiredResources?: string[];
+    mutationRoots?: string[];
+    capabilityId?: string;
+    confinement?: boolean | string;
+    confinementDriver?: ConfinementDriver;
     timeoutMs?: number;
     inputFingerprint?: string;
     maxOutputBytes?: number;
@@ -14,12 +18,32 @@ export interface ExecuteProcessOptions {
     resourceBudget?: ResourceBudget;
     waitTimeoutMs?: number;
     artifactsDir?: string;
+    abortSignal?: AbortSignal;
     /**
      * 流式投影：每个 stdout/stderr chunk 原样转发，不做缓冲或截断。
      * 回调抛错不会中断排空，首个错误以 result.streamCallbackError 记录。
      */
     onStreamChunk?: (stream: 'stdout' | 'stderr', chunk: Buffer) => void;
 }
+export interface CaptureSnapshotOptions {
+    runId: string;
+    opId: string;
+    roots?: string[];
+    capabilityId?: string;
+    includeIgnored?: boolean;
+    maxTreeSizeBytes?: number;
+    timeoutMs?: number;
+}
+export interface RollbackOptions {
+    runId: string;
+    opId: string;
+    snapshotId: string;
+    roots?: string[];
+    capabilityId?: string;
+    force?: boolean;
+    timeoutMs?: number;
+}
+export declare function normalizeResourceName(res: string): string;
 /**
  * 规范化计算完整输入的 SHA-256 指纹 (ARCHITECTURE §2 / P0-12)
  * 覆盖 execPath, args, cwd, 键排序的 envWhiteList, inheritEnv, sha256(stdin), 排序后的 requiredResources, timeoutMs, resourceBudget.
@@ -29,9 +53,44 @@ export declare class ProcessSupervisor {
     private readonly domain;
     private readonly driver;
     private activeOperations;
-    constructor(domain: ExecutionDomain, driver: PlatformDriver);
+    private serviceSupervisor;
+    private snapshotDriver;
+    private confinementDriver?;
+    constructor(domain: ExecutionDomain, driver?: PlatformDriver, snapshotDriver?: SnapshotDriver, confinementDriver?: ConfinementDriver);
     getDomain(): ExecutionDomain;
     getDriver(): PlatformDriver;
+    getSnapshotDriver(): SnapshotDriver;
+    setConfinementDriver(driver: ConfinementDriver): void;
+    getConfinementDriver(): ConfinementDriver | undefined;
+    startService(spec: ServiceSpec): Promise<ServiceHandle>;
+    /**
+     * 快照捕获协议 (ARCHITECTURE §3.5 / 契约 #32, #53)
+     */
+    captureSnapshot(options: CaptureSnapshotOptions): Promise<SnapshotOperationResult>;
+    /**
+     * 回滚协议 (ARCHITECTURE §3.5 / 契约 #28–#30, #56)
+     */
+    rollback(options: RollbackOptions): Promise<RollbackOperationResult>;
+    /**
+     * 分叉工作区 Materialize (ARCHITECTURE §3.5 / 契约 #54)
+     */
+    materialize(snapshotId: string, newRoot: string): Promise<{
+        worktreePath: string;
+    }>;
+    /**
+     * 回收分叉工作区 Dematerialize (ARCHITECTURE §3.5 / 契约 #54)
+     */
+    dematerialize(newRoot: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * 回收快照：删除驱动侧的私有 ref 与 store 记录，并写 SNAPSHOT_PRUNED。
+     * 宿主按自己的保留策略调用（例如每轮只保留会话基线与当前轮检查点），否则快照 ref 会无限累积。
+     * 未知 id 视为已回收（幂等）；驱动删除失败直接抛出，store 记录保留，便于重试。
+     */
+    pruneSnapshots(snapshotIds: string[], options?: {
+        runId?: string;
+    }): Promise<string[]>;
     /**
      * 启动协议：准入检查 -> 先持久化意图 -> 请求驱动启动 -> 登记身份并转 active -> 监督运行 -> 记录结果
      */
@@ -51,6 +110,5 @@ export declare class ProcessSupervisor {
         retained: string[];
     };
     private finalizeOperation;
-    private setupStreamDrainer;
 }
 //# sourceMappingURL=supervisor.d.ts.map

package/dist/supervisor/supervisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,iBAAiB,EAGjB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,sBAAsB,EAGtB,iBAAiB,EACjB,cAAc,EAIf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAmC9E;AAuDD,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,gBAAgB,CAAgD;IAExE,YACmB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,cAAc,EAGxC;IAEM,SAAS,IAAI,eAAe,CAElC;IAEM,SAAS,IAAI,cAAc,CAEjC;IAED;;OAEG;IACU,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgf3F;IAED;;OAEG;IACU,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsB7F;IAEY,kBAAkB,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAiD5B;IAED,OAAO,CAAC,qBAAqB;IAwB7B,OAAO,CAAC,0BAA0B;IA+C3B,cAAc,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QACzE,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAEA;IAED,OAAO,CAAC,iBAAiB;IAqDzB,OAAO,CAAC,kBAAkB;CAmL3B"}
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor.ts"],"names":[],"mappings":"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"}