@agent-link/agent 0.1.294 → 0.1.295

package/dist/adoption-lock.d.ts

@@ -0,0 +1,14 @@
+interface AdoptionLockOwner {
+    schemaVersion: 1;
+    nonce: string;
+    pid: number;
+    createdAt: string;
+}
+export interface AdoptionLock {
+    path: string;
+    owner: AdoptionLockOwner;
+    release(): void;
+}
+export declare function getAdoptionLockPath(): string;
+export declare function acquireAdoptionLock(): AdoptionLock;
+export {};

package/dist/adoption-lock.js

@@ -0,0 +1,54 @@
+import { mkdirSync, readFileSync, rmSync, writeFileSync, } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+import { CONFIG_DIR } from './config.js';
+export function getAdoptionLockPath() {
+    return join(CONFIG_DIR, 'adoption.lock');
+}
+export function acquireAdoptionLock() {
+    const path = getAdoptionLockPath();
+    mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    try {
+        mkdirSync(path, { mode: 0o700 });
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            throw new Error(`Version-store adoption is already locked at ${path}; `
+                + 'if the owning process crashed, inspect and remove the lock locally before retrying');
+        }
+        throw error;
+    }
+    const owner = {
+        schemaVersion: 1,
+        nonce: randomUUID(),
+        pid: process.pid,
+        createdAt: new Date().toISOString(),
+    };
+    try {
+        writeFileSync(join(path, 'owner.json'), JSON.stringify(owner, null, 2) + '\n', {
+            encoding: 'utf8',
+            mode: 0o600,
+            flag: 'wx',
+        });
+    }
+    catch (error) {
+        rmSync(path, { recursive: true, force: true });
+        throw error;
+    }
+    let released = false;
+    return {
+        path,
+        owner,
+        release() {
+            if (released)
+                return;
+            const current = JSON.parse(readFileSync(join(path, 'owner.json'), 'utf8'));
+            if (current.nonce !== owner.nonce || current.pid !== owner.pid) {
+                throw new Error('Version-store adoption lock ownership changed unexpectedly');
+            }
+            rmSync(path, { recursive: true, force: true });
+            released = true;
+        },
+    };
+}
+//# sourceMappingURL=adoption-lock.js.map

package/dist/adoption-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adoption-lock.js","sourceRoot":"","sources":["../src/adoption-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,IAAI,CAAC;AACZ,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAezC,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CACb,+CAA+C,IAAI,IAAI;kBACrD,oFAAoF,CACvF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAsB;QAC/B,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,UAAU,EAAE;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;YAC7E,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,IAAI;QACJ,KAAK;QACL,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAO;YACrB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAsB,CAAC;YAChG,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,EAAE,CAAC;gBAC/D,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAChF,CAAC;YACD,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adoption.d.ts

@@ -0,0 +1,21 @@
+import { type RuntimeState } from './config.js';
+import { type RuntimeReleaseManifest } from './runtime-release.js';
+import { type VersionPointer } from './version-store.js';
+export interface AdoptionResult {
+    status: 'already-adopted' | 'completed';
+    selection: VersionPointer;
+    oldPid?: number;
+    newPid?: number;
+}
+export declare function adoptVersionStore(options: {
+    currentVersion: string;
+    manifestUrl?: string;
+    fetchImpl?: typeof fetch;
+    platform?: NodeJS.Platform;
+    arch?: string;
+    prepare?: (manifest: RuntimeReleaseManifest, manifestUrl: string) => Promise<VersionPointer>;
+    bootstrapCliPath?: string;
+    runLauncher?: (launchSpecPath: string, launcherPath: string) => void | Promise<void>;
+    restartBootstrap?: (launchSpecPath: string, bootstrapCliPath: string) => void | Promise<void>;
+    verifyReplacement?: (oldPid: number, version: string, selection: VersionPointer) => Promise<RuntimeState>;
+}): Promise<AdoptionResult>;

package/dist/adoption.js

@@ -0,0 +1,303 @@
+import { rmSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { isProcessAlive, loadRuntimeState, saveRuntimeState, } from './config.js';
+import { fetchRuntimeManifest, prepareRuntimeBundle, } from './runtime-release.js';
+import { stageRuntimeBundle } from './version-stager.js';
+import { getCurrentVersionPath, getLastKnownGoodPath, isVersionStoreAdopted, loadAdoptionState, loadCurrentVersion, loadLastKnownGood, validateVersionInstallation, writeAdoptionState, writeVersionPointer, } from './version-store.js';
+import { getStableLauncherPath, installStableLauncher, runStableLauncher, validateStableLauncher, } from './launcher-manager.js';
+import { captureServiceInstallation, installServiceLaunchSpec, isServiceInstalled, restartServiceAfterUpgrade, restoreServiceInstallation, stopServiceForUpgrade, } from './service.js';
+import { loadLaunchSpec } from './launch-spec.js';
+import { restartAgentFromLaunchSpec, snapshotUpgradeLaunchSpec, } from './upgrade-launch-spec.js';
+import { stopAgentProcess } from './process-control.js';
+import { getLocalControlStatus } from './local-control-client.js';
+import { acquireAdoptionLock } from './adoption-lock.js';
+function updateAdoption(state, phase, error) {
+    const next = {
+        ...state,
+        phase,
+        updatedAt: new Date().toISOString(),
+    };
+    if (error)
+        next.error = error;
+    else
+        delete next.error;
+    writeAdoptionState(next);
+    return next;
+}
+async function waitForAdoptedRuntime(oldPid, version, selection, timeoutMs = 20_000) {
+    const deadline = Date.now() + timeoutMs;
+    let lastError = 'runtime state was not published';
+    while (Date.now() < deadline) {
+        const runtime = loadRuntimeState();
+        if (runtime?.pid
+            && runtime.pid !== oldPid
+            && isProcessAlive(runtime.pid)
+            && runtime.controlPlane) {
+            try {
+                const status = await getLocalControlStatus(runtime, 1000);
+                if (status.pid === runtime.pid
+                    && status.version === version
+                    && status.connection.websocketConnected
+                    && status.connection.relayReady
+                    && status.connection.acceptingWork
+                    && runtime.versionStore?.active === true
+                    && runtime.versionStore.selectedVersion === version) {
+                    validateVersionInstallation(selection);
+                    await new Promise(resolve => setTimeout(resolve, 250));
+                    const confirmed = loadRuntimeState();
+                    if (confirmed?.pid !== runtime.pid || confirmed.versionStore?.selectedVersion !== version) {
+                        throw new Error('Selected runtime state was not stable after health confirmation');
+                    }
+                    return runtime;
+                }
+                lastError = `replacement status version=${status.version}, relayReady=${status.connection.relayReady}`;
+            }
+            catch (error) {
+                lastError = error.message;
+            }
+        }
+        await new Promise(resolve => setTimeout(resolve, 200));
+    }
+    throw new Error(`Version-store activation did not become healthy: ${lastError}`);
+}
+async function waitForReplacementDiscovery(oldPid, timeoutMs = 10_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const runtime = loadRuntimeState();
+        if (runtime?.pid
+            && runtime.pid !== oldPid
+            && isProcessAlive(runtime.pid)
+            && runtime.controlPlane) {
+            return runtime;
+        }
+        await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    throw new Error('Replacement Agent did not publish discoverable runtime state');
+}
+async function waitForBootstrapRuntime(oldPid, version, timeoutMs = 20_000) {
+    const deadline = Date.now() + timeoutMs;
+    let lastError = 'bootstrap runtime state was not published';
+    while (Date.now() < deadline) {
+        const runtime = loadRuntimeState();
+        if (runtime?.pid
+            && runtime.pid !== oldPid
+            && isProcessAlive(runtime.pid)
+            && runtime.controlPlane
+            && !runtime.versionStore) {
+            try {
+                const status = await getLocalControlStatus(runtime, 1000);
+                if (status.pid === runtime.pid
+                    && status.version === version
+                    && status.connection.websocketConnected
+                    && status.connection.relayReady
+                    && status.connection.acceptingWork) {
+                    await new Promise(resolve => setTimeout(resolve, 250));
+                    const confirmed = loadRuntimeState();
+                    if (confirmed?.pid !== runtime.pid || confirmed.versionStore) {
+                        throw new Error('Bootstrap runtime state was not stable after health confirmation');
+                    }
+                    return runtime;
+                }
+                lastError = `bootstrap status version=${status.version}, relayReady=${status.connection.relayReady}`;
+            }
+            catch (error) {
+                lastError = error.message;
+            }
+        }
+        await new Promise(resolve => setTimeout(resolve, 200));
+    }
+    throw new Error(`Bootstrap rollback did not become healthy: ${lastError}`);
+}
+function restorePointer(path, pointer) {
+    if (pointer)
+        writeVersionPointer(path, pointer);
+    else
+        rmSync(path, { force: true });
+}
+async function waitForProcessExit(pid, timeoutMs = 5000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!isProcessAlive(pid))
+            return true;
+        await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    return !isProcessAlive(pid);
+}
+export async function adoptVersionStore(options) {
+    const lock = acquireAdoptionLock();
+    try {
+        const previousAdoption = loadAdoptionState();
+        if (isVersionStoreAdopted() && previousAdoption) {
+            return { status: 'already-adopted', selection: previousAdoption.selection };
+        }
+        const previousCurrent = loadCurrentVersion();
+        const previousLastKnownGood = loadLastKnownGood();
+        const runtime = loadRuntimeState();
+        if (!runtime?.pid || !isProcessAlive(runtime.pid)) {
+            throw new Error('Version-store adoption requires a healthy running Agent');
+        }
+        const serviceSnapshot = isServiceInstalled()
+            ? captureServiceInstallation()
+            : null;
+        let oldAgentStopped = false;
+        let adoption = null;
+        let launchSpecPath = null;
+        let launchSpec = null;
+        let savedState = null;
+        let replacementRuntime = null;
+        let hostStopped = false;
+        let shutdownAccepted = false;
+        try {
+            const liveStatus = runtime.controlPlane
+                ? await getLocalControlStatus(runtime, 1500)
+                : null;
+            if (liveStatus && liveStatus.version !== options.currentVersion) {
+                throw new Error(`Running Agent version ${liveStatus.version} does not match bootstrap version ${options.currentVersion}`);
+            }
+            launchSpecPath = snapshotUpgradeLaunchSpec(runtime);
+            launchSpec = loadLaunchSpec(launchSpecPath);
+            const runtimeRelease = await fetchRuntimeManifest(options.currentVersion, {
+                fetchImpl: options.fetchImpl,
+                manifestUrl: options.manifestUrl,
+            });
+            const selection = options.prepare
+                ? await options.prepare(runtimeRelease.manifest, runtimeRelease.manifestUrl)
+                : stageRuntimeBundle(await prepareRuntimeBundle(runtimeRelease.manifest, {
+                    fetchImpl: options.fetchImpl,
+                    platform: options.platform,
+                    arch: options.arch,
+                }), runtimeRelease.manifestUrl);
+            validateVersionInstallation(selection);
+            const createdAt = new Date().toISOString();
+            adoption = {
+                schemaVersion: 1,
+                version: options.currentVersion,
+                phase: 'preparing',
+                selection,
+                launchSpecPath,
+                createdAt,
+                updatedAt: createdAt,
+            };
+            writeAdoptionState(adoption);
+            installStableLauncher();
+            writeVersionPointer(getLastKnownGoodPath(), selection);
+            writeVersionPointer(getCurrentVersionPath(), selection);
+            adoption = updateAdoption(adoption, 'prepared');
+            const launcherPath = validateStableLauncher();
+            if (serviceSnapshot) {
+                installServiceLaunchSpec(launchSpec, {
+                    startIfStopped: false,
+                    persistPolicy: false,
+                    launcherPath,
+                });
+            }
+            adoption = updateAdoption(adoption, 'activating');
+            savedState = { ...runtime };
+            delete savedState.pid;
+            delete savedState.processInstanceId;
+            delete savedState.controlPlane;
+            delete savedState.versionStore;
+            const stopHost = () => {
+                if (!hostStopped)
+                    hostStopped = stopServiceForUpgrade(launchSpec);
+            };
+            await stopAgentProcess(runtime, 'service', {
+                afterControlAccepted: async () => {
+                    shutdownAccepted = true;
+                    await stopHost();
+                },
+                beforeForceKill: stopHost,
+            });
+            oldAgentStopped = true;
+            saveRuntimeState(savedState);
+            if (!hostStopped || !restartServiceAfterUpgrade(launchSpec)) {
+                await (options.runLauncher ?? runStableLauncher)(launchSpecPath, getStableLauncherPath());
+            }
+            replacementRuntime = await waitForReplacementDiscovery(runtime.pid);
+            const replacement = await (options.verifyReplacement ?? waitForAdoptedRuntime)(runtime.pid, options.currentVersion, selection);
+            updateAdoption(adoption, 'completed');
+            return {
+                status: 'completed',
+                selection,
+                oldPid: runtime.pid,
+                newPid: replacement.pid,
+            };
+        }
+        catch (error) {
+            if (adoption)
+                updateAdoption(adoption, 'failed', error.message);
+            const rollbackErrors = [];
+            const recordRollbackError = (rollback) => {
+                const next = rollback;
+                rollbackErrors.push(next.message);
+            };
+            const current = replacementRuntime ?? loadRuntimeState();
+            if (current?.pid && current.pid !== runtime.pid && isProcessAlive(current.pid)) {
+                try {
+                    let replacementHostStopped = false;
+                    const stopReplacementHost = () => {
+                        if (!replacementHostStopped && launchSpec) {
+                            replacementHostStopped = stopServiceForUpgrade(launchSpec);
+                        }
+                    };
+                    await stopAgentProcess(current, 'service', {
+                        afterControlAccepted: stopReplacementHost,
+                        beforeForceKill: stopReplacementHost,
+                    });
+                    oldAgentStopped = true;
+                }
+                catch (stopError) {
+                    recordRollbackError(stopError);
+                }
+            }
+            try {
+                restorePointer(getCurrentVersionPath(), previousCurrent);
+                restorePointer(getLastKnownGoodPath(), previousLastKnownGood);
+                if (serviceSnapshot)
+                    restoreServiceInstallation(serviceSnapshot);
+            }
+            catch (restoreError) {
+                recordRollbackError(restoreError);
+            }
+            if (!oldAgentStopped && shutdownAccepted) {
+                oldAgentStopped = await waitForProcessExit(runtime.pid);
+                if (!oldAgentStopped) {
+                    recordRollbackError(new Error('Old Agent did not exit after accepting adoption shutdown'));
+                }
+            }
+            const active = loadRuntimeState();
+            const replacementStillAlive = !!(replacementRuntime?.pid
+                && isProcessAlive(replacementRuntime.pid));
+            if (oldAgentStopped
+                && !replacementStillAlive
+                && (!active?.pid || !isProcessAlive(active.pid))) {
+                try {
+                    if (savedState)
+                        saveRuntimeState(savedState);
+                    if (!serviceSnapshot || !launchSpec || !restartServiceAfterUpgrade(launchSpec)) {
+                        await (options.restartBootstrap ?? restartAgentFromLaunchSpec)(launchSpecPath, options.bootstrapCliPath ?? fileURLToPath(new URL('./cli.js', import.meta.url)));
+                    }
+                    const bootstrapRuntime = await waitForBootstrapRuntime(runtime.pid, options.currentVersion);
+                    // Persist the exact verified process identity last so a delayed stale
+                    // runtime write from the failed replacement cannot win the rollback.
+                    saveRuntimeState(bootstrapRuntime);
+                }
+                catch (restartError) {
+                    recordRollbackError(restartError);
+                }
+            }
+            const rollbackMessage = rollbackErrors.join('; ');
+            if (rollbackMessage && adoption) {
+                updateAdoption(adoption, 'failed', `${error.message}; bootstrap rollback failed: ${rollbackMessage}`);
+            }
+            if (rollbackMessage) {
+                throw new Error(`${error.message}; bootstrap rollback failed: ${rollbackMessage}`);
+            }
+            throw error;
+        }
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=adoption.js.map

package/dist/adoption.js.map

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

package/dist/bootstrap-delegator.d.ts

@@ -0,0 +1,7 @@
+export interface SelectedCli {
+    entry: string;
+    version: string;
+}
+export declare function createDelegationEnvironment(selected: SelectedCli, environment?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function resolveSelectedCliForDelegation(currentCliPath: string, args: string[]): SelectedCli | null;
+export declare function delegateToSelectedCli(selected: SelectedCli, args: string[]): never;

package/dist/bootstrap-delegator.js

@@ -0,0 +1,36 @@
+import { spawnSync } from 'child_process';
+import { resolve } from 'path';
+import { isVersionStoreAdopted, loadCurrentVersion, validateVersionInstallation, } from './version-store.js';
+const BOOTSTRAP_COMMANDS = new Set(['version-store']);
+export function createDelegationEnvironment(selected, environment = process.env) {
+    return {
+        ...environment,
+        AGENTLINK_VERSION_STORE_ACTIVE: '1',
+        AGENTLINK_SELECTED_VERSION: selected.version,
+    };
+}
+export function resolveSelectedCliForDelegation(currentCliPath, args) {
+    if (args[0] && BOOTSTRAP_COMMANDS.has(args[0]))
+        return null;
+    if (!isVersionStoreAdopted())
+        return null;
+    const pointer = loadCurrentVersion();
+    if (!pointer)
+        return null;
+    validateVersionInstallation(pointer);
+    const selected = resolve(pointer.entry);
+    return selected === resolve(currentCliPath)
+        ? null
+        : { entry: selected, version: pointer.version };
+}
+export function delegateToSelectedCli(selected, args) {
+    const result = spawnSync(process.execPath, [selected.entry, ...args], {
+        stdio: 'inherit',
+        windowsHide: true,
+        env: createDelegationEnvironment(selected),
+    });
+    if (result.error)
+        throw result.error;
+    process.exit(result.status ?? 1);
+}
+//# sourceMappingURL=bootstrap-delegator.js.map

package/dist/bootstrap-delegator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-delegator.js","sourceRoot":"","sources":["../src/bootstrap-delegator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;AAOtD,MAAM,UAAU,2BAA2B,CACzC,QAAqB,EACrB,cAAiC,OAAO,CAAC,GAAG;IAE5C,OAAO;QACL,GAAG,WAAW;QACd,8BAA8B,EAAE,GAAG;QACnC,0BAA0B,EAAE,QAAQ,CAAC,OAAO;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,cAAsB,EACtB,IAAc;IAEd,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,CAAC,qBAAqB,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC;QACzC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAqB,EACrB,IAAc;IAEd,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE;QACpE,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,IAAI;QACjB,GAAG,EAAE,2BAA2B,CAAC,QAAQ,CAAC;KAC3C,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK;QAAE,MAAM,MAAM,CAAC,KAAK,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { resolveConfig, loadConfig, saveConfig, getConfigPath, loadRuntimeState, saveRuntimeState, clearRuntimeState, clearRuntimePid, getLogDir, getLogDate, cleanOldLogs, killProcess, isProcessAlive, writePidFile, } from './config.js';
+import { resolveConfig, loadConfig, saveConfig, getConfigPath, loadRuntimeState, saveRuntimeState, clearRuntimeState, clearRuntimePid, getLogDir, getLogDate, cleanOldLogs, killProcess, forceKillProcess, isProcessAlive, writePidFile, } from './config.js';
 import { isServiceInstalled, restartServiceAfterUpgrade, serviceInstall, serviceUninstall, stopServiceForUpgrade, } from './service.js';
 import { acquireEntraToken } from './entra.js';
 import { assertKnownBackendType } from './backends/index.js';
@@ -14,15 +14,24 @@ import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
 import { fetchEmergencyManifest, prepareEmergencyUpgrade, } from './emergency-upgrade.js';
 import { installVerifiedPackage } from './package-installer.js';
-import { buildLaunchSpecDaemonArgs, isFreshDaemonRuntime, loadStartLaunchSpec, } from './start-launch-spec.js';
+import { buildLaunchSpecDaemonArgs, cleanupFailedDaemonStart, isFreshDaemonRuntime, loadStartLaunchSpec, } from './start-launch-spec.js';
 import { restartAgentFromLaunchSpec, snapshotUpgradeLaunchSpec, } from './upgrade-launch-spec.js';
 import { applyAutoStartPolicyAfterHealth, applyAutoStartPolicyFromRuntime, } from './auto-start.js';
 import { getLocalControlStatus } from './local-control-client.js';
 import { stopAgentProcess } from './process-control.js';
 import { createUpgradeJob, updateUpgradeJob, } from './upgrade-job.js';
+import { delegateToSelectedCli, resolveSelectedCliForDelegation, } from './bootstrap-delegator.js';
+import { runSelfCheck } from './self-check.js';
+import { adoptVersionStore } from './adoption.js';
+import { isVersionStoreAdopted, loadAdoptionState, loadCurrentVersion, loadLastKnownGood, validateVersionInstallation, } from './version-store.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
 const qrcode = require('qrcode-terminal');
+const currentCliPath = fileURLToPath(import.meta.url);
+const delegatedCli = resolveSelectedCliForDelegation(currentCliPath, process.argv.slice(2));
+if (delegatedCli) {
+    delegateToSelectedCli(delegatedCli, process.argv.slice(2));
+}
 /** Highlight a URL with bold + underline ANSI codes if stdout supports color. */
 function highlightUrl(url) {
     if (!process.stdout.isTTY)
@@ -127,6 +136,74 @@ program
     .name('agentlink-client')
     .description('Local agent that proxies a working directory to a cloud web interface')
     .version(pkg.version);
+program
+    .command('self-check')
+    .description('Validate a staged Agent runtime without mutating local state')
+    .option('--expected-version <version>', 'Expected package version')
+    .option('--launch-spec <path>', 'LaunchSpec to validate')
+    .action((options) => {
+    try {
+        const result = runSelfCheck({
+            expectedVersion: options.expectedVersion,
+            launchSpecPath: options.launchSpec,
+        });
+        console.log(JSON.stringify(result));
+    }
+    catch (error) {
+        console.error(`Self-check failed: ${error.message}`);
+        process.exitCode = 1;
+    }
+});
+const versionStoreCmd = program
+    .command('version-store')
+    .description('Manage the immutable Agent version store');
+versionStoreCmd
+    .command('status')
+    .description('Show version-store adoption and selection status')
+    .action(() => {
+    try {
+        const adoption = loadAdoptionState();
+        const current = loadCurrentVersion();
+        const lastKnownGood = loadLastKnownGood();
+        if (current)
+            validateVersionInstallation(current);
+        if (lastKnownGood)
+            validateVersionInstallation(lastKnownGood);
+        console.log(`Adopted:          ${isVersionStoreAdopted() ? 'yes' : 'no'}`);
+        console.log(`Adoption phase:   ${adoption?.phase ?? '(not started)'}`);
+        console.log(`Current version:  ${current?.version ?? '(none)'}`);
+        console.log(`Last known good:  ${lastKnownGood?.version ?? '(none)'}`);
+    }
+    catch (error) {
+        console.error(`Version store is unhealthy: ${error.message}`);
+        process.exitCode = 1;
+    }
+});
+versionStoreCmd
+    .command('adopt')
+    .description('Stage the current Agent into the immutable version store and activate the launcher')
+    .option('--runtime-manifest <url>', 'Loopback runtime manifest override for local simulation')
+    .action(async (options) => {
+    if (process.env.AGENTLINK_PID) {
+        console.error('ERROR: Run version-store adoption from a separate local terminal.');
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const result = await adoptVersionStore({
+            currentVersion: pkg.version,
+            manifestUrl: options.runtimeManifest,
+        });
+        console.log(result.status === 'already-adopted'
+            ? `Version store is already adopted at ${result.selection.version}.`
+            : `Version store adoption completed at ${result.selection.version}.`);
+    }
+    catch (error) {
+        console.error(`Version-store adoption failed: ${error.message}`);
+        process.exitCode = 1;
+    }
+});
+versionStoreCmd.action(() => versionStoreCmd.help());
 program
     .command('start')
     .description('Start the local agent and connect to cloud relay')
@@ -381,6 +458,7 @@ program
                 }
             }
             else {
+                await cleanupFailedDaemonStart(child.pid, isProcessAlive, killProcess, forceKillProcess);
                 console.error('Agent may have failed to start. Check logs:');
                 console.error(`  ${errFile}`);
                 // Still write pid-file with PID so caller can clean up
@@ -419,6 +497,7 @@ program
                 }
             }
             else {
+                await cleanupFailedDaemonStart(child.pid, isProcessAlive, killProcess, forceKillProcess);
                 console.error('Agent may have failed to start. Check logs:');
                 console.error(`  ${errFile}`);
                 process.exit(1);
@@ -520,7 +599,11 @@ program
     }
     else if (!agentState.pid || !isProcessAlive(agentState.pid)) {
         console.log('Agent:  not running (stale state)');
-        clearRuntimePid();
+        if (agentState.pid) {
+            clearRuntimePid(agentState.processInstanceId
+                ? { pid: agentState.pid, processInstanceId: agentState.processInstanceId }
+                : agentState.pid);
+        }
     }
     else {
         const config = loadConfig();