@namzu/cli 23.0.0 → 24.0.0

package/dist/integrations/resident/foreground.js

@@ -0,0 +1,95 @@
+import { setTimeout as sleep } from 'node:timers/promises';
+import { ResidentHost, } from '@namzu/sdk';
+/** One explicitly authorized foreground invocation, with cross-process stop observation. */
+export async function runResidentForeground(options) {
+    const { agenda } = options;
+    if (!agenda.executionAt)
+        throw new Error('Resident execution requires atomic admission.');
+    const interval = options.pollIntervalMs ?? 250;
+    if (!Number.isSafeInteger(interval) || interval < 1 || interval > 60_000)
+        throw new Error('Invalid resident control polling interval.');
+    options.signal.throwIfAborted();
+    const initial = await agenda.read();
+    if (!initial)
+        throw new Error('No resident agenda exists here.');
+    const generation = options.expectedPauseGeneration ?? initial.pauseGeneration ?? 0;
+    const controller = new AbortController();
+    const signal = AbortSignal.any([options.signal, controller.signal]);
+    const fence = (state) => {
+        if (!state)
+            throw new Error('Resident agenda disappeared during execution.');
+        if ((state.pauseGeneration ?? 0) !== generation)
+            controller.abort(new Error('A durable pause request ended this invocation.'));
+        return state;
+    };
+    const read = async () => {
+        await options.checkControl?.();
+        return fence(await agenda.read());
+    };
+    const guarded = {
+        read,
+        create: (...args) => agenda.create(...args),
+        add: (...args) => agenda.add(...args),
+        setPaused: (...args) => agenda.setPaused(...args),
+        wake: (...args) => agenda.wake(...args),
+        execution: (id) => agenda.execution(id),
+        executionAt: (id, expected) => {
+            const execution = agenda.executionAt?.(id, expected);
+            if (!execution)
+                throw new Error('Resident atomic admission was removed.');
+            return {
+                read: () => execution.read(),
+                claim: async (...args) => {
+                    await read();
+                    signal.throwIfAborted();
+                    // Keep the exact learning/admission snapshot. Do not substitute the
+                    // newer control read for the snapshot projected into this step.
+                    return execution.claim(...args);
+                },
+                settle: (...args) => execution.settle(...args),
+            };
+        },
+    };
+    const host = new ResidentHost(guarded, async (...args) => {
+        await read();
+        signal.throwIfAborted();
+        return options.step(...args);
+    }, { learning: true });
+    const monitorStop = new AbortController();
+    let monitorFailure;
+    let lastRevision = initial.revision;
+    const monitor = (async () => {
+        try {
+            while (!monitorStop.signal.aborted) {
+                await sleep(interval, undefined, { signal: monitorStop.signal });
+                const state = await read();
+                if (state.revision !== lastRevision) {
+                    lastRevision = state.revision;
+                    host.notify();
+                }
+            }
+        }
+        catch (error) {
+            if (!monitorStop.signal.aborted) {
+                monitorFailure = error;
+                controller.abort(error);
+            }
+        }
+    })();
+    try {
+        const result = await host.run({
+            signal,
+            maxSteps: options.maxSteps,
+            ...(options.keepAlive !== undefined ? { keepAlive: options.keepAlive } : {}),
+            ...(options.maxIdleMs !== undefined ? { maxIdleMs: options.maxIdleMs } : {}),
+        });
+        if (monitorFailure)
+            throw monitorFailure;
+        return result;
+    }
+    finally {
+        monitorStop.abort();
+        await monitor;
+    }
+}
+//# sourceMappingURL=foreground.js.map

package/dist/integrations/resident/foreground.js.map

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

package/dist/integrations/resident/lifecycle-errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The callback has finished awaiting cleanup, but cannot certify that every
+ * owned resource drained. A managed runner must retain its ownership record.
+ * Latch this error at the step boundary: cancellation may hide it at the host.
+ */
+export declare class ResidentCleanupUnconfirmedError extends AggregateError {
+    constructor(errors: readonly unknown[]);
+}
+//# sourceMappingURL=lifecycle-errors.d.ts.map

package/dist/integrations/resident/lifecycle-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-errors.d.ts","sourceRoot":"","sources":["../../../src/integrations/resident/lifecycle-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,+BAAgC,SAAQ,cAAc;gBACtD,MAAM,EAAE,SAAS,OAAO,EAAE;CAYtC"}

package/dist/integrations/resident/lifecycle-errors.js

@@ -0,0 +1,15 @@
+/**
+ * The callback has finished awaiting cleanup, but cannot certify that every
+ * owned resource drained. A managed runner must retain its ownership record.
+ * Latch this error at the step boundary: cancellation may hide it at the host.
+ */
+export class ResidentCleanupUnconfirmedError extends AggregateError {
+    constructor(errors) {
+        super(errors, [
+            'Resident cleanup is unconfirmed; runner ownership must be retained.',
+            ...errors.map((error) => (error instanceof Error ? error.message : String(error)).slice(0, 4_000)),
+        ].join('\n'));
+        this.name = 'ResidentCleanupUnconfirmedError';
+    }
+}
+//# sourceMappingURL=lifecycle-errors.js.map

package/dist/integrations/resident/lifecycle-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-errors.js","sourceRoot":"","sources":["../../../src/integrations/resident/lifecycle-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,+BAAgC,SAAQ,cAAc;IAClE,YAAY,MAA0B;QACrC,KAAK,CACJ,MAAM,EACN;YACC,qEAAqE;YACrE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACvB,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CACxE;SACD,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAA;IAC9C,CAAC;CACD"}

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

@@ -0,0 +1,17 @@
+import type { ResidentContextualStep, ResidentHostResult } from '@namzu/sdk';
+import { type RunnerRecord, publicRunner } from './runner-store.js';
+import type { CliResident } from './storage.js';
+export interface OwnedResidentOptions {
+    readonly resident: CliResident;
+    readonly owner: RunnerRecord;
+    readonly step: ResidentContextualStep;
+    readonly signal: AbortSignal;
+    readonly keepAlive: boolean;
+    readonly maxIdleMs: number;
+    /** Readiness means control and durable ownership are installed, not model availability. */
+    readonly ready?: (owner: ReturnType<typeof publicRunner>, signal: AbortSignal) => Promise<void>;
+    readonly pollIntervalMs?: number;
+}
+/** Keep ownership until the SDK invocation, callback cleanup and control server drain. */
+export declare function runOwnedResident(options: OwnedResidentOptions): Promise<ResidentHostResult>;
+//# sourceMappingURL=owned-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"owned-runner.d.ts","sourceRoot":"","sources":["../../../src/integrations/resident/owned-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAI5E,OAAO,EACN,KAAK,YAAY,EAGjB,YAAY,EAEZ,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,0FAA0F;AAC1F,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+EjG"}

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

@@ -0,0 +1,91 @@
+import { runResidentForeground } from './foreground.js';
+import { ResidentCleanupUnconfirmedError } from './lifecycle-errors.js';
+import { createRunnerControlServer } from './runner-control.js';
+import { attachRunning, finishRunner, publicRunner, readRunner, } from './runner-store.js';
+/** Keep ownership until the SDK invocation, callback cleanup and control server drain. */
+export async function runOwnedResident(options) {
+    const { resident } = options;
+    let owner = options.owner;
+    let phase = 'starting';
+    let stepsStarted = 0;
+    const controller = new AbortController();
+    const signal = AbortSignal.any([options.signal, controller.signal]);
+    const abort = () => {
+        phase = 'stopping';
+        controller.abort(new Error('Resident runner stop requested.'));
+    };
+    const checkControl = async () => {
+        const current = readRunner(resident);
+        if (current?.instanceId !== owner.instanceId || current.phase !== 'running')
+            throw new Error('Resident runner ownership changed; this invocation is fenced.');
+    };
+    let server;
+    let outcome = 'startup_failed';
+    let cleanupConfirmed = true;
+    try {
+        signal.throwIfAborted();
+        const state = await resident.agenda.read();
+        if (!state || state.paused || (state.pauseGeneration ?? 0) !== owner.pauseGeneration)
+            throw new Error('Resident admission changed before runner startup. Resume and start a new invocation.');
+        if (state.pursuits.some((p) => p.state.phase === 'running'))
+            throw new Error('Inspect and reconcile unresolved work before starting a runner.');
+        server = await createRunnerControlServer({
+            instanceId: owner.instanceId,
+            token: owner.token,
+            getStatus: () => ({
+                pid: process.pid,
+                phase: signal.aborted ? 'stopping' : phase,
+                stepsStarted,
+            }),
+            onStop: abort,
+        });
+        owner = attachRunning(resident, owner, { pid: process.pid, port: server.port });
+        await checkControl();
+        await options.ready?.(publicRunner(owner), signal);
+        signal.throwIfAborted();
+        phase = 'idle';
+        const result = await runResidentForeground({
+            agenda: resident.agenda,
+            step: async (...args) => {
+                phase = 'working';
+                stepsStarted++;
+                try {
+                    return await options.step(...args);
+                }
+                catch (error) {
+                    // The SDK host turns aborted callbacks into a cancelled result.
+                    // Latch failed drainage before that conversion can hide it.
+                    if (error instanceof ResidentCleanupUnconfirmedError)
+                        cleanupConfirmed = false;
+                    throw error;
+                }
+                finally {
+                    phase = signal.aborted ? 'stopping' : 'idle';
+                }
+            },
+            signal,
+            maxSteps: owner.maxSteps,
+            maxIdleMs: options.maxIdleMs,
+            keepAlive: options.keepAlive,
+            expectedPauseGeneration: owner.pauseGeneration,
+            checkControl,
+            ...(options.pollIntervalMs ? { pollIntervalMs: options.pollIntervalMs } : {}),
+        });
+        outcome = result.status;
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ResidentCleanupUnconfirmedError)
+            cleanupConfirmed = false;
+        outcome = signal.aborted ? 'cancelled' : 'failed';
+        throw error;
+    }
+    finally {
+        phase = 'stopping';
+        // A stopped receipt is a drainage acknowledgement, never a PID-liveness guess.
+        await server?.close();
+        if (cleanupConfirmed)
+            finishRunner(resident, owner, outcome);
+    }
+}
+//# sourceMappingURL=owned-runner.js.map

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

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

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

@@ -0,0 +1,47 @@
+declare const PHASES: readonly ["starting", "idle", "working", "stopping"];
+export type RunnerControlPhase = (typeof PHASES)[number];
+export type RunnerControlAction = 'status' | 'stop';
+export interface RunnerControlStatus {
+    readonly pid: number;
+    readonly phase: RunnerControlPhase;
+    /** Callback entries admitted by this runner, independent of final settlement. */
+    readonly stepsStarted: number;
+}
+export interface RunnerControlServerOptions {
+    readonly instanceId: string;
+    readonly token: string;
+    readonly getStatus: () => RunnerControlStatus;
+    /** Signal owned work once. A response acknowledges this request, not drainage. */
+    readonly onStop: () => void;
+}
+export interface RunnerControlServer {
+    readonly port: number;
+    /** Refuse new clients and destroy remaining sockets before resolving. */
+    close(): Promise<void>;
+}
+export interface RunnerControlRecord {
+    readonly instanceId: string;
+    readonly token: string;
+    readonly port: number | null;
+    readonly pid: number | null;
+}
+export type RunnerControlResult = ({
+    readonly kind: 'responsive';
+    readonly instanceId: string;
+    readonly stopRequested: boolean;
+} & RunnerControlStatus) | {
+    readonly kind: 'unresponsive';
+    /** No observation here establishes that the process is dead. */
+    readonly reason: string;
+};
+/**
+ * One private, local control endpoint. Authentication is bound to an immutable
+ * runner instance, never to a PID alone. No request runs tools or shell commands.
+ */
+export declare function createRunnerControlServer(options: RunnerControlServerOptions): Promise<RunnerControlServer>;
+/** An authenticated response proves responsiveness; absence never proves death. */
+export declare function queryRunner(record: RunnerControlRecord, action: RunnerControlAction, options?: {
+    readonly timeoutMs?: number;
+}): Promise<RunnerControlResult>;
+export {};
+//# sourceMappingURL=runner-control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner-control.d.ts","sourceRoot":"","sources":["../../../src/integrations/resident/runner-control.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,MAAM,sDAAuD,CAAA;AAEnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AACxD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEnD,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;IAClC,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,mBAAmB,CAAA;IAC7C,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAC5B,CAAC;IACD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAC9B,GAAG,mBAAmB,CAAC,GACxB;IACA,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACtB,CAAA;AA8BJ;;;GAGG;AACH,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAwH9B;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAC1B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CAgF9B"}

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

@@ -0,0 +1,238 @@
+import { timingSafeEqual } from 'node:crypto';
+import { createConnection, createServer } from 'node:net';
+const MAX_MESSAGE_BYTES = 4_096;
+const MAX_OPEN_SOCKETS = 16;
+const DEFAULT_TIMEOUT_MS = 1_500;
+const PHASES = ['starting', 'idle', 'working', 'stopping'];
+function object(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function exactKeys(value, keys) {
+    const actual = Object.keys(value);
+    return actual.length === keys.length && actual.every((key) => keys.includes(key));
+}
+function validIdentity(instanceId, token) {
+    return (instanceId.length > 0 && instanceId.length <= 256 && token.length > 0 && token.length <= 512);
+}
+function validStatus(value) {
+    return (typeof value.pid === 'number' &&
+        Number.isSafeInteger(value.pid) &&
+        value.pid > 0 &&
+        typeof value.phase === 'string' &&
+        PHASES.includes(value.phase) &&
+        typeof value.stepsStarted === 'number' &&
+        Number.isSafeInteger(value.stepsStarted) &&
+        value.stepsStarted >= 0);
+}
+/**
+ * One private, local control endpoint. Authentication is bound to an immutable
+ * runner instance, never to a PID alone. No request runs tools or shell commands.
+ */
+export async function createRunnerControlServer(options) {
+    if (!validIdentity(options.instanceId, options.token))
+        throw new Error('Runner control requires a bounded instance identity and secret token.');
+    const expectedToken = Buffer.from(options.token);
+    const sockets = new Set();
+    let stopRequested = false;
+    let stopFailed = false;
+    let closing = false;
+    let closePromise;
+    const requestStop = () => {
+        if (stopRequested)
+            return;
+        stopRequested = true;
+        try {
+            options.onStop();
+        }
+        catch (error) {
+            stopFailed = true;
+            throw error;
+        }
+    };
+    const server = createServer((socket) => {
+        socket.on('error', () => { });
+        if (closing || sockets.size >= MAX_OPEN_SOCKETS) {
+            socket.destroy();
+            return;
+        }
+        sockets.add(socket);
+        socket.once('close', () => sockets.delete(socket));
+        // A total deadline, rather than an inactivity timeout a slow sender can reset.
+        const deadline = setTimeout(() => socket.destroy(), DEFAULT_TIMEOUT_MS);
+        socket.once('close', () => clearTimeout(deadline));
+        let buffered = Buffer.alloc(0);
+        let handled = false;
+        socket.on('data', (chunk) => {
+            if (handled || buffered.length + chunk.length > MAX_MESSAGE_BYTES) {
+                socket.destroy();
+                return;
+            }
+            buffered = Buffer.concat([buffered, chunk]);
+            const newline = buffered.indexOf(10);
+            if (newline < 0)
+                return;
+            handled = true;
+            if (newline !== buffered.length - 1) {
+                socket.destroy();
+                return;
+            }
+            try {
+                const request = JSON.parse(buffered.subarray(0, newline).toString('utf8'));
+                if (!object(request) ||
+                    !exactKeys(request, ['version', 'instanceId', 'token', 'action']) ||
+                    request.version !== 1 ||
+                    request.instanceId !== options.instanceId ||
+                    typeof request.token !== 'string' ||
+                    (request.action !== 'status' && request.action !== 'stop')) {
+                    socket.destroy();
+                    return;
+                }
+                const token = Buffer.from(request.token);
+                if (token.length !== expectedToken.length || !timingSafeEqual(token, expectedToken)) {
+                    socket.destroy();
+                    return;
+                }
+                if (request.action === 'stop')
+                    requestStop();
+                if (stopFailed)
+                    throw new Error('Runner stop callback failed.');
+                const state = options.getStatus();
+                if (!object(state) || !validStatus(state))
+                    throw new Error('Invalid runner state.');
+                socket.end(`${JSON.stringify({
+                    version: 1,
+                    instanceId: options.instanceId,
+                    pid: state.pid,
+                    phase: stopRequested ? 'stopping' : state.phase,
+                    stepsStarted: state.stepsStarted,
+                    stopRequested,
+                })}\n`);
+            }
+            catch {
+                // Request bytes and the secret never enter logs or error responses.
+                socket.destroy();
+            }
+        });
+    });
+    const close = () => {
+        if (closePromise)
+            return closePromise;
+        closing = true;
+        closePromise = new Promise((resolve, reject) => {
+            server.close((error) => {
+                if (error && error.code !== 'ERR_SERVER_NOT_RUNNING')
+                    reject(error);
+                else
+                    resolve();
+            });
+            for (const socket of sockets)
+                socket.destroy();
+        });
+        return closePromise;
+    };
+    await new Promise((resolve, reject) => {
+        const failed = (error) => reject(error);
+        server.once('error', failed);
+        server.listen({ host: '127.0.0.1', port: 0, exclusive: true }, () => {
+            server.removeListener('error', failed);
+            resolve();
+        });
+    });
+    // Losing the installed control endpoint stops admission through the same
+    // callback; it does not leave an uncontrolled runner claiming to be healthy.
+    server.on('error', () => {
+        try {
+            requestStop();
+        }
+        catch {
+            /* The owner is already being stopped. */
+        }
+        void close().catch(() => { });
+    });
+    const address = server.address();
+    if (address === null || typeof address === 'string') {
+        await close();
+        throw new Error('Runner control did not acquire a loopback port.');
+    }
+    return { port: address.port, close };
+}
+/** An authenticated response proves responsiveness; absence never proves death. */
+export function queryRunner(record, action, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 60_000)
+        throw new Error('Runner control timeout must be a whole number from 1 to 60000 milliseconds.');
+    if (!validIdentity(record.instanceId, record.token) ||
+        !Number.isSafeInteger(record.port) ||
+        (record.port ?? 0) < 1 ||
+        (record.port ?? 0) > 65_535 ||
+        !Number.isSafeInteger(record.pid) ||
+        (record.pid ?? 0) < 1 ||
+        (action !== 'status' && action !== 'stop'))
+        return Promise.resolve({
+            kind: 'unresponsive',
+            reason: 'Runner control endpoint is unavailable.',
+        });
+    return new Promise((resolve) => {
+        const socket = createConnection({ host: '127.0.0.1', port: record.port });
+        let settled = false;
+        let buffered = Buffer.alloc(0);
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(deadline);
+            socket.destroy();
+            resolve(result);
+        };
+        const unresponsive = (reason) => finish({ kind: 'unresponsive', reason });
+        const deadline = setTimeout(() => unresponsive('Runner control response timed out.'), timeoutMs);
+        socket.once('error', () => unresponsive('Runner control connection failed.'));
+        socket.once('close', () => unresponsive('Runner control closed without a valid response.'));
+        socket.once('connect', () => {
+            socket.write(`${JSON.stringify({ version: 1, instanceId: record.instanceId, token: record.token, action })}\n`);
+        });
+        socket.on('data', (chunk) => {
+            if (buffered.length + chunk.length > MAX_MESSAGE_BYTES) {
+                unresponsive('Runner control response exceeded its size limit.');
+                return;
+            }
+            buffered = Buffer.concat([buffered, chunk]);
+            const newline = buffered.indexOf(10);
+            if (newline < 0)
+                return;
+            try {
+                const response = JSON.parse(buffered.subarray(0, newline).toString('utf8'));
+                if (newline !== buffered.length - 1 ||
+                    !object(response) ||
+                    !exactKeys(response, [
+                        'version',
+                        'instanceId',
+                        'pid',
+                        'phase',
+                        'stepsStarted',
+                        'stopRequested',
+                    ]) ||
+                    response.version !== 1 ||
+                    response.instanceId !== record.instanceId ||
+                    response.pid !== record.pid ||
+                    !validStatus(response) ||
+                    typeof response.stopRequested !== 'boolean' ||
+                    (response.stopRequested && response.phase !== 'stopping') ||
+                    (action === 'stop' && !response.stopRequested))
+                    throw new Error('Invalid response.');
+                finish({
+                    kind: 'responsive',
+                    instanceId: record.instanceId,
+                    pid: response.pid,
+                    phase: response.phase,
+                    stepsStarted: response.stepsStarted,
+                    stopRequested: response.stopRequested,
+                });
+            }
+            catch {
+                unresponsive('Runner control returned an invalid response.');
+            }
+        });
+    });
+}
+//# sourceMappingURL=runner-control.js.map

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

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

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

@@ -0,0 +1,47 @@
+import type { RunFlags } from '../../commands/run-flags.js';
+import type { CommandContext } from '../../commands/types.js';
+import { type RunnerRecord } from './runner-store.js';
+import type { CliResident } from './storage.js';
+export interface ResidentWorkerLaunch {
+    readonly version: 1;
+    readonly cwd: string;
+    readonly agentKey: string;
+    readonly instanceId: string;
+    readonly config: CommandContext['config'];
+    readonly flags: RunFlags;
+    readonly toolLoading?: 'eager' | 'deferred';
+    readonly contextProfile?: 'resident' | 'interactive';
+    readonly maxIdleMs: number;
+}
+/** Launch the same installation with no terminal streams or on-disk credentials/config. */
+export declare function startResidentRunner(options: {
+    readonly resident: CliResident;
+    readonly ctx: CommandContext;
+    readonly flags: RunFlags;
+    readonly toolLoading?: 'eager' | 'deferred';
+    readonly contextProfile?: 'resident' | 'interactive';
+    readonly maxSteps: number;
+    readonly maxIdleMs: number;
+}): Promise<Omit<RunnerRecord, "token">>;
+export declare function residentRunnerStatus(resident: CliResident): Promise<{
+    owner: null;
+    live: null;
+} | {
+    owner: Omit<RunnerRecord, "token">;
+    live: import("./runner-control.js").RunnerControlResult | null;
+}>;
+/** Caller durably closes admission first. No signals are sent to recorded PIDs. */
+export declare function stopResidentRunner(resident: CliResident, options: {
+    readonly owner: RunnerRecord | null;
+    readonly waitMs?: number;
+}): Promise<{
+    status: "absent";
+    owner: null;
+} | {
+    status: "drained";
+    owner: Omit<RunnerRecord, "token">;
+} | {
+    status: "unconfirmed";
+    owner: Omit<RunnerRecord, "token"> | null;
+}>;
+//# sourceMappingURL=runner-launch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner-launch.d.ts","sourceRoot":"","sources":["../../../src/integrations/resident/runner-launch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,EACN,KAAK,YAAY,EAMjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IACzC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,aAAa,CAAA;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,2FAA2F;AAC3F,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IAClD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,aAAa,CAAA;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B,wCA6GA;AAED,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,WAAW;;;;;;GAO/D;AAED,mFAAmF;AACnF,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;GAkB1E"}