zcode-acp-server 0.1.0 → 0.2.0

package/dist/quota/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/quota/color.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,KAAK,cAAY,CAAC;AAE/B,yBAAyB;AACzB,KAAK,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAwB7C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAQ1C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAUT;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,CAmBlF"}

package/dist/quota/color.js

@@ -0,0 +1,95 @@
+/**
+ * Color progress-bar rendering for the `zcode-quota` CLI.
+ *
+ * The default CLI view overlays the usage numbers directly onto a heat-colored
+ * (green→yellow→red) bar using 24-bit ANSI background colors, so the percentage
+ * or used/total counter reads from inside the bar and the right margin stays
+ * short (just the reset time). `--plain` and the `/quota` slash command bypass
+ * this module entirely and keep the classic monochrome `█`/`░` layout from
+ * {@link renderBar}.
+ *
+ * Only real terminals render 24-bit color; the CLI caller gates this on
+ * `process.stdout.isTTY` so piping to a file or another command never emits
+ * raw escape codes.
+ */
+/** ANSI reset (cancel all attributes). */
+export const RESET = "\x1b[0m";
+/** ANSI 24-bit background-color escape. */
+function bg(r, g, b) {
+    return `\x1b[48;2;${r};${g};${b}m`;
+}
+/** ANSI 24-bit foreground (text) color escape. */
+function fg(r, g, b) {
+    return `\x1b[38;2;${r};${g};${b}m`;
+}
+/** Linear interpolation between two numbers, rounded to an 8-bit channel. */
+function lerp(a, b, t) {
+    return Math.round(a + (b - a) * t);
+}
+/** Empty-cell background (constant dark gray, independent of usage). */
+const EMPTY_BG = [40, 40, 48];
+/** Empty-cell foreground (muted gray text). */
+const EMPTY_FG = [120, 120, 130];
+/** Fill-cell foreground (white text — high contrast on saturated fill). */
+const FILL_FG = [255, 255, 255];
+/**
+ * Green→yellow→red heat color for a usage percent.
+ *
+ * 0% → green `(34,197,94)`, 50% → yellow `(234,179,8)`, 100% → red
+ * `(239,68,68)`, piecewise-linearly interpolated. Input is clamped to [0, 100].
+ */
+export function heatColor(pct) {
+    const p = Math.max(0, Math.min(100, pct));
+    if (p < 50) {
+        const t = p / 50;
+        return [lerp(34, 234, t), lerp(197, 179, t), lerp(94, 8, t)];
+    }
+    const t = (p - 50) / 50;
+    return [lerp(234, 239, t), lerp(179, 68, t), lerp(8, 68, t)];
+}
+/**
+ * Pick the overlay text drawn inside the bar.
+ *
+ * Returns `"used/total"` when the item carries both absolute counters (e.g. the
+ * MCP limit), otherwise `"NN%"` (the rounded used percent). This lets
+ * counter-bearing limits show their exact counts in-bar while counter-less
+ * limits (5h, Opencode Go windows) show the percent.
+ */
+export function pickOverlay(item) {
+    if (typeof item.usedCount === "number" &&
+        typeof item.totalCount === "number" &&
+        Number.isFinite(item.usedCount) &&
+        Number.isFinite(item.totalCount)) {
+        return `${item.usedCount}/${item.totalCount}`;
+    }
+    return `${Math.round(Math.max(0, Math.min(100, item.usedPercent)))}%`;
+}
+/**
+ * Render a heat-colored progress bar with optional centered overlay text.
+ *
+ * Each cell is one background color: the fill cells use {@link heatColor} (so
+ * low usage reads green, high usage red), the empty cells use a constant dark
+ * gray. When an overlay string is supplied its characters are written over the
+ * bar with a contrasting foreground (white on fill, gray on empty), centered
+ * across the `width` cells. The result always ends with {@link RESET} so the
+ * color never leaks into the text that follows.
+ */
+export function renderColorBar(usedPercent, opts) {
+    const width = opts?.width ?? 20;
+    const pct = Math.max(0, Math.min(100, usedPercent));
+    const filled = Math.round((pct / 100) * width);
+    const [fr, fgg, fb] = heatColor(pct);
+    const overlay = opts?.overlay ?? "";
+    const overlayStart = Math.floor((width - overlay.length) / 2);
+    let out = "";
+    for (let i = 0; i < width; i++) {
+        const isFill = i < filled;
+        const [br, bgg, bb] = isFill ? [fr, fgg, fb] : EMPTY_BG;
+        const idx = i - overlayStart;
+        const ch = idx >= 0 && idx < overlay.length ? overlay[idx] : " ";
+        const [tr, tg, tb] = isFill ? FILL_FG : EMPTY_FG;
+        out += `${bg(br, bgg, bb)}${fg(tr, tg, tb)}${ch}`;
+    }
+    return out + RESET;
+}
+//# sourceMappingURL=color.js.map

package/dist/quota/color.js.map

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

package/dist/quota/combined.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Combined multi-provider quota — the orchestration layer used by the
+ * `zcode-quota` CLI when no provider subcommand is given (default mode).
+ *
+ * Queries GLM Coding Plan and Opencode Go in parallel and renders a single
+ * merged card with one section per provider. The `/quota` slash command does
+ * NOT use this — it stays on the single-provider GLM {@link formatQuota}.
+ *
+ * Design notes:
+ *   - `Promise.all` so a slow Opencode Go scrape doesn't delay the GLM card.
+ *   - A `not_configured` Opencode Go result is silently dropped (no header,
+ *     no error line) in `all` mode, so GLM-only users see no noise. In `go`
+ *     mode it surfaces as a help line because the user explicitly asked.
+ *   - The divider width is computed from the widest body line so the frame
+ *     stays balanced regardless of which windows/counts are present.
+ */
+import type { FormatOptions } from "./format.js";
+import type { GoQueryResult, GoWindowKey } from "./opencode-go/types.js";
+import type { QuotaResult } from "./types.js";
+/** Which provider(s) to query. */
+export type Provider = "all" | "glm" | "go";
+/** The combined result of both providers. */
+export interface CombinedResult {
+    glm: QuotaResult;
+    go: GoQueryResult;
+}
+/**
+ * Which Opencode Go windows to render. All three (rolling + weekly + monthly)
+ * are shown in every mode that renders Go at all — the compact color layout
+ * leaves room for the monthly bar.
+ */
+export declare function defaultGoWindows(provider: Provider): GoWindowKey[];
+/**
+ * Query both providers in parallel.
+ *
+ * Each provider degrades internally (GLM → `unavailable`, Go →
+ * `not_configured`/`unavailable`); neither ever throws, so `Promise.all`
+ * always resolves.
+ */
+export declare function queryCombined(provider: Provider): Promise<CombinedResult>;
+/**
+ * Render the combined result as a single fenced ```text card.
+ *
+ * Sections are separated by a blank line; each section has a ` Header` line
+ * (indented one space so it reads as a sub-heading) followed by its body.
+ * The divider spans the widest line in the card.
+ */
+export declare function formatCombinedCard(combined: CombinedResult, opts?: {
+    provider: Provider;
+    glm?: FormatOptions;
+    goWindows?: GoWindowKey[];
+    /** Render heat-colored 24-bit ANSI bars with overlaid numbers. */
+    color?: boolean;
+    /** Optional trailing annotation appended to the first section header
+     *  (e.g. ` · refresh in 29s`). Watch mode uses it to show the countdown. */
+    refreshSuffix?: string;
+}): string;
+/** {@link formatCombinedCard} without the fence — for raw terminal output. */
+export declare function formatCombinedCardPlain(combined: CombinedResult, opts?: {
+    provider: Provider;
+    glm?: FormatOptions;
+    goWindows?: GoWindowKey[];
+    color?: boolean;
+    refreshSuffix?: string;
+}): string;
+//# sourceMappingURL=combined.d.ts.map

package/dist/quota/combined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combined.d.ts","sourceRoot":"","sources":["../../src/quota/combined.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,kCAAkC;AAClC,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;AAE5C,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,WAAW,CAAC;IACjB,EAAE,EAAE,aAAa,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,EAAE,CAOlE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAa/E;AAeD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,IAAI,GAAE;IACJ,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;gFAC4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;CACF,GACtB,MAAM,CAWR;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,EACxB,IAAI,GAAE;IACJ,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACF,GACtB,MAAM,CASR"}

package/dist/quota/combined.js

@@ -0,0 +1,179 @@
+/**
+ * Combined multi-provider quota — the orchestration layer used by the
+ * `zcode-quota` CLI when no provider subcommand is given (default mode).
+ *
+ * Queries GLM Coding Plan and Opencode Go in parallel and renders a single
+ * merged card with one section per provider. The `/quota` slash command does
+ * NOT use this — it stays on the single-provider GLM {@link formatQuota}.
+ *
+ * Design notes:
+ *   - `Promise.all` so a slow Opencode Go scrape doesn't delay the GLM card.
+ *   - A `not_configured` Opencode Go result is silently dropped (no header,
+ *     no error line) in `all` mode, so GLM-only users see no noise. In `go`
+ *     mode it surfaces as a help line because the user explicitly asked.
+ *   - The divider width is computed from the widest body line so the frame
+ *     stays balanced regardless of which windows/counts are present.
+ */
+import { renderGlmSection } from "./format.js";
+import { queryQuota } from "./index.js";
+import { formatGoSection, queryGoUsage } from "./opencode-go/index.js";
+/**
+ * Which Opencode Go windows to render. All three (rolling + weekly + monthly)
+ * are shown in every mode that renders Go at all — the compact color layout
+ * leaves room for the monthly bar.
+ */
+export function defaultGoWindows(provider) {
+    // All three windows everywhere now — the compact color layout leaves room
+    // for the monthly bar. `provider` is accepted to keep the call sites
+    // self-documenting (and to allow per-provider trimming again later) even
+    // though every branch currently returns the same set.
+    void provider;
+    return ["rolling", "weekly", "monthly"];
+}
+/**
+ * Query both providers in parallel.
+ *
+ * Each provider degrades internally (GLM → `unavailable`, Go →
+ * `not_configured`/`unavailable`); neither ever throws, so `Promise.all`
+ * always resolves.
+ */
+export async function queryCombined(provider) {
+    // For `glm`-only we skip the Go fetch entirely; for `go`-only we skip GLM.
+    // Skipping is cheaper and avoids touching Go credentials the user may not
+    // have set. We still return both fields so the formatter's shape is uniform.
+    const tasks = provider === "glm"
+        ? [queryQuota(), Promise.resolve({ kind: "not_configured" })]
+        : provider === "go"
+            ? [Promise.resolve({ kind: "unavailable" }), queryGoUsage()]
+            : [queryQuota(), queryGoUsage()];
+    const [glm, go] = await Promise.all(tasks);
+    return { glm, go };
+}
+/**
+ * Decide whether the Go section should appear at all in `all` mode.
+ *
+ * `not_configured` is silently dropped (the user hasn't set credentials and
+ * didn't explicitly ask for Go). All other kinds — including `unavailable`
+ * and `auth_error` — render so the user sees that something is wrong.
+ */
+function shouldShowGo(provider, go) {
+    if (provider === "glm")
+        return false;
+    if (go.kind === "not_configured" && provider === "all")
+        return false;
+    return true;
+}
+/**
+ * Render the combined result as a single fenced ```text card.
+ *
+ * Sections are separated by a blank line; each section has a ` Header` line
+ * (indented one space so it reads as a sub-heading) followed by its body.
+ * The divider spans the widest line in the card.
+ */
+export function formatCombinedCard(combined, opts = { provider: "all" }) {
+    const provider = opts.provider;
+    const lines = renderCombinedLines(combined, provider, opts.glm, opts.goWindows, opts.color, opts.refreshSuffix);
+    return ["```text", ...lines, "```"].join("\n");
+}
+/** {@link formatCombinedCard} without the fence — for raw terminal output. */
+export function formatCombinedCardPlain(combined, opts = { provider: "all" }) {
+    return renderCombinedLines(combined, opts.provider, opts.glm, opts.goWindows, opts.color, opts.refreshSuffix).join("\n");
+}
+/**
+ * Render the card body lines (no fence). Shared by fenced/plain variants.
+ *
+ * Single-provider modes render just that provider's section header + body
+ * (no `Quota Overview` banner, no divider). `all` mode renders the banner,
+ * divider, and both sections.
+ */
+/**
+ * Width the refresh line is right-aligned to. Matches the classic GLM divider
+ * width so the countdown lines up with the card's visual frame.
+ */
+const REFRESH_LINE_WIDTH = 34;
+/**
+ * Build the separator line that follows the first rendered section.
+ *
+ * In watch mode this carries the refresh countdown, right-aligned to
+ * {@link REFRESH_LINE_WIDTH} so its position is stable regardless of how many
+ * sections follow (or whether Go is configured). When no refresh suffix is
+ * supplied the line is blank — it still occupies the row so the layout below
+ * it never shifts.
+ */
+function separatorLine(refreshSuffix) {
+    if (!refreshSuffix)
+        return "";
+    return refreshSuffix.padStart(REFRESH_LINE_WIDTH);
+}
+function renderCombinedLines(combined, provider, glmOpts, goWindows, color = false, 
+/** Optional refresh countdown rendered on the separator line after the
+ *  first section (e.g. `refresh in 29s`). */
+refreshSuffix) {
+    const { glm, go } = combined;
+    const sep = separatorLine(refreshSuffix);
+    // Fold the color flag into the GLM FormatOptions so it reaches renderGlmSection
+    // alongside detail/compact without each caller having to set it.
+    const glmOptsColor = { ...glmOpts, color };
+    // Single-provider GLM: behave like the original card (header + divider +
+    // body) minus the fence, so `zcode-quota glm` looks identical to today's
+    // `zcode-quota`.
+    if (provider === "glm") {
+        const lines = renderSingleGlm(glm, glmOptsColor);
+        // The separator rides after the (only) section, then nothing follows.
+        return sep ? [...lines, sep] : lines;
+    }
+    // Single-provider Go: header + body, no banner/divider.
+    if (provider === "go") {
+        const section = formatGoSection(go, goWindows ?? defaultGoWindows("go"), Date.now(), color);
+        const lines = [section.header, ...section.body];
+        return sep ? [...lines, sep] : lines;
+    }
+    // Combined `all` mode. GLM renders full (MCP on its own line) — the layout
+    // is short enough now that compact mode isn't worth the lost detail.
+    const glmSection = renderGlmSection(glm, glmOptsColor);
+    const showGo = shouldShowGo("all", go);
+    const goSection = showGo
+        ? formatGoSection(go, goWindows ?? defaultGoWindows("all"), Date.now(), color)
+        : null;
+    const hasGlm = glmSection.body.length > 0;
+    const hasGo = !!goSection && goSection.body.length > 0;
+    // The separator line always follows the FIRST rendered section, so its row
+    // is fixed whether or not a second section appears.
+    const sections = [];
+    if (hasGlm)
+        sections.push([` ${glmSection.header}`, ...glmSection.body]);
+    if (hasGo)
+        sections.push([` ${goSection.header}`, ...goSection.body]);
+    if (sections.length === 0) {
+        return ["  ⚠ no usage data available"];
+    }
+    // No banner or top divider — the section headers themselves identify each
+    // provider, and an extra banner line adds noise without information. The
+    // refresh countdown sits on the separator row between sections (or after
+    // the only section), right-aligned.
+    const body = [];
+    sections.forEach((sec, i) => {
+        if (i > 0)
+            body.push(sep);
+        body.push(...sec);
+    });
+    // If there's only one section, the separator still trails it so the refresh
+    // line keeps its fixed position.
+    if (sections.length === 1 && sep)
+        body.push(sep);
+    return body;
+}
+/**
+ * Render a single GLM provider as header + divider + body (the classic card,
+ * minus the fence). Used for `zcode-quota glm`.
+ */
+function renderSingleGlm(result, opts) {
+    const section = renderGlmSection(result, opts);
+    if (result.kind !== "success") {
+        // Non-success → just the prose line, no header/divider (matches formatQuota).
+        return section.body;
+    }
+    const divider = "─".repeat(34);
+    return [section.header, divider, ...section.body];
+}
+//# sourceMappingURL=combined.js.map

package/dist/quota/combined.js.map

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

package/dist/quota/format.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Quota result formatting — renders a {@link QuotaResult} as a multi-line
+ * plain-text card inside a ```text fenced block.
+ *
+ * The whole card is wrapped in a fenced code block so the editor renders it in
+ * a monospace, bordered, copy-able frame. Monospace also normalises the block
+ * element widths (▓/░ are NOT marked East-Asian-Wide, but some proportional
+ * chat fonts stretch them; a code frame guarantees 1-cell-per-bar).
+ *
+ * The progress bar uses two block characters at {@link BAR_WIDTH}-cell width
+ * for a clean, precise fill (each cell = 5%):
+ *   █ (U+2588, full block) — used portion
+ *   ░ (U+2591, light shade) — remaining portion
+ * Inside a monospace code block the full-block reads as a solid, high-impact
+ * fill for used quota, with the light shade marking the remainder.
+ */
+import type { QuotaResult } from "./types.js";
+/**
+ * Render a {@link BAR_WIDTH}-cell progress bar for a used-percent in [0, 100].
+ *
+ * 0% → all empty; 100% → all full; otherwise the used portion is `█` and the
+ * rest is `░`, rounded to the nearest cell (each cell = 10%).
+ */
+export declare function renderBar(usedPercent: number): string;
+/**
+ * Format a reset timestamp (ms) as a local `MM-DD HH:MM` string, or `null`.
+ *
+ * Exported so the Opencode Go formatter can reuse the same layout (Go windows
+ * carry only a relative `resetInSec`; the caller converts that to an absolute
+ * ms timestamp against the fetch snapshot first).
+ */
+export declare function formatResetTime(nextResetTime?: number): string | null;
+/**
+ * Options controlling which sections of the card are rendered.
+ *
+ * - `detail` (default `true`): show per-model usage breakdown sub-lines
+ *   (`├ search-prime …`). Set to `false` for compact terminal output where the
+ *   aggregate bar is enough.
+ * - `compact` (default `false`): collapse the MCP item into a trailing
+ *   annotation on the 5h line (`· MCP (used/total)`) and drop its standalone
+ *   bar line + detail sub-lines. Used only by the combined dual-provider CLI
+ *   view to keep the merged card short; the standalone `glm` subcommand and
+ *   the `/quota` slash command keep the full layout.
+ * - `color` (default `false`): render the bar as a heat-colored (green→red)
+ *   24-bit ANSI bar with the usage numbers overlaid inside (see
+ *   {@link pickOverlay}), leaving only the reset time on the right margin.
+ *   Only the `zcode-quota` CLI sets this (gated on `stdout.isTTY`); the
+ *   `/quota` slash command never does, so its fenced ```text card stays plain
+ *   and copy-paste-safe.
+ */
+export interface FormatOptions {
+    detail?: boolean;
+    compact?: boolean;
+    color?: boolean;
+}
+/**
+ * A rendered GLM section — a header (plan name) and the bar lines.
+ *
+ * Exported so the combined CLI view can compose the GLM section alongside the
+ * Opencode Go section inside one card, without duplicating the per-item
+ * formatting logic.
+ */
+export interface RenderedGlmSection {
+    header: string;
+    body: string[];
+}
+/**
+ * Render the GLM section (header + one bar line per item) without the fence
+ * or divider.
+ *
+ * Non-success kinds return a header of `"GLM Coding Plan"` and a single
+ * explanatory body line, mirroring {@link formatQuota}'s non-success prose
+ * (just split into header/body for composability).
+ *
+ * In `compact` mode the MCP item is collapsed into a trailing annotation on
+ * the 5h line (`· MCP (used/total)`) and its own bar line + detail sub-lines
+ * are dropped — used by the combined dual-provider CLI view to keep the merged
+ * card short. The standalone `glm` subcommand and `/quota` slash command use
+ * the full layout.
+ */
+export declare function renderGlmSection(result: QuotaResult, opts?: FormatOptions): RenderedGlmSection;
+/**
+ * Render a {@link QuotaResult} as a multi-line plain-text card wrapped in a
+ * ```text fenced block.
+ *
+ * The fence makes the editor render the card in a monospace, bordered, copy-
+ * able frame — without it the proportional chat font mangles block-element
+ * widths (▓/░ render at different glyph advances and can look stretched), and
+ * the divider/bars lose their alignment.
+ *
+ * Success → header line + divider + one progress-bar line per item (plus
+ * indented per-model detail where present). Non-success kinds → a single
+ * explanatory line, unfenced (they are short prose, not a card).
+ */
+export declare function formatQuota(result: QuotaResult, opts?: FormatOptions): string;
+/**
+ * {@link formatQuota} without the ```text fence — for raw terminal output.
+ *
+ * The fence is only useful inside an editor chat frame (where it triggers a
+ * bordered, copy-able code block). A real terminal renders the fence as
+ * literal ```` ``` ```` characters, so the standalone CLI strips it.
+ * Non-success kinds are already unfenced short prose, returned unchanged.
+ */
+export declare function formatQuotaPlain(result: QuotaResult, opts?: FormatOptions): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/quota/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/quota/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,YAAY,CAAC;AAiBzD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrE;AAyCD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAgDD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,kBAAkB,CA+B9F;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAU7E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAGlF"}