adonis-ai-kit 0.0.0-stage → 1.2.0
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.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +397 -2
- package/dist/commands/ai_test.d.ts +12 -0
- package/dist/commands/ai_test.d.ts.map +1 -0
- package/dist/commands/ai_test.js +98 -0
- package/dist/commands/ai_test.js.map +1 -0
- package/dist/commands/main.d.ts +14 -0
- package/dist/commands/main.d.ts.map +1 -0
- package/dist/commands/main.js +31 -0
- package/dist/commands/main.js.map +1 -0
- package/dist/commands/make_agent.d.ts +13 -0
- package/dist/commands/make_agent.d.ts.map +1 -0
- package/dist/commands/make_agent.js +116 -0
- package/dist/commands/make_agent.js.map +1 -0
- package/dist/providers/ai_provider.d.ts +23 -0
- package/dist/providers/ai_provider.d.ts.map +1 -0
- package/dist/providers/ai_provider.js +34 -0
- package/dist/providers/ai_provider.js.map +1 -0
- package/dist/services/main.d.ts +4 -0
- package/dist/services/main.d.ts.map +1 -0
- package/dist/services/main.js +7 -0
- package/dist/services/main.js.map +1 -0
- package/dist/src/acp/acp_agents.d.ts +89 -0
- package/dist/src/acp/acp_agents.d.ts.map +1 -0
- package/dist/src/acp/acp_agents.js +367 -0
- package/dist/src/acp/acp_agents.js.map +1 -0
- package/dist/src/acp/index.d.ts +4 -0
- package/dist/src/acp/index.d.ts.map +1 -0
- package/dist/src/acp/index.js +4 -0
- package/dist/src/acp/index.js.map +1 -0
- package/dist/src/acp/provider.d.ts +74 -0
- package/dist/src/acp/provider.d.ts.map +1 -0
- package/dist/src/acp/provider.js +276 -0
- package/dist/src/acp/provider.js.map +1 -0
- package/dist/src/acp/types.d.ts +128 -0
- package/dist/src/acp/types.d.ts.map +1 -0
- package/dist/src/acp/types.js +2 -0
- package/dist/src/acp/types.js.map +1 -0
- package/dist/src/agents/agent_runner.d.ts +60 -0
- package/dist/src/agents/agent_runner.d.ts.map +1 -0
- package/dist/src/agents/agent_runner.js +134 -0
- package/dist/src/agents/agent_runner.js.map +1 -0
- package/dist/src/agents/index.d.ts +4 -0
- package/dist/src/agents/index.d.ts.map +1 -0
- package/dist/src/agents/index.js +4 -0
- package/dist/src/agents/index.js.map +1 -0
- package/dist/src/agents/loader.d.ts +56 -0
- package/dist/src/agents/loader.d.ts.map +1 -0
- package/dist/src/agents/loader.js +184 -0
- package/dist/src/agents/loader.js.map +1 -0
- package/dist/src/agents/manifest.d.ts +61 -0
- package/dist/src/agents/manifest.d.ts.map +1 -0
- package/dist/src/agents/manifest.js +35 -0
- package/dist/src/agents/manifest.js.map +1 -0
- package/dist/src/ai_manager.d.ts +140 -0
- package/dist/src/ai_manager.d.ts.map +1 -0
- package/dist/src/ai_manager.js +814 -0
- package/dist/src/ai_manager.js.map +1 -0
- package/dist/src/budget/budget_allocator.d.ts +37 -0
- package/dist/src/budget/budget_allocator.d.ts.map +1 -0
- package/dist/src/budget/budget_allocator.js +98 -0
- package/dist/src/budget/budget_allocator.js.map +1 -0
- package/dist/src/budget/budget_enforcer.d.ts +70 -0
- package/dist/src/budget/budget_enforcer.d.ts.map +1 -0
- package/dist/src/budget/budget_enforcer.js +195 -0
- package/dist/src/budget/budget_enforcer.js.map +1 -0
- package/dist/src/budget/cost_tracker.d.ts +71 -0
- package/dist/src/budget/cost_tracker.d.ts.map +1 -0
- package/dist/src/budget/cost_tracker.js +199 -0
- package/dist/src/budget/cost_tracker.js.map +1 -0
- package/dist/src/budget/index.d.ts +6 -0
- package/dist/src/budget/index.d.ts.map +1 -0
- package/dist/src/budget/index.js +6 -0
- package/dist/src/budget/index.js.map +1 -0
- package/dist/src/budget/pricing.d.ts +35 -0
- package/dist/src/budget/pricing.d.ts.map +1 -0
- package/dist/src/budget/pricing.js +129 -0
- package/dist/src/budget/pricing.js.map +1 -0
- package/dist/src/budget/types.d.ts +86 -0
- package/dist/src/budget/types.d.ts.map +1 -0
- package/dist/src/budget/types.js +2 -0
- package/dist/src/budget/types.js.map +1 -0
- package/dist/src/catalog/index.d.ts +3 -0
- package/dist/src/catalog/index.d.ts.map +1 -0
- package/dist/src/catalog/index.js +3 -0
- package/dist/src/catalog/index.js.map +1 -0
- package/dist/src/catalog/models_dev.d.ts +87 -0
- package/dist/src/catalog/models_dev.d.ts.map +1 -0
- package/dist/src/catalog/models_dev.js +38 -0
- package/dist/src/catalog/models_dev.js.map +1 -0
- package/dist/src/catalog/source.d.ts +67 -0
- package/dist/src/catalog/source.d.ts.map +1 -0
- package/dist/src/catalog/source.js +678 -0
- package/dist/src/catalog/source.js.map +1 -0
- package/dist/src/circuit_breaker.d.ts +61 -0
- package/dist/src/circuit_breaker.d.ts.map +1 -0
- package/dist/src/circuit_breaker.js +217 -0
- package/dist/src/circuit_breaker.js.map +1 -0
- package/dist/src/define_config.d.ts +11 -0
- package/dist/src/define_config.d.ts.map +1 -0
- package/dist/src/define_config.js +48 -0
- package/dist/src/define_config.js.map +1 -0
- package/dist/src/error_classifier.d.ts +50 -0
- package/dist/src/error_classifier.d.ts.map +1 -0
- package/dist/src/error_classifier.js +206 -0
- package/dist/src/error_classifier.js.map +1 -0
- package/dist/src/errors.d.ts +52 -0
- package/dist/src/errors.d.ts.map +1 -0
- package/dist/src/errors.js +70 -0
- package/dist/src/errors.js.map +1 -0
- package/dist/src/guard/confirmation.d.ts +67 -0
- package/dist/src/guard/confirmation.d.ts.map +1 -0
- package/dist/src/guard/confirmation.js +180 -0
- package/dist/src/guard/confirmation.js.map +1 -0
- package/dist/src/guard/errors.d.ts +10 -0
- package/dist/src/guard/errors.d.ts.map +1 -0
- package/dist/src/guard/errors.js +14 -0
- package/dist/src/guard/errors.js.map +1 -0
- package/dist/src/guard/guard.d.ts +47 -0
- package/dist/src/guard/guard.d.ts.map +1 -0
- package/dist/src/guard/guard.js +133 -0
- package/dist/src/guard/guard.js.map +1 -0
- package/dist/src/guard/index.d.ts +7 -0
- package/dist/src/guard/index.d.ts.map +1 -0
- package/dist/src/guard/index.js +7 -0
- package/dist/src/guard/index.js.map +1 -0
- package/dist/src/guard/registry.d.ts +72 -0
- package/dist/src/guard/registry.d.ts.map +1 -0
- package/dist/src/guard/registry.js +192 -0
- package/dist/src/guard/registry.js.map +1 -0
- package/dist/src/guard/schema_registry.d.ts +37 -0
- package/dist/src/guard/schema_registry.d.ts.map +1 -0
- package/dist/src/guard/schema_registry.js +57 -0
- package/dist/src/guard/schema_registry.js.map +1 -0
- package/dist/src/guard/types.d.ts +63 -0
- package/dist/src/guard/types.d.ts.map +1 -0
- package/dist/src/guard/types.js +2 -0
- package/dist/src/guard/types.js.map +1 -0
- package/dist/src/index.d.ts +16 -0
- package/dist/src/index.d.ts.map +1 -0
- package/dist/src/index.js +14 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/logger.d.ts +7 -0
- package/dist/src/logger.d.ts.map +1 -0
- package/dist/src/logger.js +2 -0
- package/dist/src/logger.js.map +1 -0
- package/dist/src/models/catalog_resolver.d.ts +24 -0
- package/dist/src/models/catalog_resolver.d.ts.map +1 -0
- package/dist/src/models/catalog_resolver.js +66 -0
- package/dist/src/models/catalog_resolver.js.map +1 -0
- package/dist/src/models/index.d.ts +14 -0
- package/dist/src/models/index.d.ts.map +1 -0
- package/dist/src/models/index.js +8 -0
- package/dist/src/models/index.js.map +1 -0
- package/dist/src/models/keys.d.ts +9 -0
- package/dist/src/models/keys.d.ts.map +1 -0
- package/dist/src/models/keys.js +12 -0
- package/dist/src/models/keys.js.map +1 -0
- package/dist/src/models/language_model_factory.d.ts +44 -0
- package/dist/src/models/language_model_factory.d.ts.map +1 -0
- package/dist/src/models/language_model_factory.js +193 -0
- package/dist/src/models/language_model_factory.js.map +1 -0
- package/dist/src/models/model_chain.d.ts +58 -0
- package/dist/src/models/model_chain.d.ts.map +1 -0
- package/dist/src/models/model_chain.js +144 -0
- package/dist/src/models/model_chain.js.map +1 -0
- package/dist/src/models/model_ref.d.ts +12 -0
- package/dist/src/models/model_ref.d.ts.map +1 -0
- package/dist/src/models/model_ref.js +33 -0
- package/dist/src/models/model_ref.js.map +1 -0
- package/dist/src/models/protocols.d.ts +6 -0
- package/dist/src/models/protocols.d.ts.map +1 -0
- package/dist/src/models/protocols.js +33 -0
- package/dist/src/models/protocols.js.map +1 -0
- package/dist/src/models/provider_factories.d.ts +19 -0
- package/dist/src/models/provider_factories.d.ts.map +1 -0
- package/dist/src/models/provider_factories.js +70 -0
- package/dist/src/models/provider_factories.js.map +1 -0
- package/dist/src/models/types.d.ts +17 -0
- package/dist/src/models/types.d.ts.map +1 -0
- package/dist/src/models/types.js +2 -0
- package/dist/src/models/types.js.map +1 -0
- package/dist/src/response_macro.d.ts +16 -0
- package/dist/src/response_macro.d.ts.map +1 -0
- package/dist/src/response_macro.js +151 -0
- package/dist/src/response_macro.js.map +1 -0
- package/dist/src/types.d.ts +340 -0
- package/dist/src/types.d.ts.map +1 -0
- package/dist/src/types.js +2 -0
- package/dist/src/types.js.map +1 -0
- package/dist/src/usage.d.ts +13 -0
- package/dist/src/usage.d.ts.map +1 -0
- package/dist/src/usage.js +61 -0
- package/dist/src/usage.js.map +1 -0
- package/package.json +208 -4
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/catalog/source.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import type { CircuitBreakerConfig, CircuitBreakerState, CircuitBreakerStats } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* A reservation obtained from `CircuitBreaker.acquire()`. It settles exactly once: after the first
|
|
4
|
+
* `success()`, `failure()` or `release()`, further calls do nothing.
|
|
5
|
+
*/
|
|
6
|
+
export interface BreakerPermit {
|
|
7
|
+
readonly key: string;
|
|
8
|
+
/** True when this permit occupies a half-open probe slot. */
|
|
9
|
+
readonly isProbe: boolean;
|
|
10
|
+
/** Records a success (`recordSuccess`) and frees the probe slot. */
|
|
11
|
+
success(): void;
|
|
12
|
+
/** Records a failure (`recordFailure`) and frees the probe slot. */
|
|
13
|
+
failure(error?: unknown): void;
|
|
14
|
+
/** Frees the probe slot without recording anything (the outcome does not count). */
|
|
15
|
+
release(): void;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Resilient Circuit Breaker to prevent cascading failures of upstream LLM APIs.
|
|
19
|
+
* Supports CLOSED, OPEN, and HALF_OPEN state transitions.
|
|
20
|
+
*
|
|
21
|
+
* State is tracked per breaker key. `AiManager` uses `provider:model`, so one misbehaving model
|
|
22
|
+
* does not take the whole provider down. A plain provider name works as a key too.
|
|
23
|
+
*/
|
|
24
|
+
export declare class CircuitBreaker {
|
|
25
|
+
private stats;
|
|
26
|
+
private failureThreshold;
|
|
27
|
+
private recoveryTimeoutMs;
|
|
28
|
+
private halfOpenMaxAttempts;
|
|
29
|
+
private halfOpenMaxConcurrent;
|
|
30
|
+
private onStateChange?;
|
|
31
|
+
constructor(config?: CircuitBreakerConfig);
|
|
32
|
+
private getOrInitStats;
|
|
33
|
+
getState(key: string): CircuitBreakerState;
|
|
34
|
+
/** Non-acquiring availability check (a half-open breaker is available while probe slots remain). */
|
|
35
|
+
isAvailable(key: string): boolean;
|
|
36
|
+
/**
|
|
37
|
+
* Synchronously reserves a call slot. Returns `null` when the breaker is open or every half-open
|
|
38
|
+
* probe slot is taken. Unlike `isAvailable()`, a half-open permit holds a probe slot until settled.
|
|
39
|
+
*/
|
|
40
|
+
acquire(key: string): BreakerPermit | null;
|
|
41
|
+
/**
|
|
42
|
+
* Runs `action` through the breaker.
|
|
43
|
+
*
|
|
44
|
+
* `isFailure` decides whether a thrown error counts against the breaker; errors that are the
|
|
45
|
+
* caller's fault (bad request, abort, validation) should not trip it.
|
|
46
|
+
*/
|
|
47
|
+
execute<T>(key: string, action: () => Promise<T>, isFailure?: (error: unknown) => boolean): Promise<T>;
|
|
48
|
+
recordSuccess(key: string): void;
|
|
49
|
+
recordFailure(key: string, _error?: unknown): void;
|
|
50
|
+
reset(key: string): void;
|
|
51
|
+
resetAll(): void;
|
|
52
|
+
getStats(key: string): CircuitBreakerStats;
|
|
53
|
+
getAllStats(): Record<string, CircuitBreakerStats>;
|
|
54
|
+
/**
|
|
55
|
+
* Moves to OPEN with a fresh counter set. All state is written BEFORE the user callback runs,
|
|
56
|
+
* so a throwing `onStateChange` can never leave the breaker without a cooldown deadline.
|
|
57
|
+
*/
|
|
58
|
+
private open;
|
|
59
|
+
private transition;
|
|
60
|
+
}
|
|
61
|
+
//# sourceMappingURL=circuit_breaker.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"circuit_breaker.d.ts","sourceRoot":"","sources":["../../src/circuit_breaker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAahG;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAAA;IACf,oEAAoE;IACpE,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9B,oFAAoF;IACpF,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,qBAAqB,CAAQ;IACrC,OAAO,CAAC,aAAa,CAAC,CAA2E;gBAErF,MAAM,GAAE,oBAAyB;IAQ7C,OAAO,CAAC,cAAc;IAiBtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAQ1C,oGAAoG;IACpG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IASjC;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAmC1C;;;;;OAKG;IACG,OAAO,CAAC,CAAC,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,SAAS,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAoB,GAClD,OAAO,CAAC,CAAC,CAAC;IA+Bb,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAgBhC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAclD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAYxB,QAAQ,IAAI,IAAI;IAIhB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAY1C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAIlD;;;OAGG;IACH,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,UAAU;CAmBnB"}
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
import { ProviderUnavailableError } from './errors.js';
|
|
2
|
+
/**
|
|
3
|
+
* Resilient Circuit Breaker to prevent cascading failures of upstream LLM APIs.
|
|
4
|
+
* Supports CLOSED, OPEN, and HALF_OPEN state transitions.
|
|
5
|
+
*
|
|
6
|
+
* State is tracked per breaker key. `AiManager` uses `provider:model`, so one misbehaving model
|
|
7
|
+
* does not take the whole provider down. A plain provider name works as a key too.
|
|
8
|
+
*/
|
|
9
|
+
export class CircuitBreaker {
|
|
10
|
+
stats = new Map();
|
|
11
|
+
failureThreshold;
|
|
12
|
+
recoveryTimeoutMs;
|
|
13
|
+
halfOpenMaxAttempts;
|
|
14
|
+
halfOpenMaxConcurrent;
|
|
15
|
+
onStateChange;
|
|
16
|
+
constructor(config = {}) {
|
|
17
|
+
this.failureThreshold = Math.max(1, config.failureThreshold ?? 5);
|
|
18
|
+
this.recoveryTimeoutMs = Math.max(0, config.recoveryTimeoutMs ?? 30_000);
|
|
19
|
+
this.halfOpenMaxAttempts = Math.max(1, config.halfOpenMaxAttempts ?? 2);
|
|
20
|
+
this.halfOpenMaxConcurrent = Math.max(1, config.halfOpenMaxConcurrent ?? 1);
|
|
21
|
+
this.onStateChange = config.onStateChange;
|
|
22
|
+
}
|
|
23
|
+
getOrInitStats(key) {
|
|
24
|
+
let s = this.stats.get(key);
|
|
25
|
+
if (!s) {
|
|
26
|
+
s = {
|
|
27
|
+
state: 'closed',
|
|
28
|
+
failures: 0,
|
|
29
|
+
successes: 0,
|
|
30
|
+
inFlightProbes: 0,
|
|
31
|
+
epoch: 0,
|
|
32
|
+
lastFailureTime: null,
|
|
33
|
+
nextAttemptAllowedAt: null,
|
|
34
|
+
};
|
|
35
|
+
this.stats.set(key, s);
|
|
36
|
+
}
|
|
37
|
+
return s;
|
|
38
|
+
}
|
|
39
|
+
getState(key) {
|
|
40
|
+
const s = this.getOrInitStats(key);
|
|
41
|
+
if (s.state === 'open' && s.nextAttemptAllowedAt !== null && Date.now() >= s.nextAttemptAllowedAt) {
|
|
42
|
+
this.transition(key, s, 'half_open');
|
|
43
|
+
}
|
|
44
|
+
return s.state;
|
|
45
|
+
}
|
|
46
|
+
/** Non-acquiring availability check (a half-open breaker is available while probe slots remain). */
|
|
47
|
+
isAvailable(key) {
|
|
48
|
+
const state = this.getState(key);
|
|
49
|
+
if (state === 'closed')
|
|
50
|
+
return true;
|
|
51
|
+
if (state === 'half_open') {
|
|
52
|
+
return this.getOrInitStats(key).inFlightProbes < this.halfOpenMaxConcurrent;
|
|
53
|
+
}
|
|
54
|
+
return false;
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Synchronously reserves a call slot. Returns `null` when the breaker is open or every half-open
|
|
58
|
+
* probe slot is taken. Unlike `isAvailable()`, a half-open permit holds a probe slot until settled.
|
|
59
|
+
*/
|
|
60
|
+
acquire(key) {
|
|
61
|
+
const s = this.getOrInitStats(key);
|
|
62
|
+
const state = this.getState(key);
|
|
63
|
+
if (state === 'open')
|
|
64
|
+
return null;
|
|
65
|
+
const isProbe = state === 'half_open';
|
|
66
|
+
if (isProbe) {
|
|
67
|
+
if (s.inFlightProbes >= this.halfOpenMaxConcurrent)
|
|
68
|
+
return null;
|
|
69
|
+
s.inFlightProbes++;
|
|
70
|
+
}
|
|
71
|
+
const epoch = s.epoch;
|
|
72
|
+
let settled = false;
|
|
73
|
+
const settle = () => {
|
|
74
|
+
if (settled)
|
|
75
|
+
return false;
|
|
76
|
+
settled = true;
|
|
77
|
+
if (isProbe && s.epoch === epoch)
|
|
78
|
+
s.inFlightProbes = Math.max(0, s.inFlightProbes - 1);
|
|
79
|
+
return true;
|
|
80
|
+
};
|
|
81
|
+
return {
|
|
82
|
+
key,
|
|
83
|
+
isProbe,
|
|
84
|
+
success: () => {
|
|
85
|
+
if (settle())
|
|
86
|
+
this.recordSuccess(key);
|
|
87
|
+
},
|
|
88
|
+
failure: (error) => {
|
|
89
|
+
if (settle())
|
|
90
|
+
this.recordFailure(key, error);
|
|
91
|
+
},
|
|
92
|
+
release: () => {
|
|
93
|
+
settle();
|
|
94
|
+
},
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Runs `action` through the breaker.
|
|
99
|
+
*
|
|
100
|
+
* `isFailure` decides whether a thrown error counts against the breaker; errors that are the
|
|
101
|
+
* caller's fault (bad request, abort, validation) should not trip it.
|
|
102
|
+
*/
|
|
103
|
+
async execute(key, action, isFailure = () => true) {
|
|
104
|
+
const permit = this.acquire(key);
|
|
105
|
+
if (!permit) {
|
|
106
|
+
if (this.getState(key) === 'open') {
|
|
107
|
+
const s = this.getOrInitStats(key);
|
|
108
|
+
const remainingMs = s.nextAttemptAllowedAt
|
|
109
|
+
? Math.max(0, s.nextAttemptAllowedAt - Date.now())
|
|
110
|
+
: this.recoveryTimeoutMs;
|
|
111
|
+
throw new ProviderUnavailableError(key, `Circuit breaker is OPEN. Cooldown remaining: ${Math.ceil(remainingMs / 1000)}s`);
|
|
112
|
+
}
|
|
113
|
+
throw new ProviderUnavailableError(key, 'Circuit breaker is HALF-OPEN and probe limit is reached');
|
|
114
|
+
}
|
|
115
|
+
try {
|
|
116
|
+
const result = await action();
|
|
117
|
+
permit.success();
|
|
118
|
+
return result;
|
|
119
|
+
}
|
|
120
|
+
catch (error) {
|
|
121
|
+
if (isFailure(error))
|
|
122
|
+
permit.failure(error);
|
|
123
|
+
else
|
|
124
|
+
permit.release();
|
|
125
|
+
throw error;
|
|
126
|
+
}
|
|
127
|
+
finally {
|
|
128
|
+
// Covers a throwing `isFailure`; a no-op once the permit has been settled.
|
|
129
|
+
permit.release();
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
recordSuccess(key) {
|
|
133
|
+
const s = this.getOrInitStats(key);
|
|
134
|
+
if (s.state === 'half_open') {
|
|
135
|
+
s.successes++;
|
|
136
|
+
if (s.successes >= this.halfOpenMaxAttempts) {
|
|
137
|
+
s.failures = 0;
|
|
138
|
+
s.successes = 0;
|
|
139
|
+
s.lastFailureTime = null;
|
|
140
|
+
s.nextAttemptAllowedAt = null;
|
|
141
|
+
this.transition(key, s, 'closed');
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
else if (s.state === 'closed') {
|
|
145
|
+
s.failures = 0;
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
recordFailure(key, _error) {
|
|
149
|
+
const s = this.getOrInitStats(key);
|
|
150
|
+
s.lastFailureTime = Date.now();
|
|
151
|
+
if (s.state === 'closed') {
|
|
152
|
+
s.failures++;
|
|
153
|
+
if (s.failures >= this.failureThreshold) {
|
|
154
|
+
this.open(key, s);
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
else if (s.state === 'half_open') {
|
|
158
|
+
this.open(key, s);
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
reset(key) {
|
|
162
|
+
const s = this.getOrInitStats(key);
|
|
163
|
+
const prev = s.state;
|
|
164
|
+
s.failures = 0;
|
|
165
|
+
s.successes = 0;
|
|
166
|
+
s.inFlightProbes = 0;
|
|
167
|
+
s.epoch++;
|
|
168
|
+
s.lastFailureTime = null;
|
|
169
|
+
s.nextAttemptAllowedAt = null;
|
|
170
|
+
this.transition(key, s, 'closed', prev);
|
|
171
|
+
}
|
|
172
|
+
resetAll() {
|
|
173
|
+
for (const key of [...this.stats.keys()])
|
|
174
|
+
this.reset(key);
|
|
175
|
+
}
|
|
176
|
+
getStats(key) {
|
|
177
|
+
const s = this.getOrInitStats(key);
|
|
178
|
+
const state = this.getState(key);
|
|
179
|
+
return {
|
|
180
|
+
state,
|
|
181
|
+
failures: s.failures,
|
|
182
|
+
successes: s.successes,
|
|
183
|
+
lastFailureTime: s.lastFailureTime,
|
|
184
|
+
nextAttemptAllowedAt: s.nextAttemptAllowedAt,
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
getAllStats() {
|
|
188
|
+
return Object.fromEntries([...this.stats.keys()].map((key) => [key, this.getStats(key)]));
|
|
189
|
+
}
|
|
190
|
+
/**
|
|
191
|
+
* Moves to OPEN with a fresh counter set. All state is written BEFORE the user callback runs,
|
|
192
|
+
* so a throwing `onStateChange` can never leave the breaker without a cooldown deadline.
|
|
193
|
+
*/
|
|
194
|
+
open(key, s) {
|
|
195
|
+
s.successes = 0;
|
|
196
|
+
s.inFlightProbes = 0;
|
|
197
|
+
s.nextAttemptAllowedAt = Date.now() + this.recoveryTimeoutMs;
|
|
198
|
+
this.transition(key, s, 'open');
|
|
199
|
+
}
|
|
200
|
+
transition(key, stats, to, from = stats.state) {
|
|
201
|
+
if (from === to)
|
|
202
|
+
return;
|
|
203
|
+
stats.state = to;
|
|
204
|
+
stats.epoch++;
|
|
205
|
+
if (to === 'half_open') {
|
|
206
|
+
stats.successes = 0;
|
|
207
|
+
stats.inFlightProbes = 0;
|
|
208
|
+
}
|
|
209
|
+
try {
|
|
210
|
+
this.onStateChange?.(key, from, to);
|
|
211
|
+
}
|
|
212
|
+
catch {
|
|
213
|
+
// A faulty observer must not break request handling or leave the breaker inconsistent.
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
//# sourceMappingURL=circuit_breaker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"circuit_breaker.js","sourceRoot":"","sources":["../../src/circuit_breaker.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { AiConfig } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Type-safe configuration helper for Adonis AI, following the AdonisJS 7 defineConfig pattern.
|
|
4
|
+
* Returns a new object; the input is not mutated.
|
|
5
|
+
*
|
|
6
|
+
* When `fallbackCascade` is omitted, every other HTTP-API provider becomes a fallback. ACP agents
|
|
7
|
+
* (local CLIs with shell/file access) and `custom` drivers are never added automatically: list
|
|
8
|
+
* them in `fallbackCascade` explicitly if you really want them as fallbacks.
|
|
9
|
+
*/
|
|
10
|
+
export declare function defineConfig(config: AiConfig): AiConfig;
|
|
11
|
+
//# sourceMappingURL=define_config.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAG1C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CA4CvD"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { ProviderConfigError } from './errors.js';
|
|
2
|
+
/**
|
|
3
|
+
* Type-safe configuration helper for Adonis AI, following the AdonisJS 7 defineConfig pattern.
|
|
4
|
+
* Returns a new object; the input is not mutated.
|
|
5
|
+
*
|
|
6
|
+
* When `fallbackCascade` is omitted, every other HTTP-API provider becomes a fallback. ACP agents
|
|
7
|
+
* (local CLIs with shell/file access) and `custom` drivers are never added automatically: list
|
|
8
|
+
* them in `fallbackCascade` explicitly if you really want them as fallbacks.
|
|
9
|
+
*/
|
|
10
|
+
export function defineConfig(config) {
|
|
11
|
+
if (!config.providers || Object.keys(config.providers).length === 0) {
|
|
12
|
+
throw new ProviderConfigError('global', 'At least one AI provider must be registered in "providers".');
|
|
13
|
+
}
|
|
14
|
+
let defaultProvider = config.default;
|
|
15
|
+
if (!defaultProvider) {
|
|
16
|
+
defaultProvider = Object.keys(config.providers)[0];
|
|
17
|
+
}
|
|
18
|
+
else if (!config.providers[defaultProvider]) {
|
|
19
|
+
throw new ProviderConfigError(defaultProvider, `Default provider "${defaultProvider}" is not registered in "providers" map.`);
|
|
20
|
+
}
|
|
21
|
+
const fallbackCascade = config.fallbackCascade ??
|
|
22
|
+
Object.entries(config.providers)
|
|
23
|
+
.filter(([name, provider]) => name !== defaultProvider && provider.driver !== 'acp' && provider.driver !== 'custom')
|
|
24
|
+
.map(([name]) => name);
|
|
25
|
+
for (const name of fallbackCascade) {
|
|
26
|
+
if (!config.providers[name]) {
|
|
27
|
+
throw new ProviderConfigError(name, `Fallback provider "${name}" is not registered in "providers" map.`);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
return {
|
|
31
|
+
...config,
|
|
32
|
+
default: defaultProvider,
|
|
33
|
+
fallbackCascade,
|
|
34
|
+
circuitBreaker: {
|
|
35
|
+
failureThreshold: 5,
|
|
36
|
+
recoveryTimeoutMs: 30_000,
|
|
37
|
+
halfOpenMaxAttempts: 2,
|
|
38
|
+
halfOpenMaxConcurrent: 1,
|
|
39
|
+
...config.circuitBreaker,
|
|
40
|
+
},
|
|
41
|
+
catalog: {
|
|
42
|
+
preferCache: true,
|
|
43
|
+
autoPricing: true,
|
|
44
|
+
...config.catalog,
|
|
45
|
+
},
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=define_config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAgB;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,6DAA6D,CAAC,CAAA;IACxG,CAAC;IAED,IAAI,eAAe,GAAG,MAAM,CAAC,OAAO,CAAA;IACpC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IACpD,CAAC;SAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAC3B,eAAe,EACf,qBAAqB,eAAe,yCAAyC,CAC9E,CAAA;IACH,CAAC;IAED,MAAM,eAAe,GACnB,MAAM,CAAC,eAAe;QACtB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;aAC7B,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,eAAe,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC;aACnH,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAE1B,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE,sBAAsB,IAAI,yCAAyC,CAAC,CAAA;QAC1G,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,eAAe;QACxB,eAAe;QACf,cAAc,EAAE;YACd,gBAAgB,EAAE,CAAC;YACnB,iBAAiB,EAAE,MAAM;YACzB,mBAAmB,EAAE,CAAC;YACtB,qBAAqB,EAAE,CAAC;YACxB,GAAG,MAAM,CAAC,cAAc;SACzB;QACD,OAAO,EAAE;YACP,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,IAAI;YACjB,GAAG,MAAM,CAAC,OAAO;SAClB;KACF,CAAA;AACH,CAAC"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* - `retryable`: transient upstream failure; try the next provider
|
|
3
|
+
* - `skip`: this provider cannot serve the request (open breaker, missing package/config);
|
|
4
|
+
* try the next provider but do not count it against the breaker
|
|
5
|
+
* - `fatal`: the request itself is wrong or was cancelled; fail immediately, no fallback
|
|
6
|
+
*
|
|
7
|
+
* Whether a failure also counts against the circuit breaker is a separate question,
|
|
8
|
+
* answered by {@link ErrorClassification.countsAsFailure}.
|
|
9
|
+
*/
|
|
10
|
+
export type ErrorKind = 'retryable' | 'skip' | 'fatal';
|
|
11
|
+
export interface ErrorClassification {
|
|
12
|
+
kind: ErrorKind;
|
|
13
|
+
reason: string;
|
|
14
|
+
/** Fine-grained cause; `unknown` for skip / abort / validation outcomes. */
|
|
15
|
+
errorClass: ErrorClass;
|
|
16
|
+
/** Whether the failure says something about upstream health and should count against the circuit breaker. */
|
|
17
|
+
countsAsFailure: boolean;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Fine-grained taxonomy of an LLM API failure.
|
|
21
|
+
*
|
|
22
|
+
* `ErrorKind` answers "should we fall back to the next provider?".
|
|
23
|
+
* `ErrorClass` answers "what actually went wrong?", which is what belongs in logs,
|
|
24
|
+
* dashboards and user-facing messages.
|
|
25
|
+
*/
|
|
26
|
+
export type ErrorClass = 'rate_limit' | 'overloaded' | 'timeout' | 'auth_error' | 'model_not_found' | 'prompt_too_long' | 'invalid_request' | 'server_error' | 'network_error' | 'no_output_generated' | 'unknown';
|
|
27
|
+
/**
|
|
28
|
+
* Classifies an error into the fine-grained {@link ErrorClass} taxonomy.
|
|
29
|
+
* The HTTP status and error code are looked up through the `cause` / `lastError` chain.
|
|
30
|
+
*/
|
|
31
|
+
export declare function classifyErrorClass(error: unknown): ErrorClass;
|
|
32
|
+
/**
|
|
33
|
+
* Whether an error class is transient and therefore eligible for fallback routing.
|
|
34
|
+
*/
|
|
35
|
+
export declare function isRetryableError(errorClass: ErrorClass): boolean;
|
|
36
|
+
/**
|
|
37
|
+
* Whether an error class reflects upstream health and should count against the circuit breaker.
|
|
38
|
+
* `prompt_too_long` and `no_output_generated` fall back to another model but never open the breaker.
|
|
39
|
+
*/
|
|
40
|
+
export declare function countsAsBreakerFailure(errorClass: ErrorClass): boolean;
|
|
41
|
+
/**
|
|
42
|
+
* Classifies an error for fallback / circuit-breaker decisions.
|
|
43
|
+
* `abortSignal` is the caller's signal: when it is aborted the failure is the caller's doing.
|
|
44
|
+
*/
|
|
45
|
+
export declare function classifyError(error: unknown, abortSignal?: AbortSignal): ErrorClassification;
|
|
46
|
+
/**
|
|
47
|
+
* Human-readable message for an error class, safe to show to an operator.
|
|
48
|
+
*/
|
|
49
|
+
export declare function getUserFriendlyMessage(errorClass: ErrorClass): string;
|
|
50
|
+
//# sourceMappingURL=error_classifier.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"error_classifier.d.ts","sourceRoot":"","sources":["../../src/error_classifier.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,UAAU,EAAE,UAAU,CAAA;IACtB,6GAA6G;IAC7G,eAAe,EAAE,OAAO,CAAA;CACzB;AA+DD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,qBAAqB,GACrB,SAAS,CAAA;AAkBb;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CA0B7D;AAYD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEhE;AAUD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,mBAAmB,CAqC5F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAyBrE"}
|