brass-runtime 1.13.7 → 1.14.0

package/README.md

@@ -1,58 +1,234 @@
-# Documentation
+# 🛠️ brass-runtime — Mini ZIO-like runtime in TypeScript
+
+A small experimental runtime inspired by **ZIO 2**, implemented in vanilla TypeScript and intentionally built without using `Promise` / `async`/`await` as the **primary semantic primitive**.
+
+`brass-runtime` is the foundation: it provides an effect system, fibers, scheduler, scopes, and streams.
+Higher-level modules (HTTP, streaming utilities, integrations) are built **on top of the runtime**, not baked into it.
+
+> You can still interop with the outside world (timers, fetch, Node APIs) via explicit, cancellable bridges such as `fromPromiseAbortable`.
+
+---
+
+## Philosophy
+
+- **Effects are values** — lazy, composable, referentially transparent
+- **Async is explicit** — no hidden Promise semantics
+- **Concurrency is structured** — fibers, scopes, finalizers
+- **Side effects are interpreted** — not executed eagerly
+- **Higher-level APIs are libraries, not magic**
+
+If you like ZIO’s separation between `zio-core`, `zio-streams`, and `zio-http`, this project follows the same spirit.
+
+---
+
+## Core concepts
+
+- Sync core effect: `Effect<R, E, A>` and `Exit<E, A>`
+- Algebraic async representation: `Async<R, E, A>`
+- Cooperative `Scheduler` (observable / testable)
+- Lightweight `Fiber`s with interruption & finalizers
+- Structured `Scope`s for resource safety
+- ZStream-style streams with backpressure
+
+---
+
+## Install
+
+```bash
+npm i brass-runtime
+```
+
+---
+
+## Quick start
+
+### Run an effect
+
+```ts
+import { Runtime, succeed, toPromise } from "brass-runtime";
+
+const runtime = new Runtime({ env: {} });
+
+const value = await toPromise(succeed(123), runtime.env);
+console.log(value); // 123
+```
+
+### Structured concurrency with Scope
+
+```ts
+import { Runtime, withScope } from "brass-runtime";
+
+const runtime = new Runtime({ env: {} });
+
+withScope(runtime, (scope) => {
+  const f = scope.fork(/* Async effect */);
+  // later...
+  scope.close(); // interrupts child fibers + runs finalizers
+});
+```
+
+> `toPromise` is just a convenience bridge for examples/DX. The runtime semantics remain explicit.
+
+---
+
+## Modules built on top of brass-runtime
+
+These are optional layers, implemented using the runtime primitives.
+
+### 🌐 HTTP client (brass-http layer)
+
+A ZIO-style HTTP client built on top of fibers and `Async`.
+
+- Lazy & cancelable HTTP requests
+- Explicit wire/content separation
+- Middleware-friendly (logging, retry, timeout, etc.)
+- Integrated with fiber interruption via `AbortController`
+
+👉 **Docs:** [HTTP module](./docs/http.md)
+
+Example:
+
+```ts
+import { Runtime, toPromise } from "brass-runtime";
+import { httpClientStream } from "brass-runtime/http";
+
+type Post = { id: number; title: string; body: string };
+
+const runtime = new Runtime({ env: {} });
+
+const client = httpClientStream({ baseUrl: "https://jsonplaceholder.typicode.com" });
+
+const res = await toPromise(client.getJson<Post>("/posts/1"), runtime.env);
+console.log(res.status, res.value.title);
+```
+
+---
+
+### 🤖 Brass Agent (experimental)
+
+A CLI-first coding agent built on top of the runtime. Brass Agent is currently experimental: it can inspect a workspace, discover validation commands, gather bounded context, ask an LLM for a patch, apply/rollback patches through explicit policies, and expose a thin VS Code extension over the CLI protocol.
 
 Start here:
 
-- **[Getting started](./getting-started.md)** — installation, first effects, and running examples
-- **[Architecture](./ARCHITECTURE.md)** — how the runtime is structured
-- **[Cancellation & interruption](./cancellation.md)** — interruption semantics, scopes, and cancellable `Async`
-- **[Observability](./observability.md)** — hooks, events, sinks, and tracing
-- **[HTTP client](./http.md)** — ZIO-style HTTP built on brass-runtime
-- **[Modules overview](./modules.md)** — map of core modules and where things live
-- **[Agent module boundaries](./agent-boundaries.md)** — rules for keeping `brass-agent` isolated from the core runtime
-- **[Brass Agent install and configure](./agent-install-and-configure.md)** — end-to-end local setup for CLI, config, providers, and VS Code
-
-- [Agent LLM adapters](./agent-llm-adapters.md)
-- [Agent env files](./agent-env-files.md)
-- [Agent global usage and workspace discovery](./agent-global-usage.md)
-- [Agent apply mode](./agent-apply-mode.md)
-- [Brass Agent CLI](./agent-cli.md)
-- [Agent init](./agent-init.md)
-- [Agent observability](./agent-observability.md)
-- [Agent approvals](./agent-approvals.md)
-- [Agent config and policy files](./agent-config.md)
-- [Agent project command discovery](./agent-project-commands.md)
-- [Agent project intelligence](./agent-project-intelligence.md)
-- [Declarative optimized planning roadmap](./agent-declarative-optimized-planning.md)
-- [Agent context discovery](./agent-context-discovery.md)
-- [Agent patch quality loop](./agent-patch-quality-loop.md)
-- [Agent automatic rollback safety](./agent-rollback-safety.md)
-- [Agent DX surfaces](./agent-dx.md)
-
-- [VS Code patch preview](./agent-vscode-patch-preview.md)
-- [VS Code enhanced diff preview](./agent-vscode-diff-preview.md)
-- [VS Code run history](./agent-vscode-run-history.md)
-- [VS Code batch runner](./agent-vscode-batch-runner.md)
-- [VS Code UX](./agent-vscode-ux.md)
-- [VS Code Project dashboard](./agent-vscode-project-dashboard.md)
-- [VS Code Chat layout / focus mode](./agent-vscode-chat-layout.md)
-- [Copilot-like VS Code DX](./agent-copilot-like-dx.md)
-- [Chat sessions and slash commands](./agent-chat-sessions.md)
-- [Agent follow-up context](./agent-follow-up-context.md)
-- [VS Code code actions](./agent-vscode-code-actions.md)
-- [VS Code problems-aware chat](./agent-vscode-problems.md)
-- [VS Code inline assist](./agent-vscode-inline-assist.md)
-- [Agent release readiness](./agent-release-readiness.md)
-- [VS Code local install](./agent-vscode-install.md)
-- [VS Code auto-discovery](./agent-vscode-auto-discovery.md)
-- [VS Code model setup](./agent-vscode-model-setup.md)
-- [Agent local install and doctor](./agent-local-install.md)
-- [Agent local tests](./agent-local-tests.md)
-
-- [Agent rollback patches](./agent-rollback.md)
-- [Agent redaction](./agent-redaction.md)
-- [Agent run artifacts](./agent-run-artifacts.md)
-- [Agent CI mode](./agent-ci.md)
-- [Agent presets](./agent-presets.md)
-- [Agent batch runs](./agent-batch.md)
-- [VS Code full clean and reinstall](./agent-vscode-clean-install.md)
-- [Agent language and workspace setup UX](agent-language-workspace-ux.md)
+- [Install and configure Brass Agent](./docs/agent-install-and-configure.md)
+- [Declarative optimized planning roadmap](./docs/agent-declarative-optimized-planning.md)
+- [Brass Agent CLI](./docs/agent-cli.md)
+- [Project intelligence](./docs/agent-project-intelligence.md)
+- [Global usage and workspace discovery](./docs/agent-global-usage.md)
+- [VS Code local install](./docs/agent-vscode-install.md)
+- [VS Code auto-discovery](./docs/agent-vscode-auto-discovery.md)
+- [VS Code model setup](./docs/agent-vscode-model-setup.md)
+- [VS Code chat layout / focus mode](./docs/agent-vscode-chat-layout.md)
+
+```bash
+npm run agent:vscode:install
+# then open any repo in VS Code and use Brass Agent -> Chat
+
+npm run build
+npm run agent:link
+brass-agent --where
+brass-agent --doctor
+brass-agent --init
+brass-agent --preset inspect
+```
+
+---
+
+### 🌊 Streams (ZStream-like)
+
+Pull-based, resource-aware streams with backpressure.
+
+- `ZStream<R, E, A>`
+- `Pull` semantics
+- Bounded buffers
+- Deterministic resource cleanup
+
+Examples:
+
+- `src/examples/fromPromise.ts`
+- `src/examples/mergeStreamSync.ts`
+
+---
+
+## Docs
+
+- [Getting Started](./docs/getting-started.md)
+- [Architecture](./docs/ARCHITECTURE.md)
+- [Cancellation & Interruption](./docs/cancellation.md)
+- [Observability: Hooks & Tracing](./docs/observability.md)
+- [HTTP module](./docs/http.md)
+- [Modules overview](./docs/modules.md)
+- [Install and configure Brass Agent](./docs/agent-install-and-configure.md)
+- [Declarative optimized planning roadmap](./docs/agent-declarative-optimized-planning.md)
+
+---
+
+## What’s new (recent changes)
+
+- Stream buffering with backpressure (`buffer`)
+- Abortable async integration (`fromPromiseAbortable`)
+- Fiber-safe `toPromise` for examples & DX
+- HTTP client module built on top of the runtime
+
+---
+
+## Features (status)
+
+### Runtime (core)
+
+- [x] Sync core: `Effect`
+- [x] Async algebra: `Async`
+- [x] Cooperative `Scheduler`
+- [x] Fibers with interruption & finalizers
+- [x] Structured `Scope`
+- [x] Resource safety (`acquireRelease`)
+
+### Concurrency & Streams
+
+- [x] `race`, `zipPar`, `collectAllPar`
+- [x] ZStream-like core
+- [x] Bounded buffers & backpressure
+- [x] Stream merge / zip
+- [x] Hubs / Broadcast
+- [x] Pipelines (`ZPipeline`-style)
+
+### Libraries
+
+- [x] HTTP client
+- [ ] Retry / timeout middleware
+- [ ] Logging / metrics layers
+
+---
+
+## Design notes
+
+- **No hidden Promises**: async is always modeled explicitly
+- **Deterministic execution**: scheduler is observable & testable
+- **Resource safety is structural**: scopes guarantee cleanup
+- **Libraries compose via functions**: middleware, not inheritance
+
+---
+
+## Contributing
+
+- Runtime invariants matter — avoid sneaking Promises into semantics
+- Prefer libraries on top of the runtime over changes in the core
+- Small, focused PRs are welcome (your repo may enforce PR-only changes)
+
+---
+
+## License
+
+MIT License © 2025
+
+## Brass Agent local smoke tests
+
+Run local smoke tests without CI or a real LLM provider:
+
+```bash
+npm run agent:test:local
+```
+
+This builds the project and runs a fake-LLM smoke test against the `brass-agent` CLI.
+
+See also: [Agent language and workspace setup UX](docs/agent-language-workspace-ux.md).

package/dist/agent/cli/main.cjs

@@ -17,13 +17,13 @@
 
 
 
-var _chunkXDINDYNAcjs = require('../../chunk-XDINDYNA.cjs');
+var _chunkXTMZTVITcjs = require('../../chunk-XTMZTVIT.cjs');
 
 
 
 
 
-var _chunk2P4PD6D7cjs = require('../../chunk-2P4PD6D7.cjs');
+var _chunkBKBFSOGTcjs = require('../../chunk-BKBFSOGT.cjs');
 
 // src/agent/cli/approvals.ts
 var dynamicImport = new Function("specifier", "return import(specifier)");
@@ -39,7 +39,7 @@ var answerToResponse = (answer, request) => {
   return { type: "rejected", reason: `Unrecognized approval answer: ${answer}` };
 };
 var makeCliApprovalService = (options = {}) => ({
-  request: (request) => _chunk2P4PD6D7cjs.async.call(void 0, (_env, cb) => {
+  request: (request) => _chunkBKBFSOGTcjs.async.call(void 0, (_env, cb) => {
     let closed = false;
     let rl;
     dynamicImport("node:readline/promises").then(({ createInterface }) => {
@@ -51,7 +51,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: ${_chunkXDINDYNAcjs.summarizeAgentAction.call(void 0, request.action)}
+      _optionalChain([output, 'optionalAccess', _3 => _3.write, 'optionalCall', _4 => _4(`Action: ${_chunkXTMZTVITcjs.summarizeAgentAction.call(void 0, request.action)}
 `)]);
       _optionalChain([output, 'optionalAccess', _5 => _5.write, 'optionalCall', _6 => _6(`Reason: ${request.reason}
 `)]);
@@ -60,14 +60,14 @@ Approval required (${request.risk})
       if (answer === void 0 || closed) return;
       closed = true;
       _optionalChain([rl, 'optionalAccess', _7 => _7.close, 'optionalCall', _8 => _8()]);
-      cb(_chunk2P4PD6D7cjs.Exit.succeed(answerToResponse(answer, request)));
+      cb(_chunkBKBFSOGTcjs.Exit.succeed(answerToResponse(answer, request)));
     }).catch((cause) => {
       if (closed) return;
       closed = true;
       _optionalChain([rl, 'optionalAccess', _9 => _9.close, 'optionalCall', _10 => _10()]);
       cb(
-        _chunk2P4PD6D7cjs.Exit.failCause(
-          _chunk2P4PD6D7cjs.Cause.fail({
+        _chunkBKBFSOGTcjs.Exit.failCause(
+          _chunkBKBFSOGTcjs.Cause.fail({
             _tag: "AgentLoopError",
             message: `Approval prompt failed: ${String(cause)}`
           })
@@ -290,7 +290,7 @@ var newestVsix = (extensionDir) => {
 var push = (checks, check) => {
   checks.push(check);
 };
-var runAgentDoctor = _chunk2P4PD6D7cjs.async.call(void 0, options) => {
+var runAgentDoctor = _chunkBKBFSOGTcjs.async.call(void 0, options) => {
   const cwd = _path.resolve.call(void 0, options.cwd);
   const checks = [];
   const repoRoot = _nullishCoalesce(findPackageRoot(cwd, "brass-runtime"), () => ( findPackageRoot(process.cwd(), "brass-runtime")));
@@ -877,7 +877,7 @@ var nextStepsForProfile = (profile) => {
   }
   return steps;
 };
-var writeInitFile = _chunk2P4PD6D7cjs.async.call(void 0, options) => {
+var writeInitFile = _chunkBKBFSOGTcjs.async.call(void 0, options) => {
   const path = _path.resolve.call(void 0, options.cwd, options.relativePath);
   const exists = _fs.existsSync.call(void 0, path);
   const status = exists ? options.force ? "overwritten" : "skipped" : "created";
@@ -892,7 +892,7 @@ var writeInitFile = _chunk2P4PD6D7cjs.async.call(void 0, options) => {
     bytes: Buffer.byteLength(options.content, "utf8")
   };
 };
-var initializeAgentWorkspace = _chunk2P4PD6D7cjs.async.call(void 0, options) => {
+var initializeAgentWorkspace = _chunkBKBFSOGTcjs.async.call(void 0, options) => {
   const cwd = _path.resolve.call(void 0, options.cwd);
   const profile = _nullishCoalesce(options.profile, () => ( "default"));
   const force = _nullishCoalesce(options.force, () => ( false));
@@ -964,7 +964,7 @@ var printAgentInitResult = (result) => {
 
 // src/agent/cli/main.ts
 var dynamicImport2 = new Function("specifier", "return import(specifier)");
-var readPatchFile = _chunk2P4PD6D7cjs.async.call(void 0, cwd, patchFile) => {
+var readPatchFile = _chunkBKBFSOGTcjs.async.call(void 0, cwd, patchFile) => {
   const nodePath = await dynamicImport2("node:path");
   const nodeFs = await dynamicImport2("node:fs/promises");
   return nodeFs.readFile(nodePath.resolve(cwd, patchFile), "utf8");
@@ -1098,7 +1098,7 @@ var parseCliArgs = (argv) => {
     }
     if (arg === "--preset" || arg.startsWith("--preset=")) {
       const [value, nextIndex] = readFlagValue(argv, index, "--preset");
-      if (!_chunkXDINDYNAcjs.isAgentPreset.call(void 0, value)) {
+      if (!_chunkXTMZTVITcjs.isAgentPreset.call(void 0, value)) {
         throw new Error("--preset requires one of: fix-tests, inspect, typecheck, lint");
       }
       preset = value;
@@ -1274,7 +1274,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" || !_chunkXDINDYNAcjs.isAgentPreset.call(void 0, preset))) {
+  if (preset !== void 0 && (typeof preset !== "string" || !_chunkXTMZTVITcjs.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))) {
@@ -1301,7 +1301,7 @@ var parseBatchGoalsJson = (value) => {
   if (!rawGoals) throw new Error("Batch file must be a JSON array or an object with a goals array.");
   return rawGoals.map((goal, index) => parseBatchGoal(goal, `goals[${index}]`));
 };
-var readBatchFile = _chunk2P4PD6D7cjs.async.call(void 0, cwd, batchFile) => {
+var readBatchFile = _chunkBKBFSOGTcjs.async.call(void 0, cwd, batchFile) => {
   const nodePath = await dynamicImport2("node:path");
   const nodeFs = await dynamicImport2("node:fs/promises");
   const path = nodePath.isAbsolute(batchFile) ? batchFile : nodePath.resolve(cwd, batchFile);
@@ -1318,7 +1318,7 @@ var readBatchFile = _chunk2P4PD6D7cjs.async.call(void 0, cwd, batchFile) => {
 var resolveBatchGoalText = (item, fallbackPatchFile) => {
   if (typeof item === "string") return item;
   if (item.goal) return item.goal;
-  if (item.preset) return _chunkXDINDYNAcjs.goalForAgentPreset.call(void 0, item.preset);
+  if (item.preset) return _chunkXTMZTVITcjs.goalForAgentPreset.call(void 0, item.preset);
   if (_nullishCoalesce(item.patchFile, () => ( fallbackPatchFile))) return "apply supplied patch";
   return "";
 };
@@ -1344,8 +1344,8 @@ var resolveBatchRuns = (items, parsed, config) => items.map((item, index) => {
     ...saveRunDir ? { saveRunDir } : {}
   };
 });
-var resolveParsedConfig = _chunk2P4PD6D7cjs.async.call(void 0, parsed) => {
-  const workspaceDiscovery = _chunkXDINDYNAcjs.discoverNodeWorkspaceRoot.call(void 0, parsed.cwd, {
+var resolveParsedConfig = _chunkBKBFSOGTcjs.async.call(void 0, parsed) => {
+  const workspaceDiscovery = _chunkXTMZTVITcjs.discoverNodeWorkspaceRoot.call(void 0, parsed.cwd, {
     enabled: parsed.discoverWorkspace
   });
   const cwdResolved = workspaceDiscovery.cwd;
@@ -1353,7 +1353,7 @@ var resolveParsedConfig = _chunk2P4PD6D7cjs.async.call(void 0, parsed) => {
     ...parsed,
     cwd: cwdResolved
   };
-  const loaded = await _chunkXDINDYNAcjs.loadNodeAgentConfig.call(void 0, {
+  const loaded = await _chunkXTMZTVITcjs.loadNodeAgentConfig.call(void 0, {
     cwd: cwdResolved,
     configPath: parsed.configPath,
     noConfig: parsed.noConfig
@@ -1369,7 +1369,7 @@ var resolveParsedConfig = _chunk2P4PD6D7cjs.async.call(void 0, parsed) => {
   const batchRuns = resolveBatchRuns(batchItems, parsedAtWorkspace, loaded.config);
   return {
     ...parsedAtWorkspace,
-    goalText: parsed.goalText || (parsed.preset ? _chunkXDINDYNAcjs.goalForAgentPreset.call(void 0, parsed.preset) : parsed.patchFile ? "apply supplied patch" : parsed.goalText),
+    goalText: parsed.goalText || (parsed.preset ? _chunkXTMZTVITcjs.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,
@@ -1493,7 +1493,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 _chunkXDINDYNAcjs.makeGoogleGenerativeAILLM.call(void 0, {
+  return _chunkXTMZTVITcjs.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")),
@@ -1511,12 +1511,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 _chunkXDINDYNAcjs.makeOpenAICompatibleLLM.call(void 0, { endpoint, apiKey, model });
+  return _chunkXTMZTVITcjs.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 _chunkXDINDYNAcjs.makeFakeLLM.call(void 0, { content: fakeResponse });
+  if (provider === "fake") return _chunkXTMZTVITcjs.makeFakeLLM.call(void 0, { content: fakeResponse });
   if (provider === "google" || provider === "gemini") {
     const google = makeGoogleLLMFromEnv(config);
     if (!google) {
@@ -1538,7 +1538,7 @@ var makeLLMFromEnv = (config) => {
   if (provider) {
     throw new Error(`Unsupported LLM provider: ${provider}`);
   }
-  return _nullishCoalesce(_nullishCoalesce(makeGoogleLLMFromEnv(config), () => ( makeOpenAICompatibleLLMFromEnv(config))), () => ( _chunkXDINDYNAcjs.makeFakeLLM.call(void 0, { content: fakeResponse })));
+  return _nullishCoalesce(_nullishCoalesce(makeGoogleLLMFromEnv(config), () => ( makeOpenAICompatibleLLMFromEnv(config))), () => ( _chunkXTMZTVITcjs.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()]);
@@ -1561,9 +1561,9 @@ var makeApprovalServiceFromCli = (parsed) => {
   const mode = resolveApprovalMode(parsed);
   switch (mode) {
     case "approve":
-      return _chunkXDINDYNAcjs.autoApproveApprovals;
+      return _chunkXTMZTVITcjs.autoApproveApprovals;
     case "deny":
-      return _chunkXDINDYNAcjs.makeAutoDenyApprovals.call(void 0, "Approval rejected because the CLI is running without interactive input. Use --yes to auto-approve.");
+      return _chunkXTMZTVITcjs.makeAutoDenyApprovals.call(void 0, "Approval rejected because the CLI is running without interactive input. Use --yes to auto-approve.");
     case "interactive":
       return makeCliApprovalService();
   }
@@ -1695,32 +1695,32 @@ var createHumanEventSink = (configPath) => ({
         console.log("");
         break;
       case "agent.action.started":
-        console.log(`\u2192 ${_chunkXDINDYNAcjs.summarizeAgentAction.call(void 0, event.action)}`);
+        console.log(`\u2192 ${_chunkXTMZTVITcjs.summarizeAgentAction.call(void 0, event.action)}`);
         break;
       case "agent.action.completed": {
-        const status = _chunkXDINDYNAcjs.observationStatus.call(void 0, event.observation);
-        console.log(`${statusIcon2(status)} ${_chunkXDINDYNAcjs.summarizeAgentObservation.call(void 0, event.observation)} ${formatDuration(event.durationMs)}`);
+        const status = _chunkXTMZTVITcjs.observationStatus.call(void 0, event.observation);
+        console.log(`${statusIcon2(status)} ${_chunkXTMZTVITcjs.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 ${_chunkXDINDYNAcjs.summarizeAgentAction.call(void 0, event.action)} failed with ${event.error._tag} ${formatDuration(event.durationMs)}`);
+          console.log(`\u2717 ${_chunkXTMZTVITcjs.summarizeAgentAction.call(void 0, event.action)} failed with ${event.error._tag} ${formatDuration(event.durationMs)}`);
         }
         break;
       case "agent.tool.timeout":
-        console.log(`! ${_chunkXDINDYNAcjs.summarizeAgentAction.call(void 0, event.action)} timed out after ${event.timeoutMs}ms`);
+        console.log(`! ${_chunkXTMZTVITcjs.summarizeAgentAction.call(void 0, event.action)} timed out after ${event.timeoutMs}ms`);
         break;
       case "agent.permission.denied":
-        console.log(`\u2717 ${_chunkXDINDYNAcjs.summarizeAgentAction.call(void 0, event.action)} denied: ${event.reason}`);
+        console.log(`\u2717 ${_chunkXTMZTVITcjs.summarizeAgentAction.call(void 0, event.action)} denied: ${event.reason}`);
         break;
       case "agent.approval.requested":
-        console.log(`? approval required for ${_chunkXDINDYNAcjs.summarizeAgentAction.call(void 0, event.action)} (${event.risk})`);
+        console.log(`? approval required for ${_chunkXTMZTVITcjs.summarizeAgentAction.call(void 0, event.action)} (${event.risk})`);
         break;
       case "agent.approval.resolved":
         if (event.approved) {
-          console.log(`\u2713 approval granted for ${_chunkXDINDYNAcjs.summarizeAgentAction.call(void 0, event.action)}`);
+          console.log(`\u2713 approval granted for ${_chunkXTMZTVITcjs.summarizeAgentAction.call(void 0, event.action)}`);
         } else {
-          console.log(`\u2717 approval rejected for ${_chunkXDINDYNAcjs.summarizeAgentAction.call(void 0, event.action)}${event.reason ? `: ${event.reason}` : ""}`);
+          console.log(`\u2717 approval rejected for ${_chunkXTMZTVITcjs.summarizeAgentAction.call(void 0, event.action)}${event.reason ? `: ${event.reason}` : ""}`);
         }
         break;
       case "agent.patch.applied":
@@ -1748,7 +1748,7 @@ var createProtocolEventSink = (options = {}) => ({
 });
 var safeFilePart = (value) => value.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80) || "run";
 var markdownEscape = (value) => value.replace(/\\/g, "\\\\").replace(/`/g, "\\`");
-var writeRunArtifacts = _chunk2P4PD6D7cjs.async.call(void 0, state, outputDir, options) => {
+var writeRunArtifacts = _chunkBKBFSOGTcjs.async.call(void 0, state, outputDir, options) => {
   const nodePath = await dynamicImport2("node:path");
   const nodeFs = await dynamicImport2("node:fs/promises");
   const dir = nodePath.isAbsolute(outputDir) ? outputDir : nodePath.resolve(state.goal.cwd, outputDir);
@@ -1825,13 +1825,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 = _chunkXDINDYNAcjs.NodeShell;
+  const shell = _chunkXTMZTVITcjs.NodeShell;
   return {
     shell,
-    fs: _chunkXDINDYNAcjs.makeNodeFileSystem.call(void 0, shell),
-    patch: _chunkXDINDYNAcjs.makeNodePatchService.call(void 0, shell),
+    fs: _chunkXTMZTVITcjs.makeNodeFileSystem.call(void 0, shell),
+    patch: _chunkXTMZTVITcjs.makeNodePatchService.call(void 0, shell),
     llm: makeLLMFromEnv(parsed.config.llm),
-    permissions: _chunkXDINDYNAcjs.makeConfiguredPermissions.call(void 0, parsed.config.permissions),
+    permissions: _chunkXTMZTVITcjs.makeConfiguredPermissions.call(void 0, parsed.config.permissions),
     approvals: makeApprovalServiceFromCli(parsed),
     ...events ? { events } : {},
     ...parsed.config.tools ? { toolPolicies: parsed.config.tools } : {}
@@ -1846,12 +1846,12 @@ var singleRunFromParsed = (parsed) => ({
   ...parsed.patchFile ? { patchFile: parsed.patchFile } : {},
   ...parsed.saveRunDir ? { saveRunDir: parsed.saveRunDir } : {}
 });
-var runCliAgent = _chunk2P4PD6D7cjs.async.call(void 0, parsed, run, compactOptions, events) => {
+var runCliAgent = _chunkBKBFSOGTcjs.async.call(void 0, parsed, run, compactOptions, events) => {
   const env = makeAgentEnv(parsed, events);
-  const runtime = new (0, _chunk2P4PD6D7cjs.Runtime)({ env });
+  const runtime = new (0, _chunkBKBFSOGTcjs.Runtime)({ env });
   const initialPatch = run.patchFile ? await readPatchFile(run.cwd, run.patchFile) : void 0;
   const state = await runtime.toPromise(
-    _chunkXDINDYNAcjs.runAgent.call(void 0, runtime, {
+    _chunkXTMZTVITcjs.runAgent.call(void 0, runtime, {
       id: `agent-${Date.now()}-${run.index + 1}`,
       cwd: run.cwd,
       text: run.goalText,
@@ -1919,7 +1919,7 @@ var printWorkspaceWhere = (parsed) => {
   if (result.configPath) console.log(`config: ${result.configPath}`);
   if (result.envFiles.length > 0) console.log(`env: ${result.envFiles.join(", ")}`);
 };
-var main = _chunk2P4PD6D7cjs.async.call(void 0, ) => {
+var main = _chunkBKBFSOGTcjs.async.call(void 0, ) => {
   const parsed = await resolveParsedConfig(parseCliArgs(process.argv.slice(2)));
   const isBatch = parsed.batchRuns.length > 0;
   if (parsed.showHelp) {

package/dist/agent/cli/main.js

@@ -17,13 +17,13 @@ import {
   runAgent,
   summarizeAgentAction,
   summarizeAgentObservation
-} from "../../chunk-INZBKOHY.js";
+} from "../../chunk-WJESVBWN.js";
 import {
   Cause,
   Exit,
   Runtime,
   async
-} from "../../chunk-L6KKKM66.js";
+} from "../../chunk-JT7D6M5H.js";
 
 // src/agent/cli/approvals.ts
 var dynamicImport = new Function("specifier", "return import(specifier)");

package/dist/agent/cli/main.mjs

@@ -17,13 +17,13 @@ import {
   runAgent,
   summarizeAgentAction,
   summarizeAgentObservation
-} from "../../chunk-3R7ZYRK2.mjs";
+} from "../../chunk-MQF7HZ7Y.mjs";
 import {
   Cause,
   Exit,
   Runtime,
   async
-} from "../../chunk-7F2R7A2V.mjs";
+} from "../../chunk-4N2JEK4H.mjs";
 
 // src/agent/cli/approvals.ts
 var dynamicImport = new Function("specifier", "return import(specifier)");

package/dist/agent/index.cjs

@@ -73,8 +73,8 @@
 
 
 
-var _chunkXDINDYNAcjs = require('../chunk-XDINDYNA.cjs');
-require('../chunk-2P4PD6D7.cjs');
+var _chunkXTMZTVITcjs = require('../chunk-XTMZTVIT.cjs');
+require('../chunk-BKBFSOGT.cjs');
 
 
 
@@ -150,4 +150,4 @@ require('../chunk-2P4PD6D7.cjs');
 
 
 
-exports.AGENT_CONFIG_FILE_NAMES = _chunkXDINDYNAcjs.AGENT_CONFIG_FILE_NAMES; exports.NodeShell = _chunkXDINDYNAcjs.NodeShell; exports.PROJECT_LOCKFILE_PROBES = _chunkXDINDYNAcjs.PROJECT_LOCKFILE_PROBES; exports.PROJECT_PROFILE_PROBES = _chunkXDINDYNAcjs.PROJECT_PROFILE_PROBES; exports.autoApproveApprovals = _chunkXDINDYNAcjs.autoApproveApprovals; exports.canAutoRollback = _chunkXDINDYNAcjs.canAutoRollback; exports.canRequestPatchRepair = _chunkXDINDYNAcjs.canRequestPatchRepair; exports.commandForScript = _chunkXDINDYNAcjs.commandForScript; exports.decideNextAction = _chunkXDINDYNAcjs.decideNextAction; exports.defaultPermissions = _chunkXDINDYNAcjs.defaultPermissions; exports.deriveContextSearchQueries = _chunkXDINDYNAcjs.deriveContextSearchQueries; exports.describeCommandDiscovery = _chunkXDINDYNAcjs.describeCommandDiscovery; exports.describeContextDiscovery = _chunkXDINDYNAcjs.describeContextDiscovery; exports.describeLanguagePolicy = _chunkXDINDYNAcjs.describeLanguagePolicy; exports.describePatchQuality = _chunkXDINDYNAcjs.describePatchQuality; exports.describeProjectProfile = _chunkXDINDYNAcjs.describeProjectProfile; exports.describeRollbackSafety = _chunkXDINDYNAcjs.describeRollbackSafety; exports.discoverNodeWorkspaceRoot = _chunkXDINDYNAcjs.discoverNodeWorkspaceRoot; exports.discoverPackageManager = _chunkXDINDYNAcjs.discoverPackageManager; exports.discoverProjectProfile = _chunkXDINDYNAcjs.discoverProjectProfile; exports.discoverValidationCommands = _chunkXDINDYNAcjs.discoverValidationCommands; exports.emitAgentEvent = _chunkXDINDYNAcjs.emitAgentEvent; exports.emitAgentEvents = _chunkXDINDYNAcjs.emitAgentEvents; exports.errorEventFor = _chunkXDINDYNAcjs.errorEventFor; exports.extractLikelyFilePaths = _chunkXDINDYNAcjs.extractLikelyFilePaths; exports.extractPatchPaths = _chunkXDINDYNAcjs.extractPatchPaths; exports.extractUnifiedDiff = _chunkXDINDYNAcjs.extractUnifiedDiff; exports.goalForAgentPreset = _chunkXDINDYNAcjs.goalForAgentPreset; exports.inferUserLanguage = _chunkXDINDYNAcjs.inferUserLanguage; exports.initialAgentState = _chunkXDINDYNAcjs.initialAgentState; exports.invokeAction = _chunkXDINDYNAcjs.invokeAction; exports.isAgentConfigApprovalMode = _chunkXDINDYNAcjs.isAgentConfigApprovalMode; exports.isAgentConfigLLMProvider = _chunkXDINDYNAcjs.isAgentConfigLLMProvider; exports.isAgentConfigMode = _chunkXDINDYNAcjs.isAgentConfigMode; exports.isAgentPreset = _chunkXDINDYNAcjs.isAgentPreset; exports.isRedactionEnabled = _chunkXDINDYNAcjs.isRedactionEnabled; exports.isTerminal = _chunkXDINDYNAcjs.isTerminal; exports.latestUnappliedPatch = _chunkXDINDYNAcjs.latestUnappliedPatch; exports.loadNodeAgentConfig = _chunkXDINDYNAcjs.loadNodeAgentConfig; exports.makeAutoDenyApprovals = _chunkXDINDYNAcjs.makeAutoDenyApprovals; exports.makeConfiguredPermissions = _chunkXDINDYNAcjs.makeConfiguredPermissions; exports.makeFakeLLM = _chunkXDINDYNAcjs.makeFakeLLM; exports.makeGoogleGenerativeAILLM = _chunkXDINDYNAcjs.makeGoogleGenerativeAILLM; exports.makeNodeFileSystem = _chunkXDINDYNAcjs.makeNodeFileSystem; exports.makeNodePatchService = _chunkXDINDYNAcjs.makeNodePatchService; exports.makeOpenAICompatibleLLM = _chunkXDINDYNAcjs.makeOpenAICompatibleLLM; exports.nextContextDiscoveryAction = _chunkXDINDYNAcjs.nextContextDiscoveryAction; exports.nextProjectProbeAction = _chunkXDINDYNAcjs.nextProjectProbeAction; exports.nextUnrunValidationCommand = _chunkXDINDYNAcjs.nextUnrunValidationCommand; exports.nowMillis = _chunkXDINDYNAcjs.nowMillis; exports.observationEventFor = _chunkXDINDYNAcjs.observationEventFor; exports.observationStatus = _chunkXDINDYNAcjs.observationStatus; exports.parseProjectPackageJson = _chunkXDINDYNAcjs.parseProjectPackageJson; exports.patchQualitySummary = _chunkXDINDYNAcjs.patchQualitySummary; exports.patchRepairAttemptsUsed = _chunkXDINDYNAcjs.patchRepairAttemptsUsed; exports.patchValidationStatus = _chunkXDINDYNAcjs.patchValidationStatus; exports.projectProfileProbePending = _chunkXDINDYNAcjs.projectProfileProbePending; exports.redactText = _chunkXDINDYNAcjs.redactText; exports.reduceAgentState = _chunkXDINDYNAcjs.reduceAgentState; exports.responseLanguageName = _chunkXDINDYNAcjs.responseLanguageName; exports.retry = _chunkXDINDYNAcjs.retry; exports.rollbackSafetySummary = _chunkXDINDYNAcjs.rollbackSafetySummary; exports.runAgent = _chunkXDINDYNAcjs.runAgent; exports.runStatusFor = _chunkXDINDYNAcjs.runStatusFor; exports.shouldContinueRollbackStack = _chunkXDINDYNAcjs.shouldContinueRollbackStack; exports.sleep = _chunkXDINDYNAcjs.sleep; exports.spanishLike = _chunkXDINDYNAcjs.spanishLike; exports.splitCommand = _chunkXDINDYNAcjs.splitCommand; exports.summarizeAgentAction = _chunkXDINDYNAcjs.summarizeAgentAction; exports.summarizeAgentObservation = _chunkXDINDYNAcjs.summarizeAgentObservation; exports.summarizeContextDiscovery = _chunkXDINDYNAcjs.summarizeContextDiscovery; exports.timeout = _chunkXDINDYNAcjs.timeout; exports.unappliedPatchStack = _chunkXDINDYNAcjs.unappliedPatchStack; exports.workspaceValidationStatus = _chunkXDINDYNAcjs.workspaceValidationStatus;
+exports.AGENT_CONFIG_FILE_NAMES = _chunkXTMZTVITcjs.AGENT_CONFIG_FILE_NAMES; exports.NodeShell = _chunkXTMZTVITcjs.NodeShell; exports.PROJECT_LOCKFILE_PROBES = _chunkXTMZTVITcjs.PROJECT_LOCKFILE_PROBES; exports.PROJECT_PROFILE_PROBES = _chunkXTMZTVITcjs.PROJECT_PROFILE_PROBES; exports.autoApproveApprovals = _chunkXTMZTVITcjs.autoApproveApprovals; exports.canAutoRollback = _chunkXTMZTVITcjs.canAutoRollback; exports.canRequestPatchRepair = _chunkXTMZTVITcjs.canRequestPatchRepair; exports.commandForScript = _chunkXTMZTVITcjs.commandForScript; exports.decideNextAction = _chunkXTMZTVITcjs.decideNextAction; exports.defaultPermissions = _chunkXTMZTVITcjs.defaultPermissions; exports.deriveContextSearchQueries = _chunkXTMZTVITcjs.deriveContextSearchQueries; exports.describeCommandDiscovery = _chunkXTMZTVITcjs.describeCommandDiscovery; exports.describeContextDiscovery = _chunkXTMZTVITcjs.describeContextDiscovery; exports.describeLanguagePolicy = _chunkXTMZTVITcjs.describeLanguagePolicy; exports.describePatchQuality = _chunkXTMZTVITcjs.describePatchQuality; exports.describeProjectProfile = _chunkXTMZTVITcjs.describeProjectProfile; exports.describeRollbackSafety = _chunkXTMZTVITcjs.describeRollbackSafety; exports.discoverNodeWorkspaceRoot = _chunkXTMZTVITcjs.discoverNodeWorkspaceRoot; exports.discoverPackageManager = _chunkXTMZTVITcjs.discoverPackageManager; exports.discoverProjectProfile = _chunkXTMZTVITcjs.discoverProjectProfile; exports.discoverValidationCommands = _chunkXTMZTVITcjs.discoverValidationCommands; exports.emitAgentEvent = _chunkXTMZTVITcjs.emitAgentEvent; exports.emitAgentEvents = _chunkXTMZTVITcjs.emitAgentEvents; exports.errorEventFor = _chunkXTMZTVITcjs.errorEventFor; exports.extractLikelyFilePaths = _chunkXTMZTVITcjs.extractLikelyFilePaths; exports.extractPatchPaths = _chunkXTMZTVITcjs.extractPatchPaths; exports.extractUnifiedDiff = _chunkXTMZTVITcjs.extractUnifiedDiff; exports.goalForAgentPreset = _chunkXTMZTVITcjs.goalForAgentPreset; exports.inferUserLanguage = _chunkXTMZTVITcjs.inferUserLanguage; exports.initialAgentState = _chunkXTMZTVITcjs.initialAgentState; exports.invokeAction = _chunkXTMZTVITcjs.invokeAction; exports.isAgentConfigApprovalMode = _chunkXTMZTVITcjs.isAgentConfigApprovalMode; exports.isAgentConfigLLMProvider = _chunkXTMZTVITcjs.isAgentConfigLLMProvider; exports.isAgentConfigMode = _chunkXTMZTVITcjs.isAgentConfigMode; exports.isAgentPreset = _chunkXTMZTVITcjs.isAgentPreset; exports.isRedactionEnabled = _chunkXTMZTVITcjs.isRedactionEnabled; exports.isTerminal = _chunkXTMZTVITcjs.isTerminal; exports.latestUnappliedPatch = _chunkXTMZTVITcjs.latestUnappliedPatch; exports.loadNodeAgentConfig = _chunkXTMZTVITcjs.loadNodeAgentConfig; exports.makeAutoDenyApprovals = _chunkXTMZTVITcjs.makeAutoDenyApprovals; exports.makeConfiguredPermissions = _chunkXTMZTVITcjs.makeConfiguredPermissions; exports.makeFakeLLM = _chunkXTMZTVITcjs.makeFakeLLM; exports.makeGoogleGenerativeAILLM = _chunkXTMZTVITcjs.makeGoogleGenerativeAILLM; exports.makeNodeFileSystem = _chunkXTMZTVITcjs.makeNodeFileSystem; exports.makeNodePatchService = _chunkXTMZTVITcjs.makeNodePatchService; exports.makeOpenAICompatibleLLM = _chunkXTMZTVITcjs.makeOpenAICompatibleLLM; exports.nextContextDiscoveryAction = _chunkXTMZTVITcjs.nextContextDiscoveryAction; exports.nextProjectProbeAction = _chunkXTMZTVITcjs.nextProjectProbeAction; exports.nextUnrunValidationCommand = _chunkXTMZTVITcjs.nextUnrunValidationCommand; exports.nowMillis = _chunkXTMZTVITcjs.nowMillis; exports.observationEventFor = _chunkXTMZTVITcjs.observationEventFor; exports.observationStatus = _chunkXTMZTVITcjs.observationStatus; exports.parseProjectPackageJson = _chunkXTMZTVITcjs.parseProjectPackageJson; exports.patchQualitySummary = _chunkXTMZTVITcjs.patchQualitySummary; exports.patchRepairAttemptsUsed = _chunkXTMZTVITcjs.patchRepairAttemptsUsed; exports.patchValidationStatus = _chunkXTMZTVITcjs.patchValidationStatus; exports.projectProfileProbePending = _chunkXTMZTVITcjs.projectProfileProbePending; exports.redactText = _chunkXTMZTVITcjs.redactText; exports.reduceAgentState = _chunkXTMZTVITcjs.reduceAgentState; exports.responseLanguageName = _chunkXTMZTVITcjs.responseLanguageName; exports.retry = _chunkXTMZTVITcjs.retry; exports.rollbackSafetySummary = _chunkXTMZTVITcjs.rollbackSafetySummary; exports.runAgent = _chunkXTMZTVITcjs.runAgent; exports.runStatusFor = _chunkXTMZTVITcjs.runStatusFor; exports.shouldContinueRollbackStack = _chunkXTMZTVITcjs.shouldContinueRollbackStack; exports.sleep = _chunkXTMZTVITcjs.sleep; exports.spanishLike = _chunkXTMZTVITcjs.spanishLike; exports.splitCommand = _chunkXTMZTVITcjs.splitCommand; exports.summarizeAgentAction = _chunkXTMZTVITcjs.summarizeAgentAction; exports.summarizeAgentObservation = _chunkXTMZTVITcjs.summarizeAgentObservation; exports.summarizeContextDiscovery = _chunkXTMZTVITcjs.summarizeContextDiscovery; exports.timeout = _chunkXTMZTVITcjs.timeout; exports.unappliedPatchStack = _chunkXTMZTVITcjs.unappliedPatchStack; exports.workspaceValidationStatus = _chunkXTMZTVITcjs.workspaceValidationStatus;