@namzu/cli 22.0.1 → 24.0.0

package/dist/integrations/resident/runner-store.js

@@ -0,0 +1,283 @@
+import { randomBytes, randomUUID } from 'node:crypto';
+import { lstatSync, readFileSync, readdirSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { ResidentConflictError, isEntityId } from '@namzu/sdk';
+import { publishPrivateJsonIfAbsent } from '../state/immutable-json.js';
+import { ensurePrivateStateDirectory } from '../state/private-directory.js';
+const UUID = /^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/u;
+const REVISION_NAME = /^([1-9][0-9]{0,15})\.json$/u;
+const FIELDS = [
+    'version',
+    'revision',
+    'instanceId',
+    'tenantId',
+    'projectId',
+    'agentKey',
+    'cwd',
+    'mode',
+    'phase',
+    'reservedAt',
+    'maxSteps',
+    'pauseGeneration',
+    'pid',
+    'port',
+    'token',
+    'endedAt',
+    'outcome',
+];
+function integer(value, minimum) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= minimum;
+}
+function canonicalPath(value) {
+    return !value.includes('\0') && isAbsolute(value) && resolve(value) === value;
+}
+function location(resident) {
+    if (!isEntityId(resident.tenantId, 'tenant') ||
+        !isEntityId(resident.projectId, 'project') ||
+        !/^[a-z0-9][a-z0-9_-]{0,63}$/u.test(resident.agentKey) ||
+        !canonicalPath(resident.root) ||
+        !canonicalPath(resident.cwd)) {
+        throw new Error('Invalid resident scope for runner ownership.');
+    }
+    const base = join(resident.root, 'projects', resident.projectId, 'cli', 'residents', resident.agentKey);
+    if (resident.artifactsRoot !== join(base, 'attempts')) {
+        throw new Error('Resident runner path does not match its bound project and agent.');
+    }
+    return { base, runner: join(base, 'runner'), revisions: join(base, 'runner', 'revisions') };
+}
+function realDirectory(path) {
+    try {
+        const entry = lstatSync(path);
+        if (!entry.isDirectory() || entry.isSymbolicLink()) {
+            throw new Error(`Resident runner state requires a real directory: ${path}`);
+        }
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function revisions(resident) {
+    const paths = location(resident);
+    let current = resident.root;
+    if (!realDirectory(current))
+        return [];
+    for (const segment of [
+        'projects',
+        resident.projectId,
+        'cli',
+        'residents',
+        resident.agentKey,
+        'runner',
+        'revisions',
+    ]) {
+        current = join(current, segment);
+        if (!realDirectory(current))
+            return [];
+    }
+    const numbers = [];
+    for (const entry of readdirSync(paths.revisions, { withFileTypes: true })) {
+        // Publication scratch names never establish ownership, even after a crash.
+        if (/^[1-9][0-9]{0,15}\.json\.candidate\.[0-9a-f-]+$/u.test(entry.name))
+            continue;
+        const match = REVISION_NAME.exec(entry.name);
+        const revision = match ? Number(match[1]) : Number.NaN;
+        if (!integer(revision, 1) || !entry.isFile() || entry.isSymbolicLink()) {
+            throw new Error(`Invalid resident runner revision entry: ${join(paths.revisions, entry.name)}`);
+        }
+        numbers.push(revision);
+    }
+    return numbers.sort((left, right) => right - left);
+}
+function checked(resident, raw, revision) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('Resident runner record must be an object.');
+    }
+    const value = raw;
+    if (Object.keys(value).length !== FIELDS.length || FIELDS.some((field) => !(field in value))) {
+        throw new Error('Resident runner record has missing or unsupported fields.');
+    }
+    if (value.version !== 1 ||
+        value.revision !== revision ||
+        !integer(value.revision, 1) ||
+        typeof value.instanceId !== 'string' ||
+        !UUID.test(value.instanceId) ||
+        value.tenantId !== resident.tenantId ||
+        value.projectId !== resident.projectId ||
+        value.agentKey !== resident.agentKey ||
+        value.cwd !== resident.cwd ||
+        (value.mode !== 'foreground' && value.mode !== 'background') ||
+        !['reserved', 'running', 'stopped', 'released'].includes(String(value.phase)) ||
+        !integer(value.reservedAt, 0) ||
+        !integer(value.maxSteps, 1) ||
+        !integer(value.pauseGeneration, 0) ||
+        (value.pid !== null && !integer(value.pid, 1)) ||
+        (value.port !== null && (!integer(value.port, 1) || value.port > 65_535)) ||
+        typeof value.token !== 'string' ||
+        !/^[0-9a-f]{64}$/u.test(value.token)) {
+        throw new Error('Resident runner version, revision, scope or ownership metadata is invalid.');
+    }
+    const terminal = value.phase === 'stopped' || value.phase === 'released';
+    if ((terminal
+        ? !integer(value.endedAt, 0) ||
+            typeof value.outcome !== 'string' ||
+            !value.outcome.trim() ||
+            value.outcome.length > 8_000
+        : value.endedAt !== null || value.outcome !== null) ||
+        (value.phase === 'reserved' && (value.pid !== null || value.port !== null)) ||
+        (value.phase === 'running' && value.pid === null) ||
+        (value.pid === null && value.port !== null) ||
+        (value.mode === 'background' && value.pid !== null && value.port === null)) {
+        throw new Error('Resident runner phase and process metadata disagree.');
+    }
+    return Object.freeze(value);
+}
+function readRevision(resident, revision) {
+    const path = join(location(resident).revisions, `${revision}.json`);
+    try {
+        const entry = lstatSync(path);
+        if (!entry.isFile() || entry.isSymbolicLink() || entry.size > 64 * 1024) {
+            throw new Error('expected a bounded regular file without a symbolic link');
+        }
+        return checked(resident, JSON.parse(readFileSync(path, 'utf8')), revision);
+    }
+    catch (error) {
+        // JSON.parse diagnostics can quote private record bytes, including the
+        // control token. Keep filesystem/schema details, never parser excerpts.
+        const detail = error instanceof SyntaxError
+            ? 'invalid JSON'
+            : error instanceof Error
+                ? error.message
+                : 'unknown read failure';
+        throw new Error(`Cannot read resident runner revision ${path}: ${detail}. Refusing ownership recovery from damaged state.`);
+    }
+}
+/** An absent runner is a read-only result, never an instruction to initialize it. */
+export function readRunner(resident) {
+    const head = revisions(resident)[0];
+    return head === undefined ? null : readRevision(resident, head);
+}
+/** The original runner's final evidence remains visible after a successor starts. */
+export function readRunnerInstance(resident, instanceId) {
+    if (!UUID.test(instanceId))
+        throw new Error('Invalid resident runner instance ID.');
+    for (const revision of revisions(resident)) {
+        const record = readRevision(resident, revision);
+        if (record.instanceId === instanceId)
+            return record;
+    }
+    return null;
+}
+function publish(resident, expected, propose) {
+    const current = readRunner(resident);
+    if (!isDeepStrictEqual(current, expected))
+        throw new ResidentConflictError();
+    const next = (current?.revision ?? 0) + 1;
+    if (!integer(next, 1))
+        throw new Error('Resident runner revision overflow.');
+    const record = checked(resident, propose(next), next);
+    const paths = location(resident);
+    if (!realDirectory(paths.base))
+        throw new Error('Resident binding directory is missing.');
+    const runner = ensurePrivateStateDirectory(paths.base, 'runner');
+    const directory = ensurePrivateStateDirectory(runner, 'revisions');
+    publishPrivateJsonIfAbsent(join(directory, `${next}.json`), record);
+    // The helper reports EEXIST by preserving the winner. Equality proves whose
+    // complete proposal was published; never retry a stale operation on that owner.
+    if (!isDeepStrictEqual(readRevision(resident, next), record))
+        throw new ResidentConflictError();
+    return record;
+}
+/** Reserve one explicitly authorized invocation; an occupied owner is never stolen. */
+export function reserveRunner(resident, options) {
+    if ((options.mode !== 'foreground' && options.mode !== 'background') ||
+        !integer(options.maxSteps, 1) ||
+        !integer(options.pauseGeneration, 0)) {
+        throw new Error('Invalid resident runner invocation limits or mode.');
+    }
+    const current = readRunner(resident);
+    if (current && current.phase !== 'stopped' && current.phase !== 'released') {
+        throw new ResidentConflictError();
+    }
+    return publish(resident, current, (revision) => ({
+        version: 1,
+        revision,
+        instanceId: randomUUID(),
+        tenantId: resident.tenantId,
+        projectId: resident.projectId,
+        agentKey: resident.agentKey,
+        cwd: resident.cwd,
+        mode: options.mode,
+        phase: 'reserved',
+        reservedAt: Date.now(),
+        maxSteps: options.maxSteps,
+        pauseGeneration: options.pauseGeneration,
+        pid: null,
+        port: null,
+        token: randomBytes(32).toString('hex'),
+        endedAt: null,
+        outcome: null,
+    }));
+}
+export function attachRunning(resident, expected, process) {
+    if (expected.phase !== 'reserved')
+        throw new ResidentConflictError();
+    return publish(resident, expected, (revision) => ({
+        ...expected,
+        revision,
+        phase: 'running',
+        pid: process.pid,
+        port: process.port,
+    }));
+}
+/** Publish only after the executor and its controls have drained. */
+export function finishRunner(resident, expected, outcome) {
+    if (expected.phase !== 'reserved' && expected.phase !== 'running') {
+        throw new ResidentConflictError();
+    }
+    return publish(resident, expected, (revision) => ({
+        ...expected,
+        revision,
+        phase: 'stopped',
+        endedAt: Date.now(),
+        outcome,
+    }));
+}
+/** Explicit operator recovery of an exact owner; this is never proof of drainage. */
+export function releaseRunner(resident, expected) {
+    if (expected.phase !== 'reserved' && expected.phase !== 'running') {
+        throw new ResidentConflictError();
+    }
+    return publish(resident, expected, (revision) => ({
+        ...expected,
+        revision,
+        phase: 'released',
+        endedAt: Date.now(),
+        outcome: 'Operator explicitly released this owner after inspecting stopped executors.',
+    }));
+}
+/** Status reports retain ownership evidence without disclosing the control nonce. */
+export function publicRunner(record) {
+    return {
+        version: record.version,
+        revision: record.revision,
+        instanceId: record.instanceId,
+        tenantId: record.tenantId,
+        projectId: record.projectId,
+        agentKey: record.agentKey,
+        cwd: record.cwd,
+        mode: record.mode,
+        phase: record.phase,
+        reservedAt: record.reservedAt,
+        maxSteps: record.maxSteps,
+        pauseGeneration: record.pauseGeneration,
+        pid: record.pid,
+        port: record.port,
+        endedAt: record.endedAt,
+        outcome: record.outcome,
+    };
+}
+//# sourceMappingURL=runner-store.js.map

package/dist/integrations/resident/runner-store.js.map

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

package/dist/integrations/resident/runner-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner-worker.d.ts.map

package/dist/integrations/resident/runner-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-worker.d.ts","sourceRoot":"","sources":["../../../src/integrations/resident/runner-worker.ts"],"names":[],"mappings":""}

package/dist/integrations/resident/runner-worker.js

@@ -0,0 +1,143 @@
+import { realpath } from 'node:fs/promises';
+import { openSessions } from '../sessions/store.js';
+import { runOwnedResident } from './owned-runner.js';
+import { finishRunner, readRunner } from './runner-store.js';
+import { createResidentSessionStep } from './session-step.js';
+import { lookupResident } from './storage.js';
+// Internal child entrypoint. Launch parameters arrive only through the parent's
+// IPC channel; credentials and resolved configuration are never copied to disk.
+async function main() {
+    if (!process.send)
+        throw new Error('Resident workers must be started through namzu resident start.');
+    const controller = new AbortController();
+    let handedOff = false;
+    const stop = () => controller.abort(new Error('Resident worker interrupted before or during execution.'));
+    const disconnected = () => {
+        if (!handedOff)
+            stop();
+    };
+    process.on('disconnect', disconnected);
+    process.once('SIGINT', stop);
+    process.once('SIGTERM', stop);
+    let resident = null;
+    let owner = null;
+    let lifecycleStarted = false;
+    try {
+        const launch = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error('Resident startup parameters did not arrive.')), 15_000);
+            process.once('message', (message) => {
+                clearTimeout(timer);
+                if (!message ||
+                    typeof message !== 'object' ||
+                    message.version !== 1) {
+                    reject(new Error('Invalid resident worker launch.'));
+                    return;
+                }
+                resolve(message);
+            });
+        });
+        controller.signal.throwIfAborted();
+        resident = await lookupResident(launch.cwd, launch.agentKey);
+        if (!resident || resident.cwd !== launch.cwd || (await realpath(launch.cwd)) !== launch.cwd)
+            throw new Error('Resident execution directory changed before worker startup.');
+        const candidate = readRunner(resident);
+        if (candidate?.instanceId !== launch.instanceId || candidate.phase !== 'reserved')
+            throw new Error('Resident worker does not own this startup reservation.');
+        owner = candidate;
+        const sessions = await openSessions(resident.cwd);
+        if (sessions.projectId !== resident.projectId || sessions.tenantId !== resident.tenantId)
+            throw new Error('Resident project or tenant changed before worker startup.');
+        const ctx = {
+            config: launch.config,
+            formatter: { name: 'json', print() { }, info() { }, error() { } },
+        };
+        const step = createResidentSessionStep({
+            ctx,
+            cwd: resident.cwd,
+            sessions,
+            flags: launch.flags,
+            toolLoading: launch.toolLoading,
+            contextProfile: launch.contextProfile,
+            artifactsRoot: resident.artifactsRoot,
+        });
+        lifecycleStarted = true;
+        const result = await runOwnedResident({
+            resident,
+            owner,
+            step,
+            signal: controller.signal,
+            keepAlive: true,
+            maxIdleMs: launch.maxIdleMs,
+            ready: async (ready, signal) => {
+                await new Promise((resolve, reject) => {
+                    const cleanup = () => {
+                        clearTimeout(timer);
+                        process.removeListener('message', go);
+                        signal.removeEventListener('abort', aborted);
+                    };
+                    const aborted = () => {
+                        cleanup();
+                        reject(signal.reason);
+                    };
+                    const go = (message) => {
+                        if (message &&
+                            typeof message === 'object' &&
+                            message.kind === 'go' &&
+                            message.instanceId === ready.instanceId) {
+                            handedOff = true;
+                            cleanup();
+                            resolve();
+                        }
+                    };
+                    const timer = setTimeout(() => {
+                        cleanup();
+                        reject(new Error('Resident startup handoff timed out.'));
+                    }, 15_000);
+                    process.on('message', go);
+                    signal.addEventListener('abort', aborted, { once: true });
+                    if (signal.aborted) {
+                        aborted();
+                        return;
+                    }
+                    process.send?.({ kind: 'ready', instanceId: ready.instanceId }, (error) => {
+                        if (error) {
+                            cleanup();
+                            reject(error);
+                        }
+                    });
+                });
+            },
+        });
+        return ['unresolved', 'contended'].includes(result.status)
+            ? 1
+            : result.status === 'cancelled'
+                ? 130
+                : 0;
+    }
+    catch (error) {
+        if (!lifecycleStarted && resident && owner?.phase === 'reserved') {
+            try {
+                finishRunner(resident, owner, 'startup_failed');
+            }
+            catch {
+                /* A successor is never released by this worker. */
+            }
+        }
+        if (process.connected)
+            await new Promise((resolve) => {
+                process.send?.({
+                    kind: 'error',
+                    instanceId: owner?.instanceId,
+                    message: error instanceof Error ? error.message : String(error),
+                }, () => resolve());
+            });
+        return 1;
+    }
+    finally {
+        process.removeListener('disconnect', disconnected);
+        process.removeListener('SIGINT', stop);
+        process.removeListener('SIGTERM', stop);
+    }
+}
+void main().then((code) => process.exit(code), () => process.exit(1));
+//# sourceMappingURL=runner-worker.js.map

package/dist/integrations/resident/runner-worker.js.map

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

package/dist/integrations/resident/session-step.d.ts

@@ -0,0 +1,24 @@
+import { type ResidentContextualStep } from '@namzu/sdk';
+import { type RunFlags } from '../../commands/run-flags.js';
+import type { CommandContext } from '../../commands/types.js';
+import type { CliSessions } from '../sessions/store.js';
+export interface ResidentSessionStepOptions {
+    /** Already resolved through the CLI project trust boundary. */
+    readonly ctx: CommandContext;
+    readonly cwd: string;
+    readonly sessions: CliSessions;
+    readonly flags: RunFlags;
+    /** Defer optional tool schemas per step; authority and instructions remain unchanged. */
+    readonly toolLoading?: 'eager' | 'deferred';
+    /** Resident policy with layered snapshots by default; interactive preserves the earlier prompt. */
+    readonly contextProfile?: 'resident' | 'interactive';
+    /** Private, host-owned directory for per-claim receipts. */
+    readonly artifactsRoot: string;
+}
+/**
+ * One admitted pursuit uses the normal CLI session and SDK answer-review loop.
+ * There is no provider construction before admission, conversation substitution,
+ * checkpoint replay, or host-side model retry. An error keeps the SDK claim held.
+ */
+export declare function createResidentSessionStep(options: ResidentSessionStepOptions): ResidentContextualStep;
+//# sourceMappingURL=session-step.d.ts.map

package/dist/integrations/resident/session-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-step.d.ts","sourceRoot":"","sources":["../../../src/integrations/resident/session-step.ts"],"names":[],"mappings":"AAIA,OAAO,EAGN,KAAK,sBAAsB,EAQ3B,MAAM,YAAY,CAAA;AAEnB,OAAO,EACN,KAAK,QAAQ,EAKb,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAO7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAuBvD,MAAM,WAAW,0BAA0B;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC3C,mGAAmG;IACnG,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,aAAa,CAAA;IACpD,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC9B;AAuGD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,0BAA0B,GACjC,sBAAsB,CAwPxB"}