@mobrienv/autoloop 0.4.0 → 0.7.0

package/README.md

@@ -7,10 +7,36 @@ It’s a simpler, more opinionated loop harness for long-running agent work: ins
 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/)
 
+**[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.
@@ -196,7 +222,7 @@ Bundled presets give you opinionated starting points for common workflows like c
 
 ## 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.
 
@@ -253,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":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAU5C,SAAS,mBAAmB;IAC1B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,mBAAmB,EAAE,CAAC;IAC3E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8FAA8F,CAC/F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;QACnD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,CAAC;YAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;YAC9B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,GAAG,IAAI,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,OAAe;IAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;YAClE,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;YAClC,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAE9B,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;AACvC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,GAAG,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "@mobrienv/autoloop",
-  "version": "0.4.0",
+  "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"
   },
@@ -11,27 +19,19 @@
     "bin/autoloop",
     "dist",
     "plugins/autoloop",
-    "presets/autocode",
-    "presets/autodebug",
-    "presets/autodoc",
-    "presets/autofix",
-    "presets/autoideas",
-    "presets/automerge",
-    "presets/autoperf",
-    "presets/autopr",
-    "presets/autopreset",
-    "presets/autoqa",
-    "presets/autoresearch",
-    "presets/autoreview",
-    "presets/autosec",
-    "presets/autosimplify",
-    "presets/autospec",
-    "presets/autotest",
     "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"
@@ -53,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/",
@@ -62,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"
   },
@@ -78,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.4.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>;

package/dist/backend/acp-client.js

@@ -1,293 +0,0 @@
-import { spawn } from "node:child_process";
-import * as acp from "@agentclientprotocol/sdk";
-/**
- * Format an ACP SessionUpdate for verbose stderr output.
- * Returns null for event types that should be silenced.
- */
-export function formatStreamingUpdate(update) {
-    switch (update.sessionUpdate) {
-        case "agent_message_chunk":
-            return update.content?.type === "text" ? update.content.text : null;
-        case "agent_thought_chunk":
-            return update.content?.type === "text"
-                ? `[thinking] ${update.content.text}\n`
-                : null;
-        case "tool_call":
-            return `[tool:${update.kind ?? "other"}] ${update.title}\n`;
-        case "tool_call_update":
-            if (update.status === "completed")
-                return `[tool:✓] ${update.title ?? ""}\n`;
-            if (update.status === "failed")
-                return `[tool:✗] ${update.title ?? ""}\n`;
-            return null;
-        default:
-            return null;
-    }
-}
-export async function initAcpSession(opts) {
-    const child = spawn(opts.command, opts.args, {
-        stdio: ["pipe", "pipe", "pipe"],
-        cwd: opts.cwd,
-        env: process.env,
-        detached: true, // create own process group so process.kill(-pid) in terminateAcpSession kills the full tree
-    });
-    if (!child.stdout || !child.stdin) {
-        throw new Error("Failed to create ACP process stdio streams");
-    }
-    const session = {
-        sessionId: "",
-        connection: null,
-        process: child,
-        textBuffer: "",
-        stderrBuffer: "",
-        options: opts,
-        closed: null,
-    };
-    // Buffer stderr for diagnostics
-    if (child.stderr) {
-        child.stderr.on("data", (chunk) => {
-            session.stderrBuffer += chunk.toString();
-        });
-    }
-    // Track process exit so hanging prompts can bail out
-    session.closed = new Promise((resolve) => {
-        child.on("close", (code, signal) => resolve({ code, signal }));
-    });
-    // Build transport: manual NDJSON parsing on stdout (more reliable), SDK serialization on stdin
-    const stdin = child.stdin;
-    const stdout = child.stdout;
-    const writable = new WritableStream({
-        async write(chunk) {
-            if (stdin.destroyed || stdin.writableEnded)
-                return;
-            return new Promise((resolve, reject) => {
-                stdin.write(chunk, (err) => (err ? reject(err) : resolve()));
-            });
-        },
-        close() {
-            stdin.end();
-        },
-        abort(reason) {
-            stdin.destroy(reason instanceof Error ? reason : new Error(String(reason)));
-        },
-    });
-    let buffer = "";
-    const decoder = new TextDecoder();
-    let msgController;
-    const parsedMessages = new ReadableStream({
-        start(controller) {
-            msgController = controller;
-        },
-        cancel() {
-            stdout.destroy();
-        },
-    });
-    stdout.on("data", (chunk) => {
-        buffer += decoder.decode(chunk, { stream: true });
-        const lines = buffer.split("\n");
-        buffer = lines.pop() || "";
-        for (const line of lines) {
-            const trimmed = line.trim();
-            if (trimmed) {
-                try {
-                    const msg = JSON.parse(trimmed);
-                    // Filter kiro-cli private notifications — the ACP SDK doesn't know about
-                    // _kiro.dev/* methods and responds with -32601 "Method not found".
-                    // These are private kiro-cli extensions the ACP SDK does not handle.
-                    if (msg.method &&
-                        typeof msg.method === "string" &&
-                        msg.method.startsWith("_kiro.dev/")) {
-                        continue;
-                    }
-                    msgController.enqueue(msg);
-                }
-                catch {
-                    /* skip malformed */
-                }
-            }
-        }
-    });
-    stdout.on("end", () => {
-        if (buffer.trim()) {
-            try {
-                msgController.enqueue(JSON.parse(buffer.trim()));
-            }
-            catch {
-                /* skip */
-            }
-        }
-        msgController.close();
-    });
-    stdout.on("error", (err) => {
-        msgController.error(err);
-    });
-    // Use ndJsonStream only for writable serialization; readable is our manual parser
-    const dummyReadable = new ReadableStream({ start() { } });
-    const ndJson = acp.ndJsonStream(writable, dummyReadable);
-    const stream = {
-        readable: parsedMessages,
-        writable: ndJson.writable,
-    };
-    const client = {
-        async requestPermission(params) {
-            if (opts.trustAllTools && params.options?.length) {
-                const allow = params.options.find((o) => o.kind === "allow_always") ??
-                    params.options.find((o) => o.kind === "allow_once");
-                if (allow)
-                    return { outcome: { outcome: "selected", optionId: allow.optionId } };
-            }
-            return { outcome: { outcome: "cancelled" } };
-        },
-        async sessionUpdate(params) {
-            const { update } = params;
-            if (!update)
-                return;
-            if (update.sessionUpdate === "agent_message_chunk" &&
-                update.content?.type === "text") {
-                session.textBuffer += update.content.text;
-            }
-            if (opts.verbose) {
-                const line = formatStreamingUpdate(update);
-                if (line)
-                    process.stderr.write(line);
-            }
-        },
-    };
-    session.connection = new acp.ClientSideConnection(() => client, stream);
-    // Initialize
-    await session.connection.initialize({
-        protocolVersion: acp.PROTOCOL_VERSION,
-        clientCapabilities: {},
-        clientInfo: { name: "autoloop", version: "0.1.0" },
-    });
-    // Create session
-    const result = await session.connection.newSession({
-        cwd: opts.cwd,
-        mcpServers: [],
-    });
-    session.sessionId = result.sessionId;
-    // Optionally set mode/model
-    if (opts.agentName) {
-        await session.connection.setSessionMode({
-            sessionId: session.sessionId,
-            modeId: opts.agentName,
-        });
-    }
-    if (opts.modelId) {
-        await session.connection.unstable_setSessionModel({
-            sessionId: session.sessionId,
-            modelId: opts.modelId,
-        });
-    }
-    return session;
-}
-export async function sendAcpPrompt(session, prompt, timeoutMs) {
-    session.textBuffer = "";
-    // Retry with backoff if agent isn't idle yet
-    const maxAttempts = 3;
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-        try {
-            return await sendAcpPromptOnce(session, prompt, timeoutMs);
-        }
-        catch (err) {
-            if (err.message?.includes("not idle") && attempt < maxAttempts) {
-                await new Promise((r) => setTimeout(r, attempt * 2000));
-                continue;
-            }
-            throw err;
-        }
-    }
-    // unreachable, but satisfies TS
-    return {
-        output: session.textBuffer,
-        stopReason: "end_turn",
-        timedOut: false,
-        error: "retry exhausted",
-    };
-}
-async function sendAcpPromptOnce(session, prompt, timeoutMs) {
-    session.textBuffer = "";
-    let timedOut = false;
-    let timer;
-    const timeoutPromise = new Promise((_resolve, reject) => {
-        timer = setTimeout(() => {
-            timedOut = true;
-            session.connection.cancel({ sessionId: session.sessionId });
-            reject(new Error("ACP prompt timed out"));
-        }, timeoutMs);
-    });
-    // Detect process crash mid-prompt
-    const crashPromise = session.closed.then(({ code, signal }) => {
-        const stderr = session.stderrBuffer.trim();
-        const detail = stderr ? `\n${stderr}` : "";
-        throw new Error(`kiro-cli exited unexpectedly: code=${code} signal=${signal}${detail}`);
-    });
-    try {
-        const response = await Promise.race([
-            session.connection.prompt({
-                sessionId: session.sessionId,
-                prompt: [{ type: "text", text: prompt }],
-            }),
-            timeoutPromise,
-            crashPromise,
-        ]);
-        clearTimeout(timer);
-        return {
-            output: session.textBuffer,
-            stopReason: response.stopReason,
-            timedOut: false,
-        };
-    }
-    catch (err) {
-        clearTimeout(timer);
-        if (timedOut) {
-            return {
-                output: session.textBuffer,
-                stopReason: "cancelled",
-                timedOut: true,
-            };
-        }
-        return {
-            output: session.textBuffer,
-            stopReason: "end_turn",
-            timedOut: false,
-            error: String(err),
-        };
-    }
-}
-export async function terminateAcpSession(session) {
-    const child = session.process;
-    if (!child.pid || child.killed)
-        return;
-    // Cancel any in-flight turn before killing
-    try {
-        session.connection.cancel({ sessionId: session.sessionId });
-    }
-    catch {
-        /* may not have a session */
-    }
-    // Kill the entire process tree — MCP servers run in their own process groups
-    // and won't die from just killing the parent.
-    const pid = child.pid;
-    try {
-        process.kill(-pid, "SIGTERM");
-    }
-    catch {
-        /* process group may not exist */
-    }
-    child.kill("SIGTERM");
-    const exited = await Promise.race([
-        new Promise((resolve) => child.on("exit", () => resolve(true))),
-        new Promise((resolve) => setTimeout(() => resolve(false), 3000)),
-    ]);
-    if (!exited && !child.killed) {
-        try {
-            process.kill(-pid, "SIGKILL");
-        }
-        catch {
-            /* already dead */
-        }
-        child.kill("SIGKILL");
-    }
-}
-//# sourceMappingURL=acp-client.js.map