@indigoai-us/hq-cli 5.345.91 → 5.345.93

package/dist/commands/capacity.d.ts

@@ -0,0 +1,71 @@
+/**
+ * hq capacity. `capacity`, `history`, and `doctor` read the local ledger.
+ * `enable`, `login`, and `ingest` write. Pinned CLI versions are the US-001
+ * version tokens; the installed version is the cliVersion on the latest reading.
+ *
+ * Codex rate limits use `codex app-server` only after 30 minutes idle and
+ * while no codex process is running. `account/rateLimits/read` does not
+ * refresh tokens. Starting app-server can still rewrite ~/.codex/auth.json
+ * for a managed ChatGPT login, so the read stays idle-gated.
+ */
+import { Command } from "commander";
+import { type CapacityState, type LedgerEvent, type LedgerOptions, type NowView, type ParserFailureEvent, type Reading, type ReadingSource } from "../lib/capacity/ledger.js";
+import { type CapacityAccount } from "../lib/capacity/accounts.js";
+export declare const CAPACITY_SCHEMA_VERSION: "hq-capacity-now-view.v1";
+export declare const DOCTOR_SCHEMA_VERSION = "hq-capacity-doctor.v1";
+export declare const PARSER_FAILURE_WINDOW_MS: number;
+/** now.json older than this is stale: the collector is not keeping the view current. */
+export declare const CAPACITY_STALE_MS: number;
+/** Short versions inside test/fixtures/capacity/cli-versions.json. */
+export declare const PINNED_CLI_VERSIONS: Record<string, string>;
+export interface CapacityJson extends NowView {
+    schemaVersion: string;
+    stale: boolean;
+    ageMs: number;
+    /** null when collector.json is absent. false means the collector was turned off. */
+    collectorEnabled: boolean | null;
+}
+export interface CapacityFreshness {
+    stale: boolean;
+    ageMs: number;
+    message: string | null;
+}
+export interface DoctorSource {
+    source: ReadingSource;
+    lastSuccess: string | null;
+}
+export interface DoctorVersion {
+    provider: string;
+    pinned: string | null;
+    installed: string | null;
+    match: boolean;
+}
+export interface DoctorReport {
+    schemaVersion: typeof DOCTOR_SCHEMA_VERSION;
+    collector: "on" | "off";
+    sources: DoctorSource[];
+    versions: DoctorVersion[];
+    parserFailures: ParserFailureEvent[];
+    providers: {
+        provider: string;
+        state: CapacityState;
+    }[];
+    ok: boolean;
+    stale: boolean;
+    ageMs: number;
+}
+export declare function capacityOptionsFromEnv(env?: NodeJS.ProcessEnv): LedgerOptions;
+export declare function withSchemaVersion(view: NowView): Omit<CapacityJson, "stale" | "ageMs" | "collectorEnabled">;
+/** Stale when generatedAt is missing or older than five minutes. */
+export declare function capacityFreshness(generatedAt: string, nowMs: number): CapacityFreshness;
+export declare function parseSince(since: string, nowMs: number): number;
+export declare function selectReadings(events: LedgerEvent[], filter?: {
+    provider?: string;
+    sinceMs?: number;
+}): Reading[];
+export declare function formatCapacityTable(view: NowView, nowMs: number, accounts?: readonly CapacityAccount[]): string;
+export declare function formatHistory(readings: Reading[]): string;
+export declare function buildDoctorReport(options?: LedgerOptions): DoctorReport;
+export declare function formatDoctor(report: DoctorReport): string;
+export declare function registerCapacityCommand(program: Command): Command;
+//# sourceMappingURL=capacity.d.ts.map