@agent-vm/agent-vm-worker 0.0.20

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export { computeTotalTaskTimeoutMs, loadWorkerConfig, resolveModelAlias, resolvePhaseExecutor, resolveWorkerConfigInstructionReferences, workerConfigSchema, type WorkerConfig, } from './config/worker-config.js';
+export { createCoordinator, type Coordinator, type CreateTaskInput, } from './coordinator/coordinator.js';
+export { gatherContext, readOptionalFile, type RepoContext } from './context/gather-context.js';
+export { buildCommitMessage, configureGit, createBranch, getDiff, getDiffStat, parseRepoFromUrl, sanitizeBranchName, stageAndCommit, } from './git/git-operations.js';
+export { DEFAULT_BASE_INSTRUCTIONS, DEFAULT_PLAN_AGENT_INSTRUCTIONS, DEFAULT_PLAN_REVIEWER_INSTRUCTIONS, DEFAULT_WORK_AGENT_INSTRUCTIONS, DEFAULT_WORK_REVIEWER_INSTRUCTIONS, DEFAULT_WRAPUP_INSTRUCTIONS, interpolateBaseInstructions, resolveRoleInstructions, type Role, } from './prompt/prompt-defaults.js';
+export { buildRoleSystemPrompt } from './prompt/prompt-assembler.js';
+export { buildInitialPlanMessage, buildInitialWorkMessage, buildPlanReviewMessage, buildPlanReviseMessage, buildWorkReviewMessage, buildWorkReviseMessage, } from './prompt/message-builders.js';
+export { createTaskRequestSchema, createApp, type ServerDeps } from './server.js';
+export { appendEvent, replayEvents } from './state/event-log.js';
+export { applyEvent, createInitialState, hydrateTaskStates, isTerminal, loadTaskStateFromLog, type TaskState, } from './state/task-state.js';
+export type { PhaseName, TaskConfig, TaskEvent, TaskStatus, TimestampedEvent, VerificationCommandResult, } from './state/task-event-types.js';
+export { reviewResultSchema, type ReviewResult } from './shared/review-result.js';
+export { repoLocationSchema, repoTargetSchema, type RepoLocation, type RepoTarget, } from './shared/repo-location.js';
+export { skillReferenceSchema, type SkillReference } from './shared/skill-types.js';
+export { createCodexExecutor, type CodexExecutorConfig } from './work-executor/codex-executor.js';
+export { createWorkExecutor } from './work-executor/executor-factory.js';
+export type { ExecutorCapabilities, ExecutorResult, StructuredInput, ToolDefinition, WorkExecutor, } from './work-executor/executor-interface.js';
+export { createPersistentThread, type PersistentThread, type PersistentThreadResponse, } from './work-executor/persistent-thread.js';
+export { allVerificationsPassed, buildVerificationFailureSummary, parseCommand, runCommandWithTimeout, runVerification, type RunVerificationOptions, type VerificationCommand, } from './validation-runner/verification-runner.js';
+export { buildValidationTool } from './work-phase/validation-tool.js';
+export { createGitPullDefaultTool } from './work-phase/controller-tools/git-pull-default-tool.js';
+export { createGitPushTool } from './work-phase/controller-tools/git-push-tool.js';
+export { runWorkCycle, type WorkCycleResult } from './work-phase/work-cycle.js';
+export { runWrapup, type WrapupRunResult } from './wrapup-phase/wrapup-runner.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,OAAO,EACN,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,wCAAwC,EACxC,kBAAkB,EAClB,KAAK,YAAY,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EACN,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,yBAAyB,EACzB,+BAA+B,EAC/B,kCAAkC,EAClC,+BAA+B,EAC/B,kCAAkC,EAClC,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,IAAI,GACT,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACN,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACN,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,KAAK,SAAS,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,SAAS,EACT,UAAU,EACV,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,yBAAyB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EACX,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,GACZ,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACN,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACN,sBAAsB,EACtB,+BAA+B,EAC/B,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACxB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+export { computeTotalTaskTimeoutMs, loadWorkerConfig, resolveModelAlias, resolvePhaseExecutor, resolveWorkerConfigInstructionReferences, workerConfigSchema, } from './config/worker-config.js';
+export { createCoordinator, } from './coordinator/coordinator.js';
+export { gatherContext, readOptionalFile } from './context/gather-context.js';
+export { buildCommitMessage, configureGit, createBranch, getDiff, getDiffStat, parseRepoFromUrl, sanitizeBranchName, stageAndCommit, } from './git/git-operations.js';
+export { DEFAULT_BASE_INSTRUCTIONS, DEFAULT_PLAN_AGENT_INSTRUCTIONS, DEFAULT_PLAN_REVIEWER_INSTRUCTIONS, DEFAULT_WORK_AGENT_INSTRUCTIONS, DEFAULT_WORK_REVIEWER_INSTRUCTIONS, DEFAULT_WRAPUP_INSTRUCTIONS, interpolateBaseInstructions, resolveRoleInstructions, } from './prompt/prompt-defaults.js';
+export { buildRoleSystemPrompt } from './prompt/prompt-assembler.js';
+export { buildInitialPlanMessage, buildInitialWorkMessage, buildPlanReviewMessage, buildPlanReviseMessage, buildWorkReviewMessage, buildWorkReviseMessage, } from './prompt/message-builders.js';
+export { createTaskRequestSchema, createApp } from './server.js';
+export { appendEvent, replayEvents } from './state/event-log.js';
+export { applyEvent, createInitialState, hydrateTaskStates, isTerminal, loadTaskStateFromLog, } from './state/task-state.js';
+export { reviewResultSchema } from './shared/review-result.js';
+export { repoLocationSchema, repoTargetSchema, } from './shared/repo-location.js';
+export { skillReferenceSchema } from './shared/skill-types.js';
+export { createCodexExecutor } from './work-executor/codex-executor.js';
+export { createWorkExecutor } from './work-executor/executor-factory.js';
+export { createPersistentThread, } from './work-executor/persistent-thread.js';
+export { allVerificationsPassed, buildVerificationFailureSummary, parseCommand, runCommandWithTimeout, runVerification, } from './validation-runner/verification-runner.js';
+export { buildValidationTool } from './work-phase/validation-tool.js';
+export { createGitPullDefaultTool } from './work-phase/controller-tools/git-pull-default-tool.js';
+export { createGitPushTool } from './work-phase/controller-tools/git-push-tool.js';
+export { runWorkCycle } from './work-phase/work-cycle.js';
+export { runWrapup } from './wrapup-phase/wrapup-runner.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,OAAO,EACN,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,wCAAwC,EACxC,kBAAkB,GAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,iBAAiB,GAGjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAoB,MAAM,6BAA6B,CAAC;AAChG,OAAO,EACN,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,yBAAyB,EACzB,+BAA+B,EAC/B,kCAAkC,EAClC,+BAA+B,EAC/B,kCAAkC,EAClC,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACN,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACN,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,GAEpB,MAAM,uBAAuB,CAAC;AAS/B,OAAO,EAAE,kBAAkB,EAAqB,MAAM,2BAA2B,CAAC;AAClF,OAAO,EACN,kBAAkB,EAClB,gBAAgB,GAGhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAuB,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAA4B,MAAM,mCAAmC,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAQzE,OAAO,EACN,sBAAsB,GAGtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACN,sBAAsB,EACtB,+BAA+B,EAC/B,YAAY,EACZ,qBAAqB,EACrB,eAAe,GAGf,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,YAAY,EAAwB,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAwB,MAAM,iCAAiC,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+export declare class ReportedCliError extends Error {
+}
+export interface CliIo {
+    readonly stdout: Pick<NodeJS.WriteStream, 'write'>;
+    readonly stderr: Pick<NodeJS.WriteStream, 'write'>;
+}
+export declare function runAgentVmWorkerCli(argv: readonly string[], io?: CliIo): Promise<void>;
+export declare function handleCliMainError(error: unknown, stderr: Pick<NodeJS.WriteStream, 'write'>): void;
+export declare function main(argv?: readonly string[]): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAaA,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,MAAM,WAAW,KAAK;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;CACnD;AAyGD,wBAAsB,mBAAmB,CACxC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,GAAE,KAA0D,GAC5D,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GACvC,IAAI,CAKN;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,SAAS,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzF"}

package/dist/main.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+import { serve } from '@hono/node-server';
+import { command, number, option, optional, runSafely, string, subcommands } from 'cmd-ts';
+import { loadWorkerConfig, resolvePhaseExecutor } from './config/worker-config.js';
+import { createCoordinator } from './coordinator/coordinator.js';
+import { createApp } from './server.js';
+function writeStdout(message) {
+    process.stdout.write(`${message}\n`);
+}
+export class ReportedCliError extends Error {
+}
+function isHelpRequest(argv) {
+    return argv.includes('--help') || argv.includes('-h');
+}
+const serveCommand = command({
+    name: 'serve',
+    description: 'Start the agent-vm-worker HTTP server',
+    args: {
+        port: option({
+            type: number,
+            long: 'port',
+            short: 'p',
+            defaultValue: () => 18789,
+            description: 'Port to listen on',
+        }),
+        config: option({
+            type: optional(string),
+            long: 'config',
+            short: 'c',
+            description: 'Path to worker config JSON',
+        }),
+        stateDir: option({
+            type: optional(string),
+            long: 'state-dir',
+            description: 'State directory path',
+        }),
+    },
+    handler: async (args) => {
+        const configPath = args.config ?? process.env.WORKER_CONFIG_PATH ?? undefined;
+        const baseConfig = await loadWorkerConfig(configPath);
+        const config = args.stateDir ? { ...baseConfig, stateDir: args.stateDir } : baseConfig;
+        const workspaceDir = process.env.WORKSPACE_DIR ?? '/workspace';
+        const startTime = Date.now();
+        const coordinator = await createCoordinator({ config, workspaceDir });
+        const defaultExecutor = resolvePhaseExecutor(config, {});
+        const app = createApp({
+            getActiveTaskId: () => coordinator.getActiveTaskId(),
+            getActiveTaskStatus: () => {
+                const activeTaskId = coordinator.getActiveTaskId();
+                if (!activeTaskId)
+                    return null;
+                return coordinator.getTaskState(activeTaskId)?.status ?? null;
+            },
+            getTaskState: (taskId) => coordinator.getTaskState(taskId),
+            submitTask: async (input) => coordinator.submitTask(input),
+            closeTask: async (taskId) => coordinator.closeTask(taskId),
+            getUptime: () => Math.floor((Date.now() - startTime) / 1000),
+            getExecutorInfo: () => ({
+                provider: defaultExecutor.provider,
+                model: defaultExecutor.model,
+            }),
+        });
+        serve({
+            fetch: app.fetch,
+            port: args.port,
+        }, (info) => {
+            writeStdout(`[agent-vm-worker] Server listening on http://localhost:${info.port}`);
+        });
+    },
+});
+const healthCommand = command({
+    name: 'health',
+    description: 'Check worker health',
+    args: {
+        port: option({
+            type: number,
+            long: 'port',
+            short: 'p',
+            defaultValue: () => 18789,
+            description: 'Port to check',
+        }),
+    },
+    handler: async (args) => {
+        try {
+            const response = await fetch(`http://localhost:${args.port}/health`);
+            if (!response.ok) {
+                throw new Error(`Health check failed: ${response.status}`);
+            }
+            const data = await response.json();
+            writeStdout(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            throw new Error(`Health check failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    },
+});
+const app = subcommands({
+    name: 'agent-vm-worker',
+    description: 'Configurable task worker for Gondolin VMs',
+    cmds: {
+        serve: serveCommand,
+        health: healthCommand,
+    },
+});
+export async function runAgentVmWorkerCli(argv, io = { stdout: process.stdout, stderr: process.stderr }) {
+    const result = await runSafely(app, [...argv]);
+    if (result._tag === 'ok') {
+        return;
+    }
+    const outputStream = result.error.config.into === 'stderr' ? io.stderr : io.stdout;
+    outputStream.write(result.error.config.message);
+    if (!result.error.config.message.endsWith('\n')) {
+        outputStream.write('\n');
+    }
+    // cmd-ts subcommands still surface top-level help as a stdout Exit with nonzero exitCode.
+    // We keep cmd-ts's generated help text verbatim and only normalize that help path to success.
+    if (result.error.config.into === 'stdout' && isHelpRequest(argv)) {
+        return;
+    }
+    if (result.error.config.exitCode !== 0) {
+        throw new ReportedCliError(result.error.config.message);
+    }
+}
+export function handleCliMainError(error, stderr) {
+    if (error instanceof ReportedCliError) {
+        return;
+    }
+    stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+}
+export async function main(argv = process.argv.slice(2)) {
+    await runAgentVmWorkerCli(argv, {
+        stdout: process.stdout,
+        stderr: process.stderr,
+    });
+}
+void main().catch((error) => {
+    handleCliMainError(error, process.stderr);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/plan-phase/plan-cycle.d.ts

@@ -0,0 +1,27 @@
+import type { PlanCycleConfig } from '../config/worker-config.js';
+import type { RepoLocation } from '../shared/repo-location.js';
+import { type ReviewResult } from '../shared/review-result.js';
+import type { PersistentThread, PersistentThreadResponse } from '../work-executor/persistent-thread.js';
+export interface RunPlanCycleProps {
+    readonly spec: string;
+    readonly repos: readonly RepoLocation[];
+    readonly repoSummary: string | null;
+    readonly context: Record<string, unknown>;
+    readonly cycle: PlanCycleConfig;
+    readonly planThread: PersistentThread;
+    /** Required when cycle.kind === 'review'; unused when 'noReview'. */
+    readonly reviewThread: PersistentThread | null;
+    readonly systemPromptPlanAgent: string;
+    /** Required when cycle.kind === 'review'; unused when 'noReview'. */
+    readonly systemPromptPlanReviewer: string | null;
+    readonly onPlanAgentTurn: (cycle: number, result: PersistentThreadResponse) => void | Promise<void>;
+    readonly onPlanReviewerTurn: (cycle: number, result: PersistentThreadResponse, review: ReviewResult) => void | Promise<void>;
+    /** Abort signal from the coordinator; when set, cycle stops after the current turn. */
+    readonly isClosed?: () => boolean;
+}
+export interface PlanCycleResult {
+    readonly plan: string;
+    readonly review: ReviewResult | null;
+}
+export declare function runPlanCycle(props: RunPlanCycleProps): Promise<PlanCycleResult>;
+//# sourceMappingURL=plan-cycle.d.ts.map

package/dist/plan-phase/plan-cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-cycle.d.ts","sourceRoot":"","sources":["../../src/plan-phase/plan-cycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAMlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,KAAK,EACX,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,wBAAwB,KAC5B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,YAAY,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CACrC;AAiDD,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0DrF"}

package/dist/plan-phase/plan-cycle.js

@@ -0,0 +1,83 @@
+import { buildInitialPlanMessage, buildPlanReviewMessage, buildPlanReviseMessage, } from '../prompt/message-builders.js';
+import { reviewResultSchema } from '../shared/review-result.js';
+function firstTurn(systemPrompt, userMessage) {
+    return `# System\n${systemPrompt}\n\n# Task\n${userMessage}`;
+}
+function parsePlan(response) {
+    let parsed;
+    try {
+        parsed = JSON.parse(response);
+    }
+    catch (error) {
+        throw new Error(`plan-agent response is not valid JSON. Raw: ${response.slice(0, 200)}`, {
+            cause: error,
+        });
+    }
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        !('plan' in parsed) ||
+        typeof parsed.plan !== 'string') {
+        throw new Error(`plan-agent response missing string plan field. Raw: ${response.slice(0, 200)}`);
+    }
+    return parsed.plan;
+}
+function parseReview(response) {
+    let parsed;
+    try {
+        parsed = JSON.parse(response);
+    }
+    catch (error) {
+        throw new Error(`plan-reviewer response is not valid JSON. Raw: ${response.slice(0, 200)}`, {
+            cause: error,
+        });
+    }
+    const result = reviewResultSchema.safeParse(parsed);
+    if (!result.success) {
+        throw new Error(`plan-reviewer response does not match ReviewResult schema: ${result.error.message}. Raw: ${response.slice(0, 200)}`);
+    }
+    return result.data;
+}
+export async function runPlanCycle(props) {
+    const initialMessage = buildInitialPlanMessage({
+        spec: props.spec,
+        repos: props.repos,
+        repoSummary: props.repoSummary,
+        context: props.context,
+    });
+    const initialResponse = await props.planThread.send(firstTurn(props.systemPromptPlanAgent, initialMessage));
+    await props.onPlanAgentTurn(0, initialResponse);
+    let currentPlan = parsePlan(initialResponse.response);
+    // kind === 'noReview': agent only. No reviewer thread used.
+    if (props.cycle.kind === 'noReview') {
+        return { plan: currentPlan, review: null };
+    }
+    if (props.reviewThread === null || props.systemPromptPlanReviewer === null) {
+        throw new Error('runPlanCycle: kind="review" requires reviewThread and systemPromptPlanReviewer');
+    }
+    const reviewThread = props.reviewThread;
+    const systemPromptReviewer = props.systemPromptPlanReviewer;
+    const cycleCount = props.cycle.cycleCount;
+    let lastReview = null;
+    for (let cycle = 1; cycle <= cycleCount; cycle += 1) {
+        if (props.isClosed?.()) {
+            return { plan: currentPlan, review: lastReview };
+        }
+        const reviewMessage = buildPlanReviewMessage({
+            spec: props.spec,
+            plan: currentPlan,
+            cycle,
+        });
+        const reviewResponse = await reviewThread.send(cycle === 1 ? firstTurn(systemPromptReviewer, reviewMessage) : reviewMessage);
+        lastReview = parseReview(reviewResponse.response);
+        await props.onPlanReviewerTurn(cycle, reviewResponse, lastReview);
+        if (props.isClosed?.()) {
+            return { plan: currentPlan, review: lastReview };
+        }
+        // Always revise after every review — reviewer feedback always reaches the agent.
+        const reviseResponse = await props.planThread.send(buildPlanReviseMessage({ cycle, review: lastReview }));
+        await props.onPlanAgentTurn(cycle, reviseResponse);
+        currentPlan = parsePlan(reviseResponse.response);
+    }
+    return { plan: currentPlan, review: lastReview };
+}
+//# sourceMappingURL=plan-cycle.js.map

package/dist/plan-phase/plan-cycle.js.map

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

package/dist/prompt/message-builders.d.ts

@@ -0,0 +1,44 @@
+import type { RepoLocation } from '../shared/repo-location.js';
+import type { ReviewResult } from '../shared/review-result.js';
+import type { VerificationCommandResult } from '../state/task-event-types.js';
+import type { VerificationCommand } from '../validation-runner/verification-runner.js';
+export interface BuildInitialPlanMessageProps {
+    readonly spec: string;
+    readonly repos: readonly RepoLocation[];
+    readonly repoSummary: string | null;
+    readonly context: Record<string, unknown>;
+}
+export declare function buildInitialPlanMessage(props: BuildInitialPlanMessageProps): string;
+export interface BuildPlanReviewMessageProps {
+    readonly spec: string;
+    readonly plan: string;
+    readonly cycle: number;
+}
+export declare function buildPlanReviewMessage(props: BuildPlanReviewMessageProps): string;
+export interface BuildPlanReviseMessageProps {
+    readonly cycle: number;
+    readonly review: ReviewResult;
+}
+export declare function buildPlanReviseMessage(props: BuildPlanReviseMessageProps): string;
+export interface BuildInitialWorkMessageProps {
+    readonly spec: string;
+    readonly plan: string;
+    readonly planReview: ReviewResult | null;
+    readonly validationCommandList: readonly VerificationCommand[];
+}
+export declare function buildInitialWorkMessage(props: BuildInitialWorkMessageProps): string;
+export interface BuildWorkReviewMessageProps {
+    readonly spec: string;
+    readonly plan: string;
+    readonly diff: string;
+    readonly cycle: number;
+    readonly validationCommandList?: readonly VerificationCommand[];
+}
+export declare function buildWorkReviewMessage(props: BuildWorkReviewMessageProps): string;
+export interface BuildWorkReviseMessageProps {
+    readonly cycle: number;
+    readonly review: ReviewResult;
+    readonly validationResults: readonly VerificationCommandResult[];
+}
+export declare function buildWorkReviseMessage(props: BuildWorkReviseMessageProps): string;
+//# sourceMappingURL=message-builders.d.ts.map

package/dist/prompt/message-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-builders.d.ts","sourceRoot":"","sources":["../../src/prompt/message-builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAwCvF,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,MAAM,CAQnF;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAMjF;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAOjF;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC/D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,MAAM,CAcnF;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAQjF;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACjE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAQjF"}

package/dist/prompt/message-builders.js

@@ -0,0 +1,83 @@
+function formatComments(comments) {
+    if (comments.length === 0)
+        return '(no comments)';
+    return comments
+        .map((comment) => {
+        const location = typeof comment.line === 'number' ? `${comment.file}:${String(comment.line)}` : comment.file;
+        return `- [${comment.severity}] ${location} - ${comment.comment}`;
+    })
+        .join('\n');
+}
+function formatRepos(repos) {
+    if (repos.length === 0)
+        return '(no repositories)';
+    return repos
+        .map((repo) => `- ${repo.repoUrl} (branch: ${repo.baseBranch})\n  Workspace: ${repo.workspacePath}`)
+        .join('\n');
+}
+function formatValidationList(commands) {
+    if (commands.length === 0) {
+        return '(none configured - run_validation will return an empty array)';
+    }
+    return commands.map((command) => `- ${command.name}: ${command.command}`).join('\n');
+}
+function formatValidationResults(results) {
+    if (results.length === 0)
+        return '(no validation results recorded)';
+    return results
+        .map((result) => `- ${result.name}: passed=${String(result.passed)} exitCode=${String(result.exitCode)}\n  output: ${result.output.slice(0, 800)}`)
+        .join('\n');
+}
+export function buildInitialPlanMessage(props) {
+    const parts = [`Spec:\n${props.spec}`, `Repositories:\n${formatRepos(props.repos)}`];
+    if (props.repoSummary)
+        parts.push(`Repo summary:\n${props.repoSummary}`);
+    if (Object.keys(props.context).length > 0) {
+        parts.push(`Context:\n${JSON.stringify(props.context, null, 2)}`);
+    }
+    parts.push('Produce a plan. Return JSON: { "plan": "..." }');
+    return parts.join('\n\n');
+}
+export function buildPlanReviewMessage(props) {
+    return [
+        `Spec:\n${props.spec}`,
+        `Plan v${String(props.cycle)}:\n${props.plan}`,
+        'Review. Return JSON per the ReviewResult schema from your instructions.',
+    ].join('\n\n');
+}
+export function buildPlanReviseMessage(props) {
+    return [
+        `Plan reviewer cycle ${String(props.cycle)} feedback:`,
+        `Summary: ${props.review.summary}`,
+        `Comments:\n${formatComments(props.review.comments)}`,
+        'Revise the plan. Return JSON: { "plan": "..." }',
+    ].join('\n\n');
+}
+export function buildInitialWorkMessage(props) {
+    const parts = [`Spec:\n${props.spec}`, `Approved plan:\n${props.plan}`];
+    if (props.planReview) {
+        parts.push(`Plan review commentary (advisory):\nSummary: ${props.planReview.summary}\nComments:\n${formatComments(props.planReview.comments)}`);
+    }
+    parts.push(`Validation commands available:\n${formatValidationList(props.validationCommandList)}`);
+    parts.push('Implement the plan. Return JSON: { "summary": "...", "commitShas": [], "remainingConcerns": "" }');
+    return parts.join('\n\n');
+}
+export function buildWorkReviewMessage(props) {
+    return [
+        `Spec:\n${props.spec}`,
+        `Plan:\n${props.plan}`,
+        `Diff v${String(props.cycle)}:\n${props.diff}`,
+        `Validation commands configured:\n${formatValidationList(props.validationCommandList ?? [])}`,
+        'You MUST call run_validation exactly once before returning your review. Return JSON per the ReviewResult schema from your instructions.',
+    ].join('\n\n');
+}
+export function buildWorkReviseMessage(props) {
+    return [
+        `Work reviewer cycle ${String(props.cycle)} feedback:`,
+        `Summary: ${props.review.summary}`,
+        `Comments:\n${formatComments(props.review.comments)}`,
+        `Validation results:\n${formatValidationResults(props.validationResults)}`,
+        'Revise. Return JSON: { "summary": "...", "commitShas": [], "remainingConcerns": "" }',
+    ].join('\n\n');
+}
+//# sourceMappingURL=message-builders.js.map

package/dist/prompt/message-builders.js.map

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

package/dist/prompt/prompt-assembler.d.ts

@@ -0,0 +1,11 @@
+import type { SkillReference } from '../shared/skill-types.js';
+import { type Role } from './prompt-defaults.js';
+export interface BuildRoleSystemPromptProps {
+    readonly role: Role;
+    readonly baseInstructionsOverride: string | null;
+    readonly roleInstructionsOverride: string | null;
+    readonly branchPrefix: string;
+    readonly skills: readonly SkillReference[];
+}
+export declare function buildRoleSystemPrompt(props: BuildRoleSystemPromptProps): Promise<string>;
+//# sourceMappingURL=prompt-assembler.d.ts.map

package/dist/prompt/prompt-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-assembler.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-assembler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAGN,KAAK,IAAI,EACT,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC3C;AA2BD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9F"}

package/dist/prompt/prompt-assembler.js

@@ -0,0 +1,34 @@
+import { readFile } from 'node:fs/promises';
+import { writeStderr } from '../shared/stderr.js';
+import { DEFAULT_BASE_INSTRUCTIONS, resolveRoleInstructions, } from './prompt-defaults.js';
+async function resolveSkillContent(skills) {
+    const bodies = await Promise.all(skills.map(async (skill) => {
+        try {
+            const content = await readFile(skill.path, 'utf-8');
+            return `## Skill: ${skill.name}\n${content}`;
+        }
+        catch (error) {
+            const code = error && typeof error === 'object' && 'code' in error ? error.code : undefined;
+            if (code === 'ENOENT') {
+                writeStderr(`[prompt-assembler] Skill not found, skipping: ${skill.name} at ${skill.path}`);
+                return null;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            writeStderr(`[prompt-assembler] Skill load failed (${skill.name}): ${message}`);
+            throw new Error(`Skill load failed for "${skill.name}" at "${skill.path}": ${message}`, {
+                cause: error,
+            });
+        }
+    }));
+    return bodies.filter((body) => body !== null).join('\n\n');
+}
+export async function buildRoleSystemPrompt(props) {
+    const baseTemplate = props.baseInstructionsOverride ?? DEFAULT_BASE_INSTRUCTIONS;
+    const baseInstructions = baseTemplate.replaceAll('{branchPrefix}', props.branchPrefix);
+    const roleInstructions = resolveRoleInstructions(props.role, props.roleInstructionsOverride);
+    const skillContent = await resolveSkillContent(props.skills);
+    return [baseInstructions, roleInstructions, skillContent]
+        .filter((section) => section.length > 0)
+        .join('\n\n---\n\n');
+}
+//# sourceMappingURL=prompt-assembler.js.map

package/dist/prompt/prompt-assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-assembler.js","sourceRoot":"","sources":["../../src/prompt/prompt-assembler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACN,yBAAyB,EACzB,uBAAuB,GAEvB,MAAM,sBAAsB,CAAC;AAU9B,KAAK,UAAU,mBAAmB,CAAC,MAAiC;IACnE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAA0B,EAAE;QAClD,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,aAAa,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5F,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvB,WAAW,CACV,iDAAiD,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,EAAE,CAC9E,CAAC;gBACF,OAAO,IAAI,CAAC;YACb,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,WAAW,CAAC,yCAAyC,KAAK,CAAC,IAAI,MAAM,OAAO,EAAE,CAAC,CAAC;YAChF,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,IAAI,MAAM,OAAO,EAAE,EAAE;gBACvF,KAAK,EAAE,KAAK;aACZ,CAAC,CAAC;QACJ,CAAC;IACF,CAAC,CAAC,CACF,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAiC;IAC5E,MAAM,YAAY,GAAG,KAAK,CAAC,wBAAwB,IAAI,yBAAyB,CAAC;IACjF,MAAM,gBAAgB,GAAG,YAAY,CAAC,UAAU,CAAC,gBAAgB,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IACvF,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC7F,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE7D,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,CAAC;SACvD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,IAAI,CAAC,aAAa,CAAC,CAAC;AACvB,CAAC"}

package/dist/prompt/prompt-defaults.d.ts

@@ -0,0 +1,10 @@
+export type Role = 'plan-agent' | 'plan-reviewer' | 'work-agent' | 'work-reviewer' | 'wrapup';
+export declare const DEFAULT_BASE_INSTRUCTIONS = "You are an agent operating inside a sandboxed VM. You have access to the repository workspace mounted at /workspace. All outbound network requests go through a mediation proxy.\n\n## Security\n- You do not have access to GitHub tokens, SSH keys, or other credentials. The host controller handles authenticated git operations.\n- Never print, exfiltrate, or try to discover credentials.\n- Do not run git push. Use the git-push tool when you need to push an agent branch.\n\n## Workspace\n- Work only inside the workspace directories listed in your task.\n- Do not modify the .git directory directly.\n- Preserve unrelated user or agent changes.\n\n## Git commits\n- You may stage and commit with git add and git commit.\n- Branches you create must be prefixed with {branchPrefix}.\n- Use conventional commit messages such as feat:, fix:, refactor:, test:, docs:, or chore:.\n\n## Controller tools\n- git-push pushes the current branch via the controller. The VM has no real GitHub token; push auth is handled host-side.\n- git-pull-default updates the local protected/default branch via the controller and reports drift.\n- gh pr create is available for PR creation after git-push succeeds. GitHub API traffic is mediated by the controller proxy.\n  - The VM env var GITHUB_TOKEN is a Gondolin mediation placeholder, NOT the real token. gh must see SOME token to skip its login check, so always invoke gh with GH_TOKEN=\"$GITHUB_TOKEN\" prefixed:\n      GH_TOKEN=\"$GITHUB_TOKEN\" gh pr create --base <default> --title \"...\" --body \"...\"\n  - The proxy strips the placeholder and injects the real token at the wire level. You never handle the real token directly.\n\n## Mediated secrets\n\nThe same mediation pattern applies to every credential surfaced into your env. The value you see is a Gondolin placeholder; the proxy swaps it for the real secret on outbound requests to the allowed hosts declared in zone config. Never print, log, or try to inspect the value.\n\nDefault mediated env vars for worker zones:\n- GITHUB_TOKEN: for github.com / api.github.com\n- OPENAI_API_KEY: for api.openai.com\n\nIf your task needs another credential, it must be declared in the zone secrets with injection: \"http-mediation\" and the relevant allowed host. Without that declaration, no auth flows.\n\nIf NPM_AUTH_TOKEN is configured for registry.npmjs.org and the repo needs private npm packages, configure npm at task runtime rather than expecting the gateway image to contain auth files:\n\n```bash\nprintf '//registry.npmjs.org/:_authToken=${NPM_AUTH_TOKEN}\\n' > \"$HOME/.npmrc\"\n```\n\nThe single quotes preserve the literal template so npm substitutes it from the environment during registry calls. Do not inline the env var with double quotes or bake .npmrc into an image.\n\n## Output discipline\n- Keep prose brief.\n- When asked for JSON, return only JSON with no markdown fence or prose wrapper.";
+export declare const DEFAULT_PLAN_AGENT_INSTRUCTIONS = "You are the PLAN agent. Produce an implementation plan for the task.\n\n## Inputs\n- Spec: the user's requested change.\n- Repositories: repo URLs, branches, and workspace paths.\n- Repo summary: gathered codebase context when available.\n- Context: extra task metadata.\n\n## Expected work\n- Explain what should change and why.\n- Name the files or modules likely involved.\n- Order the steps so a work agent can execute them.\n- Include validation that will prove the work.\n- Call out real risks and non-goals.\n\n## Do not\n- Write code.\n- Run commands.\n- Invent requirements.\n\n## Return format\n{ \"plan\": \"plan text\" }";
+export declare const DEFAULT_PLAN_REVIEWER_INSTRUCTIONS = "You are the PLAN REVIEWER. Review the plan against the spec and repo context.\n\n## What to find\n- Missing requirements.\n- Incorrect assumptions about the codebase.\n- Ambiguous steps that could be implemented two different ways.\n- Scope creep or needless abstraction.\n- Real failure modes the plan ignores.\n\n## Severity\n- critical: must address for correctness or spec compliance.\n- suggestion: meaningful improvement.\n- nitpick: style or wording only.\n\n## Do not\n- Rewrite the plan yourself.\n- Block on implementation details the work agent can resolve.\n\n## Return format\n{\n  \"approved\": true,\n  \"summary\": \"1-3 sentences\",\n  \"comments\": [\n    { \"file\": \"plan\", \"severity\": \"critical\", \"comment\": \"...\" }\n  ]\n}";
+export declare const DEFAULT_WORK_AGENT_INSTRUCTIONS = "You are the WORK agent. Implement the approved plan.\n\n## Inputs\n- Spec: the original task.\n- Approved plan: the implementation plan.\n- Plan review commentary: advisory feedback.\n- Validation commands: project checks available through run_validation.\n\n## Tools\n- You may call run_validation to check your work. It is optional and not required; the reviewer will run validation too.\n\n## Expected flow\n- Read the relevant code before editing.\n- Make the smallest coherent changes that satisfy the plan.\n- Commit logical chunks when useful.\n- Return a concise summary of the turn.\n\n## Do not\n- Run git push.\n- Expand beyond the plan without saying why.\n\n## Return format\n{ \"summary\": \"...\", \"commitShas\": [], \"remainingConcerns\": \"\" }";
+export declare const DEFAULT_WORK_REVIEWER_INSTRUCTIONS = "You are the WORK REVIEWER. Review the current diff against the spec and plan.\n\n## Mandatory tool call\n- You MUST call run_validation exactly once before returning your review.\n- Include the command-result array from the tool in validationResults.\n- If no validation commands are configured, run_validation returns [] and validationResults must be [].\n- Do not wrap validationResults in a tool envelope, a nested array, a string, or prose. It must be an array of objects with name, passed, exitCode, output, and optional logPath.\n\n## What to find\n- Correctness bugs.\n- Missing tests or failing validation.\n- Security or secret-handling issues.\n- Scope drift from the plan.\n- Maintainability issues that matter now.\n\n## Severity\n- critical: broken behavior, failed validation, security issue, or clear plan divergence.\n- suggestion: meaningful improvement.\n- nitpick: style only.\n\n## Return format\n{\n  \"approved\": true,\n  \"summary\": \"1-3 sentences\",\n  \"comments\": [],\n  \"validationResults\": [{ \"name\": \"test\", \"passed\": true, \"exitCode\": 0, \"output\": \"\", \"logPath\": \"optional path\" }]\n}";
+export declare const DEFAULT_WRAPUP_INSTRUCTIONS = "You are in the WRAPUP phase. The work cycle has completed.\n\n## Tools\n- git-pull-default tool: refresh the local default/protected branch and inspect drift.\n- git-push tool: push the current agent branch through the controller.\n- gh CLI: use GH_TOKEN=\"$GITHUB_TOKEN\" gh pr create from shell after git-push succeeds.\n\n## Your job\nShip the work that was already implemented. You are a fresh wrapup thread with explicit handoff context from the work agent. You are not here to redesign the solution or make broad new edits. Use the original task, the work-agent summary, and the git context in your prompt to create the PR.\n\n## How to ship\n1. Inspect the current branch and git state. You should be on an agent/* branch with committed work.\n2. If work is uncommitted, make a normal local commit with a clear conventional commit message.\n3. Call git-pull-default to update the local protected/default branch and see whether your branch is behind.\n4. If the default branch moved, decide whether a rebase or merge is needed. Resolve any conflicts locally, then commit the resolution.\n5. Call git-push. If it returns success=false, read the message and fix the git state instead of pretending the push worked.\n6. After git-push succeeds, run gh pr create from the shell. Use a clear title and body based on the work summary.\n   - IMPORTANT: gh short-circuits with a login prompt unless GH_TOKEN is set. The VM env has GITHUB_TOKEN set to a mediation placeholder. Always invoke gh with that placeholder copied into GH_TOKEN:\n       GH_TOKEN=\"$GITHUB_TOKEN\" gh pr create --base <default> --title \"...\" --body \"...\"\n     The controller proxy injects the real token at the wire level.\n7. Return JSON with the PR URL, branch name, pushed commit SHAs if known, and a concise summary.\n\n## Expected successful path\n- You call git-pull-default and confirm default-branch drift.\n- You call git-push and confirm the controller pushed the agent branch.\n- You run GH_TOKEN=\"$GITHUB_TOKEN\" gh pr create and capture the GitHub PR URL.\n- You return JSON with prUrl, branchName, pushedCommits, and summary.\n\n## Important rules\n- The VM has no real GitHub token. Never run raw git push. Always use git-push.\n- gh pr create is allowed; GitHub HTTP traffic is mediated by the controller proxy. Use GH_TOKEN=\"$GITHUB_TOKEN\" prefix with gh.\n- Do not call run_validation here. The work phase already handled validation.\n- Do not call git-push while on the protected/default branch. Create or switch to an agent/* branch first.\n\n## Do not\n- Run git push.\n- Call run_validation here.\n- Start unrelated cleanup.\n- Modify files unless git-pull-default reveals a real conflict or missing commit.\n\n## Return format\n{ \"summary\": \"wrapup result\", \"prUrl\": \"https://github.com/org/repo/pull/1\", \"branchName\": \"agent/name\", \"pushedCommits\": [\"sha\"] }";
+export declare function resolveRoleInstructions(role: Role, configValue: string | null): string;
+export declare function interpolateBaseInstructions(branchPrefix: string): string;
+//# sourceMappingURL=prompt-defaults.d.ts.map

package/dist/prompt/prompt-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-defaults.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-defaults.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE9F,eAAO,MAAM,yBAAyB,41FA6C2C,CAAC;AAElF,eAAO,MAAM,+BAA+B,6nBAqBpB,CAAC;AAEzB,eAAO,MAAM,kCAAkC,uvBAyB7C,CAAC;AAEH,eAAO,MAAM,+BAA+B,+vBAsBoB,CAAC;AAEjE,eAAO,MAAM,kCAAkC,qnCA0B7C,CAAC;AAEH,eAAO,MAAM,2BAA2B,m0FAyC4F,CAAC;AAUrI,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEtF;AAED,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAExE"}