brass-runtime 1.15.0 → 1.16.1

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 (209) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +673 -136
  3. package/dist/agent/cli/main.cjs +40 -35
  4. package/dist/agent/cli/main.js +9 -4
  5. package/dist/agent/cli/main.mjs +9 -4
  6. package/dist/agent/index.cjs +8 -4
  7. package/dist/agent/index.d.ts +1 -1
  8. package/dist/agent/index.js +7 -3
  9. package/dist/agent/index.mjs +7 -3
  10. package/dist/chunk-2HQTDLHF.mjs +683 -0
  11. package/dist/chunk-36I3M4UC.mjs +370 -0
  12. package/dist/chunk-3AYM6WPJ.js +1629 -0
  13. package/dist/chunk-3LOYJFRR.cjs +300 -0
  14. package/dist/chunk-3RG5ZIWI.js +10 -0
  15. package/dist/chunk-3Y2RIUMM.js +300 -0
  16. package/dist/{chunk-VEZNF5GZ.cjs → chunk-4ROBZFL6.cjs} +130 -126
  17. package/dist/{chunk-3QMOKAS5.js → chunk-52OB2ROS.js} +9 -5
  18. package/dist/chunk-52PPNNI4.cjs +416 -0
  19. package/dist/chunk-5EC274J5.cjs +2874 -0
  20. package/dist/chunk-5QC7LRZ3.js +229 -0
  21. package/dist/chunk-5VRJNBLZ.mjs +2874 -0
  22. package/dist/chunk-62AZW6UT.cjs +313 -0
  23. package/dist/chunk-6IXXWIUM.js +683 -0
  24. package/dist/chunk-74ZTY6CP.js +2871 -0
  25. package/dist/chunk-76YMRMH2.cjs +777 -0
  26. package/dist/chunk-7CMJS3QE.mjs +2871 -0
  27. package/dist/{chunk-4NHES7VK.mjs → chunk-7JIJOVCT.js} +27 -13
  28. package/dist/chunk-A2OM6NEH.mjs +194 -0
  29. package/dist/chunk-AGR5B2BC.cjs +683 -0
  30. package/dist/chunk-AVNQLJ5V.js +777 -0
  31. package/dist/chunk-B33ICAKP.js +313 -0
  32. package/dist/{chunk-ELOOF35R.mjs → chunk-B5JD23U7.mjs} +1 -1
  33. package/dist/chunk-BABBZK4Y.js +2024 -0
  34. package/dist/chunk-C3MDXTRZ.js +354 -0
  35. package/dist/chunk-CIZFIMK5.js +2193 -0
  36. package/dist/chunk-CZIVE6NT.cjs +354 -0
  37. package/dist/chunk-DNFJLJMW.mjs +354 -0
  38. package/dist/chunk-DNFO2EIZ.mjs +777 -0
  39. package/dist/chunk-EJ6BPYVR.mjs +416 -0
  40. package/dist/chunk-ENKODRU3.cjs +2193 -0
  41. package/dist/chunk-EOC4UHBS.mjs +229 -0
  42. package/dist/{chunk-BMH5AV44.js → chunk-FH2X7BVP.js} +756 -440
  43. package/dist/{chunk-PPUXIH5R.js → chunk-FHQGHPMO.mjs} +27 -13
  44. package/dist/{chunk-TGIFUAK4.cjs → chunk-GLE2WY7Z.cjs} +951 -635
  45. package/dist/{chunk-BDF4AMWX.mjs → chunk-GYM3LLGS.mjs} +756 -440
  46. package/dist/chunk-HLWLMW2F.mjs +2024 -0
  47. package/dist/chunk-JF5WGYJJ.cjs +194 -0
  48. package/dist/chunk-KH4SYAOS.mjs +1629 -0
  49. package/dist/chunk-KN32XNTH.mjs +313 -0
  50. package/dist/chunk-KQLYONSE.cjs +2871 -0
  51. package/dist/{chunk-STVLQ3XD.cjs → chunk-KZJQ723N.cjs} +92 -78
  52. package/dist/chunk-L2SYFEBS.js +194 -0
  53. package/dist/chunk-L6VB5N7Q.cjs +104 -0
  54. package/dist/{chunk-K6M7MDZ4.mjs → chunk-MBEJI5HF.mjs} +9 -5
  55. package/dist/chunk-MIIYDLGM.js +2874 -0
  56. package/dist/chunk-MOO4L7F4.mjs +104 -0
  57. package/dist/chunk-MT3OWDPC.mjs +2193 -0
  58. package/dist/chunk-MVGUEJ5Z.cjs +370 -0
  59. package/dist/chunk-OBGZSXTJ.cjs +10 -0
  60. package/dist/chunk-PD4EJTQC.cjs +229 -0
  61. package/dist/chunk-PWC3RBQE.mjs +300 -0
  62. package/dist/chunk-Q2I37RP3.cjs +1629 -0
  63. package/dist/chunk-RKGKFN2A.js +416 -0
  64. package/dist/{chunk-R3R2FVLG.cjs → chunk-SA6HUJVI.cjs} +5 -5
  65. package/dist/chunk-TRM4JUZQ.js +104 -0
  66. package/dist/chunk-UB4B6OFY.js +370 -0
  67. package/dist/{chunk-TO7IKXYT.js → chunk-UCUBNWM2.js} +1 -1
  68. package/dist/chunk-VN44DYYT.cjs +2024 -0
  69. package/dist/chunk-Y6FXYEAI.mjs +10 -0
  70. package/dist/client-CZHU674n.d.ts +820 -0
  71. package/dist/core/index.cjs +198 -4
  72. package/dist/core/index.d.ts +311 -212
  73. package/dist/core/index.js +237 -43
  74. package/dist/core/index.mjs +237 -43
  75. package/dist/{effect-CMOQKX8y.d.ts → effect-DIUHZ9IN.d.ts} +195 -1
  76. package/dist/effectRunner-CFLC32IK.cjs +8 -0
  77. package/dist/effectRunner-L4S7IPT3.js +8 -0
  78. package/dist/effectRunner-NNGG75QA.mjs +8 -0
  79. package/dist/http/index.cjs +1227 -2971
  80. package/dist/http/index.d.ts +826 -280
  81. package/dist/http/index.js +1089 -2833
  82. package/dist/http/index.mjs +1089 -2833
  83. package/dist/http/testing.cjs +161 -0
  84. package/dist/http/testing.d.ts +43 -0
  85. package/dist/http/testing.js +161 -0
  86. package/dist/http/testing.mjs +161 -0
  87. package/dist/index.cjs +486 -250
  88. package/dist/index.d.ts +87 -95
  89. package/dist/index.js +391 -155
  90. package/dist/index.mjs +391 -155
  91. package/dist/observability/index.cjs +162 -0
  92. package/dist/observability/index.d.ts +152 -0
  93. package/dist/observability/index.js +162 -0
  94. package/dist/observability/index.mjs +162 -0
  95. package/dist/perf/cli.cjs +401 -0
  96. package/dist/perf/cli.d.ts +1 -0
  97. package/dist/perf/cli.js +401 -0
  98. package/dist/perf/cli.mjs +401 -0
  99. package/dist/perf/index.cjs +141 -0
  100. package/dist/perf/index.d.ts +483 -0
  101. package/dist/perf/index.js +141 -0
  102. package/dist/perf/index.mjs +141 -0
  103. package/dist/schedule-CK3Ml_7p.d.ts +259 -0
  104. package/dist/schema/index.cjs +29 -0
  105. package/dist/schema/index.d.ts +179 -0
  106. package/dist/schema/index.js +29 -0
  107. package/dist/schema/index.mjs +29 -0
  108. package/dist/server-GJPg8ZSG.d.ts +675 -0
  109. package/dist/{stream-FQm9h4Mg.d.ts → stream-B4oK9JFP.d.ts} +1 -1
  110. package/dist/tracer-Hwt1cl7h.d.ts +189 -0
  111. package/dist/tracing-DqbTKGcf.d.ts +148 -0
  112. package/docs/ARCHITECTURE.md +292 -0
  113. package/docs/README.md +63 -0
  114. package/docs/adr/0001-ai-context-pack.md +32 -0
  115. package/docs/agent-apply-mode.md +104 -0
  116. package/docs/agent-approvals.md +110 -0
  117. package/docs/agent-batch.md +185 -0
  118. package/docs/agent-boundaries.md +112 -0
  119. package/docs/agent-chat-sessions.md +160 -0
  120. package/docs/agent-ci.md +17 -0
  121. package/docs/agent-cli.md +405 -0
  122. package/docs/agent-config.md +480 -0
  123. package/docs/agent-context-discovery.md +159 -0
  124. package/docs/agent-copilot-like-dx.md +126 -0
  125. package/docs/agent-declarative-optimized-planning.md +138 -0
  126. package/docs/agent-dx.md +224 -0
  127. package/docs/agent-env-files.md +126 -0
  128. package/docs/agent-follow-up-context.md +43 -0
  129. package/docs/agent-global-usage.md +180 -0
  130. package/docs/agent-init.md +109 -0
  131. package/docs/agent-install-and-configure.md +516 -0
  132. package/docs/agent-language-workspace-ux.md +99 -0
  133. package/docs/agent-llm-adapters.md +123 -0
  134. package/docs/agent-local-install.md +190 -0
  135. package/docs/agent-local-tests.md +51 -0
  136. package/docs/agent-observability.md +155 -0
  137. package/docs/agent-patch-quality-loop.md +162 -0
  138. package/docs/agent-presets.md +22 -0
  139. package/docs/agent-project-commands.md +237 -0
  140. package/docs/agent-project-intelligence.md +156 -0
  141. package/docs/agent-redaction.md +18 -0
  142. package/docs/agent-release-readiness.md +76 -0
  143. package/docs/agent-rollback-safety.md +162 -0
  144. package/docs/agent-rollback.md +23 -0
  145. package/docs/agent-run-artifacts.md +16 -0
  146. package/docs/agent-vscode-auto-discovery.md +137 -0
  147. package/docs/agent-vscode-batch-runner.md +100 -0
  148. package/docs/agent-vscode-chat-layout.md +90 -0
  149. package/docs/agent-vscode-clean-install.md +147 -0
  150. package/docs/agent-vscode-code-actions.md +70 -0
  151. package/docs/agent-vscode-diff-preview.md +45 -0
  152. package/docs/agent-vscode-inline-assist.md +56 -0
  153. package/docs/agent-vscode-install.md +186 -0
  154. package/docs/agent-vscode-model-setup.md +97 -0
  155. package/docs/agent-vscode-patch-preview.md +92 -0
  156. package/docs/agent-vscode-problems.md +79 -0
  157. package/docs/agent-vscode-project-dashboard.md +106 -0
  158. package/docs/agent-vscode-run-history.md +92 -0
  159. package/docs/agent-vscode-ux.md +73 -0
  160. package/docs/ai/INVARIANTS.md +84 -0
  161. package/docs/ai/PROJECT_MAP.md +338 -0
  162. package/docs/ai/PUBLIC_API.md +336 -0
  163. package/docs/ai/VALIDATION_MATRIX.md +67 -0
  164. package/docs/api-polish.md +37 -0
  165. package/docs/cancellation.md +162 -0
  166. package/docs/coverage.md +46 -0
  167. package/docs/getting-started.md +159 -0
  168. package/docs/guides/README.md +40 -0
  169. package/docs/guides/circuit-breaker.md +89 -0
  170. package/docs/guides/error-handling.md +91 -0
  171. package/docs/guides/getting-started.md +107 -0
  172. package/docs/guides/layers.md +189 -0
  173. package/docs/guides/metrics.md +101 -0
  174. package/docs/guides/resource-management.md +141 -0
  175. package/docs/guides/retry.md +215 -0
  176. package/docs/guides/semaphore.md +66 -0
  177. package/docs/guides/streams.md +117 -0
  178. package/docs/guides/supervisors.md +98 -0
  179. package/docs/guides/testing.md +162 -0
  180. package/docs/guides/tracing.md +71 -0
  181. package/docs/http-recipes.md +399 -0
  182. package/docs/http.md +749 -0
  183. package/docs/modules.md +285 -0
  184. package/docs/observability-collector-smoke.md +31 -0
  185. package/docs/observability-framework-examples.md +98 -0
  186. package/docs/observability.md +542 -0
  187. package/docs/otel-collector-smoke.yaml +27 -0
  188. package/docs/performance-profiler.md +199 -0
  189. package/docs/production-readiness.md +73 -0
  190. package/docs/recipes/README.md +12 -0
  191. package/docs/recipes/http-server.md +45 -0
  192. package/docs/recipes/layers.md +44 -0
  193. package/docs/recipes/performance.md +47 -0
  194. package/docs/recipes/runtime.md +41 -0
  195. package/docs/recipes/testing.md +41 -0
  196. package/docs/release.md +53 -0
  197. package/docs/wasm-bounded-queues.md +44 -0
  198. package/docs/wasm-engine-observability-benchmarks.md +85 -0
  199. package/docs/wasm-fiber-engine.md +117 -0
  200. package/docs/wasm-scheduler-state-machine.md +122 -0
  201. package/docs/wasm-stream-chunks.md +54 -0
  202. package/package.json +48 -2
  203. package/dist/chunk-AR22SXML.js +0 -1043
  204. package/dist/chunk-BDYEENHT.js +0 -224
  205. package/dist/chunk-JFPU5GQI.mjs +0 -1043
  206. package/dist/chunk-MS34J5LY.cjs +0 -224
  207. package/dist/chunk-UMAZLXAB.mjs +0 -224
  208. package/dist/chunk-XPZNXSVN.cjs +0 -1043
  209. package/dist/tracing-DNT9jEbr.d.ts +0 -106
@@ -0,0 +1,313 @@
1
+ import {
2
+ Scope
3
+ } from "./chunk-L2SYFEBS.js";
4
+ import {
5
+ unsafeGetCurrentRuntime
6
+ } from "./chunk-FH2X7BVP.js";
7
+ import {
8
+ Cause,
9
+ Exit,
10
+ asyncEffect,
11
+ asyncFail,
12
+ asyncFold,
13
+ asyncSucceed,
14
+ unit
15
+ } from "./chunk-UB4B6OFY.js";
16
+
17
+ // src/core/runtime/resource.ts
18
+ function bracket(acquire, use, release) {
19
+ return asyncEffect((env, cb) => {
20
+ const runtime = unsafeGetCurrentRuntime();
21
+ const scope = new Scope(runtime);
22
+ const acquireFiber = scope.fork(acquire);
23
+ acquireFiber.join((acquireExit) => {
24
+ if (acquireExit._tag === "Failure") {
25
+ scope.close(acquireExit);
26
+ cb(acquireExit);
27
+ return;
28
+ }
29
+ const resource2 = acquireExit.value;
30
+ const useFiber = scope.fork(use(resource2));
31
+ useFiber.join((useExit) => {
32
+ const releaseEffect = safeRelease(release, resource2, useExit);
33
+ const releaseFiber = runtime.fork(releaseEffect);
34
+ releaseFiber.join(() => {
35
+ scope.close(useExit);
36
+ cb(useExit);
37
+ });
38
+ });
39
+ });
40
+ return () => {
41
+ scope.close(Exit.failCause(Cause.interrupt()));
42
+ };
43
+ });
44
+ }
45
+ function safeRelease(release, resource2, exit) {
46
+ return asyncFold(
47
+ (() => {
48
+ try {
49
+ return release(resource2, exit);
50
+ } catch {
51
+ return unit();
52
+ }
53
+ })(),
54
+ () => unit(),
55
+ () => unit()
56
+ );
57
+ }
58
+ function ensuring(effect, finalizer) {
59
+ return asyncEffect((env, cb) => {
60
+ const runtime = unsafeGetCurrentRuntime();
61
+ const fiber = runtime.fork(effect);
62
+ fiber.join((exit) => {
63
+ const fin = asyncFold(
64
+ (() => {
65
+ try {
66
+ return finalizer(exit);
67
+ } catch {
68
+ return unit();
69
+ }
70
+ })(),
71
+ () => unit(),
72
+ () => unit()
73
+ );
74
+ runtime.fork(fin).join(() => {
75
+ cb(exit);
76
+ });
77
+ });
78
+ return () => {
79
+ fiber.interrupt();
80
+ };
81
+ });
82
+ }
83
+ function resource(acquire, release) {
84
+ return makeResourceFromUse((body) => bracket(acquire, body, release));
85
+ }
86
+ var makeResource = resource;
87
+ function resourceSucceed(value) {
88
+ return makeResourceFromUse((body) => body(value));
89
+ }
90
+ function resourceFromManaged(m) {
91
+ return makeResourceFromUse((body) => useManaged(m, body));
92
+ }
93
+ function useResource(res, body) {
94
+ return res.use(body);
95
+ }
96
+ function resourceAll(resources) {
97
+ const build = (index) => {
98
+ if (index >= resources.length) return resourceSucceed([]);
99
+ return resources[index].flatMap(
100
+ (head) => build(index + 1).map((tail) => [head, ...tail])
101
+ );
102
+ };
103
+ return build(0).map((values) => values);
104
+ }
105
+ var Resource = Object.freeze({
106
+ make: resource,
107
+ succeed: resourceSucceed,
108
+ fromManaged: resourceFromManaged,
109
+ all: resourceAll,
110
+ use: useResource
111
+ });
112
+ function makeResourceFromUse(use) {
113
+ const self = {
114
+ _tag: "Resource",
115
+ use,
116
+ map: (f) => makeResourceFromUse((body) => self.use((a) => body(f(a)))),
117
+ flatMap: (f) => makeResourceFromUse((body) => self.use((a) => f(a).use(body))),
118
+ zip: (that) => self.flatMap((a) => that.map((b) => [a, b]))
119
+ };
120
+ return self;
121
+ }
122
+ function managed(acquire, release) {
123
+ return {
124
+ _tag: "Managed",
125
+ acquire,
126
+ release: (resource2, exit) => release(resource2, exit)
127
+ };
128
+ }
129
+ function useManaged(m, body) {
130
+ return bracket(m.acquire, body, m.release);
131
+ }
132
+ function managedAll(manageds) {
133
+ const acquire = asyncEffect((env, cb) => {
134
+ const runtime = unsafeGetCurrentRuntime();
135
+ const resources = [];
136
+ let i = 0;
137
+ const acquireNext = () => {
138
+ if (i >= manageds.length) {
139
+ cb({ _tag: "Success", value: resources });
140
+ return;
141
+ }
142
+ const m = manageds[i];
143
+ const fiber = runtime.fork(m.acquire);
144
+ fiber.join((exit) => {
145
+ if (exit._tag === "Failure") {
146
+ releaseAcquired(runtime, manageds, resources, exit).then(() => {
147
+ cb(exit);
148
+ });
149
+ return;
150
+ }
151
+ resources.push(exit.value);
152
+ i++;
153
+ acquireNext();
154
+ });
155
+ };
156
+ acquireNext();
157
+ });
158
+ const release = (resources, exit) => {
159
+ return asyncEffect((_env, cb) => {
160
+ const runtime = unsafeGetCurrentRuntime();
161
+ releaseAcquired(runtime, manageds, resources, exit).then(() => {
162
+ cb({ _tag: "Success", value: void 0 });
163
+ });
164
+ });
165
+ };
166
+ return { _tag: "Managed", acquire, release };
167
+ }
168
+ async function releaseAcquired(runtime, manageds, resources, exit) {
169
+ for (let i = resources.length - 1; i >= 0; i--) {
170
+ try {
171
+ const m = manageds[i];
172
+ await new Promise((resolve) => {
173
+ const releaseEff = asyncFold(
174
+ m.release(resources[i], exit),
175
+ () => unit(),
176
+ () => unit()
177
+ );
178
+ runtime.fork(releaseEff).join(() => resolve());
179
+ });
180
+ } catch {
181
+ }
182
+ }
183
+ }
184
+
185
+ // src/core/runtime/circuitBreaker.ts
186
+ function makeCircuitBreaker(config = {}) {
187
+ const failureThreshold = config.failureThreshold ?? 5;
188
+ const resetTimeoutMs = config.resetTimeoutMs ?? 3e4;
189
+ const successThreshold = config.successThreshold ?? 1;
190
+ const isFailure = config.isFailure ?? (() => true);
191
+ const onStateChange = config.onStateChange;
192
+ let currentState = "closed";
193
+ let consecutiveFailures = 0;
194
+ let consecutiveSuccesses = 0;
195
+ let openedAt = 0;
196
+ let totalRequests = 0;
197
+ let totalFailures = 0;
198
+ let totalSuccesses = 0;
199
+ let totalRejected = 0;
200
+ let lastFailureTime = null;
201
+ let lastSuccessTime = null;
202
+ const transition = (to) => {
203
+ if (currentState === to) return;
204
+ const from = currentState;
205
+ currentState = to;
206
+ onStateChange?.(from, to);
207
+ };
208
+ const onSuccess = () => {
209
+ totalSuccesses++;
210
+ lastSuccessTime = Date.now();
211
+ consecutiveFailures = 0;
212
+ if (currentState === "half-open") {
213
+ consecutiveSuccesses++;
214
+ if (consecutiveSuccesses >= successThreshold) {
215
+ consecutiveSuccesses = 0;
216
+ transition("closed");
217
+ }
218
+ }
219
+ };
220
+ const onFailure = (error) => {
221
+ if (!isFailure(error)) {
222
+ onSuccess();
223
+ return;
224
+ }
225
+ totalFailures++;
226
+ lastFailureTime = Date.now();
227
+ consecutiveSuccesses = 0;
228
+ consecutiveFailures++;
229
+ if (currentState === "half-open") {
230
+ openedAt = Date.now();
231
+ transition("open");
232
+ } else if (currentState === "closed" && consecutiveFailures >= failureThreshold) {
233
+ openedAt = Date.now();
234
+ transition("open");
235
+ }
236
+ };
237
+ const shouldAllow = () => {
238
+ switch (currentState) {
239
+ case "closed":
240
+ return true;
241
+ case "open": {
242
+ const elapsed = Date.now() - openedAt;
243
+ if (elapsed >= resetTimeoutMs) {
244
+ transition("half-open");
245
+ return true;
246
+ }
247
+ return false;
248
+ }
249
+ case "half-open":
250
+ return true;
251
+ }
252
+ };
253
+ const protect = (effect) => {
254
+ totalRequests++;
255
+ if (!shouldAllow()) {
256
+ totalRejected++;
257
+ return asyncFail({
258
+ _tag: "CircuitBreakerOpen",
259
+ openSince: openedAt,
260
+ failures: consecutiveFailures
261
+ });
262
+ }
263
+ return asyncFold(
264
+ effect,
265
+ (error) => {
266
+ onFailure(error);
267
+ return asyncFail(error);
268
+ },
269
+ (value) => {
270
+ onSuccess();
271
+ return asyncSucceed(value);
272
+ }
273
+ );
274
+ };
275
+ const stats = () => ({
276
+ state: currentState,
277
+ failures: consecutiveFailures,
278
+ successes: consecutiveSuccesses,
279
+ totalRequests,
280
+ totalFailures,
281
+ totalSuccesses,
282
+ totalRejected,
283
+ lastFailureTime,
284
+ lastSuccessTime
285
+ });
286
+ const reset = () => {
287
+ consecutiveFailures = 0;
288
+ consecutiveSuccesses = 0;
289
+ transition("closed");
290
+ };
291
+ return {
292
+ state: () => currentState,
293
+ protect,
294
+ stats,
295
+ reset
296
+ };
297
+ }
298
+
299
+ export {
300
+ bracket,
301
+ ensuring,
302
+ resource,
303
+ makeResource,
304
+ resourceSucceed,
305
+ resourceFromManaged,
306
+ useResource,
307
+ resourceAll,
308
+ Resource,
309
+ managed,
310
+ useManaged,
311
+ managedAll,
312
+ makeCircuitBreaker
313
+ };
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  asyncEffect
3
- } from "./chunk-BDF4AMWX.mjs";
3
+ } from "./chunk-36I3M4UC.mjs";
4
4
 
5
5
  // src/core/stream/structuredConcurrency.ts
6
6
  function race(left, right, parentScope) {