@slopus/happy-agent-client 0.0.99 → 0.0.100

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.100",
     "description": "Typed client for the Happy agent HTTP API.",
     "license": "MIT",
     "repository": {