@actiondock/core 2.10.0 → 2.12.0

package/dist/runtime/standalone.js

@@ -1,11 +1,8 @@
-import { decodeStateKey } from "@actiondock/sdk";
-import { filterWithFallbackInfo } from "../filter/index.js";
 import { createActionDock } from "../service/factory.js";
-import { STANDALONE_ASYNC_UNSUPPORTED, resolveExecutionHint, } from "../errors.js";
-import { resolveActionInput, formatActionDetail, buildActionDescribePayload, mapInputValidationFailure, } from "../input/index.js";
-import { validateActionInputValue } from "../json/value-validator.js";
+import { STANDALONE_ASYNC_UNSUPPORTED } from "../errors.js";
 import { normalizeActionCollection } from "./action-collection.js";
-import { parseDuration } from "../utils/index.js";
+import { parseStandaloneArgs, printHelp, emitError } from "./standalone-help.js";
+import { handleList, handleDescribe, handleRun, handleConfig, handleState, } from "./standalone-commands.js";
 /**
  * 退出状态码常量。
  */
@@ -45,43 +42,10 @@ export class StandaloneDispatcher {
             console.error(msg);
         }
     }
-    /**
-     * 统一错误输出辅助方法。
-     *
-     * 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;
-            const hint = options?.hint ??
-                (details && typeof details === "object" && typeof details.hint === "string"
-                    ? details.hint
-                    : undefined);
-            this.writeOut(JSON.stringify({
-                ok: false,
-                error: {
-                    code,
-                    message,
-                    ...(details !== undefined ? { details } : {}),
-                },
-                ...(hint !== undefined ? { hint } : {}),
-            }, null, 2));
-        }
-        else {
-            this.writeErr(options?.textMessage ?? `Error: ${message}`);
-        }
-        return exitCode;
+        return emitError(this.writeOut.bind(this), this.writeErr.bind(this), isJson, code, message, exitCode, options);
     }
-    async createLocalService(dataDir, configOverrides = {}) {
+    async createLocalService(dataDir, configOverrides = {}, accessMode = "owner") {
         if (this.options.service) {
             return { service: this.options.service, ownsService: false };
         }
@@ -109,6 +73,9 @@ export class StandaloneDispatcher {
         };
         const service = await createActionDock({
             runtimeOptions,
+            // 发现入口使用旁观初始化：不创建数据库、不取目录锁、不收割遗留运行记录；
+            // 执行与写入入口继续持有者初始化（默认 recoverOrphans 语义）
+            ...(accessMode === "observer" ? { recoverOrphans: false } : {}),
         });
         if (this.options.inMemory) {
             this.options._sharedService = service;
@@ -116,6 +83,13 @@ export class StandaloneDispatcher {
         }
         return { service, ownsService: true };
     }
+    printHelp() {
+        printHelp(this.writeOut.bind(this), {
+            packageId: this.options.packageId,
+            version: this.options.version,
+            description: this.options.description,
+        });
+    }
     /**
      * 解析命令行参数并分发执行对应子命令。
      *
@@ -124,39 +98,7 @@ export class StandaloneDispatcher {
      * @returns 退出状态码（0: 成功, 1: 失败, 2: 参数错误, 130: 中断）
      */
     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）仅从 controlArgs 中解析
-        const filteredArgs = [];
-        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 < controlArgs.length) {
-                const pair = controlArgs[++i];
-                const [k, ...v] = pair.split("=");
-                if (k)
-                    configOverrides[k] = v.join("=");
-            }
-            else if (arg.startsWith("--config=")) {
-                const pair = arg.slice(9);
-                const [k, ...v] = pair.split("=");
-                if (k)
-                    configOverrides[k] = v.join("=");
-            }
-            else {
-                filteredArgs.push(arg);
-            }
-        }
-        const command = filteredArgs[0] || "help";
-        const subArgs = filteredArgs.slice(1);
+        const { controlArgs, actionArgs, dataDir, configOverrides, command, subArgs, } = parseStandaloneArgs(argv);
         // 2. 独立入口拒绝异步启动语义
         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, {
@@ -175,7 +117,10 @@ export class StandaloneDispatcher {
         let service;
         let ownsService = false;
         try {
-            const serviceRes = await this.createLocalService(dataDir, configOverrides);
+            // 复用既有命令分发结果确定访问性质：发现命令（list/describe）为旁观；
+            // 执行与写入命令（run/config/state）为持有者
+            const accessMode = command === "list" || command === "describe" || command === "show" ? "observer" : "owner";
+            const serviceRes = await this.createLocalService(dataDir, configOverrides, accessMode);
             service = serviceRes.service;
             ownsService = serviceRes.ownsService;
         }
@@ -183,24 +128,31 @@ export class StandaloneDispatcher {
             this.writeErr(`Error initializing standalone service: ${err?.message || err}`);
             return ExitCode.FAILURE;
         }
+        const ctx = {
+            service,
+            options: this.options,
+            writeOut: this.writeOut.bind(this),
+            writeErr: this.writeErr.bind(this),
+            emitError: this.emitError.bind(this),
+        };
         try {
             let code;
             switch (command) {
                 case "list":
-                    code = await this.handleList(service, subArgs);
+                    code = await handleList(ctx, subArgs);
                     break;
                 case "describe":
                 case "show":
-                    code = await this.handleDescribe(service, subArgs);
+                    code = await handleDescribe(ctx, subArgs);
                     break;
                 case "run":
-                    code = await this.handleRun(service, subArgs, actionArgs, control?.signal);
+                    code = await handleRun(ctx, subArgs, actionArgs, control?.signal);
                     break;
                 case "config":
-                    code = await this.handleConfig(service, subArgs);
+                    code = await handleConfig(ctx, subArgs);
                     break;
                 case "state":
-                    code = await this.handleState(service, subArgs);
+                    code = await handleState(ctx, subArgs);
                     break;
                 default:
                     this.writeErr(`Unknown command: '${command}'`);
@@ -226,499 +178,6 @@ export class StandaloneDispatcher {
             }
         }
     }
-    async handleList(service, subArgs) {
-        const isJson = subArgs.includes("--json");
-        const noFallback = subArgs.includes("--no-fallback");
-        let intent;
-        const positionalPatterns = [];
-        for (let i = 0; i < subArgs.length; i++) {
-            const arg = subArgs[i];
-            if (arg === "--intent" || arg === "-i") {
-                if (i + 1 < subArgs.length)
-                    intent = subArgs[++i];
-            }
-            else if (arg.startsWith("--intent=")) {
-                intent = arg.slice(9);
-            }
-            else if (arg.startsWith("-i=")) {
-                intent = arg.slice(3);
-            }
-            else if (!arg.startsWith("-")) {
-                positionalPatterns.push(arg);
-            }
-        }
-        const effectiveIntent = intent || (positionalPatterns.length > 0 ? positionalPatterns.join("|") : undefined);
-        const actions = await service.discovery.listActions();
-        const list = actions.map((a) => ({
-            id: a.id,
-            description: a.description || "",
-        }));
-        const filterRes = filterWithFallbackInfo(list, effectiveIntent, [(a) => a.id, (a) => a.description], !noFallback);
-        const hints = [
-            "Tip: For composite or multi-step tasks, check 'ad playbook list' for standard operating procedures.",
-        ];
-        if (isJson) {
-            this.writeOut(JSON.stringify({ items: filterRes.items, hints }, null, 2));
-        }
-        else {
-            let text = `Actions in ${this.options.packageId} (v${this.options.version}):\n\n`;
-            for (const a of filterRes.items) {
-                text += `  ${a.id.padEnd(28)} ${a.description}\n`;
-            }
-            this.writeOut(text.trimEnd());
-        }
-        return ExitCode.SUCCESS;
-    }
-    async handleDescribe(service, subArgs) {
-        const id = subArgs.find((a) => !a.startsWith("-"));
-        const isJson = subArgs.includes("--json");
-        if (!id) {
-            return this.emitError(isJson, "INVALID_ARGUMENT", "Action ID is required for describe", ExitCode.INVALID_ARGUMENT);
-        }
-        let action;
-        try {
-            action = await service.discovery.describeAction(id);
-        }
-        catch {
-            const hint = "Tip: Run 'ad list' to discover available actions.";
-            return this.emitError(isJson, "INVALID_ARGUMENT", `Action '${id}' not found`, ExitCode.INVALID_ARGUMENT, {
-                textMessage: `Error: Action '${id}' not found\n${hint}`,
-                hint,
-            });
-        }
-        const payload = buildActionDescribePayload(action, {
-            packageId: this.options.packageId,
-        });
-        if (isJson) {
-            this.writeOut(JSON.stringify(payload, null, 2));
-        }
-        else {
-            this.writeOut(formatActionDetail(payload));
-        }
-        return ExitCode.SUCCESS;
-    }
-    async handleRun(service, subArgs, actionArgs, signal) {
-        const isJson = subArgs.includes("--json");
-        const id = subArgs.find((a) => !a.startsWith("-"));
-        if (!id) {
-            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 inputStr;
-        let inputFile;
-        let timeoutMs;
-        const recognizedFlags = new Set(["--json", "--async"]);
-        for (let i = 0; i < subArgs.length; i++) {
-            const arg = subArgs[i];
-            if (arg === id || recognizedFlags.has(arg)) {
-                continue;
-            }
-            if (arg === "--timeout" && i + 1 < subArgs.length) {
-                try {
-                    timeoutMs = parseDuration(subArgs[++i]);
-                }
-                catch (err) {
-                    return this.emitError(isJson, "INVALID_ARGUMENT", `Invalid timeout format: ${err?.message || err}`, ExitCode.INVALID_ARGUMENT);
-                }
-            }
-            else if (arg.startsWith("--timeout=")) {
-                try {
-                    timeoutMs = parseDuration(arg.slice(10));
-                }
-                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 === "-i" && i + 1 < subArgs.length) {
-                inputStr = subArgs[++i];
-            }
-            else if (arg.startsWith("-i=")) {
-                inputStr = arg.slice(3);
-            }
-            else if (arg === "--input-file" && i + 1 < subArgs.length) {
-                inputFile = subArgs[++i];
-            }
-            else if (arg.startsWith("--input-file=")) {
-                inputFile = arg.slice(13);
-            }
-            else if (arg === "-f" && i + 1 < subArgs.length) {
-                inputFile = subArgs[++i];
-            }
-            else if (arg.startsWith("-f=")) {
-                inputFile = arg.slice(3);
-            }
-            else if (arg.startsWith("-")) {
-                const hint = "Hint: Separate action inputs from CLI options using '--', e.g.: ad run <id> [options] -- <param>=<val> or <param>:=<json>.";
-                return this.emitError(isJson, "INVALID_ARGUMENT", `error: unknown option '${arg}'`, ExitCode.INVALID_ARGUMENT, {
-                    textMessage: `error: unknown option '${arg}'\n${hint}`,
-                    hint,
-                });
-            }
-        }
-        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);
-            }
-        }
-        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,
-        });
-        if (isJson) {
-            if (!result.ok) {
-                const hint = resolveExecutionHint(id, result.error);
-                const machineOutput = hint !== undefined ? { ...result, hint } : result;
-                this.writeOut(JSON.stringify(machineOutput, null, 2));
-            }
-            else {
-                this.writeOut(JSON.stringify(result, null, 2));
-            }
-        }
-        else {
-            if (result.ok) {
-                const data = result.data;
-                let rawText;
-                let metaInfo;
-                if (typeof data === "string") {
-                    rawText = data;
-                }
-                else if (data !== null && typeof data === "object") {
-                    if ("content" in data && data.content !== undefined) {
-                        rawText =
-                            typeof data.content === "object" && data.content !== null
-                                ? JSON.stringify(data.content, null, 2)
-                                : String(data.content);
-                        const { content, ...rest } = data;
-                        if (Object.keys(rest).length > 0) {
-                            metaInfo = rest;
-                        }
-                    }
-                    else if ("text" in data && typeof data.text === "string") {
-                        rawText = data.text;
-                        const { text, ...rest } = data;
-                        if (Object.keys(rest).length > 0) {
-                            metaInfo = rest;
-                        }
-                    }
-                    else if ("message" in data && typeof data.message === "string") {
-                        rawText = data.message;
-                        const { message, ...rest } = data;
-                        if (Object.keys(rest).length > 0) {
-                            metaInfo = rest;
-                        }
-                    }
-                    else {
-                        rawText = JSON.stringify(data, null, 2);
-                    }
-                }
-                else if (data !== undefined) {
-                    rawText = String(data);
-                }
-                else {
-                    rawText = "";
-                }
-                if (metaInfo) {
-                    const parts = [];
-                    const title = metaInfo.path ? String(metaInfo.path) : id;
-                    parts.push(title);
-                    if (metaInfo.startLine !== undefined && metaInfo.endLine !== undefined) {
-                        parts.push(`lines ${metaInfo.startLine}-${metaInfo.endLine}`);
-                    }
-                    else if (metaInfo.line !== undefined) {
-                        parts.push(`line ${metaInfo.line}`);
-                    }
-                    if (metaInfo.hasMore !== undefined) {
-                        parts.push(`hasMore: ${metaInfo.hasMore}`);
-                    }
-                    if (metaInfo.truncated) {
-                        parts.push("truncated: true");
-                    }
-                    const handled = new Set(["path", "startLine", "endLine", "line", "hasMore", "truncated"]);
-                    for (const [k, v] of Object.entries(metaInfo)) {
-                        if (!handled.has(k) && v !== undefined) {
-                            parts.push(`${k}: ${typeof v === "object" ? JSON.stringify(v) : v}`);
-                        }
-                    }
-                    if (parts.length > 0) {
-                        this.writeErr(`[${parts.join(" | ")}]`);
-                    }
-                }
-                this.writeOut(rawText);
-            }
-            else {
-                this.writeErr(`Error [${result.error.code}]: ${result.error.message}`);
-                if (result.error.details) {
-                    this.writeErr(typeof result.error.details === "string"
-                        ? result.error.details
-                        : JSON.stringify(result.error.details, null, 2));
-                }
-                const hint = resolveExecutionHint(id, result.error);
-                if (hint) {
-                    this.writeErr(hint);
-                }
-            }
-        }
-        return result.ok ? ExitCode.SUCCESS : ExitCode.FAILURE;
-    }
-    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 service.management.config.list(this.options.packageId);
-            const dict = {};
-            for (const v of views) {
-                if (v.configured && v.value !== undefined) {
-                    dict[v.key] = v.value;
-                }
-            }
-            this.writeOut(JSON.stringify(dict, null, 2));
-            return ExitCode.SUCCESS;
-        }
-        if (sub === "get") {
-            const key = subArgs[1];
-            if (!key) {
-                this.writeErr("Error: config key required");
-                return ExitCode.INVALID_ARGUMENT;
-            }
-            try {
-                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.isServiceCapabilityError(err)) {
-                    this.writeOut("undefined");
-                    return ExitCode.SUCCESS;
-                }
-                // 内部异常严禁吞没：透传 stderr 并以 FAILURE 退出码暴露
-                this.writeErr(`Error reading config '${key}': ${err?.message || String(err)}`);
-                return ExitCode.FAILURE;
-            }
-        }
-        if (sub === "set") {
-            const key = subArgs[1];
-            const rawVal = subArgs[2];
-            if (!key || rawVal === undefined) {
-                this.writeErr("Error: key and value required");
-                return ExitCode.INVALID_ARGUMENT;
-            }
-            let parsed = rawVal;
-            try {
-                parsed = JSON.parse(rawVal);
-            }
-            catch {
-                parsed = rawVal;
-            }
-            await service.management.config.set(this.options.packageId, key, parsed);
-            this.writeOut(`Config '${key}' updated`);
-            return ExitCode.SUCCESS;
-        }
-        if (sub === "delete") {
-            const key = subArgs[1];
-            if (!key) {
-                this.writeErr("Error: config key required");
-                return ExitCode.INVALID_ARGUMENT;
-            }
-            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(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];
-            }
-            else if (subArgs[i].startsWith("--namespace=")) {
-                namespace = subArgs[i].slice(12);
-            }
-            else if (subArgs[i] === "-a" || subArgs[i] === "--all") {
-                isAll = true;
-            }
-            else if (subArgs[i] === "--json") {
-                isJson = true;
-            }
-        }
-        if (sub === "list") {
-            const prefix = subArgs[1] && !subArgs[1].startsWith("-") ? subArgs[1] : "";
-            const keys = await service.management.state.list(this.options.packageId, "", {
-                namespace,
-                prefix: prefix || undefined,
-                all: isAll,
-            });
-            this.writeOut(JSON.stringify(keys, null, 2));
-            return ExitCode.SUCCESS;
-        }
-        if (sub === "get") {
-            const key = subArgs[1] && !subArgs[1].startsWith("-") ? subArgs[1] : subArgs[2];
-            if (!key) {
-                this.writeErr("Error: state key required");
-                return ExitCode.INVALID_ARGUMENT;
-            }
-            let ns = namespace;
-            let actualKey = key;
-            if (ns === undefined) {
-                const decoded = this.decodeStateKeyArg(key);
-                ns = decoded.namespace || undefined;
-                actualKey = decoded.key;
-            }
-            const val = await service.management.state.get(this.options.packageId, "", actualKey, { namespace: ns });
-            if (isJson) {
-                this.writeOut(JSON.stringify({ key, value: val }, null, 2));
-            }
-            else {
-                this.writeOut(val !== undefined ? JSON.stringify(val) : "undefined");
-            }
-            return ExitCode.SUCCESS;
-        }
-        if (sub === "set") {
-            const key = subArgs[1];
-            const rawVal = subArgs[2];
-            if (!key || rawVal === undefined) {
-                this.writeErr("Error: key and value required");
-                return ExitCode.INVALID_ARGUMENT;
-            }
-            let ns = namespace || "";
-            let actualKey = key;
-            if (namespace === undefined) {
-                const decoded = this.decodeStateKeyArg(key);
-                ns = decoded.namespace;
-                actualKey = decoded.key;
-            }
-            let parsed = rawVal;
-            try {
-                parsed = JSON.parse(rawVal);
-            }
-            catch {
-                parsed = rawVal;
-            }
-            let ttl;
-            for (let i = 3; i < subArgs.length; i++) {
-                if (subArgs[i] === "--ttl" && i + 1 < subArgs.length) {
-                    ttl = parseInt(subArgs[++i], 10);
-                }
-                else if (subArgs[i].startsWith("--ttl=")) {
-                    ttl = parseInt(subArgs[i].slice(6), 10);
-                }
-            }
-            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;
-        }
-        if (sub === "delete" || sub === "rm") {
-            const key = subArgs[1] && !subArgs[1].startsWith("-") ? subArgs[1] : subArgs[2];
-            if (!key) {
-                this.writeErr("Error: state key required");
-                return ExitCode.INVALID_ARGUMENT;
-            }
-            const deleted = await service.management.state.delete(this.options.packageId, "", key, { namespace });
-            if (deleted) {
-                this.writeOut(`State '${key}' deleted`);
-                return ExitCode.SUCCESS;
-            }
-            this.writeErr(`Error: State key '${key}' not found`);
-            return ExitCode.FAILURE;
-        }
-        if (sub === "clear" || sub === "clean") {
-            const prefix = subArgs[1] && !subArgs[1].startsWith("-") ? subArgs[1] : "";
-            const count = await service.management.state.clear(this.options.packageId, "", {
-                namespace,
-                all: isAll,
-                prefix: prefix || undefined,
-            });
-            this.writeOut(`Cleared ${count} state entry(s)`);
-            return ExitCode.SUCCESS;
-        }
-        this.writeErr(`Unknown state subcommand: '${sub}'`);
-        return ExitCode.INVALID_ARGUMENT;
-    }
-    /**
-     * 判定配置读取异常是否为服务能力缺失（键未配置语义）而非内部故障。
-     */
-    isServiceCapabilityError(err) {
-        const code = String(err?.code || "");
-        return (code === "CAPABILITY_UNAVAILABLE" ||
-            code === "TARGET_CAPABILITY_UNAVAILABLE");
-    }
-    /**
-     * 解析携带命名空间前缀的状态键参数：委托 sdk 单一事实源 decodeStateKey。
-     *
-     * 解析失败（如存在多个未转义冒号的歧义键）时按纯键处理，交由存储层兜底。
-     */
-    decodeStateKeyArg(key) {
-        try {
-            return decodeStateKey(key);
-        }
-        catch {
-            return { namespace: "", key };
-        }
-    }
-    printHelp() {
-        this.writeOut(`${this.options.packageId} (v${this.options.version})`);
-        if (this.options.description)
-            this.writeOut(`${this.options.description}\n`);
-        this.writeOut("Usage:");
-        this.writeOut("  <cmd> list [--json]                         List available actions");
-        this.writeOut("  <cmd> describe <id> [--json]                Show action details and schemas");
-        this.writeOut("  <cmd> run <id> [--input '<json>']           Execute action (raw text output by default)");
-        this.writeOut("  <cmd> run <id> [--json]                     Output standard execution result in JSON format");
-        this.writeOut("  <cmd> config list/get/set/delete            Manage package configuration");
-        this.writeOut("  <cmd> state list/get/set/delete             Manage shared state store");
-        this.writeOut("\nGlobal options:");
-        this.writeOut("  --data-dir <path>                           Custom runtime database directory");
-        this.writeOut("  --config <KEY=val>                          Temporary config override");
-    }
-}
-export class StandaloneRuntime {
-    dispatcher;
-    constructor(options) {
-        this.dispatcher = new StandaloneDispatcher(options);
-    }
-    async run(argv) {
-        const code = await this.dispatcher.dispatch(argv);
-        if (code !== ExitCode.SUCCESS && code !== ExitCode.FAILURE) {
-            process.exit(code);
-        }
-    }
-}
-/**
- * 工厂函数：创建独立运行时实例。
- */
-export function createStandaloneRuntime(options) {
-    return new StandaloneRuntime(options);
 }
 /**
  * 独立二进制进程入口适配器。

package/dist/schema/validator.d.ts

@@ -10,9 +10,9 @@ export interface ValidationResult {
 }
 /**
  * 递归检查数据中是否包含危险的原型污染属性键名（__proto__、constructor、prototype）。
- * 内部委托 validateActionInputValue 执行迭代遍历，确保环路安全、有向无环图安全且无调用栈溢出风险。
  */
-export declare function hasDangerousKeys(data: unknown): boolean;
+import { hasDangerousKeys } from "../value-validator.js";
+export { hasDangerousKeys };
 /**
  * 内部纯 Schema 校验器。
  * 仅处理布尔 Schema 与 Ajv 规则校验，严禁执行 dangerous-key 遍历。