@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/input/help.js

@@ -0,0 +1,51 @@
+/*
+ * 帮助文本生成。内置命令来自命令表，插件命令来自注册表。
+ */
+import { BUILTIN_COMMANDS, findBuiltin } from "./commands.js";
+export function formatGlobalHelp(pluginCommands) {
+    const lines = [];
+    lines.push("Wellspring 源泉 —— 聚合式 Agent 平台");
+    lines.push("");
+    lines.push("用法：wellspring <command> [args] [options]");
+    lines.push("");
+    lines.push("命令：");
+    for (const spec of BUILTIN_COMMANDS) {
+        lines.push(`  ${spec.name.padEnd(9)} ${spec.summary}`);
+    }
+    if (pluginCommands.length > 0) {
+        lines.push("");
+        lines.push("插件命令：");
+        for (const command of pluginCommands) {
+            lines.push(`  ${command.name.padEnd(9)} ${command.summary}（来自 ${command.plugin}）`);
+        }
+    }
+    lines.push("");
+    lines.push("全局参数：");
+    lines.push("  -c, --config <file>    指定配置文件");
+    lines.push("  --home <dir>           便携模式根目录");
+    lines.push("  -l, --log-level <level> 日志级别");
+    lines.push("  --json                 机器可读输出");
+    lines.push("  -q, --quiet            静默");
+    lines.push("  -h, --help             帮助");
+    lines.push("  -v, --version          版本");
+    lines.push("");
+    lines.push('示例：wellspring chat "解释一下 EventBus"');
+    lines.push('      wellspring run --session-id 20261021-173000-ab12 "读取 package.json"');
+    return lines.join("\n");
+}
+export function formatCommandHelp(name, pluginCommand) {
+    const spec = findBuiltin(name);
+    if (spec !== undefined) {
+        return [`用法：${spec.usage}`, "", spec.summary].join("\n");
+    }
+    if (pluginCommand !== undefined) {
+        return [
+            `用法：${pluginCommand.usage}`,
+            "",
+            pluginCommand.summary,
+            `来自插件：${pluginCommand.plugin}`,
+        ].join("\n");
+    }
+    return null;
+}
+//# sourceMappingURL=help.js.map

package/dist/input/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/input/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAS7D,MAAM,UAAU,gBAAgB,CAAC,cAA4C;IACzE,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAA;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;IACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjB,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IAC1D,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;QACtF,CAAC;IACL,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnB,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;IAC7C,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;IAC9C,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAC5C,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;IAC7C,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;IACzC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;IACzC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;IACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;IAChD,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAA;IACtF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,aAAiC;IAC7E,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5D,CAAC;IACD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACH,MAAM,aAAa,CAAC,KAAK,EAAE;YAC3B,EAAE;YACF,aAAa,CAAC,OAAO;YACrB,QAAQ,aAAa,CAAC,MAAM,EAAE;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC"}

package/dist/input/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./codes.js";
+export * from "./commands.js";
+export * from "./help.js";
+export * from "./parse-options.js";
+export * from "./parse.js";
+export * from "./types.js";

package/dist/input/index.js

@@ -0,0 +1,10 @@
+/*
+ * 入参层入口。
+ */
+export * from "./codes.js";
+export * from "./commands.js";
+export * from "./help.js";
+export * from "./parse-options.js";
+export * from "./parse.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/input/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/input/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/input/parse-options.d.ts

@@ -0,0 +1,11 @@
+import { type ParseArgsOptionsConfig } from "node:util";
+import { Result } from "../api/result/result.js";
+export type CommandValues = Readonly<Record<string, string | boolean | undefined>>;
+export interface ParsedCommandLine {
+    readonly values: CommandValues;
+    readonly positionals: readonly string[];
+}
+export declare function parseCommandArgs(argv: readonly string[], options: ParseArgsOptionsConfig): Result<ParsedCommandLine>;
+/** 把 unknown 值转成字符串参数 */
+export declare function stringValue(values: CommandValues, name: string): string | undefined;
+export declare function booleanValue(values: CommandValues, name: string): boolean;

package/dist/input/parse-options.js

@@ -0,0 +1,51 @@
+/*
+ * 命令级参数解析。
+ * 统一走 node:util parseArgs，未知参数严格报错并映射为 usage.* 错误码。
+ */
+import { parseArgs } from "node:util";
+import { Result } from "../api/result/result.js";
+import { USAGE_CODES, usageCode } from "./codes.js";
+function optionName(message) {
+    const match = /(--?[A-Za-z][\w-]*)/.exec(message);
+    return match?.[1];
+}
+function mapParseError(error) {
+    const candidate = error;
+    const message = candidate.message ?? "";
+    switch (candidate.code) {
+        case "ERR_PARSE_ARGS_UNKNOWN_OPTION":
+            return usageCode(USAGE_CODES.unknownOption, optionName(message));
+        case "ERR_PARSE_ARGS_MISSING_OPTION_ARG":
+            return usageCode(USAGE_CODES.missingValue, optionName(message));
+        case "ERR_PARSE_ARGS_INVALID_OPTION_VALUE":
+            return usageCode(USAGE_CODES.invalidValue, optionName(message));
+        default:
+            return usageCode(USAGE_CODES.invalidValue);
+    }
+}
+export function parseCommandArgs(argv, options) {
+    try {
+        const parsed = parseArgs({
+            args: [...argv],
+            options,
+            strict: true,
+            allowPositionals: true,
+        });
+        return Result.successWithData({
+            values: parsed.values,
+            positionals: parsed.positionals,
+        });
+    }
+    catch (error) {
+        return Result.error(mapParseError(error));
+    }
+}
+/** 把 unknown 值转成字符串参数 */
+export function stringValue(values, name) {
+    const value = values[name];
+    return typeof value === "string" ? value : undefined;
+}
+export function booleanValue(values, name) {
+    return values[name] === true;
+}
+//# sourceMappingURL=parse-options.js.map

package/dist/input/parse-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-options.js","sourceRoot":"","sources":["../../src/input/parse-options.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAA+B,MAAM,WAAW,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AASnD,SAAS,UAAU,CAAC,OAAe;IAC/B,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;AACrB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACjC,MAAM,SAAS,GAAG,KAA4C,CAAA;IAC9D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,EAAE,CAAA;IACvC,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,+BAA+B;YAChC,OAAO,SAAS,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QACpE,KAAK,mCAAmC;YACpC,OAAO,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QACnE,KAAK,qCAAqC;YACtC,OAAO,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QACnE;YACI,OAAO,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAClD,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC5B,IAAuB,EACvB,OAA+B;IAE/B,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC;YACrB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACf,OAAO;YACP,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,IAAI;SACzB,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,eAAe,CAAoB;YAC7C,MAAM,EAAE,MAAM,CAAC,MAAuB;YACtC,WAAW,EAAE,MAAM,CAAC,WAAW;SAClC,CAAC,CAAA;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,KAAK,CAAoB,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;IAChE,CAAC;AACL,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,WAAW,CAAC,MAAqB,EAAE,IAAY;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqB,EAAE,IAAY;IAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;AAChC,CAAC"}

package/dist/input/parse.d.ts

@@ -0,0 +1,3 @@
+import { Result } from "../api/result/result.js";
+import type { ParsedGlobal } from "./types.js";
+export declare function parseGlobal(argv: readonly string[]): Result<ParsedGlobal>;

package/dist/input/parse.js

@@ -0,0 +1,119 @@
+/*
+ * 全局参数解析。
+ * 遇到第一个位置参数（命令名）即停止解析，其余原样交给命令或插件。
+ */
+import { parseArgs } from "node:util";
+import { Result } from "../api/result/result.js";
+import { USAGE_CODES, usageCode } from "./codes.js";
+const LEVELS = new Set([
+    "fatal",
+    "error",
+    "warn",
+    "info",
+    "debug",
+    "trace",
+    "silent",
+]);
+function optionName(message) {
+    const match = /(--?[A-Za-z][\w-]*)/.exec(message);
+    return match?.[1];
+}
+function mapParseError(error) {
+    const candidate = error;
+    const message = candidate.message ?? "";
+    switch (candidate.code) {
+        case "ERR_PARSE_ARGS_UNKNOWN_OPTION":
+            return usageCode(USAGE_CODES.unknownOption, optionName(message));
+        case "ERR_PARSE_ARGS_MISSING_OPTION_ARG":
+            return usageCode(USAGE_CODES.missingValue, optionName(message));
+        case "ERR_PARSE_ARGS_INVALID_OPTION_VALUE":
+            return usageCode(USAGE_CODES.invalidValue, optionName(message));
+        default:
+            return usageCode(USAGE_CODES.invalidValue);
+    }
+}
+function text(value) {
+    return typeof value === "string" ? value : undefined;
+}
+const VALUE_OPTIONS = new Set([
+    "-c",
+    "--config",
+    "--home",
+    "-l",
+    "--log-level",
+]);
+/** 手工切出全局参数前缀：遇到第一个位置参数（命令名）即停止，后续 token 全部原样保留 */
+function splitGlobalPrefix(argv) {
+    const globalArgs = [];
+    let index = 0;
+    while (index < argv.length) {
+        const token = argv[index];
+        if (token === undefined) {
+            break;
+        }
+        if (token === "--") {
+            index += 1;
+            break;
+        }
+        if (!token.startsWith("-") || token === "-") {
+            break;
+        }
+        globalArgs.push(token);
+        const equals = token.indexOf("=");
+        const name = equals === -1 ? token : token.slice(0, equals);
+        if (VALUE_OPTIONS.has(name) && equals === -1) {
+            const value = argv[index + 1];
+            if (value !== undefined) {
+                globalArgs.push(value);
+                index += 2;
+                continue;
+            }
+        }
+        index += 1;
+    }
+    const command = argv[index] ?? null;
+    return {
+        globalArgs,
+        command,
+        commandArgv: index < argv.length ? [...argv.slice(index + 1)] : [],
+    };
+}
+export function parseGlobal(argv) {
+    const { globalArgs, command, commandArgv } = splitGlobalPrefix(argv);
+    let values;
+    try {
+        const parsed = parseArgs({
+            args: globalArgs,
+            options: {
+                config: { type: "string", short: "c" },
+                home: { type: "string" },
+                "log-level": { type: "string", short: "l" },
+                json: { type: "boolean" },
+                quiet: { type: "boolean", short: "q" },
+                help: { type: "boolean", short: "h" },
+                version: { type: "boolean", short: "v" },
+            },
+            strict: true,
+            allowPositionals: false,
+        });
+        values = parsed.values;
+    }
+    catch (error) {
+        return Result.error(mapParseError(error));
+    }
+    const rawLevel = text(values["log-level"]);
+    if (rawLevel !== undefined && !LEVELS.has(rawLevel)) {
+        return Result.error(usageCode(USAGE_CODES.invalidValue, "--log-level"));
+    }
+    const options = {
+        config: text(values["config"]),
+        home: text(values["home"]),
+        logLevel: rawLevel,
+        json: values["json"] === true,
+        quiet: values["quiet"] === true,
+        help: values["help"] === true,
+        version: values["version"] === true,
+    };
+    return Result.successWithData({ options, command, commandArgv });
+}
+//# sourceMappingURL=parse.js.map

package/dist/input/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/input/parse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAIrC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGnD,MAAM,MAAM,GAAwB,IAAI,GAAG,CAAkB;IACzD,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;CACX,CAAC,CAAA;AAEF,SAAS,UAAU,CAAC,OAAe;IAC/B,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;AACrB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACjC,MAAM,SAAS,GAAG,KAA4C,CAAA;IAC9D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,EAAE,CAAA;IACvC,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,+BAA+B;YAChC,OAAO,SAAS,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QACpE,KAAK,mCAAmC;YACpC,OAAO,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QACnE,KAAK,qCAAqC;YACtC,OAAO,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;QACnE;YACI,OAAO,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAClD,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,KAA0D;IACpE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACxD,CAAC;AAED,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC;IAC/C,IAAI;IACJ,UAAU;IACV,QAAQ;IACR,IAAI;IACJ,aAAa;CAChB,CAAC,CAAA;AAEF,mDAAmD;AACnD,SAAS,iBAAiB,CAAC,IAAuB;IAK9C,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAK;QACT,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,KAAK,IAAI,CAAC,CAAA;YACV,MAAK;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAC1C,MAAK;QACT,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QAC3D,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;YAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACtB,KAAK,IAAI,CAAC,CAAA;gBACV,SAAQ;YACZ,CAAC;QACL,CAAC;QACD,KAAK,IAAI,CAAC,CAAA;IACd,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAA;IACnC,OAAO;QACH,UAAU;QACV,OAAO;QACP,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;KACrE,CAAA;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAuB;IAC/C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACpE,IAAI,MAA2E,CAAA;IAC/E,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE;gBACL,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;gBACtC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;gBAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;gBACtC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;gBACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;aAC3C;YACD,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,KAAK;SAC1B,CAAC,CAAA;QACF,MAAM,GAAG,MAAM,CAAC,MAAuB,CAAA;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,KAAK,CAAe,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IAC1C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,KAAK,CAAe,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAA;IACzF,CAAC;IAED,MAAM,OAAO,GAAkB;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,QAAQ,EAAE,QAAuC;QACjD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI;QAC7B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI;QAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI;QAC7B,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI;KACtC,CAAA;IACD,OAAO,MAAM,CAAC,eAAe,CAAe,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAA;AAClF,CAAC"}

package/dist/input/types.d.ts

@@ -0,0 +1,17 @@
+import type { LevelWithSilent } from "pino";
+export interface GlobalOptions {
+    readonly config?: string;
+    readonly home?: string;
+    readonly logLevel?: LevelWithSilent;
+    readonly json: boolean;
+    readonly quiet: boolean;
+    readonly help: boolean;
+    readonly version: boolean;
+}
+export interface ParsedGlobal {
+    readonly options: GlobalOptions;
+    /** 命令名；没有子命令时为 null */
+    readonly command: string | null;
+    /** 命令名之后的原始参数，原样交给命令或插件 */
+    readonly commandArgv: readonly string[];
+}

package/dist/input/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/input/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/input/types.ts"],"names":[],"mappings":""}

package/dist/logger/elog4js.d.ts

@@ -0,0 +1,65 @@
+export type ElogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+export interface ElogStream {
+    write(text: string): unknown;
+}
+export interface ElogOptions {
+    readonly stdout?: ElogStream;
+    readonly stderr?: ElogStream;
+    /** 未指定时按 TTY 与 NO_COLOR 自动判断 */
+    readonly color?: boolean;
+    readonly json?: boolean;
+}
+export declare class Elog {
+    #private;
+    constructor(options?: ElogOptions);
+    setJson(json: boolean): void;
+    isJson(): boolean;
+    setSessionName(name: string): void;
+    getSessionName(): string;
+    setColor(color: boolean): void;
+    /** 普通信息，stdout */
+    info(text: string): void;
+    /** 成功信息，stdout */
+    success(text: string): void;
+    debug(text: string): void;
+    warn(text: string): void;
+    error(text: string): void;
+    /** Agent 输出前缀 */
+    agentStart(): void;
+    /** Agent 输出行 */
+    agent(text: string): void;
+    /** 步骤分隔行 */
+    step(step: number, total?: number): void;
+    /** 操作请求块 */
+    action(title: string, rows: readonly {
+        readonly label: string;
+        readonly value: string;
+        readonly code?: boolean;
+    }[]): void;
+    /** 工具调用行：换行后单独一行显示中文动作名与参数摘要 */
+    toolCall(label: string, summary?: string): void;
+    /** 工具结果/错误行：缩进在工具调用下面 */
+    toolResult(text: string): void;
+    /** 操作结果行 */
+    actionStatus(name: string, status: string): void;
+    /** 只带级别标签，不再拼插件名 */
+    tag(level: ElogLevel, text: string): void;
+    /** 插件输出：`[LEVEL] [plugin] message` */
+    plugin(level: ElogLevel, pluginName: string, message: string): void;
+    /** 流式写正文，不加换行与标签 */
+    stream(text: string): void;
+    /** 结束当前流式行 */
+    line(): void;
+    /** 提示行，stderr，无级别标签 */
+    notice(text: string): void;
+    /** 纯文本行，stdout */
+    print(text?: string): void;
+    /** 清屏，仅 TTY 有效 */
+    clear(): void;
+}
+/** 初始化全局 elog4js；重复调用会替换实例 */
+export declare function initElog(options?: ElogOptions): Elog;
+/** 取全局 elog4js，未初始化时按默认参数创建 */
+export declare function getElog(): Elog;
+/** 重置全局实例，供测试使用 */
+export declare function resetElog(): void;

package/dist/logger/elog4js.js

@@ -0,0 +1,305 @@
+/*
+ * 终端 UI 输出器（elog4js）。
+ * human 模式专用：级别标签、颜色、流式输出；Pino 只负责结构化日志与文件。
+ * --json 模式下所有方法静默，stdout 只留给 Result envelope。
+ */
+const TAGS = {
+    trace: "[TRACE]",
+    debug: "[DEBUG]",
+    info: "[INFO ]",
+    warn: "[WARN ]",
+    error: "[ERROR]",
+    fatal: "[FATAL]",
+};
+const COLORS = {
+    trace: "\x1b[90m",
+    debug: "\x1b[36m",
+    info: "\x1b[32m",
+    warn: "\x1b[33m",
+    error: "\x1b[31m",
+    fatal: "\x1b[35m",
+};
+const RESET = "\x1b[0m";
+// 字符显示宽度
+function charWidth(codePoint) {
+    if (codePoint === 0x200b) {
+        return 0;
+    }
+    return codePoint >= 0x1100 &&
+        (codePoint <= 0x115f ||
+            codePoint === 0x2329 ||
+            codePoint === 0x232a ||
+            (codePoint >= 0x2e80 && codePoint <= 0xa4cf) ||
+            (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+            (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+            (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
+            (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+            (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+            (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+            (codePoint >= 0x1f300 && codePoint <= 0x1f64f) ||
+            (codePoint >= 0x1f900 && codePoint <= 0x1f9ff))
+        ? 2
+        : 1;
+}
+function displayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        width += charWidth(char.codePointAt(0) ?? 0);
+    }
+    return width;
+}
+function wrapLine(text, width) {
+    if (displayWidth(text) <= width) {
+        return [text];
+    }
+    const chunks = [];
+    let rest = text;
+    while (displayWidth(rest) > width) {
+        let taken = 0;
+        let current = 0;
+        let lastSpace = -1;
+        for (const char of rest) {
+            const next = charWidth(char.codePointAt(0) ?? 0);
+            if (current + next > width) {
+                break;
+            }
+            current += next;
+            taken += char.length;
+            if (char === " ") {
+                lastSpace = taken;
+            }
+        }
+        const cut = lastSpace > 0 ? lastSpace : taken;
+        chunks.push(rest.slice(0, cut));
+        rest = rest.slice(cut);
+    }
+    chunks.push(rest);
+    return chunks;
+}
+function detectColor(stream) {
+    const force = process.env["FORCE_COLOR"];
+    if (force === "0") {
+        return false;
+    }
+    if (force !== undefined && force !== "") {
+        return true;
+    }
+    if (process.env["NO_COLOR"] !== undefined) {
+        return false;
+    }
+    if (process.env["TERM"] === "dumb") {
+        return false;
+    }
+    return stream?.isTTY === true;
+}
+export class Elog {
+    #stdout;
+    #stderr;
+    #colorStdout;
+    #colorStderr;
+    #json;
+    #sessionName = "";
+    #streaming = false;
+    constructor(options = {}) {
+        this.#stdout = options.stdout ?? process.stdout;
+        this.#stderr = options.stderr ?? process.stderr;
+        this.#colorStdout = options.color ?? detectColor(this.#stdout);
+        this.#colorStderr = options.color ?? detectColor(this.#stderr);
+        this.#json = options.json ?? false;
+    }
+    setJson(json) {
+        this.#json = json;
+    }
+    isJson() {
+        return this.#json;
+    }
+    setSessionName(name) {
+        this.#sessionName = name;
+    }
+    getSessionName() {
+        return this.#sessionName;
+    }
+    setColor(color) {
+        this.#colorStdout = color;
+        this.#colorStderr = color;
+    }
+    /** 普通信息，stdout */
+    info(text) {
+        this.#line("info", text, this.#stdout);
+    }
+    /** 成功信息，stdout */
+    success(text) {
+        this.#line("info", text, this.#stdout, "[ OK  ]");
+    }
+    debug(text) {
+        this.#line("debug", text, this.#stderr);
+    }
+    warn(text) {
+        this.#line("warn", text, this.#stderr);
+    }
+    error(text) {
+        this.#line("error", text, this.#stderr);
+    }
+    /** Agent 输出前缀 */
+    agentStart() {
+        if (this.#json) {
+            return;
+        }
+        const color = this.#colorStdout;
+        const prefix = color ? `\x1b[36m[Agent]\x1b[0m` : "[Agent]";
+        this.#stdout.write(`\n${prefix}\n`);
+    }
+    /** Agent 输出行 */
+    agent(text) {
+        if (this.#json) {
+            return;
+        }
+        this.agentStart();
+        this.#stdout.write(`${text}\n`);
+    }
+    /** 步骤分隔行 */
+    step(step, total) {
+        if (this.#json) {
+            return;
+        }
+        const color = this.#colorStdout;
+        const text = total === undefined ? `── step ${step} ──` : `── step ${step}/${total} ──`;
+        this.#stdout.write(`\n${color ? `\x1b[36m${text}\x1b[0m` : text}\n`);
+    }
+    /** 代码块 */
+    #codeBlock(label, code) {
+        const columns = process.stdout.columns ?? 80;
+        const width = Math.max(40, columns - 2);
+        const inner = width - 4;
+        const color = this.#colorStdout;
+        const border = (text) => (color ? `\x1b[90m${text}\x1b[0m` : text);
+        const header = `┌ [${label}]`;
+        this.#stdout.write(`${border(`${header}${"─".repeat(Math.max(1, width - header.length - 1))}┐`)}\n`);
+        for (const source of code.split("\n")) {
+            const text = source.replace(/\t/g, "    ");
+            for (let index = 0; index < Math.max(1, text.length); index += inner) {
+                const chunk = text.slice(index, index + inner);
+                this.#stdout.write(`${border("│")} ${chunk.padEnd(inner)} ${border("│")}\n`);
+            }
+        }
+        this.#stdout.write(`${border(`└${"─".repeat(width - 2)}┘`)}\n`);
+    }
+    /** 操作请求块 */
+    action(title, rows) {
+        if (this.#json) {
+            return;
+        }
+        const color = this.#colorStdout;
+        const label = color ? `\x1b[33m${title}\x1b[0m` : title;
+        this.#stdout.write(`\n${label}\n`);
+        for (const row of rows) {
+            if (row.code === true) {
+                this.#stdout.write(`  ${row.label}\n`);
+                this.#codeBlock("bash", row.value);
+                continue;
+            }
+            this.#stdout.write(`  ${row.label} ${row.value}\n`);
+        }
+    }
+    /** 工具调用行：换行后单独一行显示中文动作名与参数摘要 */
+    toolCall(label, summary = "") {
+        if (this.#json) {
+            return;
+        }
+        const color = this.#colorStdout;
+        const name = color ? `\x1b[36m${label}\x1b[0m` : label;
+        const line = summary === "" ? name : `${name}  ${summary}`;
+        this.#stdout.write(`\n${line}\n`);
+    }
+    /** 工具结果/错误行：缩进在工具调用下面 */
+    toolResult(text) {
+        if (this.#json || text === "") {
+            return;
+        }
+        const color = this.#colorStdout;
+        const line = `  ${text}`;
+        this.#stdout.write(`${color ? `\x1b[90m${line}\x1b[0m` : line}\n`);
+    }
+    /** 操作结果行 */
+    actionStatus(name, status) {
+        if (this.#json) {
+            return;
+        }
+        const color = this.#colorStdout;
+        const label = color ? `\x1b[90m[操作]\x1b[0m` : "[操作]";
+        this.#stdout.write(`${label} ${name} ${status}\n`);
+    }
+    /** 只带级别标签，不再拼插件名 */
+    tag(level, text) {
+        const stream = level === "error" || level === "warn" ? this.#stderr : this.#stdout;
+        this.#line(level, text, stream);
+    }
+    /** 插件输出：`[LEVEL] [plugin] message` */
+    plugin(level, pluginName, message) {
+        const stream = level === "error" || level === "warn" ? this.#stderr : this.#stdout;
+        this.#line(level, `[${pluginName}] ${message}`, stream);
+    }
+    /** 流式写正文，不加换行与标签 */
+    stream(text) {
+        if (this.#json || text === "") {
+            return;
+        }
+        this.#streaming = true;
+        this.#stdout.write(text);
+    }
+    /** 结束当前流式行 */
+    line() {
+        if (this.#json || !this.#streaming) {
+            return;
+        }
+        this.#streaming = false;
+        this.#stdout.write("\n");
+    }
+    /** 提示行，stderr，无级别标签 */
+    notice(text) {
+        if (this.#json) {
+            return;
+        }
+        this.#stderr.write(`${text}\n`);
+    }
+    /** 纯文本行，stdout */
+    print(text = "") {
+        if (this.#json) {
+            return;
+        }
+        this.#stdout.write(`${text}\n`);
+    }
+    /** 清屏，仅 TTY 有效 */
+    clear() {
+        if (this.#json || process.stdout.isTTY !== true) {
+            return;
+        }
+        process.stdout.write("\x1b[2J\x1b[H");
+    }
+    #line(level, text, stream, tag = TAGS[level]) {
+        if (this.#json) {
+            return;
+        }
+        const color = stream === this.#stdout ? this.#colorStdout : this.#colorStderr;
+        const coloredTag = color ? `${COLORS[level]}${tag}${RESET}` : tag;
+        stream.write(`${coloredTag} ${text}\n`);
+    }
+}
+let singleton = null;
+/** 初始化全局 elog4js；重复调用会替换实例 */
+export function initElog(options = {}) {
+    singleton = new Elog(options);
+    return singleton;
+}
+/** 取全局 elog4js，未初始化时按默认参数创建 */
+export function getElog() {
+    if (singleton === null) {
+        singleton = new Elog();
+    }
+    return singleton;
+}
+/** 重置全局实例，供测试使用 */
+export function resetElog() {
+    singleton = null;
+}
+//# sourceMappingURL=elog4js.js.map