codex-orchestrator 2.0.1 → 2.0.3

package/dist/src/v2/owner-control-lock.js

@@ -0,0 +1,174 @@
+import { spawn } from 'node:child_process';
+import { lstat, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { canonicalJson, sha256 } from './containment.js';
+const ZERO_OID = '0'.repeat(40);
+export async function inspectOwnerControlLock(input) {
+    validateRepository(input.canonicalRepository);
+    const controlGitDir = join(input.orchestratorHome, 'v2', 'owner-control.git');
+    try {
+        if (!(await lstat(controlGitDir)).isDirectory())
+            return { status: 'ambiguous', reason: 'Owner control store is not a directory.' };
+    }
+    catch (error) {
+        if (typeof error === 'object' && error !== null && error.code === 'ENOENT')
+            return { status: 'absent' };
+        return { status: 'ambiguous', reason: 'Owner control store cannot be inspected.' };
+    }
+    const ref = `refs/codex-orchestrator/owners/${sha256(input.canonicalRepository)}`;
+    let oid;
+    try {
+        oid = await readRef(controlGitDir, ref);
+    }
+    catch {
+        return { status: 'ambiguous', reason: 'Owner control ref is invalid.' };
+    }
+    if (!oid)
+        return { status: 'absent' };
+    let owner;
+    try {
+        owner = await readOwner(controlGitDir, oid);
+    }
+    catch {
+        return { status: 'ambiguous', reason: 'Owner control record is malformed.' };
+    }
+    if (owner.canonicalRepository !== input.canonicalRepository || owner.host !== input.host || owner.bootId !== input.bootId) {
+        return { status: 'ambiguous', reason: 'Owner control identity is foreign or stale.' };
+    }
+    return input.processAlive(owner.pid)
+        ? { status: 'active' }
+        : { status: 'ambiguous', reason: 'Owner control record has ambiguous liveness.' };
+}
+export class OwnerControlLockBlockedError extends Error {
+    kind;
+    constructor(message = 'owner control lock is held or ambiguous', kind = 'safety') {
+        super(message);
+        this.kind = kind;
+        this.name = 'OwnerControlLockBlockedError';
+    }
+}
+export async function acquireOwnerControlLock(input) {
+    validateRepository(input.canonicalRepository);
+    if (!input.bootId || !input.host || !Number.isSafeInteger(input.pid) || input.pid <= 0)
+        throw new OwnerControlLockBlockedError('owner identity is invalid');
+    const controlGitDir = join(input.orchestratorHome, 'v2', 'owner-control.git');
+    await mkdir(join(input.orchestratorHome, 'v2'), { recursive: true, mode: 0o700 });
+    const initialized = await runGit(['init', '--bare', '--quiet', '--object-format=sha1', controlGitDir]);
+    if (initialized.code !== 0)
+        throw new OwnerControlLockBlockedError('owner control store initialization failed');
+    const ref = `refs/codex-orchestrator/owners/${sha256(input.canonicalRepository)}`;
+    const owner = {
+        version: 1,
+        token: input.createToken(),
+        canonicalRepository: input.canonicalRepository,
+        host: input.host,
+        bootId: input.bootId,
+        pid: input.pid,
+        acquiredAt: input.now(),
+    };
+    const blob = await writeBlob(controlGitDir, owner);
+    const startedAt = Date.now();
+    while (true) {
+        const observedOid = await readRef(controlGitDir, ref);
+        if (observedOid === undefined) {
+            if (await updateRef(controlGitDir, ref, blob, ZERO_OID))
+                return handle(controlGitDir, ref, blob);
+            continue;
+        }
+        const observed = await readOwner(controlGitDir, observedOid).catch(() => undefined);
+        if (!observed
+            || observed.canonicalRepository !== input.canonicalRepository
+            || observed.host !== input.host
+            || observed.bootId !== input.bootId) {
+            throw new OwnerControlLockBlockedError();
+        }
+        if (input.processAlive(observed.pid)) {
+            if (Date.now() - startedAt >= (input.waitMs ?? 5_000))
+                throw new OwnerControlLockBlockedError('owner control lock wait timed out', 'live-contention');
+            await delay(input.pollMs ?? 25);
+            continue;
+        }
+        await input.afterObservedOwner?.(structuredClone(observed));
+        if (await updateRef(controlGitDir, ref, blob, observedOid))
+            return handle(controlGitDir, ref, blob);
+        if (Date.now() - startedAt >= (input.waitMs ?? 5_000))
+            throw new OwnerControlLockBlockedError('owner control lock reclaim lost');
+    }
+}
+function handle(controlGitDir, ref, ownBlob) {
+    let released = false;
+    return {
+        async release() {
+            if (released)
+                return;
+            const result = await runGit(['--git-dir', controlGitDir, 'update-ref', '-d', ref, ownBlob]);
+            const observed = await readRef(controlGitDir, ref);
+            if (result.code !== 0 && observed === ownBlob)
+                throw new OwnerControlLockBlockedError('owner control lock release failed');
+            if (observed === ownBlob)
+                throw new OwnerControlLockBlockedError('owner control lock release was not confirmed');
+            released = true;
+        },
+    };
+}
+async function writeBlob(controlGitDir, owner) {
+    const result = await runGit(['--git-dir', controlGitDir, 'hash-object', '-w', '--stdin'], `${canonicalJson(owner)}\n`);
+    const oid = result.stdout.trim();
+    if (result.code !== 0 || !/^[0-9a-f]{40}$/u.test(oid))
+        throw new OwnerControlLockBlockedError('owner control blob write failed');
+    return oid;
+}
+async function readRef(controlGitDir, ref) {
+    const result = await runGit(['--git-dir', controlGitDir, 'rev-parse', '--verify', '--quiet', ref]);
+    if (result.code === 1)
+        return undefined;
+    const oid = result.stdout.trim();
+    if (result.code !== 0 || !/^[0-9a-f]{40}$/u.test(oid))
+        throw new OwnerControlLockBlockedError('owner control ref is invalid');
+    return oid;
+}
+async function readOwner(controlGitDir, oid) {
+    const result = await runGit(['--git-dir', controlGitDir, 'cat-file', 'blob', oid]);
+    if (result.code !== 0 || Buffer.byteLength(result.stdout) > 16 * 1024)
+        throw new Error('owner control blob is invalid');
+    return parseOwner(JSON.parse(result.stdout));
+}
+async function updateRef(controlGitDir, ref, next, previous) {
+    return (await runGit(['--git-dir', controlGitDir, 'update-ref', ref, next, previous])).code === 0;
+}
+function parseOwner(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        throw new Error('owner control record is invalid');
+    const keys = Object.keys(value).sort();
+    const expected = ['version', 'token', 'canonicalRepository', 'host', 'bootId', 'pid', 'acquiredAt'].sort();
+    if (keys.length !== expected.length || keys.some((key, index) => key !== expected[index]))
+        throw new Error('owner control record keys are invalid');
+    const owner = value;
+    validateRepository(owner.canonicalRepository);
+    if (owner.version !== 1 || !owner.token || !owner.host || !owner.bootId
+        || !Number.isSafeInteger(owner.pid) || owner.pid <= 0
+        || Number.isNaN(Date.parse(owner.acquiredAt)) || new Date(owner.acquiredAt).toISOString() !== owner.acquiredAt) {
+        throw new Error('owner control record fields are invalid');
+    }
+    return owner;
+}
+function validateRepository(value) {
+    if (!/^[a-z0-9._-]+\/[a-z0-9._-]+$/u.test(value))
+        throw new OwnerControlLockBlockedError('canonical repository is invalid');
+}
+function runGit(args, stdin) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('git', args, { stdio: ['pipe', 'pipe', 'pipe'] });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on('data', (chunk) => stdout.push(chunk));
+        child.stderr.on('data', (chunk) => stderr.push(chunk));
+        child.once('error', reject);
+        child.once('close', (code) => resolve({ code: code ?? 1, stdout: Buffer.concat(stdout).toString('utf8'), stderr: Buffer.concat(stderr).toString('utf8') }));
+        child.stdin.end(stdin);
+    });
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=owner-control-lock.js.map

package/dist/src/v2/owner-control-lock.js.map

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

package/dist/src/v2/route-continuations.d.ts

@@ -0,0 +1,32 @@
+import type { PersistedFrozenCriterionV1, PersistedIssueSnapshotV1 } from './run-store.js';
+import type { RouteReceiptV1 } from './route-decision.js';
+import type { WorkflowGenerationReceipt } from './workflow-assets.js';
+import type { WaitingHumanResult, WaitingHumanState } from './waiting-human-coordinator.js';
+import type { SpecCoordinatorResult, SpecDeliveryState } from './spec-coordinator.js';
+export interface RoutedRunContext {
+    runId: string;
+    issue: PersistedIssueSnapshotV1;
+    frozenCriteria: PersistedFrozenCriterionV1[];
+    worktreePath: string;
+    workflowGeneration: WorkflowGenerationReceipt;
+    receipt: RouteReceiptV1;
+}
+export type RoutedContinuationResult = {
+    status: 'completed';
+} | {
+    status: 'retryable';
+    code: string;
+} | {
+    status: 'blocked';
+    kind: 'external' | 'safety' | 'exhausted';
+    code: string;
+    evidence: string[];
+} | {
+    status: 'cancelled';
+};
+export interface RoutedContinuationRegistry {
+    direct(input: RoutedRunContext): Promise<RoutedContinuationResult>;
+    specRequired(input: RoutedRunContext, state: SpecDeliveryState, signal: AbortSignal): Promise<SpecCoordinatorResult>;
+    awaitingUser(input: RoutedRunContext, state: WaitingHumanState, signal: AbortSignal): Promise<WaitingHumanResult>;
+}
+//# sourceMappingURL=route-continuations.d.ts.map

package/dist/src/v2/route-continuations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-continuations.d.ts","sourceRoot":"","sources":["../../../src/v2/route-continuations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEtF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,CAAC;IAChC,cAAc,EAAE,0BAA0B,EAAE,CAAC;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,yBAAyB,CAAC;IAC9C,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAClG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACnE,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrH,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACnH"}

package/dist/src/v2/route-continuations.js

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

package/dist/src/v2/route-continuations.js.map

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

package/dist/src/v2/route-coordinator.d.ts

@@ -0,0 +1,77 @@
+import { type AmbiguityReviewRefV1, type CandidateRepairInputV1, type MalformedRepairInputV1, type RouteArtifactRefV1, type RouteExecutionV1, type RouteReceiptV1 } from './route-decision.js';
+import { type TriageRouteV1 } from './triage-route.js';
+import type { WorkflowGenerationReceipt } from './workflow-assets.js';
+import type { ContainedReportOperation, ContainedReportOperationResult } from './contained-report-operation.js';
+export type { AmbiguityReviewRefV1, CandidateRepairInputV1, ContainedReportOperation, MalformedRepairInputV1, RouteArtifactRefV1, RouteExecutionV1, RouteReceiptV1, };
+export type RouteCoordinatorResult = {
+    status: 'succeeded';
+    receipt: RouteReceiptV1;
+} | {
+    status: 'repairable';
+    code: 'triage-artifact-invalid' | 'waiting-candidate-rejected';
+    findings: string[];
+} | {
+    status: 'retryable';
+    owner: 'triage' | 'ambiguity-review';
+    code: string;
+} | {
+    status: 'safe-halt';
+    process: Extract<ContainedReportOperationResult, {
+        status: 'safe-halt';
+    }>['process'];
+    waitForAbsence(): Promise<void>;
+} | {
+    status: 'awaiting-user';
+    receipt: RouteReceiptV1;
+} | {
+    status: 'cancelled';
+} | {
+    status: 'blocked';
+    kind: 'external' | 'safety' | 'exhausted';
+    code: string;
+    evidence: string[];
+};
+export interface RouteCoordinatorState {
+    read(): Promise<RouteExecutionV1>;
+    compareAndSwap(expected: RouteExecutionV1, next: RouteExecutionV1): Promise<boolean>;
+    complete(expected: RouteExecutionV1, next: RouteExecutionV1, receipt: RouteReceiptV1): Promise<boolean>;
+    cancel(expected: RouteExecutionV1): Promise<boolean>;
+}
+export interface RouteReceiptInput {
+    artifact: TriageRouteV1;
+    triage: RouteArtifactRefV1;
+    review: AmbiguityReviewRefV1 | null;
+    decidedAt: string;
+}
+export interface RouteCoordinatorDependencies {
+    state: RouteCoordinatorState;
+    operation: ContainedReportOperation;
+    createAttemptId(): string;
+    now(): string;
+    createReceipt(input: RouteReceiptInput): RouteReceiptV1;
+}
+export interface RouteCoordinatorInput {
+    runId: string;
+    worktreePath: string;
+    workflowGeneration: WorkflowGenerationReceipt;
+    promptFacts: string[];
+    signal: AbortSignal;
+}
+export declare function initialRouteExecution(): RouteExecutionV1;
+export declare class RouteCoordinator {
+    private readonly dependencies;
+    constructor(dependencies: RouteCoordinatorDependencies);
+    run(input: RouteCoordinatorInput): Promise<RouteCoordinatorResult>;
+    private launchTriage;
+    private adoptTriage;
+    private launchReview;
+    private adoptReview;
+    private invalidTriage;
+    private retryTriage;
+    private retryReview;
+    private recoverTriage;
+    private recoverReview;
+    private complete;
+    private cancel;
+}
+//# sourceMappingURL=route-coordinator.d.ts.map

package/dist/src/v2/route-coordinator.d.ts.map

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