@namzu/cli 23.0.0 → 24.0.0

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

@@ -0,0 +1,140 @@
+import { fork } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { queryRunner } from './runner-control.js';
+import { finishRunner, publicRunner, readRunner, readRunnerInstance, reserveRunner, } from './runner-store.js';
+/** Launch the same installation with no terminal streams or on-disk credentials/config. */
+export async function startResidentRunner(options) {
+    const { resident } = options;
+    const existing = readRunner(resident);
+    if (existing && (existing.phase === 'reserved' || existing.phase === 'running'))
+        throw new Error(`Runner ${existing.instanceId} already owns this resident. Use resident status or stop; a second start cannot reset its limit.`);
+    const agenda = await resident.agenda.read();
+    if (!agenda || agenda.paused || agenda.pursuits.some((p) => p.state.phase === 'running'))
+        throw new Error('Starting requires open admission and no unresolved pursuit claims.');
+    const owner = reserveRunner(resident, {
+        mode: 'background',
+        maxSteps: options.maxSteps,
+        pauseGeneration: agenda.pauseGeneration ?? 0,
+    });
+    const source = import.meta.url.endsWith('.ts');
+    const worker = new URL(`./runner-worker.${source ? 'ts' : 'js'}`, import.meta.url);
+    const launch = {
+        version: 1,
+        cwd: resident.cwd,
+        agentKey: resident.agentKey,
+        instanceId: owner.instanceId,
+        config: options.ctx.config,
+        flags: options.flags,
+        toolLoading: options.toolLoading,
+        contextProfile: options.contextProfile,
+        maxIdleMs: options.maxIdleMs,
+    };
+    let child;
+    try {
+        child = fork(worker, [], {
+            cwd: resident.cwd,
+            env: { ...process.env, NAMZU_HOME: resident.root },
+            detached: true,
+            stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
+            execArgv: source ? ['--import', createRequire(import.meta.url).resolve('tsx')] : [],
+        });
+    }
+    catch (error) {
+        finishRunner(resident, owner, 'launch_failed');
+        throw error;
+    }
+    return await new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            child.removeListener('message', message);
+            child.removeListener('exit', exited);
+            // Keep the error listener: asynchronous IPC teardown must not crash the launcher.
+            if (child.connected)
+                child.disconnect();
+            child.unref();
+            if (error)
+                reject(error);
+            else {
+                try {
+                    const current = readRunnerInstance(resident, owner.instanceId);
+                    if (!current)
+                        throw new Error('Runner startup receipt disappeared.');
+                    resolve(publicRunner(current));
+                }
+                catch (readError) {
+                    reject(readError);
+                }
+            }
+        };
+        const message = (raw) => {
+            if (!raw || typeof raw !== 'object')
+                return;
+            const value = raw;
+            if (value.instanceId !== owner.instanceId)
+                return;
+            if (value.kind === 'error') {
+                finish(new Error(typeof value.message === 'string' ? value.message : 'Runner startup failed.'));
+            }
+            else if (value.kind === 'ready') {
+                // The child will not admit a model step before this explicit handoff.
+                child.send({ kind: 'go', instanceId: owner.instanceId }, (error) => finish(error ?? undefined));
+            }
+        };
+        const exited = () => finish(new Error('Resident worker exited before startup was acknowledged. Inspect resident status.'));
+        const timer = setTimeout(() => finish(new Error('Resident startup was not acknowledged. Ownership is retained; inspect resident status before retrying.')), 15_000);
+        child.on('message', message);
+        child.once('exit', exited);
+        child.on('error', (error) => {
+            if (!child.pid) {
+                try {
+                    finishRunner(resident, owner, 'launch_failed');
+                }
+                catch {
+                    /* Keep the exact-owner conflict visible in status. */
+                }
+            }
+            finish(error);
+        });
+        child.send(launch, (error) => {
+            if (error)
+                finish(error);
+        });
+    });
+}
+export async function residentRunnerStatus(resident) {
+    const record = readRunner(resident);
+    if (!record)
+        return { owner: null, live: null };
+    return {
+        owner: publicRunner(record),
+        live: record.phase === 'running' ? await queryRunner(record, 'status') : null,
+    };
+}
+/** Caller durably closes admission first. No signals are sent to recorded PIDs. */
+export async function stopResidentRunner(resident, options) {
+    const record = options.owner;
+    const waitMs = options.waitMs ?? 5_000;
+    if (!record)
+        return { status: 'absent', owner: null };
+    if (record.phase === 'stopped')
+        return { status: 'drained', owner: publicRunner(record) };
+    if (record.phase === 'released')
+        return { status: 'unconfirmed', owner: publicRunner(record) };
+    if (record.phase === 'running')
+        await queryRunner(record, 'stop');
+    const deadline = Date.now() + waitMs;
+    while (true) {
+        const current = readRunnerInstance(resident, record.instanceId);
+        if (current?.phase === 'stopped')
+            return { status: 'drained', owner: publicRunner(current) };
+        if (!current || current.phase === 'released' || Date.now() >= deadline)
+            return { status: 'unconfirmed', owner: current ? publicRunner(current) : null };
+        await sleep(Math.min(50, Math.max(1, deadline - Date.now())));
+    }
+}
+//# sourceMappingURL=runner-launch.js.map

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

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

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

@@ -0,0 +1,44 @@
+import { type ProjectId, type TenantId } from '@namzu/sdk';
+import type { CliResident } from './storage.js';
+export interface RunnerRecord {
+    readonly version: 1;
+    readonly revision: number;
+    readonly instanceId: string;
+    readonly tenantId: TenantId;
+    readonly projectId: ProjectId;
+    readonly agentKey: string;
+    readonly cwd: string;
+    readonly mode: 'foreground' | 'background';
+    readonly phase: 'reserved' | 'running' | 'stopped' | 'released';
+    readonly reservedAt: number;
+    readonly maxSteps: number;
+    readonly pauseGeneration: number;
+    readonly pid: number | null;
+    readonly port: number | null;
+    /** Private authentication material; never include this in status output. */
+    readonly token: string;
+    readonly endedAt: number | null;
+    readonly outcome: string | null;
+}
+export interface ReserveRunnerOptions {
+    readonly mode: RunnerRecord['mode'];
+    readonly maxSteps: number;
+    readonly pauseGeneration: number;
+}
+/** An absent runner is a read-only result, never an instruction to initialize it. */
+export declare function readRunner(resident: CliResident): RunnerRecord | null;
+/** The original runner's final evidence remains visible after a successor starts. */
+export declare function readRunnerInstance(resident: CliResident, instanceId: string): RunnerRecord | null;
+/** Reserve one explicitly authorized invocation; an occupied owner is never stolen. */
+export declare function reserveRunner(resident: CliResident, options: ReserveRunnerOptions): RunnerRecord;
+export declare function attachRunning(resident: CliResident, expected: RunnerRecord, process: {
+    readonly pid: number;
+    readonly port: number | null;
+}): RunnerRecord;
+/** Publish only after the executor and its controls have drained. */
+export declare function finishRunner(resident: CliResident, expected: RunnerRecord, outcome: string): RunnerRecord;
+/** Explicit operator recovery of an exact owner; this is never proof of drainage. */
+export declare function releaseRunner(resident: CliResident, expected: RunnerRecord): RunnerRecord;
+/** Status reports retain ownership evidence without disclosing the control nonce. */
+export declare function publicRunner(record: RunnerRecord): Omit<RunnerRecord, 'token'>;
+//# sourceMappingURL=runner-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner-store.d.ts","sourceRoot":"","sources":["../../../src/integrations/resident/runner-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAyB,KAAK,QAAQ,EAAc,MAAM,YAAY,CAAA;AAI7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAChC;AA4KD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,IAAI,CAGrE;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAOjG;AAuBD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,GAAG,YAAY,CA+BhG;AAED,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC7D,YAAY,CASd;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACb,YAAY,CAWd;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,GAAG,YAAY,CAWzF;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAmB9E"}

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":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAkB,qBAAqB,EAAiB,UAAU,EAAE,MAAM,YAAY,CAAA;AAE7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AA8B3E,MAAM,IAAI,GAAG,gDAAgD,CAAA;AAC7D,MAAM,aAAa,GAAG,6BAA6B,CAAA;AACnD,MAAM,MAAM,GAAG;IACd,SAAS;IACT,UAAU;IACV,YAAY;IACZ,UAAU;IACV,WAAW;IACX,UAAU;IACV,KAAK;IACL,MAAM;IACN,OAAO;IACP,YAAY;IACZ,UAAU;IACV,iBAAiB;IACjB,KAAK;IACL,MAAM;IACN,OAAO;IACP,SAAS;IACT,SAAS;CACA,CAAA;AAEV,SAAS,OAAO,CAAC,KAAc,EAAE,OAAe;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,OAAO,CAAA;AACpF,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IACnC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAA;AAC9E,CAAC;AAED,SAAS,QAAQ,CAAC,QAAqB;IACtC,IACC,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACxC,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;QAC1C,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACtD,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7B,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,EAC3B,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IAChE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAChB,QAAQ,CAAC,IAAI,EACb,UAAU,EACV,QAAQ,CAAC,SAAS,EAClB,KAAK,EACL,WAAW,EACX,QAAQ,CAAC,QAAQ,CACjB,CAAA;IACD,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAA;AAC5F,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IAClC,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QAC7B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAA;QACpE,MAAM,KAAK,CAAA;IACZ,CAAC;AACF,CAAC;AAED,SAAS,SAAS,CAAC,QAAqB;IACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAChC,IAAI,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAA;IAC3B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACtC,KAAK,MAAM,OAAO,IAAI;QACrB,UAAU;QACV,QAAQ,CAAC,SAAS;QAClB,KAAK;QACL,WAAW;QACX,QAAQ,CAAC,QAAQ;QACjB,QAAQ;QACR,WAAW;KACX,EAAE,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAChC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAA;IACvC,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3E,2EAA2E;QAC3E,IAAI,kDAAkD,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAQ;QACjF,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA;QACtD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CACd,2CAA2C,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAA;QACF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;AACnD,CAAC;AAED,SAAS,OAAO,CAAC,QAAqB,EAAE,GAAY,EAAE,QAAgB;IACrE,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC7D,CAAC;IACD,MAAM,KAAK,GAAG,GAA8B,CAAA;IAC5C,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC7E,CAAC;IACD,IACC,KAAK,CAAC,OAAO,KAAK,CAAC;QACnB,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAC3B,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QAC5B,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;QACpC,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS;QACtC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;QACpC,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG;QAC1B,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;QAC5D,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7E,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7B,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3B,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;QAClC,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;QACzE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EACnC,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAA;IAC9F,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAA;IACxE,IACC,CAAC,QAAQ;QACR,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YACjC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;YACrB,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK;QAC7B,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC;QACpD,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC3E,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC;QACjD,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAC3C,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EACzE,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IACxE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,CAAA;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,QAAqB,EAAE,QAAgB;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAA;IACnE,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;QAC3E,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,uEAAuE;QACvE,wEAAwE;QACxE,MAAM,MAAM,GACX,KAAK,YAAY,WAAW;YAC3B,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,KAAK,YAAY,KAAK;gBACvB,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,sBAAsB,CAAA;QAC3B,MAAM,IAAI,KAAK,CACd,wCAAwC,IAAI,KAAK,MAAM,mDAAmD,CAC1G,CAAA;IACF,CAAC;AACF,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,UAAU,CAAC,QAAqB;IAC/C,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IACnC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AAChE,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,QAAqB,EAAE,UAAkB;IAC3E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACnF,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC/C,IAAI,MAAM,CAAC,UAAU,KAAK,UAAU;YAAE,OAAO,MAAM,CAAA;IACpD,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,SAAS,OAAO,CACf,QAAqB,EACrB,QAA6B,EAC7B,OAA2C;IAE3C,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACpC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,MAAM,IAAI,qBAAqB,EAAE,CAAA;IAC5E,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IACzC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAChC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACzF,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAChE,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAClE,0BAA0B,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;IACnE,4EAA4E;IAC5E,gFAAgF;IAChF,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAE,MAAM,IAAI,qBAAqB,EAAE,CAAA;IAC/F,OAAO,MAAM,CAAA;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,QAAqB,EAAE,OAA6B;IACjF,IACC,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC;QAChE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7B,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,EACnC,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACtE,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACpC,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC5E,MAAM,IAAI,qBAAqB,EAAE,CAAA;IAClC,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC;QACV,QAAQ;QACR,UAAU,EAAE,UAAU,EAAE;QACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QACtC,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;KACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC5B,QAAqB,EACrB,QAAsB,EACtB,OAA+D;IAE/D,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU;QAAE,MAAM,IAAI,qBAAqB,EAAE,CAAA;IACpE,OAAO,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjD,GAAG,QAAQ;QACX,QAAQ;QACR,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI;KAClB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAC3B,QAAqB,EACrB,QAAsB,EACtB,OAAe;IAEf,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnE,MAAM,IAAI,qBAAqB,EAAE,CAAA;IAClC,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjD,GAAG,QAAQ;QACX,QAAQ;QACR,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,OAAO;KACP,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,QAAqB,EAAE,QAAsB;IAC1E,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnE,MAAM,IAAI,qBAAqB,EAAE,CAAA;IAClC,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjD,GAAG,QAAQ;QACX,QAAQ;QACR,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,OAAO,EAAE,6EAA6E;KACtF,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,MAAoB;IAChD,OAAO;QACN,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;KACvB,CAAA;AACF,CAAC"}

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