@slopus/happy-agent-client 0.0.99 → 0.0.101

package/dist/protocol/usage.d.ts

@@ -5,6 +5,7 @@
  * is always by provider and then by model; a client wanting a rollup computes
  * its own.
  */
+import { type Static } from "@sinclair/typebox";
 /** Token counts for one model. */
 export interface ModelUsage {
     input: number;
@@ -15,47 +16,231 @@ export interface ModelUsage {
 /** Provider key, then model ID, then the counts. */
 export type UsageBreakdown = Record<string, Record<string, ModelUsage>>;
 /** One normalized account-usage window reported by a provider. */
-export interface ProviderAccountUsageWindow {
-    usedPercent: number;
-    resetsAt: number | null;
-    startsAt: number | null;
-    durationMs: number | null;
-}
+export declare const providerAccountUsageWindowSchema: import("@sinclair/typebox").TObject<{
+    usedPercent: import("@sinclair/typebox").TNumber;
+    resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+    startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+    durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+    /** When this window itself was last measured, protocol 29 or newer. */
+    capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type ProviderAccountUsageWindow = Static<typeof providerAccountUsageWindowSchema>;
 /** Spendable balance reported alongside a provider's account limits. */
-export interface ProviderAccountUsageCredits {
-    available: boolean;
-    remainingCents: number | null;
-    unlimited: boolean;
-    usedPercent: number | null;
-}
+export declare const providerAccountUsageCreditsSchema: import("@sinclair/typebox").TObject<{
+    available: import("@sinclair/typebox").TBoolean;
+    remainingCents: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+    unlimited: import("@sinclair/typebox").TBoolean;
+    usedPercent: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+}>;
+export type ProviderAccountUsageCredits = Static<typeof providerAccountUsageCreditsSchema>;
 /** The complete latest normalized account-usage reading from one vendor. */
-export interface ProviderAccountUsage {
-    providerId: string;
-    vendor: "claude" | "codex" | "grok";
-    capturedAt: number;
-    planName: string | null;
-    exhausted: boolean;
-    windows: {
-        fiveHour: ProviderAccountUsageWindow | null;
-        weekly: ProviderAccountUsageWindow | null;
-        monthly: ProviderAccountUsageWindow | null;
+export declare const providerAccountUsageSchema: import("@sinclair/typebox").TObject<{
+    providerId: import("@sinclair/typebox").TString;
+    vendor: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"claude">, import("@sinclair/typebox").TLiteral<"codex">, import("@sinclair/typebox").TLiteral<"grok">]>;
+    capturedAt: import("@sinclair/typebox").TNumber;
+    planName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    exhausted: import("@sinclair/typebox").TBoolean;
+    windows: import("@sinclair/typebox").TObject<{
+        fiveHour: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            usedPercent: import("@sinclair/typebox").TNumber;
+            resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            /** When this window itself was last measured, protocol 29 or newer. */
+            capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        }>, import("@sinclair/typebox").TNull]>;
+        weekly: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            usedPercent: import("@sinclair/typebox").TNumber;
+            resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            /** When this window itself was last measured, protocol 29 or newer. */
+            capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        }>, import("@sinclair/typebox").TNull]>;
+        monthly: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            usedPercent: import("@sinclair/typebox").TNumber;
+            resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            /** When this window itself was last measured, protocol 29 or newer. */
+            capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        }>, import("@sinclair/typebox").TNull]>;
         /** Claude's separate weekly Fable allowance. Omitted or null when unreported. */
-        fableWeekly?: ProviderAccountUsageWindow | null;
-    };
-    credits: ProviderAccountUsageCredits | null;
-}
+        fableWeekly: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            usedPercent: import("@sinclair/typebox").TNumber;
+            resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            /** When this window itself was last measured, protocol 29 or newer. */
+            capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        }>, import("@sinclair/typebox").TNull]>>;
+    }>;
+    credits: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        available: import("@sinclair/typebox").TBoolean;
+        remainingCents: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+        unlimited: import("@sinclair/typebox").TBoolean;
+        usedPercent: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+    }>, import("@sinclair/typebox").TNull]>;
+}>;
+export type ProviderAccountUsage = Static<typeof providerAccountUsageSchema>;
+/**
+ * Everything the daemon knows about reading one provider account, without its configuration.
+ *
+ * The refresh fields are optional only for compatibility with older daemons: a protocol-29 daemon
+ * always sends them, so an entry without `refreshedAt` comes from a daemon that neither publishes
+ * `provider.usage.updated` nor serves `POST /v0/usage/refresh`.
+ */
+export declare const providerAccountUsageStateSchema: import("@sinclair/typebox").TObject<{
+    providerId: import("@sinclair/typebox").TString;
+    /** The latest successful normalized reading, or `null` when none is available. */
+    usage: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        providerId: import("@sinclair/typebox").TString;
+        vendor: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"claude">, import("@sinclair/typebox").TLiteral<"codex">, import("@sinclair/typebox").TLiteral<"grok">]>;
+        capturedAt: import("@sinclair/typebox").TNumber;
+        planName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        exhausted: import("@sinclair/typebox").TBoolean;
+        windows: import("@sinclair/typebox").TObject<{
+            fiveHour: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                usedPercent: import("@sinclair/typebox").TNumber;
+                resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                /** When this window itself was last measured, protocol 29 or newer. */
+                capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            }>, import("@sinclair/typebox").TNull]>;
+            weekly: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                usedPercent: import("@sinclair/typebox").TNumber;
+                resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                /** When this window itself was last measured, protocol 29 or newer. */
+                capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            }>, import("@sinclair/typebox").TNull]>;
+            monthly: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                usedPercent: import("@sinclair/typebox").TNumber;
+                resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                /** When this window itself was last measured, protocol 29 or newer. */
+                capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            }>, import("@sinclair/typebox").TNull]>;
+            /** Claude's separate weekly Fable allowance. Omitted or null when unreported. */
+            fableWeekly: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                usedPercent: import("@sinclair/typebox").TNumber;
+                resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                /** When this window itself was last measured, protocol 29 or newer. */
+                capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            }>, import("@sinclair/typebox").TNull]>>;
+        }>;
+        credits: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            available: import("@sinclair/typebox").TBoolean;
+            remainingCents: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            unlimited: import("@sinclair/typebox").TBoolean;
+            usedPercent: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+        }>, import("@sinclair/typebox").TNull]>;
+    }>, import("@sinclair/typebox").TNull]>;
+    /** When the daemon last finished asking, successfully or not. */
+    checkedAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+    /** Why no reading is available at all. */
+    error: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    /** When the last successful reading arrived, from a poll or from inference. */
+    refreshedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>>;
+    /** Why the latest read failed, kept even while an older reading is shown. */
+    refreshError: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+    /** The instant before which the vendor asked not to be asked again. */
+    retryAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>>;
+    /** Whether a read of this account is in flight. */
+    refreshing: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export type ProviderAccountUsageState = Static<typeof providerAccountUsageStateSchema>;
 /** One configured provider, its complete model catalog, and its latest account limits. */
-export interface ProviderUsageEntry {
-    providerId: string;
-    /** The canonical provider key from the effective configuration. */
-    type: string;
-    enabled: boolean;
-    /** The same complete model-reference list returned for this provider by `GET /v0/config`. */
-    models: import("./daemon.js").ProviderModelReference[];
-    usage: ProviderAccountUsage | null;
-    checkedAt: number | null;
-    error: string | null;
-}
+export declare const providerUsageEntrySchema: import("@sinclair/typebox").TObject<{
+    checkedAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+    enabled: import("@sinclair/typebox").TBoolean;
+    error: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    models: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        defaultEffort: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        efforts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        enabled: import("@sinclair/typebox").TBoolean;
+        id: import("@sinclair/typebox").TString;
+        name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        serviceTierOptions: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            id: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            label: import("@sinclair/typebox").TString;
+        }>>>;
+        serviceTiers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>>;
+    providerId: import("@sinclair/typebox").TString;
+    refreshError: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+    refreshedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>>;
+    refreshing: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    retryAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>>;
+    type: import("@sinclair/typebox").TString;
+    usage: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        providerId: import("@sinclair/typebox").TString;
+        vendor: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"claude">, import("@sinclair/typebox").TLiteral<"codex">, import("@sinclair/typebox").TLiteral<"grok">]>;
+        capturedAt: import("@sinclair/typebox").TNumber;
+        planName: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        exhausted: import("@sinclair/typebox").TBoolean;
+        windows: import("@sinclair/typebox").TObject<{
+            fiveHour: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                usedPercent: import("@sinclair/typebox").TNumber;
+                resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                /** When this window itself was last measured, protocol 29 or newer. */
+                capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            }>, import("@sinclair/typebox").TNull]>;
+            weekly: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                usedPercent: import("@sinclair/typebox").TNumber;
+                resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                /** When this window itself was last measured, protocol 29 or newer. */
+                capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            }>, import("@sinclair/typebox").TNull]>;
+            monthly: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                usedPercent: import("@sinclair/typebox").TNumber;
+                resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                /** When this window itself was last measured, protocol 29 or newer. */
+                capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            }>, import("@sinclair/typebox").TNull]>;
+            /** Claude's separate weekly Fable allowance. Omitted or null when unreported. */
+            fableWeekly: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                usedPercent: import("@sinclair/typebox").TNumber;
+                resetsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                startsAt: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                durationMs: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+                /** When this window itself was last measured, protocol 29 or newer. */
+                capturedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+            }>, import("@sinclair/typebox").TNull]>>;
+        }>;
+        credits: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            available: import("@sinclair/typebox").TBoolean;
+            remainingCents: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+            unlimited: import("@sinclair/typebox").TBoolean;
+            usedPercent: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TNull]>;
+        }>, import("@sinclair/typebox").TNull]>;
+    }>, import("@sinclair/typebox").TNull]>;
+}>;
+export type ProviderUsageEntry = Static<typeof providerUsageEntrySchema>;
+/** `POST /v0/usage/refresh` request body, protocol 29 or newer. */
+export declare const providerUsageRefreshRequestSchema: import("@sinclair/typebox").TObject<{
+    /** The accounts to consider; every enabled account when omitted. */
+    providerIds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    /** Read only accounts older than this; defaults to 300000 and is at least 60000. */
+    olderThanMs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type ProviderUsageRefreshRequest = Static<typeof providerUsageRefreshRequestSchema>;
+/** `POST /v0/usage/refresh` — `202`; the results arrive as `provider.usage.updated`. */
+export declare const providerUsageRefreshResponseSchema: import("@sinclair/typebox").TObject<{
+    started: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>;
+export type ProviderUsageRefreshResponse = Static<typeof providerUsageRefreshResponseSchema>;
 /** The latest exact provider measurement of one agent's active conversation context. */
 export interface AgentContextUsage {
     approximate: boolean;

package/dist/protocol/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../sources/protocol/usage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAExE,kEAAkE;AAClE,MAAM,WAAW,0BAA0B;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wEAAwE;AACxE,MAAM,WAAW,2BAA2B;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE;QACL,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAAC;QAC5C,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAAC;QAC1C,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;QAC3C,iFAAiF;QACjF,WAAW,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;KACnD,CAAC;IACF,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC;CAC/C;AAED,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,6FAA6F;IAC7F,MAAM,EAAE,OAAO,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACvD,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IAC/B,uFAAuF;IACvF,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,KAAK,EAAE,cAAc,CAAC;CACzB;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAChC,sFAAsF;IACtF,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;CACzB"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../sources/protocol/usage.ts"],"names":[],"mappings":"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"}

package/dist/protocol/usage.js

@@ -5,5 +5,85 @@
  * is always by provider and then by model; a client wanting a rollup computes
  * its own.
  */
-export {};
+import { Type } from "@sinclair/typebox";
+import { Nullable } from "./common.js";
+import { providerModelReferenceSchema } from "./daemon.js";
+/** One normalized account-usage window reported by a provider. */
+export const providerAccountUsageWindowSchema = Type.Object({
+    usedPercent: Type.Number(),
+    resetsAt: Nullable(Type.Number()),
+    startsAt: Nullable(Type.Number()),
+    durationMs: Nullable(Type.Number()),
+    /** When this window itself was last measured, protocol 29 or newer. */
+    capturedAt: Type.Optional(Type.Number()),
+});
+/** Spendable balance reported alongside a provider's account limits. */
+export const providerAccountUsageCreditsSchema = Type.Object({
+    available: Type.Boolean(),
+    remainingCents: Nullable(Type.Number()),
+    unlimited: Type.Boolean(),
+    usedPercent: Nullable(Type.Number()),
+});
+/** The complete latest normalized account-usage reading from one vendor. */
+export const providerAccountUsageSchema = Type.Object({
+    providerId: Type.String(),
+    vendor: Type.Union([Type.Literal("claude"), Type.Literal("codex"), Type.Literal("grok")]),
+    capturedAt: Type.Number(),
+    planName: Nullable(Type.String()),
+    exhausted: Type.Boolean(),
+    windows: Type.Object({
+        fiveHour: Nullable(providerAccountUsageWindowSchema),
+        weekly: Nullable(providerAccountUsageWindowSchema),
+        monthly: Nullable(providerAccountUsageWindowSchema),
+        /** Claude's separate weekly Fable allowance. Omitted or null when unreported. */
+        fableWeekly: Type.Optional(Nullable(providerAccountUsageWindowSchema)),
+    }),
+    credits: Nullable(providerAccountUsageCreditsSchema),
+});
+/**
+ * Everything the daemon knows about reading one provider account, without its configuration.
+ *
+ * The refresh fields are optional only for compatibility with older daemons: a protocol-29 daemon
+ * always sends them, so an entry without `refreshedAt` comes from a daemon that neither publishes
+ * `provider.usage.updated` nor serves `POST /v0/usage/refresh`.
+ */
+export const providerAccountUsageStateSchema = Type.Object({
+    providerId: Type.String(),
+    /** The latest successful normalized reading, or `null` when none is available. */
+    usage: Nullable(providerAccountUsageSchema),
+    /** When the daemon last finished asking, successfully or not. */
+    checkedAt: Nullable(Type.Number()),
+    /** Why no reading is available at all. */
+    error: Nullable(Type.String()),
+    /** When the last successful reading arrived, from a poll or from inference. */
+    refreshedAt: Type.Optional(Nullable(Type.Number())),
+    /** Why the latest read failed, kept even while an older reading is shown. */
+    refreshError: Type.Optional(Nullable(Type.String())),
+    /** The instant before which the vendor asked not to be asked again. */
+    retryAt: Type.Optional(Nullable(Type.Number())),
+    /** Whether a read of this account is in flight. */
+    refreshing: Type.Optional(Type.Boolean()),
+});
+/** One configured provider, its complete model catalog, and its latest account limits. */
+export const providerUsageEntrySchema = Type.Composite([
+    providerAccountUsageStateSchema,
+    Type.Object({
+        /** The canonical provider key from the effective configuration. */
+        type: Type.String(),
+        enabled: Type.Boolean(),
+        /** The same complete model-reference list returned for this provider by `GET /v0/config`. */
+        models: Type.Array(providerModelReferenceSchema),
+    }),
+]);
+/** `POST /v0/usage/refresh` request body, protocol 29 or newer. */
+export const providerUsageRefreshRequestSchema = Type.Object({
+    /** The accounts to consider; every enabled account when omitted. */
+    providerIds: Type.Optional(Type.Array(Type.String())),
+    /** Read only accounts older than this; defaults to 300000 and is at least 60000. */
+    olderThanMs: Type.Optional(Type.Number({ minimum: 0 })),
+}, { additionalProperties: false });
+/** `POST /v0/usage/refresh` — `202`; the results arrive as `provider.usage.updated`. */
+export const providerUsageRefreshResponseSchema = Type.Object({
+    started: Type.Array(Type.String()),
+});
 //# sourceMappingURL=usage.js.map

package/dist/protocol/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../sources/protocol/usage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../sources/protocol/usage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@slopus/happy-agent-client",
-    "version": "0.0.99",
+    "version": "0.0.101",
     "description": "Typed client for the Happy agent HTTP API.",
     "license": "MIT",
     "repository": {