muonroi-cli 1.2.0

package/dist/ui/status-bar/tier-badge.test.js

@@ -0,0 +1,34 @@
+/**
+ * tier-badge.test.tsx -- tests for TierBadge component.
+ */
+import { describe, expect, it } from "vitest";
+import { TierBadge } from "./tier-badge.js";
+describe("TierBadge", () => {
+    it("renders hot with green color", () => {
+        const el = TierBadge({ tier: "hot" });
+        expect(el.props.fg).toBe("green");
+        expect(el.props.children).toBe("hot");
+        expect(el.props["data-tier"]).toBe("hot");
+    });
+    it("renders warm with cyan color", () => {
+        const el = TierBadge({ tier: "warm" });
+        expect(el.props.fg).toBe("cyan");
+        expect(el.props.children).toBe("warm");
+    });
+    it("renders cold with magenta color", () => {
+        const el = TierBadge({ tier: "cold" });
+        expect(el.props.fg).toBe("magenta");
+        expect(el.props.children).toBe("cold");
+    });
+    it("renders degraded with yellow and blink", () => {
+        const el = TierBadge({ tier: "degraded" });
+        expect(el.props.fg).toBe("yellow");
+        expect(el.props.blink).toBe(true);
+        expect(el.props.children).toBe("degraded");
+    });
+    it("does not blink for non-degraded tiers", () => {
+        const el = TierBadge({ tier: "hot" });
+        expect(el.props.blink).toBeFalsy();
+    });
+});
+//# sourceMappingURL=tier-badge.test.js.map

package/dist/ui/status-bar/tier-badge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-badge.test.js","sourceRoot":"","sources":["../../../src/ui/status-bar/tier-badge.test.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAQ,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAQ,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAQ,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAQ,CAAC;QAClD,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAQ,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/ui/status-bar/usd-meter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * src/ui/status-bar/usd-meter.tsx
+ *
+ * USD meter sub-component: session + month with threshold color escalation.
+ * white < 50%, cyan >= 50%, yellow >= 80%, red >= 100%.
+ */
+import * as React from "react";
+export interface UsdMeterProps {
+    session_usd: number;
+    month_usd: number;
+    current_pct: number;
+}
+export declare function UsdMeter({ session_usd, month_usd, current_pct }: UsdMeterProps): React.ReactElement;

package/dist/ui/status-bar/usd-meter.js

@@ -0,0 +1,13 @@
+/**
+ * src/ui/status-bar/usd-meter.tsx
+ *
+ * USD meter sub-component: session + month with threshold color escalation.
+ * white < 50%, cyan >= 50%, yellow >= 80%, red >= 100%.
+ */
+import * as React from "react";
+export function UsdMeter({ session_usd, month_usd, current_pct }) {
+    const color = current_pct >= 100 ? "red" : current_pct >= 80 ? "yellow" : current_pct >= 50 ? "cyan" : "white";
+    const text = `session: $${session_usd.toFixed(2)} | month: $${month_usd.toFixed(2)}`;
+    return React.createElement("text", { fg: color, "data-testid": "usd-meter", "data-pct": current_pct }, text);
+}
+//# sourceMappingURL=usd-meter.js.map

package/dist/ui/status-bar/usd-meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usd-meter.js","sourceRoot":"","sources":["../../../src/ui/status-bar/usd-meter.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,UAAU,QAAQ,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAiB;IAC7E,MAAM,KAAK,GAAG,WAAW,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAE/G,MAAM,IAAI,GAAG,aAAa,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAErF,OAAO,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;AAC/G,CAAC"}

package/dist/ui/status-bar/usd-meter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ui/status-bar/usd-meter.test.js

@@ -0,0 +1,32 @@
+/**
+ * usd-meter.test.tsx -- tests for UsdMeter component.
+ */
+import { describe, expect, it } from "vitest";
+import { UsdMeter } from "./usd-meter.js";
+describe("UsdMeter", () => {
+    it("renders session and month USD formatted to 2 decimals", () => {
+        const el = UsdMeter({ session_usd: 3.5, month_usd: 10.123, current_pct: 40 });
+        expect(el.props.children).toBe("session: $3.50 | month: $10.12");
+    });
+    it("renders white color when current_pct < 50", () => {
+        const el = UsdMeter({ session_usd: 0, month_usd: 0, current_pct: 20 });
+        expect(el.props.fg).toBe("white");
+    });
+    it("renders cyan color when current_pct >= 50 and < 80", () => {
+        const el = UsdMeter({ session_usd: 0, month_usd: 0, current_pct: 55 });
+        expect(el.props.fg).toBe("cyan");
+    });
+    it("renders yellow color when current_pct >= 80 and < 100", () => {
+        const el = UsdMeter({ session_usd: 0, month_usd: 0, current_pct: 80 });
+        expect(el.props.fg).toBe("yellow");
+    });
+    it("renders red color when current_pct >= 100", () => {
+        const el = UsdMeter({ session_usd: 0, month_usd: 0, current_pct: 100 });
+        expect(el.props.fg).toBe("red");
+    });
+    it("has data-testid usd-meter", () => {
+        const el = UsdMeter({ session_usd: 0, month_usd: 0, current_pct: 0 });
+        expect(el.props["data-testid"]).toBe("usd-meter");
+    });
+});
+//# sourceMappingURL=usd-meter.test.js.map

package/dist/ui/status-bar/usd-meter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usd-meter.test.js","sourceRoot":"","sources":["../../../src/ui/status-bar/usd-meter.test.tsx"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAQ,CAAC;QACrF,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAQ,CAAC;QAC9E,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAQ,CAAC;QAC9E,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAQ,CAAC;QAC9E,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAQ,CAAC;QAC/E,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAQ,CAAC;QAC7E,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/ui/terminal-selection-text.d.ts

@@ -0,0 +1,23 @@
+import type { Renderable } from "@opentui/core";
+/** Subset of OpenTUI Selection used for clipboard (avoid private package subpaths). */
+export type TuiSelectionSnapshot = {
+    selectedRenderables: Renderable[];
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    anchor: {
+        x: number;
+        y: number;
+    };
+    getSelectedText(): string;
+};
+/**
+ * OpenTUI's Selection.getSelectedText() concatenates every intersected text buffer. In markdown-heavy
+ * UIs a tiny drag can still hit dozens/hundreds of sibling line renderables. We narrow to leaf buffers,
+ * optionally to the selection midpoint for thin rects, and fall back to the anchor cell's smallest buffer
+ * when the joined text is still huge.
+ */
+export declare function getCompactTuiSelectionText(selection: TuiSelectionSnapshot): string;

package/dist/ui/terminal-selection-text.js

@@ -0,0 +1,59 @@
+import { TextBufferRenderable } from "@opentui/core";
+function isStrictDescendantOf(ancestor, node) {
+    let p = node.parent;
+    while (p) {
+        if (p === ancestor)
+            return true;
+        p = p.parent;
+    }
+    return false;
+}
+/** Drop parents when a deeper selected renderable is nested under them (duplicate coverage). */
+function selectedTextBuffersOnly(selection) {
+    const raw = selection.selectedRenderables.filter((r) => !r.isDestroyed && r instanceof TextBufferRenderable);
+    return raw.filter((r) => !raw.some((other) => other !== r && isStrictDescendantOf(r, other)));
+}
+function sortReadingOrder(a, b) {
+    if (a.y !== b.y)
+        return a.y - b.y;
+    return a.x - b.x;
+}
+/**
+ * OpenTUI's Selection.getSelectedText() concatenates every intersected text buffer. In markdown-heavy
+ * UIs a tiny drag can still hit dozens/hundreds of sibling line renderables. We narrow to leaf buffers,
+ * optionally to the selection midpoint for thin rects, and fall back to the anchor cell's smallest buffer
+ * when the joined text is still huge.
+ */
+export function getCompactTuiSelectionText(selection) {
+    let buffers = selectedTextBuffersOnly(selection);
+    if (buffers.length === 0)
+        return selection.getSelectedText();
+    const b = selection.bounds;
+    const thin = b.height <= 2;
+    if (thin && buffers.length > 6) {
+        const midX = Math.floor(b.x + b.width / 2);
+        const midY = Math.floor(b.y + b.height / 2);
+        const narrowed = buffers.filter((r) => midX >= r.x && midX < r.x + r.width && midY >= r.y && midY < r.y + r.height);
+        if (narrowed.length > 0)
+            buffers = narrowed;
+    }
+    buffers = [...buffers].sort(sortReadingOrder);
+    let text = buffers
+        .map((r) => r.getSelectedText())
+        .filter((t) => t.length > 0)
+        .join("\n");
+    const lineCount = text === "" ? 0 : text.split("\n").length;
+    if (lineCount > 40 && thin) {
+        const ax = selection.anchor.x;
+        const ay = selection.anchor.y;
+        const atPoint = buffers.filter((r) => ax >= r.x && ax < r.x + r.width && ay >= r.y && ay < r.y + r.height);
+        if (atPoint.length > 0) {
+            atPoint.sort((a, b) => a.width * a.height - b.width * b.height);
+            const fallback = atPoint[0].getSelectedText();
+            if (fallback && fallback.split("\n").length < lineCount)
+                text = fallback;
+        }
+    }
+    return text || selection.getSelectedText();
+}
+//# sourceMappingURL=terminal-selection-text.js.map

package/dist/ui/terminal-selection-text.js.map

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

package/dist/ui/theme.d.ts

@@ -0,0 +1,53 @@
+export declare const dark: {
+    readonly background: "#000000";
+    readonly backgroundPanel: "#111111";
+    readonly backgroundElement: "#1a1a1a";
+    readonly border: "#333333";
+    readonly borderActive: "#555555";
+    readonly text: "#e0e0e0";
+    readonly textMuted: "#666666";
+    readonly textDim: "#444444";
+    readonly primary: "#ffffff";
+    readonly accent: "#5c9cf5";
+    readonly subagentAccent: "#66d9c2";
+    readonly selected: "#ffffff";
+    readonly selectedBg: "#2a2a2a";
+    readonly diffAdded: "#1e3a1e";
+    readonly diffAddedFg: "#8adf8a";
+    readonly diffAddedLineNum: "#3a6a3a";
+    readonly diffRemoved: "#3a1e1e";
+    readonly diffRemovedFg: "#df8a8a";
+    readonly diffRemovedLineNum: "#6a3a3a";
+    readonly diffContext: "#161616";
+    readonly diffContextFg: "#999999";
+    readonly diffLineNumber: "#555555";
+    readonly diffHeader: "#1c1c1c";
+    readonly diffHeaderFg: "#888888";
+    readonly diffSeparator: "#1a1a1a";
+    readonly diffSeparatorFg: "#555555";
+    readonly mdHeading: "#e0e0e0";
+    readonly mdBold: "#e8a465";
+    readonly mdItalic: "#e5c07b";
+    readonly mdCode: "#6abf6a";
+    readonly mdCodeBlockBg: "#141414";
+    readonly mdCodeBlockFg: "#c0c0c0";
+    readonly mdLink: "#5c9cf5";
+    readonly mdLinkText: "#d4a0d4";
+    readonly mdHr: "#333333";
+    readonly mdListBullet: "#666666";
+    readonly planBorder: "#e5c07b";
+    readonly planTitle: "#e5c07b";
+    readonly planStepNum: "#e5c07b";
+    readonly planStepTitle: "#e0e0e0";
+    readonly planStepDesc: "#999999";
+    readonly planStepFile: "#5c9cf5";
+    readonly planQuestionText: "#e0e0e0";
+    readonly planOptionDefault: "#888888";
+    readonly planOptionSelected: "#e5c07b";
+    readonly planOptionCheck: "#22c55e";
+    readonly planInputBg: "#1a1a1a";
+    readonly planInputText: "#e0e0e0";
+    readonly planHint: "#555555";
+    readonly queueBg: "#222222";
+};
+export type Theme = typeof dark;

package/dist/ui/theme.js

@@ -0,0 +1,53 @@
+export const dark = {
+    background: "#000000",
+    backgroundPanel: "#111111",
+    backgroundElement: "#1a1a1a",
+    border: "#333333",
+    borderActive: "#555555",
+    text: "#e0e0e0",
+    textMuted: "#666666",
+    textDim: "#444444",
+    primary: "#ffffff",
+    accent: "#5c9cf5",
+    subagentAccent: "#66d9c2",
+    selected: "#ffffff",
+    selectedBg: "#2a2a2a",
+    diffAdded: "#1e3a1e",
+    diffAddedFg: "#8adf8a",
+    diffAddedLineNum: "#3a6a3a",
+    diffRemoved: "#3a1e1e",
+    diffRemovedFg: "#df8a8a",
+    diffRemovedLineNum: "#6a3a3a",
+    diffContext: "#161616",
+    diffContextFg: "#999999",
+    diffLineNumber: "#555555",
+    diffHeader: "#1c1c1c",
+    diffHeaderFg: "#888888",
+    diffSeparator: "#1a1a1a",
+    diffSeparatorFg: "#555555",
+    mdHeading: "#e0e0e0",
+    mdBold: "#e8a465",
+    mdItalic: "#e5c07b",
+    mdCode: "#6abf6a",
+    mdCodeBlockBg: "#141414",
+    mdCodeBlockFg: "#c0c0c0",
+    mdLink: "#5c9cf5",
+    mdLinkText: "#d4a0d4",
+    mdHr: "#333333",
+    mdListBullet: "#666666",
+    planBorder: "#e5c07b",
+    planTitle: "#e5c07b",
+    planStepNum: "#e5c07b",
+    planStepTitle: "#e0e0e0",
+    planStepDesc: "#999999",
+    planStepFile: "#5c9cf5",
+    planQuestionText: "#e0e0e0",
+    planOptionDefault: "#888888",
+    planOptionSelected: "#e5c07b",
+    planOptionCheck: "#22c55e",
+    planInputBg: "#1a1a1a",
+    planInputText: "#e0e0e0",
+    planHint: "#555555",
+    queueBg: "#222222",
+};
+//# sourceMappingURL=theme.js.map

package/dist/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,UAAU,EAAE,SAAS;IACrB,eAAe,EAAE,SAAS;IAC1B,iBAAiB,EAAE,SAAS;IAC5B,MAAM,EAAE,SAAS;IACjB,YAAY,EAAE,SAAS;IACvB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE,SAAS;IACzB,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,gBAAgB,EAAE,SAAS;IAC3B,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,kBAAkB,EAAE,SAAS;IAC7B,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,cAAc,EAAE,SAAS;IACzB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,SAAS;IACxB,eAAe,EAAE,SAAS;IAC1B,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,SAAS;IACjB,aAAa,EAAE,SAAS;IACxB,aAAa,EAAE,SAAS;IACxB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,SAAS;IACrB,IAAI,EAAE,SAAS;IACf,YAAY,EAAE,SAAS;IACvB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,gBAAgB,EAAE,SAAS;IAC3B,iBAAiB,EAAE,SAAS;IAC5B,kBAAkB,EAAE,SAAS;IAC7B,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;CACV,CAAC"}

package/dist/usage/downgrade.d.ts

@@ -0,0 +1,37 @@
+/**
+ * src/usage/downgrade.ts
+ *
+ * Auto-downgrade chain for USAGE-04.
+ * Opus -> Sonnet -> Haiku -> HALT with status-bar transition events.
+ *
+ * Plan 06 (status bar) subscribes to DowngradeEvent for UI updates.
+ */
+export declare const DOWNGRADE_CHAIN: ReadonlyArray<string>;
+export interface DowngradeStep {
+    next: string;
+    isHalt: boolean;
+    eventLabel: string;
+}
+export interface DowngradeEvent {
+    fromModel: string;
+    toModel: string;
+    pct: number;
+    atMs: number;
+}
+/**
+ * Given the current model, return the next step down in the downgrade chain.
+ * Unknown models are treated as top-of-chain (Opus position).
+ */
+export declare function downgradeChain(currentModel: string, capPct?: number): DowngradeStep;
+type Listener = (e: DowngradeEvent) => void;
+/**
+ * Subscribe to downgrade transition events.
+ * Returns an unsubscribe function.
+ */
+export declare function subscribeDowngrade(fn: Listener): () => void;
+/**
+ * Emit a downgrade event to all subscribers.
+ * Called by decide() when cap-driven downgrade occurs.
+ */
+export declare function emitDowngrade(e: DowngradeEvent): void;
+export {};

package/dist/usage/downgrade.js

@@ -0,0 +1,49 @@
+/**
+ * src/usage/downgrade.ts
+ *
+ * Auto-downgrade chain for USAGE-04.
+ * Opus -> Sonnet -> Haiku -> HALT with status-bar transition events.
+ *
+ * Plan 06 (status bar) subscribes to DowngradeEvent for UI updates.
+ */
+export const DOWNGRADE_CHAIN = [
+    "claude-3-opus-latest",
+    "claude-3-5-sonnet-latest",
+    "claude-3-5-haiku-latest",
+    "HALT",
+];
+/**
+ * Given the current model, return the next step down in the downgrade chain.
+ * Unknown models are treated as top-of-chain (Opus position).
+ */
+export function downgradeChain(currentModel, capPct = 0) {
+    const idx = DOWNGRADE_CHAIN.indexOf(currentModel);
+    const i = idx === -1 ? 0 : idx; // unknown model treated as top
+    const next = DOWNGRADE_CHAIN[i + 1] ?? "HALT";
+    const isHalt = next === "HALT";
+    const human = (m) => m.includes("opus") ? "Opus" : m.includes("sonnet") ? "Sonnet" : m.includes("haiku") ? "Haiku" : m;
+    const eventLabel = isHalt
+        ? `Capping at ${capPct.toFixed(0)}% — halting (Haiku exhausted)`
+        : `Capping at ${capPct.toFixed(0)}% — switching ${human(currentModel)} → ${human(next)}`;
+    return { next, isHalt, eventLabel };
+}
+const listeners = new Set();
+/**
+ * Subscribe to downgrade transition events.
+ * Returns an unsubscribe function.
+ */
+export function subscribeDowngrade(fn) {
+    listeners.add(fn);
+    return () => {
+        listeners.delete(fn);
+    };
+}
+/**
+ * Emit a downgrade event to all subscribers.
+ * Called by decide() when cap-driven downgrade occurs.
+ */
+export function emitDowngrade(e) {
+    for (const l of listeners)
+        l(e);
+}
+//# sourceMappingURL=downgrade.js.map

package/dist/usage/downgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downgrade.js","sourceRoot":"","sources":["../../src/usage/downgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,eAAe,GAA0B;IACpD,sBAAsB;IACtB,0BAA0B;IAC1B,yBAAyB;IACzB,MAAM;CACP,CAAC;AAeF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,MAAM,GAAG,CAAC;IAC7D,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,+BAA+B;IAC/D,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC;IAE/B,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAC1B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpG,MAAM,UAAU,GAAG,MAAM;QACvB,CAAC,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B;QAChE,CAAC,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IAE3F,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACtC,CAAC;AAGD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAY;IAC7C,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAiB;IAC7C,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/usage/downgrade.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/usage/downgrade.test.js

@@ -0,0 +1,67 @@
+import { describe, expect, it } from "vitest";
+import { DOWNGRADE_CHAIN, downgradeChain, emitDowngrade, subscribeDowngrade, } from "./downgrade.js";
+describe("DOWNGRADE_CHAIN", () => {
+    it("is exactly Opus -> Sonnet -> Haiku -> HALT", () => {
+        expect(DOWNGRADE_CHAIN).toEqual([
+            "claude-3-opus-latest",
+            "claude-3-5-sonnet-latest",
+            "claude-3-5-haiku-latest",
+            "HALT",
+        ]);
+    });
+});
+describe("downgradeChain()", () => {
+    it("from Opus yields Sonnet with transition label", () => {
+        const step = downgradeChain("claude-3-opus-latest", 80);
+        expect(step.next).toBe("claude-3-5-sonnet-latest");
+        expect(step.isHalt).toBe(false);
+        expect(step.eventLabel).toContain("switching");
+        expect(step.eventLabel).toContain("Opus");
+        expect(step.eventLabel).toContain("Sonnet");
+        expect(step.eventLabel).toContain("80%");
+    });
+    it("from Sonnet yields Haiku with transition label", () => {
+        const step = downgradeChain("claude-3-5-sonnet-latest", 95);
+        expect(step.next).toBe("claude-3-5-haiku-latest");
+        expect(step.isHalt).toBe(false);
+        expect(step.eventLabel).toContain("Sonnet");
+        expect(step.eventLabel).toContain("Haiku");
+    });
+    it("from Haiku yields HALT with isHalt=true", () => {
+        const step = downgradeChain("claude-3-5-haiku-latest", 100);
+        expect(step.next).toBe("HALT");
+        expect(step.isHalt).toBe(true);
+        expect(step.eventLabel).toContain("halting");
+    });
+    it("unknown model treated as top of chain (Opus position)", () => {
+        const step = downgradeChain("some-unknown-model", 90);
+        expect(step.next).toBe("claude-3-5-sonnet-latest");
+        expect(step.isHalt).toBe(false);
+    });
+});
+describe("subscribeDowngrade()", () => {
+    it("fires listener with fromModel, toModel, pct on emitDowngrade", () => {
+        const events = [];
+        const unsub = subscribeDowngrade((e) => events.push(e));
+        emitDowngrade({
+            fromModel: "claude-3-opus-latest",
+            toModel: "claude-3-5-sonnet-latest",
+            pct: 82,
+            atMs: Date.now(),
+        });
+        expect(events).toHaveLength(1);
+        expect(events[0].fromModel).toBe("claude-3-opus-latest");
+        expect(events[0].toModel).toBe("claude-3-5-sonnet-latest");
+        expect(events[0].pct).toBe(82);
+        unsub();
+        // After unsub, no more events
+        emitDowngrade({
+            fromModel: "claude-3-5-sonnet-latest",
+            toModel: "claude-3-5-haiku-latest",
+            pct: 95,
+            atMs: Date.now(),
+        });
+        expect(events).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=downgrade.test.js.map

package/dist/usage/downgrade.test.js.map

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

package/dist/usage/estimator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * src/usage/estimator.ts
+ *
+ * Token estimation and cost projection for the reservation ledger.
+ * Phase 1 explicitly accepts chars/4 estimator -- fine for cap projection, NOT for billing.
+ * Phase 4 swaps in tiktoken-encoder for actual token counts.
+ */
+/**
+ * Rough token estimate from character count.
+ * Acceptable for cap projection only -- not for billing reconciliation.
+ */
+export declare function estimateTokensFromChars(chars: number): number;
+/**
+ * Project the USD cost of a request given token estimates and the static pricing table.
+ * Returns 0 for unknown provider/model -- caller decides how to handle (ledger treats as 0 risk).
+ */
+export declare function projectCostUSD(provider: string, model: string, estInputTokens: number, estOutputTokens: number): number;

package/dist/usage/estimator.js

@@ -0,0 +1,28 @@
+/**
+ * src/usage/estimator.ts
+ *
+ * Token estimation and cost projection for the reservation ledger.
+ * Phase 1 explicitly accepts chars/4 estimator -- fine for cap projection, NOT for billing.
+ * Phase 4 swaps in tiktoken-encoder for actual token counts.
+ */
+import { lookupPricing } from "../providers/pricing.js";
+/**
+ * Rough token estimate from character count.
+ * Acceptable for cap projection only -- not for billing reconciliation.
+ */
+export function estimateTokensFromChars(chars) {
+    return Math.ceil(chars / 4);
+}
+/**
+ * Project the USD cost of a request given token estimates and the static pricing table.
+ * Returns 0 for unknown provider/model -- caller decides how to handle (ledger treats as 0 risk).
+ */
+export function projectCostUSD(provider, model, estInputTokens, estOutputTokens) {
+    const p = lookupPricing(provider, model);
+    if (!p)
+        return 0;
+    const inUSD = (estInputTokens / 1_000_000) * p.input_per_million_usd;
+    const outUSD = (estOutputTokens / 1_000_000) * p.output_per_million_usd;
+    return inUSD + outUSD;
+}
+//# sourceMappingURL=estimator.js.map

package/dist/usage/estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimator.js","sourceRoot":"","sources":["../../src/usage/estimator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,KAAa,EACb,cAAsB,EACtB,eAAuB;IAEvB,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,MAAM,KAAK,GAAG,CAAC,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC;IACrE,MAAM,MAAM,GAAG,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,sBAAsB,CAAC;IACxE,OAAO,KAAK,GAAG,MAAM,CAAC;AACxB,CAAC"}

package/dist/usage/estimator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/usage/estimator.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it } from "vitest";
+import { estimateTokensFromChars, projectCostUSD } from "./estimator.js";
+describe("estimator", () => {
+    describe("projectCostUSD", () => {
+        it("computes cost for known anthropic model", () => {
+            // claude-3-5-sonnet-latest: $3/M input, $15/M output
+            // 1M input + 1M output = $3 + $15 = $18
+            const cost = projectCostUSD("anthropic", "claude-3-5-sonnet-latest", 1_000_000, 1_000_000);
+            expect(cost).toBeCloseTo(18.0, 4);
+        });
+        it("returns 0 for unknown model", () => {
+            const cost = projectCostUSD("anthropic", "nonexistent-model", 1_000_000, 1_000_000);
+            expect(cost).toBe(0);
+        });
+        it("returns 0 for unknown provider", () => {
+            const cost = projectCostUSD("unknown-provider", "gpt-4o", 1_000_000, 1_000_000);
+            expect(cost).toBe(0);
+        });
+        it("ollama wildcard returns 0 cost", () => {
+            const cost = projectCostUSD("ollama", "llama3.2", 1_000_000, 1_000_000);
+            expect(cost).toBe(0);
+        });
+        it("computes haiku cost correctly", () => {
+            // claude-3-5-haiku-latest: $0.80/M input, $4.00/M output
+            // 100k input + 25k output = 0.08 + 0.10 = 0.18
+            const cost = projectCostUSD("anthropic", "claude-3-5-haiku-latest", 100_000, 25_000);
+            expect(cost).toBeCloseTo(0.18, 4);
+        });
+    });
+    describe("estimateTokensFromChars", () => {
+        it("divides chars by 4 and rounds up", () => {
+            expect(estimateTokensFromChars(100)).toBe(25);
+            expect(estimateTokensFromChars(101)).toBe(26);
+            expect(estimateTokensFromChars(0)).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=estimator.test.js.map

package/dist/usage/estimator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimator.test.js","sourceRoot":"","sources":["../../src/usage/estimator.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEzE,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,qDAAqD;YACrD,wCAAwC;YACxC,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,EAAE,0BAA0B,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAC3F,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACpF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,IAAI,GAAG,cAAc,CAAC,kBAAkB,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAChF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACxE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,yDAAyD;YACzD,+CAA+C;YAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACrF,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/usage/ledger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * src/usage/ledger.ts
+ *
+ * Reservation ledger for USAGE-03.
+ * Atomic reserve/commit/release primitives with file-lock via proper-lockfile.
+ *
+ * Invariant: current_usd + sum(reservations.usd) + projected <= cap.monthly_usd
+ * or reserve() returns CapBreachError.
+ *
+ * Pitfall 5 mitigation: callers MUST use try/finally with release() in finally
+ * to prevent reservation leaks on stream abort.
+ *
+ * Pitfall 7 mitigation: proper-lockfile exclusive lock serializes concurrent
+ * reserve() calls so 10-parallel tool-call bursts cannot collectively exceed cap.
+ */
+import { CapBreachError, type ReservationToken } from "./types.js";
+/**
+ * Reserve projected token spend against the monthly cap.
+ * Returns ReservationToken on success, CapBreachError if projection would exceed cap.
+ *
+ * Caller contract: MUST call commit() or release() on the token.
+ * Use try/finally: `const tok = await reserve(...); try { ... commit(tok) } finally { release(tok) }`
+ */
+export declare function reserve(args: {
+    provider: string;
+    model: string;
+    estInputTokens: number;
+    estOutputTokens: number;
+    homeOverride?: string;
+}): Promise<ReservationToken | CapBreachError>;
+/**
+ * Commit actual token spend. Removes the reservation and increments current_usd.
+ * Idempotent: if the reservation ID is not found, this is a no-op.
+ *
+ * Evaluates thresholds after state mutation and emits events post-lock-release.
+ */
+export declare function commit(token: ReservationToken, actualInputTokens: number, actualOutputTokens: number, homeOverride?: string): Promise<void>;
+/**
+ * Release a reservation without committing actual cost.
+ * Used on stream abort (Pitfall 5 mitigation).
+ */
+export declare function release(token: ReservationToken, homeOverride?: string): Promise<void>;