@mobrienv/autoloop-harness 0.7.0

package/dist/stop.js

@@ -0,0 +1,81 @@
+import { jsonField } from "@mobrienv/autoloop-core";
+import { appendEvent } from "@mobrienv/autoloop-core/journal";
+import { lastNChars, log } from "./display.js";
+import { registryComplete, registryStop } from "./registry-bridge.js";
+export function stopMaxIterations(loop, iteration) {
+    const completed = iteration <= 1 ? 0 : iteration - 1;
+    log(loop, "warn", `loop stop reason=max_iterations completed_iterations=${completed} max_iterations=${loop.limits.maxIterations}`);
+    loop.onEvent?.({
+        type: "progress",
+        runId: loop.runtime.runId,
+        iteration: completed,
+        recentEvent: "loop.stop",
+        allowedRoles: [],
+        outcome: "stop:max_iterations",
+    });
+    log(loop, "info", `Reached iteration limit: ${completed}/${loop.limits.maxIterations} iterations completed.`);
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, "", "loop.stop", jsonField("reason", "max_iterations") +
+        ", " +
+        jsonField("completed_iterations", String(completed)) +
+        ", " +
+        jsonField("stopped_before_iteration", String(iteration)) +
+        ", " +
+        jsonField("max_iterations", String(loop.limits.maxIterations)));
+    registryStop(loop, completed, "max_iterations");
+    return { iterations: completed, stopReason: "max_iterations" };
+}
+export function stopBackendFailed(loop, iteration, output) {
+    log(loop, "error", `loop stop reason=backend_failed iteration=${iteration}`);
+    loop.onEvent?.({
+        type: "progress",
+        runId: loop.runtime.runId,
+        iteration,
+        recentEvent: "loop.stop",
+        allowedRoles: [],
+        outcome: "stop:backend_failed",
+    });
+    loop.onEvent?.({
+        type: "failure.diagnostic",
+        output,
+        stopReason: "backend_failed",
+    });
+    const tail = lastNChars(output, 500);
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "loop.stop", jsonField("reason", "backend_failed") +
+        ", " +
+        jsonField("iteration", String(iteration)) +
+        ", " +
+        jsonField("output_tail", tail));
+    registryStop(loop, iteration, "backend_failed");
+    return { iterations: iteration, stopReason: "backend_failed" };
+}
+export function stopBackendTimeout(loop, iteration, output) {
+    log(loop, "error", `loop stop reason=backend_timeout iteration=${iteration}`);
+    loop.onEvent?.({
+        type: "progress",
+        runId: loop.runtime.runId,
+        iteration,
+        recentEvent: "loop.stop",
+        allowedRoles: [],
+        outcome: "stop:backend_timeout",
+    });
+    loop.onEvent?.({
+        type: "failure.diagnostic",
+        output,
+        stopReason: "backend_timeout",
+    });
+    const tail = lastNChars(output, 500);
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "loop.stop", jsonField("reason", "backend_timeout") +
+        ", " +
+        jsonField("iteration", String(iteration)) +
+        ", " +
+        jsonField("output_tail", tail));
+    registryStop(loop, iteration, "backend_timeout");
+    return { iterations: iteration, stopReason: "backend_timeout" };
+}
+export function completeLoop(loop, iteration, reason) {
+    log(loop, "info", `loop complete reason=${reason}`);
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "loop.complete", jsonField("reason", reason));
+    registryComplete(loop, iteration, reason);
+    return { iterations: iteration, stopReason: reason };
+}
+//# sourceMappingURL=stop.js.map

package/dist/stop.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { LoopContext } from "./index.js";
+export declare function emitToolScript(loop: LoopContext): string;
+export declare function piAdapterScript(loop: LoopContext): string;

package/dist/tools.js

@@ -0,0 +1,65 @@
+import { joinCsv, shellQuote } from "@mobrienv/autoloop-core";
+export function emitToolScript(loop) {
+    return ("#!/bin/sh\n" +
+        "set -eu\n" +
+        "export AUTOLOOP_PROJECT_DIR=" +
+        shellQuote(loop.paths.projectDir) +
+        "\n" +
+        "export AUTOLOOP_STATE_DIR=" +
+        shellQuote(loop.paths.stateDir) +
+        "\n" +
+        "export AUTOLOOP_JOURNAL_FILE=" +
+        shellQuote(loop.paths.journalFile) +
+        "\n" +
+        "export AUTOLOOP_EVENTS_FILE=" +
+        shellQuote(loop.paths.journalFile) +
+        "\n" +
+        "export AUTOLOOP_MEMORY_FILE=" +
+        shellQuote(loop.paths.memoryFile) +
+        "\n" +
+        "export AUTOLOOP_TASKS_FILE=" +
+        shellQuote(loop.paths.tasksFile) +
+        "\n" +
+        "export AUTOLOOP_RUN_ID=" +
+        shellQuote(loop.runtime.runId) +
+        "\n" +
+        "export AUTOLOOP_COMPLETION_EVENT=" +
+        shellQuote(loop.completion.event) +
+        "\n" +
+        "export AUTOLOOP_REQUIRED_EVENTS=" +
+        shellQuote(joinCsv(loop.completion.requiredEvents)) +
+        "\n" +
+        "export AUTOLOOP_BIN=" +
+        shellQuote(loop.paths.toolPath) +
+        "\n" +
+        "stdout_file=$(mktemp)\n" +
+        "stderr_file=$(mktemp)\n" +
+        "cleanup() {\n" +
+        '  rm -f "$stdout_file" "$stderr_file"\n' +
+        "}\n" +
+        "trap cleanup EXIT\n" +
+        "if " +
+        loop.runtime.selfCommand +
+        ' "$@" >"$stdout_file" 2>"$stderr_file"; then\n' +
+        "  status=0\n" +
+        "else\n" +
+        "  status=$?\n" +
+        "fi\n" +
+        'cat "$stderr_file" >&2\n' +
+        'if [ "${1:-}" = "emit" ]; then\n' +
+        "  inner=$(sed -n 's/^%{:exit_code => \\([0-9][0-9]*\\),.*$/\\1/p' \"$stdout_file\" | tail -n 1)\n" +
+        '  if [ -n "$inner" ]; then\n' +
+        '    exit "$inner"\n' +
+        "  fi\n" +
+        "fi\n" +
+        'cat "$stdout_file"\n' +
+        'exit "$status"\n');
+}
+export function piAdapterScript(loop) {
+    return ("#!/bin/sh\n" +
+        "set -eu\n" +
+        "exec " +
+        loop.runtime.selfCommand +
+        ' pi-adapter "$@"\n');
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG9D,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,OAAO,CACL,aAAa;QACb,WAAW;QACX,8BAA8B;QAC9B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QACjC,IAAI;QACJ,4BAA4B;QAC5B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI;QACJ,+BAA+B;QAC/B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QAClC,IAAI;QACJ,8BAA8B;QAC9B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QAClC,IAAI;QACJ,8BAA8B;QAC9B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QACjC,IAAI;QACJ,6BAA6B;QAC7B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QAChC,IAAI;QACJ,yBAAyB;QACzB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAC9B,IAAI;QACJ,mCAAmC;QACnC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QACjC,IAAI;QACJ,kCAAkC;QAClC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI;QACJ,sBAAsB;QACtB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI;QACJ,yBAAyB;QACzB,yBAAyB;QACzB,eAAe;QACf,yCAAyC;QACzC,KAAK;QACL,qBAAqB;QACrB,KAAK;QACL,IAAI,CAAC,OAAO,CAAC,WAAW;QACxB,gDAAgD;QAChD,cAAc;QACd,QAAQ;QACR,eAAe;QACf,MAAM;QACN,0BAA0B;QAC1B,kCAAkC;QAClC,mGAAmG;QACnG,8BAA8B;QAC9B,qBAAqB;QACrB,QAAQ;QACR,MAAM;QACN,sBAAsB;QACtB,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAiB;IAC/C,OAAO,CACL,aAAa;QACb,WAAW;QACX,OAAO;QACP,IAAI,CAAC,OAAO,CAAC,WAAW;QACxB,oBAAoB,CACrB,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,137 @@
+import type { AcpSession } from "@mobrienv/autoloop-backends/acp-client";
+import type { AgentMap } from "@mobrienv/autoloop-core/agent-map";
+import type * as topo from "@mobrienv/autoloop-core/topology";
+import type { LoopEventEmitter } from "./events.js";
+export type TriggerSource = "cli" | "chain" | "branch";
+export interface LaunchMetadata {
+    preset: string;
+    trigger: TriggerSource;
+    createdAt: string;
+    parentRunId: string;
+}
+export interface ProfileInfo {
+    active: string[];
+    fragments: Map<string, string>;
+    warnings: string[];
+}
+export type VerdictKind = "CONTINUE" | "REDIRECT" | "TAKEOVER" | "EXIT";
+export interface Verdict {
+    verdict: VerdictKind;
+    confidence: number;
+    reasoning: string;
+    redirect_prompt?: string;
+    takeover_output?: string;
+    suggestions?: string[];
+}
+export interface LoopContext {
+    objective: string;
+    topology: topo.Topology;
+    limits: {
+        maxIterations: number;
+    };
+    completion: {
+        promise: string;
+        event: string;
+        requiredEvents: string[];
+    };
+    backend: {
+        kind: string;
+        command: string;
+        args: string[];
+        promptMode: string;
+        timeoutMs: number;
+    };
+    review: {
+        enabled: boolean;
+        every: number;
+        adversarialFirst: boolean;
+        kind: string;
+        command: string;
+        args: string[];
+        promptMode: string;
+        prompt: string;
+        timeoutMs: number;
+    };
+    parallel: {
+        enabled: boolean;
+        maxBranches: number;
+        branchTimeoutMs: number;
+    };
+    memory: {
+        budgetChars: number;
+    };
+    tasks: {
+        budgetChars: number;
+    };
+    harness: {
+        instructions: string;
+    };
+    profiles: ProfileInfo;
+    paths: {
+        projectDir: string;
+        workDir: string;
+        stateDir: string;
+        journalFile: string;
+        memoryFile: string;
+        runMemoryFile: string;
+        tasksFile: string;
+        registryFile: string;
+        toolPath: string;
+        piAdapterPath: string;
+        baseStateDir: string;
+        mainProjectDir: string;
+        worktreeBranch: string;
+        worktreePath: string;
+        worktreeMetaDir: string;
+    };
+    runtime: {
+        runId: string;
+        selfCommand: string;
+        promptOverride: string | null;
+        backendOverride: Record<string, unknown>;
+        logLevel: string;
+        branchMode: boolean;
+        isolationMode: string;
+    };
+    launch: LaunchMetadata;
+    store: Record<string, unknown>;
+    agentMap: AgentMap | null;
+    kiroSession?: AcpSession;
+    lastVerdict?: Verdict;
+    /** Optional structured-event emitter, forwarded from RunOptions.onEvent. */
+    onEvent?: LoopEventEmitter;
+}
+export interface RunOptions {
+    workDir?: string;
+    backendOverride?: Record<string, unknown>;
+    logLevel?: string | null;
+    prompt?: string | null;
+    chain?: string | null;
+    trigger?: TriggerSource;
+    parentRunId?: string;
+    profiles?: string[];
+    noDefaultProfiles?: boolean;
+    worktree?: boolean;
+    noWorktree?: boolean;
+    isolationMode?: string;
+    mergeStrategy?: string;
+    automerge?: boolean;
+    keepWorktree?: boolean;
+    /**
+     * Optional abort signal. When provided, the CLI (or SDK caller) owns
+     * process signal handling; the harness only listens to this signal for
+     * graceful teardown. Without a signal the harness runs to completion
+     * and no signal-handling is installed.
+     */
+    signal?: AbortSignal;
+    /**
+     * Optional structured-event listener. Emitted alongside the existing
+     * terminal output; SDK consumers can drive custom UIs from this stream.
+     */
+    onEvent?: LoopEventEmitter;
+}
+export interface RunSummary {
+    iterations: number;
+    stopReason: string;
+    runId?: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/wave/finalize-wave.d.ts

@@ -0,0 +1,9 @@
+import type { IterationContext } from "../prompt.js";
+import type { LoopContext, RunSummary } from "../types.js";
+import type { BranchResult, IterateFn } from "./types.js";
+export declare function finalizeParallelWave(loop: LoopContext, iter: IterationContext, waveId: string, results: BranchResult[]): {
+    reason: string;
+    waveId: string;
+};
+export declare function continueAfterParallelJoin(loop: LoopContext, iter: IterationContext, waveId: string, emittedTopic: string, totalElapsedMs: number, iterateFn: IterateFn): Promise<RunSummary>;
+export declare function stopAfterParallelWave(loop: LoopContext, iter: IterationContext, reason: string, waveId: string): RunSummary;

package/dist/wave/finalize-wave.js

@@ -0,0 +1,86 @@
+import { joinCsv, jsonField } from "@mobrienv/autoloop-core";
+import { appendEvent, appendHarnessEvent, } from "@mobrienv/autoloop-core/journal";
+import * as topology from "@mobrienv/autoloop-core/topology";
+import { parallelDispatchBase, parallelJoinedTopic } from "../emit.js";
+export function finalizeParallelWave(loop, iter, waveId, results) {
+    const timedOut = results
+        .filter((r) => r.stopReason === "backend_timeout")
+        .map((r) => r.branchId);
+    if (timedOut.length > 0) {
+        appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.timeout", jsonField("wave_id", waveId) +
+            ", " +
+            jsonField("timed_out_branches", joinCsv(timedOut)));
+        return { reason: "parallel_wave_timeout", waveId };
+    }
+    const failed = results
+        .filter((r) => !branchSuccessStatus(r.stopReason))
+        .map((r) => r.branchId);
+    if (failed.length > 0) {
+        appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.failed", jsonField("wave_id", waveId) +
+            ", " +
+            jsonField("failed_branches", joinCsv(failed)));
+        return { reason: "parallel_wave_failed", waveId };
+    }
+    return { reason: "parallel_wave_complete", waveId };
+}
+function branchSuccessStatus(status) {
+    return (status === "max_iterations" ||
+        status === "completion_event" ||
+        status === "completion_promise");
+}
+export async function continueAfterParallelJoin(loop, iter, waveId, emittedTopic, totalElapsedMs, iterateFn) {
+    const joinedTopic = parallelJoinedTopic(emittedTopic);
+    appendWaveJoinFinish(loop, iter, waveId, emittedTopic, joinedTopic, totalElapsedMs);
+    appendHarnessEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), joinedTopic, waveId);
+    return iterateFn(loop, iter.iteration + 1);
+}
+export function stopAfterParallelWave(loop, iter, reason, waveId) {
+    const fields = jsonField("reason", reason) +
+        ", " +
+        jsonField("iteration", String(iter.iteration)) +
+        (waveId ? `, ${jsonField("wave_id", waveId)}` : "");
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "loop.stop", fields);
+    return { iterations: iter.iteration, stopReason: reason };
+}
+function joinedResumeRoutingBasis(iter, emittedTopic) {
+    if (emittedTopic === "explore.parallel")
+        return iter.recentEvent;
+    return parallelDispatchBase(emittedTopic) || iter.recentEvent;
+}
+function joinedResumeRecentEvent(iter, emittedTopic, joinedTopic) {
+    if (emittedTopic === "explore.parallel")
+        return iter.recentEvent;
+    return joinedTopic;
+}
+function joinedResumeRoles(loop, iter, emittedTopic, routingBasis) {
+    if (emittedTopic === "explore.parallel")
+        return iter.allowedRoles;
+    return topology.suggestedRoles(loop.topology, routingBasis);
+}
+function joinedResumeEvents(loop, iter, emittedTopic, routingBasis) {
+    if (emittedTopic === "explore.parallel")
+        return iter.allowedEvents;
+    return topology.allowedEvents(loop.topology, routingBasis);
+}
+function appendWaveJoinFinish(loop, iter, waveId, emittedTopic, joinedTopic, totalElapsed) {
+    const routingBasis = joinedResumeRoutingBasis(iter, emittedTopic);
+    const resumeRecentEvent = joinedResumeRecentEvent(iter, emittedTopic, joinedTopic);
+    const resumeRoles = joinedResumeRoles(loop, iter, emittedTopic, routingBasis);
+    const resumeEvents = joinedResumeEvents(loop, iter, emittedTopic, routingBasis);
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.join.finish", jsonField("wave_id", waveId) +
+        ", " +
+        jsonField("trigger_topic", emittedTopic) +
+        ", " +
+        jsonField("joined_topic", joinedTopic) +
+        ", " +
+        jsonField("routing_basis", routingBasis) +
+        ", " +
+        jsonField("resume_recent_event", resumeRecentEvent) +
+        ", " +
+        jsonField("resume_roles", joinCsv(resumeRoles)) +
+        ", " +
+        jsonField("resume_events", joinCsv(resumeEvents)) +
+        ", " +
+        jsonField("elapsed_ms", String(totalElapsed)));
+}
+//# sourceMappingURL=finalize-wave.js.map

package/dist/wave/finalize-wave.js.map

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

package/dist/wave/launch-branches.d.ts

@@ -0,0 +1,6 @@
+import type { IterationContext } from "../prompt.js";
+import type { LoopContext } from "../types.js";
+import type { BranchResult, BranchSpec } from "./types.js";
+export declare function prepareParallelBranches(loop: LoopContext, iter: IterationContext, waveId: string, waveDir: string, emittedTopic: string, objectives: string[]): BranchSpec[];
+export declare function launchParallelBranches(loop: LoopContext, specs: BranchSpec[]): BranchSpec[];
+export declare function joinParallelBranches(loop: LoopContext, iter: IterationContext, waveId: string, pending: BranchSpec[]): BranchResult[];