@omnicross/subscriptions 0.1.4 → 0.1.6

package/dist/index.d.cts

@@ -80,13 +80,11 @@ interface SubscriptionCredentialStore {
  *     → sort by `priority` asc → effective `lastUsedAt` asc (LRU) → `createdAt` asc
  *     → `[0]`.
  *
- * A faithful port of CRS `sortAccountsByPriority` + `unifiedClaudeScheduler`
- * session mapping. The class holds process-lived state — the affinity map and an
- * in-memory `lastUsedAt` overlay (the authoritative live tie-break value, seeded
- * from the persisted field and advanced to `now` on each selection so repeated
- * selections round-robin fairly even before any durable persist). ONE instance is
- * constructed at bootstrap and SHARED by all three auth strategies (each scopes
- * its calls by `providerId`), mirroring the single long-lived CRS scheduler.
+ * The class holds process-lived state: a session-affinity map and an in-memory
+ * `lastUsedAt` overlay. The overlay is seeded from persisted state and advanced
+ * to `now` on each selection, so repeated selections rotate fairly even before
+ * durable persistence. One instance is constructed at bootstrap and shared by
+ * all three auth strategies, with every call scoped by `providerId`.
  *
  * ZERO-REGRESSION CARRIER: `select()` returns `null` when the schedulable account
  * count is ≤ 1. Callers treat `null` (and an `isActive` result) as "use the
@@ -96,15 +94,17 @@ interface SubscriptionCredentialStore {
  * @module scheduler/SubscriptionAccountSelector
  */
 
-/** Sticky session→account affinity TTL (CRS parity: 1 hour). */
+/** Sticky session→account affinity TTL (1 hour). */
 declare const SESSION_AFFINITY_TTL_MS = 3600000;
 /** Min gap between best-effort `lastUsedAt` durable persists, per account. */
 declare const LAST_USED_PERSIST_THROTTLE_MS = 60000;
-/** Precedence assumed for an account with no `priority` (CRS `|| 50`). */
+/** Precedence assumed for an account with no explicit `priority`. */
 declare const DEFAULT_ACCOUNT_PRIORITY = 50;
 /** One schedulable candidate — the scheduling projection of an account entry. */
 interface SchedulableAccount {
     id: string;
+    /** Operator-defined pool group used by resource-level gateway bindings. */
+    group?: string;
     /** Default `50` (lower = higher precedence). */
     priority?: number;
     /** ISO — LRU tie-break; absent ⇒ treated as least-recently-used (`0`). */
@@ -226,9 +226,9 @@ declare class SubscriptionProviderRegistry {
      * process singleton, built here and captured by the opencodego profile's
      * `nextFallback` (consult) + `recordModelOutcome` (record) closures. Because
      * the `SubscriptionProviderRegistry` is itself a process singleton (via
-     * `setSubscriptionProviderRegistry`), breaker state persists across requests —
-     * exactly the reference's long-lived `FallbackHandler`. Constructed with the
-     * default reference thresholds (3 / 30s / 3) and the default `Date.now` clock.
+     * `setSubscriptionProviderRegistry`), breaker state persists across requests.
+     * Constructed with the production thresholds (3 / 30s / 3) and the default
+     * `Date.now` clock.
      */
     private readonly breaker;
     constructor(accounts: SubscriptionAccountService, tokens: SubscriptionCredentialStore);

package/dist/index.d.ts

@@ -80,13 +80,11 @@ interface SubscriptionCredentialStore {
  *     → sort by `priority` asc → effective `lastUsedAt` asc (LRU) → `createdAt` asc
  *     → `[0]`.
  *
- * A faithful port of CRS `sortAccountsByPriority` + `unifiedClaudeScheduler`
- * session mapping. The class holds process-lived state — the affinity map and an
- * in-memory `lastUsedAt` overlay (the authoritative live tie-break value, seeded
- * from the persisted field and advanced to `now` on each selection so repeated
- * selections round-robin fairly even before any durable persist). ONE instance is
- * constructed at bootstrap and SHARED by all three auth strategies (each scopes
- * its calls by `providerId`), mirroring the single long-lived CRS scheduler.
+ * The class holds process-lived state: a session-affinity map and an in-memory
+ * `lastUsedAt` overlay. The overlay is seeded from persisted state and advanced
+ * to `now` on each selection, so repeated selections rotate fairly even before
+ * durable persistence. One instance is constructed at bootstrap and shared by
+ * all three auth strategies, with every call scoped by `providerId`.
  *
  * ZERO-REGRESSION CARRIER: `select()` returns `null` when the schedulable account
  * count is ≤ 1. Callers treat `null` (and an `isActive` result) as "use the
@@ -96,15 +94,17 @@ interface SubscriptionCredentialStore {
  * @module scheduler/SubscriptionAccountSelector
  */
 
-/** Sticky session→account affinity TTL (CRS parity: 1 hour). */
+/** Sticky session→account affinity TTL (1 hour). */
 declare const SESSION_AFFINITY_TTL_MS = 3600000;
 /** Min gap between best-effort `lastUsedAt` durable persists, per account. */
 declare const LAST_USED_PERSIST_THROTTLE_MS = 60000;
-/** Precedence assumed for an account with no `priority` (CRS `|| 50`). */
+/** Precedence assumed for an account with no explicit `priority`. */
 declare const DEFAULT_ACCOUNT_PRIORITY = 50;
 /** One schedulable candidate — the scheduling projection of an account entry. */
 interface SchedulableAccount {
     id: string;
+    /** Operator-defined pool group used by resource-level gateway bindings. */
+    group?: string;
     /** Default `50` (lower = higher precedence). */
     priority?: number;
     /** ISO — LRU tie-break; absent ⇒ treated as least-recently-used (`0`). */
@@ -226,9 +226,9 @@ declare class SubscriptionProviderRegistry {
      * process singleton, built here and captured by the opencodego profile's
      * `nextFallback` (consult) + `recordModelOutcome` (record) closures. Because
      * the `SubscriptionProviderRegistry` is itself a process singleton (via
-     * `setSubscriptionProviderRegistry`), breaker state persists across requests —
-     * exactly the reference's long-lived `FallbackHandler`. Constructed with the
-     * default reference thresholds (3 / 30s / 3) and the default `Date.now` clock.
+     * `setSubscriptionProviderRegistry`), breaker state persists across requests.
+     * Constructed with the production thresholds (3 / 30s / 3) and the default
+     * `Date.now` clock.
      */
     private readonly breaker;
     constructor(accounts: SubscriptionAccountService, tokens: SubscriptionCredentialStore);