@fitlab-ai/agent-infra 0.9.8 → 0.9.9

package/dist/lib/agent-clients/adapters/codex-lifecycle/sandbox-controller.js

@@ -5,11 +5,11 @@ import os from 'node:os';
 import path from 'node:path';
 import semver from 'semver';
 import * as toml from 'smol-toml';
-import { requestSandboxControl } from '../../../sandbox/control/client.js';
+import { requestCodexControllerClose, requestCodexControllerOpen, requestCodexControllerVerify, requestSandboxControl } from '../../../sandbox/control/client.js';
 import { readSandboxControlStatus } from '../../../sandbox/control/state.js';
-import { getProcessStartTime, isProcessAlive } from '../../../server/process-state.js';
+import { getProcessStartTime } from '../../../server/process-state.js';
 import { computeLifecycleBuildIdentity } from './build-identity.js';
-const CONTEXT_TTL_MS = 4 * 60 * 60 * 1_000;
+import { contextFromControllerLease, controllerProofFromContext, verifyCodexSandboxControllerContext as verifyContextFile, writeCodexSandboxControllerContext } from './controller-context.js';
 function digestFiles(files) {
     const hash = crypto.createHash('sha256');
     for (const file of [...files].sort()) {
@@ -108,6 +108,26 @@ function verifyControl(taskId, control) {
     if (payload.taskId !== taskId)
         throw new Error('CODEX_SANDBOX_CONTROLLER_TASK_BINDING_INVALID');
 }
+function verifyCodexSandboxControllerContext(contextPath, options = {}) {
+    const control = options.control ?? controlFromEnvironment();
+    const context = verifyContextFile(contextPath, {
+        repoRoot: options.repoRoot,
+        now: options.now,
+        generation: control.generation,
+        probeProcess: options.probeProcess
+    });
+    const verified = (options.requestControllerVerify ?? requestCodexControllerVerify)({
+        controllerProof: controllerProofFromContext(context),
+        ...control,
+        timeoutMs: 30_000
+    });
+    if (verified.binding.taskId !== context.taskId
+        || verified.binding.controlGeneration !== context.controlGeneration
+        || verified.binding.controllerInstanceDigest !== context.controllerInstanceDigest) {
+        throw new Error('CODEX_SANDBOX_CONTROLLER_CONTEXT_INVALID');
+    }
+    return context;
+}
 function detectedCodexVersion() {
     const result = spawnSync('codex', ['--version'], { encoding: 'utf8' });
     const version = /codex-cli\s+(\d+\.\d+\.\d+)/u.exec(result.stdout ?? '')?.[1];
@@ -191,7 +211,6 @@ function prepareCodexSandboxController(input, options = {}) {
     const repoRoot = path.resolve(options.repoRoot ?? process.cwd());
     const sourceHome = path.resolve(options.codexHome ?? process.env.CODEX_HOME ?? path.join(os.homedir(), '.codex'));
     const control = options.control ?? controlFromEnvironment();
-    (options.verifyTaskBinding ?? verifyControl)(input.taskId, control);
     const version = (options.codexVersion ?? detectedCodexVersion)();
     if (!semver.gte(version, '0.147.0'))
         throw new Error('CODEX_SANDBOX_CONTROLLER_CODEX_UNSUPPORTED');
@@ -200,48 +219,36 @@ function prepareCodexSandboxController(input, options = {}) {
     fs.mkdirSync(runtimeRoot, { recursive: true, mode: 0o700 });
     fs.chmodSync(runtimeRoot, 0o700);
     const key = crypto.createHash('sha256')
-        .update(`${input.taskId}\0${control.generation}`)
+        .update(`${process.pid}\0${control.generation}`)
         .digest('hex');
-    const leasePath = path.join(runtimeRoot, `${key}.lease.json`);
-    if (fs.existsSync(leasePath)) {
-        const lease = JSON.parse(fs.readFileSync(leasePath, 'utf8'));
-        if (Number.isSafeInteger(lease.pid) && typeof lease.startTime === 'number'
-            && getProcessStartTime(lease.pid) === lease.startTime) {
-            throw new Error('CODEX_SANDBOX_CONTROLLER_BUSY');
-        }
-        fs.unlinkSync(leasePath);
-    }
     const parentStartTime = getProcessStartTime(process.pid);
     if (!parentStartTime)
         throw new Error('CODEX_SANDBOX_CONTROLLER_PROCESS_IDENTITY_INVALID');
-    const instanceDigest = crypto.randomBytes(32).toString('hex');
-    fs.writeFileSync(leasePath, `${JSON.stringify({
-        version: 1,
-        pid: process.pid,
-        startTime: parentStartTime,
-        taskId: input.taskId,
-        generation: control.generation,
-        instanceDigest
-    })}\n`, { mode: 0o600, flag: 'wx' });
     const home = fs.mkdtempSync(path.join(runtimeRoot, `${key}-`));
     fs.chmodSync(home, 0o700);
     let cleaned = false;
+    let context = null;
     const cleanup = () => {
         if (cleaned)
             return;
         cleaned = true;
+        if (context) {
+            try {
+                (options.closeController ?? requestCodexControllerClose)({
+                    controllerProcess: context.controllerProcess,
+                    controllerProof: controllerProofFromContext(context),
+                    ...control,
+                    timeoutMs: 30_000
+                });
+            }
+            catch {
+                // The wrapper is exiting; dead-process recovery safely handles an unknown close result.
+            }
+        }
         const relative = path.relative(runtimeRoot, home);
         if (!relative.startsWith('..') && !path.isAbsolute(relative)) {
             fs.rmSync(home, { recursive: true, force: true });
         }
-        try {
-            const lease = JSON.parse(fs.readFileSync(leasePath, 'utf8'));
-            if (lease.instanceDigest === instanceDigest)
-                fs.unlinkSync(leasePath);
-        }
-        catch {
-            // A missing or replaced lease is owned by another cleanup path.
-        }
     };
     try {
         const auth = path.join(sourceHome, 'auth.json');
@@ -263,22 +270,25 @@ function prepareCodexSandboxController(input, options = {}) {
             throw new Error('CODEX_SANDBOX_CONTROLLER_BUNDLE_MISMATCH');
         }
         const buildIdentity = computeLifecycleBuildIdentity(repoRoot);
-        const now = (options.now ?? Date.now)();
-        const context = Object.freeze({
-            version: 1,
-            taskId: input.taskId,
-            controlGeneration: control.generation,
-            controllerInstanceDigest: instanceDigest,
-            parentPid: process.pid,
-            parentStartTime,
-            issuedAt: now,
-            expiresAt: now + CONTEXT_TTL_MS,
-            buildIdentity,
+        const opened = (options.openController ?? requestCodexControllerOpen)({
+            controllerProcess: { pid: process.pid, startTime: parentStartTime },
+            ...control,
+            timeoutMs: 30_000
+        });
+        const taskId = opened.lease.taskId;
+        context = contextFromControllerLease(opened.lease, {
             hookDefinitionHash: crypto.createHash('sha256').update(fs.readFileSync(hooks)).digest('hex'),
             lifecycleProfilesHash: digestFiles([executor, reviewer])
         });
+        if (opened.lease.controlGeneration !== control.generation
+            || opened.lease.controllerProcess.pid !== process.pid
+            || opened.lease.controllerProcess.startTime !== parentStartTime
+            || JSON.stringify(opened.lease.buildIdentity) !== JSON.stringify(buildIdentity)) {
+            throw new Error('SANDBOX_CONTROL_RESULT_INVALID');
+        }
+        (options.verifyTaskBinding ?? verifyControl)(taskId, control);
         const contextPath = path.join(home, 'controller-context.json');
-        fs.writeFileSync(contextPath, `${JSON.stringify(context, null, 2)}\n`, { mode: 0o600 });
+        writeCodexSandboxControllerContext(contextPath, context);
         const shimDir = path.join(home, 'bin');
         fs.mkdirSync(shimDir, { mode: 0o700 });
         const internalCli = path.resolve(process.argv[1] ?? path.join(repoRoot, 'bin', 'internal-cli.ts'));
@@ -292,7 +302,7 @@ function prepareCodexSandboxController(input, options = {}) {
             input.reviewerModel ? `--reviewer-model ${input.reviewerModel}` : '',
             input.reviewerReasoningEffort ? `--reviewer-reasoning-effort ${input.reviewerReasoningEffort}` : ''
         ].filter(Boolean).join(' ');
-        const prompt = `$run-task ${input.taskRef}${policy ? ` ${policy}` : ''}`;
+        const prompt = `$run-task ${taskId}${policy ? ` ${policy}` : ''}`;
         const args = Object.freeze([
             'exec',
             '--enable', 'hooks',
@@ -303,7 +313,7 @@ function prepareCodexSandboxController(input, options = {}) {
             '-C', repoRoot,
             prompt
         ]);
-        const env = isolatedEnvironment(home, shimDir, contextPath, input.taskId, control, providerEnvironment, options.environment ?? process.env);
+        const env = isolatedEnvironment(home, shimDir, contextPath, taskId, control, providerEnvironment, options.environment ?? process.env);
         return Object.freeze({
             command: 'codex',
             args,
@@ -319,27 +329,6 @@ function prepareCodexSandboxController(input, options = {}) {
         throw error;
     }
 }
-function verifyCodexSandboxControllerContext(contextPath, taskId, options = {}) {
-    const stat = fs.lstatSync(contextPath);
-    if (!stat.isFile() || stat.isSymbolicLink() || (stat.mode & 0o077) !== 0) {
-        throw new Error('CODEX_SANDBOX_CONTROLLER_CONTEXT_INVALID');
-    }
-    const context = JSON.parse(fs.readFileSync(contextPath, 'utf8'));
-    const generation = options.generation ?? process.env.AGENT_INFRA_CONTROL_GENERATION;
-    if (context.version !== 1
-        || context.taskId !== taskId
-        || context.controlGeneration !== generation
-        || context.expiresAt < (options.now ?? Date.now())
-        || getProcessStartTime(context.parentPid) !== context.parentStartTime
-        || !isProcessAlive(context.parentPid)) {
-        throw new Error('CODEX_SANDBOX_CONTROLLER_CONTEXT_INVALID');
-    }
-    const current = computeLifecycleBuildIdentity(options.repoRoot ?? process.cwd());
-    if (JSON.stringify(current) !== JSON.stringify(context.buildIdentity)) {
-        throw new Error('CODEX_SANDBOX_CONTROLLER_BUNDLE_MISMATCH');
-    }
-    return Object.freeze(context);
-}
 async function runCodexSandboxController(input, options = {}) {
     const prepared = prepareCodexSandboxController(input, options);
     try {
@@ -394,5 +383,5 @@ async function runCodexSandboxController(input, options = {}) {
         prepared.cleanup();
     }
 }
-export { prepareCodexSandboxController, runCodexSandboxController, verifyCodexSandboxControllerContext };
+export { prepareCodexSandboxController, runCodexSandboxController, verifyCodexSandboxControllerContext, controllerProofFromContext };
 //# sourceMappingURL=sandbox-controller.js.map

package/dist/lib/git/workflow.js

@@ -124,7 +124,16 @@ function pushGitRefs(input, runner = defaultRunner) {
         }
         const canonical = ref.startsWith('refs/') ? ref : `refs/heads/${ref}`;
         const remoteFact = run(runner, input.cwd, ['ls-remote', '--exit-code', input.remote, canonical]);
-        operations.push({ name: 'push', ref, status: remoteFact.status === 0 ? 'applied' : 'failed', message: remoteFact.status === 0 ? undefined : 'Remote ref verification failed' });
+        const remoteSha = remoteFact.status === 0 ? remoteFact.stdout.trim().split(/\s+/)[0] ?? null : null;
+        const verified = remoteFact.status === 0 && (!input.expectedSha || remoteSha === input.expectedSha);
+        operations.push({
+            name: 'push',
+            ref,
+            status: verified ? 'applied' : 'failed',
+            message: verified ? undefined : input.expectedSha
+                ? `Remote ref verification failed: expected ${input.expectedSha}, received ${remoteSha ?? 'unavailable'}`
+                : 'Remote ref verification failed'
+        });
     }
     const failures = operations.filter((item) => item.status === 'failed').length;
     return { status: failures === 0 ? 'applied' : failures === operations.length ? 'failed' : 'degraded', changed: failures < operations.length, snapshot: inspectGitWorkflow(input.cwd, runner).snapshot, operations, error: failures ? { code: 'GIT_PUSH_PARTIAL', message: `${failures} ref push operation(s) failed` } : null };

package/dist/lib/internal/codex-lifecycle.js

@@ -8,6 +8,7 @@ import { createCodexCapabilityStore } from '../agent-clients/adapters/codex-life
 import { computeLifecycleBuildIdentity } from '../agent-clients/adapters/codex-lifecycle/build-identity.js';
 import { verifyCodexSandboxControllerContext } from '../agent-clients/adapters/codex-lifecycle/sandbox-controller.js';
 import { resolveTaskRef } from '../task/resolve-ref.js';
+import { hasSealableOrchestrationDelegation } from '../task/orchestration.js';
 import { activateCodexOrchestrationDelegation, activateCodexSpawnDelegation, reconcileCodexOrchestrationDelegation, sealCodexOrchestrationDelegation, sealCodexParentDelegation } from '../task/codex-orchestration.js';
 const USAGE = 'Usage: agent-infra-internal codex-lifecycle <capability-arm|hook-event|resolve-start|resolve-stop|preflight|consume> [options]\n';
 const MANAGED_AGENT = /^agent-infra-lifecycle-(executor|reviewer)$/;
@@ -80,7 +81,7 @@ function controllerBinding(taskId) {
     const contextPath = process.env.AGENT_INFRA_CODEX_CONTROLLER_CONTEXT;
     if (!contextPath)
         return undefined;
-    const context = verifyCodexSandboxControllerContext(contextPath, taskId, { repoRoot: process.cwd() });
+    const context = verifyCodexSandboxControllerContext(contextPath, { repoRoot: process.cwd() });
     return {
         instanceDigest: context.controllerInstanceDigest,
         controlGeneration: context.controlGeneration
@@ -121,7 +122,8 @@ function recordFromPayload(phase, payload) {
             sessionId: text('sessionId'),
             turnId: text('turnId'),
             childThreadId: text('childThreadId'),
-            nativeAgent: text('nativeAgent')
+            nativeAgent: text('nativeAgent'),
+            source: 'hook'
         };
     if (phase === 'subagent-stop')
         return {
@@ -314,8 +316,17 @@ async function codexLifecycle(args = []) {
             }
             const result = store.apply(event);
             if (parsed.values['--bridge'] === 'true' && event.type === 'hook-stop') {
-                const bridged = await sealCodexOrchestrationDelegation(event.childThreadId, { store });
-                outputBridgeResult(bridged);
+                if (!hasSealableOrchestrationDelegation('codex', event.childThreadId, { repoRoot: process.cwd() })) {
+                    output({ status: 'ignored', changed: false, evidence: null, diagnostics: [], error: null });
+                    return;
+                }
+                output({
+                    status: result.state.status,
+                    changed: true,
+                    evidence: result.state,
+                    diagnostics: [],
+                    error: result.state.error
+                });
                 return;
             }
             output({ status: result.state.status, changed: true, evidence: result.state, diagnostics: [], error: result.state.error });
@@ -341,7 +352,10 @@ async function codexLifecycle(args = []) {
             return;
         }
         if (parsed.operation === 'resolve-stop') {
-            const terminal = await resolveCodexTerminal(childThreadId);
+            const stopTurnId = store.read(childThreadId).state.stop?.turnId;
+            if (!stopTurnId)
+                throw new Error('Codex lifecycle stop hook is not available');
+            const terminal = await resolveCodexTerminal(childThreadId, stopTurnId);
             const latest = store.apply(terminal);
             if (latest.state.status !== 'stop-ready') {
                 throw new Error(`Codex lifecycle stop evidence is not ready (status=${latest.state.status})`);

package/dist/lib/internal/codex-sandbox-controller.js

@@ -20,8 +20,6 @@ function parse(args) {
         return null;
     }
     const allowed = new Set([
-        '--task-id',
-        '--task-ref',
         '--context',
         '--executor-model',
         '--executor-reasoning-effort',
@@ -31,6 +29,11 @@ function parse(args) {
     const values = {};
     for (let index = 1; index < args.length; index += 1) {
         const flag = args[index];
+        if (flag === '--task-id' || flag.startsWith('--task-id=')
+            || flag === '--task-ref' || flag.startsWith('--task-ref=')) {
+            fail('CODEX_SANDBOX_CONTROLLER_IDENTITY_OPTION_UNSUPPORTED', 'controller task identity options are not supported', 2);
+            return null;
+        }
         const value = args[++index];
         if (!allowed.has(flag) || Object.hasOwn(values, flag) || !value || value.startsWith('--')) {
             fail('CODEX_SANDBOX_CONTROLLER_PAYLOAD_INVALID', `invalid option '${flag}'`, 2);
@@ -44,18 +47,13 @@ async function codexSandboxController(args = []) {
     const parsed = parse(args);
     if (!parsed || process.exitCode)
         return;
-    const taskId = parsed.values['--task-id'];
-    if (!taskId) {
-        fail('CODEX_SANDBOX_CONTROLLER_PAYLOAD_INVALID', '--task-id is required', 2);
-        return;
-    }
     try {
         if (parsed.operation === 'verify-context') {
             const contextPath = parsed.values['--context']
                 ?? process.env.AGENT_INFRA_CODEX_CONTROLLER_CONTEXT;
             if (!contextPath)
                 throw new Error('CODEX_SANDBOX_CONTROLLER_CONTEXT_MISSING');
-            const context = verifyCodexSandboxControllerContext(contextPath, taskId);
+            const context = verifyCodexSandboxControllerContext(contextPath);
             process.stdout.write(`${JSON.stringify({
                 status: 'ready',
                 changed: false,
@@ -72,9 +70,6 @@ async function codexSandboxController(args = []) {
             })}\n`);
             return;
         }
-        const taskRef = parsed.values['--task-ref'];
-        if (!taskRef)
-            throw new Error('CODEX_SANDBOX_CONTROLLER_TASK_REF_REQUIRED');
         const policy = [
             '--executor-model',
             '--executor-reasoning-effort',
@@ -86,8 +81,6 @@ async function codexSandboxController(args = []) {
             throw new Error('CODEX_SANDBOX_CONTROLLER_MODEL_POLICY_INVALID');
         }
         const exitCode = await runCodexSandboxController({
-            taskId,
-            taskRef,
             executorModel: parsed.values['--executor-model'],
             executorReasoningEffort: parsed.values['--executor-reasoning-effort'],
             reviewerModel: parsed.values['--reviewer-model'],

package/dist/lib/internal/git-workflow.js

@@ -1,7 +1,8 @@
 import fs from 'node:fs';
-import { commitExplicitPaths, inspectGitWorkflow, pushGitRefs, pushRebasedBranch } from '../git/workflow.js';
+import { inspectGitWorkflow, pushRebasedBranch } from '../git/workflow.js';
 import { compareReviewTrees, snapshotReview } from '../git/review-snapshot.js';
 import { resolvePostReviewGlobs } from '../task/review-fingerprint.js';
+import { executeCommitOperation } from '../task/commit-operation.js';
 function output(value) { process.stdout.write(`${JSON.stringify(value)}\n`); }
 function gitWorkflow(args = []) {
     const [action, ...rest] = args;
@@ -16,12 +17,9 @@ function gitWorkflow(args = []) {
     else if (action === 'commit') {
         const inputIndex = rest.indexOf('--input');
         const input = inputIndex >= 0 && rest[inputIndex + 1] ? JSON.parse(fs.readFileSync(rest[inputIndex + 1], 'utf8')) : null;
-        result = input ? commitExplicitPaths({ cwd: cwd ?? process.cwd(), ...input }) : { status: 'failed', changed: false, error: { code: 'GIT_INPUT_REQUIRED', message: '--input JSON file is required' } };
-    }
-    else if (action === 'push') {
-        const inputIndex = rest.indexOf('--input');
-        const input = inputIndex >= 0 && rest[inputIndex + 1] ? JSON.parse(fs.readFileSync(rest[inputIndex + 1], 'utf8')) : null;
-        result = input ? pushGitRefs({ cwd: cwd ?? process.cwd(), ...input }) : { status: 'failed', changed: false, error: { code: 'GIT_INPUT_REQUIRED', message: '--input JSON file is required' } };
+        result = input
+            ? executeCommitOperation({ cwd: cwd ?? process.cwd(), ...input })
+            : { status: 'failed', changed: false, error: { code: 'GIT_INPUT_REQUIRED', message: '--input JSON file is required' } };
     }
     else if (action === 'push-rebased') {
         const inputIndex = rest.indexOf('--input');

package/dist/lib/internal/platform-pr.js

@@ -7,12 +7,12 @@ const USAGE = `Usage: agent-infra-internal platform-pr inspect <task-ref> [--cwd
        agent-infra-internal platform-pr resolve-external <task-ref> --agent <agent> [--pr <N>] [--dry-run] [--cwd <path>]
        agent-infra-internal platform-pr create <task-ref> --agent <agent> --base <branch> --head <branch> --title-file <path|-> --body-file <path|-> [--draft] [--dry-run] [--cwd <path>]
        agent-infra-internal platform-pr bind <task-ref> --pr <N> --agent <agent> [--dry-run] [--cwd <path>]
-       agent-infra-internal platform-pr sync <task-ref> --agent <agent> [--metadata] [--closing-issue] [--dry-run] [--cwd <path>]
+       agent-infra-internal platform-pr sync <task-ref> --agent <agent> [--metadata] [--closing-issue] --result <pr_created|pr_reused|no_op> [--dry-run] [--cwd <path>]
        agent-infra-internal platform-pr summary-context <task-ref> [--cwd <path>]
-       agent-infra-internal platform-pr summary-sync <task-ref> --agent <agent> --body-file <path|-> [--dry-run] [--cwd <path>]
+       agent-infra-internal platform-pr summary-sync <task-ref> --agent <agent> --body-file <path|-> --result <pr_created|pr_reused|no_op> [--dry-run] [--cwd <path>]
 `;
 const BOOLEAN_FLAGS = new Set(['--draft', '--dry-run', '--metadata', '--closing-issue']);
-const VALUE_FLAGS = new Set(['--cwd', '--agent', '--base', '--head', '--title-file', '--body-file', '--pr']);
+const VALUE_FLAGS = new Set(['--cwd', '--agent', '--base', '--head', '--title-file', '--body-file', '--pr', '--result']);
 function key(flag) {
     return flag.slice(2).replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
 }
@@ -79,9 +79,9 @@ function platformPr(args = []) {
         'resolve-external': ['cwd', 'agent', 'pr', 'dryRun'],
         create: ['cwd', 'agent', 'base', 'head', 'titleFile', 'bodyFile', 'draft', 'dryRun'],
         bind: ['cwd', 'agent', 'pr', 'dryRun'],
-        sync: ['cwd', 'agent', 'metadata', 'closingIssue', 'dryRun'],
+        sync: ['cwd', 'agent', 'metadata', 'closingIssue', 'result', 'dryRun'],
         'summary-context': ['cwd'],
-        'summary-sync': ['cwd', 'agent', 'bodyFile', 'dryRun']
+        'summary-sync': ['cwd', 'agent', 'bodyFile', 'result', 'dryRun']
     };
     const unexpected = Object.keys(values).find((name) => !allowed[operation].includes(name));
     if (unexpected) {
@@ -106,6 +106,11 @@ function platformPr(args = []) {
         return;
     }
     values.agent = agent;
+    const primaryResult = values.result === undefined ? undefined : values.result;
+    if (primaryResult !== undefined && !['pr_created', 'pr_reused', 'no_op'].includes(primaryResult)) {
+        fail('--result must be pr_created, pr_reused, or no_op');
+        return;
+    }
     if (operation === 'resolve-external') {
         const pr = values.pr === undefined ? undefined : Number(values.pr);
         if (pr !== undefined && (!Number.isInteger(pr) || pr <= 0)) {
@@ -129,7 +134,11 @@ function platformPr(args = []) {
             fail('sync requires --metadata or --closing-issue');
             return;
         }
-        finish(syncPlatformPullRequest(taskRef, { cwd, agent: values.agent, metadata: values.metadata === true, closingIssue: values.closingIssue === true, dryRun: values.dryRun === true }));
+        if (!primaryResult) {
+            fail('sync requires --result pr_created, pr_reused, or no_op');
+            return;
+        }
+        finish(syncPlatformPullRequest(taskRef, { cwd, agent: values.agent, metadata: values.metadata === true, closingIssue: values.closingIssue === true, primaryResult: primaryResult, dryRun: values.dryRun === true }));
         return;
     }
     if (operation === 'summary-sync') {
@@ -137,8 +146,12 @@ function platformPr(args = []) {
             fail('summary-sync requires --body-file');
             return;
         }
+        if (!primaryResult) {
+            fail('summary-sync requires --result pr_created, pr_reused, or no_op');
+            return;
+        }
         try {
-            finish(syncPullRequestSummary(taskRef, { cwd, agent: values.agent, body: readFile(values.bodyFile, cwd), dryRun: values.dryRun === true }));
+            finish(syncPullRequestSummary(taskRef, { cwd, agent: values.agent, body: readFile(values.bodyFile, cwd), primaryResult: primaryResult, dryRun: values.dryRun === true }));
         }
         catch (error) {
             fail(`unable to read body file: ${error instanceof Error ? error.message : String(error)}`);

package/dist/lib/internal/release-workflow.js

@@ -10,12 +10,13 @@ import { releaseSnapshot } from '../release/workflow.js';
 function command(cwd, executable, args) {
     return spawnSync(executable, args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
 }
+// The tape is the canonical init interaction contract. Do not hash all of
+// lib/init.ts: non-visual config serialization changes must not re-record it.
 const DEMO_INPUT_PATHS = [
     'assets/demo-init.tape',
     'scripts/demo-regen.sh',
     'scripts/normalize-gif-duration.py',
     'bin/cli.ts',
-    'lib/init.ts',
     'lib/log.ts',
     'lib/prompt.ts',
     'lib/paths.ts',

package/dist/lib/internal/sandbox-control.js

@@ -1,6 +1,70 @@
-import { requestSandboxControl, SandboxControlClientError } from '../sandbox/control/client.js';
+import { requestSandboxControl, requestSandboxTaskFinalization, requestSandboxTaskControl, SandboxControlClientError } from '../sandbox/control/client.js';
+import { normalizeAgentToken, AGENT_USAGE_HINT } from '../agent-clients/tokens.js';
 import { serveSandboxControl } from '../sandbox/control/server.js';
 import { runSandboxControlExecutor } from '../sandbox/control/executor.js';
+import { controllerProofFromContext, verifyCodexSandboxControllerContext } from '../agent-clients/adapters/codex-lifecycle/sandbox-controller.js';
+function isCanonicalCodexPrepare(args) {
+    if (args[1] !== 'prepare')
+        return false;
+    const clients = [];
+    for (let index = 2; index < args.length; index += 1) {
+        if (args[index] === '--client')
+            clients.push(args[index + 1] ?? '');
+        else if (args[index]?.startsWith('--client='))
+            clients.push(args[index].slice('--client='.length));
+    }
+    return clients.length === 1 && clients[0] === 'codex';
+}
+function writeFinalizationEnvelope(status, accepted, error, changed = false, result = null) {
+    process.stdout.write(`${JSON.stringify({ version: 1, status, changed, accepted, result, error })}\n`);
+}
+function finalizationErrorStatus(error) {
+    if (error.code === 'SANDBOX_CONTROL_RESULT_UNKNOWN')
+        return 'unknown';
+    return error.retryable ? 'blocked' : 'failed';
+}
+function sandboxFinalizationClient(args) {
+    if (args.length !== 4 || !args[0] || args[1] !== 'complete' || args[2] !== '--agent' || !args[3]) {
+        const error = { code: 'TASK_FINALIZATION_PAYLOAD_INVALID', message: 'task ref, complete intent, and --agent are required', retryable: false };
+        writeFinalizationEnvelope('failed', false, error);
+        process.stderr.write('Usage: agent-infra-internal task-finalization <N | TASK-id> complete --agent <agent>\n');
+        process.exitCode = 1;
+        return;
+    }
+    const agent = normalizeAgentToken(args[3]);
+    if (!agent) {
+        const error = { code: 'TASK_FINALIZATION_PAYLOAD_INVALID', message: `invalid --agent: ${AGENT_USAGE_HINT}`, retryable: false };
+        writeFinalizationEnvelope('failed', false, error);
+        process.exitCode = 1;
+        return;
+    }
+    let response;
+    try {
+        response = requestSandboxTaskFinalization({ agent });
+    }
+    catch (error) {
+        if (!(error instanceof SandboxControlClientError))
+            throw error;
+        writeFinalizationEnvelope(finalizationErrorStatus(error.detail), error.accepted, error.detail);
+        process.stderr.write(`${error.detail.message}\n`);
+        process.exitCode = error.detail.code === 'SANDBOX_CONTROL_RESULT_UNKNOWN' ? 1 : error.detail.retryable ? 2 : 1;
+        return;
+    }
+    if (response.phase === 'rejected') {
+        const error = response.error ?? {
+            code: 'SANDBOX_CONTROL_REJECTED',
+            message: 'sandbox control rejected the finalization request',
+            retryable: false
+        };
+        writeFinalizationEnvelope(finalizationErrorStatus(error), error.code === 'SANDBOX_CONTROL_RESULT_UNKNOWN', error);
+        process.stderr.write(`${error.message}\n`);
+        process.exitCode = error.code === 'SANDBOX_CONTROL_RESULT_UNKNOWN' ? 1 : error.retryable ? 2 : 1;
+        return;
+    }
+    process.stdout.write(response.stdout);
+    process.stderr.write(response.stderr);
+    process.exitCode = response.exitCode ?? 1;
+}
 async function sandboxControl(args) {
     const [operation, ...rest] = args;
     if (operation === 'serve') {
@@ -33,9 +97,22 @@ async function sandboxControl(args) {
     }
     if (operation === 'client') {
         const [family = '', ...commandArgs] = rest;
+        if (family === 'task-finalization') {
+            sandboxFinalizationClient(commandArgs);
+            return;
+        }
         let response;
         try {
-            response = requestSandboxControl({ family, args: commandArgs });
+            if (family === 'task-orchestration' && isCanonicalCodexPrepare(commandArgs)) {
+                const contextPath = process.env.AGENT_INFRA_CODEX_CONTROLLER_CONTEXT;
+                const proof = contextPath
+                    ? controllerProofFromContext(verifyCodexSandboxControllerContext(contextPath))
+                    : null;
+                response = requestSandboxTaskControl({ family, args: commandArgs, controllerProof: proof });
+            }
+            else {
+                response = requestSandboxControl({ family, args: commandArgs });
+            }
         }
         catch (error) {
             if (!(error instanceof SandboxControlClientError))

package/dist/lib/internal/task-finalization.js

@@ -0,0 +1,54 @@
+import { normalizeAgentToken, AGENT_USAGE_HINT } from '../agent-clients/tokens.js';
+import { applyTaskFinalization } from '../task/finalization.js';
+import { detectRepoRoot, resolveTaskRef } from '../task/resolve-ref.js';
+import { verifyTaskEvent } from '../task/verification.js';
+const USAGE = 'Usage: agent-infra-internal task-finalization <N | TASK-id> complete --agent <agent>\n';
+function envelope(status, changed, accepted, result, error) {
+    return `${JSON.stringify({ version: 1, status, changed, accepted, result, error })}\n`;
+}
+function exitCode(status) {
+    return status === 'completed' ? 0 : status === 'blocked' ? 2 : 1;
+}
+function fail(message) {
+    const error = { code: 'TASK_FINALIZATION_PAYLOAD_INVALID', message, retryable: false };
+    process.stdout.write(envelope('failed', false, false, null, error));
+    process.stderr.write(USAGE);
+    process.exitCode = 1;
+}
+function taskFinalization(args = []) {
+    if (args[0] === '--help' || args[0] === '-h') {
+        process.stdout.write(USAGE);
+        return;
+    }
+    if (args.length !== 4 || !args[0] || args[1] !== 'complete' || args[2] !== '--agent' || !args[3]) {
+        fail('task ref, complete intent, and --agent are required');
+        return;
+    }
+    const agent = normalizeAgentToken(args[3]);
+    if (!agent) {
+        fail(`invalid --agent: ${AGENT_USAGE_HINT}`);
+        return;
+    }
+    let repoRoot;
+    try {
+        repoRoot = detectRepoRoot();
+    }
+    catch (error) {
+        const detail = { code: 'REPO_ROOT_NOT_FOUND', message: error instanceof Error ? error.message : String(error), retryable: false };
+        process.stdout.write(envelope('failed', false, true, null, detail));
+        process.exitCode = 1;
+        return;
+    }
+    const resolved = resolveTaskRef(args[0], { repoRoot });
+    if (!resolved.ok) {
+        const detail = { code: resolved.code, message: resolved.message, retryable: false };
+        process.stdout.write(envelope('failed', false, true, null, detail));
+        process.exitCode = 1;
+        return;
+    }
+    const result = applyTaskFinalization({ taskRef: resolved.taskId, intent: 'complete', agent }, { repoRoot, preflight: (request, options) => verifyTaskEvent({ ...request, event: 'complete-task.hard-preflight' }, options) });
+    process.stdout.write(envelope(result.status, result.changed, true, result, result.error));
+    process.exitCode = exitCode(result.status);
+}
+export { taskFinalization };
+//# sourceMappingURL=task-finalization.js.map