@framers/agentos 0.1.194 → 0.1.195

package/dist/core/providers/ApiKeyPoolRegistry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module core/providers/ApiKeyPoolRegistry
+ *
+ * Singleton registry for API key pools keyed by environment variable name.
+ * Providers that share the same env var (e.g., all ElevenLabs providers
+ * share ELEVENLABS_API_KEY) get the same pool instance so exhaustion
+ * state is consistent across the process.
+ */
+import { ApiKeyPool, type ApiKeyPoolConfig } from './ApiKeyPool.js';
+/**
+ * Get or create an ApiKeyPool for the given environment variable.
+ * Returns a singleton -- the same pool is returned on subsequent calls
+ * with the same env var name.
+ */
+export declare function getKeyPool(envVar: string, config?: ApiKeyPoolConfig): ApiKeyPool;
+/** Reset all pools. For testing only. */
+export declare function resetAllPools(): void;
+//# sourceMappingURL=ApiKeyPoolRegistry.d.ts.map

package/dist/core/providers/ApiKeyPoolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiKeyPoolRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/providers/ApiKeyPoolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIpE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAOhF;AAED,yCAAyC;AACzC,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/core/providers/ApiKeyPoolRegistry.js

@@ -0,0 +1,28 @@
+/**
+ * @module core/providers/ApiKeyPoolRegistry
+ *
+ * Singleton registry for API key pools keyed by environment variable name.
+ * Providers that share the same env var (e.g., all ElevenLabs providers
+ * share ELEVENLABS_API_KEY) get the same pool instance so exhaustion
+ * state is consistent across the process.
+ */
+import { ApiKeyPool } from './ApiKeyPool.js';
+const pools = new Map();
+/**
+ * Get or create an ApiKeyPool for the given environment variable.
+ * Returns a singleton -- the same pool is returned on subsequent calls
+ * with the same env var name.
+ */
+export function getKeyPool(envVar, config) {
+    let pool = pools.get(envVar);
+    if (!pool) {
+        pool = new ApiKeyPool(process.env[envVar] ?? '', config);
+        pools.set(envVar, pool);
+    }
+    return pool;
+}
+/** Reset all pools. For testing only. */
+export function resetAllPools() {
+    pools.clear();
+}
+//# sourceMappingURL=ApiKeyPoolRegistry.js.map

package/dist/core/providers/ApiKeyPoolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiKeyPoolRegistry.js","sourceRoot":"","sources":["../../../src/core/providers/ApiKeyPoolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAyB,MAAM,iBAAiB,CAAC;AAEpE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,MAAyB;IAClE,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QACzD,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,aAAa;IAC3B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/core/providers/index.d.ts

@@ -0,0 +1,4 @@
+export { ApiKeyPool, type ApiKeyPoolConfig } from './ApiKeyPool.js';
+export { getKeyPool, resetAllPools } from './ApiKeyPoolRegistry.js';
+export { isQuotaError } from './quotaErrors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/providers/index.js

@@ -0,0 +1,4 @@
+export { ApiKeyPool } from './ApiKeyPool.js';
+export { getKeyPool, resetAllPools } from './ApiKeyPoolRegistry.js';
+export { isQuotaError } from './quotaErrors.js';
+//# sourceMappingURL=index.js.map

package/dist/core/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/providers/quotaErrors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module core/providers/quotaErrors
+ *
+ * Detects quota-exhaustion and rate-limit errors across all provider APIs.
+ * Used by providers to decide when to rotate to the next API key.
+ */
+/**
+ * Check if an HTTP error response indicates quota exhaustion or rate limiting.
+ *
+ * @param status - HTTP status code from the response.
+ * @param body - Response body text (can be empty).
+ * @returns `true` if this looks like a quota/rate-limit error.
+ */
+export declare function isQuotaError(status: number, body: string): boolean;
+//# sourceMappingURL=quotaErrors.d.ts.map

package/dist/core/providers/quotaErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quotaErrors.d.ts","sourceRoot":"","sources":["../../../src/core/providers/quotaErrors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKlE"}

package/dist/core/providers/quotaErrors.js

@@ -0,0 +1,33 @@
+/**
+ * @module core/providers/quotaErrors
+ *
+ * Detects quota-exhaustion and rate-limit errors across all provider APIs.
+ * Used by providers to decide when to rotate to the next API key.
+ */
+/** Status codes that always indicate quota/rate-limit exhaustion. */
+const QUOTA_STATUS_CODES = new Set([429, 402, 456]);
+/** Substrings in response bodies that indicate quota exhaustion. */
+const QUOTA_BODY_SIGNALS = [
+    'quota_exceeded',
+    'rate_limit_exceeded',
+    'insufficient_quota',
+    'overloaded_error',
+    'resource_exhausted',
+    'rate_limit',
+];
+/**
+ * Check if an HTTP error response indicates quota exhaustion or rate limiting.
+ *
+ * @param status - HTTP status code from the response.
+ * @param body - Response body text (can be empty).
+ * @returns `true` if this looks like a quota/rate-limit error.
+ */
+export function isQuotaError(status, body) {
+    if (QUOTA_STATUS_CODES.has(status))
+        return true;
+    if (!body)
+        return false;
+    const lower = body.toLowerCase();
+    return QUOTA_BODY_SIGNALS.some((signal) => lower.includes(signal));
+}
+//# sourceMappingURL=quotaErrors.js.map

package/dist/core/providers/quotaErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quotaErrors.js","sourceRoot":"","sources":["../../../src/core/providers/quotaErrors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qEAAqE;AACrE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEpD,oEAAoE;AACpE,MAAM,kBAAkB,GAAG;IACzB,gBAAgB;IAChB,qBAAqB;IACrB,oBAAoB;IACpB,kBAAkB;IAClB,oBAAoB;IACpB,YAAY;CACb,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY;IACvD,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.194",
+  "version": "0.1.195",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",