@mobrienv/autoloop 0.3.0 → 0.7.0

package/README.md

@@ -1,21 +1,85 @@
 # autoloop
 
-Autonomous LLM loop harness for long-horizon, multi-role agent work.
+autoloop is a spinoff of ralph-orchestrator built to keep the parts that mattered and drop a lot of the extra experimental surface area.
+
+It’s a simpler, more opinionated loop harness for long-running agent work: inspectable runs, easier preset-driven workflows, and operator surfaces that agents can use directly too.
+
+It’s early and still evolving. autoloop is not a replacement for ralph-orchestrator — it’s a cleaner path for exploring a simpler UX without breaking Ralph.
 
 [![npm version](https://img.shields.io/npm/v/@mobrienv/autoloop)](https://www.npmjs.com/package/@mobrienv/autoloop)
+[![docs](https://img.shields.io/badge/docs-live-blue)](https://mikeyobrien.github.io/autoloop/)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
 
-## Features
+**[Read the docs →](https://mikeyobrien.github.io/autoloop/)**
+
+[![autoloop hero showing the CLI surface and local dashboard](docs/launches/autoloop-readme-hero.png)](docs/launches/autoloop-hybrid-launch-video-x.mp4)
+
+## Use as a library
+
+As of `0.5.0-sdk.0`, autoloop ships an embed-able runtime alongside the CLI. Pass an `AbortSignal` for cancellation and an `onEvent` callback to consume the structured event stream — no terminal output is produced unless you ask for it.
+
+```ts
+import { run, type LoopEvent } from "@mobrienv/autoloop";
+
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 60_000);
+
+const summary = await run("./my-project", "build the login page", "autoloop", {
+  signal: controller.signal,
+  onEvent: (event: LoopEvent) => {
+    if (event.type === "iteration.start") console.log(`iter ${event.iteration}`);
+    if (event.type === "loop.finish") console.log(`done: ${event.stopReason}`);
+  },
+});
+
+console.log(summary); // { iterations, stopReason, runId }
+```
+
+The CLI entry (`bin/autoloop`) is still the primary interface; the library export is for agent frameworks and dashboards that want to drive loops in-process.
+
+## Why autoloop exists
+
+ralph-orchestrator grew to include a lot of different experiments and ways of doing things. autoloop spins out a narrower set of ideas into something simpler and more opinionated.
+
+The bet is that long-running agent workflows get much better when they are:
+
+- inspectable after every iteration
+- easy to launch through reusable presets
+- safe to run in isolation when they touch real code
+- operable by both humans and agents
 
-- **Event-driven role routing** -- roles hand off via structured events; the harness manages iteration, backpressure, and completion detection
-- **Append-only journal** -- every iteration is recorded; inspect, replay, or audit any run
-- **Preset system** -- bundled presets for common workflows (code, docs, QA, security, specs); create your own in minutes
-- **Persistent memory** -- loops accumulate learnings and preferences across runs
+If Ralph is the broader experimentation surface, autoloop is the cleaner runtime path.
+
+## What it emphasizes
+
+- **Inspectable long-running loops** -- every iteration is recorded in an append-only journal, with tools to inspect prompts, outputs, topology, metrics, tasks, memory, and artifacts
+- **Easier preset-driven workflows** -- bundled presets give you a fast starting point, and custom preset creation is a first-class path
+- **Operator visibility** -- `loops`, `watch`, `health`, `inspect`, and the local dashboard show what actually happened
+- **Worktree isolation + automerge** -- run risky coding passes in git worktrees and merge them back only when ready
+- **Designed for agents too** -- autoloop is intentionally shaped as a surface that agents can use directly, not just a human operator CLI
 - **Dynamic chains** -- compose presets into multi-stage pipelines
-- **Worktree isolation** -- run loops in git worktrees so your working tree stays clean
+- **Persistent memory + profiles** -- loops accumulate learnings across runs and can load repo/user tuning profiles
+
+## What autoloop is
+
+- a simpler, more opinionated spinoff of ralph-orchestrator
+- a loop harness for long-running agent workflows
+- a system built around inspectability, presets, and operator visibility
+- a tool for both human operators and agents
+
+## What it is not
+
+- not a replacement for ralph-orchestrator
+- not just a thin CLI wrapper around model calls
+- not a generic workflow engine for everything
+- not optimized for the broadest possible feature surface
 
 ## Table of contents
 
+- [Why autoloop exists](#why-autoloop-exists)
+- [What it emphasizes](#what-it-emphasizes)
+- [What autoloop is](#what-autoloop-is)
+- [What it is not](#what-it-is-not)
 - [Install](#install)
 - [Quick start](#quick-start)
 - [Usage](#usage)
@@ -33,7 +97,6 @@ Autonomous LLM loop harness for long-horizon, multi-role agent work.
 
 ```bash
 npm install -g @mobrienv/autoloop
-autoloop --help
 ```
 
 ### From source
@@ -50,31 +113,51 @@ node bin/autoloop --help
 ```bash
 # Run a bundled preset
 autoloop run autocode "Fix the login bug"
+
+# Inspect active and recent runs
+autoloop loops
+
+# Open the local dashboard
+autoloop dashboard
+
+# Keep an implementation pass isolated in a git worktree
+autoloop run autocode --worktree --automerge "Implement the approved fix"
 ```
 
-`autocode` is a bundled preset. The quoted string is the prompt passed to the loop. The harness iterates through roles (planner -> builder -> critic -> finalizer) until a `task.complete` event is emitted or the iteration limit is reached.
+`autocode` is a bundled preset. The quoted string is the objective passed to the loop.
+
+The usual golden path is:
+
+1. start a loop with a preset
+2. watch it move through iterations
+3. inspect the journal, events, and artifacts
+4. open the dashboard when you want a higher-level operator view
+5. use worktree isolation when the loop is making risky repo changes
 
 ## Usage
 
+The main commands are:
+
 ```
 autoloop run <preset-name|preset-dir> [prompt...] [flags]
-autoloop emit <topic> [summary]
-autoloop inspect <artifact> [selector] [project-dir] [--format <md|terminal|text|json|csv>]
-autoloop memory <list|add|remove> [args]
-autoloop task <add|complete|update|remove|list> [args]
 autoloop list
 autoloop loops [--all]
 autoloop loops show <run-id>
 autoloop loops artifacts <run-id>
 autoloop loops watch <run-id>
-autoloop loops health [--verbose]
+autoloop inspect <artifact> [selector] [project-dir] [--format <md|terminal|text|json|csv|graph>]
+autoloop dashboard [--port <port>]
+autoloop worktree <list|show|merge|clean> [args]
 autoloop chain <list|run> [args]
+autoloop emit <topic> [summary]
+autoloop memory <list|status|find|add|remove> [args]
+autoloop task <add|complete|update|remove|list> [args]
 autoloop runs clean [--max-age <days>]
-autoloop worktree <list|show|merge|clean> [args]
 autoloop config <show|set|unset|path> [args]
-autoloop dashboard [--port <port>]
 ```
 
+Use `run` to start work, `loops` and `inspect` to understand what happened, and `dashboard` when you want a local operator surface.
+
 ### Flags
 
 | Flag | Description |
@@ -90,17 +173,27 @@ autoloop dashboard [--port <port>]
 ### Examples
 
 ```bash
-# Run a preset by name
+# Run a preset against a coding task
 autoloop run autocode "Refactor the auth module"
 
+# Run a QA pass
+autoloop run autoqa "Exercise the new onboarding flow and report UX issues"
+
 # Run from a custom preset directory
 autoloop run ./my-preset "Analyze the API"
 
-# Override the backend
-autoloop run autoqa -b claude "Review recent changes"
+# Keep implementation isolated in a worktree
+autoloop run autocode --worktree --automerge "Implement the approved fix"
 
-# List available presets
-autoloop list
+# Watch a run in progress
+autoloop loops watch <run-id>
+
+# Inspect what happened after the run completes
+autoloop inspect journal <run-id>
+autoloop loops artifacts <run-id>
+
+# Open the dashboard
+autoloop dashboard
 
 # Run an inline chain
 autoloop run --chain autospec,autocode "Design and build feature X"
@@ -108,26 +201,30 @@ autoloop run --chain autospec,autocode "Design and build feature X"
 
 ## Bundled presets
 
+Bundled presets give you opinionated starting points for common workflows like coding, QA, docs, review, security, specs, and performance.
+
 | Preset | Purpose |
 |--------|---------|
 | `autocode` | Plan, build, review, and commit code changes |
-| `autodoc` | Audit, write, verify, and publish documentation |
-| `autofix` | Diagnose, fix, and verify bugs |
+| `autosimplify` | Scope, simplify, verify, and review code for simplicity |
 | `autoideas` | Scan, analyze, review, and synthesize improvement ideas |
-| `automerge` | Merge a completed worktree branch back into its base branch |
-| `autoperf` | Profile, measure, optimize, and judge performance |
-| `autopr` | Turn the current branch into a reviewable pull request |
-| `autoqa` | Plan, execute, inspect, and report on QA |
 | `autoresearch` | Research strategies, implement, evaluate, and benchmark |
+| `autoqa` | Plan, execute, inspect, and report on QA |
+| `autotest` | Survey, write, run, and assess tests |
+| `autofix` | Diagnose, fix, and verify bugs |
 | `autoreview` | Read, suggest, check, and summarize code reviews |
+| `autodoc` | Audit, write, verify, and publish documentation |
 | `autosec` | Scan, analyze, harden, and report on security |
-| `autosimplify` | Scope, simplify, verify, and review code for simplicity |
+| `autoperf` | Profile, measure, optimize, and judge performance |
 | `autospec` | Research, clarify, design, plan, and critique specifications |
-| `autotest` | Survey, write, run, and assess tests |
+| `automerge` | Merge a completed worktree branch back into its base branch |
+| `autopr` | Turn the current branch into a reviewable pull request |
 
 ## Creating custom presets
 
-A preset is a directory containing `autoloops.toml`, `topology.toml`, `harness.md`, and a `roles/` folder. See [Creating presets](docs/creating-presets.md) for the full guide, or examine any `presets/<name>/` directory as a working example.
+A preset is a directory containing `autoloops.toml`, `topology.toml`, `harness.md`, and a `roles/` folder. See [Creating presets](https://mikeyobrien.github.io/autoloop/guides/creating-presets) for the full guide, or examine any `presets/<name>/` directory as a working example.
+
+Some older or internal layouts may still include `miniloops.toml`, but `autoloops.toml` is the canonical entry point for new presets.
 
 ## Project structure
 
@@ -182,22 +279,22 @@ export MOCK_FIXTURE_PATH=test/fixtures/backend/complete-success.json
 node bin/autoloop run . -b "node dist/testing/mock-backend.js"
 ```
 
-See [CLI reference](docs/cli.md#mock-backend) for fixture schema and bundled scenarios.
+See [CLI reference](https://mikeyobrien.github.io/autoloop/reference/cli#mock-backend) for fixture schema and bundled scenarios.
 
 ## Further reading
 
-- [Platform architecture](docs/platform.md)
-- [Configuration reference](docs/configuration.md)
-- [Creating presets](docs/creating-presets.md)
-- [Topology and event routing](docs/topology.md)
-- [Memory system](docs/memory.md)
-- [Dynamic chains](docs/dynamic-chains.md)
-- [CLI reference](docs/cli.md)
-- [Dashboard](docs/dashboard.md)
-- [Profiles](docs/profiles.md)
-- [Tasks](docs/tasks.md)
-- [Worktree isolation](docs/worktree.md)
-- [Releasing](docs/releasing.md)
+- [Platform architecture](https://mikeyobrien.github.io/autoloop/concepts/platform)
+- [Configuration reference](https://mikeyobrien.github.io/autoloop/reference/configuration)
+- [Creating presets](https://mikeyobrien.github.io/autoloop/guides/creating-presets)
+- [Topology and event routing](https://mikeyobrien.github.io/autoloop/reference/topology)
+- [Memory system](https://mikeyobrien.github.io/autoloop/reference/memory)
+- [Dynamic chains](https://mikeyobrien.github.io/autoloop/features/dynamic-chains)
+- [CLI reference](https://mikeyobrien.github.io/autoloop/reference/cli)
+- [Dashboard](https://mikeyobrien.github.io/autoloop/features/dashboard)
+- [Profiles](https://mikeyobrien.github.io/autoloop/features/profiles)
+- [Tasks](https://mikeyobrien.github.io/autoloop/features/tasks)
+- [Worktree isolation](https://mikeyobrien.github.io/autoloop/features/worktree)
+- [Releasing](https://mikeyobrien.github.io/autoloop/development/releasing)
 
 ## Contributing
 

package/bin/autoloop

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import('../dist/main.js');
+import('@mobrienv/autoloop-cli');

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { loadProject as loadProjectConfig } from "@mobrienv/autoloop-core/config";
+export { type Config, defaults as configDefaults, get as configGet, getInt as configGetInt, getList as configGetList, type LayeredConfig, parseToml as parseConfigToml, } from "@mobrienv/autoloop-core/config-schema";
+export { emit, run, runParallelBranchCli } from "@mobrienv/autoloop-harness";
+export type { EmitResult } from "@mobrienv/autoloop-harness/emit";
+export type { LoopEvent, LoopEventEmitter, } from "@mobrienv/autoloop-harness/events";
+export type { LoopContext, RunOptions, RunSummary, TriggerSource, Verdict, VerdictKind, } from "@mobrienv/autoloop-harness/types";

package/dist/index.js

@@ -0,0 +1,19 @@
+// Public SDK entry point for @mobrienv/autoloop.
+//
+// This module re-exports the minimal surface SDK consumers need to embed
+// autoloop in their own code. It is deliberately narrow; everything else
+// (CLI render helpers, preset resolution, dashboard, etc.) stays internal.
+//
+// Usage:
+//   import { run, type LoopEvent } from "@mobrienv/autoloop";
+//
+//   const summary = await run(projectDir, prompt, "autoloop", {
+//     signal: controller.signal,
+//     onEvent: (e: LoopEvent) => console.log(e.type),
+//   });
+export { loadProject as loadProjectConfig } from "@mobrienv/autoloop-core/config";
+// Pure config helpers, for consumers who want to inspect merged config
+// without re-implementing the schema layer.
+export { defaults as configDefaults, get as configGet, getInt as configGetInt, getList as configGetList, parseToml as parseConfigToml, } from "@mobrienv/autoloop-core/config-schema";
+export { emit, run, runParallelBranchCli } from "@mobrienv/autoloop-harness";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,2EAA2E;AAC3E,EAAE;AACF,SAAS;AACT,8DAA8D;AAC9D,EAAE;AACF,gEAAgE;AAChE,iCAAiC;AACjC,sDAAsD;AACtD,QAAQ;AAER,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAClF,uEAAuE;AACvE,4CAA4C;AAC5C,OAAO,EAEL,QAAQ,IAAI,cAAc,EAC1B,GAAG,IAAI,SAAS,EAChB,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,EAExB,SAAS,IAAI,eAAe,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/testing/mock-backend.js

@@ -10,8 +10,7 @@
  */
 import { execFileSync } from "node:child_process";
 import { readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
 function fixturePathFromArgs() {
     return process.argv[2] ?? "";
 }
@@ -38,9 +37,8 @@ function loadFixture() {
     }
 }
 function emitEvent(event, payload) {
-    const currentFile = fileURLToPath(import.meta.url);
-    const distDir = dirname(dirname(currentFile));
-    const mainEntry = resolve(distDir, "main.js");
+    const require = createRequire(import.meta.url);
+    const mainEntry = require.resolve("@mobrienv/autoloop-cli");
     try {
         execFileSync(process.execPath, [mainEntry, "emit", event, payload], {
             encoding: "utf-8",

package/dist/testing/mock-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"mock-backend.js","sourceRoot":"","sources":["../../src/testing/mock-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mock-backend.js","sourceRoot":"","sources":["../../src/testing/mock-backend.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,22 +1,37 @@
 {
   "name": "@mobrienv/autoloop",
-  "version": "0.3.0",
-  "description": "Autonomous LLM loop harness and control plane for long-horizon autonomous work",
+  "version": "0.7.0",
+  "description": "Simpler, opinionated loop harness for inspectable long-running agent workflows",
   "type": "module",
-  "main": "dist/main.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "bin": {
     "autoloop": "bin/autoloop"
   },
   "files": [
     "bin/autoloop",
     "dist",
-    "presets",
-    "plugins",
+    "plugins/autoloop",
     "README.md"
   ],
   "engines": {
     "node": ">=18"
   },
+  "workspaces": [
+    "packages/core",
+    "packages/presets",
+    "packages/backends",
+    "packages/harness",
+    "packages/dashboard",
+    "packages/cli"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mikeyobrien/autoloop.git"
@@ -38,7 +53,8 @@
     "provenance": true
   },
   "scripts": {
-    "build": "tsc",
+    "build": "npm run build --workspaces && tsc",
+    "build:root": "tsc",
     "lint": "biome check src/ test/",
     "lint:fix": "biome check --write src/ test/",
     "format": "biome format src/ test/",
@@ -47,6 +63,10 @@
     "test:coverage": "node --experimental-vm-modules node_modules/.bin/vitest run --coverage",
     "test:watch": "node --experimental-vm-modules node_modules/.bin/vitest",
     "check": "biome check src/ test/ && tsc --noEmit && npm run test:coverage",
+    "release": "node bin/release",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
     "prepare": "husky",
     "version": "node -e \"const p=require('./plugins/autoloop/.claude-plugin/plugin.json');p.version=require('./package.json').version;require('fs').writeFileSync('./plugins/autoloop/.claude-plugin/plugin.json',JSON.stringify(p,null,2)+'\\n')\" && git add plugins/autoloop/.claude-plugin/plugin.json"
   },
@@ -63,12 +83,14 @@
     "lint-staged": "^16.4.0",
     "playwright": "^1.59.1",
     "typescript": "^5.9.3",
+    "vitepress": "^1.6.4",
+    "vitepress-plugin-llmstxt": "^0.5.1",
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@agentclientprotocol/sdk": "^0.18.0",
-    "@hono/node-server": "^1.19.12",
-    "@iarna/toml": "^2.2.5",
-    "hono": "^4.12.10"
+    "@mobrienv/autoloop-cli": "0.7.0",
+    "@mobrienv/autoloop-core": "0.7.0",
+    "@mobrienv/autoloop-harness": "0.7.0",
+    "@mobrienv/autoloop-presets": "0.7.0"
   }
 }

package/plugins/autoloop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "autoloop",
-  "version": "0.3.0",
+  "version": "0.7.0",
   "description": "Run and operate autoloops — start runs, monitor progress, inject guidance, manage worktrees, inspect artifacts, and clean up.",
   "homepage": "https://github.com/mikeyobrien/autoloop-ts",
   "repository": "https://github.com/mikeyobrien/autoloop-ts",

package/dist/agent-map.d.ts

@@ -1,10 +0,0 @@
-export interface AgentMap {
-    globalDefault: string;
-    presets: Record<string, PresetAgentMap>;
-}
-export interface PresetAgentMap {
-    defaultAgent: string;
-    roles: Record<string, string>;
-}
-export declare function loadAgentMap(projectDir: string): AgentMap | null;
-export declare function resolveRoleAgent(agentMap: AgentMap | null, presetName: string, roleId: string): string | undefined;

package/dist/agent-map.js

@@ -1,58 +0,0 @@
-/**
- * Loads and resolves per-role agent mappings from agents.toml.
- *
- * Resolution order:
- *   1. preset.<name>.<role>  (role-specific)
- *   2. preset.<name>.default (preset default)
- *   3. defaults.agent        (global fallback)
- *   4. undefined              (caller falls back to backend.agent)
- */
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import TOML from "@iarna/toml";
-export function loadAgentMap(projectDir) {
-    const path = join(projectDir, "agents.toml");
-    if (!existsSync(path))
-        return null;
-    const text = readFileSync(path, "utf-8");
-    const parsed = TOML.parse(text);
-    return buildAgentMap(parsed);
-}
-export function resolveRoleAgent(agentMap, presetName, roleId) {
-    if (!agentMap)
-        return undefined;
-    const preset = agentMap.presets[presetName];
-    if (preset) {
-        const roleAgent = preset.roles[roleId];
-        if (roleAgent)
-            return roleAgent;
-        if (preset.defaultAgent)
-            return preset.defaultAgent;
-    }
-    return agentMap.globalDefault || undefined;
-}
-function buildAgentMap(parsed) {
-    const defaults = parsed["defaults"];
-    const globalDefault = typeof defaults?.["agent"] === "string" ? defaults["agent"] : "";
-    const presets = {};
-    const presetSection = parsed["preset"];
-    if (presetSection) {
-        for (const [name, value] of Object.entries(presetSection)) {
-            if (typeof value === "object" && value !== null) {
-                presets[name] = buildPresetAgentMap(value);
-            }
-        }
-    }
-    return { globalDefault, presets };
-}
-function buildPresetAgentMap(section) {
-    const defaultAgent = typeof section["default"] === "string" ? section["default"] : "";
-    const roles = {};
-    for (const [key, value] of Object.entries(section)) {
-        if (key !== "default" && typeof value === "string") {
-            roles[key] = value;
-        }
-    }
-    return { defaultAgent, roles };
-}
-//# sourceMappingURL=agent-map.js.map

package/dist/agent-map.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-map.js","sourceRoot":"","sources":["../src/agent-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,aAAa,CAAC;AAY/B,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;IAC3D,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAyB,EACzB,UAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAChC,IAAI,MAAM,CAAC,YAAY;YAAE,OAAO,MAAM,CAAC,YAAY,CAAC;IACtD,CAAC;IAED,OAAO,QAAQ,CAAC,aAAa,IAAI,SAAS,CAAC;AAC7C,CAAC;AAED,SAAS,aAAa,CAAC,MAA+B;IACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAwC,CAAC;IAC3E,MAAM,aAAa,GACjB,OAAO,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnE,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAwC,CAAC;IAC9E,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,KAAgC,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAgC;IAC3D,MAAM,YAAY,GAChB,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnD,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/backend/acp-client.d.ts

@@ -1,38 +0,0 @@
-import { type ChildProcess } from "node:child_process";
-import * as acp from "@agentclientprotocol/sdk";
-export interface AcpClientOptions {
-    command: string;
-    args: string[];
-    cwd: string;
-    trustAllTools: boolean;
-    agentName?: string;
-    modelId?: string;
-    verbose?: boolean;
-}
-export interface AcpSession {
-    sessionId: string;
-    connection: acp.ClientSideConnection;
-    process: ChildProcess;
-    textBuffer: string;
-    stderrBuffer: string;
-    options: AcpClientOptions;
-    /** Resolves when the child process exits — used to race against hanging prompts */
-    closed: Promise<{
-        code: number | null;
-        signal: string | null;
-    }>;
-}
-export interface AcpPromptResult {
-    output: string;
-    stopReason: acp.StopReason;
-    timedOut: boolean;
-    error?: string;
-}
-/**
- * Format an ACP SessionUpdate for verbose stderr output.
- * Returns null for event types that should be silenced.
- */
-export declare function formatStreamingUpdate(update: acp.SessionUpdate): string | null;
-export declare function initAcpSession(opts: AcpClientOptions): Promise<AcpSession>;
-export declare function sendAcpPrompt(session: AcpSession, prompt: string, timeoutMs: number): Promise<AcpPromptResult>;
-export declare function terminateAcpSession(session: AcpSession): Promise<void>;