@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/commands/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/commands/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,OAAO,EAA4C,MAAM,aAAa,CAAA;AAUxF,0DAA0D;AAC1D,KAAK,UAAU,cAAc,CAAC,KAAoB;IAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAA;IAC7C,IAAI,KAAe,CAAA;IACnB,IAAI,CAAC;QACD,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACxC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAA;IACb,CAAC;IACD,MAAM,OAAO,GAAoB,EAAE,CAAA;IACnC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC/B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAA;QACpC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,SAAQ;QAClD,IAAI,IAAI,GAAG,OAAO,CAAA;QAClB,IAAI,OAAO,GAAG,OAAO,CAAA;QACrB,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAGvE,CAAA;YACD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE;gBAAE,IAAI,GAAG,GAAG,CAAC,IAAI,CAAA;YACpE,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;QACpF,CAAC;QAAC,MAAM,CAAC;YACL,2BAA2B;QAC/B,CAAC;QACD,IAAI,IAAI,GAAa,EAAE,CAAA;QACvB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;YAC5D,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACpD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAC1D,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAC1B,CAAA;YACL,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,mBAAmB;QACvB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACT,OAAO;YACP,IAAI;YACJ,OAAO;YACP,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;YAC/B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC;SACzC,CAAC,CAAA;IACN,CAAC;IACD,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,qBAAqB;AACrB,SAAS,YAAY,CACjB,OAAiC,EACjC,OAAe,EACf,UAAkB;IAElB,OAAO,OAAO;SACT,MAAM,CACH,CAAC,MAAM,EAAE,EAAE,CACP,MAAM,CAAC,OAAO,KAAK,OAAO;QAC1B,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAC1E;SACA,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,GAAmB,EACnB,IAAuB;IAEvB,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE;QAClC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B,CAAC,CAAA;IACF,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAU,MAAM,CAAC,OAAO,EAAE,IAAI,WAAW,CAAC,YAAY,CAAC,EAAE,CAAA;IAC1F,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAA;IAC7B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAC5C,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAElD,IAAI,CAAC;QACD,QAAQ,UAAU,EAAE,CAAC;YACjB,KAAK,MAAM,EAAE,CAAC;gBACV,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBAC/C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;oBACnE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAA;oBACtD,GAAG,CAAC,IAAI,CAAC,KAAK,CACV,GAAG,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,UAAU,IAAI,EAAE,CACjF,CAAA;gBACL,CAAC;gBACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAA;YAC3B,CAAC;YACD,KAAK,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;gBAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACrB,OAAO,OAAO,CAAC,GAAG,WAAW,CAAC,YAAY,OAAO,CAAC,CAAA;gBACtD,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC;oBACjC,IAAI;oBACJ,SAAS,EACL,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;oBAC3E,KAAK;iBACR,CAAC,CAAA;gBACF,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;gBAC7C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBACtB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,4BAA4B,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;gBACzD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;gBAC1C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;gBACrD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAA;gBACtD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAA;YAC3B,CAAC;YACD,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS,EAAE,CAAC;gBACb,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;gBAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACrB,OAAO,OAAO,CAAC,GAAG,WAAW,CAAC,YAAY,OAAO,CAAC,CAAA;gBACtD,CAAC;gBACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,OAAO,OAAO,CAAC,GAAG,WAAW,CAAC,YAAY,OAAO,CAAC,CAAA;gBACtD,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBAC/C,MAAM,KAAK,GACP,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;oBACjD,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;gBAClD,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;gBAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAA;gBACjD,IAAI,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBACrC,OAAO,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAA;gBAC9C,CAAC;gBACD,MAAM,OAAO,GAAG,UAAU,KAAK,QAAQ,CAAA;gBACvC,MAAM,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;gBACnD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,OAAO,UAAU,CAAC,CAAA;gBAChE,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;YAC5C,CAAC;YACD,KAAK,SAAS,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;gBAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACvB,OAAO,OAAO,CAAC,GAAG,WAAW,CAAC,YAAY,OAAO,CAAC,CAAA;gBACtD,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;gBACnE,GAAG,CAAC,IAAI,CAAC,IAAI,CACT,SAAS,CAAC,qBAAqB;oBAC3B,CAAC,CAAC,SAAS,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC,cAAc,IAAI,MAAM,OAAO;oBACvE,CAAC,CAAC,SAAS,SAAS,CAAC,EAAE,EAAE,CAChC,CAAA;gBACD,OAAO,OAAO,CAAC,SAAS,CAAC,CAAA;YAC7B,CAAC;YACD,KAAK,MAAM,EAAE,CAAC;gBACV,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;gBAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACvB,OAAO,OAAO,CAAC,GAAG,WAAW,CAAC,YAAY,OAAO,CAAC,CAAA;gBACtD,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;gBAChD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;gBAC9B,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;YAChC,CAAC;YACD,KAAK,QAAQ,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;gBAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACrB,OAAO,OAAO,CAAC,GAAG,WAAW,CAAC,YAAY,OAAO,CAAC,CAAA;gBACtD,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBAC/C,MAAM,MAAM,GACR,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;oBACjD,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;gBAClD,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAA;gBAC5D,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,OAAO,CAAC,CAAA;gBAC1E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACnC,GAAG,CAAC,IAAI,CAAC,KAAK,CACV,MAAM,OAAO,YAAY,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;wBAC7C,oBAAoB,CAC3B,CAAA;oBACD,OAAO,OAAO,CAAC,yBAAyB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACnE,CAAC;gBACD,MAAM,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;gBACtC,GAAG,CAAC,IAAI,CAAC,IAAI,CACT,SAAS,OAAO,GAAG,MAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACvE,CAAA;gBACD,OAAO,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;YACnC,CAAC;YACD;gBACI,OAAO,OAAO,CAAC,GAAG,WAAW,CAAC,iBAAiB,WAAW,UAAU,IAAI,EAAE,EAAE,CAAC,CAAA;QACrF,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,OAAO,OAAO,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAA;IACtD,CAAC;AACL,CAAC"}

package/dist/commands/session.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext, type CommandOutcome } from "./shared.js";
+export declare function runSessionCommand(ctx: CommandContext, argv: readonly string[]): Promise<CommandOutcome>;

package/dist/commands/session.js

@@ -0,0 +1,167 @@
+/*
+ * session 命令：list / show / delete。
+ */
+import { Result } from "../api/result/result.js";
+import { USAGE_CODES } from "../input/codes.js";
+import { booleanValue, parseCommandArgs, stringValue } from "../input/parse-options.js";
+import { contentText } from "../session/replay.js";
+import { SessionStore } from "../session/store.js";
+import { failure, success } from "./shared.js";
+function truncate(text, full) {
+    if (full || text.length <= 200) {
+        return text;
+    }
+    return `${text.slice(0, 200)}…`;
+}
+function eventText(event) {
+    const message = event.data["message"];
+    if (typeof message !== "object" || message === null) {
+        return "";
+    }
+    const content = message.content;
+    if (!Array.isArray(content)) {
+        return "";
+    }
+    return contentText(content);
+}
+function printSession(session, full, ctx) {
+    ctx.elog.print(`${session.meta.id}  ${session.meta.cwd}`);
+    for (const turn of session.turns) {
+        const mode = turn.mode ?? "chat";
+        ctx.elog.print(`#${turn.turn} [${mode}]`);
+        for (const event of turn.events) {
+            if (event.type === "user/message") {
+                ctx.elog.print(`  > ${truncate(eventText(event), full)}`);
+            }
+            else if (event.type === "assistant/message") {
+                ctx.elog.print(`  ${truncate(eventText(event), full)}`);
+            }
+            else if (event.type === "tool/call") {
+                const name = event.data["name"];
+                ctx.elog.print(`  [tool] ${String(name ?? "")}`);
+            }
+            else if (event.type === "turn/end") {
+                const reason = event.data["reason"];
+                const kind = typeof reason === "object" && reason !== null
+                    ? (reason.kind ?? "")
+                    : "";
+                ctx.elog.print(`  -- ${String(kind)}`);
+            }
+        }
+    }
+}
+async function handleList(ctx, args) {
+    const parsed = parseCommandArgs(args, {
+        all: { type: "boolean" },
+        limit: { type: "string" },
+    });
+    if (!parsed.isSuccess()) {
+        return { result: Result.error(parsed.getCode() ?? USAGE_CODES.invalidValue) };
+    }
+    const line = parsed.getData();
+    if (line === null) {
+        return failure(USAGE_CODES.invalidValue);
+    }
+    const rawLimit = stringValue(line.values, "limit");
+    let limit = 20;
+    if (rawLimit !== undefined) {
+        const value = Number(rawLimit);
+        if (!Number.isInteger(value) || value <= 0) {
+            return failure(`${USAGE_CODES.invalidValue}:--limit`);
+        }
+        limit = value;
+    }
+    const list = await new SessionStore().list({
+        cwd: process.cwd(),
+        all: booleanValue(line.values, "all"),
+        limit,
+    });
+    for (const item of list) {
+        ctx.elog.print(`${item.id}${item.last ? " *" : ""}  turns=${item.turns}  ${item.cwd}`);
+    }
+    return success(list.map((item) => ({ ...item, dir: undefined })));
+}
+async function handleShow(ctx, args) {
+    const parsed = parseCommandArgs(args, {
+        full: { type: "boolean" },
+    });
+    if (!parsed.isSuccess()) {
+        return { result: Result.error(parsed.getCode() ?? USAGE_CODES.invalidValue) };
+    }
+    const line = parsed.getData();
+    const id = line?.positionals[0];
+    if (id === undefined) {
+        return failure(`${USAGE_CODES.missingValue}:session-id`);
+    }
+    const session = await new SessionStore().open(id, process.cwd());
+    printSession(session, line !== null && booleanValue(line.values, "full"), ctx);
+    return success({ meta: session.meta, turns: session.turns });
+}
+async function handleDelete(ctx, args) {
+    const parsed = parseCommandArgs(args, {
+        all: { type: "boolean" },
+        yes: { type: "boolean" },
+    });
+    if (!parsed.isSuccess()) {
+        return { result: Result.error(parsed.getCode() ?? USAGE_CODES.invalidValue) };
+    }
+    const line = parsed.getData();
+    if (line === null) {
+        return failure(USAGE_CODES.invalidValue);
+    }
+    const all = booleanValue(line.values, "all");
+    const yes = booleanValue(line.values, "yes");
+    const store = new SessionStore();
+    if (all) {
+        if (!yes) {
+            return failure(USAGE_CODES.missingConfirmation);
+        }
+        const removed = await store.removeAll(process.cwd());
+        ctx.elog.info(`已删除 ${removed} 个会话`);
+        return success({ removed });
+    }
+    if (line.positionals.length === 0) {
+        return failure(`${USAGE_CODES.missingValue}:session-id`);
+    }
+    for (const id of line.positionals) {
+        await store.remove(id);
+        ctx.elog.info(`已删除 ${id}`);
+    }
+    return success({ removed: line.positionals });
+}
+export async function runSessionCommand(ctx, argv) {
+    const [subcommand, ...rest] = argv;
+    try {
+        switch (subcommand) {
+            case "list":
+                return await handleList(ctx, rest);
+            case "show":
+                return await handleShow(ctx, rest);
+            case "delete":
+                return await handleDelete(ctx, rest);
+            default:
+                return failure(`${USAGE_CODES.unknownSubcommand}:session ${subcommand ?? ""}`);
+        }
+    }
+    catch (error) {
+        return failure(sessionErrorCode(error));
+    }
+}
+function sessionErrorCode(error) {
+    if (error instanceof Error) {
+        if (error.name === "SessionNotFoundError") {
+            return "session.not-found";
+        }
+        if (error.name === "SessionAmbiguousError") {
+            return "session.ambiguous-id";
+        }
+        if (error.name === "SessionLockedError") {
+            return "session.locked";
+        }
+        if (error.message.includes("会话 id 不合法")) {
+            return USAGE_CODES.invalidSessionId;
+        }
+    }
+    return "session.corrupted";
+}
+//# sourceMappingURL=session.js.map

package/dist/commands/session.js.map

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

package/dist/commands/shared.d.ts

@@ -0,0 +1,35 @@
+import type { Logger } from "pino";
+import { Result } from "../api/result/result.js";
+import type { AppSetting } from "../config/types.js";
+import type { GlobalOptions } from "../input/types.js";
+import type { Elog } from "../logger/elog4js.js";
+import type { OpenAIClient } from "../network/openai.js";
+import type { ResolvedPaths } from "../platform/path.js";
+import type { LoadedPlugin } from "../plugin/loader.js";
+import type { AgentToolRegistry } from "../plugin/agent-tools.js";
+import type { PluginRegistry } from "../plugin/registry.js";
+export interface CommandContext {
+    readonly global: GlobalOptions;
+    readonly settings: AppSetting;
+    readonly settingsFile: string;
+    readonly configCode: string | null;
+    readonly paths: ResolvedPaths;
+    readonly logger: Logger;
+    readonly elog: Elog;
+    readonly registry: PluginRegistry;
+    readonly agentTools: AgentToolRegistry;
+    readonly openai: OpenAIClient | null;
+    /** 当前生效的供应商 id 与模型（已按 models.* 解析）；测试上下文可省略 */
+    readonly activeProvider?: string;
+    readonly activeModel?: string;
+    readonly activeReasoning?: string;
+    loadPlugins(): Promise<readonly LoadedPlugin[]>;
+}
+export interface CommandOutcome {
+    readonly result: Result<unknown>;
+}
+export declare function success(data?: unknown): CommandOutcome;
+export declare function failure(code: string): CommandOutcome;
+/** 错误码 → 人类可读文案，字段级细节保留在冒号后 */
+export declare function errorMessage(code: string): string;
+export declare function exitCodeFor(code: string | null): number;

package/dist/commands/shared.js

@@ -0,0 +1,66 @@
+/*
+ * 命令层公共类型与错误文案。
+ */
+import { Result } from "../api/result/result.js";
+import { isUsageCode } from "../input/codes.js";
+export function success(data) {
+    return { result: Result.successWithData(data ?? null) };
+}
+export function failure(code) {
+    return { result: Result.error(code) };
+}
+const MESSAGES = {
+    "usage.unknown-command": "未知命令",
+    "usage.unknown-option": "未知参数",
+    "usage.unknown-subcommand": "未知子命令",
+    "usage.missing-value": "缺少参数值",
+    "usage.invalid-value": "参数值非法",
+    "usage.missing-context": "缺少对话内容",
+    "usage.invalid-session-id": "会话 id 不合法",
+    "usage.unknown-config-key": "配置项不存在",
+    "usage.conflicting-options": "参数互相冲突",
+    "usage.missing-confirmation": "缺少 --yes 确认",
+    "config.read-failed": "配置文件读取失败",
+    "config.parse-failed": "配置文件解析失败",
+    "config.invalid": "配置项非法",
+    "config.version-unsupported": "配置版本不受支持",
+    "config.write-failed": "配置文件写入失败",
+    "config.invalid-api-key": "API Key 格式不合法",
+    "config.credentials-write-failed": "凭据文件写入失败",
+    "openai.missing-api-key": "缺少 API Key（wellspring key set 或环境变量 OPENAI_API_KEY）",
+    "openai.empty-output": "模型返回空内容",
+    "openai.timeout": "模型请求超时",
+    "openai.connection-failed": "无法连接模型服务",
+    "openai.unauthorized": "模型服务鉴权失败",
+    "openai.forbidden": "模型服务拒绝访问",
+    "openai.rate-limited": "模型服务限流",
+    "openai.bad-request": "模型请求参数非法",
+    "openai.server-error": "模型服务内部错误",
+    "openai.request-failed": "模型请求失败",
+    "session.not-found": "会话不存在",
+    "session.parse-failed": "会话事件解析失败",
+    "session.corrupted": "会话段损坏",
+    "session.ambiguous-id": "会话 id 在多处重复",
+    "session.locked": "会话正在被其他进程写入",
+    "plugin.command-failed": "插件命令执行失败",
+    "plugin.load-failed": "插件加载失败",
+    "plugin.install-failed": "插件安装失败",
+    "plugin.has-dependents": "插件被其它插件依赖，使用 --ignore 强制卸载",
+    "plugin.not-found": "插件不存在",
+    "service.already-running": "服务已在运行",
+    "service.not-running": "没有正在运行的服务",
+    "service.stop-timeout": "等待服务退出超时",
+    "service.stop-failed": "停止服务失败",
+    "service.record-failed": "服务状态记录失败",
+    "runtime.unknown-status": "未知运行状态",
+};
+/** 错误码 → 人类可读文案，字段级细节保留在冒号后 */
+export function errorMessage(code) {
+    const [base, detail] = code.split(":", 2);
+    const message = MESSAGES[base ?? ""] ?? base ?? code;
+    return detail === undefined || detail === "" ? message : `${message}：${detail}`;
+}
+export function exitCodeFor(code) {
+    return isUsageCode(code) ? 2 : 1;
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AA+B/C,MAAM,UAAU,OAAO,CAAC,IAAc;IAClC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,eAAe,CAAU,IAAI,IAAI,IAAI,CAAC,EAAE,CAAA;AACpE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAChC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAU,IAAI,CAAC,EAAE,CAAA;AAClD,CAAC;AAED,MAAM,QAAQ,GAAqC;IAC/C,uBAAuB,EAAE,MAAM;IAC/B,sBAAsB,EAAE,MAAM;IAC9B,0BAA0B,EAAE,OAAO;IACnC,qBAAqB,EAAE,OAAO;IAC9B,qBAAqB,EAAE,OAAO;IAC9B,uBAAuB,EAAE,QAAQ;IACjC,0BAA0B,EAAE,WAAW;IACvC,0BAA0B,EAAE,QAAQ;IACpC,2BAA2B,EAAE,QAAQ;IACrC,4BAA4B,EAAE,aAAa;IAC3C,oBAAoB,EAAE,UAAU;IAChC,qBAAqB,EAAE,UAAU;IACjC,gBAAgB,EAAE,OAAO;IACzB,4BAA4B,EAAE,UAAU;IACxC,qBAAqB,EAAE,UAAU;IACjC,wBAAwB,EAAE,eAAe;IACzC,iCAAiC,EAAE,UAAU;IAC7C,wBAAwB,EAAE,qDAAqD;IAC/E,qBAAqB,EAAE,SAAS;IAChC,gBAAgB,EAAE,QAAQ;IAC1B,0BAA0B,EAAE,UAAU;IACtC,qBAAqB,EAAE,UAAU;IACjC,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,QAAQ;IAC/B,oBAAoB,EAAE,UAAU;IAChC,qBAAqB,EAAE,UAAU;IACjC,uBAAuB,EAAE,QAAQ;IACjC,mBAAmB,EAAE,OAAO;IAC5B,sBAAsB,EAAE,UAAU;IAClC,mBAAmB,EAAE,OAAO;IAC5B,sBAAsB,EAAE,aAAa;IACrC,gBAAgB,EAAE,aAAa;IAC/B,uBAAuB,EAAE,UAAU;IACnC,oBAAoB,EAAE,QAAQ;IAC9B,uBAAuB,EAAE,QAAQ;IACjC,uBAAuB,EAAE,4BAA4B;IACrD,kBAAkB,EAAE,OAAO;IAC3B,yBAAyB,EAAE,QAAQ;IACnC,qBAAqB,EAAE,WAAW;IAClC,sBAAsB,EAAE,UAAU;IAClC,qBAAqB,EAAE,QAAQ;IAC/B,uBAAuB,EAAE,UAAU;IACnC,wBAAwB,EAAE,QAAQ;CACrC,CAAA;AAED,+BAA+B;AAC/B,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI,IAAI,CAAA;IACpD,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,EAAE,CAAA;AACnF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAmB;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACpC,CAAC"}

package/dist/commands/start.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext, type CommandOutcome } from "./shared.js";
+export declare function runStartCommand(ctx: CommandContext): Promise<CommandOutcome>;

package/dist/commands/start.js

@@ -0,0 +1,75 @@
+/*
+ * start：以服务进程启动。
+ * 加载插件后触发 onInit，保持进程存活；只有 Ctrl+C / SIGTERM 或插件调用 shutdown() 才退出。
+ */
+import { emitInitHooks, emitShutdownHooks, setShutdownHandler } from "../api/host/hooks.js";
+import { setHostStatus } from "../api/host/host.js";
+import { ServiceAlreadyRunningError, assertServiceStartable, clearServiceRecord, writeServiceRecord, } from "../service/control.js";
+import { failure, success } from "./shared.js";
+export async function runStartCommand(ctx) {
+    await ctx.loadPlugins();
+    try {
+        await assertServiceStartable(ctx.paths);
+    }
+    catch (error) {
+        if (error instanceof ServiceAlreadyRunningError) {
+            return failure(`service.already-running:${error.pid}`);
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return failure(`service.record-failed:${message}`);
+    }
+    await writeServiceRecord({ pid: process.pid, startedAt: new Date().toISOString(), cwd: process.cwd() }, ctx.paths);
+    const state = { resolve: null };
+    const shutdownPromise = new Promise((resolve) => {
+        state.resolve = resolve;
+    });
+    const requestShutdown = () => {
+        state.resolve?.();
+    };
+    setShutdownHandler(requestShutdown);
+    let signals = 0;
+    const onSignal = () => {
+        signals += 1;
+        // 第二次 Ctrl+C 直接退出：某个插件的 onShutdown 卡住时仍然能停下来
+        if (signals > 1) {
+            ctx.elog.notice("强制退出");
+            process.exit(130);
+        }
+        requestShutdown();
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    // 没有常驻 handle 时 Node 会直接退出，这里显式保持事件循环
+    const keepAlive = setInterval(() => undefined, 60_000);
+    ctx.logger.info({ pid: process.pid }, "service started");
+    ctx.elog.info("Wellspring 服务已启动，Ctrl+C 退出");
+    try {
+        await emitInitHooks();
+        await shutdownPromise;
+        setHostStatus("stopping");
+        ctx.elog.notice("正在关闭…");
+        // 兜底：插件 onShutdown 若卡住（例如有长连接没断开），超时后强制退出
+        const forceExit = setTimeout(() => {
+            ctx.elog.notice("关闭超时，强制退出");
+            process.exit(130);
+        }, 10_000);
+        forceExit.unref();
+        try {
+            await emitShutdownHooks();
+        }
+        finally {
+            clearTimeout(forceExit);
+        }
+        ctx.logger.info("service stopped");
+        ctx.elog.info("Wellspring 服务已关闭");
+        return success({ pid: process.pid });
+    }
+    finally {
+        clearInterval(keepAlive);
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+        setShutdownHandler(null);
+        await clearServiceRecord(process.pid, ctx.paths);
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/commands/stop.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext, type CommandOutcome } from "./shared.js";
+export declare function runStopCommand(ctx: CommandContext): Promise<CommandOutcome>;

package/dist/commands/stop.js

@@ -0,0 +1,24 @@
+/*
+ * stop：停止正在运行的 wellspring start 服务。
+ * 读取 <dataDir>/service.json，发送 SIGTERM，等待进程退出。
+ */
+import { ServiceNotRunningError, ServiceStopTimeoutError, stopService } from "../service/control.js";
+import { failure, success } from "./shared.js";
+export async function runStopCommand(ctx) {
+    try {
+        const pid = await stopService(ctx.paths);
+        ctx.elog.info(`已停止 Wellspring 服务（pid ${pid}）`);
+        return success({ pid });
+    }
+    catch (error) {
+        if (error instanceof ServiceNotRunningError) {
+            return failure("service.not-running");
+        }
+        if (error instanceof ServiceStopTimeoutError) {
+            return failure(`service.stop-timeout:${error.pid}`);
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return failure(`service.stop-failed:${message}`);
+    }
+}
+//# sourceMappingURL=stop.js.map

package/dist/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACpG,OAAO,EAAE,OAAO,EAAE,OAAO,EAA4C,MAAM,aAAa,CAAA;AAExF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAmB;IACpD,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACxC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,GAAG,GAAG,CAAC,CAAA;QAC9C,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC,qBAAqB,CAAC,CAAA;QACzC,CAAC;QACD,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;YAC3C,OAAO,OAAO,CAAC,wBAAwB,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;QACvD,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,OAAO,OAAO,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAA;IACpD,CAAC;AACL,CAAC"}

package/dist/commands/version.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext, type CommandOutcome } from "./shared.js";
+export declare function runVersionCommand(ctx: CommandContext): Promise<CommandOutcome>;

package/dist/commands/version.js

@@ -0,0 +1,33 @@
+/*
+ * version：读取 package.json 的版本号并输出运行环境。
+ */
+import { join } from "node:path";
+import { readTextIfExists } from "../platform/file.js";
+import { platform } from "../platform/os.js";
+import { success } from "./shared.js";
+async function readPackage() {
+    const file = join(import.meta.dirname, "../../package.json");
+    const text = await readTextIfExists(file);
+    if (text === null) {
+        return {};
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return {};
+    }
+}
+export async function runVersionCommand(ctx) {
+    const pkg = await readPackage();
+    const data = {
+        name: pkg.name ?? "wellspring",
+        version: pkg.version ?? "0.0.0",
+        node: process.versions.node,
+        platform,
+    };
+    ctx.elog.print(`${data.name} ${data.version}`);
+    ctx.elog.print(`node ${data.node}  ${data.platform}`);
+    return success(data);
+}
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAA4C,MAAM,aAAa,CAAA;AAO/E,KAAK,UAAU,WAAW;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAA;IAC5D,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAA;IACzC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAA;IACb,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAmB;IACvD,MAAM,GAAG,GAAG,MAAM,WAAW,EAAE,CAAA;IAC/B,MAAM,IAAI,GAAG;QACT,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,YAAY;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO;QAC/B,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;QAC3B,QAAQ;KACX,CAAA;IACD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IAC9C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;IACrD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC"}

package/dist/config/codes.d.ts

@@ -0,0 +1,13 @@
+/** 配置错误码。字段级错误格式为 `${invalid}:<path>`，path 为英文点分路径 */
+export declare const CONFIG_CODES: {
+    readonly readFailed: "config.read-failed";
+    readonly parseFailed: "config.parse-failed";
+    readonly invalid: "config.invalid";
+    readonly versionUnsupported: "config.version-unsupported";
+    readonly writeFailed: "config.write-failed";
+    readonly invalidApiKey: "config.invalid-api-key";
+    readonly credentialsWriteFailed: "config.credentials-write-failed";
+};
+export type ConfigCode = (typeof CONFIG_CODES)[keyof typeof CONFIG_CODES];
+/** 字段级错误码，例如 config.invalid:logger.level */
+export declare function invalidCode(path: string): string;

package/dist/config/codes.js

@@ -0,0 +1,15 @@
+/** 配置错误码。字段级错误格式为 `${invalid}:<path>`，path 为英文点分路径 */
+export const CONFIG_CODES = {
+    readFailed: "config.read-failed",
+    parseFailed: "config.parse-failed",
+    invalid: "config.invalid",
+    versionUnsupported: "config.version-unsupported",
+    writeFailed: "config.write-failed",
+    invalidApiKey: "config.invalid-api-key",
+    credentialsWriteFailed: "config.credentials-write-failed",
+};
+/** 字段级错误码，例如 config.invalid:logger.level */
+export function invalidCode(path) {
+    return `${CONFIG_CODES.invalid}:${path}`;
+}
+//# sourceMappingURL=codes.js.map

package/dist/config/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../src/config/codes.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,UAAU,EAAE,oBAAoB;IAChC,WAAW,EAAE,qBAAqB;IAClC,OAAO,EAAE,gBAAgB;IACzB,kBAAkB,EAAE,4BAA4B;IAChD,WAAW,EAAE,qBAAqB;IAClC,aAAa,EAAE,wBAAwB;IACvC,sBAAsB,EAAE,iCAAiC;CACnD,CAAA;AAIV,4CAA4C;AAC5C,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAO,GAAG,YAAY,CAAC,OAAO,IAAI,IAAI,EAAE,CAAA;AAC5C,CAAC"}

package/dist/config/credentials.d.ts

@@ -0,0 +1,67 @@
+import { Result } from "../api/result/result.js";
+/** 凭据文件在 config 根目录下的文件名 */
+export declare const CREDENTIALS_FILE_NAME = "credentials.json";
+/** 凭据文件结构版本；v2 增加 providers 分槽，v1 只认 openai */
+export declare const CREDENTIALS_VERSION = 2;
+/** 单个 key 的长度上限，避免把异常输入写进文件 */
+export declare const MAX_API_KEY_CHARS = 4096;
+/** 内置供应商的 id；它的 key 放在 openai 槽，兼容 v1 与 OPENAI_API_KEY */
+export declare const BUILTIN_PROVIDER_ID = "openai";
+/** key 的来源：环境变量或本地凭据文件 */
+export type ApiKeySource = "env" | "credentials";
+export interface ResolvedApiKey {
+    readonly apiKey: string;
+    readonly source: ApiKeySource;
+}
+export interface ApiKeyStatus {
+    readonly configured: boolean;
+    /** 当前生效来源；未配置为 null */
+    readonly source: ApiKeySource | null;
+    /** 掩码后的 key，例如 `sk-…abcd`；未配置为 null */
+    readonly masked: string | null;
+    /** 凭据文件路径，便于界面提示 */
+    readonly file: string;
+    /** 环境变量是否设置（设置时优先于文件） */
+    readonly envOverride: boolean;
+    /** 本地凭据文件里是否有 key（即使被环境变量覆盖也保留，便于界面提供清除） */
+    readonly stored: boolean;
+}
+/** 单个供应商的 Key 状态 */
+export interface ProviderKeyStatus extends ApiKeyStatus {
+    /** 供应商自己的环境变量名；内置为 OPENAI_API_KEY */
+    readonly envVar: string | null;
+}
+/** 供应商凭据来源描述（只用于解析，不含明文） */
+export interface ProviderKeyRef {
+    readonly id: string;
+    readonly apiKeyEnv: string | null;
+}
+/** 默认凭据路径；测试/多环境时可显式传 configDir */
+export declare function credentialsFile(configDir?: string): string;
+/** 列表展示用的掩码；短 key 直接全遮 */
+export declare function maskApiKey(apiKey: string): string;
+/** 校验并规范化用户输入的 key；空白、含控制字符或超长都视为非法 */
+export declare function normalizeApiKey(raw: unknown): string | null;
+/** 某个供应商本地保存的 key（同步） */
+export declare function readProviderApiKeySync(providerId: string, file?: string): string | null;
+/** 某个供应商本地保存的 key（异步） */
+export declare function readProviderApiKey(providerId: string, file?: string): Promise<string | null>;
+/** 默认（内置 openai）供应商本地保存的 key */
+export declare function readStoredApiKeySync(file?: string): string | null;
+export declare function readStoredApiKey(file?: string): Promise<string | null>;
+/** 解析某个供应商的 key：环境变量优先于本地凭据 */
+export declare function resolveProviderApiKeySync(provider: ProviderKeyRef, file?: string): ResolvedApiKey | null;
+/** 解析默认供应商的 key：OPENAI_API_KEY 优先于本地凭据 */
+export declare function resolveApiKeySync(file?: string): ResolvedApiKey | null;
+/** 默认供应商的状态（CLI 与 API Key 弹窗用） */
+export declare function apiKeyStatusSync(file?: string): ApiKeyStatus;
+/** 指定供应商的 Key 状态（掩码） */
+export declare function providerKeyStatusSync(provider: ProviderKeyRef, file?: string): ProviderKeyStatus;
+/** 保存某个供应商的 key；providerId=openai 时写内置槽 */
+export declare function saveProviderApiKey(providerId: string, raw: unknown, file?: string): Promise<Result<void>>;
+/** 清除某个供应商的 key；内置槽清除后 OPENAI_API_KEY 仍可能生效 */
+export declare function clearProviderApiKey(providerId: string, file?: string): Promise<Result<void>>;
+/** 保存默认供应商的 key（兼容旧调用） */
+export declare function saveStoredApiKey(raw: unknown, file?: string): Promise<Result<void>>;
+/** 清除默认供应商的本地 key（兼容旧调用） */
+export declare function clearStoredApiKey(file?: string): Promise<Result<void>>;