@mobrienv/autoloop 0.1.2

package/dist/harness/emit.js

@@ -0,0 +1,220 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import * as config from "../config.js";
+import * as topology from "../topology.js";
+import { splitCsv, listText, joinCsv } from "../utils.js";
+import { jsonField } from "../json.js";
+import { appendAgentEvent, appendEvent, latestRunId, latestIterationForRun, } from "./journal.js";
+const COORDINATION_TOPICS = new Set([
+    "issue.discovered",
+    "issue.resolved",
+    "slice.started",
+    "slice.verified",
+    "slice.committed",
+    "context.archived",
+    "chain.spawn",
+]);
+export function coordinationTopic(topic) {
+    return COORDINATION_TOPICS.has(topic);
+}
+const CORE_SYSTEM_TOPICS = new Set([
+    "iteration.start",
+    "iteration.finish",
+    "loop.start",
+    "loop.complete",
+    "loop.stop",
+    "review.start",
+    "review.finish",
+    "backend.start",
+    "backend.finish",
+    "event.invalid",
+]);
+export function coreSystemTopic(topic) {
+    if (CORE_SYSTEM_TOPICS.has(topic))
+        return true;
+    return topic.startsWith("wave.");
+}
+export function systemTopic(topic) {
+    return coordinationTopic(topic) || coreSystemTopic(topic);
+}
+export function parallelTopic(topic) {
+    return parallelTriggerTopic(topic) || reservedParallelJoinedTopic(topic);
+}
+export function parallelTriggerTopic(topic) {
+    if (topic === "explore.parallel")
+        return true;
+    return dispatchParallelTopic(topic);
+}
+function dispatchParallelTopic(topic) {
+    if (topic === "explore.parallel")
+        return false;
+    return topic.endsWith(".parallel");
+}
+export function reservedParallelJoinedTopic(topic) {
+    return topic.endsWith(".parallel.joined");
+}
+export function emit(projectDir, topic, payload) {
+    const journalFile = resolveEmitJournalFile(projectDir);
+    mkdirSync(dirname(journalFile), { recursive: true });
+    const validation = emitValidationContext(projectDir, journalFile);
+    if (coordinationTopic(topic)) {
+        acceptEmit(journalFile, topic, payload, validation);
+        return;
+    }
+    if (invalidEvent(topic, validation.allowedEvents, validation.parallelEnabled, validation.completionEvent)) {
+        rejectEmit(journalFile, topic, validation);
+    }
+    else {
+        acceptEmit(journalFile, topic, payload, validation);
+    }
+}
+export function invalidEvent(emittedTopic, allowedEvents, parallelEnabled, completionEvent) {
+    if (!emittedTopic)
+        return false;
+    if (reservedParallelJoinedTopic(emittedTopic))
+        return true;
+    if (!parallelEnabled) {
+        if (parallelTopic(emittedTopic))
+            return true;
+        return invalidEventAfterParallelCheck(emittedTopic, allowedEvents);
+    }
+    if (parallelTopic(emittedTopic)) {
+        return !validParallelTriggerEvent(emittedTopic, allowedEvents, completionEvent);
+    }
+    return invalidEventAfterParallelCheck(emittedTopic, allowedEvents);
+}
+function invalidEventAfterParallelCheck(emittedTopic, allowedEvents) {
+    if (allowedEvents.length === 0)
+        return false;
+    return !topology.eventMatchesAny(emittedTopic, allowedEvents);
+}
+function validParallelTriggerEvent(emittedTopic, allowedEvents, completionEvent) {
+    if (emittedTopic === "explore.parallel")
+        return true;
+    const baseEvent = parallelDispatchBase(emittedTopic);
+    if (!baseEvent)
+        return false;
+    if (baseEvent === completionEvent)
+        return false;
+    if (coordinationTopic(baseEvent) ||
+        coreSystemTopic(baseEvent) ||
+        parallelTopic(baseEvent))
+        return false;
+    if (allowedEvents.length === 0)
+        return false;
+    return topology.eventMatchesAny(baseEvent, allowedEvents);
+}
+export function parallelDispatchBase(topic) {
+    if (!dispatchParallelTopic(topic))
+        return "";
+    return topic.slice(0, -".parallel".length);
+}
+export function parallelJoinedTopic(topic) {
+    return topic + ".joined";
+}
+export function dispatchParallelJoinedTopic(topic) {
+    if (topic === "explore.parallel.joined")
+        return false;
+    return topic.endsWith(".parallel.joined");
+}
+export function dispatchParallelJoinBase(topic) {
+    if (topic === "explore.parallel.joined")
+        return "loop.start";
+    if (dispatchParallelJoinedTopic(topic)) {
+        return topic.slice(0, -".parallel.joined".length);
+    }
+    return topic;
+}
+export function routingTopic(topic) {
+    const nonRouting = new Set([
+        "iteration.start",
+        "iteration.finish",
+        "loop.complete",
+        "loop.stop",
+        "review.start",
+        "review.finish",
+        "backend.start",
+        "backend.finish",
+        "event.invalid",
+        "",
+    ]);
+    if (nonRouting.has(topic))
+        return false;
+    return !coordinationTopic(topic);
+}
+function emitValidationContext(projectDir, journalFile) {
+    const runId = resolveEmitRunId(journalFile);
+    const cfg = config.loadProject(projectDir);
+    const topo = topology.loadTopology(projectDir);
+    const compEvent = topology.completionEvent(topo, config.get(cfg, "event_loop.completion_event", "task.complete"));
+    const parallelEnabled = truthySetting(config.get(cfg, "parallel.enabled", "false"));
+    return {
+        runId,
+        iteration: resolveEmitIteration(journalFile, runId),
+        recentEvent: emitRecentEvent(),
+        allowedRoles: envCsvList("MINILOOPS_ALLOWED_ROLES"),
+        allowedEvents: envCsvList("MINILOOPS_ALLOWED_EVENTS"),
+        parallelEnabled,
+        completionEvent: compEvent,
+    };
+}
+function resolveEmitRunId(journalFile) {
+    const envValue = process.env["MINILOOPS_RUN_ID"];
+    return envValue || latestRunId(journalFile);
+}
+function resolveEmitIteration(journalFile, runId) {
+    const envValue = process.env["MINILOOPS_ITERATION"];
+    return envValue || latestIterationForRun(journalFile, runId);
+}
+function emitRecentEvent() {
+    return process.env["MINILOOPS_RECENT_EVENT"] || "loop.start";
+}
+function envCsvList(name) {
+    const value = process.env[name];
+    if (!value)
+        return [];
+    return splitCsv(value);
+}
+function acceptEmit(journalFile, topic, payload, validation) {
+    appendAgentEvent(journalFile, validation.runId, validation.iteration, topic, payload);
+    console.log("emitted " + topic);
+    process.exitCode = 0;
+}
+function rejectEmit(journalFile, topic, validation) {
+    const message = invalidEmitMessage(topic, validation);
+    appendInvalidEvent(journalFile, validation.runId, validation.iteration, validation.recentEvent, topic, validation.allowedRoles, validation.allowedEvents);
+    process.stderr.write(message + "\n");
+    process.exitCode = 1;
+}
+function invalidEmitMessage(topic, validation) {
+    return ("invalid event `" +
+        topic +
+        "`; recent event: `" +
+        validation.recentEvent +
+        "`; suggested roles: " +
+        listText(validation.allowedRoles) +
+        "; allowed next events: " +
+        listText(validation.allowedEvents));
+}
+export function appendInvalidEvent(journalFile, runId, iteration, recentEvent, emittedTopic, allowedRoles, allowedEvents) {
+    appendEvent(journalFile, runId, iteration, "event.invalid", jsonField("recent_event", recentEvent) +
+        ", " +
+        jsonField("emitted", emittedTopic) +
+        ", " +
+        jsonField("suggested_roles", joinCsv(allowedRoles)) +
+        ", " +
+        jsonField("allowed_events", joinCsv(allowedEvents)));
+}
+export function resolveEmitJournalFile(projectDir) {
+    const envJournal = process.env["MINILOOPS_JOURNAL_FILE"];
+    if (envJournal)
+        return envJournal;
+    const envEvents = process.env["MINILOOPS_EVENTS_FILE"];
+    if (envEvents)
+        return envEvents;
+    return config.resolveJournalFile(projectDir);
+}
+function truthySetting(value) {
+    return value !== "false" && value !== "0" && value !== "";
+}
+//# sourceMappingURL=emit.js.map

package/dist/harness/emit.js.map

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

package/dist/harness/index.d.ts

@@ -0,0 +1,13 @@
+import { emit as emitCmd } from "./emit.js";
+import type { LoopContext, RunOptions, RunSummary } from "./types.js";
+export type { LoopContext, RunOptions, RunSummary };
+export declare function run(projectDir: string, promptOverride: string | null, selfCommand: string, runOptions: RunOptions): RunSummary;
+export { emitCmd as emit };
+export declare function renderScratchpadFormat(projectDir: string, format: string): void;
+export declare function renderPromptFormat(projectDir: string, iteration: string, format: string): void;
+export declare function renderOutput(projectDir: string, iteration: string): void;
+export declare function renderJournal(projectDir: string): void;
+export declare function renderCoordinationFormat(projectDir: string, format: string): void;
+export declare function renderMetrics(projectDir: string, format: string): void;
+export declare function renderMetricsForRun(projectDir: string, runId: string, format: string): void;
+export declare function runParallelBranchCli(projectDir: string, branchDir: string, selfCommand: string): void;

package/dist/harness/index.js

@@ -0,0 +1,124 @@
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { readRunLines, readIfExists } from "./journal.js";
+import { emit as emitCmd, resolveEmitJournalFile } from "./emit.js";
+import { renderRunScratchpadFull } from "./scratchpad.js";
+import { coordinationFromLines } from "./coordination.js";
+import { collectMetricsRows, formatMetrics } from "./metrics.js";
+import { loadParallelBranchLaunch, parallelBranchBackendOverride, writeParallelBranchSummary, renderBranchResult, seedBranchContext, branchStopReason, appendLoopStart, } from "./parallel.js";
+import { printSummary, log, printProjectedMarkdown, printProjectedText, } from "./display.js";
+import { ensureLayout, installRuntimeTools, iterationFieldForRun, ensureRenderRunId, emptyFallback, buildLoopContext, reloadLoop, applyRuntimeModeOverrides, initStore, } from "./config-helpers.js";
+import { maybeRunMetareview } from "./metareview.js";
+import { runIteration } from "./iteration.js";
+import { stopMaxIterations } from "./stop.js";
+import { registryStart } from "../registry/harness.js";
+export function run(projectDir, promptOverride, selfCommand, runOptions) {
+    let loop = buildLoopContext(projectDir, promptOverride, selfCommand, runOptions);
+    loop = reloadLoop(loop);
+    loop = initStore(loop);
+    ensureLayout(loop.paths.stateDir);
+    installRuntimeTools(loop);
+    appendLoopStart(loop);
+    registryStart(loop);
+    log(loop, "info", `loop start run_id=${loop.runtime.runId} max_iterations=${loop.limits.maxIterations}`);
+    const summary = iterate(loop, 1);
+    printSummary(summary, loop);
+    return summary;
+}
+export { emitCmd as emit };
+export function renderScratchpadFormat(projectDir, format) {
+    const journalFile = resolveEmitJournalFile(projectDir);
+    const runId = ensureRenderRunId(journalFile);
+    printProjectedMarkdown(emptyFallback(renderRunScratchpadFull(readRunLines(journalFile, runId))), format);
+}
+export function renderPromptFormat(projectDir, iteration, format) {
+    const journalFile = resolveEmitJournalFile(projectDir);
+    const runId = ensureRenderRunId(journalFile);
+    const prompt = iterationFieldForRun(journalFile, runId, iteration, "iteration.start", "prompt");
+    if (!prompt) {
+        console.log(`missing prompt projection for iteration ${iteration}`);
+        return;
+    }
+    printProjectedMarkdown(prompt, format);
+}
+export function renderOutput(projectDir, iteration) {
+    const journalFile = resolveEmitJournalFile(projectDir);
+    const runId = ensureRenderRunId(journalFile);
+    const output = iterationFieldForRun(journalFile, runId, iteration, "iteration.finish", "output");
+    console.log(output || `missing output projection for iteration ${iteration}`);
+}
+export function renderJournal(projectDir) {
+    console.log(readIfExists(resolveEmitJournalFile(projectDir)));
+}
+export function renderCoordinationFormat(projectDir, format) {
+    const journalFile = resolveEmitJournalFile(projectDir);
+    const runId = ensureRenderRunId(journalFile);
+    const lines = readRunLines(journalFile, runId);
+    printProjectedMarkdown(emptyFallback(coordinationFromLines(lines)), format);
+}
+export function renderMetrics(projectDir, format) {
+    const journalFile = resolveEmitJournalFile(projectDir);
+    const runId = ensureRenderRunId(journalFile);
+    const lines = readRunLines(journalFile, runId);
+    const rows = collectMetricsRows(lines);
+    printProjectedText(formatMetrics(rows, format), format);
+}
+export function renderMetricsForRun(projectDir, runId, format) {
+    const journalFile = resolveEmitJournalFile(projectDir);
+    const lines = readRunLines(journalFile, runId);
+    const rows = collectMetricsRows(lines);
+    printProjectedText(formatMetrics(rows, format), format);
+}
+export function runParallelBranchCli(projectDir, branchDir, selfCommand) {
+    const launch = loadParallelBranchLaunch(branchDir);
+    const branchPrompt = launch.prompt;
+    const routingEvent = launch.routingEvent || "loop.start";
+    const backendOverride = parallelBranchBackendOverride(launch);
+    const logLevelVal = launch.logLevel || null;
+    let branchLoop = buildLoopContext(projectDir, branchPrompt, selfCommand, {
+        workDir: branchDir,
+        backendOverride,
+        logLevel: logLevelVal,
+        trigger: "branch",
+    });
+    branchLoop = reloadLoop(branchLoop);
+    branchLoop = initStore(branchLoop);
+    branchLoop.runtime.branchMode = true;
+    branchLoop = applyRuntimeModeOverrides(branchLoop);
+    ensureLayout(branchLoop.paths.stateDir);
+    installRuntimeTools(branchLoop);
+    appendLoopStart(branchLoop);
+    registryStart(branchLoop);
+    const seeded = seedBranchContext(branchLoop, routingEvent);
+    const startMs = Date.now();
+    const summary = iterate(seeded, 1);
+    const finishedMs = Date.now();
+    const elapsedMs = finishedMs - startMs;
+    const output = iterationFieldForRun(seeded.paths.journalFile, seeded.runtime.runId, "1", "iteration.finish", "output");
+    const stopReason = branchStopReason(summary.stopReason, elapsedMs, seeded.parallel.branchTimeoutMs);
+    const result = {
+        branch_id: launch.branchId,
+        objective: launch.objective,
+        stop_reason: stopReason,
+        output,
+        routing_event: routingEvent,
+        allowed_roles: launch.allowedRoles,
+        allowed_events: launch.allowedEvents,
+        branch_dir: branchDir,
+        elapsed_ms: elapsedMs,
+        finished_at_ms: finishedMs,
+    };
+    writeFileSync(join(branchDir, "result.md"), renderBranchResult(result));
+    writeParallelBranchSummary(branchDir, result);
+}
+// --- Private implementation ---
+function iterate(loop, iteration) {
+    const liveLoop = reloadLoop(loop);
+    installRuntimeTools(liveLoop);
+    const reviewed = maybeRunMetareview(liveLoop, iteration);
+    if (iteration > reviewed.limits.maxIterations) {
+        return stopMaxIterations(reviewed, iteration);
+    }
+    return runIteration(reviewed, iteration, iterate);
+}
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

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

package/dist/harness/iteration.d.ts

@@ -0,0 +1,4 @@
+import type { IterationContext } from "./prompt.js";
+import type { LoopContext, RunSummary } from "./types.js";
+export declare function runIteration(loop: LoopContext, iteration: number, iterate: (loop: LoopContext, iteration: number) => RunSummary): RunSummary;
+export declare function finishIteration(loop: LoopContext, iter: IterationContext, output: string, iterate: (loop: LoopContext, iteration: number) => RunSummary): RunSummary;

package/dist/harness/iteration.js

@@ -0,0 +1,129 @@
+import { listText } from "../utils.js";
+import { readRunLines, extractTopic, extractField, extractIteration } from "./journal.js";
+import { invalidEvent, systemTopic, parallelTriggerTopic, appendInvalidEvent } from "./emit.js";
+import { buildIterationContext } from "./prompt.js";
+import { executeParallelWave, continueAfterParallelJoin, stopAfterParallelWave } from "./wave.js";
+import { printIterationBanner, printIterationFooter, printProgressLine, log, } from "./display.js";
+import { buildBackendCommand, appendIterationStart, appendBackendStart, appendBackendFinish, appendIterationFinish, runProcess, } from "./parallel.js";
+import { stopBackendFailed, stopBackendTimeout, completeLoop } from "./stop.js";
+import { registryProgress } from "../registry/harness.js";
+export function runIteration(loop, iteration, iterate) {
+    const iter = buildIterationContext(loop, iteration);
+    printIterationBanner(loop, iter);
+    appendIterationStart(loop, iter);
+    log(loop, "debug", `iteration ${iteration} start`);
+    appendBackendStart(loop, iter);
+    log(loop, "debug", `backend start command=${loop.backend.command}`);
+    const startEpoch = Math.floor(Date.now() / 1000);
+    const { output, exitCode, timedOut } = runProcess(buildBackendCommand(loop, iter), loop.backend.timeoutMs, loop.backend.kind);
+    const elapsedS = Math.floor(Date.now() / 1000) - startEpoch;
+    appendBackendFinish(loop, iter, output, exitCode, timedOut);
+    appendIterationFinish(loop, iter, output, exitCode, timedOut, elapsedS);
+    registryProgress(loop, iteration);
+    log(loop, "debug", `iteration ${iteration} finish exit_code=${exitCode}`);
+    printIterationFooter(iter, elapsedS);
+    if (timedOut)
+        return stopBackendTimeout(loop, iteration, output);
+    if (exitCode !== 0)
+        return stopBackendFailed(loop, iteration, output);
+    return finishIteration(loop, iter, output, iterate);
+}
+export function finishIteration(loop, iter, output, iterate) {
+    const runLines = readRunLines(loop.paths.journalFile, loop.runtime.runId);
+    const allTopics = runLines.map(extractTopic).filter((t) => t !== "");
+    const turnLines = runLines.filter((l) => extractIteration(l) === String(iter.iteration));
+    const emitted = latestAgentEventRecord(turnLines);
+    if (invalidEvent(emitted.topic, iter.allowedEvents, loop.parallel.enabled, loop.completion.event)) {
+        return rejectInvalidAndContinue(loop, iter, emitted.topic, iterate);
+    }
+    if (parallelTriggerTopic(emitted.topic)) {
+        return finishParallelIteration(loop, iter, emitted.topic, emitted.payload, iterate);
+    }
+    if (completedViaEvent(allTopics, loop.completion.event, loop.completion.requiredEvents)) {
+        printProgressLine({
+            runId: loop.runtime.runId,
+            iteration: iter.iteration,
+            recentEvent: iter.recentEvent,
+            allowedRoles: iter.allowedRoles,
+            emittedTopic: emitted.topic,
+            outcome: "complete:completion_event",
+        });
+        return completeLoop(loop, iter.iteration, "completion_event");
+    }
+    if (completedViaPromise(output, loop.completion.promise)) {
+        printProgressLine({
+            runId: loop.runtime.runId,
+            iteration: iter.iteration,
+            recentEvent: iter.recentEvent,
+            allowedRoles: iter.allowedRoles,
+            emittedTopic: emitted.topic,
+            outcome: "complete:completion_promise",
+        });
+        return completeLoop(loop, iter.iteration, "completion_promise");
+    }
+    printProgressLine({
+        runId: loop.runtime.runId,
+        iteration: iter.iteration,
+        recentEvent: iter.recentEvent,
+        allowedRoles: iter.allowedRoles,
+        emittedTopic: emitted.topic,
+        outcome: "continue",
+    });
+    return iterate(loop, iter.iteration + 1);
+}
+function rejectInvalidAndContinue(loop, iter, emittedTopic, iterate) {
+    appendInvalidEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), iter.recentEvent, emittedTopic, iter.allowedRoles, iter.allowedEvents);
+    console.log(`[reject] invalid event \`${emittedTopic}\`; recent event: \`${iter.recentEvent}\`; allowed next events: ${listText(iter.allowedEvents)}`);
+    printProgressLine({
+        runId: loop.runtime.runId,
+        iteration: iter.iteration,
+        recentEvent: iter.recentEvent,
+        allowedRoles: iter.allowedRoles,
+        emittedTopic,
+        outcome: "rejected:event.invalid",
+    });
+    return iterate(loop, iter.iteration + 1);
+}
+function finishParallelIteration(loop, iter, emittedTopic, emittedPayload, iterate) {
+    const result = executeParallelWave(loop, iter, emittedTopic, emittedPayload);
+    if (result.reason === "parallel_wave_complete") {
+        printProgressLine({
+            runId: loop.runtime.runId,
+            iteration: iter.iteration,
+            recentEvent: iter.recentEvent,
+            allowedRoles: iter.allowedRoles,
+            emittedTopic,
+            outcome: "parallel:joined",
+        });
+        return continueAfterParallelJoin(loop, iter, result.waveId, emittedTopic, result.elapsedMs, iterate);
+    }
+    printProgressLine({
+        runId: loop.runtime.runId,
+        iteration: iter.iteration,
+        recentEvent: iter.recentEvent,
+        allowedRoles: iter.allowedRoles,
+        emittedTopic,
+        outcome: `parallel:stop:${result.reason}`,
+    });
+    return stopAfterParallelWave(loop, iter, result.reason, result.waveId);
+}
+function latestAgentEventRecord(lines) {
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const topic = extractTopic(lines[i]);
+        if (!systemTopic(topic)) {
+            return { topic, payload: extractField(lines[i], "payload") };
+        }
+    }
+    return { topic: "", payload: "" };
+}
+function completedViaEvent(topics, completionEvent, requiredEvents) {
+    if (!topics.includes(completionEvent))
+        return false;
+    return requiredEvents.every((e) => topics.includes(e));
+}
+function completedViaPromise(output, promise) {
+    if (!promise)
+        return false;
+    return output.includes(promise);
+}
+//# sourceMappingURL=iteration.js.map

package/dist/harness/iteration.js.map

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

package/dist/harness/journal.d.ts

@@ -0,0 +1,13 @@
+export declare function appendEvent(path: string, runId: string, iteration: string, topic: string, fieldsJson: string): void;
+export declare function appendAgentEvent(path: string, runId: string, iteration: string, topic: string, payload: string): void;
+export declare function appendHarnessEvent(path: string, runId: string, iteration: string, topic: string, payload: string): void;
+export declare function readLines(path: string): string[];
+export declare function readRunLines(path: string, runId: string): string[];
+export declare function extractTopic(line: string): string;
+export declare function extractField(line: string, key: string): string;
+export declare function extractRun(line: string): string;
+export declare function extractIteration(line: string): string;
+export declare function latestRunId(path: string): string;
+export declare function latestIterationForRun(path: string, runId: string): string;
+export declare function appendText(path: string, content: string): void;
+export declare function readIfExists(path: string): string;

package/dist/harness/journal.js

@@ -0,0 +1,106 @@
+import { existsSync, readFileSync, appendFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { extractField as jsonExtractField, extractTopic as jsonExtractTopic } from "../json.js";
+import { encodeEvent } from "../events/encode.js";
+import { lineSep } from "../utils.js";
+export function appendEvent(path, runId, iteration, topic, fieldsJson) {
+    appendText(path, encodeEvent({
+        shape: "fields",
+        run: runId,
+        iteration: iteration || undefined,
+        topic,
+        fields: parsedFields(fieldsJson),
+        rawFields: parsedFieldsRaw(fieldsJson),
+    }));
+}
+export function appendAgentEvent(path, runId, iteration, topic, payload) {
+    appendEmittedEvent(path, runId, iteration, topic, payload, "agent");
+}
+export function appendHarnessEvent(path, runId, iteration, topic, payload) {
+    appendEmittedEvent(path, runId, iteration, topic, payload, "harness");
+}
+function appendEmittedEvent(path, runId, iteration, topic, payload, source) {
+    appendText(path, encodeEvent({
+        shape: "payload",
+        run: runId,
+        iteration: iteration || undefined,
+        topic,
+        payload,
+        source,
+    }));
+}
+function parsedFields(fieldsJson) {
+    const parsed = parsedFieldsRaw(fieldsJson);
+    const result = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        result[key] = value === null || value === undefined ? "" : String(value);
+    }
+    return result;
+}
+function parsedFieldsRaw(fieldsJson) {
+    if (!fieldsJson.trim())
+        return {};
+    try {
+        return JSON.parse("{" + fieldsJson + "}");
+    }
+    catch {
+        return {};
+    }
+}
+export function readLines(path) {
+    const text = readIfExists(path);
+    return text
+        .split(lineSep())
+        .map((l) => l.trim())
+        .filter((l) => l !== "");
+}
+export function readRunLines(path, runId) {
+    return readLines(path).filter((line) => extractRun(line) === runId);
+}
+export function extractTopic(line) {
+    return jsonExtractTopic(line);
+}
+export function extractField(line, key) {
+    return jsonExtractField(line, key);
+}
+export function extractRun(line) {
+    return extractField(line, "run");
+}
+export function extractIteration(line) {
+    return extractField(line, "iteration");
+}
+export function latestRunId(path) {
+    const lines = readLines(path);
+    let current = "";
+    for (const line of lines) {
+        if (extractTopic(line) === "loop.start") {
+            const run = extractRun(line);
+            if (run)
+                current = run;
+        }
+    }
+    return current;
+}
+export function latestIterationForRun(path, runId) {
+    const lines = readRunLines(path, runId);
+    let current = "";
+    for (const line of lines) {
+        if (extractTopic(line) === "iteration.start") {
+            const iter = extractIteration(line);
+            if (iter)
+                current = iter;
+        }
+    }
+    return current;
+}
+export function appendText(path, content) {
+    const dir = dirname(path);
+    mkdirSync(dir, { recursive: true });
+    appendFileSync(path, content, "utf-8");
+}
+export function readIfExists(path) {
+    if (!existsSync(path))
+        return "";
+    return readFileSync(path, "utf-8");
+}
+//# sourceMappingURL=journal.js.map