myshell-tools 2.0.0 → 2.1.0

package/dist/infra/config.js

@@ -0,0 +1,64 @@
+/**
+ * src/infra/config.ts — Global app configuration persisted at
+ * <homeDir>/.myshell-tools/config.json.
+ *
+ * Reads merge over defaults so that new keys added in future versions are
+ * always present even when the on-disk file pre-dates them.
+ */
+import { mkdir, readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { atomicWrite } from './atomic.js';
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULTS = {
+    onboarded: false,
+    setAsDefault: false,
+};
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function getConfigDir(homeDir) {
+    return join(homeDir, '.myshell-tools');
+}
+function getConfigPath(homeDir) {
+    return join(getConfigDir(homeDir), 'config.json');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Load the global app config.  Returns defaults merged with any on-disk
+ * values so unknown/corrupt files never throw and new keys are always present.
+ */
+export async function loadConfig(homeDir) {
+    const home = homeDir ?? homedir();
+    let raw;
+    try {
+        raw = await readFile(getConfigPath(home), 'utf8');
+    }
+    catch {
+        // Missing file — return defaults
+        return { ...DEFAULTS };
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        // Merge: defaults first, then on-disk values (new keys default safely)
+        return { ...DEFAULTS, ...parsed };
+    }
+    catch {
+        // Corrupt JSON — return defaults
+        return { ...DEFAULTS };
+    }
+}
+/**
+ * Persist the app config atomically.  Creates the `.myshell-tools` directory
+ * if it does not exist.
+ */
+export async function saveConfig(config, homeDir) {
+    const home = homeDir ?? homedir();
+    await mkdir(getConfigDir(home), { recursive: true });
+    await atomicWrite(getConfigPath(home), JSON.stringify(config, null, 2));
+}
+//# sourceMappingURL=config.js.map

package/dist/infra/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/infra/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa1C,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,QAAQ,GAAc;IAC1B,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,KAAK;CACpB,CAAC;AAEF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAgB;IAC/C,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;IAClC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;QACjC,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QACrD,uEAAuE;QACvE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;QACjC,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAiB,EAAE,OAAgB;IAClE,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/infra/conversation-store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * src/infra/conversation-store.ts — the persistent conversation contract.
+ *
+ * The menu UX manages multiple named, persistent conversations. This is the
+ * port both the file-backed implementation (infra) and the menu (interface)
+ * build against. Conversations live in a GLOBAL store (the user's home dir) so
+ * they follow the user across projects; each one is an append-only message log
+ * plus lightweight metadata.
+ *
+ * A conversation's `SessionWriter` is what gets injected into orchestrate() so a
+ * run's messages persist into that conversation.
+ */
+import type { SessionEntry, SessionWriter } from '../core/types.js';
+export interface ConversationMeta {
+    readonly id: string;
+    readonly title: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly messageCount: number;
+    /** Whether this conversation is pinned (sorted to the top of the list). */
+    readonly pinned: boolean;
+    /** Optional short category tag (e.g. "ui", "refactor"); null when unset. */
+    readonly category: string | null;
+}
+export interface ConversationStore {
+    /** All conversations, pinned first then most-recently-updated first. */
+    list(): Promise<ConversationMeta[]>;
+    /** Create a new conversation; returns its metadata (with a fresh id). */
+    create(title: string): Promise<ConversationMeta>;
+    /** Read a conversation's full message history (oldest first); [] if missing. */
+    load(id: string): Promise<SessionEntry[]>;
+    /** Rename a conversation. No-op if the id does not exist. */
+    rename(id: string, title: string): Promise<void>;
+    /** Delete a conversation and its messages. No-op if missing. */
+    remove(id: string): Promise<void>;
+    /** A SessionWriter bound to `id` — appends entries and bumps updatedAt/count. */
+    writer(id: string): SessionWriter;
+    /** Pin or unpin a conversation. No-op if the id does not exist. */
+    setPinned(id: string, pinned: boolean): Promise<void>;
+    /** Set or clear the category tag for a conversation. No-op if id missing. */
+    setCategory(id: string, category: string | null): Promise<void>;
+}

package/dist/infra/conversation-store.js

@@ -0,0 +1,14 @@
+/**
+ * src/infra/conversation-store.ts — the persistent conversation contract.
+ *
+ * The menu UX manages multiple named, persistent conversations. This is the
+ * port both the file-backed implementation (infra) and the menu (interface)
+ * build against. Conversations live in a GLOBAL store (the user's home dir) so
+ * they follow the user across projects; each one is an append-only message log
+ * plus lightweight metadata.
+ *
+ * A conversation's `SessionWriter` is what gets injected into orchestrate() so a
+ * run's messages persist into that conversation.
+ */
+export {};
+//# sourceMappingURL=conversation-store.js.map

package/dist/infra/conversation-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-store.js","sourceRoot":"","sources":["../../src/infra/conversation-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/infra/conversations.d.ts

@@ -0,0 +1,18 @@
+/**
+ * src/infra/conversations.ts — File-backed ConversationStore implementation.
+ *
+ * Storage layout under <homeDir>/.myshell-tools/conversations/:
+ *   index.json       — JSON array of ConversationMeta, newest first
+ *   index.json.lock  — advisory lock for concurrent index mutations
+ *   <id>.jsonl       — one SessionEntry per line (append-only message log)
+ */
+import type { Clock } from '../core/types.js';
+import type { ConversationStore } from './conversation-store.js';
+/**
+ * Create a file-backed ConversationStore that persists conversations under
+ * `<homeDir ?? os.homedir()>/.myshell-tools/conversations/`.
+ */
+export declare function createFileConversationStore(opts: {
+    homeDir?: string;
+    clock: Clock;
+}): ConversationStore;

package/dist/infra/conversations.js

@@ -0,0 +1,296 @@
+/**
+ * src/infra/conversations.ts — File-backed ConversationStore implementation.
+ *
+ * Storage layout under <homeDir>/.myshell-tools/conversations/:
+ *   index.json       — JSON array of ConversationMeta, newest first
+ *   index.json.lock  — advisory lock for concurrent index mutations
+ *   <id>.jsonl       — one SessionEntry per line (append-only message log)
+ */
+import { mkdir, readFile, unlink } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { atomicAppendJSONL, atomicWrite, withLock } from './atomic.js';
+// ---------------------------------------------------------------------------
+// Path helpers (local — conversations dir lives in homeDir, not cwd)
+// ---------------------------------------------------------------------------
+function getConversationsDir(homeDir) {
+    return join(homeDir, '.myshell-tools', 'conversations');
+}
+function getIndexPath(homeDir) {
+    return join(getConversationsDir(homeDir), 'index.json');
+}
+function getIndexLockPath(homeDir) {
+    return join(getConversationsDir(homeDir), 'index.json.lock');
+}
+function getMessagePath(homeDir, id) {
+    return join(getConversationsDir(homeDir), `${id}.jsonl`);
+}
+// ---------------------------------------------------------------------------
+// Internal index helpers
+// ---------------------------------------------------------------------------
+async function ensureDir(homeDir) {
+    await mkdir(getConversationsDir(homeDir), { recursive: true });
+}
+/**
+ * Normalise a raw index entry that may be missing fields added in later
+ * versions (pinned, category). Old on-disk entries that predate these fields
+ * will be migrated transparently on read so existing stores keep working.
+ */
+function normaliseMeta(raw) {
+    const r = raw;
+    return {
+        id: String(r['id'] ?? ''),
+        title: String(r['title'] ?? ''),
+        createdAt: String(r['createdAt'] ?? ''),
+        updatedAt: String(r['updatedAt'] ?? ''),
+        messageCount: typeof r['messageCount'] === 'number' ? r['messageCount'] : 0,
+        pinned: typeof r['pinned'] === 'boolean' ? r['pinned'] : false,
+        category: typeof r['category'] === 'string' ? r['category'] : null,
+    };
+}
+async function readIndex(homeDir) {
+    try {
+        const raw = await readFile(getIndexPath(homeDir), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.map(normaliseMeta);
+    }
+    catch {
+        return [];
+    }
+}
+async function writeIndex(homeDir, index) {
+    await atomicWrite(getIndexPath(homeDir), JSON.stringify(index, null, 2));
+}
+// ---------------------------------------------------------------------------
+// Title extraction: trim + truncate to 80 chars
+// ---------------------------------------------------------------------------
+const MAX_TITLE_LEN = 80;
+function deriveTitle(content) {
+    const trimmed = content.trim();
+    return trimmed.length <= MAX_TITLE_LEN ? trimmed : trimmed.slice(0, MAX_TITLE_LEN);
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a file-backed ConversationStore that persists conversations under
+ * `<homeDir ?? os.homedir()>/.myshell-tools/conversations/`.
+ */
+export function createFileConversationStore(opts) {
+    const { clock } = opts;
+    const home = opts.homeDir ?? homedir();
+    return {
+        // -----------------------------------------------------------------------
+        // list
+        // -----------------------------------------------------------------------
+        async list() {
+            const index = await readIndex(home);
+            return [...index].sort((a, b) => {
+                // Pinned items always come before unpinned
+                if (a.pinned !== b.pinned)
+                    return a.pinned ? -1 : 1;
+                // Within the same pin group, most-recently-updated first
+                return a.updatedAt < b.updatedAt ? 1 : -1;
+            });
+        },
+        // -----------------------------------------------------------------------
+        // create
+        // -----------------------------------------------------------------------
+        async create(title) {
+            await ensureDir(home);
+            const id = clock.uuid();
+            const now = clock.isoNow();
+            const meta = {
+                id,
+                title,
+                createdAt: now,
+                updatedAt: now,
+                messageCount: 0,
+                pinned: false,
+                category: null,
+            };
+            await withLock(getIndexLockPath(home), async () => {
+                const index = await readIndex(home);
+                await writeIndex(home, [meta, ...index]);
+            });
+            return meta;
+        },
+        // -----------------------------------------------------------------------
+        // load
+        // -----------------------------------------------------------------------
+        async load(id) {
+            let raw;
+            try {
+                raw = await readFile(getMessagePath(home, id), 'utf8');
+            }
+            catch (err) {
+                const nodeErr = err;
+                if (nodeErr.code === 'ENOENT')
+                    return [];
+                throw err;
+            }
+            const entries = [];
+            for (const line of raw.split('\n')) {
+                const trimmed = line.trim();
+                if (trimmed.length === 0)
+                    continue;
+                try {
+                    entries.push(JSON.parse(trimmed));
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+            return entries;
+        },
+        // -----------------------------------------------------------------------
+        // writer
+        // -----------------------------------------------------------------------
+        writer(id) {
+            return {
+                id,
+                async append(entry) {
+                    await ensureDir(home);
+                    // Append the entry to the conversation's JSONL file
+                    await atomicAppendJSONL(getMessagePath(home, id), entry);
+                    // Update index under lock
+                    await withLock(getIndexLockPath(home), async () => {
+                        const index = await readIndex(home);
+                        const idx = index.findIndex((m) => m.id === id);
+                        if (idx === -1)
+                            return;
+                        const existing = index[idx];
+                        if (existing === undefined)
+                            return;
+                        const updatedAt = clock.isoNow();
+                        const messageCount = existing.messageCount + 1;
+                        // If this is a user message and the title is still the placeholder,
+                        // use the message content as the title (first user message wins).
+                        let title = existing.title;
+                        if (entry.role === 'user' &&
+                            entry.content &&
+                            (title.trim().length === 0 || title === existing.title) &&
+                            existing.messageCount === 0) {
+                            title = deriveTitle(entry.content);
+                        }
+                        const updated = {
+                            id: existing.id,
+                            title,
+                            createdAt: existing.createdAt,
+                            updatedAt,
+                            messageCount,
+                            pinned: existing.pinned,
+                            category: existing.category,
+                        };
+                        const newIndex = [...index];
+                        newIndex[idx] = updated;
+                        await writeIndex(home, newIndex);
+                    });
+                },
+            };
+        },
+        // -----------------------------------------------------------------------
+        // rename
+        // -----------------------------------------------------------------------
+        async rename(id, title) {
+            await withLock(getIndexLockPath(home), async () => {
+                const index = await readIndex(home);
+                const idx = index.findIndex((m) => m.id === id);
+                if (idx === -1)
+                    return;
+                const existing = index[idx];
+                if (existing === undefined)
+                    return;
+                const updated = {
+                    id: existing.id,
+                    title,
+                    createdAt: existing.createdAt,
+                    updatedAt: existing.updatedAt,
+                    messageCount: existing.messageCount,
+                    pinned: existing.pinned,
+                    category: existing.category,
+                };
+                const newIndex = [...index];
+                newIndex[idx] = updated;
+                await writeIndex(home, newIndex);
+            });
+        },
+        // -----------------------------------------------------------------------
+        // remove
+        // -----------------------------------------------------------------------
+        async remove(id) {
+            // Best-effort delete of message file
+            try {
+                await unlink(getMessagePath(home, id));
+            }
+            catch {
+                // Missing or already gone — ignore
+            }
+            // Remove from index under lock
+            await withLock(getIndexLockPath(home), async () => {
+                const index = await readIndex(home);
+                const filtered = index.filter((m) => m.id !== id);
+                if (filtered.length === index.length)
+                    return; // not found, no-op
+                await writeIndex(home, filtered);
+            });
+        },
+        // -----------------------------------------------------------------------
+        // setPinned
+        // -----------------------------------------------------------------------
+        async setPinned(id, pinned) {
+            await ensureDir(home);
+            await withLock(getIndexLockPath(home), async () => {
+                const index = await readIndex(home);
+                const idx = index.findIndex((m) => m.id === id);
+                if (idx === -1)
+                    return; // no-op if missing
+                const existing = index[idx];
+                if (existing === undefined)
+                    return;
+                const updated = {
+                    id: existing.id,
+                    title: existing.title,
+                    createdAt: existing.createdAt,
+                    updatedAt: existing.updatedAt,
+                    messageCount: existing.messageCount,
+                    pinned,
+                    category: existing.category,
+                };
+                const newIndex = [...index];
+                newIndex[idx] = updated;
+                await writeIndex(home, newIndex);
+            });
+        },
+        // -----------------------------------------------------------------------
+        // setCategory
+        // -----------------------------------------------------------------------
+        async setCategory(id, category) {
+            await ensureDir(home);
+            await withLock(getIndexLockPath(home), async () => {
+                const index = await readIndex(home);
+                const idx = index.findIndex((m) => m.id === id);
+                if (idx === -1)
+                    return; // no-op if missing
+                const existing = index[idx];
+                if (existing === undefined)
+                    return;
+                const updated = {
+                    id: existing.id,
+                    title: existing.title,
+                    createdAt: existing.createdAt,
+                    updatedAt: existing.updatedAt,
+                    messageCount: existing.messageCount,
+                    pinned: existing.pinned,
+                    category,
+                };
+                const newIndex = [...index];
+                newIndex[idx] = updated;
+                await writeIndex(home, newIndex);
+            });
+        },
+    };
+}
+//# sourceMappingURL=conversations.js.map

package/dist/infra/conversations.js.map

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

package/dist/infra/insights.d.ts

@@ -0,0 +1,66 @@
+/**
+ * src/infra/insights.ts — Pure reducers over LedgerEntry[] for spend and provider health.
+ *
+ * No I/O. All functions are deterministic given the same inputs.
+ * Safe to call in tests with hand-built arrays.
+ *
+ * Honesty Contract:
+ *   - No hardcoded percentages — success rates are always computed from data.
+ *   - No digit-% literals in source — percent strings are built by concatenation.
+ *   - No fabricated values — all outputs derive strictly from the input entries.
+ */
+import type { LedgerEntry } from '../core/types.js';
+/** Aggregated spend data suitable for display in the control panel header. */
+export interface SpendSummary {
+    /** Total USD spent in the current calendar day (UTC). */
+    readonly todayUsd: number;
+    /** Total USD spent across all time. */
+    readonly totalUsd: number;
+    /** Total number of ledger entries (calls). */
+    readonly calls: number;
+    /** Per-provider breakdown keyed by ProviderId string. */
+    readonly byProvider: Record<string, {
+        readonly usd: number;
+        readonly calls: number;
+    }>;
+}
+/**
+ * Pure reduction over LedgerEntry[] that produces a SpendSummary.
+ *
+ * "Today" is defined as entries whose `timestamp` ISO string has the same
+ * YYYY-MM-DD date prefix as `nowIso`. Both are treated as UTC.
+ *
+ * @param entries - Array of LedgerEntry objects (may be empty).
+ * @param nowIso  - ISO-8601 timestamp representing "now" (e.g. from Clock.isoNow()).
+ */
+export declare function summarizeSpend(entries: LedgerEntry[], nowIso: string): SpendSummary;
+/** Health summary for a single provider derived from its ledger entries. */
+export interface ProviderHealth {
+    readonly provider: string;
+    readonly calls: number;
+    /** Fraction of successful calls in [0, 1]. 0 when calls === 0. */
+    readonly successRate: number;
+    /** Arithmetic mean of durationMs. 0 when calls === 0. */
+    readonly avgDurationMs: number;
+    readonly status: 'healthy' | 'degraded' | 'unknown';
+}
+/**
+ * Compute per-provider health from a LedgerEntry array.
+ *
+ * Status thresholds:
+ *   - `unknown`  — 0 calls
+ *   - `degraded` — successRate < 0.7
+ *   - `healthy`  — successRate >= 0.7
+ *
+ * @param entries - Array of LedgerEntry objects (may be empty).
+ */
+export declare function providerHealth(entries: LedgerEntry[]): ProviderHealth[];
+/**
+ * Format a USD amount as a string with a `$` prefix and 4 decimal places.
+ *
+ * The result never contains a digit immediately before `%` — this is a dollar
+ * amount, not a percentage.
+ *
+ * @param n - Amount in US dollars (may be 0).
+ */
+export declare function formatUsd(n: number): string;

package/dist/infra/insights.js

@@ -0,0 +1,105 @@
+/**
+ * src/infra/insights.ts — Pure reducers over LedgerEntry[] for spend and provider health.
+ *
+ * No I/O. All functions are deterministic given the same inputs.
+ * Safe to call in tests with hand-built arrays.
+ *
+ * Honesty Contract:
+ *   - No hardcoded percentages — success rates are always computed from data.
+ *   - No digit-% literals in source — percent strings are built by concatenation.
+ *   - No fabricated values — all outputs derive strictly from the input entries.
+ */
+/**
+ * Pure reduction over LedgerEntry[] that produces a SpendSummary.
+ *
+ * "Today" is defined as entries whose `timestamp` ISO string has the same
+ * YYYY-MM-DD date prefix as `nowIso`. Both are treated as UTC.
+ *
+ * @param entries - Array of LedgerEntry objects (may be empty).
+ * @param nowIso  - ISO-8601 timestamp representing "now" (e.g. from Clock.isoNow()).
+ */
+export function summarizeSpend(entries, nowIso) {
+    const todayDate = nowIso.slice(0, 10); // 'YYYY-MM-DD'
+    let todayUsd = 0;
+    let totalUsd = 0;
+    const byProvider = {};
+    for (const entry of entries) {
+        totalUsd += entry.usd;
+        if (entry.timestamp.slice(0, 10) === todayDate) {
+            todayUsd += entry.usd;
+        }
+        const existing = byProvider[entry.provider];
+        if (existing !== undefined) {
+            existing.usd += entry.usd;
+            existing.calls += 1;
+        }
+        else {
+            byProvider[entry.provider] = { usd: entry.usd, calls: 1 };
+        }
+    }
+    return {
+        todayUsd,
+        totalUsd,
+        calls: entries.length,
+        byProvider,
+    };
+}
+/**
+ * Compute per-provider health from a LedgerEntry array.
+ *
+ * Status thresholds:
+ *   - `unknown`  — 0 calls
+ *   - `degraded` — successRate < 0.7
+ *   - `healthy`  — successRate >= 0.7
+ *
+ * @param entries - Array of LedgerEntry objects (may be empty).
+ */
+export function providerHealth(entries) {
+    const byProvider = {};
+    for (const entry of entries) {
+        const existing = byProvider[entry.provider];
+        if (existing !== undefined) {
+            existing.calls += 1;
+            existing.successes += entry.success ? 1 : 0;
+            existing.durationMs += entry.durationMs;
+        }
+        else {
+            byProvider[entry.provider] = {
+                calls: 1,
+                successes: entry.success ? 1 : 0,
+                durationMs: entry.durationMs,
+            };
+        }
+    }
+    return Object.entries(byProvider).map(([provider, agg]) => {
+        const { calls, successes, durationMs } = agg;
+        const successRate = calls === 0 ? 0 : successes / calls;
+        const avgDurationMs = calls === 0 ? 0 : durationMs / calls;
+        let status;
+        if (calls === 0) {
+            status = 'unknown';
+        }
+        else if (successRate < 0.7) {
+            status = 'degraded';
+        }
+        else {
+            status = 'healthy';
+        }
+        return { provider, calls, successRate, avgDurationMs, status };
+    });
+}
+// ---------------------------------------------------------------------------
+// formatUsd
+// ---------------------------------------------------------------------------
+/**
+ * Format a USD amount as a string with a `$` prefix and 4 decimal places.
+ *
+ * The result never contains a digit immediately before `%` — this is a dollar
+ * amount, not a percentage.
+ *
+ * @param n - Amount in US dollars (may be 0).
+ */
+export function formatUsd(n) {
+    return '$' + n.toFixed(4);
+}
+//# sourceMappingURL=insights.js.map

package/dist/infra/insights.js.map

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

package/dist/infra/ledger.d.ts

@@ -23,16 +23,14 @@ export declare function createLedger(opts: {
  * @param cwd - The project working directory.
  */
 export declare function readLedger(cwd: string): Promise<LedgerEntry[]>;
-/** Per-model aggregation used in the summary. */
-export interface ModelSummary {
-    readonly calls: number;
-    readonly usd: number;
-}
 /** Aggregate summary returned by `summarizeLedger`. */
 export interface LedgerSummary {
     readonly totalUsd: number;
     readonly calls: number;
-    readonly byModel: Record<string, ModelSummary>;
+    readonly byModel: Record<string, {
+        readonly calls: number;
+        readonly usd: number;
+    }>;
 }
 /**
  * Pure reduction over a ledger entry array.