mindweave 0.0.1 → 2.1.2

package/dist/cli/groupReveal.js

@@ -0,0 +1,51 @@
+/**
+ * groupReveal.ts — the pure decision for HOW to reveal a NEW discovery group
+ * (a burst of file reads folding into one "● Read N files" row).
+ *
+ * Revealing a group's opening call the instant it happens meant it showed up
+ * bare — "Reading 2 files…" with nothing under it — then visibly grew into its
+ * finished shape once the reads resolved. The reference design never shows
+ * that transient state at all: every block in it is already resolved.
+ *
+ * So a NEW group is held — not dispatched — until it's SETTLED: the model has
+ * moved on to something else, detected by a later, non-group action already
+ * queued behind its opening call. At that point the whole burst reveals at
+ * once, fully resolved — header and complete list together, never a
+ * transition. There is deliberately no time-based fallback that shows partial
+ * progress after a grace period: between two SEQUENTIAL reads in a real turn
+ * there's a full model round-trip (seconds, not the single-digit milliseconds
+ * a local file read takes), so any short grace elapses almost every time and
+ * the group ends up shown live-updating anyway — exactly the bug this file
+ * exists to avoid. The hold can't get stuck forever either way: every turn
+ * ends with a `finishReply` action that goes through the same queue, which
+ * counts as "not a group member" and settles any group still open.
+ */
+/** Whether an action is part of an in-progress group's burst — a further
+ *  grouped call opening, or any tool's end resolving. */
+export function isGroupMember(a) {
+    return (a.type === "toolStart" && a.group === true) || a.type === "toolEnd";
+}
+/** Has the model already moved past this group? True once something that
+ *  ISN'T part of the burst has queued up behind its opening call. */
+export function groupSettled(queueAfterFront) {
+    return queueAfterFront.some((a) => !isGroupMember(a));
+}
+/**
+ * Whether a STANDALONE tool call may be shown yet: only once its own result is
+ * queued behind it, so the row arrives already carrying its diff/output instead
+ * of appearing as a bare `Update(home.html)` that grows a body a beat later.
+ *
+ * Same principle as the group hold above, and the same absence of a timer. The
+ * caller releases the hold when the stream ends (no further event can arrive) or
+ * when the user flushes with Esc.
+ */
+export function resultQueued(toolId, queue) {
+    return queue.some((a) => a.type === "toolEnd" && a.toolId === toolId);
+}
+/** Decide how to reveal a new group's opening call: settled (or flushing
+ *  outright, Esc) → "flush" the whole burst at once; otherwise "hold" — there
+ *  is no partial/progress state, see the file header for why. */
+export function planGroupReveal(settled, flushing) {
+    return settled || flushing ? "flush" : "hold";
+}
+//# sourceMappingURL=groupReveal.js.map

package/dist/cli/groupReveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupReveal.js","sourceRoot":"","sources":["../../src/cli/groupReveal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;yDACyD;AACzD,MAAM,UAAU,aAAa,CAAC,CAAoC;IAChE,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;AAC9E,CAAC;AAED;qEACqE;AACrE,MAAM,UAAU,YAAY,CAAC,eAA6D;IACxF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAmD;IAC9F,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AACxE,CAAC;AAID;;iEAEiE;AACjE,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,QAAiB;IACjE,OAAO,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC"}

package/dist/cli/help.js

@@ -0,0 +1,55 @@
+/**
+ * help.ts — what `/help` prints.
+ *
+ * Rendered from the SAME command list the input's autocomplete offers, plus the
+ * project skills and MCP prompts that are live in this session. A second
+ * hand-maintained list of commands would be a literal standing in for something
+ * that already has a source of truth, and it would go stale the first time a
+ * command was added — see BOUNDARY.md.
+ *
+ * Pure: takes the lists, returns the text. The caller does the gathering.
+ */
+/** Right-pad a command name so the descriptions line up in a column. */
+function column(commands) {
+    return commands.reduce((w, c) => Math.max(w, c.name.length), 0);
+}
+/**
+ * Render the help text. Sections with no commands are omitted entirely, so a
+ * project with no skills and no MCP servers sees a clean list rather than empty
+ * headings.
+ */
+export function formatHelp(sections) {
+    const live = sections.filter((s) => s.commands.length > 0);
+    // One column width across ALL sections, so the descriptions form a single
+    // aligned edge rather than restarting per heading.
+    const width = column(live.flatMap((s) => [...s.commands]));
+    const blocks = live.map((s) => {
+        const rows = s.commands.map((c) => `  ${c.name.padEnd(width)}  ${c.description}`);
+        return `${s.title}\n${rows.join("\n")}`;
+    });
+    return [
+        ...blocks,
+        // The two things a new user needs that have no other discovery path: there is
+        // no autocomplete entry for either, and nothing else mentions them.
+        "Also\n" +
+            "  @path             attach a file to your message (Tab completes the path)\n" +
+            "  Esc               stop what's running\n" +
+            // The input stays live while a turn runs and the placeholder says so, so
+            // QUEUEING is discoverable. Getting back OUT of the queue is not: nothing on
+            // screen mentions it until something is already queued, and by then a user who
+            // has changed their mind is looking for a way to undo, not to read a hint.
+            "  ↑                 take back a message you queued while it was working",
+        // Sub-agents are the one part of the machinery that visibly does something on
+        // screen without explaining itself: a rail of tool calls appears under a worker
+        // that is not the agent you were talking to. What it costs you and what it hands
+        // back is worth stating ONCE, here, rather than on every delegation.
+        "About sub-agents\n" +
+            "  Mindweave can hand a wide, self-contained job to a sub-agent — a sweeping\n" +
+            "  search, an inventory, a bounded refactor — and work from what it reports back.\n" +
+            "  Their raw tool loops and output never enter the main conversation, so a large\n" +
+            "  search costs you a summary instead of a hundred results. They return finished\n" +
+            "  work (a patch, an answer), compact their own context independently, and cannot\n" +
+            "  change files unless the job they were given is a job that changes files.",
+    ].join("\n\n");
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,wEAAwE;AACxE,SAAS,MAAM,CAAC,QAAgC;IAC9C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgC;IACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,0EAA0E;IAC1E,mDAAmD;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAClF,OAAO,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,MAAM;QACT,8EAA8E;QAC9E,oEAAoE;QACpE,QAAQ;YACN,8EAA8E;YAC9E,2CAA2C;YAC3C,yEAAyE;YACzE,6EAA6E;YAC7E,+EAA+E;YAC/E,2EAA2E;YAC3E,yEAAyE;QAC3E,8EAA8E;QAC9E,gFAAgF;QAChF,iFAAiF;QACjF,qEAAqE;QACrE,oBAAoB;YAClB,+EAA+E;YAC/E,oFAAoF;YACpF,mFAAmF;YACnF,mFAAmF;YACnF,oFAAoF;YACpF,4EAA4E;KAC/E,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC"}

package/dist/cli/inputView.js

@@ -0,0 +1,105 @@
+/**
+ * inputView.ts — what the prompt box actually shows: the buffer wrapped into rows,
+ * windowed to a height the frame can afford, with the cursor's exact position.
+ *
+ * Pure, and separate from the component, because the two things that go wrong here are
+ * both arithmetic. A buffer that wraps to more rows than the frame can spare pushes the
+ * tip line off the bottom of the screen (measured — that is the glitch this fixes), and
+ * a cursor mapped onto the wrong row is worse than no cursor at all. Neither is
+ * observable from a typecheck, and both are trivial to assert on a plain string array.
+ *
+ * The wrap records where each row STARTED in the original buffer, which is what makes
+ * the cursor exact. Wrapping and then trying to guess the offset back is where an
+ * off-by-one lives: a word break silently drops the space it broke on, so the rendered
+ * text is shorter than the source it came from.
+ */
+/**
+ * Greedy word-wrap that remembers offsets (pure).
+ *
+ * Explicit newlines always break. A word longer than the width is split rather than
+ * allowed to overflow — an unbroken 300-character URL must not push the box wider than
+ * the terminal.
+ */
+export function wrapWithOffsets(text, width) {
+    const w = Math.max(1, width);
+    const rows = [];
+    let lineStart = 0;
+    for (const line of splitKeepingOffsets(text)) {
+        if (line.text.length === 0) {
+            rows.push({ text: "", start: line.start });
+            continue;
+        }
+        let i = 0;
+        while (i < line.text.length) {
+            if (line.text.length - i <= w) {
+                rows.push({ text: line.text.slice(i), start: line.start + i });
+                break;
+            }
+            // Break on the last space that fits; if there is none, the word is longer than
+            // the row and gets split at the edge.
+            const slice = line.text.slice(i, i + w + 1);
+            const lastSpace = slice.lastIndexOf(" ");
+            const take = lastSpace > 0 ? lastSpace : w;
+            rows.push({ text: line.text.slice(i, i + take), start: line.start + i });
+            // Skip the single space we broke on; any others belong to the next row.
+            i += take + (lastSpace > 0 ? 1 : 0);
+        }
+        lineStart = line.start + line.text.length + 1;
+    }
+    void lineStart;
+    return rows.length > 0 ? rows : [{ text: "", start: 0 }];
+}
+/** Split on newlines, keeping each line's offset in the original string. */
+function splitKeepingOffsets(text) {
+    const out = [];
+    let start = 0;
+    for (;;) {
+        const nl = text.indexOf("\n", start);
+        if (nl === -1) {
+            out.push({ text: text.slice(start), start });
+            return out;
+        }
+        out.push({ text: text.slice(start, nl), start });
+        start = nl + 1;
+    }
+}
+/**
+ * The rows to draw and where the cursor sits among them.
+ *
+ * `maxRows` is a hard ceiling on the box's height. Beyond it the view scrolls with the
+ * cursor rather than growing, because the prompt shares a fixed frame with the chat and
+ * the tip line: a box allowed to grow without limit takes those rows from the bottom of
+ * the screen, which is exactly what it looks like when the tip disappears.
+ */
+export function inputView(value, cursor, width, maxRows) {
+    const all = wrapWithOffsets(value, width);
+    const clampedCursor = Math.max(0, Math.min(cursor, value.length));
+    // The LAST row whose start is at or before the cursor. Searching for the first row
+    // that contains it would put a cursor sitting exactly on a break at the end of the
+    // previous row instead of the start of the next, which is where the caret belongs
+    // after typing the character that caused the break.
+    let row = 0;
+    for (let i = 0; i < all.length; i++) {
+        if (all[i].start <= clampedCursor)
+            row = i;
+        else
+            break;
+    }
+    const cursorCol = Math.max(0, Math.min(clampedCursor - all[row].start, all[row].text.length));
+    const cap = Math.max(1, maxRows);
+    if (all.length <= cap) {
+        return { rows: all, cursorRow: row, cursorCol, hiddenAbove: 0, hiddenBelow: 0 };
+    }
+    // Keep the cursor in view, preferring to show as much as possible BEFORE it — when
+    // typing you care about what you have just written, not the tail you are pushing down.
+    let first = Math.min(Math.max(0, row - (cap - 1)), all.length - cap);
+    first = Math.max(0, first);
+    return {
+        rows: all.slice(first, first + cap),
+        cursorRow: row - first,
+        cursorCol,
+        hiddenAbove: first,
+        hiddenBelow: all.length - (first + cap),
+    };
+}
+//# sourceMappingURL=inputView.js.map

package/dist/cli/inputView.js.map

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

package/dist/cli/keyManager.js

@@ -0,0 +1,65 @@
+/**
+ * keyManager.ts — the rows /key shows, as plain data.
+ *
+ * Three levels, because a provider is not one key. PROVIDERS first, then that provider's
+ * KEYS with an "add another" that never runs out, then what can be done to one key. A
+ * flat list of every key across every provider was the first attempt and it buried the
+ * thing people actually came to do: manage the keys of one provider.
+ *
+ * Derived here rather than in the view so "how many keys does this provider have",
+ * "which one is being sent" and "what can be done to it" are answerable without
+ * rendering anything.
+ */
+import { allProviders } from "../drivers/registry.js";
+import { activeSlot, keyHint, keysFor, nextFreeSlot } from "./keyStore.js";
+/** Every provider, with how many keys it holds. */
+export function providerRows(env = process.env) {
+    return allProviders().map((p) => ({
+        id: p.id,
+        label: p.label,
+        apiKeyEnv: p.apiKeyEnv,
+        count: keysFor(p.apiKeyEnv, env).length,
+    }));
+}
+/** One provider's keys, in slot order. */
+export function keyRowsFor(provider, env = process.env) {
+    const live = activeSlot(provider.apiKeyEnv, env);
+    return keysFor(provider.apiKeyEnv, env).map((k) => ({
+        label: provider.label,
+        apiKeyEnv: provider.apiKeyEnv,
+        slot: k.slot,
+        hint: keyHint(k.value),
+        active: k.slot === live,
+    }));
+}
+/** Where the next key for this provider would go, or null when it is full. */
+export function nextSlotFor(provider, env = process.env) {
+    return nextFreeSlot(provider.apiKeyEnv, env);
+}
+/** How a provider's key count reads on the provider list. */
+export function countLabel(count) {
+    return count === 0 ? "no key yet" : `${count} key${count === 1 ? "" : "s"}`;
+}
+export const ACTION_SHOW = "Show the key";
+export const ACTION_ACTIVATE = "Make this the active key";
+export const ACTION_EDIT = "Edit it";
+export const ACTION_REMOVE = "Remove it";
+export const ACTION_BACK = "Back";
+/**
+ * What can be done to one key.
+ *
+ * "Make this the active key" is left out when it already is — an action that does
+ * nothing is worse than an absent one, because the user tries it and learns nothing.
+ * Removing a provider's only key IS allowed: it is how a wrong key gets corrected, and
+ * the row says what it will cost rather than refusing.
+ */
+export function actionsFor(row, keysForProvider) {
+    return [
+        ACTION_SHOW,
+        ...(row.active ? [] : [ACTION_ACTIVATE]),
+        ACTION_EDIT,
+        keysForProvider === 1 ? `${ACTION_REMOVE} (the only key)` : ACTION_REMOVE,
+        ACTION_BACK,
+    ];
+}
+//# sourceMappingURL=keyManager.js.map

package/dist/cli/keyManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyManager.js","sourceRoot":"","sources":["../../src/cli/keyManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAoB3E,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC/D,OAAO,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,MAAM;KACxC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,QAAqB,EAAE,MAAyB,OAAO,CAAC,GAAG;IACpF,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACjD,OAAO,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACtB,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI;KACxB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,QAAqB,EAAE,MAAyB,OAAO,CAAC,GAAG;IACrF,OAAO,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAC1D,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,eAAuB;IAC7D,OAAO;QACL,WAAW;QACX,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACxC,WAAW;QACX,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,iBAAiB,CAAC,CAAC,CAAC,aAAa;QACzE,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/cli/keySetup.js

@@ -0,0 +1,35 @@
+/**
+ * keySetup.ts — what the first-run setup screen offers, as plain data.
+ *
+ * The old screen asked for ONE provider's key, the default one, and had no way past it.
+ * Mindweave speaks to thirteen, and which one a new user already has an account with is
+ * not something we can guess — so the screen shows the same list `/provider` does and
+ * lets them fill in as many as they like before going in.
+ *
+ * The rows are derived here rather than in the view, so "is Continue available", "which
+ * ones are already set up" and "what order are they in" can be checked without rendering
+ * anything.
+ */
+import { allProviders } from "../drivers/registry.js";
+export function setupView(hasKey) {
+    const rows = allProviders().map((p) => ({
+        id: p.id,
+        label: p.label,
+        envVar: p.apiKeyEnv,
+        keysUrl: p.keysUrl,
+        ready: hasKey(p.apiKeyEnv),
+    }));
+    const readyCount = rows.filter((r) => r.ready).length;
+    return { rows, readyCount, canContinue: readyCount > 0 };
+}
+/**
+ * Which row to land on when the screen opens.
+ *
+ * The first provider WITHOUT a key, so adding a second or third key does not start by
+ * re-offering one already done. Falls back to the top when everything is set up.
+ */
+export function initialRow(view) {
+    const next = view.rows.findIndex((r) => !r.ready);
+    return next === -1 ? 0 : next;
+}
+//# sourceMappingURL=keySetup.js.map

package/dist/cli/keySetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keySetup.js","sourceRoot":"","sources":["../../src/cli/keySetup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA0BtD,MAAM,UAAU,SAAS,CAAC,MAAmC;IAC3D,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,SAAS;QACnB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;KAC3B,CAAC,CAAC,CAAC;IACJ,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACtD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,GAAG,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC"}

package/dist/cli/keyStore.js

@@ -0,0 +1,73 @@
+/**
+ * keyStore.ts — more than one key per provider.
+ *
+ * A provider is not one credential. People hold a work key and a personal one, a free
+ * key that rate-limits and a paid one that does not, a key with credit and one that ran
+ * out. Mindweave held exactly one per provider, so the answer to "this key stopped
+ * answering" was to go and edit a file.
+ *
+ * TWO ROLES, TWO VARIABLES, and they must not be the same one. Keys are STORED as
+ * `DEEPSEEK_API_KEY_1`, `_2`, `_3`; the bare `DEEPSEEK_API_KEY` is the one currently
+ * LIVE, which is what every driver reads. Every driver therefore stays unchanged, and
+ * the file stays something a person can open and edit.
+ *
+ * The first attempt used the bare name as both slot 1 and the live key, which reads
+ * neatly and destroys data: switching to key 3 overwrote the variable that WAS key 1, so
+ * key 1 was gone and removing another key duplicated key 3 into its place. Found by
+ * exercising add → use → remove and reading the file back, not by reading the code.
+ *
+ * A bare variable with no numbered ones is still honoured as slot 1 — that is how an
+ * existing config, or a key exported in the shell, keeps working — and it is normalised
+ * into `_1` the first time anything is written.
+ */
+/** How many keys one provider may hold. Past this the list stops being a list. */
+export const MAX_SLOTS = 9;
+/** The variable a slot is STORED under. Never the bare name — that one is the live key. */
+export function slotVar(apiKeyEnv, slot) {
+    return `${apiKeyEnv}_${slot}`;
+}
+/** Every key stored for a provider, in slot order, skipping empty slots. */
+export function keysFor(apiKeyEnv, env = process.env) {
+    const out = [];
+    for (let slot = 1; slot <= MAX_SLOTS; slot++) {
+        const envVar = slotVar(apiKeyEnv, slot);
+        const value = env[envVar]?.trim();
+        if (value)
+            out.push({ slot, envVar, value });
+    }
+    // An existing config, or a shell export, has only the bare variable. It counts as the
+    // one stored key so nothing a user already had disappears from the list.
+    if (out.length === 0) {
+        const legacy = env[apiKeyEnv]?.trim();
+        if (legacy)
+            return [{ slot: 1, envVar: slotVar(apiKeyEnv, 1), value: legacy }];
+    }
+    return out;
+}
+/** The next free slot, or null when the provider is full. */
+export function nextFreeSlot(apiKeyEnv, env = process.env) {
+    for (let slot = 1; slot <= MAX_SLOTS; slot++) {
+        if (!env[slotVar(apiKeyEnv, slot)]?.trim())
+            return slot;
+    }
+    return null;
+}
+/**
+ * A key's last four characters, for telling two of them apart on screen.
+ *
+ * Never the whole key, and never the FIRST characters: a provider prefix like `sk-ant-`
+ * is identical across a user's keys, so it would distinguish nothing while still putting
+ * part of a credential on a screen someone might be sharing.
+ */
+export function keyHint(value) {
+    const tail = value.trim().slice(-4);
+    return tail ? `…${tail}` : "";
+}
+/** Which stored key the drivers are actually sending, or null when none is live. */
+export function activeSlot(apiKeyEnv, env = process.env) {
+    const live = env[apiKeyEnv]?.trim();
+    if (!live)
+        return null;
+    return keysFor(apiKeyEnv, env).find((k) => k.value === live)?.slot ?? null;
+}
+//# sourceMappingURL=keyStore.js.map

package/dist/cli/keyStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyStore.js","sourceRoot":"","sources":["../../src/cli/keyStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAE3B,2FAA2F;AAC3F,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,IAAY;IACrD,OAAO,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC;AAChC,CAAC;AAQD,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC7E,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QAClC,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,sFAAsF;IACtF,yEAAyE;IACzE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;QACtC,IAAI,MAAM;YAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAClF,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;YAAE,OAAO,IAAI,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAChC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAChF,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;AAC7E,CAAC"}