npm - @yolk-sdk/agent - Versions diffs - 0.1.0-canary.57 → 0.1.0-canary.58 - Mend

@yolk-sdk/agent 0.1.0-canary.57 → 0.1.0-canary.58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/README.md +35 -1
package/dist/providers/anthropic/usage.d.mts +15 -0
package/dist/providers/anthropic/usage.d.mts.map +1 -0
package/dist/providers/anthropic/usage.mjs +73 -0
package/dist/providers/anthropic/usage.mjs.map +1 -0
package/dist/providers/openai/codex-usage.d.mts +15 -0
package/dist/providers/openai/codex-usage.d.mts.map +1 -0
package/dist/providers/openai/codex-usage.mjs +84 -0
package/dist/providers/openai/codex-usage.mjs.map +1 -0
package/dist/providers/subscription-usage-internal.d.mts +20 -0
package/dist/providers/subscription-usage-internal.d.mts.map +1 -0
package/dist/providers/subscription-usage-internal.mjs +52 -0
package/dist/providers/subscription-usage-internal.mjs.map +1 -0
package/dist/providers/subscription-usage.d.mts +49 -0
package/dist/providers/subscription-usage.d.mts.map +1 -0
package/dist/providers/subscription-usage.mjs +55 -0
package/dist/providers/subscription-usage.mjs.map +1 -0
package/dist/skillset/merge.d.mts +2 -2
package/dist/skillset/name.d.mts +2 -2
package/dist/skillset/name.d.mts.map +1 -1
package/package.json +16 -1
package/src/providers/anthropic/usage.ts +150 -0
package/src/providers/openai/codex-usage.ts +179 -0
package/src/providers/subscription-usage-internal.ts +105 -0
package/src/providers/subscription-usage.ts +88 -0

package/README.md CHANGED Viewed

@@ -10,7 +10,7 @@ Root export is intentionally tiny. Import feature APIs from explicit subpaths.
 pnpm add @yolk-sdk/agent@canary effect
 ```
-Add `react` if you use `@yolk-sdk/agent/react`.
+Add `react` if you use `@yolk-sdk/agent/react` or `@yolk-sdk/agent/voice/react`.
 Canary APIs are unstable. Keep all `@yolk-sdk/*` packages on the same version.
 Published package metadata requires Node.js 22+.
@@ -30,13 +30,16 @@ Published package metadata requires Node.js 22+.
 | `@yolk-sdk/agent/oauth`                               | Provider-neutral OAuth token and broker contracts              |
 | `@yolk-sdk/agent/providers/openai`                    | OpenAI/Codex OAuth and broker helpers                          |
 | `@yolk-sdk/agent/providers/openai/codex`              | OpenAI Codex request and auth helpers                          |
+| `@yolk-sdk/agent/providers/openai/codex-usage`        | Codex subscription-allowance snapshots                         |
 | `@yolk-sdk/agent/providers/openai/codex-provider`     | Codex LLM provider factory                                     |
 | `@yolk-sdk/agent/providers/openai/provider`           | OpenAI-compatible LLM provider factory                         |
 | `@yolk-sdk/agent/providers/openai/realtime`           | OpenAI Realtime session config and event codecs                |
 | `@yolk-sdk/agent/providers/openai/speech`             | OpenAI text-to-speech and transcription adapters               |
 | `@yolk-sdk/agent/providers/anthropic`                 | Anthropic/Claude OAuth and broker helpers                      |
 | `@yolk-sdk/agent/providers/anthropic/claude`          | Claude request and auth helpers                                |
+| `@yolk-sdk/agent/providers/anthropic/usage`           | Claude subscription-allowance snapshots                        |
 | `@yolk-sdk/agent/providers/anthropic/claude-provider` | Claude LLM provider factory                                    |
+| `@yolk-sdk/agent/providers/subscription-usage`        | Shared allowance snapshot and safe error schemas               |
 | `@yolk-sdk/agent/skillset`                            | Portable skill and slash-command parsing/catalogs              |
 | `@yolk-sdk/agent/voice`                               | Voice protocol, controller, tool handler, projection, speech   |
 | `@yolk-sdk/agent/voice/browser`                       | Browser WebRTC voice transport                                 |
@@ -180,6 +183,37 @@ policy and emits protocol-visible retry/error state:
 Raw provider response bodies stay out of protocol/UI. Hosts own durable persistence and display of
 typed retry/error state.
+## Subscription allowance snapshots
+The Claude and Codex usage adapters read best-effort consumer subscription allowance percentages and
+reset windows. Claude currently normalizes its aggregate five-hour and seven-day windows; Codex
+normalizes its primary and secondary rate-limit windows. Additional provider-specific buckets are
+ignored. These private provider endpoints may change without notice. Pass a fresh
+host-owned `OAuthAccessToken` and provide an Effect `HttpClient`:
+```ts
+import { Effect } from 'effect'
+import { FetchHttpClient } from 'effect/unstable/http'
+import { fetchOpenAiCodexSubscriptionUsage } from '@yolk-sdk/agent/providers/openai/codex-usage'
+const snapshot = await fetchOpenAiCodexSubscriptionUsage(hostOAuthAccessToken).pipe(
+  Effect.provide(FetchHttpClient.layer),
+  Effect.runPromise
+)
+```
+Use `fetchAnthropicClaudeSubscriptionUsage` from
+`@yolk-sdk/agent/providers/anthropic/usage` for Claude. Provider adapters return an immutable Effect
+`Chunk` of semantic window ids, percentages, and optional reset/duration fields; hosts own labels,
+polling, persistence, stale-data
+policy, alert thresholds, billing interpretation, and UI. Configure `requestTimeoutMs` at the
+server integration boundary. Endpoint origins stay fixed, and `FetchHttpClient.layer` is configured
+for manual redirects. A custom `HttpClient` must not follow redirects for these credential-bearing
+requests.
+Subscription allowance snapshots are separate from protocol `AgentUsage`, which accounts for tokens
+used by model requests and nested model work.
 ## Usage accounting
 Provider `LLMUsage` events are additive deltas. Adapters normalize vendor counters before emitting;

package/dist/providers/anthropic/usage.d.mts ADDED Viewed

@@ -0,0 +1,15 @@
+import { ProviderSubscriptionUsageError, ProviderSubscriptionUsageResponseError, ProviderSubscriptionUsageSnapshot } from "../subscription-usage.mjs";
+import { Effect } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import { OAuthAccessToken } from "@yolk-sdk/agent/oauth";
+//#region src/providers/anthropic/usage.d.ts
+declare const anthropicClaudeSubscriptionUsageUrl = "https://api.anthropic.com/api/oauth/usage";
+type AnthropicClaudeSubscriptionUsageOptions = {
+  readonly requestTimeoutMs?: number;
+};
+declare const parseAnthropicClaudeSubscriptionUsage: (value: unknown, fetchedAt: string) => Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageResponseError>;
+declare const fetchAnthropicClaudeSubscriptionUsage: (token: OAuthAccessToken, options?: AnthropicClaudeSubscriptionUsageOptions) => Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageError, HttpClient.HttpClient>;
+//#endregion
+export { AnthropicClaudeSubscriptionUsageOptions, anthropicClaudeSubscriptionUsageUrl, fetchAnthropicClaudeSubscriptionUsage, parseAnthropicClaudeSubscriptionUsage };
+//# sourceMappingURL=usage.d.mts.map

package/dist/providers/anthropic/usage.d.mts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"usage.d.mts","names":[],"sources":["../../../src/providers/anthropic/usage.ts"],"mappings":";;;;;;cAqBa,mCAAA;AAAA,KAED,uCAAA;EAAA,SACD,gBAAgB;AAAA;AAAA,cAoBd,qCAAA,GACX,KAAA,WACA,SAAA,aACC,MAAA,CAAO,MAAA,CAAO,iCAAA,EAAmC,sCAAA;AAAA,cAuDvC,qCAAA,GACX,KAAA,EAAO,gBAAA,EACP,OAAA,GAAS,uCAAA,KACR,MAAA,CAAO,MAAA,CACR,iCAAA,EACA,8BAAA,EACA,UAAA,CAAW,UAAA"}

package/dist/providers/anthropic/usage.mjs ADDED Viewed

@@ -0,0 +1,73 @@
+import { ProviderSubscriptionUsageConfigurationError, ProviderSubscriptionUsageResponseError, ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageWindow } from "../subscription-usage.mjs";
+import { canonicalSubscriptionUsageInstant, executeProviderSubscriptionUsageRequest, readProviderSubscriptionUsageJson, validProviderSubscriptionUsageTimeout, validSubscriptionUsagePercent } from "../subscription-usage-internal.mjs";
+import { anthropicClaudeAuthorizationHeaders, anthropicClaudeProviderId } from "./claude.mjs";
+import { Chunk, Clock, Effect } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as Schema from "effect/Schema";
+//#region src/providers/anthropic/usage.ts
+const anthropicClaudeSubscriptionUsageUrl = "https://api.anthropic.com/api/oauth/usage";
+const NullableNumber = Schema.NullOr(Schema.Number);
+const NullableString = Schema.NullOr(Schema.String);
+var AnthropicClaudeSubscriptionUsageWindowWire = class extends Schema.Class("AnthropicClaudeSubscriptionUsageWindowWire")({
+	utilization: Schema.optional(NullableNumber),
+	resets_at: Schema.optional(NullableString)
+}) {};
+var AnthropicClaudeSubscriptionUsageWire = class extends Schema.Class("AnthropicClaudeSubscriptionUsageWire")({
+	five_hour: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire)),
+	seven_day: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire))
+}) {};
+const parseAnthropicClaudeSubscriptionUsage = (value, fetchedAt) => {
+	const canonicalFetchedAt = canonicalSubscriptionUsageInstant(fetchedAt);
+	if (canonicalFetchedAt === void 0) return Effect.fail(ProviderSubscriptionUsageResponseError.make({
+		provider: anthropicClaudeProviderId,
+		category: "invalid_response"
+	}));
+	return Schema.decodeUnknownEffect(AnthropicClaudeSubscriptionUsageWire)(value).pipe(Effect.map((decoded) => {
+		const windows = [];
+		const append = (wire, id) => {
+			if (!validSubscriptionUsagePercent(wire?.utilization)) return;
+			const resetValue = wire.resets_at === null ? void 0 : wire.resets_at;
+			const resetsAt = resetValue === void 0 ? void 0 : canonicalSubscriptionUsageInstant(resetValue);
+			windows.push(ProviderSubscriptionUsageWindow.make({
+				id,
+				usedPercent: wire.utilization,
+				...resetsAt === void 0 ? {} : { resetsAt }
+			}));
+		};
+		append(decoded.five_hour, "five-hour");
+		append(decoded.seven_day, "seven-day");
+		return ProviderSubscriptionUsageSnapshot.make({
+			provider: anthropicClaudeProviderId,
+			fetchedAt: canonicalFetchedAt,
+			windows: Chunk.fromIterable(windows)
+		});
+	}), Effect.mapError(() => ProviderSubscriptionUsageResponseError.make({
+		provider: anthropicClaudeProviderId,
+		category: "invalid_response"
+	})), Effect.withSpan("AnthropicClaudeSubscriptionUsage.parse"));
+};
+const fetchAnthropicClaudeSubscriptionUsage = (token, options = {}) => Effect.gen(function* () {
+	if (token.provider !== "anthropic-claude") return yield* Effect.fail(ProviderSubscriptionUsageConfigurationError.make({
+		provider: anthropicClaudeProviderId,
+		reason: "provider_mismatch"
+	}));
+	const requestTimeoutMs = options.requestTimeoutMs ?? 1e4;
+	if (!validProviderSubscriptionUsageTimeout(requestTimeoutMs)) return yield* Effect.fail(ProviderSubscriptionUsageConfigurationError.make({
+		provider: anthropicClaudeProviderId,
+		reason: "invalid_request_timeout"
+	}));
+	return yield* parseAnthropicClaudeSubscriptionUsage(yield* readProviderSubscriptionUsageJson(anthropicClaudeProviderId, yield* executeProviderSubscriptionUsageRequest({
+		provider: anthropicClaudeProviderId,
+		client: yield* HttpClient.HttpClient,
+		request: HttpClientRequest.get(anthropicClaudeSubscriptionUsageUrl).pipe(HttpClientRequest.setHeaders({
+			accept: "application/json",
+			...anthropicClaudeAuthorizationHeaders(token),
+			"anthropic-beta": "oauth-2025-04-20"
+		})),
+		timeoutMs: requestTimeoutMs
+	})), new Date(yield* Clock.currentTimeMillis).toISOString());
+}).pipe(Effect.withSpan("AnthropicClaudeSubscriptionUsage.fetch"));
+//#endregion
+export { anthropicClaudeSubscriptionUsageUrl, fetchAnthropicClaudeSubscriptionUsage, parseAnthropicClaudeSubscriptionUsage };
+//# sourceMappingURL=usage.mjs.map

package/dist/providers/anthropic/usage.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"usage.mjs","names":[],"sources":["../../../src/providers/anthropic/usage.ts"],"sourcesContent":["import { Chunk, Clock, Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport { HttpClient, HttpClientRequest } from 'effect/unstable/http'\nimport type { OAuthAccessToken } from '@yolk-sdk/agent/oauth'\nimport { anthropicClaudeAuthorizationHeaders, anthropicClaudeProviderId } from './claude.ts'\nimport {\n canonicalSubscriptionUsageInstant,\n defaultProviderSubscriptionUsageTimeoutMs,\n executeProviderSubscriptionUsageRequest,\n readProviderSubscriptionUsageJson,\n validProviderSubscriptionUsageTimeout,\n validSubscriptionUsagePercent\n} from '../subscription-usage-internal.ts'\nimport {\n ProviderSubscriptionUsageConfigurationError,\n type ProviderSubscriptionUsageError,\n ProviderSubscriptionUsageResponseError,\n ProviderSubscriptionUsageSnapshot,\n ProviderSubscriptionUsageWindow\n} from '../subscription-usage.ts'\n\nexport const anthropicClaudeSubscriptionUsageUrl = 'https://api.anthropic.com/api/oauth/usage'\n\nexport type AnthropicClaudeSubscriptionUsageOptions = {\n readonly requestTimeoutMs?: number\n}\n\nconst NullableNumber = Schema.NullOr(Schema.Number)\nconst NullableString = Schema.NullOr(Schema.String)\n\nclass AnthropicClaudeSubscriptionUsageWindowWire extends Schema.Class<AnthropicClaudeSubscriptionUsageWindowWire>(\n 'AnthropicClaudeSubscriptionUsageWindowWire'\n)({\n utilization: Schema.optional(NullableNumber),\n resets_at: Schema.optional(NullableString)\n}) {}\n\nclass AnthropicClaudeSubscriptionUsageWire extends Schema.Class<AnthropicClaudeSubscriptionUsageWire>(\n 'AnthropicClaudeSubscriptionUsageWire'\n)({\n five_hour: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire)),\n seven_day: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire))\n}) {}\n\nexport const parseAnthropicClaudeSubscriptionUsage = (\n value: unknown,\n fetchedAt: string\n): Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageResponseError> => {\n const canonicalFetchedAt = canonicalSubscriptionUsageInstant(fetchedAt)\n\n if (canonicalFetchedAt === undefined) {\n return Effect.fail(\n ProviderSubscriptionUsageResponseError.make({\n provider: anthropicClaudeProviderId,\n category: 'invalid_response'\n })\n )\n }\n\n return Schema.decodeUnknownEffect(AnthropicClaudeSubscriptionUsageWire)(value).pipe(\n Effect.map(decoded => {\n const windows: Array<ProviderSubscriptionUsageWindow> = []\n const append = (\n wire: AnthropicClaudeSubscriptionUsageWindowWire | null | undefined,\n id: 'five-hour' | 'seven-day'\n ) => {\n if (!validSubscriptionUsagePercent(wire?.utilization)) {\n return\n }\n\n const resetValue = wire.resets_at === null ? undefined : wire.resets_at\n const resetsAt =\n resetValue === undefined ? undefined : canonicalSubscriptionUsageInstant(resetValue)\n\n windows.push(\n ProviderSubscriptionUsageWindow.make({\n id,\n usedPercent: wire.utilization,\n ...(resetsAt === undefined ? {} : { resetsAt })\n })\n )\n }\n\n append(decoded.five_hour, 'five-hour')\n append(decoded.seven_day, 'seven-day')\n\n return ProviderSubscriptionUsageSnapshot.make({\n provider: anthropicClaudeProviderId,\n fetchedAt: canonicalFetchedAt,\n windows: Chunk.fromIterable(windows)\n })\n }),\n Effect.mapError(() =>\n ProviderSubscriptionUsageResponseError.make({\n provider: anthropicClaudeProviderId,\n category: 'invalid_response'\n })\n ),\n Effect.withSpan('AnthropicClaudeSubscriptionUsage.parse')\n )\n}\n\nexport const fetchAnthropicClaudeSubscriptionUsage = (\n token: OAuthAccessToken,\n options: AnthropicClaudeSubscriptionUsageOptions = {}\n): Effect.Effect<\n ProviderSubscriptionUsageSnapshot,\n ProviderSubscriptionUsageError,\n HttpClient.HttpClient\n> =>\n Effect.gen(function* () {\n if (token.provider !== anthropicClaudeProviderId) {\n return yield* Effect.fail(\n ProviderSubscriptionUsageConfigurationError.make({\n provider: anthropicClaudeProviderId,\n reason: 'provider_mismatch'\n })\n )\n }\n\n const requestTimeoutMs = options.requestTimeoutMs ?? defaultProviderSubscriptionUsageTimeoutMs\n\n if (!validProviderSubscriptionUsageTimeout(requestTimeoutMs)) {\n return yield* Effect.fail(\n ProviderSubscriptionUsageConfigurationError.make({\n provider: anthropicClaudeProviderId,\n reason: 'invalid_request_timeout'\n })\n )\n }\n\n const client = yield* HttpClient.HttpClient\n const request = HttpClientRequest.get(anthropicClaudeSubscriptionUsageUrl).pipe(\n HttpClientRequest.setHeaders({\n accept: 'application/json',\n ...anthropicClaudeAuthorizationHeaders(token),\n 'anthropic-beta': 'oauth-2025-04-20'\n })\n )\n const response = yield* executeProviderSubscriptionUsageRequest({\n provider: anthropicClaudeProviderId,\n client,\n request,\n timeoutMs: requestTimeoutMs\n })\n const json = yield* readProviderSubscriptionUsageJson(anthropicClaudeProviderId, response)\n const fetchedAt = new Date(yield* Clock.currentTimeMillis).toISOString()\n\n return yield* parseAnthropicClaudeSubscriptionUsage(json, fetchedAt)\n }).pipe(Effect.withSpan('AnthropicClaudeSubscriptionUsage.fetch'))\n"],"mappings":";;;;;;;AAqBA,MAAa,sCAAsC;AAMnD,MAAM,iBAAiB,OAAO,OAAO,OAAO,MAAM;AAClD,MAAM,iBAAiB,OAAO,OAAO,OAAO,MAAM;AAElD,IAAM,6CAAN,cAAyD,OAAO,MAC9D,4CACF,EAAE;CACA,aAAa,OAAO,SAAS,cAAc;CAC3C,WAAW,OAAO,SAAS,cAAc;AAC3C,CAAC,EAAE,CAAC;AAEJ,IAAM,uCAAN,cAAmD,OAAO,MACxD,sCACF,EAAE;CACA,WAAW,OAAO,SAAS,OAAO,OAAO,0CAA0C,CAAC;CACpF,WAAW,OAAO,SAAS,OAAO,OAAO,0CAA0C,CAAC;AACtF,CAAC,EAAE,CAAC;AAEJ,MAAa,yCACX,OACA,cAC6F;CAC7F,MAAM,qBAAqB,kCAAkC,SAAS;CAEtE,IAAI,uBAAuB,KAAA,GACzB,OAAO,OAAO,KACZ,uCAAuC,KAAK;EAC1C,UAAU;EACV,UAAU;CACZ,CAAC,CACH;CAGF,OAAO,OAAO,oBAAoB,oCAAoC,EAAE,KAAK,EAAE,KAC7E,OAAO,KAAI,YAAW;EACpB,MAAM,UAAkD,CAAC;EACzD,MAAM,UACJ,MACA,OACG;GACH,IAAI,CAAC,8BAA8B,MAAM,WAAW,GAClD;GAGF,MAAM,aAAa,KAAK,cAAc,OAAO,KAAA,IAAY,KAAK;GAC9D,MAAM,WACJ,eAAe,KAAA,IAAY,KAAA,IAAY,kCAAkC,UAAU;GAErF,QAAQ,KACN,gCAAgC,KAAK;IACnC;IACA,aAAa,KAAK;IAClB,GAAI,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS;GAC/C,CAAC,CACH;EACF;EAEA,OAAO,QAAQ,WAAW,WAAW;EACrC,OAAO,QAAQ,WAAW,WAAW;EAErC,OAAO,kCAAkC,KAAK;GAC5C,UAAU;GACV,WAAW;GACX,SAAS,MAAM,aAAa,OAAO;EACrC,CAAC;CACH,CAAC,GACD,OAAO,eACL,uCAAuC,KAAK;EAC1C,UAAU;EACV,UAAU;CACZ,CAAC,CACH,GACA,OAAO,SAAS,wCAAwC,CAC1D;AACF;AAEA,MAAa,yCACX,OACA,UAAmD,CAAC,MAMpD,OAAO,IAAI,aAAa;CACtB,IAAI,MAAM,aAAA,oBACR,OAAO,OAAO,OAAO,KACnB,4CAA4C,KAAK;EAC/C,UAAU;EACV,QAAQ;CACV,CAAC,CACH;CAGF,MAAM,mBAAmB,QAAQ,oBAAA;CAEjC,IAAI,CAAC,sCAAsC,gBAAgB,GACzD,OAAO,OAAO,OAAO,KACnB,4CAA4C,KAAK;EAC/C,UAAU;EACV,QAAQ;CACV,CAAC,CACH;CAoBF,OAAO,OAAO,sCAAsC,OAHhC,kCAAkC,2BAA2B,OANzD,wCAAwC;EAC9D,UAAU;EACV,QAAA,OAVoB,WAAW;EAW/B,SAVc,kBAAkB,IAAI,mCAAmC,EAAE,KACzE,kBAAkB,WAAW;GAC3B,QAAQ;GACR,GAAG,oCAAoC,KAAK;GAC5C,kBAAkB;EACpB,CAAC,CAKK;EACN,WAAW;CACb,CAAC,CACwF,GACvE,IAAI,KAAK,OAAO,MAAM,iBAAiB,EAAE,YAEO,CAAC;AACrE,CAAC,EAAE,KAAK,OAAO,SAAS,wCAAwC,CAAC"}

package/dist/providers/openai/codex-usage.d.mts ADDED Viewed

@@ -0,0 +1,15 @@
+import { ProviderSubscriptionUsageError, ProviderSubscriptionUsageResponseError, ProviderSubscriptionUsageSnapshot } from "../subscription-usage.mjs";
+import { Effect } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import { OAuthAccessToken } from "@yolk-sdk/agent/oauth";
+//#region src/providers/openai/codex-usage.d.ts
+declare const openAiCodexSubscriptionUsageUrl = "https://chatgpt.com/backend-api/wham/usage";
+type OpenAiCodexSubscriptionUsageOptions = {
+  readonly requestTimeoutMs?: number;
+};
+declare const parseOpenAiCodexSubscriptionUsage: (value: unknown, fetchedAt: string) => Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageResponseError>;
+declare const fetchOpenAiCodexSubscriptionUsage: (token: OAuthAccessToken, options?: OpenAiCodexSubscriptionUsageOptions) => Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageError, HttpClient.HttpClient>;
+//#endregion
+export { OpenAiCodexSubscriptionUsageOptions, fetchOpenAiCodexSubscriptionUsage, openAiCodexSubscriptionUsageUrl, parseOpenAiCodexSubscriptionUsage };
+//# sourceMappingURL=codex-usage.d.mts.map

package/dist/providers/openai/codex-usage.d.mts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"codex-usage.d.mts","names":[],"sources":["../../../src/providers/openai/codex-usage.ts"],"mappings":";;;;;;cAsBa,+BAAA;AAAA,KAED,mCAAA;EAAA,SACD,gBAAgB;AAAA;AAAA,cA2Bd,iCAAA,GACX,KAAA,WACA,SAAA,aACC,MAAA,CAAO,MAAA,CAAO,iCAAA,EAAmC,sCAAA;AAAA,cAiEvC,iCAAA,GACX,KAAA,EAAO,gBAAA,EACP,OAAA,GAAS,mCAAA,KACR,MAAA,CAAO,MAAA,CACR,iCAAA,EACA,8BAAA,EACA,UAAA,CAAW,UAAA"}

package/dist/providers/openai/codex-usage.mjs ADDED Viewed

@@ -0,0 +1,84 @@
+import { ProviderSubscriptionUsageConfigurationError, ProviderSubscriptionUsageResponseError, ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageWindow } from "../subscription-usage.mjs";
+import { canonicalSubscriptionUsageInstant, executeProviderSubscriptionUsageRequest, positiveSubscriptionUsageNumber, readProviderSubscriptionUsageJson, validProviderSubscriptionUsageTimeout, validSubscriptionUsagePercent } from "../subscription-usage-internal.mjs";
+import { openAiCodexProviderId } from "./codex.mjs";
+import { Chunk, Clock, Effect } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as Schema from "effect/Schema";
+//#region src/providers/openai/codex-usage.ts
+const openAiCodexSubscriptionUsageUrl = "https://chatgpt.com/backend-api/wham/usage";
+const NullableNumber = Schema.NullOr(Schema.Number);
+var OpenAiCodexSubscriptionUsageWindowWire = class extends Schema.Class("OpenAiCodexSubscriptionUsageWindowWire")({
+	used_percent: Schema.optional(NullableNumber),
+	limit_window_seconds: Schema.optional(NullableNumber),
+	reset_after_seconds: Schema.optional(NullableNumber),
+	reset_at: Schema.optional(NullableNumber)
+}) {};
+var OpenAiCodexSubscriptionRateLimitWire = class extends Schema.Class("OpenAiCodexSubscriptionRateLimitWire")({
+	primary_window: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionUsageWindowWire)),
+	secondary_window: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionUsageWindowWire))
+}) {};
+var OpenAiCodexSubscriptionUsageWire = class extends Schema.Class("OpenAiCodexSubscriptionUsageWire")({ rate_limit: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionRateLimitWire)) }) {};
+const parseOpenAiCodexSubscriptionUsage = (value, fetchedAt) => {
+	const canonicalFetchedAt = canonicalSubscriptionUsageInstant(fetchedAt);
+	if (canonicalFetchedAt === void 0) return Effect.fail(ProviderSubscriptionUsageResponseError.make({
+		provider: openAiCodexProviderId,
+		category: "invalid_response"
+	}));
+	return Schema.decodeUnknownEffect(OpenAiCodexSubscriptionUsageWire)(value).pipe(Effect.map((decoded) => {
+		const windows = [];
+		const append = (wire, id) => {
+			if (!validSubscriptionUsagePercent(wire?.used_percent)) return;
+			const resetAt = wire.reset_at;
+			const resetsAt = resetAt === null || resetAt === void 0 ? void 0 : canonicalSubscriptionUsageInstant(resetAt);
+			const resetsAfterSeconds = positiveSubscriptionUsageNumber(wire.reset_after_seconds) ? wire.reset_after_seconds : void 0;
+			const windowDurationMinutes = positiveSubscriptionUsageNumber(wire.limit_window_seconds) ? wire.limit_window_seconds / 60 : void 0;
+			windows.push(ProviderSubscriptionUsageWindow.make({
+				id,
+				usedPercent: wire.used_percent,
+				...resetsAt === void 0 ? {} : { resetsAt },
+				...resetsAfterSeconds === void 0 ? {} : { resetsAfterSeconds },
+				...windowDurationMinutes === void 0 ? {} : { windowDurationMinutes }
+			}));
+		};
+		append(decoded.rate_limit?.primary_window, "primary");
+		append(decoded.rate_limit?.secondary_window, "secondary");
+		return ProviderSubscriptionUsageSnapshot.make({
+			provider: openAiCodexProviderId,
+			fetchedAt: canonicalFetchedAt,
+			windows: Chunk.fromIterable(windows)
+		});
+	}), Effect.mapError(() => ProviderSubscriptionUsageResponseError.make({
+		provider: openAiCodexProviderId,
+		category: "invalid_response"
+	})), Effect.withSpan("OpenAiCodexSubscriptionUsage.parse"));
+};
+const fetchOpenAiCodexSubscriptionUsage = (token, options = {}) => Effect.gen(function* () {
+	if (token.provider !== "openai-codex") return yield* Effect.fail(ProviderSubscriptionUsageConfigurationError.make({
+		provider: openAiCodexProviderId,
+		reason: "provider_mismatch"
+	}));
+	const accountId = token.accountId?.trim();
+	if (accountId === void 0 || accountId.length === 0) return yield* Effect.fail(ProviderSubscriptionUsageConfigurationError.make({
+		provider: openAiCodexProviderId,
+		reason: "missing_account_id"
+	}));
+	const requestTimeoutMs = options.requestTimeoutMs ?? 1e4;
+	if (!validProviderSubscriptionUsageTimeout(requestTimeoutMs)) return yield* Effect.fail(ProviderSubscriptionUsageConfigurationError.make({
+		provider: openAiCodexProviderId,
+		reason: "invalid_request_timeout"
+	}));
+	return yield* parseOpenAiCodexSubscriptionUsage(yield* readProviderSubscriptionUsageJson(openAiCodexProviderId, yield* executeProviderSubscriptionUsageRequest({
+		provider: openAiCodexProviderId,
+		client: yield* HttpClient.HttpClient,
+		request: HttpClientRequest.get(openAiCodexSubscriptionUsageUrl).pipe(HttpClientRequest.setHeaders({
+			accept: "application/json",
+			authorization: `Bearer ${token.accessToken}`,
+			"chatgpt-account-id": accountId
+		})),
+		timeoutMs: requestTimeoutMs
+	})), new Date(yield* Clock.currentTimeMillis).toISOString());
+}).pipe(Effect.withSpan("OpenAiCodexSubscriptionUsage.fetch"));
+//#endregion
+export { fetchOpenAiCodexSubscriptionUsage, openAiCodexSubscriptionUsageUrl, parseOpenAiCodexSubscriptionUsage };
+//# sourceMappingURL=codex-usage.mjs.map

package/dist/providers/openai/codex-usage.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"codex-usage.mjs","names":[],"sources":["../../../src/providers/openai/codex-usage.ts"],"sourcesContent":["import { Chunk, Clock, Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport { HttpClient, HttpClientRequest } from 'effect/unstable/http'\nimport type { OAuthAccessToken } from '@yolk-sdk/agent/oauth'\nimport { openAiCodexProviderId } from './codex.ts'\nimport {\n canonicalSubscriptionUsageInstant,\n defaultProviderSubscriptionUsageTimeoutMs,\n executeProviderSubscriptionUsageRequest,\n positiveSubscriptionUsageNumber,\n readProviderSubscriptionUsageJson,\n validProviderSubscriptionUsageTimeout,\n validSubscriptionUsagePercent\n} from '../subscription-usage-internal.ts'\nimport {\n ProviderSubscriptionUsageConfigurationError,\n type ProviderSubscriptionUsageError,\n ProviderSubscriptionUsageResponseError,\n ProviderSubscriptionUsageSnapshot,\n ProviderSubscriptionUsageWindow\n} from '../subscription-usage.ts'\n\nexport const openAiCodexSubscriptionUsageUrl = 'https://chatgpt.com/backend-api/wham/usage'\n\nexport type OpenAiCodexSubscriptionUsageOptions = {\n readonly requestTimeoutMs?: number\n}\n\nconst NullableNumber = Schema.NullOr(Schema.Number)\n\nclass OpenAiCodexSubscriptionUsageWindowWire extends Schema.Class<OpenAiCodexSubscriptionUsageWindowWire>(\n 'OpenAiCodexSubscriptionUsageWindowWire'\n)({\n used_percent: Schema.optional(NullableNumber),\n limit_window_seconds: Schema.optional(NullableNumber),\n reset_after_seconds: Schema.optional(NullableNumber),\n reset_at: Schema.optional(NullableNumber)\n}) {}\n\nclass OpenAiCodexSubscriptionRateLimitWire extends Schema.Class<OpenAiCodexSubscriptionRateLimitWire>(\n 'OpenAiCodexSubscriptionRateLimitWire'\n)({\n primary_window: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionUsageWindowWire)),\n secondary_window: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionUsageWindowWire))\n}) {}\n\nclass OpenAiCodexSubscriptionUsageWire extends Schema.Class<OpenAiCodexSubscriptionUsageWire>(\n 'OpenAiCodexSubscriptionUsageWire'\n)({\n rate_limit: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionRateLimitWire))\n}) {}\n\nexport const parseOpenAiCodexSubscriptionUsage = (\n value: unknown,\n fetchedAt: string\n): Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageResponseError> => {\n const canonicalFetchedAt = canonicalSubscriptionUsageInstant(fetchedAt)\n\n if (canonicalFetchedAt === undefined) {\n return Effect.fail(\n ProviderSubscriptionUsageResponseError.make({\n provider: openAiCodexProviderId,\n category: 'invalid_response'\n })\n )\n }\n\n return Schema.decodeUnknownEffect(OpenAiCodexSubscriptionUsageWire)(value).pipe(\n Effect.map(decoded => {\n const windows: Array<ProviderSubscriptionUsageWindow> = []\n const append = (\n wire: OpenAiCodexSubscriptionUsageWindowWire | null | undefined,\n id: 'primary' | 'secondary'\n ) => {\n if (!validSubscriptionUsagePercent(wire?.used_percent)) {\n return\n }\n\n const resetAt = wire.reset_at\n const resetsAt =\n resetAt === null || resetAt === undefined\n ? undefined\n : canonicalSubscriptionUsageInstant(resetAt)\n const resetsAfterSeconds = positiveSubscriptionUsageNumber(wire.reset_after_seconds)\n ? wire.reset_after_seconds\n : undefined\n const windowDurationMinutes = positiveSubscriptionUsageNumber(wire.limit_window_seconds)\n ? wire.limit_window_seconds / 60\n : undefined\n\n windows.push(\n ProviderSubscriptionUsageWindow.make({\n id,\n usedPercent: wire.used_percent,\n ...(resetsAt === undefined ? {} : { resetsAt }),\n ...(resetsAfterSeconds === undefined ? {} : { resetsAfterSeconds }),\n ...(windowDurationMinutes === undefined ? {} : { windowDurationMinutes })\n })\n )\n }\n\n append(decoded.rate_limit?.primary_window, 'primary')\n append(decoded.rate_limit?.secondary_window, 'secondary')\n\n return ProviderSubscriptionUsageSnapshot.make({\n provider: openAiCodexProviderId,\n fetchedAt: canonicalFetchedAt,\n windows: Chunk.fromIterable(windows)\n })\n }),\n Effect.mapError(() =>\n ProviderSubscriptionUsageResponseError.make({\n provider: openAiCodexProviderId,\n category: 'invalid_response'\n })\n ),\n Effect.withSpan('OpenAiCodexSubscriptionUsage.parse')\n )\n}\n\nexport const fetchOpenAiCodexSubscriptionUsage = (\n token: OAuthAccessToken,\n options: OpenAiCodexSubscriptionUsageOptions = {}\n): Effect.Effect<\n ProviderSubscriptionUsageSnapshot,\n ProviderSubscriptionUsageError,\n HttpClient.HttpClient\n> =>\n Effect.gen(function* () {\n if (token.provider !== openAiCodexProviderId) {\n return yield* Effect.fail(\n ProviderSubscriptionUsageConfigurationError.make({\n provider: openAiCodexProviderId,\n reason: 'provider_mismatch'\n })\n )\n }\n\n const accountId = token.accountId?.trim()\n\n if (accountId === undefined || accountId.length === 0) {\n return yield* Effect.fail(\n ProviderSubscriptionUsageConfigurationError.make({\n provider: openAiCodexProviderId,\n reason: 'missing_account_id'\n })\n )\n }\n\n const requestTimeoutMs = options.requestTimeoutMs ?? defaultProviderSubscriptionUsageTimeoutMs\n\n if (!validProviderSubscriptionUsageTimeout(requestTimeoutMs)) {\n return yield* Effect.fail(\n ProviderSubscriptionUsageConfigurationError.make({\n provider: openAiCodexProviderId,\n reason: 'invalid_request_timeout'\n })\n )\n }\n\n const client = yield* HttpClient.HttpClient\n const request = HttpClientRequest.get(openAiCodexSubscriptionUsageUrl).pipe(\n HttpClientRequest.setHeaders({\n accept: 'application/json',\n authorization: `Bearer ${token.accessToken}`,\n 'chatgpt-account-id': accountId\n })\n )\n const response = yield* executeProviderSubscriptionUsageRequest({\n provider: openAiCodexProviderId,\n client,\n request,\n timeoutMs: requestTimeoutMs\n })\n const json = yield* readProviderSubscriptionUsageJson(openAiCodexProviderId, response)\n const fetchedAt = new Date(yield* Clock.currentTimeMillis).toISOString()\n\n return yield* parseOpenAiCodexSubscriptionUsage(json, fetchedAt)\n }).pipe(Effect.withSpan('OpenAiCodexSubscriptionUsage.fetch'))\n"],"mappings":";;;;;;;AAsBA,MAAa,kCAAkC;AAM/C,MAAM,iBAAiB,OAAO,OAAO,OAAO,MAAM;AAElD,IAAM,yCAAN,cAAqD,OAAO,MAC1D,wCACF,EAAE;CACA,cAAc,OAAO,SAAS,cAAc;CAC5C,sBAAsB,OAAO,SAAS,cAAc;CACpD,qBAAqB,OAAO,SAAS,cAAc;CACnD,UAAU,OAAO,SAAS,cAAc;AAC1C,CAAC,EAAE,CAAC;AAEJ,IAAM,uCAAN,cAAmD,OAAO,MACxD,sCACF,EAAE;CACA,gBAAgB,OAAO,SAAS,OAAO,OAAO,sCAAsC,CAAC;CACrF,kBAAkB,OAAO,SAAS,OAAO,OAAO,sCAAsC,CAAC;AACzF,CAAC,EAAE,CAAC;AAEJ,IAAM,mCAAN,cAA+C,OAAO,MACpD,kCACF,EAAE,EACA,YAAY,OAAO,SAAS,OAAO,OAAO,oCAAoC,CAAC,EACjF,CAAC,EAAE,CAAC;AAEJ,MAAa,qCACX,OACA,cAC6F;CAC7F,MAAM,qBAAqB,kCAAkC,SAAS;CAEtE,IAAI,uBAAuB,KAAA,GACzB,OAAO,OAAO,KACZ,uCAAuC,KAAK;EAC1C,UAAU;EACV,UAAU;CACZ,CAAC,CACH;CAGF,OAAO,OAAO,oBAAoB,gCAAgC,EAAE,KAAK,EAAE,KACzE,OAAO,KAAI,YAAW;EACpB,MAAM,UAAkD,CAAC;EACzD,MAAM,UACJ,MACA,OACG;GACH,IAAI,CAAC,8BAA8B,MAAM,YAAY,GACnD;GAGF,MAAM,UAAU,KAAK;GACrB,MAAM,WACJ,YAAY,QAAQ,YAAY,KAAA,IAC5B,KAAA,IACA,kCAAkC,OAAO;GAC/C,MAAM,qBAAqB,gCAAgC,KAAK,mBAAmB,IAC/E,KAAK,sBACL,KAAA;GACJ,MAAM,wBAAwB,gCAAgC,KAAK,oBAAoB,IACnF,KAAK,uBAAuB,KAC5B,KAAA;GAEJ,QAAQ,KACN,gCAAgC,KAAK;IACnC;IACA,aAAa,KAAK;IAClB,GAAI,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS;IAC7C,GAAI,uBAAuB,KAAA,IAAY,CAAC,IAAI,EAAE,mBAAmB;IACjE,GAAI,0BAA0B,KAAA,IAAY,CAAC,IAAI,EAAE,sBAAsB;GACzE,CAAC,CACH;EACF;EAEA,OAAO,QAAQ,YAAY,gBAAgB,SAAS;EACpD,OAAO,QAAQ,YAAY,kBAAkB,WAAW;EAExD,OAAO,kCAAkC,KAAK;GAC5C,UAAU;GACV,WAAW;GACX,SAAS,MAAM,aAAa,OAAO;EACrC,CAAC;CACH,CAAC,GACD,OAAO,eACL,uCAAuC,KAAK;EAC1C,UAAU;EACV,UAAU;CACZ,CAAC,CACH,GACA,OAAO,SAAS,oCAAoC,CACtD;AACF;AAEA,MAAa,qCACX,OACA,UAA+C,CAAC,MAMhD,OAAO,IAAI,aAAa;CACtB,IAAI,MAAM,aAAA,gBACR,OAAO,OAAO,OAAO,KACnB,4CAA4C,KAAK;EAC/C,UAAU;EACV,QAAQ;CACV,CAAC,CACH;CAGF,MAAM,YAAY,MAAM,WAAW,KAAK;CAExC,IAAI,cAAc,KAAA,KAAa,UAAU,WAAW,GAClD,OAAO,OAAO,OAAO,KACnB,4CAA4C,KAAK;EAC/C,UAAU;EACV,QAAQ;CACV,CAAC,CACH;CAGF,MAAM,mBAAmB,QAAQ,oBAAA;CAEjC,IAAI,CAAC,sCAAsC,gBAAgB,GACzD,OAAO,OAAO,OAAO,KACnB,4CAA4C,KAAK;EAC/C,UAAU;EACV,QAAQ;CACV,CAAC,CACH;CAoBF,OAAO,OAAO,kCAAkC,OAH5B,kCAAkC,uBAAuB,OANrD,wCAAwC;EAC9D,UAAU;EACV,QAAA,OAVoB,WAAW;EAW/B,SAVc,kBAAkB,IAAI,+BAA+B,EAAE,KACrE,kBAAkB,WAAW;GAC3B,QAAQ;GACR,eAAe,UAAU,MAAM;GAC/B,sBAAsB;EACxB,CAAC,CAKK;EACN,WAAW;CACb,CAAC,CACoF,GACnE,IAAI,KAAK,OAAO,MAAM,iBAAiB,EAAE,YAEG,CAAC;AACjE,CAAC,EAAE,KAAK,OAAO,SAAS,oCAAoC,CAAC"}

package/dist/providers/subscription-usage-internal.d.mts ADDED Viewed

@@ -0,0 +1,20 @@
+import { ProviderSubscriptionUsageError, ProviderSubscriptionUsageResponseError } from "./subscription-usage.mjs";
+import { Effect } from "effect";
+import { HttpClient, HttpClientRequest, HttpClientResponse } from "effect/unstable/http";
+//#region src/providers/subscription-usage-internal.d.ts
+declare const defaultProviderSubscriptionUsageTimeoutMs = 10000;
+declare const canonicalSubscriptionUsageInstant: (value: string | number) => string | undefined;
+declare const validSubscriptionUsagePercent: (value: number | null | undefined) => value is number;
+declare const positiveSubscriptionUsageNumber: (value: number | null | undefined) => value is number;
+declare const validProviderSubscriptionUsageTimeout: (value: number) => boolean;
+declare const executeProviderSubscriptionUsageRequest: (input: {
+  readonly provider: string;
+  readonly client: HttpClient.HttpClient;
+  readonly request: HttpClientRequest.HttpClientRequest;
+  readonly timeoutMs: number;
+}) => Effect.Effect<HttpClientResponse.HttpClientResponse, ProviderSubscriptionUsageError, never>;
+declare const readProviderSubscriptionUsageJson: (provider: string, response: HttpClientResponse.HttpClientResponse) => Effect.Effect<unknown, ProviderSubscriptionUsageResponseError, never>;
+//#endregion
+export { canonicalSubscriptionUsageInstant, defaultProviderSubscriptionUsageTimeoutMs, executeProviderSubscriptionUsageRequest, positiveSubscriptionUsageNumber, readProviderSubscriptionUsageJson, validProviderSubscriptionUsageTimeout, validSubscriptionUsagePercent };
+//# sourceMappingURL=subscription-usage-internal.d.mts.map

package/dist/providers/subscription-usage-internal.d.mts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"subscription-usage-internal.d.mts","names":[],"sources":["../../src/providers/subscription-usage-internal.ts"],"mappings":";;;;;cAiBa,yCAAA;AAAA,cAEA,iCAAA,GAAqC,KAAsB;AAAA,cAM3D,6BAAA,GAAiC,KAAA,gCAAmC,KAAK;AAAA,cAGzE,+BAAA,GACX,KAAA,gCACC,KAAK;AAAA,cAEK,qCAAA,GAAyC,KAAa;AAAA,cAetD,uCAAA,GAA2C,KAAA;EAAA,SAC7C,QAAA;EAAA,SACA,MAAA,EAAQ,UAAA,CAAW,UAAA;EAAA,SACnB,OAAA,EAAS,iBAAA,CAAkB,iBAAA;EAAA,SAC3B,SAAA;AAAA,MACV,MAAA,CAAA,MAAA,CAAA,kBAAA,CAAA,kBAAA,EAAA,8BAAA;AAAA,cAuCY,iCAAA,GACX,QAAA,UACA,QAAA,EAAU,kBAAA,CAAmB,kBAAA,KAAkB,MAAA,CAAA,MAAA,UAAA,sCAAA"}

package/dist/providers/subscription-usage-internal.mjs ADDED Viewed

@@ -0,0 +1,52 @@
+import { retryAfterMsFromHeaders } from "./provider-error.mjs";
+import { ProviderSubscriptionUsageAuthError, ProviderSubscriptionUsageRateLimitError, ProviderSubscriptionUsageRequestError, ProviderSubscriptionUsageResponseError } from "./subscription-usage.mjs";
+import { Duration, Effect } from "effect";
+import { FetchHttpClient, HttpClientResponse } from "effect/unstable/http";
+import * as Schema from "effect/Schema";
+//#region src/providers/subscription-usage-internal.ts
+const defaultProviderSubscriptionUsageTimeoutMs = 1e4;
+const canonicalSubscriptionUsageInstant = (value) => {
+	const date = new Date(typeof value === "number" ? value * 1e3 : value);
+	return Number.isFinite(date.getTime()) ? date.toISOString() : void 0;
+};
+const validSubscriptionUsagePercent = (value) => value !== null && value !== void 0 && Number.isFinite(value) && value >= 0 && value <= 100;
+const positiveSubscriptionUsageNumber = (value) => value !== null && value !== void 0 && Number.isFinite(value) && value > 0;
+const validProviderSubscriptionUsageTimeout = (value) => Number.isFinite(value) && value > 0;
+const responseError = (provider, status) => {
+	if (status === 401 || status === 403) return ProviderSubscriptionUsageAuthError.make({
+		provider,
+		status
+	});
+	return ProviderSubscriptionUsageResponseError.make({
+		provider,
+		category: status >= 300 && status < 400 ? "redirect" : "http",
+		status
+	});
+};
+const executeProviderSubscriptionUsageRequest = (input) => Effect.gen(function* () {
+	const response = yield* input.client.execute(input.request).pipe(Effect.provideService(FetchHttpClient.RequestInit, { redirect: "manual" }), Effect.withTracerEnabled(false), Effect.mapError(() => ProviderSubscriptionUsageRequestError.make({
+		provider: input.provider,
+		category: "network"
+	})), Effect.timeoutOrElse({
+		duration: Duration.millis(input.timeoutMs),
+		orElse: () => Effect.fail(ProviderSubscriptionUsageRequestError.make({
+			provider: input.provider,
+			category: "timeout"
+		}))
+	}));
+	if (response.status === 429) return yield* Effect.fail(ProviderSubscriptionUsageRateLimitError.make({
+		provider: input.provider,
+		retryAfterMs: retryAfterMsFromHeaders(response.headers)
+	}));
+	if (response.status < 200 || response.status >= 300) return yield* Effect.fail(responseError(input.provider, response.status));
+	return response;
+});
+const readProviderSubscriptionUsageJson = (provider, response) => HttpClientResponse.schemaBodyJson(Schema.Unknown)(response).pipe(Effect.withTracerEnabled(false), Effect.mapError(() => ProviderSubscriptionUsageResponseError.make({
+	provider,
+	category: "invalid_response",
+	status: response.status
+})));
+//#endregion
+export { canonicalSubscriptionUsageInstant, defaultProviderSubscriptionUsageTimeoutMs, executeProviderSubscriptionUsageRequest, positiveSubscriptionUsageNumber, readProviderSubscriptionUsageJson, validProviderSubscriptionUsageTimeout, validSubscriptionUsagePercent };
+//# sourceMappingURL=subscription-usage-internal.mjs.map

package/dist/providers/subscription-usage-internal.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"subscription-usage-internal.mjs","names":[],"sources":["../../src/providers/subscription-usage-internal.ts"],"sourcesContent":["import { Duration, Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport {\n FetchHttpClient,\n HttpClientResponse,\n type HttpClient,\n type HttpClientRequest\n} from 'effect/unstable/http'\nimport { retryAfterMsFromHeaders } from './provider-error.ts'\nimport {\n ProviderSubscriptionUsageAuthError,\n type ProviderSubscriptionUsageError,\n ProviderSubscriptionUsageRateLimitError,\n ProviderSubscriptionUsageRequestError,\n ProviderSubscriptionUsageResponseError\n} from './subscription-usage.ts'\n\nexport const defaultProviderSubscriptionUsageTimeoutMs = 10_000\n\nexport const canonicalSubscriptionUsageInstant = (value: string | number): string | undefined => {\n const date = new Date(typeof value === 'number' ? value * 1000 : value)\n\n return Number.isFinite(date.getTime()) ? date.toISOString() : undefined\n}\n\nexport const validSubscriptionUsagePercent = (value: number | null | undefined): value is number =>\n value !== null && value !== undefined && Number.isFinite(value) && value >= 0 && value <= 100\n\nexport const positiveSubscriptionUsageNumber = (\n value: number | null | undefined\n): value is number => value !== null && value !== undefined && Number.isFinite(value) && value > 0\n\nexport const validProviderSubscriptionUsageTimeout = (value: number) =>\n Number.isFinite(value) && value > 0\n\nconst responseError = (provider: string, status: number): ProviderSubscriptionUsageError => {\n if (status === 401 || status === 403) {\n return ProviderSubscriptionUsageAuthError.make({ provider, status })\n }\n\n return ProviderSubscriptionUsageResponseError.make({\n provider,\n category: status >= 300 && status < 400 ? 'redirect' : 'http',\n status\n })\n}\n\nexport const executeProviderSubscriptionUsageRequest = (input: {\n readonly provider: string\n readonly client: HttpClient.HttpClient\n readonly request: HttpClientRequest.HttpClientRequest\n readonly timeoutMs: number\n}) =>\n Effect.gen(function* () {\n const response = yield* input.client.execute(input.request).pipe(\n Effect.provideService(FetchHttpClient.RequestInit, { redirect: 'manual' }),\n Effect.withTracerEnabled(false),\n Effect.mapError(() =>\n ProviderSubscriptionUsageRequestError.make({\n provider: input.provider,\n category: 'network'\n })\n ),\n Effect.timeoutOrElse({\n duration: Duration.millis(input.timeoutMs),\n orElse: () =>\n Effect.fail(\n ProviderSubscriptionUsageRequestError.make({\n provider: input.provider,\n category: 'timeout'\n })\n )\n })\n )\n\n if (response.status === 429) {\n return yield* Effect.fail(\n ProviderSubscriptionUsageRateLimitError.make({\n provider: input.provider,\n retryAfterMs: retryAfterMsFromHeaders(response.headers)\n })\n )\n }\n\n if (response.status < 200 || response.status >= 300) {\n return yield* Effect.fail(responseError(input.provider, response.status))\n }\n\n return response\n })\n\nexport const readProviderSubscriptionUsageJson = (\n provider: string,\n response: HttpClientResponse.HttpClientResponse\n) =>\n HttpClientResponse.schemaBodyJson(Schema.Unknown)(response).pipe(\n Effect.withTracerEnabled(false),\n Effect.mapError(() =>\n ProviderSubscriptionUsageResponseError.make({\n provider,\n category: 'invalid_response',\n status: response.status\n })\n )\n )\n"],"mappings":";;;;;;AAiBA,MAAa,4CAA4C;AAEzD,MAAa,qCAAqC,UAA+C;CAC/F,MAAM,OAAO,IAAI,KAAK,OAAO,UAAU,WAAW,QAAQ,MAAO,KAAK;CAEtE,OAAO,OAAO,SAAS,KAAK,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,KAAA;AAChE;AAEA,MAAa,iCAAiC,UAC5C,UAAU,QAAQ,UAAU,KAAA,KAAa,OAAO,SAAS,KAAK,KAAK,SAAS,KAAK,SAAS;AAE5F,MAAa,mCACX,UACoB,UAAU,QAAQ,UAAU,KAAA,KAAa,OAAO,SAAS,KAAK,KAAK,QAAQ;AAEjG,MAAa,yCAAyC,UACpD,OAAO,SAAS,KAAK,KAAK,QAAQ;AAEpC,MAAM,iBAAiB,UAAkB,WAAmD;CAC1F,IAAI,WAAW,OAAO,WAAW,KAC/B,OAAO,mCAAmC,KAAK;EAAE;EAAU;CAAO,CAAC;CAGrE,OAAO,uCAAuC,KAAK;EACjD;EACA,UAAU,UAAU,OAAO,SAAS,MAAM,aAAa;EACvD;CACF,CAAC;AACH;AAEA,MAAa,2CAA2C,UAMtD,OAAO,IAAI,aAAa;CACtB,MAAM,WAAW,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO,EAAE,KAC1D,OAAO,eAAe,gBAAgB,aAAa,EAAE,UAAU,SAAS,CAAC,GACzE,OAAO,kBAAkB,KAAK,GAC9B,OAAO,eACL,sCAAsC,KAAK;EACzC,UAAU,MAAM;EAChB,UAAU;CACZ,CAAC,CACH,GACA,OAAO,cAAc;EACnB,UAAU,SAAS,OAAO,MAAM,SAAS;EACzC,cACE,OAAO,KACL,sCAAsC,KAAK;GACzC,UAAU,MAAM;GAChB,UAAU;EACZ,CAAC,CACH;CACJ,CAAC,CACH;CAEA,IAAI,SAAS,WAAW,KACtB,OAAO,OAAO,OAAO,KACnB,wCAAwC,KAAK;EAC3C,UAAU,MAAM;EAChB,cAAc,wBAAwB,SAAS,OAAO;CACxD,CAAC,CACH;CAGF,IAAI,SAAS,SAAS,OAAO,SAAS,UAAU,KAC9C,OAAO,OAAO,OAAO,KAAK,cAAc,MAAM,UAAU,SAAS,MAAM,CAAC;CAG1E,OAAO;AACT,CAAC;AAEH,MAAa,qCACX,UACA,aAEA,mBAAmB,eAAe,OAAO,OAAO,EAAE,QAAQ,EAAE,KAC1D,OAAO,kBAAkB,KAAK,GAC9B,OAAO,eACL,uCAAuC,KAAK;CAC1C;CACA,UAAU;CACV,QAAQ,SAAS;AACnB,CAAC,CACH,CACF"}

package/dist/providers/subscription-usage.d.mts ADDED Viewed

@@ -0,0 +1,49 @@
+import * as Schema from "effect/Schema";
+//#region src/providers/subscription-usage.d.ts
+declare const ProviderSubscriptionUsageInstant: Schema.Trimmed;
+declare const ProviderSubscriptionUsagePercent: Schema.Number;
+declare const ProviderSubscriptionUsageWindow_base: Schema.Class<ProviderSubscriptionUsageWindow, Schema.Struct<{
+  readonly id: Schema.Trimmed;
+  readonly usedPercent: Schema.Number;
+  readonly resetsAt: Schema.optional<Schema.Trimmed>;
+  readonly resetsAfterSeconds: Schema.optional<Schema.Number>;
+  readonly windowDurationMinutes: Schema.optional<Schema.Number>;
+}>, {}>;
+declare class ProviderSubscriptionUsageWindow extends ProviderSubscriptionUsageWindow_base {}
+declare const ProviderSubscriptionUsageSnapshot_base: Schema.Class<ProviderSubscriptionUsageSnapshot, Schema.Struct<{
+  readonly provider: Schema.Trimmed;
+  readonly fetchedAt: Schema.Trimmed;
+  readonly windows: Schema.Chunk<typeof ProviderSubscriptionUsageWindow>;
+}>, {}>;
+declare class ProviderSubscriptionUsageSnapshot extends ProviderSubscriptionUsageSnapshot_base {}
+declare const ProviderSubscriptionUsageRequestError_base: Schema.Class<ProviderSubscriptionUsageRequestError, Schema.TaggedStruct<"ProviderSubscriptionUsageRequestError", {
+  readonly provider: Schema.String;
+  readonly category: Schema.Literals<readonly ["timeout", "network"]>;
+}>, import("effect/Cause").YieldableError>;
+declare class ProviderSubscriptionUsageRequestError extends ProviderSubscriptionUsageRequestError_base {}
+declare const ProviderSubscriptionUsageResponseError_base: Schema.Class<ProviderSubscriptionUsageResponseError, Schema.TaggedStruct<"ProviderSubscriptionUsageResponseError", {
+  readonly provider: Schema.String;
+  readonly category: Schema.Literals<readonly ["http", "invalid_response", "redirect"]>;
+  readonly status: Schema.optional<Schema.Number>;
+}>, import("effect/Cause").YieldableError>;
+declare class ProviderSubscriptionUsageResponseError extends ProviderSubscriptionUsageResponseError_base {}
+declare const ProviderSubscriptionUsageAuthError_base: Schema.Class<ProviderSubscriptionUsageAuthError, Schema.TaggedStruct<"ProviderSubscriptionUsageAuthError", {
+  readonly provider: Schema.String;
+  readonly status: Schema.Number;
+}>, import("effect/Cause").YieldableError>;
+declare class ProviderSubscriptionUsageAuthError extends ProviderSubscriptionUsageAuthError_base {}
+declare const ProviderSubscriptionUsageRateLimitError_base: Schema.Class<ProviderSubscriptionUsageRateLimitError, Schema.TaggedStruct<"ProviderSubscriptionUsageRateLimitError", {
+  readonly provider: Schema.String;
+  readonly retryAfterMs: Schema.optional<Schema.Number>;
+}>, import("effect/Cause").YieldableError>;
+declare class ProviderSubscriptionUsageRateLimitError extends ProviderSubscriptionUsageRateLimitError_base {}
+declare const ProviderSubscriptionUsageConfigurationError_base: Schema.Class<ProviderSubscriptionUsageConfigurationError, Schema.TaggedStruct<"ProviderSubscriptionUsageConfigurationError", {
+  readonly provider: Schema.String;
+  readonly reason: Schema.Literals<readonly ["invalid_request_timeout", "missing_account_id", "provider_mismatch"]>;
+}>, import("effect/Cause").YieldableError>;
+declare class ProviderSubscriptionUsageConfigurationError extends ProviderSubscriptionUsageConfigurationError_base {}
+type ProviderSubscriptionUsageError = ProviderSubscriptionUsageRequestError | ProviderSubscriptionUsageResponseError | ProviderSubscriptionUsageAuthError | ProviderSubscriptionUsageRateLimitError | ProviderSubscriptionUsageConfigurationError;
+//#endregion
+export { ProviderSubscriptionUsageAuthError, ProviderSubscriptionUsageConfigurationError, ProviderSubscriptionUsageError, ProviderSubscriptionUsageInstant, ProviderSubscriptionUsagePercent, ProviderSubscriptionUsageRateLimitError, ProviderSubscriptionUsageRequestError, ProviderSubscriptionUsageResponseError, ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageWindow };
+//# sourceMappingURL=subscription-usage.d.mts.map

package/dist/providers/subscription-usage.d.mts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"subscription-usage.d.mts","names":[],"sources":["../../src/providers/subscription-usage.ts"],"mappings":";;;cAUa,gCAAA,EAAgC,MAAA,CAAA,OAM5C;AAAA,cAEY,gCAAA,EAAgC,MAAA,CAAA,MAG5C;AAAA,cAAA,oCAAA;;;;;;;cAEY,+BAAA,SAAwC,oCAQnD;AAAA,cAAG,sCAAA;;;;;cAEQ,iCAAA,SAA0C,sCAMrD;AAAA,cAAG,0CAAA;;;;cAEQ,qCAAA,SAA8C,0CAM1D;AAAA,cAAG,2CAAA;;;;;cAES,sCAAA,SAA+C,2CAO3D;AAAA,cAAG,uCAAA;;;;cAES,kCAAA,SAA2C,uCAMvD;AAAA,cAAG,4CAAA;;;;cAES,uCAAA,SAAgD,4CAM5D;AAAA,cAAG,gDAAA;;;;cAES,2CAAA,SAAoD,gDAMhE;AAAA,KAEW,8BAAA,GACR,qCAAA,GACA,sCAAA,GACA,kCAAA,GACA,uCAAA,GACA,2CAAA"}

package/dist/providers/subscription-usage.mjs ADDED Viewed

@@ -0,0 +1,55 @@
+import * as Schema from "effect/Schema";
+//#region src/providers/subscription-usage.ts
+const NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()));
+const PositiveNumber = Schema.Number.pipe(Schema.check(Schema.isGreaterThan(0)));
+const isCanonicalInstant = (value) => {
+	const date = new Date(value);
+	return Number.isFinite(date.getTime()) && date.toISOString() === value;
+};
+const ProviderSubscriptionUsageInstant = NonEmptyTrimmedString.pipe(Schema.check(Schema.makeFilter(isCanonicalInstant, { identifier: "ProviderSubscriptionUsageInstant" })));
+const ProviderSubscriptionUsagePercent = Schema.Number.pipe(Schema.check(Schema.isGreaterThanOrEqualTo(0)), Schema.check(Schema.isLessThanOrEqualTo(100)));
+var ProviderSubscriptionUsageWindow = class extends Schema.Class("ProviderSubscriptionUsageWindow")({
+	id: NonEmptyTrimmedString,
+	usedPercent: ProviderSubscriptionUsagePercent,
+	resetsAt: Schema.optional(ProviderSubscriptionUsageInstant),
+	resetsAfterSeconds: Schema.optional(PositiveNumber),
+	windowDurationMinutes: Schema.optional(PositiveNumber)
+}) {};
+var ProviderSubscriptionUsageSnapshot = class extends Schema.Class("ProviderSubscriptionUsageSnapshot")({
+	provider: NonEmptyTrimmedString,
+	fetchedAt: ProviderSubscriptionUsageInstant,
+	windows: Schema.Chunk(ProviderSubscriptionUsageWindow)
+}) {};
+var ProviderSubscriptionUsageRequestError = class extends Schema.TaggedErrorClass()("ProviderSubscriptionUsageRequestError", {
+	provider: Schema.String,
+	category: Schema.Literals(["timeout", "network"])
+}) {};
+var ProviderSubscriptionUsageResponseError = class extends Schema.TaggedErrorClass()("ProviderSubscriptionUsageResponseError", {
+	provider: Schema.String,
+	category: Schema.Literals([
+		"http",
+		"invalid_response",
+		"redirect"
+	]),
+	status: Schema.optional(Schema.Number)
+}) {};
+var ProviderSubscriptionUsageAuthError = class extends Schema.TaggedErrorClass()("ProviderSubscriptionUsageAuthError", {
+	provider: Schema.String,
+	status: Schema.Number
+}) {};
+var ProviderSubscriptionUsageRateLimitError = class extends Schema.TaggedErrorClass()("ProviderSubscriptionUsageRateLimitError", {
+	provider: Schema.String,
+	retryAfterMs: Schema.optional(Schema.Number)
+}) {};
+var ProviderSubscriptionUsageConfigurationError = class extends Schema.TaggedErrorClass()("ProviderSubscriptionUsageConfigurationError", {
+	provider: Schema.String,
+	reason: Schema.Literals([
+		"invalid_request_timeout",
+		"missing_account_id",
+		"provider_mismatch"
+	])
+}) {};
+//#endregion
+export { ProviderSubscriptionUsageAuthError, ProviderSubscriptionUsageConfigurationError, ProviderSubscriptionUsageInstant, ProviderSubscriptionUsagePercent, ProviderSubscriptionUsageRateLimitError, ProviderSubscriptionUsageRequestError, ProviderSubscriptionUsageResponseError, ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageWindow };
+//# sourceMappingURL=subscription-usage.mjs.map

package/dist/providers/subscription-usage.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"subscription-usage.mjs","names":[],"sources":["../../src/providers/subscription-usage.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\n\nconst NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()))\nconst PositiveNumber = Schema.Number.pipe(Schema.check(Schema.isGreaterThan(0)))\nconst isCanonicalInstant = (value: string) => {\n const date = new Date(value)\n\n return Number.isFinite(date.getTime()) && date.toISOString() === value\n}\n\nexport const ProviderSubscriptionUsageInstant = NonEmptyTrimmedString.pipe(\n Schema.check(\n Schema.makeFilter(isCanonicalInstant, {\n identifier: 'ProviderSubscriptionUsageInstant'\n })\n )\n)\n\nexport const ProviderSubscriptionUsagePercent = Schema.Number.pipe(\n Schema.check(Schema.isGreaterThanOrEqualTo(0)),\n Schema.check(Schema.isLessThanOrEqualTo(100))\n)\n\nexport class ProviderSubscriptionUsageWindow extends Schema.Class<ProviderSubscriptionUsageWindow>(\n 'ProviderSubscriptionUsageWindow'\n)({\n id: NonEmptyTrimmedString,\n usedPercent: ProviderSubscriptionUsagePercent,\n resetsAt: Schema.optional(ProviderSubscriptionUsageInstant),\n resetsAfterSeconds: Schema.optional(PositiveNumber),\n windowDurationMinutes: Schema.optional(PositiveNumber)\n}) {}\n\nexport class ProviderSubscriptionUsageSnapshot extends Schema.Class<ProviderSubscriptionUsageSnapshot>(\n 'ProviderSubscriptionUsageSnapshot'\n)({\n provider: NonEmptyTrimmedString,\n fetchedAt: ProviderSubscriptionUsageInstant,\n windows: Schema.Chunk(ProviderSubscriptionUsageWindow)\n}) {}\n\nexport class ProviderSubscriptionUsageRequestError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageRequestError>()(\n 'ProviderSubscriptionUsageRequestError',\n {\n provider: Schema.String,\n category: Schema.Literals(['timeout', 'network'])\n }\n) {}\n\nexport class ProviderSubscriptionUsageResponseError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageResponseError>()(\n 'ProviderSubscriptionUsageResponseError',\n {\n provider: Schema.String,\n category: Schema.Literals(['http', 'invalid_response', 'redirect']),\n status: Schema.optional(Schema.Number)\n }\n) {}\n\nexport class ProviderSubscriptionUsageAuthError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageAuthError>()(\n 'ProviderSubscriptionUsageAuthError',\n {\n provider: Schema.String,\n status: Schema.Number\n }\n) {}\n\nexport class ProviderSubscriptionUsageRateLimitError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageRateLimitError>()(\n 'ProviderSubscriptionUsageRateLimitError',\n {\n provider: Schema.String,\n retryAfterMs: Schema.optional(Schema.Number)\n }\n) {}\n\nexport class ProviderSubscriptionUsageConfigurationError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageConfigurationError>()(\n 'ProviderSubscriptionUsageConfigurationError',\n {\n provider: Schema.String,\n reason: Schema.Literals(['invalid_request_timeout', 'missing_account_id', 'provider_mismatch'])\n }\n) {}\n\nexport type ProviderSubscriptionUsageError =\n | ProviderSubscriptionUsageRequestError\n | ProviderSubscriptionUsageResponseError\n | ProviderSubscriptionUsageAuthError\n | ProviderSubscriptionUsageRateLimitError\n | ProviderSubscriptionUsageConfigurationError\n"],"mappings":";;AAEA,MAAM,wBAAwB,OAAO,QAAQ,KAAK,OAAO,MAAM,OAAO,WAAW,CAAC,CAAC;AACnF,MAAM,iBAAiB,OAAO,OAAO,KAAK,OAAO,MAAM,OAAO,cAAc,CAAC,CAAC,CAAC;AAC/E,MAAM,sBAAsB,UAAkB;CAC5C,MAAM,OAAO,IAAI,KAAK,KAAK;CAE3B,OAAO,OAAO,SAAS,KAAK,QAAQ,CAAC,KAAK,KAAK,YAAY,MAAM;AACnE;AAEA,MAAa,mCAAmC,sBAAsB,KACpE,OAAO,MACL,OAAO,WAAW,oBAAoB,EACpC,YAAY,mCACd,CAAC,CACH,CACF;AAEA,MAAa,mCAAmC,OAAO,OAAO,KAC5D,OAAO,MAAM,OAAO,uBAAuB,CAAC,CAAC,GAC7C,OAAO,MAAM,OAAO,oBAAoB,GAAG,CAAC,CAC9C;AAEA,IAAa,kCAAb,cAAqD,OAAO,MAC1D,iCACF,EAAE;CACA,IAAI;CACJ,aAAa;CACb,UAAU,OAAO,SAAS,gCAAgC;CAC1D,oBAAoB,OAAO,SAAS,cAAc;CAClD,uBAAuB,OAAO,SAAS,cAAc;AACvD,CAAC,EAAE,CAAC;AAEJ,IAAa,oCAAb,cAAuD,OAAO,MAC5D,mCACF,EAAE;CACA,UAAU;CACV,WAAW;CACX,SAAS,OAAO,MAAM,+BAA+B;AACvD,CAAC,EAAE,CAAC;AAEJ,IAAa,wCAAb,cAA2D,OAAO,iBAAwD,EACxH,yCACA;CACE,UAAU,OAAO;CACjB,UAAU,OAAO,SAAS,CAAC,WAAW,SAAS,CAAC;AAClD,CACF,EAAE,CAAC;AAEH,IAAa,yCAAb,cAA4D,OAAO,iBAAyD,EAC1H,0CACA;CACE,UAAU,OAAO;CACjB,UAAU,OAAO,SAAS;EAAC;EAAQ;EAAoB;CAAU,CAAC;CAClE,QAAQ,OAAO,SAAS,OAAO,MAAM;AACvC,CACF,EAAE,CAAC;AAEH,IAAa,qCAAb,cAAwD,OAAO,iBAAqD,EAClH,sCACA;CACE,UAAU,OAAO;CACjB,QAAQ,OAAO;AACjB,CACF,EAAE,CAAC;AAEH,IAAa,0CAAb,cAA6D,OAAO,iBAA0D,EAC5H,2CACA;CACE,UAAU,OAAO;CACjB,cAAc,OAAO,SAAS,OAAO,MAAM;AAC7C,CACF,EAAE,CAAC;AAEH,IAAa,8CAAb,cAAiE,OAAO,iBAA8D,EACpI,+CACA;CACE,UAAU,OAAO;CACjB,QAAQ,OAAO,SAAS;EAAC;EAA2B;EAAsB;CAAmB,CAAC;AAChG,CACF,EAAE,CAAC"}

package/dist/skillset/merge.d.mts CHANGED Viewed

@@ -17,8 +17,8 @@ declare const mergeSkillsets: (sources: ReadonlyArray<SkillsetSource>) => Effect
   skills: {
     readonly name: string;
     readonly description: string;
-    readonly location: string;
     readonly content: string;
+    readonly location: string;
     readonly source?: string | undefined;
   }[];
   commands: {
@@ -27,7 +27,6 @@ declare const mergeSkillsets: (sources: ReadonlyArray<SkillsetSource>) => Effect
     readonly template: string;
     readonly description?: string | undefined;
     readonly source?: string | undefined;
-    readonly location?: string | undefined;
     readonly arguments?: readonly {
       readonly required: boolean;
       readonly name: string;
@@ -35,6 +34,7 @@ declare const mergeSkillsets: (sources: ReadonlyArray<SkillsetSource>) => Effect
     }[] | undefined;
     readonly access?: "read" | "write" | "destructive" | undefined;
     readonly fileRefs?: boolean | undefined;
+    readonly location?: string | undefined;
   }[];
 }, SkillsetError, never>;
 //#endregion

package/dist/skillset/name.d.mts CHANGED Viewed

@@ -3,8 +3,8 @@ import { Effect } from "effect";
 //#region src/skillset/name.d.ts
 declare const isValidSkillsetName: (name: string) => boolean;
-declare const validateSkillsetName: (name: string) => Effect.Effect<never, SkillsetError, never> | Effect.Effect<string, never, never>;
-declare const validateDirectoryName: (expected: string, actual: string) => Effect.Effect<never, SkillsetError, never> | Effect.Effect<string, never, never>;
+declare const validateSkillsetName: (name: string) => Effect.Effect<string, never, never> | Effect.Effect<never, SkillsetError, never>;
+declare const validateDirectoryName: (expected: string, actual: string) => Effect.Effect<string, never, never> | Effect.Effect<never, SkillsetError, never>;
 //#endregion
 export { isValidSkillsetName, validateDirectoryName, validateSkillsetName };
 //# sourceMappingURL=name.d.mts.map

package/dist/skillset/name.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"name.d.mts","names":[],"sources":["../../src/skillset/name.ts"],"mappings":";;;;cAMa,mBAAA,GAAuB,IAAY;AAAA,cAGnC,oBAAA,GAAwB,IAAA,aAAY,MAAA,CAAA,MAAA,~~QAAA~~,~~aAAA~~,~~WAAA~~,MAAA,~~CAAA~~,~~MAAA~~;AAAA,cAUpC,qBAAA,GAAyB,QAAA,UAAkB,MAAA,aAAc,MAAA,CAAA,MAAA,~~QAAA~~,~~aAAA~~,~~WAAA~~,MAAA,~~CAAA~~,~~MAAA~~"}
1	+ {"version":3,"file":"name.d.mts","names":[],"sources":["../../src/skillset/name.ts"],"mappings":";;;;cAMa,mBAAA,GAAuB,IAAY;AAAA,cAGnC,oBAAA,GAAwB,IAAA,aAAY,MAAA,CAAA,MAAA,yBAAA,MAAA,CAAA,MAAA,QAAA,aAAA;AAAA,cAUpC,qBAAA,GAAyB,QAAA,UAAkB,MAAA,aAAc,MAAA,CAAA,MAAA,yBAAA,MAAA,CAAA,MAAA,QAAA,aAAA"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@yolk-sdk/agent",
-  "version": "0.1.0-canary.57",
+  "version": "0.1.0-canary.58",
   "description": "Protocol, loop, runtime, client, compaction, tools, React, providers, OAuth, skillset, and voice primitives for building Yolk agents.",
   "license": "MIT",
   "type": "module",
@@ -87,6 +87,11 @@
       "import": "./dist/providers/openai/codex.mjs",
       "default": "./dist/providers/openai/codex.mjs"
     },
+    "./providers/openai/codex-usage": {
+      "types": "./dist/providers/openai/codex-usage.d.mts",
+      "import": "./dist/providers/openai/codex-usage.mjs",
+      "default": "./dist/providers/openai/codex-usage.mjs"
+    },
     "./providers/openai/codex-provider": {
       "types": "./dist/providers/openai/codex-provider.d.mts",
       "import": "./dist/providers/openai/codex-provider.mjs",
@@ -117,11 +122,21 @@
       "import": "./dist/providers/anthropic/claude.mjs",
       "default": "./dist/providers/anthropic/claude.mjs"
     },
+    "./providers/anthropic/usage": {
+      "types": "./dist/providers/anthropic/usage.d.mts",
+      "import": "./dist/providers/anthropic/usage.mjs",
+      "default": "./dist/providers/anthropic/usage.mjs"
+    },
     "./providers/anthropic/claude-provider": {
       "types": "./dist/providers/anthropic/claude-provider.d.mts",
       "import": "./dist/providers/anthropic/claude-provider.mjs",
       "default": "./dist/providers/anthropic/claude-provider.mjs"
     },
+    "./providers/subscription-usage": {
+      "types": "./dist/providers/subscription-usage.d.mts",
+      "import": "./dist/providers/subscription-usage.mjs",
+      "default": "./dist/providers/subscription-usage.mjs"
+    },
     "./skillset": {
       "types": "./dist/skillset/index.d.mts",
       "import": "./dist/skillset/index.mjs",

package/src/providers/anthropic/usage.ts ADDED Viewed

@@ -0,0 +1,150 @@
+import { Chunk, Clock, Effect } from 'effect'
+import * as Schema from 'effect/Schema'
+import { HttpClient, HttpClientRequest } from 'effect/unstable/http'
+import type { OAuthAccessToken } from '@yolk-sdk/agent/oauth'
+import { anthropicClaudeAuthorizationHeaders, anthropicClaudeProviderId } from './claude.ts'
+import {
+  canonicalSubscriptionUsageInstant,
+  defaultProviderSubscriptionUsageTimeoutMs,
+  executeProviderSubscriptionUsageRequest,
+  readProviderSubscriptionUsageJson,
+  validProviderSubscriptionUsageTimeout,
+  validSubscriptionUsagePercent
+} from '../subscription-usage-internal.ts'
+import {
+  ProviderSubscriptionUsageConfigurationError,
+  type ProviderSubscriptionUsageError,
+  ProviderSubscriptionUsageResponseError,
+  ProviderSubscriptionUsageSnapshot,
+  ProviderSubscriptionUsageWindow
+} from '../subscription-usage.ts'
+export const anthropicClaudeSubscriptionUsageUrl = 'https://api.anthropic.com/api/oauth/usage'
+export type AnthropicClaudeSubscriptionUsageOptions = {
+  readonly requestTimeoutMs?: number
+}
+const NullableNumber = Schema.NullOr(Schema.Number)
+const NullableString = Schema.NullOr(Schema.String)
+class AnthropicClaudeSubscriptionUsageWindowWire extends Schema.Class<AnthropicClaudeSubscriptionUsageWindowWire>(
+  'AnthropicClaudeSubscriptionUsageWindowWire'
+)({
+  utilization: Schema.optional(NullableNumber),
+  resets_at: Schema.optional(NullableString)
+}) {}
+class AnthropicClaudeSubscriptionUsageWire extends Schema.Class<AnthropicClaudeSubscriptionUsageWire>(
+  'AnthropicClaudeSubscriptionUsageWire'
+)({
+  five_hour: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire)),
+  seven_day: Schema.optional(Schema.NullOr(AnthropicClaudeSubscriptionUsageWindowWire))
+}) {}
+export const parseAnthropicClaudeSubscriptionUsage = (
+  value: unknown,
+  fetchedAt: string
+): Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageResponseError> => {
+  const canonicalFetchedAt = canonicalSubscriptionUsageInstant(fetchedAt)
+  if (canonicalFetchedAt === undefined) {
+    return Effect.fail(
+      ProviderSubscriptionUsageResponseError.make({
+        provider: anthropicClaudeProviderId,
+        category: 'invalid_response'
+      })
+    )
+  }
+  return Schema.decodeUnknownEffect(AnthropicClaudeSubscriptionUsageWire)(value).pipe(
+    Effect.map(decoded => {
+      const windows: Array<ProviderSubscriptionUsageWindow> = []
+      const append = (
+        wire: AnthropicClaudeSubscriptionUsageWindowWire | null | undefined,
+        id: 'five-hour' | 'seven-day'
+      ) => {
+        if (!validSubscriptionUsagePercent(wire?.utilization)) {
+          return
+        }
+        const resetValue = wire.resets_at === null ? undefined : wire.resets_at
+        const resetsAt =
+          resetValue === undefined ? undefined : canonicalSubscriptionUsageInstant(resetValue)
+        windows.push(
+          ProviderSubscriptionUsageWindow.make({
+            id,
+            usedPercent: wire.utilization,
+            ...(resetsAt === undefined ? {} : { resetsAt })
+          })
+        )
+      }
+      append(decoded.five_hour, 'five-hour')
+      append(decoded.seven_day, 'seven-day')
+      return ProviderSubscriptionUsageSnapshot.make({
+        provider: anthropicClaudeProviderId,
+        fetchedAt: canonicalFetchedAt,
+        windows: Chunk.fromIterable(windows)
+      })
+    }),
+    Effect.mapError(() =>
+      ProviderSubscriptionUsageResponseError.make({
+        provider: anthropicClaudeProviderId,
+        category: 'invalid_response'
+      })
+    ),
+    Effect.withSpan('AnthropicClaudeSubscriptionUsage.parse')
+  )
+}
+export const fetchAnthropicClaudeSubscriptionUsage = (
+  token: OAuthAccessToken,
+  options: AnthropicClaudeSubscriptionUsageOptions = {}
+): Effect.Effect<
+  ProviderSubscriptionUsageSnapshot,
+  ProviderSubscriptionUsageError,
+  HttpClient.HttpClient
+> =>
+  Effect.gen(function* () {
+    if (token.provider !== anthropicClaudeProviderId) {
+      return yield* Effect.fail(
+        ProviderSubscriptionUsageConfigurationError.make({
+          provider: anthropicClaudeProviderId,
+          reason: 'provider_mismatch'
+        })
+      )
+    }
+    const requestTimeoutMs = options.requestTimeoutMs ?? defaultProviderSubscriptionUsageTimeoutMs
+    if (!validProviderSubscriptionUsageTimeout(requestTimeoutMs)) {
+      return yield* Effect.fail(
+        ProviderSubscriptionUsageConfigurationError.make({
+          provider: anthropicClaudeProviderId,
+          reason: 'invalid_request_timeout'
+        })
+      )
+    }
+    const client = yield* HttpClient.HttpClient
+    const request = HttpClientRequest.get(anthropicClaudeSubscriptionUsageUrl).pipe(
+      HttpClientRequest.setHeaders({
+        accept: 'application/json',
+        ...anthropicClaudeAuthorizationHeaders(token),
+        'anthropic-beta': 'oauth-2025-04-20'
+      })
+    )
+    const response = yield* executeProviderSubscriptionUsageRequest({
+      provider: anthropicClaudeProviderId,
+      client,
+      request,
+      timeoutMs: requestTimeoutMs
+    })
+    const json = yield* readProviderSubscriptionUsageJson(anthropicClaudeProviderId, response)
+    const fetchedAt = new Date(yield* Clock.currentTimeMillis).toISOString()
+    return yield* parseAnthropicClaudeSubscriptionUsage(json, fetchedAt)
+  }).pipe(Effect.withSpan('AnthropicClaudeSubscriptionUsage.fetch'))

package/src/providers/openai/codex-usage.ts ADDED Viewed

@@ -0,0 +1,179 @@
+import { Chunk, Clock, Effect } from 'effect'
+import * as Schema from 'effect/Schema'
+import { HttpClient, HttpClientRequest } from 'effect/unstable/http'
+import type { OAuthAccessToken } from '@yolk-sdk/agent/oauth'
+import { openAiCodexProviderId } from './codex.ts'
+import {
+  canonicalSubscriptionUsageInstant,
+  defaultProviderSubscriptionUsageTimeoutMs,
+  executeProviderSubscriptionUsageRequest,
+  positiveSubscriptionUsageNumber,
+  readProviderSubscriptionUsageJson,
+  validProviderSubscriptionUsageTimeout,
+  validSubscriptionUsagePercent
+} from '../subscription-usage-internal.ts'
+import {
+  ProviderSubscriptionUsageConfigurationError,
+  type ProviderSubscriptionUsageError,
+  ProviderSubscriptionUsageResponseError,
+  ProviderSubscriptionUsageSnapshot,
+  ProviderSubscriptionUsageWindow
+} from '../subscription-usage.ts'
+export const openAiCodexSubscriptionUsageUrl = 'https://chatgpt.com/backend-api/wham/usage'
+export type OpenAiCodexSubscriptionUsageOptions = {
+  readonly requestTimeoutMs?: number
+}
+const NullableNumber = Schema.NullOr(Schema.Number)
+class OpenAiCodexSubscriptionUsageWindowWire extends Schema.Class<OpenAiCodexSubscriptionUsageWindowWire>(
+  'OpenAiCodexSubscriptionUsageWindowWire'
+)({
+  used_percent: Schema.optional(NullableNumber),
+  limit_window_seconds: Schema.optional(NullableNumber),
+  reset_after_seconds: Schema.optional(NullableNumber),
+  reset_at: Schema.optional(NullableNumber)
+}) {}
+class OpenAiCodexSubscriptionRateLimitWire extends Schema.Class<OpenAiCodexSubscriptionRateLimitWire>(
+  'OpenAiCodexSubscriptionRateLimitWire'
+)({
+  primary_window: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionUsageWindowWire)),
+  secondary_window: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionUsageWindowWire))
+}) {}
+class OpenAiCodexSubscriptionUsageWire extends Schema.Class<OpenAiCodexSubscriptionUsageWire>(
+  'OpenAiCodexSubscriptionUsageWire'
+)({
+  rate_limit: Schema.optional(Schema.NullOr(OpenAiCodexSubscriptionRateLimitWire))
+}) {}
+export const parseOpenAiCodexSubscriptionUsage = (
+  value: unknown,
+  fetchedAt: string
+): Effect.Effect<ProviderSubscriptionUsageSnapshot, ProviderSubscriptionUsageResponseError> => {
+  const canonicalFetchedAt = canonicalSubscriptionUsageInstant(fetchedAt)
+  if (canonicalFetchedAt === undefined) {
+    return Effect.fail(
+      ProviderSubscriptionUsageResponseError.make({
+        provider: openAiCodexProviderId,
+        category: 'invalid_response'
+      })
+    )
+  }
+  return Schema.decodeUnknownEffect(OpenAiCodexSubscriptionUsageWire)(value).pipe(
+    Effect.map(decoded => {
+      const windows: Array<ProviderSubscriptionUsageWindow> = []
+      const append = (
+        wire: OpenAiCodexSubscriptionUsageWindowWire | null | undefined,
+        id: 'primary' | 'secondary'
+      ) => {
+        if (!validSubscriptionUsagePercent(wire?.used_percent)) {
+          return
+        }
+        const resetAt = wire.reset_at
+        const resetsAt =
+          resetAt === null || resetAt === undefined
+            ? undefined
+            : canonicalSubscriptionUsageInstant(resetAt)
+        const resetsAfterSeconds = positiveSubscriptionUsageNumber(wire.reset_after_seconds)
+          ? wire.reset_after_seconds
+          : undefined
+        const windowDurationMinutes = positiveSubscriptionUsageNumber(wire.limit_window_seconds)
+          ? wire.limit_window_seconds / 60
+          : undefined
+        windows.push(
+          ProviderSubscriptionUsageWindow.make({
+            id,
+            usedPercent: wire.used_percent,
+            ...(resetsAt === undefined ? {} : { resetsAt }),
+            ...(resetsAfterSeconds === undefined ? {} : { resetsAfterSeconds }),
+            ...(windowDurationMinutes === undefined ? {} : { windowDurationMinutes })
+          })
+        )
+      }
+      append(decoded.rate_limit?.primary_window, 'primary')
+      append(decoded.rate_limit?.secondary_window, 'secondary')
+      return ProviderSubscriptionUsageSnapshot.make({
+        provider: openAiCodexProviderId,
+        fetchedAt: canonicalFetchedAt,
+        windows: Chunk.fromIterable(windows)
+      })
+    }),
+    Effect.mapError(() =>
+      ProviderSubscriptionUsageResponseError.make({
+        provider: openAiCodexProviderId,
+        category: 'invalid_response'
+      })
+    ),
+    Effect.withSpan('OpenAiCodexSubscriptionUsage.parse')
+  )
+}
+export const fetchOpenAiCodexSubscriptionUsage = (
+  token: OAuthAccessToken,
+  options: OpenAiCodexSubscriptionUsageOptions = {}
+): Effect.Effect<
+  ProviderSubscriptionUsageSnapshot,
+  ProviderSubscriptionUsageError,
+  HttpClient.HttpClient
+> =>
+  Effect.gen(function* () {
+    if (token.provider !== openAiCodexProviderId) {
+      return yield* Effect.fail(
+        ProviderSubscriptionUsageConfigurationError.make({
+          provider: openAiCodexProviderId,
+          reason: 'provider_mismatch'
+        })
+      )
+    }
+    const accountId = token.accountId?.trim()
+    if (accountId === undefined || accountId.length === 0) {
+      return yield* Effect.fail(
+        ProviderSubscriptionUsageConfigurationError.make({
+          provider: openAiCodexProviderId,
+          reason: 'missing_account_id'
+        })
+      )
+    }
+    const requestTimeoutMs = options.requestTimeoutMs ?? defaultProviderSubscriptionUsageTimeoutMs
+    if (!validProviderSubscriptionUsageTimeout(requestTimeoutMs)) {
+      return yield* Effect.fail(
+        ProviderSubscriptionUsageConfigurationError.make({
+          provider: openAiCodexProviderId,
+          reason: 'invalid_request_timeout'
+        })
+      )
+    }
+    const client = yield* HttpClient.HttpClient
+    const request = HttpClientRequest.get(openAiCodexSubscriptionUsageUrl).pipe(
+      HttpClientRequest.setHeaders({
+        accept: 'application/json',
+        authorization: `Bearer ${token.accessToken}`,
+        'chatgpt-account-id': accountId
+      })
+    )
+    const response = yield* executeProviderSubscriptionUsageRequest({
+      provider: openAiCodexProviderId,
+      client,
+      request,
+      timeoutMs: requestTimeoutMs
+    })
+    const json = yield* readProviderSubscriptionUsageJson(openAiCodexProviderId, response)
+    const fetchedAt = new Date(yield* Clock.currentTimeMillis).toISOString()
+    return yield* parseOpenAiCodexSubscriptionUsage(json, fetchedAt)
+  }).pipe(Effect.withSpan('OpenAiCodexSubscriptionUsage.fetch'))

package/src/providers/subscription-usage-internal.ts ADDED Viewed

@@ -0,0 +1,105 @@
+import { Duration, Effect } from 'effect'
+import * as Schema from 'effect/Schema'
+import {
+  FetchHttpClient,
+  HttpClientResponse,
+  type HttpClient,
+  type HttpClientRequest
+} from 'effect/unstable/http'
+import { retryAfterMsFromHeaders } from './provider-error.ts'
+import {
+  ProviderSubscriptionUsageAuthError,
+  type ProviderSubscriptionUsageError,
+  ProviderSubscriptionUsageRateLimitError,
+  ProviderSubscriptionUsageRequestError,
+  ProviderSubscriptionUsageResponseError
+} from './subscription-usage.ts'
+export const defaultProviderSubscriptionUsageTimeoutMs = 10_000
+export const canonicalSubscriptionUsageInstant = (value: string | number): string | undefined => {
+  const date = new Date(typeof value === 'number' ? value * 1000 : value)
+  return Number.isFinite(date.getTime()) ? date.toISOString() : undefined
+}
+export const validSubscriptionUsagePercent = (value: number | null | undefined): value is number =>
+  value !== null && value !== undefined && Number.isFinite(value) && value >= 0 && value <= 100
+export const positiveSubscriptionUsageNumber = (
+  value: number | null | undefined
+): value is number => value !== null && value !== undefined && Number.isFinite(value) && value > 0
+export const validProviderSubscriptionUsageTimeout = (value: number) =>
+  Number.isFinite(value) && value > 0
+const responseError = (provider: string, status: number): ProviderSubscriptionUsageError => {
+  if (status === 401 || status === 403) {
+    return ProviderSubscriptionUsageAuthError.make({ provider, status })
+  }
+  return ProviderSubscriptionUsageResponseError.make({
+    provider,
+    category: status >= 300 && status < 400 ? 'redirect' : 'http',
+    status
+  })
+}
+export const executeProviderSubscriptionUsageRequest = (input: {
+  readonly provider: string
+  readonly client: HttpClient.HttpClient
+  readonly request: HttpClientRequest.HttpClientRequest
+  readonly timeoutMs: number
+}) =>
+  Effect.gen(function* () {
+    const response = yield* input.client.execute(input.request).pipe(
+      Effect.provideService(FetchHttpClient.RequestInit, { redirect: 'manual' }),
+      Effect.withTracerEnabled(false),
+      Effect.mapError(() =>
+        ProviderSubscriptionUsageRequestError.make({
+          provider: input.provider,
+          category: 'network'
+        })
+      ),
+      Effect.timeoutOrElse({
+        duration: Duration.millis(input.timeoutMs),
+        orElse: () =>
+          Effect.fail(
+            ProviderSubscriptionUsageRequestError.make({
+              provider: input.provider,
+              category: 'timeout'
+            })
+          )
+      })
+    )
+    if (response.status === 429) {
+      return yield* Effect.fail(
+        ProviderSubscriptionUsageRateLimitError.make({
+          provider: input.provider,
+          retryAfterMs: retryAfterMsFromHeaders(response.headers)
+        })
+      )
+    }
+    if (response.status < 200 || response.status >= 300) {
+      return yield* Effect.fail(responseError(input.provider, response.status))
+    }
+    return response
+  })
+export const readProviderSubscriptionUsageJson = (
+  provider: string,
+  response: HttpClientResponse.HttpClientResponse
+) =>
+  HttpClientResponse.schemaBodyJson(Schema.Unknown)(response).pipe(
+    Effect.withTracerEnabled(false),
+    Effect.mapError(() =>
+      ProviderSubscriptionUsageResponseError.make({
+        provider,
+        category: 'invalid_response',
+        status: response.status
+      })
+    )
+  )

package/src/providers/subscription-usage.ts ADDED Viewed

@@ -0,0 +1,88 @@
+import * as Schema from 'effect/Schema'
+const NonEmptyTrimmedString = Schema.Trimmed.pipe(Schema.check(Schema.isNonEmpty()))
+const PositiveNumber = Schema.Number.pipe(Schema.check(Schema.isGreaterThan(0)))
+const isCanonicalInstant = (value: string) => {
+  const date = new Date(value)
+  return Number.isFinite(date.getTime()) && date.toISOString() === value
+}
+export const ProviderSubscriptionUsageInstant = NonEmptyTrimmedString.pipe(
+  Schema.check(
+    Schema.makeFilter(isCanonicalInstant, {
+      identifier: 'ProviderSubscriptionUsageInstant'
+    })
+  )
+)
+export const ProviderSubscriptionUsagePercent = Schema.Number.pipe(
+  Schema.check(Schema.isGreaterThanOrEqualTo(0)),
+  Schema.check(Schema.isLessThanOrEqualTo(100))
+)
+export class ProviderSubscriptionUsageWindow extends Schema.Class<ProviderSubscriptionUsageWindow>(
+  'ProviderSubscriptionUsageWindow'
+)({
+  id: NonEmptyTrimmedString,
+  usedPercent: ProviderSubscriptionUsagePercent,
+  resetsAt: Schema.optional(ProviderSubscriptionUsageInstant),
+  resetsAfterSeconds: Schema.optional(PositiveNumber),
+  windowDurationMinutes: Schema.optional(PositiveNumber)
+}) {}
+export class ProviderSubscriptionUsageSnapshot extends Schema.Class<ProviderSubscriptionUsageSnapshot>(
+  'ProviderSubscriptionUsageSnapshot'
+)({
+  provider: NonEmptyTrimmedString,
+  fetchedAt: ProviderSubscriptionUsageInstant,
+  windows: Schema.Chunk(ProviderSubscriptionUsageWindow)
+}) {}
+export class ProviderSubscriptionUsageRequestError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageRequestError>()(
+  'ProviderSubscriptionUsageRequestError',
+  {
+    provider: Schema.String,
+    category: Schema.Literals(['timeout', 'network'])
+  }
+) {}
+export class ProviderSubscriptionUsageResponseError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageResponseError>()(
+  'ProviderSubscriptionUsageResponseError',
+  {
+    provider: Schema.String,
+    category: Schema.Literals(['http', 'invalid_response', 'redirect']),
+    status: Schema.optional(Schema.Number)
+  }
+) {}
+export class ProviderSubscriptionUsageAuthError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageAuthError>()(
+  'ProviderSubscriptionUsageAuthError',
+  {
+    provider: Schema.String,
+    status: Schema.Number
+  }
+) {}
+export class ProviderSubscriptionUsageRateLimitError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageRateLimitError>()(
+  'ProviderSubscriptionUsageRateLimitError',
+  {
+    provider: Schema.String,
+    retryAfterMs: Schema.optional(Schema.Number)
+  }
+) {}
+export class ProviderSubscriptionUsageConfigurationError extends Schema.TaggedErrorClass<ProviderSubscriptionUsageConfigurationError>()(
+  'ProviderSubscriptionUsageConfigurationError',
+  {
+    provider: Schema.String,
+    reason: Schema.Literals(['invalid_request_timeout', 'missing_account_id', 'provider_mismatch'])
+  }
+) {}
+export type ProviderSubscriptionUsageError =
+  | ProviderSubscriptionUsageRequestError
+  | ProviderSubscriptionUsageResponseError
+  | ProviderSubscriptionUsageAuthError
+  | ProviderSubscriptionUsageRateLimitError
+  | ProviderSubscriptionUsageConfigurationError