@cortexkit/anthropic-auth-core 2.4.8 → 2.4.9

package/dist/internal-types/quota/format.d.ts

@@ -30,6 +30,8 @@ export interface QuotaTextOptions {
 }
 export interface QuotaWindowPart {
     kind: 'window' | 'budget';
+    /** Unknown windows have no dated percentage; budgets retain their own wording. */
+    reading: 'known' | 'unknown';
     /** The display name of a quota window, or `credits` for the budget. */
     name: string;
     /**
@@ -45,7 +47,8 @@ export interface QuotaWindowPart {
     remainingPercent?: number;
     /** A bare relative reset span such as `4d`, only when the reset is future. */
     resetIn?: string;
-    checkedAt: number;
+    /** The reading time, omitted for a window with no reading. */
+    checkedAt?: number;
     /** Whether the reset followed this reading and has arrived by `now`. */
     resetSinceReading: boolean;
 }
@@ -64,9 +67,11 @@ export interface QuotaParts {
  */
 export declare function quotaWindowName(limit: Pick<ProjectedLimit, 'scope' | 'label' | 'windowMinutes'>): string;
 /**
- * Structured quota wording for layouts that need one row per window. The
- * windows use the same filtering and order as `quotaTextParts`; future resets
- * and the optional age keep the shared formatter's wording.
+ * Structured quota wording for layouts that need one row per window.
+ * Windows without a dated percentage remain as explicit unknown parts. Limits
+ * marked absent (not reported) or retired (no longer tracked) remain omitted.
+ * Reported windows, future resets and the optional age keep the shared
+ * formatter's wording and order.
  */
 export declare function quotaWindowParts(quota: ProjectedQuota | undefined, options: QuotaTextOptions): QuotaParts;
 /**

package/dist/internal-types/routing-accessor/index.d.ts

@@ -0,0 +1,62 @@
+/** An eligible vault route, not a local pool row. */
+export interface RoutingCandidate {
+    /** Vault account id, not the plugin's route id. */
+    accountId: string;
+    credentialId: string;
+}
+export interface AskRoutingInput<Candidate extends RoutingCandidate = RoutingCandidate> {
+    sessionId: string;
+    provider: string;
+    modelId: string;
+    /** Only routes already eligible under the plugin's vault and killswitch rules. */
+    candidates: readonly Candidate[];
+    /** Defaults to 500 ms, clamped to 1–2000 ms. */
+    deadlineMs?: number;
+}
+export interface RoutingHold {
+    /** Uncapped advice from routing. The plugin must apply its own hold cap. */
+    retry_after_ms: number;
+}
+export interface RoutingSelection<Candidate extends RoutingCandidate = RoutingCandidate> {
+    /** The original eligible candidate, including any plugin-specific metadata. */
+    candidate: Candidate;
+    hold?: RoutingHold;
+}
+interface RoutingReportIdentity {
+    sessionId: string;
+    accountId: string;
+    credentialId?: string;
+}
+export type ReportRoutingInput = RoutingReportIdentity & ({
+    outcome: 'served';
+    /**
+     * Pass only rate-limit headers, never the whole response headers.
+     * Values are forwarded unchanged; do not include tokens, emails or labels.
+     */
+    headers: Readonly<Record<string, string>>;
+} | {
+    outcome: 'exhausted';
+    /** The exhausted quota window; keep scoped quota groups in `pool`. */
+    window: '5h' | '7d';
+    /**
+     * Scoped quota group, such as `non-gemini`.
+     * Must be a non-empty string without `:`. Omit to block the whole
+     * account; include to block only this pool.
+     */
+    pool?: string;
+    /** Optional reset time in epoch milliseconds. */
+    resetsAt?: number;
+});
+/**
+ * Ask routing for an eligible vault route. Any failure or unfamiliar answer
+ * yields undefined so the plugin can keep its own choice. This does not admit
+ * routes: callers must exclude vault refusals and killswitch-blocked accounts.
+ */
+export declare function askRouting<Candidate extends RoutingCandidate>(input: AskRoutingInput<Candidate>): Promise<RoutingSelection<Candidate> | undefined>;
+/**
+ * Report a vault request without waiting for routing. Only contract fields are
+ * sent, and all accessor failures are ignored. Headers must already be limited
+ * to rate-limit headers by the caller; values are not filtered or redacted here.
+ */
+export declare function reportRouting(input: ReportRoutingInput): void;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/anthropic-auth-core",
-  "version": "2.4.8",
+  "version": "2.4.9",
   "type": "module",
   "repository": {
     "type": "git",
@@ -30,7 +30,7 @@
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@cortexkit/common-auth": "0.32.1"
+    "@cortexkit/common-auth": "0.33.0"
   },
   "dependencies": {
     "@cortexkit/claustrum-client": "0.13.0",