scoutline 0.1.0 → 0.6.0

package/dist/lib/redact.js

@@ -1,50 +1,184 @@
 /**
- * Redact sensitive values from tool metadata (for output + caching).
+ * Recursive Provider credential redaction (DESIGN.md §16).
+ *
+ * This Module is the single source of truth for stripping Provider
+ * credentials before any value leaves Scoutline's outward boundaries:
+ * formatted errors, cached metadata, quota failures, diagnostics output,
+ * and fatal shell errors.
+ *
+ * Redaction properties (Phase 4 P4-01):
+ *   - Case-insensitive for the canonical credential-shaped keys.
+ *   - Recursive through nested arrays and plain objects.
+ *   - Non-mutating — the original input is never modified.
+ *   - Secret-aware — every configured secret value is replaced inside
+ *     any string the value tree reaches, not just the configured key.
+ *   - Empty-safe — empty strings are never treated as a replacement token.
+ *
+ * The Module retains the legacy `redactSecrets(value, apiKey?)` and
+ * `redactTool(tool)` exports so existing call sites keep compiling.
+ * New code should pass an explicit array of secrets so every Provider's
+ * credential is covered in one pass.
  */
-const REDACT_KEYS = new Set([
+/**
+ * Canonical credential-shaped key names. Lowercased so case-insensitive
+ * matching is a one-step compare. Covers every name DESIGN.md §16
+ * enumerates plus the common HTTP header aliases.
+ */
+const CREDENTIAL_KEYS = new Set([
     "authorization",
-    "Authorization",
+    "x-api-key",
     "api_key",
-    "apiKey",
+    "apikey",
     "access_token",
     "token",
-    "Z_AI_API_KEY",
-    "ZAI_API_KEY",
+    "z_ai_api_key",
+    "zai_api_key",
+    "minimax_api_key",
 ]);
-function redactString(value, apiKey) {
-    let result = value;
-    if (apiKey && result.includes(apiKey)) {
-        result = result.replaceAll(apiKey, "[REDACTED]");
-    }
-    if (/^Bearer\s+\S+/.test(result)) {
-        result = result.replace(/Bearer\s+\S+/, "Bearer [REDACTED]");
+const REDACTED = "[REDACTED]";
+/**
+ * Replace credential-shaped substrings inside a single string. Useful
+ * for error messages and load-failure texts where the value is a flat
+ * string rather than a structured object.
+ *
+ * Replaces:
+ *   - Bearer authorization values (any case).
+ *   - x-api-key assignments (any case; `=`, `:`, or whitespace as the
+ *     key/value separator — covers both `x-api-key=value` and
+ *     `x-api-key value`).
+ *   - Z_AI_API_KEY, ZAI_API_KEY, MINIMAX_API_KEY assignments.
+ *   - The literal credentials passed in `extraSecrets` (each value is
+ *     replaced wherever it appears; empty strings are skipped).
+ */
+export function redactCredentialString(input, extraSecrets) {
+    if (typeof input !== "string")
+        return input;
+    let result = input;
+    result = result.replace(/Bearer\s+\S+/gi, REDACTED);
+    // Fixup C — W3: the class accepts either `=`, `:`, or any whitespace
+    // as the key/value separator. The trailing `\S+` consumes the secret
+    // value; the entire `key + separator + value` span is replaced with
+    // the redaction marker.
+    result = result.replace(/x-api-key[\s=:]+[^\s,;"'`]+/gi, REDACTED);
+    result = result.replace(/Z_AI_API_KEY\s*=\s*\S+/gi, REDACTED);
+    result = result.replace(/ZAI_API_KEY\s*=\s*\S+/gi, REDACTED);
+    result = result.replace(/MINIMAX_API_KEY\s*=\s*\S+/gi, REDACTED);
+    // Embedded credential substrings inside URLs, e.g.
+    // `https://user:secret@host/path`. Catches both `https://` and
+    // `http://` schemes and replaces the entire URL with the marker so
+    // the user info does not leak.
+    result = result.replace(/https?:\/\/[^\s/:]+:[^\s@\/]+@[^\s/]+/gi, REDACTED);
+    const secrets = normalizeSecrets(extraSecrets);
+    for (const secret of secrets) {
+        if (secret.length === 0)
+            continue;
+        // Escape regex meta characters so a secret containing characters
+        // like `.` or `+` does not accidentally broaden the replacement.
+        const escaped = secret.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        result = result.replace(new RegExp(escaped, "g"), REDACTED);
     }
     return result;
 }
-export function redactSecrets(value, apiKey) {
-    if (typeof value === "string") {
-        return redactString(value, apiKey);
+/**
+ * Normalise the `secrets` argument to a deduplicated array of
+ * non-empty strings. A `undefined` argument yields an empty list;
+ * a single string yields `[string]`; an array yields the filtered
+ * list.
+ */
+function normalizeSecrets(secrets) {
+    if (secrets === undefined)
+        return [];
+    const list = Array.isArray(secrets) ? secrets : [secrets];
+    const out = [];
+    const seen = new Set();
+    for (const item of list) {
+        if (typeof item !== "string")
+            continue;
+        if (item.length === 0)
+            continue;
+        if (seen.has(item))
+            continue;
+        seen.add(item);
+        out.push(item);
+    }
+    return out;
+}
+/**
+ * Resolve the configured Provider credential values from the current
+ * process environment. Returned values are deduplicated and empty
+ * entries skipped, so callers can pass the result directly to
+ * {@link redactSecrets}.
+ */
+export function configuredSecrets(env = process.env) {
+    const candidates = [
+        env.Z_AI_API_KEY,
+        env.ZAI_API_KEY,
+        env.MINIMAX_API_KEY,
+    ];
+    return normalizeSecrets(candidates.filter((c) => typeof c === "string"));
+}
+/**
+ * Recursively redact credential values from an arbitrary tree.
+ *
+ * Accepts either a single string (back-compat overload) or an array of
+ * secret values. Returns a NEW value tree; the input is never mutated.
+ *
+ * Key matching is case-insensitive over {@link CREDENTIAL_KEYS}. Plain
+ * objects and arrays are descended into. Other object kinds (Date,
+ * typed arrays, class instances) are returned as-is so their internal
+ * state is not reflected.
+ */
+export function redactSecrets(value, secrets) {
+    const normalized = normalizeSecrets(secrets);
+    // Fast path: primitive value or null/undefined.
+    if (value === null || value === undefined)
+        return value;
+    const t = typeof value;
+    if (t === "string") {
+        return redactCredentialString(value, normalized);
     }
+    if (t !== "object")
+        return value;
+    // Recurse through arrays.
     if (Array.isArray(value)) {
-        return value.map((item) => redactSecrets(item, apiKey));
+        return value.map((item) => redactSecrets(item, normalized));
     }
-    if (value && typeof value === "object") {
-        const obj = value;
-        const output = {};
-        for (const [key, child] of Object.entries(obj)) {
-            if (REDACT_KEYS.has(key)) {
-                output[key] = "[REDACTED]";
-                continue;
-            }
-            output[key] = redactSecrets(child, apiKey);
+    // Skip exotic non-plain objects: Date, TypedArrays, Map, Set,
+    // class instances. Plain objects descend; everything else is left
+    // untouched to avoid reflecting internal state.
+    if (!isPlainObject(value)) {
+        return value;
+    }
+    const input = value;
+    const output = {};
+    for (const key of Object.keys(input)) {
+        if (CREDENTIAL_KEYS.has(key.toLowerCase())) {
+            output[key] = REDACTED;
+            continue;
         }
-        return output;
+        output[key] = redactSecrets(input[key], normalized);
     }
-    return value;
+    return output;
+}
+function isPlainObject(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
 }
-export function redactTool(tool) {
-    const apiKey = process.env.Z_AI_API_KEY || process.env.ZAI_API_KEY;
+/**
+ * Redact credential-shaped fields from a Tool's metadata tree.
+ *
+ * Back-compat: when called with a single argument the function reads
+ * the configured Provider credentials from the current process
+ * environment. When called with an explicit secrets argument, the
+ * caller's value is used instead.
+ */
+export function redactTool(tool, secrets) {
+    const resolved = secrets === undefined
+        ? configuredSecrets()
+        : normalizeSecrets(secrets);
     const clone = JSON.parse(JSON.stringify(tool));
-    return redactSecrets(clone, apiKey);
+    return redactSecrets(clone, resolved);
 }
 //# sourceMappingURL=redact.js.map

package/dist/lib/redact.js.map

@@ -1 +1 @@
-{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/lib/redact.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,eAAe;IACf,eAAe;IACf,SAAS;IACT,QAAQ;IACR,cAAc;IACd,OAAO;IACP,cAAc;IACd,aAAa;CACd,CAAC,CAAC;AAEH,SAAS,YAAY,CAAC,KAAa,EAAE,MAAe;IAClD,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,MAAe;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAS,CAAC;IACvD,OAAO,aAAa,CAAC,KAAK,EAAE,MAAM,CAAS,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/lib/redact.ts"],"names":[],"mappings":"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"}

package/dist/lib/tool-cache.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Tool-discovery cache — extracted from {@link ZaiMcpClient} (Ticket 02).
+ *
+ * Owns its filesystem I/O directly against the `tools/` subdirectory
+ * under the unified cache root (D1 revised — does NOT reuse
+ * `ResponseCache` for storage). Stores {@link redactTool}-scrubbed tools
+ * (B2 fix) under a single TTL check (H2 fix).
+ *
+ * # Enable check (preserves v0.4.0 granularity — D3 deviation)
+ *
+ * ```text
+ * isToolCacheEnabled = isCacheEnabled() && ZAI_MCP_TOOL_CACHE != "0"/"false"
+ * ```
+ *
+ * - `SCOUTLINE_CACHE=0` (or legacy `ZAI_CACHE=0`) disables BOTH caches
+ *   because `isCacheEnabled()` returns false.
+ * - `ZAI_MCP_TOOL_CACHE=0` disables ONLY the tool cache; the response
+ *   cache stays enabled because `isCacheEnabled()` does NOT consult
+ *   this var. This preserves the four `mcp-client.test.js` suites that
+ *   set `ZAI_MCP_TOOL_CACHE=0` per-suite while relying on
+ *   response-cache hits.
+ *
+ * # Versioning
+ *
+ * {@link TOOL_CACHE_VERSION} is stamped into every cache envelope. A
+ * mismatch (e.g. an old `tools-*.json` written by a future or past
+ * release) yields a clean miss — never a throw — so an upgrade cannot
+ * break tool discovery.
+ */
+import type { Tool } from "@utcp/sdk";
+/**
+ * Cache envelope version. Bumped when the on-disk shape of
+ * {@link ToolCachePayload} changes; old envelopes are ignored.
+ */
+export declare const TOOL_CACHE_VERSION = 1;
+/**
+ * Inputs to the tool-cache key. Captures every dimension that affects
+ * WHICH tools the MCP servers return: mode + baseUrl (ZAI vs ZHIPU),
+ * the three HTTP endpoints, and whether the stdio vision server is
+ * registered. The ZaiMcpClient adapter builds this from {@link loadConfig}
+ * + {@link getMcpEndpoints} + its private `resolveEnableVision()`.
+ */
+export interface ToolCacheConfig {
+    mode: string;
+    baseUrl: string;
+    endpoints: Record<string, string>;
+    enableVision: boolean;
+}
+/**
+ * Tool-cache enable check (preserves v0.4.0 granularity — D3
+ * deviation). The tool cache is enabled only when BOTH:
+ *   - the response cache is enabled (`isCacheEnabled()` honours
+ *     `SCOUTLINE_CACHE` / `ZAI_CACHE`); AND
+ *   - the tool-specific `ZAI_MCP_TOOL_CACHE` env var is not "0"/"false".
+ *
+ * Read at call time (H1 fix) so per-suite env mutations in tests remain
+ * observable.
+ */
+export declare function isToolCacheEnabled(): boolean;
+/**
+ * Build the 16-char cache key for a config. Mirrors the v0.4.0 algorithm
+ * in the extracted `ZaiMcpClient.getToolCacheKey`: SHA-256 of the
+ * JSON-stringified config, first 16 hex chars. Two configs that produce
+ * the same JSON yield the same key; distinct configs yield distinct keys.
+ */
+export declare function buildToolCacheKey(config: ToolCacheConfig): string;
+/**
+ * Build the absolute on-disk path for a config's tool-cache envelope.
+ * Always lands under the `tools/` subdirectory (sibling of `cache/`).
+ */
+export declare function buildToolCachePath(config: ToolCacheConfig): string;
+/**
+ * Read the tool cache for a config. Returns `null` on miss, version
+ * mismatch, TTL expiry, corruption (invalid JSON, missing file), or when
+ * the tool cache is disabled. NEVER throws — a miss degrades cleanly to
+ * discovery.
+ */
+export declare function readToolCache(config: ToolCacheConfig): Promise<Tool[] | null>;
+/**
+ * Write the tool cache for a config. Applies {@link redactTool} to every
+ * tool before serialization (B2 fix) so the on-disk envelope never
+ * contains raw Provider credentials. Best-effort: I/O failures are
+ * swallowed (cache is disposable).
+ */
+export declare function writeToolCache(config: ToolCacheConfig, tools: Tool[]): Promise<void>;
+//# sourceMappingURL=tool-cache.d.ts.map

package/dist/lib/tool-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cache.d.ts","sourceRoot":"","sources":["../../src/lib/tool-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAItC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC;CACvB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAI5C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAElE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAenF;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1F"}

package/dist/lib/tool-cache.js

@@ -0,0 +1,123 @@
+/**
+ * Tool-discovery cache — extracted from {@link ZaiMcpClient} (Ticket 02).
+ *
+ * Owns its filesystem I/O directly against the `tools/` subdirectory
+ * under the unified cache root (D1 revised — does NOT reuse
+ * `ResponseCache` for storage). Stores {@link redactTool}-scrubbed tools
+ * (B2 fix) under a single TTL check (H2 fix).
+ *
+ * # Enable check (preserves v0.4.0 granularity — D3 deviation)
+ *
+ * ```text
+ * isToolCacheEnabled = isCacheEnabled() && ZAI_MCP_TOOL_CACHE != "0"/"false"
+ * ```
+ *
+ * - `SCOUTLINE_CACHE=0` (or legacy `ZAI_CACHE=0`) disables BOTH caches
+ *   because `isCacheEnabled()` returns false.
+ * - `ZAI_MCP_TOOL_CACHE=0` disables ONLY the tool cache; the response
+ *   cache stays enabled because `isCacheEnabled()` does NOT consult
+ *   this var. This preserves the four `mcp-client.test.js` suites that
+ *   set `ZAI_MCP_TOOL_CACHE=0` per-suite while relying on
+ *   response-cache hits.
+ *
+ * # Versioning
+ *
+ * {@link TOOL_CACHE_VERSION} is stamped into every cache envelope. A
+ * mismatch (e.g. an old `tools-*.json` written by a future or past
+ * release) yields a clean miss — never a throw — so an upgrade cannot
+ * break tool discovery.
+ */
+import crypto from "node:crypto";
+import * as fs from "node:fs/promises";
+import path from "node:path";
+import { toolCacheDir, isCacheEnabled, getCacheTtlMs } from "./cache.js";
+import { redactTool } from "./redact.js";
+/**
+ * Cache envelope version. Bumped when the on-disk shape of
+ * {@link ToolCachePayload} changes; old envelopes are ignored.
+ */
+export const TOOL_CACHE_VERSION = 1;
+/**
+ * Tool-cache enable check (preserves v0.4.0 granularity — D3
+ * deviation). The tool cache is enabled only when BOTH:
+ *   - the response cache is enabled (`isCacheEnabled()` honours
+ *     `SCOUTLINE_CACHE` / `ZAI_CACHE`); AND
+ *   - the tool-specific `ZAI_MCP_TOOL_CACHE` env var is not "0"/"false".
+ *
+ * Read at call time (H1 fix) so per-suite env mutations in tests remain
+ * observable.
+ */
+export function isToolCacheEnabled() {
+    if (!isCacheEnabled())
+        return false;
+    const v = (process.env.ZAI_MCP_TOOL_CACHE ?? "1").toLowerCase();
+    return !["0", "false"].includes(v);
+}
+/**
+ * Build the 16-char cache key for a config. Mirrors the v0.4.0 algorithm
+ * in the extracted `ZaiMcpClient.getToolCacheKey`: SHA-256 of the
+ * JSON-stringified config, first 16 hex chars. Two configs that produce
+ * the same JSON yield the same key; distinct configs yield distinct keys.
+ */
+export function buildToolCacheKey(config) {
+    return crypto.createHash("sha256").update(JSON.stringify(config)).digest("hex").slice(0, 16);
+}
+/**
+ * Build the absolute on-disk path for a config's tool-cache envelope.
+ * Always lands under the `tools/` subdirectory (sibling of `cache/`).
+ */
+export function buildToolCachePath(config) {
+    return path.join(toolCacheDir(), `tools-${buildToolCacheKey(config)}.json`);
+}
+/**
+ * Read the tool cache for a config. Returns `null` on miss, version
+ * mismatch, TTL expiry, corruption (invalid JSON, missing file), or when
+ * the tool cache is disabled. NEVER throws — a miss degrades cleanly to
+ * discovery.
+ */
+export async function readToolCache(config) {
+    if (!isToolCacheEnabled())
+        return null;
+    const ttlMs = getCacheTtlMs();
+    if (ttlMs <= 0)
+        return null;
+    try {
+        const raw = await fs.readFile(buildToolCachePath(config), "utf8");
+        const entry = JSON.parse(raw);
+        if (!entry || entry.version !== TOOL_CACHE_VERSION || !Array.isArray(entry.tools)) {
+            return null;
+        }
+        if (Date.now() - (entry.timestamp ?? 0) > ttlMs)
+            return null;
+        return entry.tools;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write the tool cache for a config. Applies {@link redactTool} to every
+ * tool before serialization (B2 fix) so the on-disk envelope never
+ * contains raw Provider credentials. Best-effort: I/O failures are
+ * swallowed (cache is disposable).
+ */
+export async function writeToolCache(config, tools) {
+    if (!isToolCacheEnabled())
+        return;
+    if (getCacheTtlMs() <= 0)
+        return;
+    try {
+        const filePath = buildToolCachePath(config);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        const payload = {
+            version: TOOL_CACHE_VERSION,
+            timestamp: Date.now(),
+            tools: tools.map((tool) => redactTool(tool)),
+        };
+        await fs.writeFile(filePath, JSON.stringify(payload));
+    }
+    catch {
+        // Best-effort cache only.
+    }
+}
+//# sourceMappingURL=tool-cache.js.map

package/dist/lib/tool-cache.js.map

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

package/dist/lib/tty.d.ts

@@ -36,25 +36,12 @@ interface SearchResultLike {
     occurrences?: number;
 }
 export declare function formatSearchResultsPretty(results: SearchResultLike[]): string;
-interface QuotaLike {
-    plan?: string;
-    timeWindow?: {
-        used?: number;
-        limit?: number;
-        remaining?: number;
-        percentage?: number;
-        windowHours?: number;
-        resetsIn?: string | null;
-        byTool?: Array<{
-            modelCode?: string;
-            usage?: number;
-        }>;
-    } | null;
-    tokens?: {
-        percentage?: number;
-        resetsIn?: string | null;
-    } | null;
-}
-export declare function formatQuotaPretty(q: QuotaLike): string;
+import type { QuotaDashboard } from "../capabilities/quota.js";
+/**
+ * Provider-neutral TTY rendering of a {@link QuotaDashboard}. Each
+ * Provider entry is labelled with its Provider id and each category by
+ * its normalized name; progress bars represent the REMAINING percentage.
+ */
+export declare function formatQuotaDashboard(dashboard: QuotaDashboard): string;
 export {};
 //# sourceMappingURL=tty.d.ts.map

package/dist/lib/tty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../src/lib/tty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,KAAK,OAAO,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAUrC,eAAO,MAAM,KAAK;IAChB,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,KAAK;IACL,MAAM;IACN,GAAG;IACH,OAAO;IACP,IAAI;CACL,CAAC;AAEF,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,KAAK,GAAG,SAAS,CAKnB;AAED,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAe7E;AAED,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxD,GAAG,IAAI,CAAC;IACT,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE;AAUD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAqCtD"}
+{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../src/lib/tty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,KAAK,OAAO,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAUrC,eAAO,MAAM,KAAK;IAChB,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,KAAK;IACL,MAAM;IACN,GAAG;IACH,OAAO;IACP,IAAI;CACL,CAAC;AAEF,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,KAAK,GAAG,SAAS,CAKnB;AAED,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAe7E;AAED,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAsE/D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,CAkBtE"}

package/dist/lib/tty.js

@@ -60,42 +60,63 @@ export function formatSearchResultsPretty(results) {
     }
     return lines.join("\n");
 }
-/** ASCII progress bar: 20 chars wide. */
-function progressBar(pct) {
+/**
+ * Remaining-percentage progress bar: 20 chars wide. Low remaining is
+ * red (tight quota), high remaining is green. The bar represents the
+ * REMAINING share, not the used share.
+ */
+function remainingBar(pct) {
     const filled = Math.round((pct / 100) * 20);
     const bar = "█".repeat(filled) + "░".repeat(20 - filled);
-    const colorFn = pct >= 90 ? color.red : pct >= 70 ? color.yellow : color.green;
+    const colorFn = pct < 30 ? color.red : pct < 70 ? color.yellow : color.green;
     return colorFn(bar);
 }
-export function formatQuotaPretty(q) {
-    const lines = [];
-    lines.push("");
-    lines.push(`  ${color.bold("Z.AI Coding Plan")} — ${color.magenta(q.plan || "unknown")} tier`);
-    lines.push("");
-    if (q.timeWindow) {
-        const tw = q.timeWindow;
-        const pct = tw.percentage ?? 0;
-        const resetTxt = tw.resetsIn ? `resets in ${color.dim(tw.resetsIn)}` : "";
-        lines.push(`  ${color.bold(`Time window`)} ${color.gray(`(${tw.windowHours || 5}h rolling)`)}  ${resetTxt}`);
-        lines.push("");
-        lines.push(`  ${progressBar(pct)}  ${tw.used ?? 0}/${tw.limit ?? 0} calls (${pct}%)`);
-        if (tw.remaining !== undefined) {
-            lines.push(`  ${color.green(`${tw.remaining} remaining`)}`);
-        }
-        if (tw.byTool && tw.byTool.length > 0) {
-            lines.push("");
-            const sorted = [...tw.byTool].sort((a, b) => (b.usage || 0) - (a.usage || 0));
-            for (const t of sorted) {
-                lines.push(`    ${color.gray("•")} ${t.modelCode}: ${t.usage || 0}`);
+function formatResetLabel(resetsAt) {
+    if (!resetsAt)
+        return "";
+    return `resets ${color.gray(resetsAt)}`;
+}
+function renderCategory(category, lines) {
+    const current = category.current;
+    const pct = current.remainingPercent;
+    const resetTxt = formatResetLabel(current.resetsAt);
+    lines.push(`    ${color.bold(category.name)}  ${remainingBar(pct)}  ${pct}% remaining`);
+    const counts = [];
+    if (typeof current.used === "number" && typeof current.limit === "number") {
+        counts.push(`${current.used}/${current.limit}`);
+    }
+    if (typeof current.remaining === "number") {
+        counts.push(`${color.green(`${current.remaining} left`)}`);
+    }
+    if (counts.length > 0 || resetTxt) {
+        lines.push(`      ${[...counts, resetTxt].filter(Boolean).join("  ·  ")}`);
+    }
+    if (category.weekly) {
+        const w = category.weekly;
+        lines.push(`      ${color.gray("weekly")} ${remainingBar(w.remainingPercent)} ${w.remainingPercent}%`);
+    }
+}
+/**
+ * Provider-neutral TTY rendering of a {@link QuotaDashboard}. Each
+ * Provider entry is labelled with its Provider id and each category by
+ * its normalized name; progress bars represent the REMAINING percentage.
+ */
+export function formatQuotaDashboard(dashboard) {
+    const lines = [""];
+    for (const entry of dashboard.providers) {
+        if (entry.status === "ok") {
+            const success = entry;
+            const planTxt = success.plan ? ` ${color.gray(`(${success.plan})`)}` : "";
+            lines.push(`  ${color.bold(success.provider)}${planTxt}`);
+            for (const category of success.categories) {
+                renderCategory(category, lines);
             }
         }
-        lines.push("");
-    }
-    if (q.tokens) {
-        const pct = q.tokens.percentage ?? 0;
-        const resetTxt = q.tokens.resetsIn ? `resets in ${color.dim(q.tokens.resetsIn)}` : "";
-        lines.push(`  ${color.bold("Token budget")}  ${resetTxt}`);
-        lines.push(`  ${progressBar(pct)}  ${pct}% used`);
+        else {
+            const failure = entry;
+            lines.push(`  ${color.bold(failure.provider)} ${color.red("error")}`);
+            lines.push(`    ${color.dim(failure.error.message)}`);
+        }
         lines.push("");
     }
     return lines.join("\n");

package/dist/lib/tty.js.map

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