brass-runtime 1.16.1 → 1.18.0

package/README.md

@@ -9,6 +9,10 @@ Built without `Promise`/`async`/`await` as the primary semantic primitive. Effec
 npm i brass-runtime
 ```
 
+Runnable framework examples live in the
+[repository examples](https://github.com/BaldrVivaldelli/brass-runtime/tree/main/examples).
+They are kept out of the npm package so installs stay small.
+
 ---
 
 ## What it does
@@ -159,9 +163,30 @@ console.log(http.compression?.stats());
 deduplication, priority scheduling, retry, adaptive concurrency, safe-method
 response cache, decompression, stats, `cancelAll`, and JSON/text helpers. Use
 `preset: "production"` when you want that production-ready shape explicitly,
-`preset: "balanced"` to skip the default cache, or `preset: "minimal"` for a
-cheap wire client with the same helper API. `preset: "default"` remains the
-same full preset for compatibility.
+`preset: "balanced"` to skip the default cache, `preset: "highThroughputProxy"`
+for hot BFF/proxy paths without lifecycle queues or Brass timers by default,
+`preset: "proxy"` as the shorter compatibility alias, or `preset: "minimal"`
+for a cheap wire client with the same helper API. `preset: "default"` remains
+the same full preset for compatibility.
+
+On Node BFF/proxy services, pair the proxy preset with the first-party
+`node:http` transport when the default `fetch` backend is the bottleneck.
+The Node-only factory below wires that recommended shape directly:
+
+```ts
+import { toPromise } from "brass-runtime";
+import { makeNodeHttpProxyClient } from "brass-runtime/http";
+
+const http = makeNodeHttpProxyClient({
+  baseUrl: "https://api.example.com",
+  nodeTransport: {
+    maxSockets: 512,
+    maxFreeSockets: 512,
+  },
+});
+
+await toPromise(http.shutdown(), {}); // also destroys owned Node agents
+```
 
 The HTTP stack is meant to replace the usual `fetch` wrapper plus Zod/Valibot
 glue: schemas are dependency-free, responses and request bodies are validated in
@@ -420,6 +445,7 @@ const client = baseClient.with(middleware);
 import { Runtime, asyncSucceed } from "brass-runtime/core";
 import {
   makeObservability,
+  makeOtlpOptions,
   runObservedHttpServerEffect,
   withHttpObservability,
 } from "brass-runtime/observability";
@@ -431,11 +457,7 @@ const obs = makeObservability({
   sampling: { ratio: 0.25, respectRemoteSampled: true, forceSampleOnError: true },
   redaction: {},
   cardinality: { maxValuesPerLabel: 100 },
-  otlp: {
-    metricsUrl: "http://collector:4318/v1/metrics",
-    tracesUrl: "http://collector:4318/v1/traces",
-    logsUrl: "http://collector:4318/v1/logs",
-  },
+  otlp: makeOtlpOptions({ endpoint: "http://collector:4318" }),
   flushIntervalMs: 10_000,
 });
 
@@ -463,6 +485,14 @@ It also reads `req.policy` automatically: logs and span attributes include
 Metric labels stay conservative by default; opt into stable labels with
 `withHttpObservability({ policy: { labelKeys: ["preset", "lane", "poolKey"] } })`.
 
+For hot proxy paths, keep HTTP metrics separate from runtime hooks:
+`makeObservability({ metrics: false, logs: false, traces: false })`,
+`preset: "proxy"`, `withHttpObservability({ spans: false, logs: false,
+injectTraceHeaders: false, includeHostLabel: false })`. For sampled spans on
+the same path, avoid global runtime hooks and use
+`withHttpObservability({ spans: { events: false, sampleRate: 0.001 },
+spanSink: observability.tracer, injectTraceHeaders: false })`.
+
 ### Performance profiler
 
 ```bash
@@ -666,6 +696,8 @@ Property-based tests use `fast-check` with 100+ iterations per property. Each HT
 - [Cancellation & Interruption](./docs/cancellation.md)
 - [Observability: Hooks & Tracing](./docs/observability.md)
 - [Observability framework examples](./docs/observability-framework-examples.md)
+- [Framework integrations](./docs/framework-integrations.md)
+- [NestJS integration](./docs/frameworks/nestjs.md)
 - [Observability collector smoke](./docs/observability-collector-smoke.md)
 - [HTTP module](./docs/http.md)
 - [Production readiness](./docs/production-readiness.md)

package/dist/agent/cli/main.cjs

@@ -17,18 +17,17 @@
 
 
 
-var _chunk4ROBZFL6cjs = require('../../chunk-4ROBZFL6.cjs');
+var _chunk2SLT3X6Gcjs = require('../../chunk-2SLT3X6G.cjs');
 require('../../chunk-SA6HUJVI.cjs');
-require('../../chunk-JF5WGYJJ.cjs');
 
 
-var _chunkGLE2WY7Zcjs = require('../../chunk-GLE2WY7Z.cjs');
+var _chunkSSQJKDN3cjs = require('../../chunk-SSQJKDN3.cjs');
 
 
 
 
 var _chunkMVGUEJ5Zcjs = require('../../chunk-MVGUEJ5Z.cjs');
-require('../../chunk-CZIVE6NT.cjs');
+require('../../chunk-UUMKZJRJ.cjs');
 require('../../chunk-OBGZSXTJ.cjs');
 
 // src/agent/cli/approvals.ts
@@ -57,7 +56,7 @@ var makeCliApprovalService = (options = {}) => ({
       _optionalChain([output, 'optionalAccess', _ => _.write, 'optionalCall', _2 => _2(`
 Approval required (${request.risk})
 `)]);
-      _optionalChain([output, 'optionalAccess', _3 => _3.write, 'optionalCall', _4 => _4(`Action: ${_chunk4ROBZFL6cjs.summarizeAgentAction.call(void 0, request.action)}
+      _optionalChain([output, 'optionalAccess', _3 => _3.write, 'optionalCall', _4 => _4(`Action: ${_chunk2SLT3X6Gcjs.summarizeAgentAction.call(void 0, request.action)}
 `)]);
       _optionalChain([output, 'optionalAccess', _5 => _5.write, 'optionalCall', _6 => _6(`Reason: ${request.reason}
 `)]);
@@ -1104,7 +1103,7 @@ var parseCliArgs = (argv) => {
     }
     if (arg === "--preset" || arg.startsWith("--preset=")) {
       const [value, nextIndex] = readFlagValue(argv, index, "--preset");
-      if (!_chunk4ROBZFL6cjs.isAgentPreset.call(void 0, value)) {
+      if (!_chunk2SLT3X6Gcjs.isAgentPreset.call(void 0, value)) {
         throw new Error("--preset requires one of: fix-tests, inspect, typecheck, lint");
       }
       preset = value;
@@ -1280,7 +1279,7 @@ var parseBatchGoal = (value, path) => {
   if (cwd !== void 0 && typeof cwd !== "string") throw new Error(`${path}.cwd must be a string.`);
   if (patchFile !== void 0 && typeof patchFile !== "string") throw new Error(`${path}.patchFile must be a string.`);
   if (saveRunDir !== void 0 && typeof saveRunDir !== "string") throw new Error(`${path}.saveRunDir must be a string.`);
-  if (preset !== void 0 && (typeof preset !== "string" || !_chunk4ROBZFL6cjs.isAgentPreset.call(void 0, preset))) {
+  if (preset !== void 0 && (typeof preset !== "string" || !_chunk2SLT3X6Gcjs.isAgentPreset.call(void 0, preset))) {
     throw new Error(`${path}.preset must be one of: fix-tests, inspect, typecheck, lint.`);
   }
   if (mode !== void 0 && (typeof mode !== "string" || !isAgentMode(mode))) {
@@ -1324,7 +1323,7 @@ var readBatchFile = async (cwd, batchFile) => {
 var resolveBatchGoalText = (item, fallbackPatchFile) => {
   if (typeof item === "string") return item;
   if (item.goal) return item.goal;
-  if (item.preset) return _chunk4ROBZFL6cjs.goalForAgentPreset.call(void 0, item.preset);
+  if (item.preset) return _chunk2SLT3X6Gcjs.goalForAgentPreset.call(void 0, item.preset);
   if (_nullishCoalesce(item.patchFile, () => ( fallbackPatchFile))) return "apply supplied patch";
   return "";
 };
@@ -1351,7 +1350,7 @@ var resolveBatchRuns = (items, parsed, config) => items.map((item, index) => {
   };
 });
 var resolveParsedConfig = async (parsed) => {
-  const workspaceDiscovery = _chunk4ROBZFL6cjs.discoverNodeWorkspaceRoot.call(void 0, parsed.cwd, {
+  const workspaceDiscovery = _chunk2SLT3X6Gcjs.discoverNodeWorkspaceRoot.call(void 0, parsed.cwd, {
     enabled: parsed.discoverWorkspace
   });
   const cwdResolved = workspaceDiscovery.cwd;
@@ -1359,7 +1358,7 @@ var resolveParsedConfig = async (parsed) => {
     ...parsed,
     cwd: cwdResolved
   };
-  const loaded = await _chunk4ROBZFL6cjs.loadNodeAgentConfig.call(void 0, {
+  const loaded = await _chunk2SLT3X6Gcjs.loadNodeAgentConfig.call(void 0, {
     cwd: cwdResolved,
     configPath: parsed.configPath,
     noConfig: parsed.noConfig
@@ -1375,7 +1374,7 @@ var resolveParsedConfig = async (parsed) => {
   const batchRuns = resolveBatchRuns(batchItems, parsedAtWorkspace, loaded.config);
   return {
     ...parsedAtWorkspace,
-    goalText: parsed.goalText || (parsed.preset ? _chunk4ROBZFL6cjs.goalForAgentPreset.call(void 0, parsed.preset) : parsed.patchFile ? "apply supplied patch" : parsed.goalText),
+    goalText: parsed.goalText || (parsed.preset ? _chunk2SLT3X6Gcjs.goalForAgentPreset.call(void 0, parsed.preset) : parsed.patchFile ? "apply supplied patch" : parsed.goalText),
     mode: parsed.modeSpecified ? parsed.mode : parsed.preset === "inspect" ? "read-only" : _nullishCoalesce(loaded.config.mode, () => ( parsed.mode)),
     approval: parsed.approvalSpecified ? parsed.approval : _nullishCoalesce(loaded.config.approval, () => ( parsed.approval)),
     config: loaded.config,
@@ -1499,7 +1498,7 @@ var envByName = (name) => name ? process.env[name] : void 0;
 var makeGoogleLLMFromEnv = (config) => {
   const apiKey = _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(envByName(_optionalChain([config, 'optionalAccess', _39 => _39.apiKeyEnv])), () => ( process.env.BRASS_GOOGLE_API_KEY)), () => ( process.env.GOOGLE_API_KEY)), () => ( process.env.GEMINI_API_KEY));
   if (!apiKey) return void 0;
-  return _chunk4ROBZFL6cjs.makeGoogleGenerativeAILLM.call(void 0, {
+  return _chunk2SLT3X6Gcjs.makeGoogleGenerativeAILLM.call(void 0, {
     apiKey,
     model: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(process.env.BRASS_GOOGLE_MODEL, () => ( process.env.BRASS_LLM_MODEL)), () => ( _optionalChain([config, 'optionalAccess', _40 => _40.model]))), () => ( "gemini-2.5-flash")),
     apiVersion: _nullishCoalesce(_nullishCoalesce(process.env.BRASS_GOOGLE_API_VERSION, () => ( _optionalChain([config, 'optionalAccess', _41 => _41.apiVersion]))), () => ( "v1beta")),
@@ -1517,12 +1516,12 @@ var makeOpenAICompatibleLLMFromEnv = (config) => {
   const apiKey = _nullishCoalesce(envByName(_optionalChain([config, 'optionalAccess', _50 => _50.apiKeyEnv])), () => ( process.env.BRASS_LLM_API_KEY));
   const model = _nullishCoalesce(_nullishCoalesce(process.env.BRASS_LLM_MODEL, () => ( _optionalChain([config, 'optionalAccess', _51 => _51.model]))), () => ( "gpt-4.1"));
   if (!endpoint || !apiKey) return void 0;
-  return _chunk4ROBZFL6cjs.makeOpenAICompatibleLLM.call(void 0, { endpoint, apiKey, model });
+  return _chunk2SLT3X6Gcjs.makeOpenAICompatibleLLM.call(void 0, { endpoint, apiKey, model });
 };
 var makeLLMFromEnv = (config) => {
   const provider = _optionalChain([(_nullishCoalesce(process.env.BRASS_LLM_PROVIDER, () => ( _optionalChain([config, 'optionalAccess', _52 => _52.provider])))), 'optionalAccess', _53 => _53.trim, 'call', _54 => _54(), 'access', _55 => _55.toLowerCase, 'call', _56 => _56()]);
   const fakeResponse = _nullishCoalesce(process.env.BRASS_FAKE_LLM_RESPONSE, () => ( _optionalChain([config, 'optionalAccess', _57 => _57.fakeResponse])));
-  if (provider === "fake") return _chunk4ROBZFL6cjs.makeFakeLLM.call(void 0, { content: fakeResponse });
+  if (provider === "fake") return _chunk2SLT3X6Gcjs.makeFakeLLM.call(void 0, { content: fakeResponse });
   if (provider === "google" || provider === "gemini") {
     const google = makeGoogleLLMFromEnv(config);
     if (!google) {
@@ -1544,7 +1543,7 @@ var makeLLMFromEnv = (config) => {
   if (provider) {
     throw new Error(`Unsupported LLM provider: ${provider}`);
   }
-  return _nullishCoalesce(_nullishCoalesce(makeGoogleLLMFromEnv(config), () => ( makeOpenAICompatibleLLMFromEnv(config))), () => ( _chunk4ROBZFL6cjs.makeFakeLLM.call(void 0, { content: fakeResponse })));
+  return _nullishCoalesce(_nullishCoalesce(makeGoogleLLMFromEnv(config), () => ( makeOpenAICompatibleLLMFromEnv(config))), () => ( _chunk2SLT3X6Gcjs.makeFakeLLM.call(void 0, { content: fakeResponse })));
 };
 var parseApprovalModeFromEnv = () => {
   const raw = _optionalChain([process, 'access', _58 => _58.env, 'access', _59 => _59.BRASS_AGENT_APPROVAL, 'optionalAccess', _60 => _60.trim, 'call', _61 => _61(), 'access', _62 => _62.toLowerCase, 'call', _63 => _63()]);
@@ -1567,9 +1566,9 @@ var makeApprovalServiceFromCli = (parsed) => {
   const mode = resolveApprovalMode(parsed);
   switch (mode) {
     case "approve":
-      return _chunk4ROBZFL6cjs.autoApproveApprovals;
+      return _chunk2SLT3X6Gcjs.autoApproveApprovals;
     case "deny":
-      return _chunk4ROBZFL6cjs.makeAutoDenyApprovals.call(void 0, "Approval rejected because the CLI is running without interactive input. Use --yes to auto-approve.");
+      return _chunk2SLT3X6Gcjs.makeAutoDenyApprovals.call(void 0, "Approval rejected because the CLI is running without interactive input. Use --yes to auto-approve.");
     case "interactive":
       return makeCliApprovalService();
   }
@@ -1701,32 +1700,32 @@ var createHumanEventSink = (configPath) => ({
         console.log("");
         break;
       case "agent.action.started":
-        console.log(`\u2192 ${_chunk4ROBZFL6cjs.summarizeAgentAction.call(void 0, event.action)}`);
+        console.log(`\u2192 ${_chunk2SLT3X6Gcjs.summarizeAgentAction.call(void 0, event.action)}`);
         break;
       case "agent.action.completed": {
-        const status = _chunk4ROBZFL6cjs.observationStatus.call(void 0, event.observation);
-        console.log(`${statusIcon2(status)} ${_chunk4ROBZFL6cjs.summarizeAgentObservation.call(void 0, event.observation)} ${formatDuration(event.durationMs)}`);
+        const status = _chunk2SLT3X6Gcjs.observationStatus.call(void 0, event.observation);
+        console.log(`${statusIcon2(status)} ${_chunk2SLT3X6Gcjs.summarizeAgentObservation.call(void 0, event.observation)} ${formatDuration(event.durationMs)}`);
         break;
       }
       case "agent.action.failed":
         if (event.error._tag !== "ToolTimeout" && event.error._tag !== "PermissionDenied" && event.error._tag !== "ApprovalRejected") {
-          console.log(`\u2717 ${_chunk4ROBZFL6cjs.summarizeAgentAction.call(void 0, event.action)} failed with ${event.error._tag} ${formatDuration(event.durationMs)}`);
+          console.log(`\u2717 ${_chunk2SLT3X6Gcjs.summarizeAgentAction.call(void 0, event.action)} failed with ${event.error._tag} ${formatDuration(event.durationMs)}`);
         }
         break;
       case "agent.tool.timeout":
-        console.log(`! ${_chunk4ROBZFL6cjs.summarizeAgentAction.call(void 0, event.action)} timed out after ${event.timeoutMs}ms`);
+        console.log(`! ${_chunk2SLT3X6Gcjs.summarizeAgentAction.call(void 0, event.action)} timed out after ${event.timeoutMs}ms`);
         break;
       case "agent.permission.denied":
-        console.log(`\u2717 ${_chunk4ROBZFL6cjs.summarizeAgentAction.call(void 0, event.action)} denied: ${event.reason}`);
+        console.log(`\u2717 ${_chunk2SLT3X6Gcjs.summarizeAgentAction.call(void 0, event.action)} denied: ${event.reason}`);
         break;
       case "agent.approval.requested":
-        console.log(`? approval required for ${_chunk4ROBZFL6cjs.summarizeAgentAction.call(void 0, event.action)} (${event.risk})`);
+        console.log(`? approval required for ${_chunk2SLT3X6Gcjs.summarizeAgentAction.call(void 0, event.action)} (${event.risk})`);
         break;
       case "agent.approval.resolved":
         if (event.approved) {
-          console.log(`\u2713 approval granted for ${_chunk4ROBZFL6cjs.summarizeAgentAction.call(void 0, event.action)}`);
+          console.log(`\u2713 approval granted for ${_chunk2SLT3X6Gcjs.summarizeAgentAction.call(void 0, event.action)}`);
         } else {
-          console.log(`\u2717 approval rejected for ${_chunk4ROBZFL6cjs.summarizeAgentAction.call(void 0, event.action)}${event.reason ? `: ${event.reason}` : ""}`);
+          console.log(`\u2717 approval rejected for ${_chunk2SLT3X6Gcjs.summarizeAgentAction.call(void 0, event.action)}${event.reason ? `: ${event.reason}` : ""}`);
         }
         break;
       case "agent.patch.applied":
@@ -1831,13 +1830,13 @@ var printHumanFinalSummary = (state) => {
 };
 var makeEventsSink = (parsed, compactOptions) => parsed.output === "human" ? createHumanEventSink(parsed.resolvedConfigPath) : parsed.output === "events-json" ? createJsonEventSink(compactOptions) : parsed.output === "protocol-json" ? createProtocolEventSink(compactOptions) : void 0;
 var makeAgentEnv = (parsed, events) => {
-  const shell = _chunk4ROBZFL6cjs.NodeShell;
+  const shell = _chunk2SLT3X6Gcjs.NodeShell;
   return {
     shell,
-    fs: _chunk4ROBZFL6cjs.makeNodeFileSystem.call(void 0, shell),
-    patch: _chunk4ROBZFL6cjs.makeNodePatchService.call(void 0, shell),
+    fs: _chunk2SLT3X6Gcjs.makeNodeFileSystem.call(void 0, shell),
+    patch: _chunk2SLT3X6Gcjs.makeNodePatchService.call(void 0, shell),
     llm: makeLLMFromEnv(parsed.config.llm),
-    permissions: _chunk4ROBZFL6cjs.makeConfiguredPermissions.call(void 0, parsed.config.permissions),
+    permissions: _chunk2SLT3X6Gcjs.makeConfiguredPermissions.call(void 0, parsed.config.permissions),
     approvals: makeApprovalServiceFromCli(parsed),
     ...events ? { events } : {},
     ...parsed.config.tools ? { toolPolicies: parsed.config.tools } : {}
@@ -1854,10 +1853,10 @@ var singleRunFromParsed = (parsed) => ({
 });
 var runCliAgent = async (parsed, run, compactOptions, events) => {
   const env = makeAgentEnv(parsed, events);
-  const runtime = new (0, _chunkGLE2WY7Zcjs.Runtime)({ env });
+  const runtime = new (0, _chunkSSQJKDN3cjs.Runtime)({ env });
   const initialPatch = run.patchFile ? await readPatchFile(run.cwd, run.patchFile) : void 0;
   const state = await runtime.toPromise(
-    _chunk4ROBZFL6cjs.runAgent.call(void 0, runtime, {
+    _chunk2SLT3X6Gcjs.runAgent.call(void 0, runtime, {
       id: `agent-${Date.now()}-${run.index + 1}`,
       cwd: run.cwd,
       text: run.goalText,

package/dist/agent/cli/main.js

@@ -17,18 +17,17 @@ import {
   runAgent,
   summarizeAgentAction,
   summarizeAgentObservation
-} from "../../chunk-52OB2ROS.js";
+} from "../../chunk-ITG6I7ZS.js";
 import "../../chunk-UCUBNWM2.js";
-import "../../chunk-L2SYFEBS.js";
 import {
   Runtime
-} from "../../chunk-FH2X7BVP.js";
+} from "../../chunk-XSAHV5HQ.js";
 import {
   Cause,
   Exit,
   asyncEffect
 } from "../../chunk-UB4B6OFY.js";
-import "../../chunk-C3MDXTRZ.js";
+import "../../chunk-HCJ4S3YB.js";
 import "../../chunk-3RG5ZIWI.js";
 
 // src/agent/cli/approvals.ts

package/dist/agent/cli/main.mjs

@@ -17,18 +17,17 @@ import {
   runAgent,
   summarizeAgentAction,
   summarizeAgentObservation
-} from "../../chunk-MBEJI5HF.mjs";
+} from "../../chunk-R6WDSZA6.mjs";
 import "../../chunk-B5JD23U7.mjs";
-import "../../chunk-A2OM6NEH.mjs";
 import {
   Runtime
-} from "../../chunk-GYM3LLGS.mjs";
+} from "../../chunk-2QNREG6K.mjs";
 import {
   Cause,
   Exit,
   asyncEffect
 } from "../../chunk-36I3M4UC.mjs";
-import "../../chunk-DNFJLJMW.mjs";
+import "../../chunk-6MLAZPBL.mjs";
 import "../../chunk-Y6FXYEAI.mjs";
 
 // src/agent/cli/approvals.ts

package/dist/agent/index.cjs

@@ -73,12 +73,11 @@
 
 
 
-var _chunk4ROBZFL6cjs = require('../chunk-4ROBZFL6.cjs');
+var _chunk2SLT3X6Gcjs = require('../chunk-2SLT3X6G.cjs');
 require('../chunk-SA6HUJVI.cjs');
-require('../chunk-JF5WGYJJ.cjs');
-require('../chunk-GLE2WY7Z.cjs');
+require('../chunk-SSQJKDN3.cjs');
 require('../chunk-MVGUEJ5Z.cjs');
-require('../chunk-CZIVE6NT.cjs');
+require('../chunk-UUMKZJRJ.cjs');
 require('../chunk-OBGZSXTJ.cjs');
 
 
@@ -155,4 +154,4 @@ require('../chunk-OBGZSXTJ.cjs');
 
 
 
-exports.AGENT_CONFIG_FILE_NAMES = _chunk4ROBZFL6cjs.AGENT_CONFIG_FILE_NAMES; exports.NodeShell = _chunk4ROBZFL6cjs.NodeShell; exports.PROJECT_LOCKFILE_PROBES = _chunk4ROBZFL6cjs.PROJECT_LOCKFILE_PROBES; exports.PROJECT_PROFILE_PROBES = _chunk4ROBZFL6cjs.PROJECT_PROFILE_PROBES; exports.autoApproveApprovals = _chunk4ROBZFL6cjs.autoApproveApprovals; exports.canAutoRollback = _chunk4ROBZFL6cjs.canAutoRollback; exports.canRequestPatchRepair = _chunk4ROBZFL6cjs.canRequestPatchRepair; exports.commandForScript = _chunk4ROBZFL6cjs.commandForScript; exports.decideNextAction = _chunk4ROBZFL6cjs.decideNextAction; exports.defaultPermissions = _chunk4ROBZFL6cjs.defaultPermissions; exports.deriveContextSearchQueries = _chunk4ROBZFL6cjs.deriveContextSearchQueries; exports.describeCommandDiscovery = _chunk4ROBZFL6cjs.describeCommandDiscovery; exports.describeContextDiscovery = _chunk4ROBZFL6cjs.describeContextDiscovery; exports.describeLanguagePolicy = _chunk4ROBZFL6cjs.describeLanguagePolicy; exports.describePatchQuality = _chunk4ROBZFL6cjs.describePatchQuality; exports.describeProjectProfile = _chunk4ROBZFL6cjs.describeProjectProfile; exports.describeRollbackSafety = _chunk4ROBZFL6cjs.describeRollbackSafety; exports.discoverNodeWorkspaceRoot = _chunk4ROBZFL6cjs.discoverNodeWorkspaceRoot; exports.discoverPackageManager = _chunk4ROBZFL6cjs.discoverPackageManager; exports.discoverProjectProfile = _chunk4ROBZFL6cjs.discoverProjectProfile; exports.discoverValidationCommands = _chunk4ROBZFL6cjs.discoverValidationCommands; exports.emitAgentEvent = _chunk4ROBZFL6cjs.emitAgentEvent; exports.emitAgentEvents = _chunk4ROBZFL6cjs.emitAgentEvents; exports.errorEventFor = _chunk4ROBZFL6cjs.errorEventFor; exports.extractLikelyFilePaths = _chunk4ROBZFL6cjs.extractLikelyFilePaths; exports.extractPatchPaths = _chunk4ROBZFL6cjs.extractPatchPaths; exports.extractUnifiedDiff = _chunk4ROBZFL6cjs.extractUnifiedDiff; exports.goalForAgentPreset = _chunk4ROBZFL6cjs.goalForAgentPreset; exports.inferUserLanguage = _chunk4ROBZFL6cjs.inferUserLanguage; exports.initialAgentState = _chunk4ROBZFL6cjs.initialAgentState; exports.invokeAction = _chunk4ROBZFL6cjs.invokeAction; exports.isAgentConfigApprovalMode = _chunk4ROBZFL6cjs.isAgentConfigApprovalMode; exports.isAgentConfigLLMProvider = _chunk4ROBZFL6cjs.isAgentConfigLLMProvider; exports.isAgentConfigMode = _chunk4ROBZFL6cjs.isAgentConfigMode; exports.isAgentPreset = _chunk4ROBZFL6cjs.isAgentPreset; exports.isRedactionEnabled = _chunk4ROBZFL6cjs.isRedactionEnabled; exports.isTerminal = _chunk4ROBZFL6cjs.isTerminal; exports.latestUnappliedPatch = _chunk4ROBZFL6cjs.latestUnappliedPatch; exports.loadNodeAgentConfig = _chunk4ROBZFL6cjs.loadNodeAgentConfig; exports.makeAutoDenyApprovals = _chunk4ROBZFL6cjs.makeAutoDenyApprovals; exports.makeConfiguredPermissions = _chunk4ROBZFL6cjs.makeConfiguredPermissions; exports.makeFakeLLM = _chunk4ROBZFL6cjs.makeFakeLLM; exports.makeGoogleGenerativeAILLM = _chunk4ROBZFL6cjs.makeGoogleGenerativeAILLM; exports.makeNodeFileSystem = _chunk4ROBZFL6cjs.makeNodeFileSystem; exports.makeNodePatchService = _chunk4ROBZFL6cjs.makeNodePatchService; exports.makeOpenAICompatibleLLM = _chunk4ROBZFL6cjs.makeOpenAICompatibleLLM; exports.nextContextDiscoveryAction = _chunk4ROBZFL6cjs.nextContextDiscoveryAction; exports.nextProjectProbeAction = _chunk4ROBZFL6cjs.nextProjectProbeAction; exports.nextUnrunValidationCommand = _chunk4ROBZFL6cjs.nextUnrunValidationCommand; exports.nowMillis = _chunk4ROBZFL6cjs.nowMillis; exports.observationEventFor = _chunk4ROBZFL6cjs.observationEventFor; exports.observationStatus = _chunk4ROBZFL6cjs.observationStatus; exports.parseProjectPackageJson = _chunk4ROBZFL6cjs.parseProjectPackageJson; exports.patchQualitySummary = _chunk4ROBZFL6cjs.patchQualitySummary; exports.patchRepairAttemptsUsed = _chunk4ROBZFL6cjs.patchRepairAttemptsUsed; exports.patchValidationStatus = _chunk4ROBZFL6cjs.patchValidationStatus; exports.projectProfileProbePending = _chunk4ROBZFL6cjs.projectProfileProbePending; exports.redactText = _chunk4ROBZFL6cjs.redactText; exports.reduceAgentState = _chunk4ROBZFL6cjs.reduceAgentState; exports.responseLanguageName = _chunk4ROBZFL6cjs.responseLanguageName; exports.retry = _chunk4ROBZFL6cjs.retry; exports.rollbackSafetySummary = _chunk4ROBZFL6cjs.rollbackSafetySummary; exports.runAgent = _chunk4ROBZFL6cjs.runAgent; exports.runStatusFor = _chunk4ROBZFL6cjs.runStatusFor; exports.shouldContinueRollbackStack = _chunk4ROBZFL6cjs.shouldContinueRollbackStack; exports.sleep = _chunk4ROBZFL6cjs.sleep; exports.spanishLike = _chunk4ROBZFL6cjs.spanishLike; exports.splitCommand = _chunk4ROBZFL6cjs.splitCommand; exports.summarizeAgentAction = _chunk4ROBZFL6cjs.summarizeAgentAction; exports.summarizeAgentObservation = _chunk4ROBZFL6cjs.summarizeAgentObservation; exports.summarizeContextDiscovery = _chunk4ROBZFL6cjs.summarizeContextDiscovery; exports.timeout = _chunk4ROBZFL6cjs.timeout; exports.unappliedPatchStack = _chunk4ROBZFL6cjs.unappliedPatchStack; exports.workspaceValidationStatus = _chunk4ROBZFL6cjs.workspaceValidationStatus;
+exports.AGENT_CONFIG_FILE_NAMES = _chunk2SLT3X6Gcjs.AGENT_CONFIG_FILE_NAMES; exports.NodeShell = _chunk2SLT3X6Gcjs.NodeShell; exports.PROJECT_LOCKFILE_PROBES = _chunk2SLT3X6Gcjs.PROJECT_LOCKFILE_PROBES; exports.PROJECT_PROFILE_PROBES = _chunk2SLT3X6Gcjs.PROJECT_PROFILE_PROBES; exports.autoApproveApprovals = _chunk2SLT3X6Gcjs.autoApproveApprovals; exports.canAutoRollback = _chunk2SLT3X6Gcjs.canAutoRollback; exports.canRequestPatchRepair = _chunk2SLT3X6Gcjs.canRequestPatchRepair; exports.commandForScript = _chunk2SLT3X6Gcjs.commandForScript; exports.decideNextAction = _chunk2SLT3X6Gcjs.decideNextAction; exports.defaultPermissions = _chunk2SLT3X6Gcjs.defaultPermissions; exports.deriveContextSearchQueries = _chunk2SLT3X6Gcjs.deriveContextSearchQueries; exports.describeCommandDiscovery = _chunk2SLT3X6Gcjs.describeCommandDiscovery; exports.describeContextDiscovery = _chunk2SLT3X6Gcjs.describeContextDiscovery; exports.describeLanguagePolicy = _chunk2SLT3X6Gcjs.describeLanguagePolicy; exports.describePatchQuality = _chunk2SLT3X6Gcjs.describePatchQuality; exports.describeProjectProfile = _chunk2SLT3X6Gcjs.describeProjectProfile; exports.describeRollbackSafety = _chunk2SLT3X6Gcjs.describeRollbackSafety; exports.discoverNodeWorkspaceRoot = _chunk2SLT3X6Gcjs.discoverNodeWorkspaceRoot; exports.discoverPackageManager = _chunk2SLT3X6Gcjs.discoverPackageManager; exports.discoverProjectProfile = _chunk2SLT3X6Gcjs.discoverProjectProfile; exports.discoverValidationCommands = _chunk2SLT3X6Gcjs.discoverValidationCommands; exports.emitAgentEvent = _chunk2SLT3X6Gcjs.emitAgentEvent; exports.emitAgentEvents = _chunk2SLT3X6Gcjs.emitAgentEvents; exports.errorEventFor = _chunk2SLT3X6Gcjs.errorEventFor; exports.extractLikelyFilePaths = _chunk2SLT3X6Gcjs.extractLikelyFilePaths; exports.extractPatchPaths = _chunk2SLT3X6Gcjs.extractPatchPaths; exports.extractUnifiedDiff = _chunk2SLT3X6Gcjs.extractUnifiedDiff; exports.goalForAgentPreset = _chunk2SLT3X6Gcjs.goalForAgentPreset; exports.inferUserLanguage = _chunk2SLT3X6Gcjs.inferUserLanguage; exports.initialAgentState = _chunk2SLT3X6Gcjs.initialAgentState; exports.invokeAction = _chunk2SLT3X6Gcjs.invokeAction; exports.isAgentConfigApprovalMode = _chunk2SLT3X6Gcjs.isAgentConfigApprovalMode; exports.isAgentConfigLLMProvider = _chunk2SLT3X6Gcjs.isAgentConfigLLMProvider; exports.isAgentConfigMode = _chunk2SLT3X6Gcjs.isAgentConfigMode; exports.isAgentPreset = _chunk2SLT3X6Gcjs.isAgentPreset; exports.isRedactionEnabled = _chunk2SLT3X6Gcjs.isRedactionEnabled; exports.isTerminal = _chunk2SLT3X6Gcjs.isTerminal; exports.latestUnappliedPatch = _chunk2SLT3X6Gcjs.latestUnappliedPatch; exports.loadNodeAgentConfig = _chunk2SLT3X6Gcjs.loadNodeAgentConfig; exports.makeAutoDenyApprovals = _chunk2SLT3X6Gcjs.makeAutoDenyApprovals; exports.makeConfiguredPermissions = _chunk2SLT3X6Gcjs.makeConfiguredPermissions; exports.makeFakeLLM = _chunk2SLT3X6Gcjs.makeFakeLLM; exports.makeGoogleGenerativeAILLM = _chunk2SLT3X6Gcjs.makeGoogleGenerativeAILLM; exports.makeNodeFileSystem = _chunk2SLT3X6Gcjs.makeNodeFileSystem; exports.makeNodePatchService = _chunk2SLT3X6Gcjs.makeNodePatchService; exports.makeOpenAICompatibleLLM = _chunk2SLT3X6Gcjs.makeOpenAICompatibleLLM; exports.nextContextDiscoveryAction = _chunk2SLT3X6Gcjs.nextContextDiscoveryAction; exports.nextProjectProbeAction = _chunk2SLT3X6Gcjs.nextProjectProbeAction; exports.nextUnrunValidationCommand = _chunk2SLT3X6Gcjs.nextUnrunValidationCommand; exports.nowMillis = _chunk2SLT3X6Gcjs.nowMillis; exports.observationEventFor = _chunk2SLT3X6Gcjs.observationEventFor; exports.observationStatus = _chunk2SLT3X6Gcjs.observationStatus; exports.parseProjectPackageJson = _chunk2SLT3X6Gcjs.parseProjectPackageJson; exports.patchQualitySummary = _chunk2SLT3X6Gcjs.patchQualitySummary; exports.patchRepairAttemptsUsed = _chunk2SLT3X6Gcjs.patchRepairAttemptsUsed; exports.patchValidationStatus = _chunk2SLT3X6Gcjs.patchValidationStatus; exports.projectProfileProbePending = _chunk2SLT3X6Gcjs.projectProfileProbePending; exports.redactText = _chunk2SLT3X6Gcjs.redactText; exports.reduceAgentState = _chunk2SLT3X6Gcjs.reduceAgentState; exports.responseLanguageName = _chunk2SLT3X6Gcjs.responseLanguageName; exports.retry = _chunk2SLT3X6Gcjs.retry; exports.rollbackSafetySummary = _chunk2SLT3X6Gcjs.rollbackSafetySummary; exports.runAgent = _chunk2SLT3X6Gcjs.runAgent; exports.runStatusFor = _chunk2SLT3X6Gcjs.runStatusFor; exports.shouldContinueRollbackStack = _chunk2SLT3X6Gcjs.shouldContinueRollbackStack; exports.sleep = _chunk2SLT3X6Gcjs.sleep; exports.spanishLike = _chunk2SLT3X6Gcjs.spanishLike; exports.splitCommand = _chunk2SLT3X6Gcjs.splitCommand; exports.summarizeAgentAction = _chunk2SLT3X6Gcjs.summarizeAgentAction; exports.summarizeAgentObservation = _chunk2SLT3X6Gcjs.summarizeAgentObservation; exports.summarizeContextDiscovery = _chunk2SLT3X6Gcjs.summarizeContextDiscovery; exports.timeout = _chunk2SLT3X6Gcjs.timeout; exports.unappliedPatchStack = _chunk2SLT3X6Gcjs.unappliedPatchStack; exports.workspaceValidationStatus = _chunk2SLT3X6Gcjs.workspaceValidationStatus;

package/dist/agent/index.d.ts

@@ -1,4 +1,4 @@
-import { A as Async, f as Runtime, S as Scope } from '../effect-DIUHZ9IN.js';
+import { A as Async, b as Runtime, S as Scope } from '../effect-CtUDl5M5.js';
 
 type AgentMode = "read-only" | "propose" | "write" | "autonomous";
 type AgentPackageManager = "npm" | "pnpm" | "yarn" | "bun";

package/dist/agent/index.js

@@ -73,12 +73,11 @@ import {
   timeout,
   unappliedPatchStack,
   workspaceValidationStatus
-} from "../chunk-52OB2ROS.js";
+} from "../chunk-ITG6I7ZS.js";
 import "../chunk-UCUBNWM2.js";
-import "../chunk-L2SYFEBS.js";
-import "../chunk-FH2X7BVP.js";
+import "../chunk-XSAHV5HQ.js";
 import "../chunk-UB4B6OFY.js";
-import "../chunk-C3MDXTRZ.js";
+import "../chunk-HCJ4S3YB.js";
 import "../chunk-3RG5ZIWI.js";
 export {
   AGENT_CONFIG_FILE_NAMES,

package/dist/agent/index.mjs

@@ -73,12 +73,11 @@ import {
   timeout,
   unappliedPatchStack,
   workspaceValidationStatus
-} from "../chunk-MBEJI5HF.mjs";
+} from "../chunk-R6WDSZA6.mjs";
 import "../chunk-B5JD23U7.mjs";
-import "../chunk-A2OM6NEH.mjs";
-import "../chunk-GYM3LLGS.mjs";
+import "../chunk-2QNREG6K.mjs";
 import "../chunk-36I3M4UC.mjs";
-import "../chunk-DNFJLJMW.mjs";
+import "../chunk-6MLAZPBL.mjs";
 import "../chunk-Y6FXYEAI.mjs";
 export {
   AGENT_CONFIG_FILE_NAMES,

package/dist/{chunk-GYM3LLGS.mjs → chunk-2QNREG6K.mjs}

@@ -2,12 +2,15 @@ import {
   Async,
   Cause,
   Exit,
-  asyncEffect
+  asyncEffect,
+  asyncFlatMap,
+  asyncFold,
+  unit
 } from "./chunk-36I3M4UC.mjs";
 import {
   Schema,
   parseConfig
-} from "./chunk-DNFJLJMW.mjs";
+} from "./chunk-6MLAZPBL.mjs";
 
 // src/core/runtime/ringBuffer.ts
 var PushStatus = /* @__PURE__ */ ((PushStatus3) => {
@@ -2978,7 +2981,7 @@ var Runtime = class _Runtime {
     if (this.hooks !== NoopHooks) return false;
     if (getCurrentFiber() !== null) return false;
     if (this.scheduler !== globalScheduler) return false;
-    if (this.lane !== void 0 || this.inferLane) return false;
+    if (this.inferLane) return false;
     if (this.engineMode !== "ts") return false;
     new NativeTopLevelRunner(this, effect, cb).start();
     return true;
@@ -3137,7 +3140,7 @@ var NativeTopLevelRunner = class {
         syncExit = exit;
         return;
       }
-      queueMicrotask(() => this.resumeAsync(exit));
+      this.resumeAsync(exit);
     };
     try {
       current.register(this.runtime.env, resume);
@@ -4035,6 +4038,183 @@ var JsFiberEngine = class {
   }
 };
 
+// src/core/runtime/scope.ts
+var nextScopeId = 1;
+function awaitAll(fibers) {
+  return asyncEffect((_env, cb) => {
+    let remaining = fibers.length;
+    if (remaining === 0) {
+      cb({ _tag: "Success", value: void 0 });
+      return;
+    }
+    for (const f of fibers) {
+      f.join(() => {
+        remaining -= 1;
+        if (remaining === 0) cb({ _tag: "Success", value: void 0 });
+      });
+    }
+  });
+}
+var Scope = class _Scope {
+  constructor(runtime, parentScopeId) {
+    this.runtime = runtime;
+    this.parentScopeId = parentScopeId;
+    this.id = nextScopeId++;
+    const inferredParent = this.parentScopeId ?? getCurrentFiber()?.scopeId;
+    if (this.runtime.hasActiveHooks()) {
+      this.runtime.emit({
+        type: "scope.open",
+        scopeId: this.id,
+        parentScopeId: inferredParent
+      });
+    }
+  }
+  runtime;
+  parentScopeId;
+  id;
+  closed = false;
+  children = /* @__PURE__ */ new Set();
+  subScopes = /* @__PURE__ */ new Set();
+  finalizers = [];
+  /** registra un finalizer (LIFO) */
+  addFinalizer(f) {
+    if (this.closed) {
+      throw new Error("Trying to add finalizer to closed scope");
+    }
+    this.finalizers.push(f);
+  }
+  /** crea un sub scope (mismo runtime) */
+  subScope() {
+    if (this.closed) throw new Error("Scope closed");
+    const s = new _Scope(this.runtime, this.id);
+    this.subScopes.add(s);
+    return s;
+  }
+  /** ✅ fork en este scope */
+  fork(eff) {
+    if (this.closed) throw new Error("Scope closed");
+    const f = this.runtime.fork(eff, this.id);
+    this.children.add(f);
+    f.join(() => this.children.delete(f));
+    return f;
+  }
+  /** close fire-and-forget (no bloquea) */
+  close(exit = { _tag: "Success", value: void 0 }) {
+    this.runtime.fork(this.closeAsync(exit));
+  }
+  /** Emit the scope.close event if hooks are active. */
+  emitCloseEvent(exit) {
+    if (this.runtime.hasActiveHooks()) {
+      const status = exit._tag === "Success" ? "success" : Cause.isInterruptedOnly(exit.cause) ? "interrupted" : "failure";
+      const failure = exit._tag === "Failure" ? Cause.firstFailure(exit.cause) : void 0;
+      this.runtime.emit({
+        type: "scope.close",
+        scopeId: this.id,
+        status,
+        error: failure?._tag === "Some" ? failure.value : exit._tag === "Failure" ? exit.cause : void 0
+      });
+    }
+  }
+  /**
+   * Build an effect that executes finalizers in LIFO order.
+   *
+   * Optimization over the original: instead of wrapping every finalizer in
+   * `asyncFold(fin(exit), () => unit(), () => unit())` which creates 3 effect
+   * nodes per finalizer (Fold + 2 Succeed), we use a single Sync thunk per
+   * finalizer that catches errors inline.  When the finalizer returns a
+   * Succeed effect (like `unit()`), the Sync thunk completes without creating
+   * additional effect nodes.
+   */
+  buildFinalizerEffect(exit) {
+    const fins = this.finalizers;
+    if (fins.length === 0) return unit();
+    let chain = unit();
+    for (let i = fins.length - 1; i >= 0; i--) {
+      const fin = fins[i];
+      chain = asyncFlatMap(chain, () => {
+        let result;
+        try {
+          result = fin(exit);
+        } catch {
+          return unit();
+        }
+        if (result._tag === "Succeed") {
+          return unit();
+        }
+        return asyncFold(
+          result,
+          () => unit(),
+          () => unit()
+        );
+      });
+    }
+    return chain;
+  }
+  closeAsync(exit = { _tag: "Success", value: void 0 }, opts = { awaitChildren: true }) {
+    return asyncFlatMap(
+      unit(),
+      () => asyncEffect((env, cb) => {
+        if (this.closed) {
+          cb({ _tag: "Success", value: void 0 });
+          return;
+        }
+        this.closed = true;
+        const children = Array.from(this.children);
+        const subScopes = Array.from(this.subScopes);
+        for (const child of children) {
+          child.interrupt();
+        }
+        const closeSubs = subScopes.reduceRight(
+          (acc, s) => asyncFlatMap(acc, () => s.closeAsync(exit, opts)),
+          unit()
+        );
+        const runFinalizers = this.buildFinalizerEffect(exit);
+        const needsAwait = opts.awaitChildren && children.length > 0;
+        const awaitChildrenEff = needsAwait ? awaitAll(children) : unit();
+        const hasSubScopes = subScopes.length > 0;
+        const hasNoFinalizers = this.finalizers.length === 0;
+        if (!hasSubScopes && !needsAwait && hasNoFinalizers) {
+          this.emitCloseEvent(exit);
+          cb({ _tag: "Success", value: void 0 });
+          return;
+        }
+        const all = asyncFlatMap(closeSubs, () => asyncFlatMap(awaitChildrenEff, () => runFinalizers));
+        this.runtime.fork(all).join(() => {
+          this.emitCloseEvent(exit);
+          cb({ _tag: "Success", value: void 0 });
+        });
+      })
+    );
+  }
+};
+function withScopeAsync(runtime, f) {
+  return asyncEffect((_env, cb) => {
+    const scope = new Scope(runtime);
+    let done = false;
+    const completeAfterClose = (exit) => {
+      runtime.fork(scope.closeAsync(exit)).join(() => {
+        if (done) return;
+        done = true;
+        cb(exit);
+      });
+    };
+    const fiber = runtime.fork(f(scope));
+    fiber.join(completeAfterClose);
+    return () => {
+      if (done) return;
+      fiber.interrupt();
+      runtime.fork(scope.closeAsync(Exit.failCause(Cause.interrupt())));
+    };
+  });
+}
+function withScope(runtime, f) {
+  return withScopeAsync(runtime, (scope) => {
+    const out = f(scope);
+    if (out && typeof out === "object" && "_tag" in out) return out;
+    return unit();
+  });
+}
+
 export {
   PushStatus,
   RingBuffer,
@@ -4085,5 +4265,8 @@ export {
   RuntimeFiber,
   getCurrentFiber,
   unsafeGetCurrentRuntime,
-  withCurrentFiber
+  withCurrentFiber,
+  Scope,
+  withScopeAsync,
+  withScope
 };