@xyit/wellspring 0.0.0-stage → 1.0.0

package/dist/event/event.d.ts

@@ -0,0 +1,27 @@
+export declare class EventEntity<T> {
+    private readonly data;
+    private cancelled;
+    private cancelReason;
+    private constructor();
+    static create<T>(data: T, cancelled?: boolean, cancelReason?: string): EventEntity<T>;
+    cancel(reason?: string): this;
+    getData(): T;
+    isCancelled(): boolean;
+    getCancelReason(): string;
+}
+export type EventListener<T = unknown> = (event: EventEntity<T>) => void;
+export declare class EventBus {
+    private readonly listeners;
+    private readonly bridgeSubscriptions;
+    subscribe<T>(eventName: string, listener: EventListener<T>): () => void;
+    publish<T>(eventName: string, event: EventEntity<T>): void;
+    /** sandbox bridge 收到宿主事件后在本进程投递 */
+    receive<T>(eventName: string, data: T): void;
+    private deliverLocal;
+    once<T>(eventName: string, listener: EventListener<T>): () => void;
+    clear(eventName: string): void;
+    clearAll(): void;
+    private remove;
+    private unsubscribeBridge;
+}
+export declare const eventBus: EventBus;

package/dist/event/event.js

@@ -0,0 +1,152 @@
+/*
+ * EventEntity / EventBus
+ *
+ * EventEntity 的负载只读，取消状态可变：监听器对事件实例调 cancel 后
+ * isCancelled 立即为 true，EventBus 据此终止后续传播
+ * 取消不回滚已完成的投递
+ */
+export class EventEntity {
+    data;
+    cancelled;
+    cancelReason;
+    constructor(data, cancelled = false, cancelReason = "") {
+        this.data = data;
+        this.cancelled = cancelled;
+        this.cancelReason = cancelReason;
+    }
+    static create(data, cancelled = false, cancelReason = "") {
+        return new EventEntity(data, cancelled, cancelReason);
+    }
+    cancel(reason = "") {
+        this.cancelled = true;
+        this.cancelReason = reason;
+        return this;
+    }
+    getData() {
+        return this.data;
+    }
+    isCancelled() {
+        return this.cancelled;
+    }
+    getCancelReason() {
+        return this.cancelReason;
+    }
+}
+import { getHostBridge } from "../sandbox/bridge-state.js";
+export class EventBus {
+    listeners = new Map();
+    bridgeSubscriptions = new Set();
+    subscribe(eventName, listener) {
+        if (typeof listener !== "function") {
+            throw new TypeError(`监听器不是函数：${eventName}`);
+        }
+        const record = { fn: listener, active: true };
+        const bridge = getHostBridge();
+        if (bridge !== null && !this.bridgeSubscriptions.has(eventName)) {
+            this.bridgeSubscriptions.add(eventName);
+            void bridge.request("host.event.subscribe", { name: eventName }).catch(() => undefined);
+        }
+        const handlers = this.listeners.get(eventName);
+        if (handlers) {
+            handlers.push(record);
+        }
+        else {
+            this.listeners.set(eventName, [record]);
+        }
+        return () => this.remove(eventName, record);
+    }
+    publish(eventName, event) {
+        const bridge = getHostBridge();
+        if (bridge !== null) {
+            bridge.notify("host.event.publish", { name: eventName, data: event.getData() });
+            return;
+        }
+        this.deliverLocal(eventName, event);
+    }
+    /** sandbox bridge 收到宿主事件后在本进程投递 */
+    receive(eventName, data) {
+        this.deliverLocal(eventName, EventEntity.create(data));
+    }
+    deliverLocal(eventName, event) {
+        const handlers = this.listeners.get(eventName);
+        if (!handlers || handlers.length === 0) {
+            return;
+        }
+        let firstError;
+        let failed = false;
+        // 快照后校验存活状态：本轮回调内的退订对后续监听器生效
+        for (const record of handlers.slice()) {
+            if (!record.active)
+                continue;
+            if (event.isCancelled())
+                break;
+            try {
+                record.fn(event);
+            }
+            catch (error) {
+                // 单监听器异常不中断其余监听器，循环结束后抛出首个异常
+                if (!failed) {
+                    firstError = error;
+                    failed = true;
+                }
+            }
+        }
+        if (failed) {
+            throw firstError;
+        }
+    }
+    once(eventName, listener) {
+        const unsubscribe = this.subscribe(eventName, (event) => {
+            // 先退订再回调：回调内重入发布不会二次触发，回调抛错也不残留订阅
+            unsubscribe();
+            listener(event);
+        });
+        return unsubscribe;
+    }
+    clear(eventName) {
+        this.unsubscribeBridge(eventName);
+        const handlers = this.listeners.get(eventName);
+        if (!handlers)
+            return;
+        for (const record of handlers) {
+            record.active = false;
+        }
+        this.listeners.delete(eventName);
+    }
+    clearAll() {
+        for (const eventName of [...this.bridgeSubscriptions]) {
+            this.unsubscribeBridge(eventName);
+        }
+        for (const handlers of this.listeners.values()) {
+            for (const record of handlers) {
+                record.active = false;
+            }
+        }
+        this.listeners.clear();
+    }
+    remove(eventName, record) {
+        if (!record.active)
+            return;
+        record.active = false;
+        const handlers = this.listeners.get(eventName);
+        if (!handlers)
+            return;
+        const index = handlers.indexOf(record);
+        if (index !== -1) {
+            handlers.splice(index, 1);
+        }
+        if (handlers.length === 0) {
+            this.listeners.delete(eventName);
+            this.unsubscribeBridge(eventName);
+        }
+    }
+    unsubscribeBridge(eventName) {
+        if (!this.bridgeSubscriptions.delete(eventName)) {
+            return;
+        }
+        const bridge = getHostBridge();
+        bridge?.notify("host.event.unsubscribe", { name: eventName });
+    }
+}
+export const eventBus = new EventBus();
+//# sourceMappingURL=event.js.map

package/dist/event/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/event/event.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+/*
+ * Wellspring CLI 入口。
+ * 解析全局参数 → 应用目录/日志覆盖 → 加载配置与插件 → 分发命令。
+ */
+import { resolve } from "node:path";
+import { configureHost, setHostStatus } from "./api/host/host.js";
+import { setHookErrorHandler, setHookGuard, withHookOwner } from "./api/host/hooks.js";
+import { runConfigCommand } from "./commands/config.js";
+import { runConversationCommand } from "./commands/conversation.js";
+import { runDoctorCommand } from "./commands/doctor.js";
+import { runHelpCommand } from "./commands/help.js";
+import { runKeyCommand } from "./commands/key.js";
+import { runPluginCommand } from "./commands/plugin.js";
+import { errorMessage, exitCodeFor, failure, } from "./commands/shared.js";
+import { runSessionCommand } from "./commands/session.js";
+import { runStartCommand } from "./commands/start.js";
+import { runStopCommand } from "./commands/stop.js";
+import { runVersionCommand } from "./commands/version.js";
+import { credentialsFile } from "./config/credentials.js";
+import { activeModelProvider, effectiveModel, effectiveReasoning, providerApiKey, providerOpenAISettings, } from "./config/providers.js";
+import { DEFAULT_SETTINGS } from "./config/defaults.js";
+import { loadSettings, SETTING_FILE_NAME } from "./config/loader.js";
+import { BUILTIN_NAMES, findBuiltin } from "./input/commands.js";
+import { parseGlobal } from "./input/parse.js";
+import { getElog, initElog } from "./logger/elog4js.js";
+import { closeLogger, initLogger } from "./logger/logger.js";
+import { initOpenAIClient } from "./network/openai.js";
+import { createProxyFetch } from "./network/proxy.js";
+import { getPaths } from "./platform/path.js";
+import { withConsoleGuard } from "./plugin/console-guard.js";
+import { loadPlugins } from "./plugin/loader.js";
+import { createPluginFileApi } from "./plugin/fs.js";
+import { ensurePluginDataDir, loadPluginConfig } from "./plugin/runtime.js";
+import { shutdownAllSandboxPlugins } from "./sandbox/plugin-client.js";
+import { AgentToolRegistry } from "./plugin/agent-tools.js";
+import { PluginRegistry } from "./plugin/registry.js";
+function printParseError(code) {
+    const elog = getElog();
+    elog.error(errorMessage(code));
+    elog.notice("运行 wellspring --help 查看用法");
+    process.exitCode = 2;
+}
+function emitOutcome(outcome, json) {
+    const code = outcome.result.getCode();
+    if (json) {
+        const payload = {
+            success: outcome.result.isSuccess(),
+            code: outcome.result.isSuccess() ? null : code,
+            data: outcome.result.isSuccess() ? outcome.result.getData() : null,
+        };
+        process.stdout.write(`${JSON.stringify(payload)}\n`);
+    }
+    else if (!outcome.result.isSuccess() && code !== null) {
+        getElog().error(errorMessage(code));
+    }
+    process.exitCode = outcome.result.isSuccess() ? 0 : exitCodeFor(code);
+}
+function stripJsonFlag(argv) {
+    const next = [...argv];
+    const marker = next.indexOf("--");
+    const limit = marker === -1 ? next.length : marker;
+    for (let index = 0; index < limit; index += 1) {
+        if (next[index] === "--json") {
+            next.splice(index, 1);
+            return { argv: next, json: true };
+        }
+    }
+    return { argv: next, json: false };
+}
+function createPluginOutput(pluginName) {
+    const elog = getElog();
+    return {
+        info: (text) => elog.plugin("info", pluginName, text),
+        warn: (text) => elog.plugin("warn", pluginName, text),
+        error: (text) => elog.plugin("error", pluginName, text),
+        print: (text = "") => elog.plugin("info", pluginName, text),
+    };
+}
+async function main(argv) {
+    const parsed = parseGlobal(argv);
+    if (!parsed.isSuccess()) {
+        printParseError(parsed.getCode() ?? "usage.invalid-value");
+        return;
+    }
+    const parsedGlobal = parsed.getData();
+    if (parsedGlobal === null) {
+        printParseError("usage.invalid-value");
+        return;
+    }
+    const { options: globalOptions } = parsedGlobal;
+    let command = parsedGlobal.command;
+    let commandArgv = [...parsedGlobal.commandArgv];
+    if (globalOptions.version) {
+        command = "version";
+        commandArgv = [];
+    }
+    const builtin = command === null ? undefined : findBuiltin(command);
+    const builtinName = builtin?.name ?? null;
+    let jsonMode = globalOptions.json;
+    if (builtinName !== null) {
+        const stripped = stripJsonFlag(commandArgv);
+        commandArgv = stripped.argv;
+        jsonMode = jsonMode || stripped.json;
+    }
+    const options = { ...globalOptions, json: jsonMode };
+    if (globalOptions.home !== undefined) {
+        process.env["WELLSPRING_HOME"] = globalOptions.home;
+    }
+    const paths = getPaths();
+    configureHost({ paths });
+    setHostStatus("starting");
+    const settingsFile = resolve(globalOptions.config ?? `${paths.configDir}/${SETTING_FILE_NAME}`);
+    const loaded = await loadSettings(settingsFile);
+    const settings = loaded.getData() ?? DEFAULT_SETTINGS;
+    const configCode = loaded.isSuccess() ? null : loaded.getCode();
+    initElog({ json: jsonMode });
+    const elog = getElog();
+    const logger = await initLogger({
+        settings,
+        level: globalOptions.logLevel ?? (globalOptions.quiet ? "silent" : undefined),
+        json: jsonMode,
+        stdout: false,
+    });
+    if (configCode !== null) {
+        logger.warn({ code: configCode }, "配置加载失败，使用默认配置");
+        elog.warn(`配置加载失败，使用默认配置：${errorMessage(configCode)}`);
+    }
+    setHookGuard(async (owner, task) => {
+        await withHookOwner(owner, async () => {
+            await withConsoleGuard(owner, logger.child({ plugin: owner }), task);
+        });
+    });
+    setHookErrorHandler(({ hook, owner, error }) => {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn({ hook, owner, message }, "插件钩子执行失败");
+        elog.warn(`插件钩子执行失败：${hook}（${owner ?? "-"}）：${message}`);
+    });
+    let openai = null;
+    let proxyFetch;
+    try {
+        proxyFetch = createProxyFetch(settings.network.proxy);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        logger.warn({ reason }, "代理初始化失败");
+        elog.warn(`代理初始化失败：${reason}`);
+        proxyFetch = undefined;
+    }
+    // 当前供应商/模型：启动时解析一次，CLI 单轮命令直接用
+    const provider = activeModelProvider(settings);
+    const activeModel = effectiveModel(settings, provider);
+    const activeReasoning = effectiveReasoning(settings, provider);
+    const providerApiKeyValue = providerApiKey(provider, paths.configDir);
+    const openaiResult = initOpenAIClient({
+        settings: providerOpenAISettings(settings, provider),
+        apiKey: providerApiKeyValue ?? "",
+        credentialsFile: credentialsFile(paths.configDir),
+        logger: logger.child({ module: "openai" }),
+        fetch: proxyFetch,
+    });
+    if (openaiResult.isSuccess()) {
+        openai = openaiResult.getData();
+    }
+    else {
+        logger.warn({ code: openaiResult.getCode() }, "OpenAI 客户端不可用");
+    }
+    const registry = new PluginRegistry();
+    const agentTools = new AgentToolRegistry();
+    let pluginsCache = null;
+    const ensurePlugins = async () => {
+        if (pluginsCache !== null) {
+            return pluginsCache;
+        }
+        pluginsCache = await loadPlugins({
+            paths,
+            config: settings,
+            logger,
+            registry,
+            agentTools,
+            sandbox: settings.sandbox,
+        });
+        setHostStatus("running");
+        for (const plugin of pluginsCache) {
+            if (plugin.status === "failed") {
+                logger.warn({ plugin: plugin.name, error: plugin.error }, "插件加载失败");
+            }
+        }
+        return pluginsCache;
+    };
+    const commandHelpRequested = builtinName !== null && commandArgv.some((token) => token === "--help" || token === "-h");
+    const requested = commandHelpRequested ? builtinName : command;
+    let commandName;
+    if ((globalOptions.help || commandHelpRequested) && requested !== null) {
+        commandName = "help";
+        commandArgv = [requested];
+    }
+    else {
+        commandName = requested ?? "help";
+    }
+    const ctx = {
+        global: options,
+        settings,
+        settingsFile,
+        configCode,
+        paths,
+        logger,
+        elog,
+        registry,
+        agentTools,
+        openai,
+        activeProvider: provider.id,
+        activeModel,
+        activeReasoning,
+        loadPlugins: ensurePlugins,
+    };
+    try {
+        // 钩子与插件命令都可能在任意命令里用到；version / key / plugin 不启动插件
+        // plugin 子命令只改文件，插件是否加载由下次运行决定
+        if (commandName !== "version" && commandName !== "key" && commandName !== "plugin") {
+            await ensurePlugins();
+        }
+        setHostStatus("running");
+        let outcome;
+        switch (commandName) {
+            case "chat":
+                outcome = await runConversationCommand(ctx, commandArgv, "chat");
+                break;
+            case "run":
+                outcome = await runConversationCommand(ctx, commandArgv, "run");
+                break;
+            case "start":
+                outcome = await runStartCommand(ctx);
+                break;
+            case "stop":
+                outcome = await runStopCommand(ctx);
+                break;
+            case "session":
+                outcome = await runSessionCommand(ctx, commandArgv);
+                break;
+            case "config":
+                outcome = await runConfigCommand(ctx, commandArgv);
+                break;
+            case "plugin":
+                outcome = await runPluginCommand(ctx, commandArgv);
+                break;
+            case "doctor":
+                outcome = await runDoctorCommand(ctx);
+                break;
+            case "key":
+                outcome = await runKeyCommand(ctx, commandArgv);
+                break;
+            case "version":
+                outcome = await runVersionCommand(ctx);
+                break;
+            case "help":
+                outcome = await runHelpCommand(ctx, commandArgv);
+                break;
+            default: {
+                const record = registry.resolve(commandName);
+                if (record === undefined) {
+                    outcome = failure(`usage.unknown-command:${commandName}`);
+                    break;
+                }
+                const pluginLogger = logger.child({ plugin: record.pluginName });
+                try {
+                    const pluginDataDir = await ensurePluginDataDir(record.pluginName, paths);
+                    const pluginConfig = await loadPluginConfig(record.pluginName, paths);
+                    const pluginFs = createPluginFileApi(pluginDataDir);
+                    const workspaceFs = createPluginFileApi(process.cwd());
+                    const pluginContext = {
+                        argv: commandArgv,
+                        env: process.env,
+                        paths,
+                        config: settings,
+                        logger: pluginLogger,
+                        output: createPluginOutput(record.pluginName),
+                        pluginDataDir,
+                        pluginConfig,
+                        fs: pluginFs,
+                        workspaceFs,
+                        cwd: process.cwd(),
+                        json: jsonMode,
+                        stdin: process.stdin,
+                        stdout: process.stdout,
+                        stderr: process.stderr,
+                    };
+                    const code = await withHookOwner(record.pluginName, async () => withConsoleGuard(record.pluginName, pluginLogger, async () => record.command.run(pluginContext)));
+                    process.exitCode = typeof code === "number" ? code : 0;
+                    return;
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    logger.error({ plugin: record.pluginName, message }, "插件命令执行失败");
+                    outcome = failure(`plugin.command-failed:${message}`);
+                }
+            }
+        }
+        emitOutcome(outcome, jsonMode);
+    }
+    finally {
+        setHostStatus("stopped");
+        await shutdownAllSandboxPlugins();
+        await closeLogger();
+    }
+}
+await main(process.argv.slice(2));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/input/codes.d.ts

@@ -0,0 +1,15 @@
+/** 入参错误码，退出码统一为 2 */
+export declare const USAGE_CODES: {
+    readonly unknownCommand: "usage.unknown-command";
+    readonly unknownOption: "usage.unknown-option";
+    readonly unknownSubcommand: "usage.unknown-subcommand";
+    readonly missingValue: "usage.missing-value";
+    readonly invalidValue: "usage.invalid-value";
+    readonly missingContext: "usage.missing-context";
+    readonly invalidSessionId: "usage.invalid-session-id";
+    readonly unknownConfigKey: "usage.unknown-config-key";
+    readonly conflictingOptions: "usage.conflicting-options";
+    readonly missingConfirmation: "usage.missing-confirmation";
+};
+export declare function usageCode(code: string, detail?: string): string;
+export declare function isUsageCode(code: string | null): boolean;

package/dist/input/codes.js

@@ -0,0 +1,20 @@
+/** 入参错误码，退出码统一为 2 */
+export const USAGE_CODES = {
+    unknownCommand: "usage.unknown-command",
+    unknownOption: "usage.unknown-option",
+    unknownSubcommand: "usage.unknown-subcommand",
+    missingValue: "usage.missing-value",
+    invalidValue: "usage.invalid-value",
+    missingContext: "usage.missing-context",
+    invalidSessionId: "usage.invalid-session-id",
+    unknownConfigKey: "usage.unknown-config-key",
+    conflictingOptions: "usage.conflicting-options",
+    missingConfirmation: "usage.missing-confirmation",
+};
+export function usageCode(code, detail) {
+    return detail === undefined || detail === "" ? code : `${code}:${detail}`;
+}
+export function isUsageCode(code) {
+    return code !== null && code.startsWith("usage.");
+}
+//# sourceMappingURL=codes.js.map

package/dist/input/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../src/input/codes.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,cAAc,EAAE,uBAAuB;IACvC,aAAa,EAAE,sBAAsB;IACrC,iBAAiB,EAAE,0BAA0B;IAC7C,YAAY,EAAE,qBAAqB;IACnC,YAAY,EAAE,qBAAqB;IACnC,cAAc,EAAE,uBAAuB;IACvC,gBAAgB,EAAE,0BAA0B;IAC5C,gBAAgB,EAAE,0BAA0B;IAC5C,kBAAkB,EAAE,2BAA2B;IAC/C,mBAAmB,EAAE,4BAA4B;CAC3C,CAAA;AAEV,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAe;IACnD,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAA;AAC7E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAmB;IAC3C,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;AACrD,CAAC"}

package/dist/input/commands.d.ts

@@ -0,0 +1,10 @@
+/** 内置命令元数据，帮助文本与命令校验共用这一份 */
+export interface BuiltinCommandSpec {
+    readonly name: string;
+    readonly summary: string;
+    readonly usage: string;
+    readonly aliases?: readonly string[];
+}
+export declare const BUILTIN_COMMANDS: readonly BuiltinCommandSpec[];
+export declare const BUILTIN_NAMES: ReadonlySet<string>;
+export declare function findBuiltin(name: string): BuiltinCommandSpec | undefined;

package/dist/input/commands.js

@@ -0,0 +1,65 @@
+/** 内置命令元数据，帮助文本与命令校验共用这一份 */
+export const BUILTIN_COMMANDS = [
+    {
+        name: "chat",
+        summary: "对话模式，单轮对话或进入交互式会话",
+        usage: "wellspring chat [--session-id <id>] [--new] [--model <name>] [--reasoning off|low|high|max] [--system <text>] <context...>",
+    },
+    {
+        name: "run",
+        summary: "Agent 模式，单轮执行或进入交互式会话",
+        usage: "wellspring run [--session-id <id>] [--new] [--agent <name>] [--model <name>] [--reasoning off|low|high|max] [--permission read-only|workspace-write|danger-full-access] [--allow-exec] [--max-steps <n>] <context...>",
+    },
+    {
+        name: "start",
+        summary: "以服务进程启动，加载插件并触发 onInit",
+        usage: "wellspring start",
+    },
+    {
+        name: "stop",
+        summary: "停止正在运行的 Wellspring 服务",
+        usage: "wellspring stop",
+    },
+    {
+        name: "session",
+        summary: "查看、切换与删除会话",
+        usage: "wellspring session <list|show|delete> [args]",
+    },
+    {
+        name: "config",
+        summary: "配置路径、查看与读写配置项",
+        usage: "wellspring config <path|show|get|set> [args]",
+    },
+    {
+        name: "key",
+        summary: "查看、设置、清除与测试 OpenAI API Key",
+        usage: "wellspring key <status|set|clear|test|path> [--provider <id>] [args]",
+    },
+    {
+        name: "plugin",
+        summary: "插件列表、安装与删除",
+        usage: "wellspring plugin <list|new|install|link|enable|disable|remove> [args]",
+    },
+    {
+        name: "doctor",
+        summary: "环境与配置诊断",
+        usage: "wellspring doctor [--json]",
+    },
+    {
+        name: "version",
+        summary: "显示版本与运行环境",
+        usage: "wellspring version [--json]",
+        aliases: ["-v"],
+    },
+    {
+        name: "help",
+        summary: "显示帮助",
+        usage: "wellspring help [command]",
+        aliases: ["-h"],
+    },
+];
+export const BUILTIN_NAMES = new Set(BUILTIN_COMMANDS.map((spec) => spec.name));
+export function findBuiltin(name) {
+    return BUILTIN_COMMANDS.find((spec) => spec.name === name || (spec.aliases ?? []).includes(name));
+}
+//# sourceMappingURL=commands.js.map

package/dist/input/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/input/commands.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAS7B,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC3D;QACI,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,mBAAmB;QAC5B,KAAK,EAAE,4HAA4H;KACtI;IACD;QACI,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,uBAAuB;QAChC,KAAK,EAAE,uNAAuN;KACjO;IACD;QACI,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,wBAAwB;QACjC,KAAK,EAAE,kBAAkB;KAC5B;IACD;QACI,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,uBAAuB;QAChC,KAAK,EAAE,iBAAiB;KAC3B;IACD;QACI,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,YAAY;QACrB,KAAK,EAAE,8CAA8C;KACxD;IACD;QACI,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,8CAA8C;KACxD;IACD;QACI,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,4BAA4B;QACrC,KAAK,EAAE,sEAAsE;KAChF;IACD;QACI,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,YAAY;QACrB,KAAK,EAAE,wEAAwE;KAClF;IACD;QACI,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,4BAA4B;KACtC;IACD;QACI,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,6BAA6B;QACpC,OAAO,EAAE,CAAC,IAAI,CAAC;KAClB;IACD;QACI,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,2BAA2B;QAClC,OAAO,EAAE,CAAC,IAAI,CAAC;KAClB;CACJ,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AAEpG,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAO,gBAAgB,CAAC,IAAI,CACxB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CACtE,CAAA;AACL,CAAC"}

package/dist/input/help.d.ts

@@ -0,0 +1,8 @@
+export interface HelpPluginCommand {
+    readonly name: string;
+    readonly summary: string;
+    readonly usage: string;
+    readonly plugin: string;
+}
+export declare function formatGlobalHelp(pluginCommands: readonly HelpPluginCommand[]): string;
+export declare function formatCommandHelp(name: string, pluginCommand?: HelpPluginCommand): string | null;