@actiondock/core 2.6.0 → 2.8.0

package/dist/{app → package}/types.d.ts

@@ -1,12 +1,14 @@
-import type { ActionDefinition, ActionRef, ExecutionEvent, ExecutionResult, JsonValue, Logger, ProcessAPI, RunRecord } from "@actiondock/sdk";
-import type { CancelResult, ExecuteOptions, ExecutionService, ExecutionTicket } from "../execution/types.js";
+import type { ActionDefinition, ExecutionEvent, ExecutionResult, JsonValue, Logger, ProcessAPI, RunRecord } from "@actiondock/sdk";
+import type { ActionInvoker, CancelResult, ExecutionTicket, LocalActionResolver } from "../execution/types.js";
+import type { InvocationContext, RunOptions } from "../invocation/types.js";
 import type { ConfigItemDefinition, ProjectConfig } from "../project/types.js";
-import type { Clock } from "../runtime/clock.js";
 import type { EventSink } from "../runtime/events.js";
 import type { RuntimePlatform, StorageFactory, StorageFactoryOptions } from "../platform/types.js";
-import type { RuntimeStorage } from "../storage/types.js";
-import type { ConfigValueView, StateScopeOptions } from "../target/types.js";
-export type { ConfigValueView, RuntimePlatform, StateScopeOptions, StorageFactory, StorageFactoryOptions };
+import type { RuntimeStorage, StateEntry } from "../storage/types.js";
+import type { Clock } from "../storage/clock.js";
+import type { ConfigValueView, ListRunsOptions, StateScopeOptions } from "../service/types.js";
+import type { PackageIdentity } from "../runtime/identity.js";
+export type { ConfigValueView, ListRunsOptions, PackageIdentity, RuntimePlatform, StateScopeOptions, StorageFactory, StorageFactoryOptions };
 /**
  * 宏包信息契约。
  */
@@ -95,6 +97,18 @@ export interface ListActionsOptions {
     /** 标识前缀过滤 */
     prefix?: string;
 }
+/**
+ * 对 Action 摘要列表应用统一的检索过滤（标签、模糊关键词与标识前缀）。
+ *
+ * PackageRuntime 与 Host 两级列表查询的单一事实源：
+ * 两处过滤块逐字相同，收敛后调用方仅需在外层叠加各自的特有逻辑
+ * （Host 版在过滤前额外完成可见性筛选与跨包限定名改写）。
+ */
+export declare function applyActionSummaryFilters<T extends {
+    id: string;
+    description?: string;
+    tags?: string[];
+}>(summaries: readonly T[], options?: ListActionsOptions): T[];
 /**
  * Playbook 规程简要摘要条目。
  */
@@ -137,21 +151,13 @@ export interface StateOptions {
     ttl?: number;
 }
 /**
- * ActionDockApp 初始化配置选项。
+ * PackageRuntime 初始化公开配置选项（面向用户与外部配置）。
  */
-export interface ActionDockAppOptions {
+export interface PackageRuntimeOptions {
     /** 项目根目录绝对物理路径 */
     packageRoot?: string;
     /** 项目配置文件 (actiondock.json) 对象 */
     projectConfig?: ProjectConfig;
-    /** 显式注入的运行时平台适配 */
-    platform?: RuntimePlatform;
-    /** 显式注入的项目级运行时存储实例 */
-    storage?: RuntimeStorage;
-    /** 显式注入的全局运行时存储实例 */
-    globalStorage?: RuntimeStorage;
-    /** 显式注入的事件接收器 */
-    eventSink?: EventSink;
     /** 数据持久化存储目录 */
     dataDir?: string;
     /** 自定义家目录绝对路径 */
@@ -165,31 +171,11 @@ export interface ActionDockAppOptions {
     } | (ActionDefinition & {
         id: string;
     })> | Record<string, ActionDefinition>;
-    /** 跨包或动态 Action 解析器 */
-    actionResolver?: (ref: ActionRef | string) => ActionDefinition | undefined | Promise<ActionDefinition | undefined>;
-    /** 跨包运行上下文解析委托函数 */
-    packageContextResolver?: (packageId: string) => Promise<{
-        projectRoot?: string;
-        projectConfig?: ProjectConfig;
-        storage: RuntimeStorage;
-        actions?: Map<string, ActionDefinition>;
-        packageInstanceId?: string;
-        generationId?: string;
-    } | undefined> | {
-        projectRoot?: string;
-        projectConfig?: ProjectConfig;
-        storage: RuntimeStorage;
-        actions?: Map<string, ActionDefinition>;
-        packageInstanceId?: string;
-        generationId?: string;
-    } | undefined;
-    /** 包物理实例标识 */
-    packageInstanceId?: string;
-    /** 快照代次标识 */
-    generationId?: string;
+    /** 仅支持当前包局部 Action 的动态解析委托函数 */
+    actionResolver?: LocalActionResolver;
     /**
      * 是否以数据目录持有者身份打开存储：true 时构造阶段收割遗留非终态运行记录。
-     * 默认 true（App 主路径即持有者）；外部工具创建旁观视图时置 false。
+     * 默认 true（PackageRuntime 主路径即持有者）；外部工具创建旁观视图时置 false。
      */
     recoverOrphans?: boolean;
     /** 临时配置覆写字典 */
@@ -202,8 +188,8 @@ export interface ActionDockAppOptions {
     maxCallDepth?: number;
     /** 最大子任务数限制 */
     maxSubRuns?: number;
-    /** 执行宿主会话标识 */
-    hostSessionId?: string;
+    /** 显式注入的运行时平台适配 */
+    platform?: RuntimePlatform;
     /** 日志记录器 */
     logger?: Logger;
     /** 时钟源 */
@@ -214,11 +200,34 @@ export interface ActionDockAppOptions {
     exposeDebugInfo?: boolean;
 }
 /**
- * ActionDock 统一应用领域契约。
- * 作为单个 Action Package 的唯一运行单元与对外门面。
+ * PackageRuntime 内部装配选项（框架内部接线与依赖注入）。
+ *
+ * 普通公开 API 仅暴露 PackageRuntimeOptions，此选项仅在 Host 容器或核心测试装配时使用。
  */
-export interface ActionDockApp {
-    /** 包唯一标识 */
+export interface PackageRuntimeInternalOptions extends PackageRuntimeOptions {
+    /** 显式注入的包物理与快照身份标识值对象 */
+    identity?: PackageIdentity;
+    /** 显式注入的项目级运行时存储实例 */
+    storage?: RuntimeStorage;
+    /** 显式注入的全局运行时存储实例 */
+    globalStorage?: RuntimeStorage;
+    /** 显式注入的事件接收器 */
+    eventSink?: EventSink;
+    /** 子任务动作调用委托器 */
+    actionInvoker?: ActionInvoker;
+    /** 执行宿主会话标识 */
+    hostSessionId?: string;
+}
+/**
+ * 单个 Action Package 的运行时领域契约（PackageRuntime）。
+ *
+ * 铁律 1 执行主链核心节点：
+ * Host -> Resolution -> PackageRuntime -> ExecutionService -> ActionRunner -> Action
+ */
+export interface PackageRuntime {
+    /** 包唯一物理与快照身份标识值对象（只在创建时生成一次） */
+    readonly identity: PackageIdentity;
+    /** 包唯一逻辑标识 */
     readonly packageId: string;
     /** 包物理实例标识 */
     readonly packageInstanceId?: string;
@@ -228,16 +237,11 @@ export interface ActionDockApp {
     readonly packageRoot?: string;
     /** 项目配置对象（actiondock.json 解析结果） */
     readonly projectConfig: ProjectConfig;
-    /** 底层运行平台驱动适配契约 */
-    readonly platform: RuntimePlatform;
-    /** 当前包持久化存储实例 */
-    readonly storage: RuntimeStorage;
-    /** 全局持久化存储实例 */
-    readonly globalStorage?: RuntimeStorage;
-    /** 统一执行协调服务实例 */
-    readonly executionService: ExecutionService;
-    /** 预加载的 Action 定义映射表（短标识至定义） */
-    readonly actionsMap: Map<string, ActionDefinition>;
+    /**
+     * 受信任内部调用方法（Host 或子任务执行主链调用入口）。
+     * 委托内部 ExecutionService 执行，确保全生命周期指标与事件不发生分裂。
+     */
+    startInvocation(actionId: string, input: JsonValue, context: InvocationContext): Promise<ExecutionTicket>;
     /** 获取当前包元数据信息 */
     info(options?: {
         exposeDebugInfo?: boolean;
@@ -251,13 +255,20 @@ export interface ActionDockApp {
     /** 静态查询并返回指定 Playbook 的规范内容与操作指南 */
     describePlaybook(id: string): Promise<PlaybookSpec>;
     /** 同步执行指定 Action 并等待终态结果（仅接受本包短标识） */
-    runAction(id: string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionResult>;
+    runAction(id: string, input: JsonValue, options?: RunOptions): Promise<ExecutionResult>;
     /** 异步启动指定 Action 并立即返回任务执行票据（仅接受本包短标识） */
-    startAction(id: string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionTicket>;
+    startAction(id: string, input: JsonValue, options?: RunOptions): Promise<ExecutionTicket>;
+    /** 查询任务执行记录列表 */
+    listRuns(options?: ListRunsOptions): Promise<RunRecord[]>;
     /** 查询指定运行标识的记录详情 */
     getRun(runId: string): Promise<RunRecord | undefined>;
     /** 取消指定在运行的任务 */
     cancelRun(runId: string, reason?: string): Promise<CancelResult>;
+    /** 清空历史任务运行记录 */
+    clearRuns(options?: {
+        actionId?: string;
+        status?: string;
+    }): Promise<number>;
     /** 订阅指定运行的事件流 */
     events(runId: string, options?: {
         after?: number | string;
@@ -293,8 +304,16 @@ export interface ActionDockApp {
     /** 清空指定持久化状态项 */
     clearState(options?: StateScopeOptions): Promise<number>;
     clearState(actionId: string, options?: StateScopeOptions): Promise<number>;
+    /** 列出当前包在存储中的状态条目（含完整元数据） */
+    listStateEntries?(options?: any): Promise<StateEntry[]>;
     /** 优雅关闭应用并收尾清理所有底层资源 */
     close(options?: {
         graceMs?: number;
     }): Promise<void>;
 }
+/**
+ * 宿主托管专用内部运行时契约。
+ */
+export interface HostManagedPackageRuntime extends PackageRuntime {
+    setActionInvoker(invoker?: ActionInvoker): void;
+}

package/dist/package/types.js

@@ -0,0 +1,22 @@
+/**
+ * 对 Action 摘要列表应用统一的检索过滤（标签、模糊关键词与标识前缀）。
+ *
+ * PackageRuntime 与 Host 两级列表查询的单一事实源：
+ * 两处过滤块逐字相同，收敛后调用方仅需在外层叠加各自的特有逻辑
+ * （Host 版在过滤前额外完成可见性筛选与跨包限定名改写）。
+ */
+export function applyActionSummaryFilters(summaries, options) {
+    let results = summaries;
+    if (options?.tags && options.tags.length > 0) {
+        results = results.filter((s) => options.tags.every((t) => s.tags?.includes(t)));
+    }
+    if (options?.query) {
+        const q = options.query.toLowerCase();
+        results = results.filter((s) => s.id.toLowerCase().includes(q) ||
+            (s.description && s.description.toLowerCase().includes(q)));
+    }
+    if (options?.prefix) {
+        results = results.filter((s) => s.id.startsWith(options.prefix));
+    }
+    return results;
+}

package/dist/platform/index.d.ts

@@ -1,3 +1,3 @@
 export * from "./types.js";
 export * from "./node-fs.js";
-export * from "./default.js";
+export * from "./node.js";

package/dist/platform/index.js

@@ -1,3 +1,3 @@
 export * from "./types.js";
 export * from "./node-fs.js";
-export * from "./default.js";
+export * from "./node.js";

package/dist/platform/node.d.ts

@@ -0,0 +1,48 @@
+import type { ProcessAPI } from "@actiondock/sdk";
+import { type Clock } from "../runtime/clock.js";
+import { type ModuleLoader } from "../node/module-loader.js";
+import { ProcessManager } from "../process/process-manager.js";
+import type { ProcessDriver } from "../process/driver.js";
+import { type SqliteDriver } from "../storage/index.js";
+import type { FileSystem, RuntimePlatform, StorageFactory } from "./types.js";
+/**
+ * Node 平台构建配置选项。
+ */
+export interface NodePlatformOptions {
+    /** 平台名称覆盖（默认使用 node） */
+    name?: "node" | "test";
+    /** 自定义全局数据存储目录 */
+    dataDir?: string;
+    /** 自定义家目录路径 */
+    customHome?: string;
+    /** 文件系统安全沙箱根路径 */
+    rootDir?: string;
+    /** 自定义 SQLite 驱动工厂函数（必须返回满足同步契约的 SqliteDriver，默认实例化 NodeSqliteDriver） */
+    driverFactory?: (dbPath: string) => SqliteDriver;
+    /** 自定义进程执行驱动（默认依托基于 NodeProcessDriver 的 ProcessManager） */
+    process?: ProcessAPI;
+    /** 可选注入的底层进程驱动 */
+    processDriver?: ProcessDriver;
+    /** 可选注入的受管进程管理器 */
+    processManager?: ProcessManager;
+    /** 自定义源码加载驱动（默认实例化 NodeModuleLoader） */
+    modules?: ModuleLoader;
+    /** 自定义文件系统实现（默认实例化 NodeFileSystem） */
+    files?: FileSystem;
+    /** 自定义时钟驱动（默认实例化 SystemClock） */
+    clock?: Clock;
+    /** 自定义存储工厂（默认基于 NodeSqliteDriver 构造） */
+    storage?: StorageFactory;
+}
+/**
+ * 创建 Node 运行时平台实例。
+ * 组装 Node 原生核心组件：
+ * - NodeSqliteDriver 同步持久化存储驱动
+ * - NodeProcessDriver 原生进程驱动与 ProcessManager 受管进程引擎
+ * - NodeModuleLoader 原生源码加载器
+ * - NodeFileSystem 文件系统
+ * - SystemClock 系统时钟
+ *
+ * @param options 平台配置选项
+ */
+export declare function createNodePlatform(options?: NodePlatformOptions): RuntimePlatform;

package/dist/platform/node.js

@@ -0,0 +1,96 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { SystemClock } from "../runtime/clock.js";
+import { NodeModuleLoader } from "../node/module-loader.js";
+import { NodeProcessDriver } from "../process/process-driver.js";
+import { ProcessManager } from "../process/process-manager.js";
+import { NodeSqliteDriver } from "../storage/sqlite-driver.js";
+import { resolveDatabasePath, resolveGlobalDatabasePath, SqliteRuntimeStorage, } from "../storage/index.js";
+import { NodeFileSystem } from "./node-fs.js";
+function ensureDirectoryForDb(dbPath) {
+    if (dbPath !== ":memory:") {
+        const dir = dirname(dbPath);
+        if (!existsSync(dir)) {
+            try {
+                mkdirSync(dir, { recursive: true, mode: 0o700 });
+            }
+            catch (err) {
+                if (err?.code === "EEXIST" || err?.code === "EISDIR") {
+                    return;
+                }
+                throw new Error(`Failed to create data directory '${dir}' for database '${dbPath}': ${err?.message || String(err)}`, { cause: err });
+            }
+        }
+    }
+}
+/**
+ * 创建 Node 运行时平台实例。
+ * 组装 Node 原生核心组件：
+ * - NodeSqliteDriver 同步持久化存储驱动
+ * - NodeProcessDriver 原生进程驱动与 ProcessManager 受管进程引擎
+ * - NodeModuleLoader 原生源码加载器
+ * - NodeFileSystem 文件系统
+ * - SystemClock 系统时钟
+ *
+ * @param options 平台配置选项
+ */
+export function createNodePlatform(options = {}) {
+    const platformName = options.name ?? "node";
+    const clock = options.clock ?? new SystemClock();
+    const files = options.files ?? new NodeFileSystem({ rootDir: options.rootDir });
+    const modules = options.modules ?? new NodeModuleLoader();
+    const processDriver = options.processDriver ?? new NodeProcessDriver();
+    const processManager = options.processManager ?? new ProcessManager({ driver: processDriver });
+    const process = options.process ??
+        processManager.forOwner({
+            tenantId: "default",
+            principalId: "default",
+            packageInstanceId: "default",
+            generationId: "default",
+        });
+    const createDriver = options.driverFactory ?? ((dbPath) => new NodeSqliteDriver(dbPath));
+    const storage = options.storage ?? {
+        createStorage(packageId, opts) {
+            const mergedOpts = {
+                customHome: options.customHome,
+                dataDir: options.dataDir,
+                ...opts,
+            };
+            const dbPath = resolveDatabasePath(packageId, mergedOpts);
+            ensureDirectoryForDb(dbPath);
+            return new SqliteRuntimeStorage({
+                dbPath,
+                packageId,
+                clock,
+                driver: createDriver(dbPath),
+                recoverOrphans: opts?.recoverOrphans === true,
+            });
+        },
+        createGlobalStorage(opts) {
+            const mergedOpts = {
+                customHome: options.customHome,
+                dataDir: options.dataDir,
+                ...opts,
+            };
+            const dbPath = mergedOpts.inMemory
+                ? ":memory:"
+                : resolveGlobalDatabasePath({ dataDir: mergedOpts.dataDir, customHome: mergedOpts.customHome });
+            ensureDirectoryForDb(dbPath);
+            return new SqliteRuntimeStorage({
+                dbPath,
+                packageId: "__global__",
+                clock,
+                driver: createDriver(dbPath),
+                recoverOrphans: opts?.recoverOrphans === true,
+            });
+        },
+    };
+    return {
+        name: platformName,
+        clock,
+        files,
+        modules,
+        process,
+        storage,
+    };
+}

package/dist/platform/types.d.ts

@@ -82,15 +82,6 @@ export interface StorageFactory {
      */
     createGlobalStorage(options?: GlobalStorageFactoryOptions): RuntimeStorage;
 }
-/**
- * 跨运行时 HTTP 服务启动工厂契约。
- */
-export interface HttpServerFactory {
-    /**
-     * 启动 HTTP 服务端实例。
-     */
-    launchHttpServer(options: any): Promise<any>;
-}
 /**
  * 运行时底层环境核心标准契约。
  * 提供统一的运行时契约，屏蔽宿主平台与测试沙箱环境的实现差异。

package/dist/process/control-arbiter.d.ts

@@ -1,4 +1,5 @@
 import type { ControlGrant } from "@actiondock/sdk";
+import { type ErrorCode } from "../errors.js";
 import type { ManagedProcessRecord, ProcessOwner } from "./managed-record.js";
 import type { StoredProcessRecord } from "./metadata-store.js";
 /**
@@ -97,7 +98,7 @@ export declare class ControlArbiter {
      * 禁止直接操作 acquireWaiters 数组。
      */
     revokeAllWaiters(proc: ManagedProcessRecord, reason: {
-        code: string;
+        code: ErrorCode;
         message: string;
     }): void;
     /**

package/dist/process/control-arbiter.js

@@ -1,4 +1,3 @@
-import { randomUUID } from "node:crypto";
 import { ACCESS_DENIED, CONTROL_BUSY, CONTROL_EXPIRED, CONTROL_REVOKED, PROCESS_QUARANTINED, QUOTA_EXCEEDED, ProcessError, } from "../errors.js";
 /**
  * 控制权仲裁器。
@@ -103,7 +102,7 @@ export class ControlArbiter {
      */
     grantControl(proc, requestId, ttlMs, runId) {
         proc.controlEpoch += 1;
-        const token = `tok_${proc.info.id}_${proc.controlEpoch}_${randomUUID().replace(/-/g, "")}`;
+        const token = `tok_${proc.info.id}_${proc.controlEpoch}_${crypto.randomUUID().replace(/-/g, "")}`;
         const expiresAt = new Date(Date.now() + ttlMs).toISOString();
         proc.info.control = "held";
         proc.currentGrant = {

package/dist/process/driver.d.ts

@@ -3,6 +3,10 @@ import type { Capabilities, LaunchSpec } from "@actiondock/sdk";
  * 进程驱动实例底层控制句柄接口。
  */
 export interface ProcessDriverHandle {
+    /**
+     * 进程系统标识符（若底层为操作系统子进程）。
+     */
+    pid?: number;
     /**
      * 向受管进程标准输入通道写入原始字节数据。
      *
@@ -82,6 +86,8 @@ export declare function resolveProcessEnv(envConfig?: LaunchSpec["env"], hostEnv
  * 进程观察者接口，接收来自底层驱动的流输出与生命周期通知。
  */
 export interface ProcessObserver {
+    /** 期望关联的受管进程标识（若有） */
+    processId?: string;
     /**
      * 接收来自进程的输出数据。
      *
@@ -135,10 +141,6 @@ export interface ProcessDriver {
      * @param observer 进程生命周期与输出观察者
      */
     spawn(spec: LaunchSpec, observer: ProcessObserver): Promise<ProcessHandle>;
-    /**
-     * 兼容旧版基于 processId 派生新进程签名。
-     */
-    spawn(processId: string, spec: LaunchSpec, callbacks: ProcessDriverCallbacks): Promise<ProcessDriverHandle>;
     /**
      * 向受管进程标准输入写入字节数据。
      *
@@ -162,7 +164,6 @@ export interface ProcessDriver {
      * 优雅终止或强制终止底层进程。
      */
     terminate(handle: ProcessHandle, graceMs: number): Promise<void>;
-    terminate(processId: string, graceMs: number): Promise<void>;
     /**
      * 销毁进程句柄并清理关联资源。
      */
@@ -174,12 +175,12 @@ export interface ProcessDriver {
 export declare class MemoryProcessDriver implements ProcessDriver {
     private capabilities;
     handles: Map<string, MemoryProcessDriverHandle>;
-    spawnHook?: (processId: string, spec: LaunchSpec, callbacks: ProcessDriverCallbacks) => Promise<MemoryProcessDriverHandle | void> | MemoryProcessDriverHandle | void;
+    spawnHook?: (spec: LaunchSpec, observer: ProcessObserver) => Promise<MemoryProcessDriverHandle | void> | MemoryProcessDriverHandle | void;
     constructor(capabilities?: Partial<Capabilities>);
     getCapabilities(): Capabilities;
     setCapabilities(caps: Partial<Capabilities>): void;
-    spawn(specOrProcessId: LaunchSpec | string, observerOrSpec: ProcessObserver | LaunchSpec, maybeCallbacks?: ProcessDriverCallbacks): Promise<any>;
-    terminate(handleOrId: ProcessHandle | string, graceMs: number): Promise<void>;
+    spawn(spec: LaunchSpec, observer: ProcessObserver): Promise<ProcessHandle>;
+    terminate(handle: ProcessHandle, graceMs: number): Promise<void>;
 }
 /**
  * 内存模拟进程驱动句柄实现。

package/dist/process/driver.js

@@ -93,25 +93,15 @@ export class MemoryProcessDriver {
     setCapabilities(caps) {
         this.capabilities = { ...this.capabilities, ...caps };
     }
-    async spawn(specOrProcessId, observerOrSpec, maybeCallbacks) {
-        if (typeof specOrProcessId === "string") {
-            const processId = specOrProcessId;
-            const spec = observerOrSpec;
-            const callbacks = maybeCallbacks;
-            if (this.spawnHook) {
-                const customHandle = await this.spawnHook(processId, spec, callbacks);
-                if (customHandle) {
-                    this.handles.set(processId, customHandle);
-                    return customHandle;
-                }
+    async spawn(spec, observer) {
+        const processId = observer.processId ?? `mem-${Math.random().toString(36).slice(2, 10)}`;
+        if (this.spawnHook) {
+            const customHandle = await this.spawnHook(spec, observer);
+            if (customHandle) {
+                this.handles.set(customHandle.id, customHandle);
+                return customHandle;
             }
-            const handle = new MemoryProcessDriverHandle(processId, spec, callbacks);
-            this.handles.set(processId, handle);
-            return handle;
         }
-        const spec = specOrProcessId;
-        const observer = observerOrSpec;
-        const processId = `mem-${Math.random().toString(36).slice(2, 10)}`;
         const callbacks = {
             onOutput(stream, data) {
                 observer.output(stream, data);
@@ -130,11 +120,10 @@ export class MemoryProcessDriver {
         this.handles.set(processId, handle);
         return handle;
     }
-    async terminate(handleOrId, graceMs) {
-        const id = typeof handleOrId === "string" ? handleOrId : handleOrId.id;
-        const handle = this.handles.get(id);
-        if (handle) {
-            await handle.terminate(graceMs);
+    async terminate(handle, graceMs) {
+        const instance = this.handles.get(handle.id);
+        if (instance) {
+            await instance.terminate(graceMs);
         }
     }
 }

package/dist/process/index.d.ts

@@ -11,3 +11,5 @@ export * from "./control-arbiter.js";
 export * from "./input-dispatcher.js";
 export * from "./process-manager.js";
 export * from "./context-process.js";
+export * from "./process-driver.js";
+export * from "./process-executor.js";

package/dist/process/index.js

@@ -11,3 +11,5 @@ export * from "./control-arbiter.js";
 export * from "./input-dispatcher.js";
 export * from "./process-manager.js";
 export * from "./context-process.js";
+export * from "./process-driver.js";
+export * from "./process-executor.js";

package/dist/process/managed-record.d.ts

@@ -1,5 +1,5 @@
 import type { ControlGrant, Limits, OperationReceipt, ProcessControlAction, ProcessInfo } from "@actiondock/sdk";
-import type { ProcessDriverHandle } from "./driver.js";
+import type { ProcessDriverHandle, ProcessHandle } from "./driver.js";
 import type { ProcessRequestKey } from "./metadata-store.js";
 import type { ProcessOutputLog } from "./output-log.js";
 import type { EvictedOutputTombstone } from "./terminal-output-cache.js";
@@ -50,7 +50,7 @@ export interface ManagedProcessRecord {
     info: ProcessInfo;
     owner: ProcessOwner;
     scope: string;
-    handle?: ProcessDriverHandle;
+    handle?: ProcessHandle & ProcessDriverHandle;
     outputLog: ProcessOutputLog;
     outputUnavailable?: boolean;
     outputTombstone?: EvictedOutputTombstone;