@actiondock/core 2.6.0 → 2.8.0

package/dist/runtime/standalone.d.ts

@@ -1,7 +1,7 @@
 import { type ActionDefinition } from "@actiondock/sdk";
-import type { ActionSpec } from "../app/types.js";
+import type { ActionSpec } from "../package/types.js";
 import type { ConfigItemDefinition } from "../project/types.js";
-import type { ActionDockTarget } from "../target/types.js";
+import type { ActionDockService } from "../service/types.js";
 /**
  * 退出状态码常量。
  */
@@ -11,6 +11,13 @@ export declare const ExitCode: {
     readonly INVALID_ARGUMENT: 2;
     readonly SIGINT: 130;
 };
+/**
+ * 调用控制选项契约。
+ */
+export interface InvocationControl {
+    signal?: AbortSignal;
+    cancellationSource?: "external" | "sigint";
+}
 /**
  * 独立二进制运行分发器配置选项。
  */
@@ -21,8 +28,8 @@ export interface StandaloneDispatcherOptions {
     version: string;
     /** 描述信息 */
     description?: string;
-    /** 已构造的 ActionDockTarget 门面（若未传入则依据 actions/config 自动创建） */
-    target?: ActionDockTarget;
+    /** 已构造的 ActionDockService 服务（若未传入则依据 actions/config 自动创建） */
+    service?: ActionDockService;
     /** 声明的配置依赖定义（兼容选项） */
     configDefs?: Record<string, ConfigItemDefinition>;
     config?: Record<string, ConfigItemDefinition>;
@@ -49,7 +56,7 @@ export interface StandaloneDispatcherOptions {
  *
  * 职责：
  * 1. 负责轻量参数解析、诊断输出渲染与统一退出码管理。
- * 2. 统一面向 ActionDockTarget 门面调用能力（支持本地 LocalTarget 与 IPC 监督隔离 Target）。
+ * 2. 统一面向 ActionDockService 服务调用能力。
  * 3. 严格遵循 ActionDock 2.0 输出协议约定：结果数据专走 stdout，日志与错误专走 stderr。
  * 4. 独立入口拒绝异步启动语义，显式拦截并返回 STANDALONE_ASYNC_UNSUPPORTED。
  */
@@ -58,23 +65,39 @@ export declare class StandaloneDispatcher {
     constructor(options: StandaloneDispatcherOptions);
     private writeOut;
     private writeErr;
-    private createLocalTarget;
+    /**
+     * 统一错误输出辅助方法。
+     *
+     * JSON 模式向 stdout 输出两空格缩进的标准错误结构；
+     * 纯文本模式向 stderr 输出单行错误消息（默认携带 Error: 前缀）。
+     * 消息文本与退出码由调用方逐字给定，输出字节严格保持不变。
+     *
+     * @param isJson 是否处于 JSON 输出模式
+     * @param code 错误码
+     * @param message JSON 模式错误消息（兼作纯文本默认消息主体）
+     * @param exitCode 调用方应返回的退出状态码
+     * @param options 可选项：textMessage 覆盖纯文本消息全文；details 为 JSON 模式可选结构化详情
+     * @returns 透传 exitCode 供调用方直接返回
+     */
+    private emitError;
+    private createLocalService;
     /**
      * 解析命令行参数并分发执行对应子命令。
      *
      * @param argv 命令行参数数组（如 process.argv.slice(2)）
+     * @param control 可选的中断与取消控制契约
      * @returns 退出状态码（0: 成功, 1: 失败, 2: 参数错误, 130: 中断）
      */
-    dispatch(argv: string[]): Promise<number>;
+    dispatch(argv: string[], control?: InvocationControl): Promise<number>;
     private handleList;
     private handleDescribe;
     private handleRun;
     private handleConfig;
     private handleState;
     /**
-     * 判定配置读取异常是否为目标层能力缺失（键未配置语义）而非内部故障。
+     * 判定配置读取异常是否为服务能力缺失（键未配置语义）而非内部故障。
      */
-    private isTargetCapabilityError;
+    private isServiceCapabilityError;
     /**
      * 解析携带命名空间前缀的状态键参数：委托 sdk 单一事实源 decodeStateKey。
      *
@@ -97,3 +120,8 @@ export declare class StandaloneRuntime {
  * 工厂函数：创建独立运行时实例。
  */
 export declare function createStandaloneRuntime(options: StandaloneRuntimeOptions): StandaloneRuntime;
+/**
+ * 独立二进制进程入口适配器。
+ * 仅在命令行可执行入口调用，负责全局 SIGINT 监听与退出状态码写入。
+ */
+export declare function runStandaloneProcess(argv: string[], options: StandaloneDispatcherOptions): Promise<void>;

package/dist/runtime/standalone.js

@@ -1,8 +1,9 @@
-import { readFileSync } from "node:fs";
 import { decodeStateKey } from "@actiondock/sdk";
 import { filterWithFallbackInfo } from "../filter/index.js";
-import { createActionDockTarget } from "../target/target.js";
+import { createActionDock } from "../service/factory.js";
 import { STANDALONE_ASYNC_UNSUPPORTED } from "../errors.js";
+import { resolveActionInput, formatActionDetail, buildActionDescribePayload, mapInputValidationFailure, } from "../input/index.js";
+import { validateActionInputValue } from "../json/value-validator.js";
 import { normalizeActionCollection } from "./action-collection.js";
 import { parseDuration } from "../utils/index.js";
 /**
@@ -19,7 +20,7 @@ export const ExitCode = {
  *
  * 职责：
  * 1. 负责轻量参数解析、诊断输出渲染与统一退出码管理。
- * 2. 统一面向 ActionDockTarget 门面调用能力（支持本地 LocalTarget 与 IPC 监督隔离 Target）。
+ * 2. 统一面向 ActionDockService 服务调用能力。
  * 3. 严格遵循 ActionDock 2.0 输出协议约定：结果数据专走 stdout，日志与错误专走 stderr。
  * 4. 独立入口拒绝异步启动语义，显式拦截并返回 STANDALONE_ASYNC_UNSUPPORTED。
  */
@@ -44,18 +45,49 @@ export class StandaloneDispatcher {
             console.error(msg);
         }
     }
-    async createLocalTarget(dataDir, configOverrides = {}) {
-        if (this.options.target) {
-            return { target: this.options.target, ownsTarget: false };
+    /**
+     * 统一错误输出辅助方法。
+     *
+     * JSON 模式向 stdout 输出两空格缩进的标准错误结构；
+     * 纯文本模式向 stderr 输出单行错误消息（默认携带 Error: 前缀）。
+     * 消息文本与退出码由调用方逐字给定，输出字节严格保持不变。
+     *
+     * @param isJson 是否处于 JSON 输出模式
+     * @param code 错误码
+     * @param message JSON 模式错误消息（兼作纯文本默认消息主体）
+     * @param exitCode 调用方应返回的退出状态码
+     * @param options 可选项：textMessage 覆盖纯文本消息全文；details 为 JSON 模式可选结构化详情
+     * @returns 透传 exitCode 供调用方直接返回
+     */
+    emitError(isJson, code, message, exitCode, options) {
+        if (isJson) {
+            const details = options?.details;
+            this.writeOut(JSON.stringify({
+                ok: false,
+                error: {
+                    code,
+                    message,
+                    ...(details !== undefined ? { details } : {}),
+                },
+            }, null, 2));
+        }
+        else {
+            this.writeErr(options?.textMessage ?? `Error: ${message}`);
+        }
+        return exitCode;
+    }
+    async createLocalService(dataDir, configOverrides = {}) {
+        if (this.options.service) {
+            return { service: this.options.service, ownsService: false };
         }
-        if (this.options.inMemory && this.options._sharedTarget) {
-            return { target: this.options._sharedTarget, ownsTarget: false };
+        if (this.options.inMemory && this.options._sharedService) {
+            return { service: this.options._sharedService, ownsService: false };
         }
         // 归一化 Action 集合：单一入口统一三形态输入
         const { actionsMap, actionSpecs } = normalizeActionCollection(this.options.actions);
         // projectConfig.actions 要求 manifest 形态，字段语义兼容，此处显式收敛类型
         const manifestActions = actionSpecs;
-        const appOptions = {
+        const runtimeOptions = {
             projectConfig: {
                 id: this.options.packageId,
                 name: this.options.packageId,
@@ -70,38 +102,40 @@ export class StandaloneDispatcher {
             customHome: this.options.customHome,
             inMemory: this.options.inMemory,
         };
-        const target = await createActionDockTarget({
-            type: "local",
-            appOptions,
+        const service = await createActionDock({
+            runtimeOptions,
         });
         if (this.options.inMemory) {
-            this.options._sharedTarget = target;
-            return { target, ownsTarget: false };
+            this.options._sharedService = service;
+            return { service, ownsService: false };
         }
-        return { target, ownsTarget: true };
+        return { service, ownsService: true };
     }
     /**
      * 解析命令行参数并分发执行对应子命令。
      *
      * @param argv 命令行参数数组（如 process.argv.slice(2)）
+     * @param control 可选的中断与取消控制契约
      * @returns 退出状态码（0: 成功, 1: 失败, 2: 参数错误, 130: 中断）
      */
-    async dispatch(argv) {
-        const args = [...argv];
+    async dispatch(argv, control) {
+        const separator = argv.indexOf("--");
+        const controlArgs = separator >= 0 ? argv.slice(0, separator) : argv;
+        const actionArgs = separator >= 0 ? argv.slice(separator + 1) : [];
         let dataDir;
         const configOverrides = {};
-        // 1. 提取全局参数（--data-dir, --config）
+        // 1. 提取全局参数（--data-dir, --config）仅从 controlArgs 中解析
         const filteredArgs = [];
-        for (let i = 0; i < args.length; i++) {
-            const arg = args[i];
-            if (arg === "--data-dir" && i + 1 < args.length) {
-                dataDir = args[++i];
+        for (let i = 0; i < controlArgs.length; i++) {
+            const arg = controlArgs[i];
+            if (arg === "--data-dir" && i + 1 < controlArgs.length) {
+                dataDir = controlArgs[++i];
             }
             else if (arg.startsWith("--data-dir=")) {
                 dataDir = arg.slice(11);
             }
-            else if (arg === "--config" && i + 1 < args.length) {
-                const pair = args[++i];
+            else if (arg === "--config" && i + 1 < controlArgs.length) {
+                const pair = controlArgs[++i];
                 const [k, ...v] = pair.split("=");
                 if (k)
                     configOverrides[k] = v.join("=");
@@ -119,21 +153,10 @@ export class StandaloneDispatcher {
         const command = filteredArgs[0] || "help";
         const subArgs = filteredArgs.slice(1);
         // 2. 独立入口拒绝异步启动语义
-        if (args.includes("--async")) {
-            const isJson = args.includes("--json");
-            if (isJson) {
-                this.writeOut(JSON.stringify({
-                    ok: false,
-                    error: {
-                        code: STANDALONE_ASYNC_UNSUPPORTED,
-                        message: "Async execution is not supported in standalone single-execution binaries. Use 'ad serve' or remote target.",
-                    },
-                }, null, 2));
-            }
-            else {
-                this.writeErr(`Error [${STANDALONE_ASYNC_UNSUPPORTED}]: Async execution is not supported in standalone single-execution binaries.`);
-            }
-            return ExitCode.FAILURE;
+        if (controlArgs.includes("--async")) {
+            return this.emitError(controlArgs.includes("--json"), STANDALONE_ASYNC_UNSUPPORTED, "Async execution is not supported in standalone single-execution binaries. Use 'ad serve' or remote target.", ExitCode.FAILURE, {
+                textMessage: `Error [${STANDALONE_ASYNC_UNSUPPORTED}]: Async execution is not supported in standalone single-execution binaries.`,
+            });
         }
         // 3. 版本与帮助快速处理（无需初始化 Host / Storage）
         if (command === "-v" || command === "-V" || command === "--version" || command === "version") {
@@ -144,56 +167,61 @@ export class StandaloneDispatcher {
             this.printHelp();
             return ExitCode.SUCCESS;
         }
-        let target;
-        let ownsTarget = false;
+        let service;
+        let ownsService = false;
         try {
-            const targetRes = await this.createLocalTarget(dataDir, configOverrides);
-            target = targetRes.target;
-            ownsTarget = targetRes.ownsTarget;
+            const serviceRes = await this.createLocalService(dataDir, configOverrides);
+            service = serviceRes.service;
+            ownsService = serviceRes.ownsService;
         }
         catch (err) {
-            this.writeErr(`Error initializing standalone target: ${err?.message || err}`);
+            this.writeErr(`Error initializing standalone service: ${err?.message || err}`);
             return ExitCode.FAILURE;
         }
-        const controller = new AbortController();
-        const sigintHandler = () => {
-            controller.abort(new Error("Interrupted by SIGINT"));
-        };
-        process.once("SIGINT", sigintHandler);
         try {
+            let code;
             switch (command) {
                 case "list":
-                    return await this.handleList(target, subArgs);
+                    code = await this.handleList(service, subArgs);
+                    break;
                 case "describe":
                 case "show":
-                    return await this.handleDescribe(target, subArgs);
+                    code = await this.handleDescribe(service, subArgs);
+                    break;
                 case "run":
-                    return await this.handleRun(target, subArgs, controller.signal);
+                    code = await this.handleRun(service, subArgs, actionArgs, control?.signal);
+                    break;
                 case "config":
-                    return await this.handleConfig(target, subArgs);
+                    code = await this.handleConfig(service, subArgs);
+                    break;
                 case "state":
-                    return await this.handleState(target, subArgs);
+                    code = await this.handleState(service, subArgs);
+                    break;
                 default:
                     this.writeErr(`Unknown command: '${command}'`);
                     this.printHelp();
                     return ExitCode.INVALID_ARGUMENT;
             }
+            if (control?.cancellationSource === "sigint" && control?.signal?.aborted) {
+                return ExitCode.SIGINT;
+            }
+            return code;
         }
         catch (err) {
-            if (err?.name === "AbortError" || controller.signal.aborted) {
+            if (control?.cancellationSource === "sigint" &&
+                (control?.signal?.aborted || err?.name === "AbortError" || err?.code === "SIGINT_INTERRUPTED")) {
                 return ExitCode.SIGINT;
             }
             this.writeErr(`Error: ${err?.message || err}`);
             return ExitCode.FAILURE;
         }
         finally {
-            process.removeListener("SIGINT", sigintHandler);
-            if (ownsTarget) {
-                await target.close();
+            if (ownsService) {
+                await service.close();
             }
         }
     }
-    async handleList(target, subArgs) {
+    async handleList(service, subArgs) {
         const isJson = subArgs.includes("--json");
         const noFallback = subArgs.includes("--no-fallback");
         let intent;
@@ -215,7 +243,7 @@ export class StandaloneDispatcher {
             }
         }
         const effectiveIntent = intent || (positionalPatterns.length > 0 ? positionalPatterns.join("|") : undefined);
-        const actions = await target.listActions();
+        const actions = await service.discovery.listActions();
         const list = actions.map((a) => ({
             id: a.id,
             description: a.description || "",
@@ -233,94 +261,89 @@ export class StandaloneDispatcher {
         }
         return ExitCode.SUCCESS;
     }
-    async handleDescribe(target, subArgs) {
+    async handleDescribe(service, subArgs) {
         const id = subArgs.find((a) => !a.startsWith("-"));
         const isJson = subArgs.includes("--json");
         if (!id) {
-            this.writeErr("Error: Action ID is required for describe");
-            return ExitCode.INVALID_ARGUMENT;
+            return this.emitError(isJson, "INVALID_ARGUMENT", "Action ID is required for describe", ExitCode.INVALID_ARGUMENT);
         }
         let action;
         try {
-            action = await target.describeAction(id);
+            action = await service.discovery.describeAction(id);
         }
         catch {
-            this.writeErr(`Error: Action '${id}' not found`);
-            return ExitCode.INVALID_ARGUMENT;
+            return this.emitError(isJson, "INVALID_ARGUMENT", `Action '${id}' not found`, ExitCode.INVALID_ARGUMENT);
         }
-        const detail = {
-            id: action.id,
+        const payload = buildActionDescribePayload(action, {
             packageId: this.options.packageId,
-            description: action.description,
-            inputSchema: action.inputSchema,
-            outputSchema: action.outputSchema,
-        };
+        });
         if (isJson) {
-            this.writeOut(JSON.stringify(detail, null, 2));
+            this.writeOut(JSON.stringify(payload, null, 2));
         }
         else {
-            let text = `Action: ${action.id}\n`;
-            if (action.description)
-                text += `Description: ${action.description}\n`;
-            if (action.inputSchema) {
-                text += `\nInput Schema:\n${JSON.stringify(action.inputSchema, null, 2)}\n`;
-            }
-            if (action.outputSchema) {
-                text += `\nOutput Schema:\n${JSON.stringify(action.outputSchema, null, 2)}\n`;
-            }
-            this.writeOut(text.trimEnd());
+            this.writeOut(formatActionDetail(payload));
         }
         return ExitCode.SUCCESS;
     }
-    async handleRun(target, subArgs, signal) {
+    async handleRun(service, subArgs, actionArgs, signal) {
+        const isJson = subArgs.includes("--json");
         const id = subArgs.find((a) => !a.startsWith("-"));
         if (!id) {
-            this.writeErr("Error: Action ID is required for run");
-            return ExitCode.INVALID_ARGUMENT;
+            return this.emitError(isJson, "INVALID_ARGUMENT", "Error: Action ID is required for run", ExitCode.INVALID_ARGUMENT, { textMessage: "Error: Action ID is required for run" });
         }
-        let input = {};
+        let inputStr;
+        let inputFile;
         let timeoutMs;
-        let isJson = false;
         for (let i = 0; i < subArgs.length; i++) {
             const arg = subArgs[i];
-            if (arg === "--json") {
-                isJson = true;
-            }
-            else if (arg === "--timeout" && i + 1 < subArgs.length) {
-                timeoutMs = parseDuration(subArgs[++i]);
-            }
-            else if (arg.startsWith("--timeout=")) {
-                timeoutMs = parseDuration(arg.slice(10));
-            }
-            else if (arg === "--input" && i + 1 < subArgs.length) {
+            if (arg === "--timeout" && i + 1 < subArgs.length) {
                 try {
-                    input = JSON.parse(subArgs[++i]);
+                    timeoutMs = parseDuration(subArgs[++i]);
                 }
-                catch (e) {
-                    this.writeErr(`Error parsing --input JSON: ${e.message}`);
-                    return ExitCode.INVALID_ARGUMENT;
+                catch (err) {
+                    return this.emitError(isJson, "INVALID_ARGUMENT", `Invalid timeout format: ${err?.message || err}`, ExitCode.INVALID_ARGUMENT);
                 }
             }
-            else if (arg.startsWith("--input=")) {
+            else if (arg.startsWith("--timeout=")) {
                 try {
-                    input = JSON.parse(arg.slice(8));
+                    timeoutMs = parseDuration(arg.slice(10));
                 }
-                catch (e) {
-                    this.writeErr(`Error parsing --input JSON: ${e.message}`);
-                    return ExitCode.INVALID_ARGUMENT;
+                catch (err) {
+                    return this.emitError(isJson, "INVALID_ARGUMENT", `Invalid timeout format: ${err?.message || err}`, ExitCode.INVALID_ARGUMENT);
                 }
             }
+            else if (arg === "--input" && i + 1 < subArgs.length) {
+                inputStr = subArgs[++i];
+            }
+            else if (arg.startsWith("--input=")) {
+                inputStr = arg.slice(8);
+            }
             else if (arg === "--input-file" && i + 1 < subArgs.length) {
-                try {
-                    input = JSON.parse(readFileSync(subArgs[++i], "utf-8"));
-                }
-                catch (e) {
-                    this.writeErr(`Error reading --input-file: ${e.message}`);
-                    return ExitCode.INVALID_ARGUMENT;
-                }
+                inputFile = subArgs[++i];
+            }
+            else if (arg.startsWith("--input-file=")) {
+                inputFile = arg.slice(13);
+            }
+        }
+        let input;
+        try {
+            input = await resolveActionInput({
+                input: inputStr,
+                inputFile,
+                flatArgs: actionArgs.length > 0 ? actionArgs : undefined,
+                stdin: process.stdin,
+            });
+            const check = validateActionInputValue(input);
+            if (!check.valid) {
+                throw mapInputValidationFailure("cli-pre-target", check);
             }
         }
-        const result = await target.runAction(id, input, {
+        catch (err) {
+            return this.emitError(isJson, err?.code || "INVALID_ARGUMENT", err?.message || String(err), ExitCode.INVALID_ARGUMENT, {
+                details: err?.details,
+            });
+        }
+        const result = await service.execution.run(id, input, {
             signal,
             timeoutMs,
         });
@@ -409,10 +432,14 @@ export class StandaloneDispatcher {
         }
         return result.ok ? ExitCode.SUCCESS : ExitCode.FAILURE;
     }
-    async handleConfig(target, subArgs) {
+    async handleConfig(service, subArgs) {
         const sub = subArgs[0] || "list";
+        if (!service.management) {
+            this.writeErr("Error: management port is not enabled on this service");
+            return ExitCode.FAILURE;
+        }
         if (sub === "list") {
-            const views = await target.listConfig(this.options.packageId);
+            const views = await service.management.config.list(this.options.packageId);
             const dict = {};
             for (const v of views) {
                 if (v.configured && v.value !== undefined) {
@@ -429,13 +456,13 @@ export class StandaloneDispatcher {
                 return ExitCode.INVALID_ARGUMENT;
             }
             try {
-                const item = await target.getConfig(this.options.packageId, key);
+                const item = await service.management.config.get(this.options.packageId, key);
                 this.writeOut(item.configured ? JSON.stringify(item.value) : "undefined");
                 return ExitCode.SUCCESS;
             }
             catch (err) {
-                // 目标层能力缺失（如远端未开启管理接口）视为键未配置，输出 undefined
-                if (this.isTargetCapabilityError(err)) {
+                // 服务能力缺失（如远端未开启管理接口）视为键未配置，输出 undefined
+                if (this.isServiceCapabilityError(err)) {
                     this.writeOut("undefined");
                     return ExitCode.SUCCESS;
                 }
@@ -458,7 +485,7 @@ export class StandaloneDispatcher {
             catch {
                 parsed = rawVal;
             }
-            await target.setConfig(this.options.packageId, key, parsed);
+            await service.management.config.set(this.options.packageId, key, parsed);
             this.writeOut(`Config '${key}' updated`);
             return ExitCode.SUCCESS;
         }
@@ -468,18 +495,22 @@ export class StandaloneDispatcher {
                 this.writeErr("Error: config key required");
                 return ExitCode.INVALID_ARGUMENT;
             }
-            await target.deleteConfig(this.options.packageId, key);
+            await service.management.config.delete(this.options.packageId, key);
             this.writeOut(`Config '${key}' deleted`);
             return ExitCode.SUCCESS;
         }
         this.writeErr(`Unknown config subcommand: '${sub}'`);
         return ExitCode.INVALID_ARGUMENT;
     }
-    async handleState(target, subArgs) {
+    async handleState(service, subArgs) {
         const sub = subArgs[0] || "list";
         let namespace;
         let isAll = false;
         let isJson = false;
+        if (!service.management) {
+            this.writeErr("Error: management port is not enabled on this service");
+            return ExitCode.FAILURE;
+        }
         for (let i = 1; i < subArgs.length; i++) {
             if ((subArgs[i] === "-n" || subArgs[i] === "--namespace") && i + 1 < subArgs.length) {
                 namespace = subArgs[++i];
@@ -496,7 +527,7 @@ export class StandaloneDispatcher {
         }
         if (sub === "list") {
             const prefix = subArgs[1] && !subArgs[1].startsWith("-") ? subArgs[1] : "";
-            const keys = await target.listStateKeys(this.options.packageId, "", {
+            const keys = await service.management.state.list(this.options.packageId, "", {
                 namespace,
                 prefix: prefix || undefined,
                 all: isAll,
@@ -517,7 +548,7 @@ export class StandaloneDispatcher {
                 ns = decoded.namespace || undefined;
                 actualKey = decoded.key;
             }
-            const val = await target.getState(this.options.packageId, "", actualKey, { namespace: ns });
+            const val = await service.management.state.get(this.options.packageId, "", actualKey, { namespace: ns });
             if (isJson) {
                 this.writeOut(JSON.stringify({ key, value: val }, null, 2));
             }
@@ -556,7 +587,7 @@ export class StandaloneDispatcher {
                     ttl = parseInt(subArgs[i].slice(6), 10);
                 }
             }
-            await target.setState(this.options.packageId, "", actualKey, parsed, { namespace: ns, ttl });
+            await service.management.state.set(this.options.packageId, "", actualKey, parsed, { namespace: ns, ttl });
             const displayKey = ns ? `${ns}:${actualKey}` : actualKey;
             this.writeOut(`State '${displayKey}' updated`);
             return ExitCode.SUCCESS;
@@ -567,7 +598,7 @@ export class StandaloneDispatcher {
                 this.writeErr("Error: state key required");
                 return ExitCode.INVALID_ARGUMENT;
             }
-            const deleted = await target.deleteState(this.options.packageId, "", key, { namespace });
+            const deleted = await service.management.state.delete(this.options.packageId, "", key, { namespace });
             if (deleted) {
                 this.writeOut(`State '${key}' deleted`);
                 return ExitCode.SUCCESS;
@@ -577,7 +608,7 @@ export class StandaloneDispatcher {
         }
         if (sub === "clear" || sub === "clean") {
             const prefix = subArgs[1] && !subArgs[1].startsWith("-") ? subArgs[1] : "";
-            const count = await target.clearState(this.options.packageId, "", {
+            const count = await service.management.state.clear(this.options.packageId, "", {
                 namespace,
                 all: isAll,
                 prefix: prefix || undefined,
@@ -589,15 +620,12 @@ export class StandaloneDispatcher {
         return ExitCode.INVALID_ARGUMENT;
     }
     /**
-     * 判定配置读取异常是否为目标层能力缺失（键未配置语义）而非内部故障。
+     * 判定配置读取异常是否为服务能力缺失（键未配置语义）而非内部故障。
      */
-    isTargetCapabilityError(err) {
+    isServiceCapabilityError(err) {
         const code = String(err?.code || "");
-        const msg = String(err?.message || "");
-        return (code === "TARGET_CAPABILITY_UNAVAILABLE" ||
-            code === "CAPABILITY_UNAVAILABLE" ||
-            msg.includes("TARGET_CAPABILITY_UNAVAILABLE") ||
-            msg.includes("Management APIs are not enabled"));
+        return (code === "CAPABILITY_UNAVAILABLE" ||
+            code === "TARGET_CAPABILITY_UNAVAILABLE");
     }
     /**
      * 解析携带命名空间前缀的状态键参数：委托 sdk 单一事实源 decodeStateKey。
@@ -646,3 +674,34 @@ export class StandaloneRuntime {
 export function createStandaloneRuntime(options) {
     return new StandaloneRuntime(options);
 }
+/**
+ * 独立二进制进程入口适配器。
+ * 仅在命令行可执行入口调用，负责全局 SIGINT 监听与退出状态码写入。
+ */
+export async function runStandaloneProcess(argv, options) {
+    const controller = new AbortController();
+    const control = {
+        signal: controller.signal,
+    };
+    let sigintCount = 0;
+    const sigintHandler = () => {
+        sigintCount++;
+        if (sigintCount === 1) {
+            control.cancellationSource = "sigint";
+            controller.abort(new Error("Interrupted by SIGINT"));
+        }
+        else {
+            process.exitCode = 130;
+            process.exit(130);
+        }
+    };
+    process.on("SIGINT", sigintHandler);
+    try {
+        const dispatcher = new StandaloneDispatcher(options);
+        const exitCode = await dispatcher.dispatch(argv, control);
+        process.exitCode = exitCode;
+    }
+    finally {
+        process.removeListener("SIGINT", sigintHandler);
+    }
+}

package/dist/schema/index.d.ts

@@ -0,0 +1 @@
+export * from "./validator.js";

package/dist/schema/index.js

@@ -0,0 +1 @@
+export * from "./validator.js";