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.
Files changed (196) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +397 -2
  4. package/dist/commands/ai_test.d.ts +12 -0
  5. package/dist/commands/ai_test.d.ts.map +1 -0
  6. package/dist/commands/ai_test.js +98 -0
  7. package/dist/commands/ai_test.js.map +1 -0
  8. package/dist/commands/main.d.ts +14 -0
  9. package/dist/commands/main.d.ts.map +1 -0
  10. package/dist/commands/main.js +31 -0
  11. package/dist/commands/main.js.map +1 -0
  12. package/dist/commands/make_agent.d.ts +13 -0
  13. package/dist/commands/make_agent.d.ts.map +1 -0
  14. package/dist/commands/make_agent.js +116 -0
  15. package/dist/commands/make_agent.js.map +1 -0
  16. package/dist/providers/ai_provider.d.ts +23 -0
  17. package/dist/providers/ai_provider.d.ts.map +1 -0
  18. package/dist/providers/ai_provider.js +34 -0
  19. package/dist/providers/ai_provider.js.map +1 -0
  20. package/dist/services/main.d.ts +4 -0
  21. package/dist/services/main.d.ts.map +1 -0
  22. package/dist/services/main.js +7 -0
  23. package/dist/services/main.js.map +1 -0
  24. package/dist/src/acp/acp_agents.d.ts +89 -0
  25. package/dist/src/acp/acp_agents.d.ts.map +1 -0
  26. package/dist/src/acp/acp_agents.js +367 -0
  27. package/dist/src/acp/acp_agents.js.map +1 -0
  28. package/dist/src/acp/index.d.ts +4 -0
  29. package/dist/src/acp/index.d.ts.map +1 -0
  30. package/dist/src/acp/index.js +4 -0
  31. package/dist/src/acp/index.js.map +1 -0
  32. package/dist/src/acp/provider.d.ts +74 -0
  33. package/dist/src/acp/provider.d.ts.map +1 -0
  34. package/dist/src/acp/provider.js +276 -0
  35. package/dist/src/acp/provider.js.map +1 -0
  36. package/dist/src/acp/types.d.ts +128 -0
  37. package/dist/src/acp/types.d.ts.map +1 -0
  38. package/dist/src/acp/types.js +2 -0
  39. package/dist/src/acp/types.js.map +1 -0
  40. package/dist/src/agents/agent_runner.d.ts +60 -0
  41. package/dist/src/agents/agent_runner.d.ts.map +1 -0
  42. package/dist/src/agents/agent_runner.js +134 -0
  43. package/dist/src/agents/agent_runner.js.map +1 -0
  44. package/dist/src/agents/index.d.ts +4 -0
  45. package/dist/src/agents/index.d.ts.map +1 -0
  46. package/dist/src/agents/index.js +4 -0
  47. package/dist/src/agents/index.js.map +1 -0
  48. package/dist/src/agents/loader.d.ts +56 -0
  49. package/dist/src/agents/loader.d.ts.map +1 -0
  50. package/dist/src/agents/loader.js +184 -0
  51. package/dist/src/agents/loader.js.map +1 -0
  52. package/dist/src/agents/manifest.d.ts +61 -0
  53. package/dist/src/agents/manifest.d.ts.map +1 -0
  54. package/dist/src/agents/manifest.js +35 -0
  55. package/dist/src/agents/manifest.js.map +1 -0
  56. package/dist/src/ai_manager.d.ts +140 -0
  57. package/dist/src/ai_manager.d.ts.map +1 -0
  58. package/dist/src/ai_manager.js +814 -0
  59. package/dist/src/ai_manager.js.map +1 -0
  60. package/dist/src/budget/budget_allocator.d.ts +37 -0
  61. package/dist/src/budget/budget_allocator.d.ts.map +1 -0
  62. package/dist/src/budget/budget_allocator.js +98 -0
  63. package/dist/src/budget/budget_allocator.js.map +1 -0
  64. package/dist/src/budget/budget_enforcer.d.ts +70 -0
  65. package/dist/src/budget/budget_enforcer.d.ts.map +1 -0
  66. package/dist/src/budget/budget_enforcer.js +195 -0
  67. package/dist/src/budget/budget_enforcer.js.map +1 -0
  68. package/dist/src/budget/cost_tracker.d.ts +71 -0
  69. package/dist/src/budget/cost_tracker.d.ts.map +1 -0
  70. package/dist/src/budget/cost_tracker.js +199 -0
  71. package/dist/src/budget/cost_tracker.js.map +1 -0
  72. package/dist/src/budget/index.d.ts +6 -0
  73. package/dist/src/budget/index.d.ts.map +1 -0
  74. package/dist/src/budget/index.js +6 -0
  75. package/dist/src/budget/index.js.map +1 -0
  76. package/dist/src/budget/pricing.d.ts +35 -0
  77. package/dist/src/budget/pricing.d.ts.map +1 -0
  78. package/dist/src/budget/pricing.js +129 -0
  79. package/dist/src/budget/pricing.js.map +1 -0
  80. package/dist/src/budget/types.d.ts +86 -0
  81. package/dist/src/budget/types.d.ts.map +1 -0
  82. package/dist/src/budget/types.js +2 -0
  83. package/dist/src/budget/types.js.map +1 -0
  84. package/dist/src/catalog/index.d.ts +3 -0
  85. package/dist/src/catalog/index.d.ts.map +1 -0
  86. package/dist/src/catalog/index.js +3 -0
  87. package/dist/src/catalog/index.js.map +1 -0
  88. package/dist/src/catalog/models_dev.d.ts +87 -0
  89. package/dist/src/catalog/models_dev.d.ts.map +1 -0
  90. package/dist/src/catalog/models_dev.js +38 -0
  91. package/dist/src/catalog/models_dev.js.map +1 -0
  92. package/dist/src/catalog/source.d.ts +67 -0
  93. package/dist/src/catalog/source.d.ts.map +1 -0
  94. package/dist/src/catalog/source.js +678 -0
  95. package/dist/src/catalog/source.js.map +1 -0
  96. package/dist/src/circuit_breaker.d.ts +61 -0
  97. package/dist/src/circuit_breaker.d.ts.map +1 -0
  98. package/dist/src/circuit_breaker.js +217 -0
  99. package/dist/src/circuit_breaker.js.map +1 -0
  100. package/dist/src/define_config.d.ts +11 -0
  101. package/dist/src/define_config.d.ts.map +1 -0
  102. package/dist/src/define_config.js +48 -0
  103. package/dist/src/define_config.js.map +1 -0
  104. package/dist/src/error_classifier.d.ts +50 -0
  105. package/dist/src/error_classifier.d.ts.map +1 -0
  106. package/dist/src/error_classifier.js +206 -0
  107. package/dist/src/error_classifier.js.map +1 -0
  108. package/dist/src/errors.d.ts +52 -0
  109. package/dist/src/errors.d.ts.map +1 -0
  110. package/dist/src/errors.js +70 -0
  111. package/dist/src/errors.js.map +1 -0
  112. package/dist/src/guard/confirmation.d.ts +67 -0
  113. package/dist/src/guard/confirmation.d.ts.map +1 -0
  114. package/dist/src/guard/confirmation.js +180 -0
  115. package/dist/src/guard/confirmation.js.map +1 -0
  116. package/dist/src/guard/errors.d.ts +10 -0
  117. package/dist/src/guard/errors.d.ts.map +1 -0
  118. package/dist/src/guard/errors.js +14 -0
  119. package/dist/src/guard/errors.js.map +1 -0
  120. package/dist/src/guard/guard.d.ts +47 -0
  121. package/dist/src/guard/guard.d.ts.map +1 -0
  122. package/dist/src/guard/guard.js +133 -0
  123. package/dist/src/guard/guard.js.map +1 -0
  124. package/dist/src/guard/index.d.ts +7 -0
  125. package/dist/src/guard/index.d.ts.map +1 -0
  126. package/dist/src/guard/index.js +7 -0
  127. package/dist/src/guard/index.js.map +1 -0
  128. package/dist/src/guard/registry.d.ts +72 -0
  129. package/dist/src/guard/registry.d.ts.map +1 -0
  130. package/dist/src/guard/registry.js +192 -0
  131. package/dist/src/guard/registry.js.map +1 -0
  132. package/dist/src/guard/schema_registry.d.ts +37 -0
  133. package/dist/src/guard/schema_registry.d.ts.map +1 -0
  134. package/dist/src/guard/schema_registry.js +57 -0
  135. package/dist/src/guard/schema_registry.js.map +1 -0
  136. package/dist/src/guard/types.d.ts +63 -0
  137. package/dist/src/guard/types.d.ts.map +1 -0
  138. package/dist/src/guard/types.js +2 -0
  139. package/dist/src/guard/types.js.map +1 -0
  140. package/dist/src/index.d.ts +16 -0
  141. package/dist/src/index.d.ts.map +1 -0
  142. package/dist/src/index.js +14 -0
  143. package/dist/src/index.js.map +1 -0
  144. package/dist/src/logger.d.ts +7 -0
  145. package/dist/src/logger.d.ts.map +1 -0
  146. package/dist/src/logger.js +2 -0
  147. package/dist/src/logger.js.map +1 -0
  148. package/dist/src/models/catalog_resolver.d.ts +24 -0
  149. package/dist/src/models/catalog_resolver.d.ts.map +1 -0
  150. package/dist/src/models/catalog_resolver.js +66 -0
  151. package/dist/src/models/catalog_resolver.js.map +1 -0
  152. package/dist/src/models/index.d.ts +14 -0
  153. package/dist/src/models/index.d.ts.map +1 -0
  154. package/dist/src/models/index.js +8 -0
  155. package/dist/src/models/index.js.map +1 -0
  156. package/dist/src/models/keys.d.ts +9 -0
  157. package/dist/src/models/keys.d.ts.map +1 -0
  158. package/dist/src/models/keys.js +12 -0
  159. package/dist/src/models/keys.js.map +1 -0
  160. package/dist/src/models/language_model_factory.d.ts +44 -0
  161. package/dist/src/models/language_model_factory.d.ts.map +1 -0
  162. package/dist/src/models/language_model_factory.js +193 -0
  163. package/dist/src/models/language_model_factory.js.map +1 -0
  164. package/dist/src/models/model_chain.d.ts +58 -0
  165. package/dist/src/models/model_chain.d.ts.map +1 -0
  166. package/dist/src/models/model_chain.js +144 -0
  167. package/dist/src/models/model_chain.js.map +1 -0
  168. package/dist/src/models/model_ref.d.ts +12 -0
  169. package/dist/src/models/model_ref.d.ts.map +1 -0
  170. package/dist/src/models/model_ref.js +33 -0
  171. package/dist/src/models/model_ref.js.map +1 -0
  172. package/dist/src/models/protocols.d.ts +6 -0
  173. package/dist/src/models/protocols.d.ts.map +1 -0
  174. package/dist/src/models/protocols.js +33 -0
  175. package/dist/src/models/protocols.js.map +1 -0
  176. package/dist/src/models/provider_factories.d.ts +19 -0
  177. package/dist/src/models/provider_factories.d.ts.map +1 -0
  178. package/dist/src/models/provider_factories.js +70 -0
  179. package/dist/src/models/provider_factories.js.map +1 -0
  180. package/dist/src/models/types.d.ts +17 -0
  181. package/dist/src/models/types.d.ts.map +1 -0
  182. package/dist/src/models/types.js +2 -0
  183. package/dist/src/models/types.js.map +1 -0
  184. package/dist/src/response_macro.d.ts +16 -0
  185. package/dist/src/response_macro.d.ts.map +1 -0
  186. package/dist/src/response_macro.js +151 -0
  187. package/dist/src/response_macro.js.map +1 -0
  188. package/dist/src/types.d.ts +340 -0
  189. package/dist/src/types.d.ts.map +1 -0
  190. package/dist/src/types.js +2 -0
  191. package/dist/src/types.js.map +1 -0
  192. package/dist/src/usage.d.ts +13 -0
  193. package/dist/src/usage.d.ts.map +1 -0
  194. package/dist/src/usage.js +61 -0
  195. package/dist/src/usage.js.map +1 -0
  196. 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"}