@autopilot-harness/port-runner 0.12.0

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @autopilot-harness/port-runner — external process loop for hosts without stop-continue.
+ * No vendor Stop hook; CLI owns spawn + in-process ReviewEngine.handleStop.
+ */
+export { RUNNER_PLATFORM, RUNNER_DEFAULT_MAX_ITERATIONS, RUNNER_MIN_RECOMMENDED_ITERATIONS, RUNNER_MAX_ITERATIONS_CLAMP, RUNNER_PROMPT_FILE_THRESHOLD, normalizeRunnerConfig, hasRunnerCommand, assertRunnerCommand, type RunnerConfig, type RunnerConfigInput, type RunnerPromptMode, } from "./config.js";
+export { stableRunnerConversationId, runnerConversationFileToken, } from "./conversation-id.js";
+export { RUNNER_EXECUTING_SUMMARY, buildFirstTurnPrompt, } from "./first-turn-prompt.js";
+export { resolvePromptChannel, assertTemplateMatchesChannel, tokenizeCommandTemplate, expandCommandTemplate, resolveRunnerCwd, unlinkPromptFile, resolveChecklistPathInProject, type PromptChannel, type ExpandedCommand, } from "./command-template.js";
+export { driverResultToStopStatus, type AgentDriver, type DriverResult, type DriverRunInput, } from "./driver.js";
+export { CliDriver } from "./cli-driver.js";
+export { MockDriver, type MockDriverStep } from "./mock-driver.js";
+export { runStopTick, shouldContinueAfterStop, type RunStopTickInput, type RunStopTickResult, } from "./stop-tick.js";
+export { canResumeRunnerSession, type ResumeDecision, } from "./resume.js";
+export { runRunnerLoop, type RunRunnerLoopOptions, type RunnerLoopResult, type RunnerLoopOutcome, } from "./loop.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,eAAe,EACf,6BAA6B,EAC7B,iCAAiC,EACjC,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @autopilot-harness/port-runner — external process loop for hosts without stop-continue.
+ * No vendor Stop hook; CLI owns spawn + in-process ReviewEngine.handleStop.
+ */
+export { RUNNER_PLATFORM, RUNNER_DEFAULT_MAX_ITERATIONS, RUNNER_MIN_RECOMMENDED_ITERATIONS, RUNNER_MAX_ITERATIONS_CLAMP, RUNNER_PROMPT_FILE_THRESHOLD, normalizeRunnerConfig, hasRunnerCommand, assertRunnerCommand, } from "./config.js";
+export { stableRunnerConversationId, runnerConversationFileToken, } from "./conversation-id.js";
+export { RUNNER_EXECUTING_SUMMARY, buildFirstTurnPrompt, } from "./first-turn-prompt.js";
+export { resolvePromptChannel, assertTemplateMatchesChannel, tokenizeCommandTemplate, expandCommandTemplate, resolveRunnerCwd, unlinkPromptFile, resolveChecklistPathInProject, } from "./command-template.js";
+export { driverResultToStopStatus, } from "./driver.js";
+export { CliDriver } from "./cli-driver.js";
+export { MockDriver } from "./mock-driver.js";
+export { runStopTick, shouldContinueAfterStop, } from "./stop-tick.js";
+export { canResumeRunnerSession, } from "./resume.js";
+export { runRunnerLoop, } from "./loop.js";
+//# 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;;;GAGG;AAEH,OAAO,EACL,eAAe,EACf,6BAA6B,EAC7B,iCAAiC,EACjC,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GAIpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,GAG9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,GAIzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAuB,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EACL,WAAW,EACX,uBAAuB,GAGxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,GAEvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,GAId,MAAM,WAAW,CAAC"}

package/dist/loop.d.ts

@@ -0,0 +1,33 @@
+import { type FollowupLocaleBundle, type PhaseActionConfig, type StateStore } from "@autopilot-harness/core";
+import type { RunnerConfig } from "./config.js";
+import type { AgentDriver } from "./driver.js";
+import { runStopTick } from "./stop-tick.js";
+export type RunnerLoopOutcome = "completed" | "budget_exhausted" | "stopped" | "error";
+export interface RunnerLoopResult {
+    outcome: RunnerLoopOutcome;
+    iterations: number;
+    conversationId: string;
+    lastMessage?: string;
+    errorMessage?: string;
+}
+export interface RunRunnerLoopOptions {
+    store: StateStore;
+    projectRoot: string;
+    conversationId: string;
+    config: RunnerConfig;
+    /** When set, applyRun before the loop (fresh start). */
+    runSlug?: string;
+    phaseActions?: PhaseActionConfig;
+    /** Override driver (tests). Default: CliDriver when command set. */
+    driver?: AgentDriver;
+    localeBundle?: FollowupLocaleBundle;
+    /** Called before each agent turn with the prompt that will be sent. */
+    onPrompt?: (prompt: string, iteration: number) => void;
+    /** Override Stop tick (tests). Default: runStopTick. */
+    stopTick?: typeof runStopTick;
+}
+/**
+ * External Autopilot loop: spawn agent → handleStop → re-inject tip / stop.
+ */
+export declare function runRunnerLoop(opts: RunRunnerLoopOptions): Promise<RunnerLoopResult>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,OAAO,EACL,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,kBAAkB,GAClB,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,WAAW,CAAC;CAC/B;AAqCD;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAgN3B"}

package/dist/loop.js

@@ -0,0 +1,223 @@
+import { applyRun, firstUnchecked, isHarnessFollowupMessage, isSafeTrackSlug, loadProjectReviewConfig, normalizeProjectRoot, parseChecklist, sessionReviewRunnable, } from "@autopilot-harness/core";
+import { RUNNER_PLATFORM, assertRunnerCommand } from "./config.js";
+import { CliDriver } from "./cli-driver.js";
+import { resolveChecklistPathInProject } from "./command-template.js";
+import { driverResultToStopStatus } from "./driver.js";
+import { buildFirstTurnPrompt } from "./first-turn-prompt.js";
+import { canResumeRunnerSession } from "./resume.js";
+import { runStopTick, shouldContinueAfterStop, } from "./stop-tick.js";
+function resolveInitialPrompt(store, conversationId, projectRoot) {
+    const chain = store.getReviewChain(conversationId);
+    const pending = chain?.pending_followup?.trim() ?? "";
+    if (pending)
+        return pending;
+    const session = store.getSession(conversationId);
+    const slug = session?.track_id?.trim() ?? "";
+    const root = normalizeProjectRoot(store.projectRoot) ??
+        normalizeProjectRoot(projectRoot);
+    const checklistPath = session?.checklist_path?.trim();
+    if (!root || !slug || !checklistPath) {
+        throw new Error("Cannot build first-turn prompt: missing track or checklist path.");
+    }
+    if (!isSafeTrackSlug(slug)) {
+        throw new Error(`Unsafe track slug in session: "${slug.slice(0, 64)}"`);
+    }
+    const abs = resolveChecklistPathInProject(root, checklistPath);
+    if (!abs) {
+        throw new Error(`Checklist not found or outside project: ${checklistPath}`);
+    }
+    const cl = parseChecklist(abs, { projectRoot: root });
+    const item = firstUnchecked(cl);
+    if (!item) {
+        throw new Error(`No unchecked items in track "${slug}".`);
+    }
+    return buildFirstTurnPrompt({ slug, item });
+}
+/**
+ * External Autopilot loop: spawn agent → handleStop → re-inject tip / stop.
+ */
+export async function runRunnerLoop(opts) {
+    const root = normalizeProjectRoot(opts.projectRoot) ??
+        normalizeProjectRoot(opts.store.projectRoot);
+    if (!root) {
+        return {
+            outcome: "error",
+            iterations: 0,
+            conversationId: opts.conversationId,
+            errorMessage: "Invalid project root.",
+        };
+    }
+    if (!opts.store.isConversationIdOk(opts.conversationId)) {
+        return {
+            outcome: "error",
+            iterations: 0,
+            conversationId: opts.conversationId,
+            errorMessage: "Invalid conversation id.",
+        };
+    }
+    const driver = opts.driver ??
+        (() => {
+            assertRunnerCommand(opts.config);
+            return new CliDriver(opts.config);
+        })();
+    if (opts.runSlug !== undefined) {
+        const runResult = applyRun(opts.store, opts.conversationId, root, {
+            slug: opts.runSlug === "" ? undefined : opts.runSlug,
+            config: opts.phaseActions,
+            platform: RUNNER_PLATFORM,
+        });
+        if (!runResult.ok) {
+            return {
+                outcome: "error",
+                iterations: 0,
+                conversationId: opts.conversationId,
+                errorMessage: runResult.userMessage,
+            };
+        }
+    }
+    else {
+        const resume = canResumeRunnerSession(opts.store, opts.conversationId, root);
+        if (!resume.ok) {
+            return {
+                outcome: "error",
+                iterations: 0,
+                conversationId: opts.conversationId,
+                errorMessage: resume.message,
+            };
+        }
+    }
+    let prompt;
+    try {
+        prompt = resolveInitialPrompt(opts.store, opts.conversationId, root);
+    }
+    catch (err) {
+        return {
+            outcome: "error",
+            iterations: 0,
+            conversationId: opts.conversationId,
+            errorMessage: err instanceof Error ? err.message : String(err),
+        };
+    }
+    const max = opts.config.maxIterations;
+    let lastMessage = prompt;
+    const reviewScope = loadProjectReviewConfig(root).reviewScope;
+    for (let i = 0; i < max; i += 1) {
+        opts.onPrompt?.(prompt, i);
+        let driverResult;
+        try {
+            driverResult = await driver.run({
+                prompt,
+                iteration: i,
+                conversationId: opts.conversationId,
+                projectRoot: root,
+            });
+        }
+        catch (err) {
+            return {
+                outcome: "error",
+                iterations: i + 1,
+                conversationId: opts.conversationId,
+                lastMessage: prompt,
+                errorMessage: err instanceof Error
+                    ? err.message
+                    : `Agent spawn failed: ${String(err)}`,
+            };
+        }
+        const status = driverResultToStopStatus(driverResult);
+        const tick = opts.stopTick ?? runStopTick;
+        let action;
+        try {
+            ({ action } = tick(opts.store, root, {
+                conversationId: opts.conversationId,
+                status,
+                loopCount: i,
+            }, opts.localeBundle));
+        }
+        catch (err) {
+            // Agent turn already finished — return structured error so callers can
+            // resume (pending / dirty tree) instead of an unhandled rejection.
+            return {
+                outcome: "error",
+                iterations: i + 1,
+                conversationId: opts.conversationId,
+                lastMessage: prompt,
+                errorMessage: err instanceof Error
+                    ? err.message
+                    : `Stop tick failed: ${String(err)}`,
+            };
+        }
+        if (shouldContinueAfterStop(action)) {
+            prompt = action.message.trim();
+            lastMessage = prompt;
+            continue;
+        }
+        // Explicit one-shot halt (loop:false) — do not redeliver pending in this start.
+        if (action && action.loop === false) {
+            return {
+                outcome: "stopped",
+                iterations: i + 1,
+                conversationId: opts.conversationId,
+                lastMessage: action.message,
+            };
+        }
+        const session = opts.store.getSession(opts.conversationId);
+        const chain = opts.store.getReviewChain(opts.conversationId);
+        let pending = chain?.pending_followup?.trim() ?? "";
+        const runnable = Boolean(session && sessionReviewRunnable(session, reviewScope));
+        // No transcript_path: ReviewEngine will not clear "delivered" pending
+        // (tryRedeliverPending skips; pendingBlocksAdvance fails open). Runner
+        // injected lastMessage as the agent prompt — ack matching *harness*
+        // followup only while still runnable (disarmed/paused must keep pending
+        // for a later resume; never clear unrelated pending text).
+        if (pending &&
+            pending === lastMessage &&
+            isHarnessFollowupMessage(pending) &&
+            runnable) {
+            try {
+                opts.store.clearPendingFollowupIf(opts.conversationId, (m) => m.trim() === pending);
+            }
+            catch {
+                /* best-effort */
+            }
+            pending =
+                opts.store.getReviewChain(opts.conversationId)?.pending_followup?.trim() ??
+                    "";
+        }
+        // Null action + a *different* live pending: redeliver while still runnable.
+        if (pending && pending !== lastMessage && runnable) {
+            prompt = pending;
+            lastMessage = pending;
+            continue;
+        }
+        if (pending) {
+            return {
+                outcome: "stopped",
+                iterations: i + 1,
+                conversationId: opts.conversationId,
+                lastMessage: pending,
+            };
+        }
+        if (session?.phase === "done" || session?.phase === "idle") {
+            return {
+                outcome: "completed",
+                iterations: i + 1,
+                conversationId: opts.conversationId,
+                lastMessage: action?.message,
+            };
+        }
+        // No loop tip — stop cleanly (item may still be mid-flight without pending).
+        return {
+            outcome: "stopped",
+            iterations: i + 1,
+            conversationId: opts.conversationId,
+            lastMessage: action?.message ?? lastMessage,
+        };
+    }
+    return {
+        outcome: "budget_exhausted",
+        iterations: max,
+        conversationId: opts.conversationId,
+        lastMessage,
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

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

package/dist/mock-driver.d.ts

@@ -0,0 +1,14 @@
+import type { AgentDriver, DriverResult, DriverRunInput } from "./driver.js";
+export type MockDriverStep = DriverResult | ((input: DriverRunInput) => DriverResult | Promise<DriverResult>);
+/**
+ * In-process driver for contract tests (research §5).
+ * Records every prompt; plays scripted exit codes / side effects.
+ */
+export declare class MockDriver implements AgentDriver {
+    private readonly steps;
+    readonly calls: DriverRunInput[];
+    private stepIndex;
+    constructor(steps?: readonly MockDriverStep[]);
+    run(input: DriverRunInput): Promise<DriverResult>;
+}
+//# sourceMappingURL=mock-driver.d.ts.map

package/dist/mock-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-driver.d.ts","sourceRoot":"","sources":["../src/mock-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAEtE;;;GAGG;AACH,qBAAa,UAAW,YAAW,WAAW;IAIhC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAM;IACtC,OAAO,CAAC,SAAS,CAAK;gBAEO,KAAK,GAAE,SAAS,cAAc,EAAO;IAE5D,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CAYxD"}

package/dist/mock-driver.js

@@ -0,0 +1,25 @@
+/**
+ * In-process driver for contract tests (research §5).
+ * Records every prompt; plays scripted exit codes / side effects.
+ */
+export class MockDriver {
+    steps;
+    calls = [];
+    stepIndex = 0;
+    constructor(steps = []) {
+        this.steps = steps;
+    }
+    async run(input) {
+        this.calls.push({ ...input });
+        const step = this.steps[this.stepIndex];
+        this.stepIndex += 1;
+        if (step === undefined) {
+            return { exitCode: 0, signal: null };
+        }
+        if (typeof step === "function") {
+            return step(input);
+        }
+        return step;
+    }
+}
+//# sourceMappingURL=mock-driver.js.map

package/dist/mock-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-driver.js","sourceRoot":"","sources":["../src/mock-driver.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,OAAO,UAAU;IAIQ;IAHpB,KAAK,GAAqB,EAAE,CAAC;IAC9B,SAAS,GAAG,CAAC,CAAC;IAEtB,YAA6B,QAAmC,EAAE;QAArC,UAAK,GAAL,KAAK,CAAgC;IAAG,CAAC;IAEtE,KAAK,CAAC,GAAG,CAAC,KAAqB;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACvC,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/resume.d.ts

@@ -0,0 +1,16 @@
+import { type StateStore } from "@autopilot-harness/core";
+export type ResumeDecision = {
+    ok: true;
+    reason: "pending" | "executing";
+} | {
+    ok: false;
+    reason: "missing" | "paused" | "idle";
+    message: string;
+};
+/**
+ * Whether `runner start` may continue without `--run` (research §8).
+ * When there is no pending tip, gates must match first-turn prompt builders
+ * (track + in-project checklist + unchecked item) so resume never ok-then-throw.
+ */
+export declare function canResumeRunnerSession(store: StateStore, conversationId: string, projectRoot: string): ResumeDecision;
+//# sourceMappingURL=resume.d.ts.map

package/dist/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../src/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,cAAc,CAyFhB"}

package/dist/resume.js

@@ -0,0 +1,88 @@
+import { countUnchecked, isSafeTrackSlug, normalizeProjectRoot, parseChecklist, } from "@autopilot-harness/core";
+import { resolveChecklistPathInProject } from "./command-template.js";
+/**
+ * Whether `runner start` may continue without `--run` (research §8).
+ * When there is no pending tip, gates must match first-turn prompt builders
+ * (track + in-project checklist + unchecked item) so resume never ok-then-throw.
+ */
+export function canResumeRunnerSession(store, conversationId, projectRoot) {
+    if (!store.isConversationIdOk(conversationId)) {
+        return {
+            ok: false,
+            reason: "missing",
+            message: "Invalid conversation id.",
+        };
+    }
+    const session = store.getSession(conversationId);
+    if (!session) {
+        return {
+            ok: false,
+            reason: "missing",
+            message: "No runner session. Start with: npx @autopilot-harness/cli runner start --run <slug>",
+        };
+    }
+    if (session.paused !== 0) {
+        return {
+            ok: false,
+            reason: "paused",
+            message: "Runner session is paused. Use Autopilot OFF / RESUME (or session tools) before starting again.",
+        };
+    }
+    const chain = store.getReviewChain(conversationId);
+    const pending = chain?.pending_followup?.trim() ?? "";
+    if (pending) {
+        return { ok: true, reason: "pending" };
+    }
+    if (session.phase === "executing") {
+        const root = normalizeProjectRoot(store.projectRoot) ??
+            normalizeProjectRoot(projectRoot);
+        const slug = session.track_id?.trim() ?? "";
+        const checklistPath = session.checklist_path?.trim() ?? "";
+        if (!root || !slug || !checklistPath) {
+            return {
+                ok: false,
+                reason: "idle",
+                message: "Cannot resume: missing track or checklist path. Start with: npx @autopilot-harness/cli runner start --run <slug>",
+            };
+        }
+        if (!isSafeTrackSlug(slug)) {
+            return {
+                ok: false,
+                reason: "idle",
+                message: `Unsafe track slug in session: "${slug.slice(0, 64)}"`,
+            };
+        }
+        try {
+            const abs = resolveChecklistPathInProject(root, checklistPath);
+            if (!abs) {
+                return {
+                    ok: false,
+                    reason: "idle",
+                    message: "Checklist not found or outside project. Start with: npx @autopilot-harness/cli runner start --run <slug>",
+                };
+            }
+            const cl = parseChecklist(abs, { projectRoot: root });
+            if (countUnchecked(cl) > 0) {
+                return { ok: true, reason: "executing" };
+            }
+            return {
+                ok: false,
+                reason: "idle",
+                message: "Track has no unchecked items. Start with: npx @autopilot-harness/cli runner start --run <slug>",
+            };
+        }
+        catch {
+            return {
+                ok: false,
+                reason: "idle",
+                message: "Cannot read checklist for resume. Start with: npx @autopilot-harness/cli runner start --run <slug>",
+            };
+        }
+    }
+    return {
+        ok: false,
+        reason: "idle",
+        message: "Nothing to resume. Start with: npx @autopilot-harness/cli runner start --run <slug>",
+    };
+}
+//# sourceMappingURL=resume.js.map

package/dist/resume.js.map

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

package/dist/stop-tick.d.ts

@@ -0,0 +1,20 @@
+import { type FollowupAction, type FollowupLocaleBundle, type StateStore, type StopHandlerInput } from "@autopilot-harness/core";
+export interface RunStopTickInput {
+    conversationId: string;
+    status: StopHandlerInput["status"];
+    loopCount: number;
+}
+export interface RunStopTickResult {
+    action: FollowupAction | null;
+}
+/**
+ * Thin in-process Stop tick (research §1).
+ * No vendor hook / no transcriptPath in v1.
+ */
+export declare function runStopTick(store: StateStore, projectRoot: string, input: RunStopTickInput, localeBundle?: FollowupLocaleBundle): RunStopTickResult;
+/** True when the tick asks for another agent turn with a tip. */
+export declare function shouldContinueAfterStop(action: FollowupAction | null): action is FollowupAction & {
+    loop: true;
+    message: string;
+};
+//# sourceMappingURL=stop-tick.d.ts.map

package/dist/stop-tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-tick.d.ts","sourceRoot":"","sources":["../src/stop-tick.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,gBAAgB,EACvB,YAAY,CAAC,EAAE,oBAAoB,GAClC,iBAAiB,CAanB;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,GAAG,IAAI,GAC5B,MAAM,IAAI,cAAc,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAO5D"}

package/dist/stop-tick.js

@@ -0,0 +1,24 @@
+import { createConfiguredReviewEngine, } from "@autopilot-harness/core";
+import { RUNNER_PLATFORM } from "./config.js";
+/**
+ * Thin in-process Stop tick (research §1).
+ * No vendor hook / no transcriptPath in v1.
+ */
+export function runStopTick(store, projectRoot, input, localeBundle) {
+    const engine = createConfiguredReviewEngine(store, projectRoot, localeBundle);
+    const action = engine.handleStop({
+        conversationId: input.conversationId,
+        status: input.status,
+        loopCount: input.loopCount,
+        platform: RUNNER_PLATFORM,
+    });
+    return { action };
+}
+/** True when the tick asks for another agent turn with a tip. */
+export function shouldContinueAfterStop(action) {
+    return Boolean(action &&
+        action.loop === true &&
+        typeof action.message === "string" &&
+        action.message.trim());
+}
+//# sourceMappingURL=stop-tick.js.map

package/dist/stop-tick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-tick.js","sourceRoot":"","sources":["../src/stop-tick.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAK7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAY9C;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,KAAiB,EACjB,WAAmB,EACnB,KAAuB,EACvB,YAAmC;IAEnC,MAAM,MAAM,GAAG,4BAA4B,CACzC,KAAK,EACL,WAAW,EACX,YAAY,CACb,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;QAC/B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,eAAe;KAC1B,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CACrC,MAA6B;IAE7B,OAAO,OAAO,CACZ,MAAM;QACJ,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAClC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CACxB,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@autopilot-harness/port-runner",
+  "version": "0.12.0",
+  "description": "Autopilot harness external process runner for hosts without stop-continue (CLI loop + drivers)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mt2007/autopilot-harness.git",
+    "directory": "packages/ports/runner"
+  },
+  "homepage": "https://github.com/mt2007/autopilot-harness#readme",
+  "bugs": {
+    "url": "https://github.com/mt2007/autopilot-harness/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@autopilot-harness/core": "0.12.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "mt2007 (https://github.com/mt2007)",
+  "keywords": [
+    "autopilot",
+    "harness",
+    "agent",
+    "ai",
+    "vibecoding",
+    "runner",
+    "checklist",
+    "code-review"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}