@agentproto/model-intel 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# @agentproto/model-intel
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Model intelligence primitives. This first slice is the unified quota status
+contract of AIP-67 (`quota/v1`):
+
+- `QuotaStatus` with a mandatory `basis` (`provider` | `probe` | `observed` | `estimated`)
+- `QuotaWindow.remainingPct` (0-100) is required; a window that cannot state it is omitted
+- `QuotaReader`: never throws, never fabricates, unknown resolves to `undefined`
+- `QuotaReaderRegistry` / `defineQuotaReader`
+
+Core readers MUST NOT emit `basis: "probe"`.

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+
+/**
+ * Where a quota figure came from. `provider` is a documented provider
+ * surface; `observed` is derived from this host's own traffic; `estimated`
+ * is a local computation; `probe` is an undocumented surface reached through
+ * a connector and MUST NOT be emitted by core readers.
+ */
+declare const QUOTA_BASES: readonly ["provider", "probe", "observed", "estimated"];
+type QuotaBasis = (typeof QUOTA_BASES)[number];
+declare const quotaWindowSchema: z.ZodObject<{
+    id: z.ZodString;
+    remainingPct: z.ZodNumber;
+    used: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    remaining: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    resetsAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type QuotaWindow = z.infer<typeof quotaWindowSchema>;
+declare const quotaCreditsSchema: z.ZodObject<{
+    balanceUsd: z.ZodOptional<z.ZodNumber>;
+    unlimited: z.ZodOptional<z.ZodBoolean>;
+    currency: z.ZodString;
+}, z.core.$strip>;
+type QuotaCredits = z.infer<typeof quotaCreditsSchema>;
+declare const quotaStatusSchema: z.ZodObject<{
+    profileRef: z.ZodString;
+    asOf: z.ZodString;
+    basis: z.ZodEnum<{
+        provider: "provider";
+        probe: "probe";
+        observed: "observed";
+        estimated: "estimated";
+    }>;
+    source: z.ZodOptional<z.ZodString>;
+    windows: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        remainingPct: z.ZodNumber;
+        used: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        remaining: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        resetsAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    credits: z.ZodOptional<z.ZodObject<{
+        balanceUsd: z.ZodOptional<z.ZodNumber>;
+        unlimited: z.ZodOptional<z.ZodBoolean>;
+        currency: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type QuotaStatus = z.infer<typeof quotaStatusSchema>;
+/** The minimal auth-profile projection a reader needs. */
+interface QuotaProfile {
+    profileRef: string;
+    endpoint: string;
+    method: "oauth-bearer" | "api-key";
+    credentialRef?: string;
+}
+interface QuotaReadContext {
+    signal?: AbortSignal;
+    /** Resolve a profile's opaque credentialRef to a bearer secret. */
+    resolveCredential?(ref: string): Promise<string | undefined>;
+    fetchImpl?: typeof fetch;
+    now?: () => Date;
+}
+/**
+ * Reads quota for a profile. MUST NOT throw: any failure or unknown value
+ * resolves to `undefined`. Never fabricates a figure.
+ */
+interface QuotaReader {
+    readonly id: string;
+    supports(profile: QuotaProfile): boolean;
+    read(profile: QuotaProfile, ctx: QuotaReadContext): Promise<QuotaStatus | undefined>;
+}
+
+/** remainingPct from a used percentage, or undefined when it is not a finite 0-100 number. */
+declare function remainingPctFromUsed(usedPct: number | null | undefined): number | undefined;
+/** remainingPct from remaining/limit counts, or undefined when limit is not a positive finite number. */
+declare function remainingPctFromCounts(remaining: number | null | undefined, limit: number | null | undefined): number | undefined;
+interface BuildQuotaStatusInput {
+    profileRef: string;
+    basis: QuotaBasis;
+    source?: string;
+    now?: () => Date;
+    /** Candidate windows; any that fail validation are dropped, never repaired. */
+    windows?: readonly unknown[];
+    credits?: QuotaCredits;
+}
+/**
+ * Assemble a QuotaStatus. Invalid windows are omitted. Returns `undefined`
+ * when there is nothing to report (no valid window and no credits).
+ */
+declare function buildQuotaStatus(input: BuildQuotaStatusInput): QuotaStatus | undefined;
+
+/** Identity helper that fixes the QuotaReader contract at definition time (AIP-43 handle). */
+declare function defineQuotaReader(reader: QuotaReader): QuotaReader;
+declare class QuotaReaderRegistry {
+    private readonly readers;
+    register(reader: QuotaReader): this;
+    list(): QuotaReader[];
+    /** First registered reader that supports the profile, in registration order. */
+    find(profile: QuotaProfile): QuotaReader | undefined;
+    /** Read through the first supporting reader. Never throws; unknown -> undefined. */
+    read(profile: QuotaProfile, ctx?: QuotaReadContext): Promise<QuotaStatus | undefined>;
+}
+
+interface AnthropicHeadersInput {
+    profileRef: string;
+    headers: Headers | Record<string, string | undefined>;
+    now?: () => Date;
+}
+/**
+ * PURE: build a QuotaStatus from Anthropic's DOCUMENTED rate-limit headers
+ * `anthropic-ratelimit-{requests,tokens,input-tokens,output-tokens}-{limit,remaining,reset}`.
+ * The undocumented `anthropic-ratelimit-unified-*` family is never read.
+ * A dimension with a missing/non-numeric limit or remaining is skipped.
+ */
+declare function quotaFromAnthropicHeaders(input: AnthropicHeadersInput): QuotaStatus | undefined;
+
+interface OpenRouterQuotaReaderOptions {
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+/**
+ * OpenRouter quota reader: `GET /key` exposes the key's USD cap and remaining
+ * headroom. The whole read is wrapped so it never throws; an uncapped key
+ * (`limit_remaining` null/absent) yields no window and no credits.
+ */
+declare function createOpenRouterQuotaReader(opts?: OpenRouterQuotaReaderOptions): QuotaReader;
+
+/**
+ * @agentproto/model-intel — model intelligence primitives.
+ *
+ * Unified, provider-neutral quota status (AIP-67): one QuotaStatus shape with a
+ * mandatory `basis`, a never-throw QuotaReader contract, and a reader registry.
+ * Unknown is omitted, never fabricated.
+ *
+ * @see https://agentproto.sh/docs/aip-67
+ */
+declare const SPEC_NAME: "quota/v1";
+declare const SPEC_VERSION: "1.0.0-alpha";
+
+export { type BuildQuotaStatusInput, QUOTA_BASES, type QuotaBasis, type QuotaCredits, type QuotaProfile, type QuotaReadContext, type QuotaReader, QuotaReaderRegistry, type QuotaStatus, type QuotaWindow, SPEC_NAME, SPEC_VERSION, buildQuotaStatus, createOpenRouterQuotaReader, defineQuotaReader, quotaCreditsSchema, quotaFromAnthropicHeaders, quotaStatusSchema, quotaWindowSchema, remainingPctFromCounts, remainingPctFromUsed };

package/dist/index.mjs

@@ -0,0 +1,251 @@
+import { z } from 'zod';
+
+/**
+ * @agentproto/model-intel v0.1.0
+ * Model intelligence: unified quota status (AIP-67).
+ */
+
+var QUOTA_BASES = ["provider", "probe", "observed", "estimated"];
+var isoTimestamp = z.string().refine((s) => !Number.isNaN(Date.parse(s)), {
+  message: "expected an ISO-8601 timestamp"
+});
+var quotaWindowSchema = z.object({
+  /** Open string: "5h", "7d", "month", "minute", "day", "primary", "key_limit", ... */
+  id: z.string().min(1),
+  /** 0-100. Required: a window that cannot state it is not emitted. */
+  remainingPct: z.number().min(0).max(100),
+  used: z.number().optional(),
+  limit: z.number().optional(),
+  remaining: z.number().optional(),
+  unit: z.string().optional(),
+  resetsAt: isoTimestamp.optional()
+});
+var quotaCreditsSchema = z.object({
+  balanceUsd: z.number().optional(),
+  unlimited: z.boolean().optional(),
+  currency: z.string().min(1)
+});
+var quotaStatusSchema = z.object({
+  profileRef: z.string().min(1),
+  asOf: isoTimestamp,
+  basis: z.enum(QUOTA_BASES),
+  source: z.string().optional(),
+  windows: z.array(quotaWindowSchema),
+  credits: quotaCreditsSchema.optional()
+});
+
+// src/build.ts
+function remainingPctFromUsed(usedPct) {
+  if (usedPct === null || usedPct === void 0 || !Number.isFinite(usedPct)) return void 0;
+  if (usedPct < 0 || usedPct > 100) return void 0;
+  return 100 - usedPct;
+}
+function remainingPctFromCounts(remaining, limit) {
+  if (remaining === null || remaining === void 0 || limit === null || limit === void 0) {
+    return void 0;
+  }
+  if (!Number.isFinite(remaining) || !Number.isFinite(limit) || limit <= 0) return void 0;
+  if (remaining < 0 || remaining > limit) return void 0;
+  return remaining / limit * 100;
+}
+function buildQuotaStatus(input) {
+  const windows = [];
+  for (const candidate of input.windows ?? []) {
+    const parsed = quotaWindowSchema.safeParse(candidate);
+    if (parsed.success) windows.push(parsed.data);
+  }
+  if (windows.length === 0 && input.credits === void 0) return void 0;
+  return {
+    profileRef: input.profileRef,
+    asOf: (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString(),
+    basis: input.basis,
+    ...input.source !== void 0 ? { source: input.source } : {},
+    windows,
+    ...input.credits !== void 0 ? { credits: input.credits } : {}
+  };
+}
+
+// src/registry.ts
+function defineQuotaReader(reader) {
+  return reader;
+}
+var QuotaReaderRegistry = class {
+  readers = /* @__PURE__ */ new Map();
+  register(reader) {
+    if (this.readers.has(reader.id)) {
+      throw new Error(`quota reader already registered: ${reader.id}`);
+    }
+    this.readers.set(reader.id, reader);
+    return this;
+  }
+  list() {
+    return [...this.readers.values()];
+  }
+  /** First registered reader that supports the profile, in registration order. */
+  find(profile) {
+    for (const reader of this.readers.values()) {
+      if (safeSupports(reader, profile)) return reader;
+    }
+    return void 0;
+  }
+  /** Read through the first supporting reader. Never throws; unknown -> undefined. */
+  async read(profile, ctx = {}) {
+    const reader = this.find(profile);
+    if (!reader) return void 0;
+    try {
+      return await reader.read(profile, ctx);
+    } catch {
+      return void 0;
+    }
+  }
+};
+function safeSupports(reader, profile) {
+  try {
+    return reader.supports(profile);
+  } catch {
+    return false;
+  }
+}
+
+// src/readers/anthropic.ts
+var DIMENSIONS = [
+  { id: "requests-1m", header: "requests", unit: "requests" },
+  { id: "tokens-1m", header: "tokens", unit: "tokens" },
+  { id: "input-tokens-1m", header: "input-tokens", unit: "tokens" },
+  { id: "output-tokens-1m", header: "output-tokens", unit: "tokens" }
+];
+function headerGet(headers, name) {
+  if (headers instanceof Headers) {
+    return headers.get(name) ?? void 0;
+  }
+  const lower = name.toLowerCase();
+  for (const [key, value] of Object.entries(headers)) {
+    if (key.toLowerCase() === lower) return value;
+  }
+  return void 0;
+}
+function parseCount(raw) {
+  if (raw === void 0) return void 0;
+  const trimmed = raw.trim();
+  if (!trimmed) return void 0;
+  const n = Number(trimmed);
+  return Number.isFinite(n) ? n : void 0;
+}
+function parseReset(raw) {
+  if (raw === void 0) return void 0;
+  const trimmed = raw.trim();
+  if (!trimmed) return void 0;
+  const date = new Date(trimmed);
+  return Number.isNaN(date.getTime()) ? void 0 : date.toISOString();
+}
+function quotaFromAnthropicHeaders(input) {
+  const windows = [];
+  for (const dimension of DIMENSIONS) {
+    const prefix = `anthropic-ratelimit-${dimension.header}`;
+    const limit = parseCount(headerGet(input.headers, `${prefix}-limit`));
+    const remaining = parseCount(headerGet(input.headers, `${prefix}-remaining`));
+    if (limit === void 0 || remaining === void 0) continue;
+    const remainingPct = remainingPctFromCounts(remaining, limit);
+    if (remainingPct === void 0) continue;
+    const resetsAt = parseReset(headerGet(input.headers, `${prefix}-reset`));
+    windows.push({
+      id: dimension.id,
+      remainingPct,
+      limit,
+      remaining,
+      unit: dimension.unit,
+      ...resetsAt !== void 0 ? { resetsAt } : {}
+    });
+  }
+  return buildQuotaStatus({
+    profileRef: input.profileRef,
+    basis: "provider",
+    source: "anthropic:ratelimit-headers",
+    now: input.now,
+    windows
+  });
+}
+var DEFAULT_BASE_URL = "https://openrouter.ai/api/v1";
+var DEFAULT_TIMEOUT_MS = 4e3;
+var OPENROUTER_KEY_SCHEMA = z.object({
+  data: z.object({
+    limit: z.number().nullable().optional(),
+    limit_remaining: z.number().nullable().optional()
+  }).passthrough()
+}).passthrough();
+async function getKeyJson(baseUrl, secret, ctx, timeoutMs) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  const onAbort = () => controller.abort();
+  ctx.signal?.addEventListener("abort", onAbort);
+  try {
+    const res = await (ctx.fetchImpl ?? fetch)(`${baseUrl}/key`, {
+      method: "GET",
+      headers: { authorization: `Bearer ${secret}` },
+      signal: controller.signal
+    });
+    if (!res.ok) return void 0;
+    return await res.json();
+  } catch {
+    return void 0;
+  } finally {
+    clearTimeout(timer);
+    ctx.signal?.removeEventListener("abort", onAbort);
+  }
+}
+function createOpenRouterQuotaReader(opts) {
+  const baseUrl = opts?.baseUrl ?? DEFAULT_BASE_URL;
+  const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return defineQuotaReader({
+    id: "openrouter-key",
+    supports: (profile) => profile.endpoint === "openrouter" && profile.method === "api-key",
+    read: async (profile, ctx) => {
+      try {
+        if (!profile.credentialRef) return void 0;
+        if (!ctx.resolveCredential) return void 0;
+        const secret = await ctx.resolveCredential(profile.credentialRef).catch(() => void 0);
+        if (!secret) return void 0;
+        const body = await getKeyJson(baseUrl, secret, ctx, timeoutMs);
+        if (body === void 0) return void 0;
+        const parsed = OPENROUTER_KEY_SCHEMA.safeParse(body);
+        if (!parsed.success) return void 0;
+        const { limit, limit_remaining } = parsed.data.data;
+        const windows = [];
+        if (typeof limit === "number" && Number.isFinite(limit) && typeof limit_remaining === "number" && Number.isFinite(limit_remaining)) {
+          const remainingPct = remainingPctFromCounts(limit_remaining, limit);
+          if (remainingPct !== void 0) {
+            windows.push({
+              id: "key_limit",
+              remainingPct,
+              remaining: limit_remaining,
+              limit,
+              unit: "USD"
+            });
+          }
+        }
+        let credits;
+        if (typeof limit_remaining === "number" && Number.isFinite(limit_remaining)) {
+          credits = { balanceUsd: limit_remaining, currency: "USD" };
+        }
+        return buildQuotaStatus({
+          profileRef: profile.profileRef,
+          basis: "provider",
+          source: "openrouter:/key",
+          now: ctx.now,
+          windows,
+          ...credits !== void 0 ? { credits } : {}
+        });
+      } catch {
+        return void 0;
+      }
+    }
+  });
+}
+
+// src/index.ts
+var SPEC_NAME = "quota/v1";
+var SPEC_VERSION = "1.0.0-alpha";
+
+export { QUOTA_BASES, QuotaReaderRegistry, SPEC_NAME, SPEC_VERSION, buildQuotaStatus, createOpenRouterQuotaReader, defineQuotaReader, quotaCreditsSchema, quotaFromAnthropicHeaders, quotaStatusSchema, quotaWindowSchema, remainingPctFromCounts, remainingPctFromUsed };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/build.ts","../src/registry.ts","../src/readers/anthropic.ts","../src/readers/openrouter.ts","../src/index.ts"],"names":["z"],"mappings":";;;;;;;AAQO,IAAM,WAAA,GAAc,CAAC,UAAA,EAAY,OAAA,EAAS,YAAY,WAAW;AAGxE,IAAM,YAAA,GAAe,CAAA,CAAE,MAAA,EAAO,CAAE,OAAO,CAAC,CAAA,KAAM,CAAC,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA,EAAG;AAAA,EAC1E,OAAA,EAAS;AACX,CAAC,CAAA;AAEM,IAAM,iBAAA,GAAoB,EAAE,MAAA,CAAO;AAAA;AAAA,EAExC,EAAA,EAAI,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA;AAAA,EAEpB,YAAA,EAAc,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,GAAG,CAAA;AAAA,EACvC,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,SAAA,EAAW,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC/B,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,QAAA,EAAU,aAAa,QAAA;AACzB,CAAC;AAGM,IAAM,kBAAA,GAAqB,EAAE,MAAA,CAAO;AAAA,EACzC,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChC,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAChC,QAAA,EAAU,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC;AAC5B,CAAC;AAGM,IAAM,iBAAA,GAAoB,EAAE,MAAA,CAAO;AAAA,EACxC,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA;AAAA,EAC5B,IAAA,EAAM,YAAA;AAAA,EACN,KAAA,EAAO,CAAA,CAAE,IAAA,CAAK,WAAW,CAAA;AAAA,EACzB,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC5B,OAAA,EAAS,CAAA,CAAE,KAAA,CAAM,iBAAiB,CAAA;AAAA,EAClC,OAAA,EAAS,mBAAmB,QAAA;AAC9B,CAAC;;;ACtCM,SAAS,qBAAqB,OAAA,EAAwD;AAC3F,EAAA,IAAI,OAAA,KAAY,QAAQ,OAAA,KAAY,MAAA,IAAa,CAAC,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,EAAG,OAAO,MAAA;AACnF,EAAA,IAAI,OAAA,GAAU,CAAA,IAAK,OAAA,GAAU,GAAA,EAAK,OAAO,MAAA;AACzC,EAAA,OAAO,GAAA,GAAM,OAAA;AACf;AAGO,SAAS,sBAAA,CACd,WACA,KAAA,EACoB;AACpB,EAAA,IAAI,cAAc,IAAA,IAAQ,SAAA,KAAc,UAAa,KAAA,KAAU,IAAA,IAAQ,UAAU,MAAA,EAAW;AAC1F,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,SAAS,CAAA,IAAK,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IAAK,KAAA,IAAS,CAAA,EAAG,OAAO,MAAA;AACjF,EAAA,IAAI,SAAA,GAAY,CAAA,IAAK,SAAA,GAAY,KAAA,EAAO,OAAO,MAAA;AAC/C,EAAA,OAAQ,YAAY,KAAA,GAAS,GAAA;AAC/B;AAgBO,SAAS,iBAAiB,KAAA,EAAuD;AACtF,EAAA,MAAM,UAAyB,EAAC;AAChC,EAAA,KAAA,MAAW,SAAA,IAAa,KAAA,CAAM,OAAA,IAAW,EAAC,EAAG;AAC3C,IAAA,MAAM,MAAA,GAAS,iBAAA,CAAkB,SAAA,CAAU,SAAS,CAAA;AACpD,IAAA,IAAI,MAAA,CAAO,OAAA,EAAS,OAAA,CAAQ,IAAA,CAAK,OAAO,IAAI,CAAA;AAAA,EAC9C;AACA,EAAA,IAAI,QAAQ,MAAA,KAAW,CAAA,IAAK,KAAA,CAAM,OAAA,KAAY,QAAW,OAAO,MAAA;AAChE,EAAA,OAAO;AAAA,IACL,YAAY,KAAA,CAAM,UAAA;AAAA,IAClB,IAAA,EAAA,CAAO,MAAM,GAAA,KAAQ,0BAAU,IAAA,EAAK,CAAA,IAAM,WAAA,EAAY;AAAA,IACtD,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,GAAI,MAAM,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,KAAA,CAAM,MAAA,EAAO,GAAI,EAAC;AAAA,IAC7D,OAAA;AAAA,IACA,GAAI,MAAM,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,KAAA,CAAM,OAAA,EAAQ,GAAI;AAAC,GAClE;AACF;;;ACjDO,SAAS,kBAAkB,MAAA,EAAkC;AAClE,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,sBAAN,MAA0B;AAAA,EACd,OAAA,uBAAc,GAAA,EAAyB;AAAA,EAExD,SAAS,MAAA,EAA2B;AAClC,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAO,EAAE,CAAA,EAAG;AAC/B,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iCAAA,EAAoC,MAAA,CAAO,EAAE,CAAA,CAAE,CAAA;AAAA,IACjE;AACA,IAAA,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,MAAM,CAAA;AAClC,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,IAAA,GAAsB;AACpB,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,OAAA,CAAQ,QAAQ,CAAA;AAAA,EAClC;AAAA;AAAA,EAGA,KAAK,OAAA,EAAgD;AACnD,IAAA,KAAA,MAAW,MAAA,IAAU,IAAA,CAAK,OAAA,CAAQ,MAAA,EAAO,EAAG;AAC1C,MAAA,IAAI,YAAA,CAAa,MAAA,EAAQ,OAAO,CAAA,EAAG,OAAO,MAAA;AAAA,IAC5C;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA,EAGA,MAAM,IAAA,CAAK,OAAA,EAAuB,GAAA,GAAwB,EAAC,EAAqC;AAC9F,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA;AAChC,IAAA,IAAI,CAAC,QAAQ,OAAO,MAAA;AACpB,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,MAAA,CAAO,IAAA,CAAK,OAAA,EAAS,GAAG,CAAA;AAAA,IACvC,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,EACF;AACF;AAEA,SAAS,YAAA,CAAa,QAAqB,OAAA,EAAgC;AACzE,EAAA,IAAI;AACF,IAAA,OAAO,MAAA,CAAO,SAAS,OAAO,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;;;ACjCA,IAAM,UAAA,GAAmC;AAAA,EACvC,EAAE,EAAA,EAAI,aAAA,EAAe,MAAA,EAAQ,UAAA,EAAY,MAAM,UAAA,EAAW;AAAA,EAC1D,EAAE,EAAA,EAAI,WAAA,EAAa,MAAA,EAAQ,QAAA,EAAU,MAAM,QAAA,EAAS;AAAA,EACpD,EAAE,EAAA,EAAI,iBAAA,EAAmB,MAAA,EAAQ,cAAA,EAAgB,MAAM,QAAA,EAAS;AAAA,EAChE,EAAE,EAAA,EAAI,kBAAA,EAAoB,MAAA,EAAQ,eAAA,EAAiB,MAAM,QAAA;AAC3D,CAAA;AAGA,SAAS,SAAA,CACP,SACA,IAAA,EACoB;AACpB,EAAA,IAAI,mBAAmB,OAAA,EAAS;AAC9B,IAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA,IAAK,MAAA;AAAA,EAC9B;AACA,EAAA,MAAM,KAAA,GAAQ,KAAK,WAAA,EAAY;AAC/B,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAClD,IAAA,IAAI,GAAA,CAAI,WAAA,EAAY,KAAM,KAAA,EAAO,OAAO,KAAA;AAAA,EAC1C;AACA,EAAA,OAAO,MAAA;AACT;AAGA,SAAS,WAAW,GAAA,EAA6C;AAC/D,EAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,MAAA;AAC9B,EAAA,MAAM,OAAA,GAAU,IAAI,IAAA,EAAK;AACzB,EAAA,IAAI,CAAC,SAAS,OAAO,MAAA;AACrB,EAAA,MAAM,CAAA,GAAI,OAAO,OAAO,CAAA;AACxB,EAAA,OAAO,MAAA,CAAO,QAAA,CAAS,CAAC,CAAA,GAAI,CAAA,GAAI,MAAA;AAClC;AAGA,SAAS,WAAW,GAAA,EAA6C;AAC/D,EAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,MAAA;AAC9B,EAAA,MAAM,OAAA,GAAU,IAAI,IAAA,EAAK;AACzB,EAAA,IAAI,CAAC,SAAS,OAAO,MAAA;AACrB,EAAA,MAAM,IAAA,GAAO,IAAI,IAAA,CAAK,OAAO,CAAA;AAC7B,EAAA,OAAO,MAAA,CAAO,MAAM,IAAA,CAAK,OAAA,EAAS,CAAA,GAAI,MAAA,GAAY,KAAK,WAAA,EAAY;AACrE;AAQO,SAAS,0BAA0B,KAAA,EAAuD;AAC/F,EAAA,MAAM,UAAqC,EAAC;AAC5C,EAAA,KAAA,MAAW,aAAa,UAAA,EAAY;AAClC,IAAA,MAAM,MAAA,GAAS,CAAA,oBAAA,EAAuB,SAAA,CAAU,MAAM,CAAA,CAAA;AACtD,IAAA,MAAM,KAAA,GAAQ,WAAW,SAAA,CAAU,KAAA,CAAM,SAAS,CAAA,EAAG,MAAM,QAAQ,CAAC,CAAA;AACpE,IAAA,MAAM,SAAA,GAAY,WAAW,SAAA,CAAU,KAAA,CAAM,SAAS,CAAA,EAAG,MAAM,YAAY,CAAC,CAAA;AAC5E,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,SAAA,KAAc,MAAA,EAAW;AACpD,IAAA,MAAM,YAAA,GAAe,sBAAA,CAAuB,SAAA,EAAW,KAAK,CAAA;AAC5D,IAAA,IAAI,iBAAiB,MAAA,EAAW;AAChC,IAAA,MAAM,QAAA,GAAW,WAAW,SAAA,CAAU,KAAA,CAAM,SAAS,CAAA,EAAG,MAAM,QAAQ,CAAC,CAAA;AACvE,IAAA,OAAA,CAAQ,IAAA,CAAK;AAAA,MACX,IAAI,SAAA,CAAU,EAAA;AAAA,MACd,YAAA;AAAA,MACA,KAAA;AAAA,MACA,SAAA;AAAA,MACA,MAAM,SAAA,CAAU,IAAA;AAAA,MAChB,GAAI,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,KAAa;AAAC,KAC9C,CAAA;AAAA,EACH;AACA,EAAA,OAAO,gBAAA,CAAiB;AAAA,IACtB,YAAY,KAAA,CAAM,UAAA;AAAA,IAClB,KAAA,EAAO,UAAA;AAAA,IACP,MAAA,EAAQ,6BAAA;AAAA,IACR,KAAK,KAAA,CAAM,GAAA;AAAA,IACX;AAAA,GACD,CAAA;AACH;AClFA,IAAM,gBAAA,GAAmB,8BAAA;AACzB,IAAM,kBAAA,GAAqB,GAAA;AAE3B,IAAM,qBAAA,GAAwBA,EAC3B,MAAA,CAAO;AAAA,EACN,IAAA,EAAMA,EACH,MAAA,CAAO;AAAA,IACN,OAAOA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,GAAW,QAAA,EAAS;AAAA,IACtC,iBAAiBA,CAAAA,CAAE,MAAA,EAAO,CAAE,QAAA,GAAW,QAAA;AAAS,GACjD,EACA,WAAA;AACL,CAAC,EACA,WAAA,EAAY;AAQf,eAAe,UAAA,CACb,OAAA,EACA,MAAA,EACA,GAAA,EACA,SAAA,EAC8B;AAC9B,EAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,EAAA,MAAM,QAAQ,UAAA,CAAW,MAAM,UAAA,CAAW,KAAA,IAAS,SAAS,CAAA;AAC5D,EAAA,MAAM,OAAA,GAAU,MAAM,UAAA,CAAW,KAAA,EAAM;AACvC,EAAA,GAAA,CAAI,MAAA,EAAQ,gBAAA,CAAiB,OAAA,EAAS,OAAO,CAAA;AAC7C,EAAA,IAAI;AACF,IAAA,MAAM,MAAM,MAAA,CAAO,GAAA,CAAI,aAAa,KAAA,EAAO,CAAA,EAAG,OAAO,CAAA,IAAA,CAAA,EAAQ;AAAA,MAC3D,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS,EAAE,aAAA,EAAe,CAAA,OAAA,EAAU,MAAM,CAAA,CAAA,EAAG;AAAA,MAC7C,QAAQ,UAAA,CAAW;AAAA,KACpB,CAAA;AACD,IAAA,IAAI,CAAC,GAAA,CAAI,EAAA,EAAI,OAAO,KAAA,CAAA;AACpB,IAAA,OAAO,MAAM,IAAI,IAAA,EAAK;AAAA,EACxB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT,CAAA,SAAE;AACA,IAAA,YAAA,CAAa,KAAK,CAAA;AAClB,IAAA,GAAA,CAAI,MAAA,EAAQ,mBAAA,CAAoB,OAAA,EAAS,OAAO,CAAA;AAAA,EAClD;AACF;AAOO,SAAS,4BAA4B,IAAA,EAAkD;AAC5F,EAAA,MAAM,OAAA,GAAU,MAAM,OAAA,IAAW,gBAAA;AACjC,EAAA,MAAM,SAAA,GAAY,MAAM,SAAA,IAAa,kBAAA;AAErC,EAAA,OAAO,iBAAA,CAAkB;AAAA,IACvB,EAAA,EAAI,gBAAA;AAAA,IACJ,UAAU,CAAC,OAAA,KACT,QAAQ,QAAA,KAAa,YAAA,IAAgB,QAAQ,MAAA,KAAW,SAAA;AAAA,IAC1D,IAAA,EAAM,OACJ,OAAA,EACA,GAAA,KACqC;AACrC,MAAA,IAAI;AACF,QAAA,IAAI,CAAC,OAAA,CAAQ,aAAA,EAAe,OAAO,KAAA,CAAA;AACnC,QAAA,IAAI,CAAC,GAAA,CAAI,iBAAA,EAAmB,OAAO,KAAA,CAAA;AACnC,QAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,iBAAA,CAAkB,QAAQ,aAAa,CAAA,CAAE,KAAA,CAAM,MAAM,KAAA,CAAS,CAAA;AACvF,QAAA,IAAI,CAAC,QAAQ,OAAO,KAAA,CAAA;AAEpB,QAAA,MAAM,OAAO,MAAM,UAAA,CAAW,OAAA,EAAS,MAAA,EAAQ,KAAK,SAAS,CAAA;AAC7D,QAAA,IAAI,IAAA,KAAS,QAAW,OAAO,KAAA,CAAA;AAC/B,QAAA,MAAM,MAAA,GAAS,qBAAA,CAAsB,SAAA,CAAU,IAAI,CAAA;AACnD,QAAA,IAAI,CAAC,MAAA,CAAO,OAAA,EAAS,OAAO,KAAA,CAAA;AAE5B,QAAA,MAAM,EAAE,KAAA,EAAO,eAAA,EAAgB,GAAI,OAAO,IAAA,CAAK,IAAA;AAC/C,QAAA,MAAM,UAAyB,EAAC;AAChC,QAAA,IACE,OAAO,KAAA,KAAU,QAAA,IACjB,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IACrB,OAAO,eAAA,KAAoB,QAAA,IAC3B,MAAA,CAAO,QAAA,CAAS,eAAe,CAAA,EAC/B;AACA,UAAA,MAAM,YAAA,GAAe,sBAAA,CAAuB,eAAA,EAAiB,KAAK,CAAA;AAClE,UAAA,IAAI,iBAAiB,KAAA,CAAA,EAAW;AAC9B,YAAA,OAAA,CAAQ,IAAA,CAAK;AAAA,cACX,EAAA,EAAI,WAAA;AAAA,cACJ,YAAA;AAAA,cACA,SAAA,EAAW,eAAA;AAAA,cACX,KAAA;AAAA,cACA,IAAA,EAAM;AAAA,aACP,CAAA;AAAA,UACH;AAAA,QACF;AACA,QAAA,IAAI,OAAA;AACJ,QAAA,IAAI,OAAO,eAAA,KAAoB,QAAA,IAAY,MAAA,CAAO,QAAA,CAAS,eAAe,CAAA,EAAG;AAC3E,UAAA,OAAA,GAAU,EAAE,UAAA,EAAY,eAAA,EAAiB,QAAA,EAAU,KAAA,EAAM;AAAA,QAC3D;AAEA,QAAA,OAAO,gBAAA,CAAiB;AAAA,UACtB,YAAY,OAAA,CAAQ,UAAA;AAAA,UACpB,KAAA,EAAO,UAAA;AAAA,UACP,MAAA,EAAQ,iBAAA;AAAA,UACR,KAAK,GAAA,CAAI,GAAA;AAAA,UACT,OAAA;AAAA,UACA,GAAI,OAAA,KAAY,KAAA,CAAA,GAAY,EAAE,OAAA,KAAY;AAAC,SAC5C,CAAA;AAAA,MACH,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,MAAA;AAAA,MACT;AAAA,IACF;AAAA,GACD,CAAA;AACH;;;AC1GO,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["import { z } from \"zod\"\n\n/**\n * Where a quota figure came from. `provider` is a documented provider\n * surface; `observed` is derived from this host's own traffic; `estimated`\n * is a local computation; `probe` is an undocumented surface reached through\n * a connector and MUST NOT be emitted by core readers.\n */\nexport const QUOTA_BASES = [\"provider\", \"probe\", \"observed\", \"estimated\"] as const\nexport type QuotaBasis = (typeof QUOTA_BASES)[number]\n\nconst isoTimestamp = z.string().refine((s) => !Number.isNaN(Date.parse(s)), {\n  message: \"expected an ISO-8601 timestamp\",\n})\n\nexport const quotaWindowSchema = z.object({\n  /** Open string: \"5h\", \"7d\", \"month\", \"minute\", \"day\", \"primary\", \"key_limit\", ... */\n  id: z.string().min(1),\n  /** 0-100. Required: a window that cannot state it is not emitted. */\n  remainingPct: z.number().min(0).max(100),\n  used: z.number().optional(),\n  limit: z.number().optional(),\n  remaining: z.number().optional(),\n  unit: z.string().optional(),\n  resetsAt: isoTimestamp.optional(),\n})\nexport type QuotaWindow = z.infer<typeof quotaWindowSchema>\n\nexport const quotaCreditsSchema = z.object({\n  balanceUsd: z.number().optional(),\n  unlimited: z.boolean().optional(),\n  currency: z.string().min(1),\n})\nexport type QuotaCredits = z.infer<typeof quotaCreditsSchema>\n\nexport const quotaStatusSchema = z.object({\n  profileRef: z.string().min(1),\n  asOf: isoTimestamp,\n  basis: z.enum(QUOTA_BASES),\n  source: z.string().optional(),\n  windows: z.array(quotaWindowSchema),\n  credits: quotaCreditsSchema.optional(),\n})\nexport type QuotaStatus = z.infer<typeof quotaStatusSchema>\n\n/** The minimal auth-profile projection a reader needs. */\nexport interface QuotaProfile {\n  profileRef: string\n  endpoint: string\n  method: \"oauth-bearer\" | \"api-key\"\n  credentialRef?: string\n}\n\nexport interface QuotaReadContext {\n  signal?: AbortSignal\n  /** Resolve a profile's opaque credentialRef to a bearer secret. */\n  resolveCredential?(ref: string): Promise<string | undefined>\n  fetchImpl?: typeof fetch\n  now?: () => Date\n}\n\n/**\n * Reads quota for a profile. MUST NOT throw: any failure or unknown value\n * resolves to `undefined`. Never fabricates a figure.\n */\nexport interface QuotaReader {\n  readonly id: string\n  supports(profile: QuotaProfile): boolean\n  read(profile: QuotaProfile, ctx: QuotaReadContext): Promise<QuotaStatus | undefined>\n}\n","import type { QuotaBasis, QuotaCredits, QuotaStatus, QuotaWindow } from \"./types.js\"\nimport { quotaWindowSchema } from \"./types.js\"\n\n/** remainingPct from a used percentage, or undefined when it is not a finite 0-100 number. */\nexport function remainingPctFromUsed(usedPct: number | null | undefined): number | undefined {\n  if (usedPct === null || usedPct === undefined || !Number.isFinite(usedPct)) return undefined\n  if (usedPct < 0 || usedPct > 100) return undefined\n  return 100 - usedPct\n}\n\n/** remainingPct from remaining/limit counts, or undefined when limit is not a positive finite number. */\nexport function remainingPctFromCounts(\n  remaining: number | null | undefined,\n  limit: number | null | undefined,\n): number | undefined {\n  if (remaining === null || remaining === undefined || limit === null || limit === undefined) {\n    return undefined\n  }\n  if (!Number.isFinite(remaining) || !Number.isFinite(limit) || limit <= 0) return undefined\n  if (remaining < 0 || remaining > limit) return undefined\n  return (remaining / limit) * 100\n}\n\nexport interface BuildQuotaStatusInput {\n  profileRef: string\n  basis: QuotaBasis\n  source?: string\n  now?: () => Date\n  /** Candidate windows; any that fail validation are dropped, never repaired. */\n  windows?: readonly unknown[]\n  credits?: QuotaCredits\n}\n\n/**\n * Assemble a QuotaStatus. Invalid windows are omitted. Returns `undefined`\n * when there is nothing to report (no valid window and no credits).\n */\nexport function buildQuotaStatus(input: BuildQuotaStatusInput): QuotaStatus | undefined {\n  const windows: QuotaWindow[] = []\n  for (const candidate of input.windows ?? []) {\n    const parsed = quotaWindowSchema.safeParse(candidate)\n    if (parsed.success) windows.push(parsed.data)\n  }\n  if (windows.length === 0 && input.credits === undefined) return undefined\n  return {\n    profileRef: input.profileRef,\n    asOf: (input.now ?? (() => new Date()))().toISOString(),\n    basis: input.basis,\n    ...(input.source !== undefined ? { source: input.source } : {}),\n    windows,\n    ...(input.credits !== undefined ? { credits: input.credits } : {}),\n  }\n}\n","import type { QuotaProfile, QuotaReadContext, QuotaReader, QuotaStatus } from \"./types.js\"\n\n/** Identity helper that fixes the QuotaReader contract at definition time (AIP-43 handle). */\nexport function defineQuotaReader(reader: QuotaReader): QuotaReader {\n  return reader\n}\n\nexport class QuotaReaderRegistry {\n  private readonly readers = new Map<string, QuotaReader>()\n\n  register(reader: QuotaReader): this {\n    if (this.readers.has(reader.id)) {\n      throw new Error(`quota reader already registered: ${reader.id}`)\n    }\n    this.readers.set(reader.id, reader)\n    return this\n  }\n\n  list(): QuotaReader[] {\n    return [...this.readers.values()]\n  }\n\n  /** First registered reader that supports the profile, in registration order. */\n  find(profile: QuotaProfile): QuotaReader | undefined {\n    for (const reader of this.readers.values()) {\n      if (safeSupports(reader, profile)) return reader\n    }\n    return undefined\n  }\n\n  /** Read through the first supporting reader. Never throws; unknown -> undefined. */\n  async read(profile: QuotaProfile, ctx: QuotaReadContext = {}): Promise<QuotaStatus | undefined> {\n    const reader = this.find(profile)\n    if (!reader) return undefined\n    try {\n      return await reader.read(profile, ctx)\n    } catch {\n      return undefined\n    }\n  }\n}\n\nfunction safeSupports(reader: QuotaReader, profile: QuotaProfile): boolean {\n  try {\n    return reader.supports(profile)\n  } catch {\n    return false\n  }\n}\n","import { buildQuotaStatus, remainingPctFromCounts } from \"../build.js\"\nimport type { QuotaStatus } from \"../types.js\"\n\nexport interface AnthropicHeadersInput {\n  profileRef: string\n  headers: Headers | Record<string, string | undefined>\n  now?: () => Date\n}\n\ninterface Dimension {\n  id: string\n  header: string\n  unit: string\n}\n\nconst DIMENSIONS: readonly Dimension[] = [\n  { id: \"requests-1m\", header: \"requests\", unit: \"requests\" },\n  { id: \"tokens-1m\", header: \"tokens\", unit: \"tokens\" },\n  { id: \"input-tokens-1m\", header: \"input-tokens\", unit: \"tokens\" },\n  { id: \"output-tokens-1m\", header: \"output-tokens\", unit: \"tokens\" },\n]\n\n/** Read a header case-insensitively from a `Headers` or a plain record. */\nfunction headerGet(\n  headers: Headers | Record<string, string | undefined>,\n  name: string,\n): string | undefined {\n  if (headers instanceof Headers) {\n    return headers.get(name) ?? undefined\n  }\n  const lower = name.toLowerCase()\n  for (const [key, value] of Object.entries(headers)) {\n    if (key.toLowerCase() === lower) return value\n  }\n  return undefined\n}\n\n/** Parse a numeric rate-limit header; empty/garbage → undefined. */\nfunction parseCount(raw: string | undefined): number | undefined {\n  if (raw === undefined) return undefined\n  const trimmed = raw.trim()\n  if (!trimmed) return undefined\n  const n = Number(trimmed)\n  return Number.isFinite(n) ? n : undefined\n}\n\n/** Normalize an RFC 3339 reset header to an ISO string; unparseable → undefined. */\nfunction parseReset(raw: string | undefined): string | undefined {\n  if (raw === undefined) return undefined\n  const trimmed = raw.trim()\n  if (!trimmed) return undefined\n  const date = new Date(trimmed)\n  return Number.isNaN(date.getTime()) ? undefined : date.toISOString()\n}\n\n/**\n * PURE: build a QuotaStatus from Anthropic's DOCUMENTED rate-limit headers\n * `anthropic-ratelimit-{requests,tokens,input-tokens,output-tokens}-{limit,remaining,reset}`.\n * The undocumented `anthropic-ratelimit-unified-*` family is never read.\n * A dimension with a missing/non-numeric limit or remaining is skipped.\n */\nexport function quotaFromAnthropicHeaders(input: AnthropicHeadersInput): QuotaStatus | undefined {\n  const windows: Record<string, unknown>[] = []\n  for (const dimension of DIMENSIONS) {\n    const prefix = `anthropic-ratelimit-${dimension.header}`\n    const limit = parseCount(headerGet(input.headers, `${prefix}-limit`))\n    const remaining = parseCount(headerGet(input.headers, `${prefix}-remaining`))\n    if (limit === undefined || remaining === undefined) continue\n    const remainingPct = remainingPctFromCounts(remaining, limit)\n    if (remainingPct === undefined) continue\n    const resetsAt = parseReset(headerGet(input.headers, `${prefix}-reset`))\n    windows.push({\n      id: dimension.id,\n      remainingPct,\n      limit,\n      remaining,\n      unit: dimension.unit,\n      ...(resetsAt !== undefined ? { resetsAt } : {}),\n    })\n  }\n  return buildQuotaStatus({\n    profileRef: input.profileRef,\n    basis: \"provider\",\n    source: \"anthropic:ratelimit-headers\",\n    now: input.now,\n    windows,\n  })\n}\n","import { z } from \"zod\"\nimport { buildQuotaStatus, remainingPctFromCounts } from \"../build.js\"\nimport { defineQuotaReader } from \"../registry.js\"\nimport type { QuotaCredits, QuotaProfile, QuotaReadContext, QuotaReader, QuotaStatus, QuotaWindow } from \"../types.js\"\n\nconst DEFAULT_BASE_URL = \"https://openrouter.ai/api/v1\"\nconst DEFAULT_TIMEOUT_MS = 4000\n\nconst OPENROUTER_KEY_SCHEMA = z\n  .object({\n    data: z\n      .object({\n        limit: z.number().nullable().optional(),\n        limit_remaining: z.number().nullable().optional(),\n      })\n      .passthrough(),\n  })\n  .passthrough()\n\nexport interface OpenRouterQuotaReaderOptions {\n  baseUrl?: string\n  timeoutMs?: number\n}\n\n/** GET `${baseUrl}/key` and parse the body, never throwing. */\nasync function getKeyJson(\n  baseUrl: string,\n  secret: string,\n  ctx: QuotaReadContext,\n  timeoutMs: number,\n): Promise<unknown | undefined> {\n  const controller = new AbortController()\n  const timer = setTimeout(() => controller.abort(), timeoutMs)\n  const onAbort = () => controller.abort()\n  ctx.signal?.addEventListener(\"abort\", onAbort)\n  try {\n    const res = await (ctx.fetchImpl ?? fetch)(`${baseUrl}/key`, {\n      method: \"GET\",\n      headers: { authorization: `Bearer ${secret}` },\n      signal: controller.signal,\n    })\n    if (!res.ok) return undefined\n    return await res.json()\n  } catch {\n    return undefined\n  } finally {\n    clearTimeout(timer)\n    ctx.signal?.removeEventListener(\"abort\", onAbort)\n  }\n}\n\n/**\n * OpenRouter quota reader: `GET /key` exposes the key's USD cap and remaining\n * headroom. The whole read is wrapped so it never throws; an uncapped key\n * (`limit_remaining` null/absent) yields no window and no credits.\n */\nexport function createOpenRouterQuotaReader(opts?: OpenRouterQuotaReaderOptions): QuotaReader {\n  const baseUrl = opts?.baseUrl ?? DEFAULT_BASE_URL\n  const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS\n\n  return defineQuotaReader({\n    id: \"openrouter-key\",\n    supports: (profile: QuotaProfile): boolean =>\n      profile.endpoint === \"openrouter\" && profile.method === \"api-key\",\n    read: async (\n      profile: QuotaProfile,\n      ctx: QuotaReadContext,\n    ): Promise<QuotaStatus | undefined> => {\n      try {\n        if (!profile.credentialRef) return undefined\n        if (!ctx.resolveCredential) return undefined\n        const secret = await ctx.resolveCredential(profile.credentialRef).catch(() => undefined)\n        if (!secret) return undefined\n\n        const body = await getKeyJson(baseUrl, secret, ctx, timeoutMs)\n        if (body === undefined) return undefined\n        const parsed = OPENROUTER_KEY_SCHEMA.safeParse(body)\n        if (!parsed.success) return undefined\n\n        const { limit, limit_remaining } = parsed.data.data\n        const windows: QuotaWindow[] = []\n        if (\n          typeof limit === \"number\" &&\n          Number.isFinite(limit) &&\n          typeof limit_remaining === \"number\" &&\n          Number.isFinite(limit_remaining)\n        ) {\n          const remainingPct = remainingPctFromCounts(limit_remaining, limit)\n          if (remainingPct !== undefined) {\n            windows.push({\n              id: \"key_limit\",\n              remainingPct,\n              remaining: limit_remaining,\n              limit,\n              unit: \"USD\",\n            })\n          }\n        }\n        let credits: QuotaCredits | undefined\n        if (typeof limit_remaining === \"number\" && Number.isFinite(limit_remaining)) {\n          credits = { balanceUsd: limit_remaining, currency: \"USD\" }\n        }\n\n        return buildQuotaStatus({\n          profileRef: profile.profileRef,\n          basis: \"provider\",\n          source: \"openrouter:/key\",\n          now: ctx.now,\n          windows,\n          ...(credits !== undefined ? { credits } : {}),\n        })\n      } catch {\n        return undefined\n      }\n    },\n  })\n}\n","/**\n * @agentproto/model-intel — model intelligence primitives.\n *\n * Unified, provider-neutral quota status (AIP-67): one QuotaStatus shape with a\n * mandatory `basis`, a never-throw QuotaReader contract, and a reader registry.\n * Unknown is omitted, never fabricated.\n *\n * @see https://agentproto.sh/docs/aip-67\n */\n\nexport const SPEC_NAME = \"quota/v1\" as const\nexport const SPEC_VERSION = \"1.0.0-alpha\" as const\n\nexport {\n  QUOTA_BASES,\n  quotaCreditsSchema,\n  quotaStatusSchema,\n  quotaWindowSchema,\n} from \"./types.js\"\nexport type {\n  QuotaBasis,\n  QuotaCredits,\n  QuotaProfile,\n  QuotaReadContext,\n  QuotaReader,\n  QuotaStatus,\n  QuotaWindow,\n} from \"./types.js\"\nexport {\n  buildQuotaStatus,\n  remainingPctFromCounts,\n  remainingPctFromUsed,\n} from \"./build.js\"\nexport type { BuildQuotaStatusInput } from \"./build.js\"\nexport { QuotaReaderRegistry, defineQuotaReader } from \"./registry.js\"\nexport { quotaFromAnthropicHeaders } from \"./readers/anthropic.js\"\nexport { createOpenRouterQuotaReader } from \"./readers/openrouter.js\"\n"]}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@agentproto/model-intel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "@agentproto/model-intel — model intelligence primitives. Unified, provider-neutral quota status (AIP-67): a QuotaStatus shape with a mandatory basis, a never-throw QuotaReader contract, and a reader registry. Unknown is omitted, never fabricated.",
+  "keywords": [
+    "agentproto",
+    "aip-67",
+    "quota",
+    "model-intel",
+    "llm",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-67",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/model-intel"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.9",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7",
+    "@agentproto/tooling": "0.1.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }