@mobrienv/autoloop-harness 0.7.4 → 0.8.0

package/dist/control/claude-sdk-adapter.js

@@ -0,0 +1,79 @@
+import { defaultCapabilities } from "./capabilities.js";
+/**
+ * Live-control adapter for the claude-sdk backend. The Claude Agent SDK runs
+ * each iteration as a streaming-input session: `interrupt()` cancels the
+ * in-flight turn, and a pushed user message steers it mid-turn — delivered at
+ * the next safe boundary. Guidance also stays durable via the journal, so
+ * `guide` is always applied even when live steering is unavailable.
+ */
+export function claudeSdkControlAdapter(runId, hooks) {
+    const caps = buildCapabilities(runId);
+    return {
+        backend: "claude-sdk",
+        capabilities() {
+            return caps;
+        },
+        onRequest(request) {
+            if (request.verb === "interrupt") {
+                return applyInterrupt(hooks);
+            }
+            if (request.verb === "guide") {
+                const payload = request.payload;
+                if (payload?.interrupt) {
+                    return applyInterrupt(hooks, "guidance-driven");
+                }
+                return applySteer(hooks, payload?.message ?? "");
+            }
+            return { state: "ignored", detail: `unknown verb: ${request.verb}` };
+        },
+    };
+}
+function buildCapabilities(runId) {
+    const base = defaultCapabilities("claude-sdk", runId);
+    base.interrupt = {
+        supported: true,
+        detail: "SDK interrupt() of the in-flight turn",
+    };
+    base.guidance = {
+        supported: true,
+        detail: "journal-durable + live steer into the in-flight turn",
+    };
+    return base;
+}
+function applySteer(hooks, message) {
+    if (!message) {
+        return { state: "applied", detail: "guidance appended" };
+    }
+    try {
+        hooks.triggerSteer(message);
+        return {
+            state: "applied",
+            detail: "guidance appended + steered into live turn",
+        };
+    }
+    catch {
+        // Steering is opportunistic; the journal copy still reaches the next
+        // iteration prompt, so the guidance itself is applied either way.
+        return {
+            state: "applied",
+            detail: "guidance appended (live steer unavailable)",
+        };
+    }
+}
+function applyInterrupt(hooks, detailPrefix = "interrupt") {
+    try {
+        hooks.triggerInterrupt();
+        return {
+            state: "applied",
+            detail: `${detailPrefix}: SDK interrupt sent`,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            state: "rejected",
+            detail: `${detailPrefix}: interrupt failed: ${msg}`,
+        };
+    }
+}
+//# sourceMappingURL=claude-sdk-adapter.js.map

package/dist/control/claude-sdk-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-sdk-adapter.js","sourceRoot":"","sources":["../../src/control/claude-sdk-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAexD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAa,EACb,KAA4B;IAE5B,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAEtC,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,YAAY;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QACD,SAAS,CAAC,OAAuB;YAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACjC,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAuB,CAAC;gBAChD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;oBACvB,OAAO,cAAc,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;gBAClD,CAAC;gBACD,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACvE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,IAAI,GAAG,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,SAAS,GAAG;QACf,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,uCAAuC;KAChD,CAAC;IACF,IAAI,CAAC,QAAQ,GAAG;QACd,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,sDAAsD;KAC/D,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAA4B,EAAE,OAAe;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC;QACH,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,4CAA4C;SACrD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,kEAAkE;QAClE,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,4CAA4C;SACrD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,KAA4B,EAC5B,YAAY,GAAG,WAAW;IAE1B,IAAI,CAAC;QACH,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,GAAG,YAAY,sBAAsB;SAC9C,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,GAAG,YAAY,uBAAuB,GAAG,EAAE;SACpD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/control/dispatch.d.ts

@@ -0,0 +1,14 @@
+import type { LiveControlAdapter } from "./adapter.js";
+import type { ControlRequest } from "./types.js";
+/**
+ * Publish an adapter's capabilities to the run-scoped control directory.
+ * Called at loop start and any time the adapter's capabilities change.
+ */
+export declare function publishCapabilities(runStateDir: string, adapter: LiveControlAdapter): void;
+/**
+ * Drain all pending control requests for this run, handing each to the
+ * adapter and recording its ack to the status log.
+ *
+ * Returns the list of requests that were acknowledged on this drain pass.
+ */
+export declare function drainControlRequests(runStateDir: string, adapter: LiveControlAdapter): ControlRequest[];

package/dist/control/dispatch.js

@@ -0,0 +1,41 @@
+import { appendStatus, pendingRequests, writeCapabilities } from "./queue.js";
+/**
+ * Publish an adapter's capabilities to the run-scoped control directory.
+ * Called at loop start and any time the adapter's capabilities change.
+ */
+export function publishCapabilities(runStateDir, adapter) {
+    writeCapabilities(runStateDir, adapter.capabilities());
+}
+/**
+ * Drain all pending control requests for this run, handing each to the
+ * adapter and recording its ack to the status log.
+ *
+ * Returns the list of requests that were acknowledged on this drain pass.
+ */
+export function drainControlRequests(runStateDir, adapter) {
+    const requests = pendingRequests(runStateDir);
+    for (const request of requests) {
+        ackRequest(runStateDir, adapter, request);
+    }
+    return requests;
+}
+function ackRequest(runStateDir, adapter, request) {
+    let ack;
+    try {
+        ack = adapter.onRequest(request);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        ack = { state: "rejected", detail: `adapter threw: ${msg}` };
+    }
+    const status = {
+        id: request.id,
+        runId: request.runId,
+        verb: request.verb,
+        state: ack.state,
+        at: new Date().toISOString(),
+        detail: ack.detail,
+    };
+    appendStatus(runStateDir, status);
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/control/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/control/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG9E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,OAA2B;IAE3B,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,OAA2B;IAE3B,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC9C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,UAAU,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CACjB,WAAmB,EACnB,OAA2B,EAC3B,OAAuB;IAEvB,IAAI,GAAe,CAAC;IACpB,IAAI,CAAC;QACH,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,GAAG,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,EAAE,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,MAAM,GAAkB;QAC5B,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB,CAAC;IACF,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/control/index.d.ts

@@ -0,0 +1,11 @@
+export { acpControlAdapter, kiroControlAdapter } from "./acp-adapter.js";
+export type { LiveControlAdapter } from "./adapter.js";
+export { CAPABILITY_VERBS, defaultCapabilities, supportsInterrupt, } from "./capabilities.js";
+export { claudeSdkControlAdapter } from "./claude-sdk-adapter.js";
+export { drainControlRequests, publishCapabilities } from "./dispatch.js";
+export { baseStateDirFromRunState, controlCapabilitiesFile, controlDir, controlRequestsFile, controlStatusFile, } from "./paths.js";
+export { piControlAdapter } from "./pi-adapter.js";
+export { appendRequest, appendStatus, buildRequest, newRequestId, pendingRequests, readCapabilities, readRequests, readStatuses, writeCapabilities, } from "./queue.js";
+export type { ControlSnapshot } from "./render.js";
+export { renderCapabilities, renderShow } from "./render.js";
+export type { CapabilityVerb, ControlAck, ControlCapabilities, ControlCapability, ControlPayload, ControlRequest, ControlStatus, ControlStatusState, ControlVerb, GuidePayload, InterruptPayload, } from "./types.js";

package/dist/control/index.js

@@ -0,0 +1,9 @@
+export { acpControlAdapter, kiroControlAdapter } from "./acp-adapter.js";
+export { CAPABILITY_VERBS, defaultCapabilities, supportsInterrupt, } from "./capabilities.js";
+export { claudeSdkControlAdapter } from "./claude-sdk-adapter.js";
+export { drainControlRequests, publishCapabilities } from "./dispatch.js";
+export { baseStateDirFromRunState, controlCapabilitiesFile, controlDir, controlRequestsFile, controlStatusFile, } from "./paths.js";
+export { piControlAdapter } from "./pi-adapter.js";
+export { appendRequest, appendStatus, buildRequest, newRequestId, pendingRequests, readCapabilities, readRequests, readStatuses, writeCapabilities, } from "./queue.js";
+export { renderCapabilities, renderShow } from "./render.js";
+//# sourceMappingURL=index.js.map

package/dist/control/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/control/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEzE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,EACV,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/control/kiro-adapter.d.ts

@@ -0,0 +1,2 @@
+export type { AcpAdapterHooks as KiroAdapterHooks } from "./acp-adapter.js";
+export { acpControlAdapter, kiroControlAdapter, } from "./acp-adapter.js";

package/dist/control/kiro-adapter.js

@@ -0,0 +1,2 @@
+export { acpControlAdapter, kiroControlAdapter, } from "./acp-adapter.js";
+//# sourceMappingURL=kiro-adapter.js.map

package/dist/control/kiro-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kiro-adapter.js","sourceRoot":"","sources":["../../src/control/kiro-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/control/paths.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolve the run-scoped control directory.
+ *
+ * `runStateDir` is the per-run state tree:
+ *   - run-scoped mode: <base>/.autoloop/runs/<run-id>/
+ *   - worktree mode:   <worktree>/.autoloop/
+ *   - shared mode:     <base>/.autoloop/runs/<run-id>/ (same as run-scoped)
+ *
+ * The registry record's `state_dir` is always the right input.
+ */
+export declare function controlDir(runStateDir: string): string;
+export declare function controlRequestsFile(runStateDir: string): string;
+export declare function controlStatusFile(runStateDir: string): string;
+export declare function controlCapabilitiesFile(runStateDir: string): string;
+/**
+ * Infer the base state dir given a run's recorded state_dir. Used to find the
+ * parent `.autoloop/` registry when the run dir is a per-run or worktree tree.
+ */
+export declare function baseStateDirFromRunState(runStateDir: string): string;

package/dist/control/paths.js

@@ -0,0 +1,40 @@
+import { basename, join } from "node:path";
+/**
+ * Resolve the run-scoped control directory.
+ *
+ * `runStateDir` is the per-run state tree:
+ *   - run-scoped mode: <base>/.autoloop/runs/<run-id>/
+ *   - worktree mode:   <worktree>/.autoloop/
+ *   - shared mode:     <base>/.autoloop/runs/<run-id>/ (same as run-scoped)
+ *
+ * The registry record's `state_dir` is always the right input.
+ */
+export function controlDir(runStateDir) {
+    return join(runStateDir, "control");
+}
+export function controlRequestsFile(runStateDir) {
+    return join(controlDir(runStateDir), "requests.jsonl");
+}
+export function controlStatusFile(runStateDir) {
+    return join(controlDir(runStateDir), "status.jsonl");
+}
+export function controlCapabilitiesFile(runStateDir) {
+    return join(controlDir(runStateDir), "capabilities.json");
+}
+/**
+ * Infer the base state dir given a run's recorded state_dir. Used to find the
+ * parent `.autoloop/` registry when the run dir is a per-run or worktree tree.
+ */
+export function baseStateDirFromRunState(runStateDir) {
+    // run-scoped: <base>/runs/<run-id>/  -> parent of parent
+    // worktree: <work>/.autoloop/        -> runStateDir itself is the base
+    // shared:   same as run-scoped
+    const parentName = basename(runStateDir);
+    if (parentName === ".autoloop" || parentName === ".miniloop") {
+        return runStateDir;
+    }
+    // runs/<run-id>/ path — peel two levels
+    const runs = join(runStateDir, "..");
+    return join(runs, "..");
+}
+//# sourceMappingURL=paths.js.map

package/dist/control/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/control/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,OAAO,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,yDAAyD;IACzD,uEAAuE;IACvE,+BAA+B;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC7D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,wCAAwC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/control/pi-adapter.d.ts

@@ -0,0 +1,15 @@
+import type { LiveControlAdapter } from "./adapter.js";
+export interface PiAdapterHooks {
+    /** Called when the supervisor asks the backend to cancel its in-flight turn. */
+    triggerInterrupt: () => void;
+    /** Called to queue guidance into the in-flight turn via pi's `steer` command. */
+    triggerSteer: (message: string) => void;
+}
+/**
+ * Live-control adapter for the pi backend. Pi runs as a persistent RPC
+ * session (`pi --mode rpc`): `abort` cancels the in-flight turn, and `steer`
+ * queues guidance into it mid-turn — delivered before the next LLM call.
+ * Guidance also stays durable via the journal, so `guide` is always applied
+ * even when live steering is unavailable.
+ */
+export declare function piControlAdapter(runId: string, hooks: PiAdapterHooks): LiveControlAdapter;

package/dist/control/pi-adapter.js

@@ -0,0 +1,76 @@
+import { defaultCapabilities } from "./capabilities.js";
+/**
+ * Live-control adapter for the pi backend. Pi runs as a persistent RPC
+ * session (`pi --mode rpc`): `abort` cancels the in-flight turn, and `steer`
+ * queues guidance into it mid-turn — delivered before the next LLM call.
+ * Guidance also stays durable via the journal, so `guide` is always applied
+ * even when live steering is unavailable.
+ */
+export function piControlAdapter(runId, hooks) {
+    const caps = buildCapabilities(runId);
+    return {
+        backend: "pi",
+        capabilities() {
+            return caps;
+        },
+        onRequest(request) {
+            if (request.verb === "interrupt") {
+                return applyInterrupt(hooks);
+            }
+            if (request.verb === "guide") {
+                const payload = request.payload;
+                if (payload?.interrupt) {
+                    return applyInterrupt(hooks, "guidance-driven");
+                }
+                return applySteer(hooks, payload?.message ?? "");
+            }
+            return { state: "ignored", detail: `unknown verb: ${request.verb}` };
+        },
+    };
+}
+function buildCapabilities(runId) {
+    const base = defaultCapabilities("pi", runId);
+    base.interrupt = {
+        supported: true,
+        detail: "pi RPC abort of the in-flight turn",
+    };
+    base.guidance = {
+        supported: true,
+        detail: "journal-durable + live steer into the in-flight turn",
+    };
+    return base;
+}
+function applySteer(hooks, message) {
+    if (!message) {
+        return { state: "applied", detail: "guidance appended" };
+    }
+    try {
+        hooks.triggerSteer(message);
+        return {
+            state: "applied",
+            detail: "guidance appended + steered into live turn",
+        };
+    }
+    catch {
+        // Steering is opportunistic; the journal copy still reaches the next
+        // iteration prompt, so the guidance itself is applied either way.
+        return {
+            state: "applied",
+            detail: "guidance appended (live steer unavailable)",
+        };
+    }
+}
+function applyInterrupt(hooks, detailPrefix = "interrupt") {
+    try {
+        hooks.triggerInterrupt();
+        return { state: "applied", detail: `${detailPrefix}: pi abort sent` };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            state: "rejected",
+            detail: `${detailPrefix}: abort failed: ${msg}`,
+        };
+    }
+}
+//# sourceMappingURL=pi-adapter.js.map

package/dist/control/pi-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-adapter.js","sourceRoot":"","sources":["../../src/control/pi-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAexD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,KAAqB;IAErB,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAEtC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,YAAY;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QACD,SAAS,CAAC,OAAuB;YAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACjC,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAuB,CAAC;gBAChD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;oBACvB,OAAO,cAAc,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;gBAClD,CAAC;gBACD,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACvE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,GAAG;QACf,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,oCAAoC;KAC7C,CAAC;IACF,IAAI,CAAC,QAAQ,GAAG;QACd,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,sDAAsD;KAC/D,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAAqB,EAAE,OAAe;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC;QACH,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,4CAA4C;SACrD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,kEAAkE;QAClE,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,4CAA4C;SACrD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,KAAqB,EACrB,YAAY,GAAG,WAAW;IAE1B,IAAI,CAAC;QACH,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,iBAAiB,EAAE,CAAC;IACxE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,GAAG,YAAY,mBAAmB,GAAG,EAAE;SAChD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/control/queue.d.ts

@@ -0,0 +1,14 @@
+import type { ControlCapabilities, ControlPayload, ControlRequest, ControlStatus, ControlVerb } from "./types.js";
+export declare function appendRequest(runStateDir: string, request: ControlRequest): void;
+export declare function readRequests(runStateDir: string): ControlRequest[];
+export declare function appendStatus(runStateDir: string, status: ControlStatus): void;
+export declare function readStatuses(runStateDir: string): ControlStatus[];
+export declare function writeCapabilities(runStateDir: string, caps: ControlCapabilities): void;
+export declare function readCapabilities(runStateDir: string): ControlCapabilities | null;
+/**
+ * Pending requests are requests with no status line yet — i.e. control the
+ * harness has not yet acknowledged.
+ */
+export declare function pendingRequests(runStateDir: string): ControlRequest[];
+export declare function newRequestId(): string;
+export declare function buildRequest(runId: string, verb: ControlVerb, payload: ControlPayload, reason?: string): ControlRequest;

package/dist/control/queue.js

@@ -0,0 +1,82 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { dirname } from "node:path";
+import { controlCapabilitiesFile, controlRequestsFile, controlStatusFile, } from "./paths.js";
+function ensureDir(path) {
+    mkdirSync(dirname(path), { recursive: true });
+}
+function readJsonlLines(path) {
+    if (!existsSync(path))
+        return [];
+    const text = readFileSync(path, "utf-8");
+    const out = [];
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            out.push(JSON.parse(trimmed));
+        }
+        catch {
+            /* skip malformed */
+        }
+    }
+    return out;
+}
+export function appendRequest(runStateDir, request) {
+    const path = controlRequestsFile(runStateDir);
+    ensureDir(path);
+    appendFileSync(path, `${JSON.stringify(request)}\n`, "utf-8");
+}
+export function readRequests(runStateDir) {
+    return readJsonlLines(controlRequestsFile(runStateDir));
+}
+export function appendStatus(runStateDir, status) {
+    const path = controlStatusFile(runStateDir);
+    ensureDir(path);
+    appendFileSync(path, `${JSON.stringify(status)}\n`, "utf-8");
+}
+export function readStatuses(runStateDir) {
+    return readJsonlLines(controlStatusFile(runStateDir));
+}
+export function writeCapabilities(runStateDir, caps) {
+    const path = controlCapabilitiesFile(runStateDir);
+    ensureDir(path);
+    writeFileSync(path, `${JSON.stringify(caps, null, 2)}\n`, "utf-8");
+}
+export function readCapabilities(runStateDir) {
+    const path = controlCapabilitiesFile(runStateDir);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Pending requests are requests with no status line yet — i.e. control the
+ * harness has not yet acknowledged.
+ */
+export function pendingRequests(runStateDir) {
+    const requests = readRequests(runStateDir);
+    const acked = new Set(readStatuses(runStateDir).map((s) => s.id));
+    return requests.filter((r) => !acked.has(r.id));
+}
+function randomSuffix() {
+    return Math.random().toString(36).slice(2, 8);
+}
+export function newRequestId() {
+    return `ctl_${Date.now().toString(36)}_${randomSuffix()}`;
+}
+export function buildRequest(runId, verb, payload, reason = "") {
+    return {
+        id: newRequestId(),
+        runId,
+        requestedAt: new Date().toISOString(),
+        verb,
+        reason,
+        payload,
+    };
+}
+//# sourceMappingURL=queue.js.map

package/dist/control/queue.js.map

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

package/dist/control/render.d.ts

@@ -0,0 +1,10 @@
+import type { RunRecord } from "@mobrienv/autoloop-core/registry/types";
+import type { ControlCapabilities, ControlRequest, ControlStatus } from "./types.js";
+export interface ControlSnapshot {
+    run: RunRecord;
+    capabilities: ControlCapabilities | null;
+    pendingRequests: ControlRequest[];
+    recentStatuses: ControlStatus[];
+}
+export declare function renderShow(snap: ControlSnapshot): string;
+export declare function renderCapabilities(caps: ControlCapabilities | null): string;

package/dist/control/render.js

@@ -0,0 +1,53 @@
+import { CAPABILITY_VERBS } from "./capabilities.js";
+export function renderShow(snap) {
+    const lines = [];
+    lines.push(`Run:         ${snap.run.run_id}`);
+    lines.push(`Status:      ${snap.run.status}`);
+    lines.push(`Preset:      ${snap.run.preset}`);
+    lines.push(`Backend:     ${snap.run.backend || "(unknown)"}`);
+    lines.push(`Iteration:   ${snap.run.iteration}`);
+    if (snap.run.stop_reason)
+        lines.push(`Stop:        ${snap.run.stop_reason}`);
+    if (snap.run.pid)
+        lines.push(`PID:         ${snap.run.pid}`);
+    lines.push("");
+    lines.push(renderCapabilities(snap.capabilities));
+    lines.push("");
+    lines.push("Recent control activity:");
+    if (snap.recentStatuses.length === 0 && snap.pendingRequests.length === 0) {
+        lines.push("  (none)");
+    }
+    else {
+        for (const r of snap.pendingRequests) {
+            lines.push(`  pending  ${r.verb.padEnd(10)} ${r.id}  ${r.reason || ""}`);
+        }
+        for (const s of snap.recentStatuses.slice(-5)) {
+            const detail = s.detail ? ` — ${s.detail}` : "";
+            lines.push(`  ${s.state.padEnd(8)} ${s.verb.padEnd(10)} ${s.id}${detail}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function renderCapabilities(caps) {
+    if (!caps) {
+        return "Capabilities: (none published yet — run may not be live)";
+    }
+    const lines = [];
+    lines.push(`Capabilities (backend: ${caps.backend}):`);
+    for (const verb of CAPABILITY_VERBS) {
+        const cap = caps[verb];
+        const mark = cap.supported ? "yes" : "no ";
+        const detail = cap.detail ? ` — ${cap.detail}` : "";
+        lines.push(`  ${verb.padEnd(10)} ${mark}${detail}`);
+    }
+    if (caps.extras) {
+        for (const [name, cap] of Object.entries(caps.extras)) {
+            const mark = cap.supported ? "yes" : "no ";
+            const detail = cap.detail ? ` — ${cap.detail}` : "";
+            lines.push(`  ${name.padEnd(10)} ${mark}${detail}`);
+        }
+    }
+    lines.push(`  published  ${caps.publishedAt}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/control/render.js.map

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

package/dist/control/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Backend-neutral live-control types.
+ *
+ * The supervisor-facing contract. Adapters (Kiro ACP, Pi, future Claude live
+ * sessions) map these verbs to backend-specific behavior; the journal remains
+ * canonical for what actually happened.
+ */
+export type ControlVerb = "interrupt" | "guide";
+export type CapabilityVerb = "guidance" | "interrupt" | "inspect";
+export interface GuidePayload {
+    message: string;
+    /** If true, operator wants the current turn aborted so guidance is picked up now. */
+    interrupt: boolean;
+}
+export type InterruptPayload = Record<string, never>;
+export type ControlPayload = GuidePayload | InterruptPayload;
+export interface ControlRequest {
+    id: string;
+    runId: string;
+    requestedAt: string;
+    verb: ControlVerb;
+    reason: string;
+    payload: ControlPayload;
+}
+export interface ControlCapability {
+    supported: boolean;
+    detail?: string;
+}
+export type ControlCapabilities = Record<CapabilityVerb, ControlCapability> & {
+    backend: string;
+    publishedAt: string;
+    runId: string;
+    extras?: Record<string, ControlCapability>;
+};
+export type ControlStatusState = "received" | "applied" | "rejected" | "ignored";
+export interface ControlStatus {
+    id: string;
+    runId: string;
+    verb: ControlVerb;
+    state: ControlStatusState;
+    at: string;
+    detail?: string;
+}
+export interface ControlAck {
+    state: ControlStatusState;
+    detail?: string;
+}

package/dist/control/types.js

@@ -0,0 +1,9 @@
+/**
+ * Backend-neutral live-control types.
+ *
+ * The supervisor-facing contract. Adapters (Kiro ACP, Pi, future Claude live
+ * sessions) map these verbs to backend-specific behavior; the journal remains
+ * canonical for what actually happened.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/control/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/control/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/emit.js

@@ -34,6 +34,7 @@ const CORE_SYSTEM_TOPICS = new Set([
     "review.finish",
     "backend.start",
     "backend.finish",
+    "backend.usage",
     "event.invalid",
 ]);
 export function coreSystemTopic(topic) {
@@ -70,12 +71,13 @@ export function emit(projectDir, topic, payload) {
     if (operatorTopic(topic)) {
         return acceptEmit(journalFile, topic, payload, validation);
     }
-    // Task completion gate: block completion if open tasks remain
+    // Task completion gate: block completion if open blocking tasks remain.
+    // Soft tasks (soft === true) are advisory and never block completion.
     if (topic === validation.completionEvent) {
         const tasksFile = config.resolveTasksFile(projectDir);
-        const openTasks = materializeOpenFrom(tasksFile);
-        if (openTasks.length > 0) {
-            return rejectTaskGate(journalFile, topic, openTasks, validation);
+        const blockingTasks = materializeOpenFrom(tasksFile).filter((t) => t.soft !== true);
+        if (blockingTasks.length > 0) {
+            return rejectTaskGate(journalFile, topic, blockingTasks, validation);
         }
     }
     if (invalidEvent(topic, validation.allowedEvents, validation.parallelEnabled, validation.completionEvent)) {