@agent-link/agent 0.1.289 → 0.1.292

package/dist/index.js

@@ -10,8 +10,11 @@ export function enableLogTimestamps() {
 if (!process.stdout.isTTY)
     enableLogTimestamps();
 import { saveRuntimeState, clearRuntimePid, writePidFile, encodeBase64Url } from './config.js';
-import { connect, disconnect, getE2EKey } from './connection.js';
+import { beginShutdown, connect, disconnect, getConnectionStatus, getE2EKey, sendAndFlush, } from './connection.js';
 import { shutdownScheduler } from './scheduler.js';
+import { createLocalControlService } from './local-control.js';
+import { startLocalControlServer } from './local-control-http.js';
+import { createShutdownCoordinator } from './shutdown-coordinator.js';
 const require = createRequire(import.meta.url);
 const qrcode = require('qrcode-terminal');
 /** Highlight a URL with bold + underline ANSI codes if stdout supports color. */
@@ -34,7 +37,40 @@ export async function start(config, daemon = false, pidFile, launchSpecPath, lau
         const e2eKey = getE2EKey();
         const e2eFragment = e2eKey ? `#/?k=${encodeBase64Url(e2eKey)}` : '';
         const sessionUrl = `${httpBase}/${config.entra ? 'ms' : 's'}/${sessionId}${e2eFragment}`;
-        // Persist runtime state so `agentlink status` can read it
+        const startedAt = new Date().toISOString();
+        let controlServer = null;
+        const shutdownCoordinator = createShutdownCoordinator({
+            markShuttingDown: () => beginShutdown(),
+            steps: [
+                {
+                    name: 'notify-web',
+                    run: async (request) => {
+                        await sendAndFlush({
+                            type: request.reason === 'upgrade' ? 'agent_upgrading' : 'agent_stopping',
+                            reason: request.reason,
+                            requestId: request.requestId,
+                            jobId: request.jobId,
+                            targetVersion: request.targetVersion,
+                        });
+                    },
+                },
+                { name: 'scheduler', run: () => shutdownScheduler() },
+                { name: 'connection-resources', run: () => disconnect() },
+                { name: 'control-plane', run: () => controlServer?.close() },
+                { name: 'runtime-state', run: () => clearRuntimePid() },
+            ],
+            exit: (code) => process.exit(code),
+        });
+        const controlService = createLocalControlService({
+            version: require('../package.json').version,
+            startedAt,
+            config,
+            getConnectionStatus,
+            getShutdownStatus: () => shutdownCoordinator.status(),
+            requestShutdown: (request) => shutdownCoordinator.request(request),
+        });
+        controlServer = await startLocalControlServer(controlService);
+        // Persist runtime state so `agentlink status` can discover the exact process.
         saveRuntimeState({
             pid: process.pid,
             sessionId,
@@ -42,10 +78,11 @@ export async function start(config, daemon = false, pidFile, launchSpecPath, lau
             server: config.server,
             name: config.name,
             dir: config.dir,
-            startedAt: new Date().toISOString(),
+            startedAt,
             agent: config.agent,
             launchSpecPath,
             launchSpecDigest,
+            controlPlane: controlServer.discovery,
         });
         console.log('');
         console.log(`[AgentLink] Session URL: ${highlightUrl(sessionUrl)}`);
@@ -58,15 +95,22 @@ export async function start(config, daemon = false, pidFile, launchSpecPath, lau
             writePidFile(pidFile, { pid: process.pid, sessionUrl, password: config.password });
         }
         // Keep process alive, handle graceful shutdown
-        const shutdown = () => {
+        const shutdown = (signal) => {
             console.log('\n[AgentLink] Shutting down...');
-            shutdownScheduler();
-            clearRuntimePid();
-            disconnect();
-            process.exit(0);
+            if (shutdownCoordinator.status().phase !== 'idle')
+                return;
+            try {
+                shutdownCoordinator.request({
+                    reason: 'service',
+                    requestId: `signal-${signal}-${Date.now()}`,
+                });
+            }
+            catch (error) {
+                console.error('[AgentLink] Failed to schedule shutdown:', error);
+            }
         };
-        process.on('SIGINT', shutdown);
-        process.on('SIGTERM', shutdown);
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
     }
     catch (err) {
         const msg = err.message || String(err);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC,oFAAoF;AACpF,MAAM,UAAU,mBAAmB;IACjC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAU,EAAE,CAAC;QACjH,MAAM,IAAI,GAAI,OAAe,CAAC,MAAM,CAAC,CAAC;QACrC,OAAe,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3G,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;IAAE,mBAAmB,EAAE,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EACL,aAAa,EACb,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAwB,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAA2B,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE1C,iFAAiF;AACjF,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACtC,OAAO,eAAe,GAAG,SAAS,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,MAAmB,EACnB,MAAM,GAAG,KAAK,EACd,OAAgB,EAChB,cAAuB,EACvB,gBAAyB;IAEzB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,kCAAkC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtD,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM;SAC3B,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;SAC1B,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,UAAU,GAAG,GAAG,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,GAAG,WAAW,EAAE,CAAC;QAEzF,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,aAAa,GAA8B,IAAI,CAAC;QACpD,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;YACpD,gBAAgB,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;YACvC,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,YAAY;oBAClB,GAAG,EAAE,KAAK,EAAE,OAAwB,EAAE,EAAE;wBACtC,MAAM,YAAY,CAAC;4BACjB,IAAI,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB;4BACzE,MAAM,EAAE,OAAO,CAAC,MAAM;4BACtB,SAAS,EAAE,OAAO,CAAC,SAAS;4BAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;4BACpB,aAAa,EAAE,OAAO,CAAC,aAAa;yBACrC,CAAC,CAAC;oBACL,CAAC;iBACF;gBACD,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,EAAE;gBACrD,EAAE,IAAI,EAAE,sBAAsB,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE;gBACzD,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE;gBAC5D,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,EAAE;aACxD;YACD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;SACnC,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,yBAAyB,CAAC;YAC/C,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO;YAC3C,SAAS;YACT,MAAM;YACN,mBAAmB;YACnB,iBAAiB,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE;YACrD,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC;SACnE,CAAC,CAAC;QACH,aAAa,GAAG,MAAM,uBAAuB,CAAC,cAAc,CAAC,CAAC;QAE9D,8EAA8E;QAC9E,gBAAgB,CAAC;YACf,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS;YACT,UAAU;YACV,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,SAAS;YACT,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,cAAc;YACd,gBAAgB;YAChB,YAAY,EAAE,aAAa,CAAC,SAAS;SACtC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,4BAA4B,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAY,EAAE,EAAE;YAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QAEtD,oDAAoD;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE;YAClC,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;YAC9C,IAAI,mBAAmB,CAAC,MAAM,EAAE,CAAC,KAAK,KAAK,MAAM;gBAAE,OAAO;YAC1D,IAAI,CAAC;gBACH,mBAAmB,CAAC,OAAO,CAAC;oBAC1B,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,UAAU,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;iBAC5C,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;YACnE,CAAC;QACH,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,8CAA8C,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAE7E,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACxE,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACjF,OAAO,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,OAAO,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACrF,CAAC;aAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACpE,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC7F,CAAC;aAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACxE,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/local-control-client.d.ts

@@ -0,0 +1,15 @@
+import type { RuntimeState } from './config.js';
+import type { LocalControlStatus, ShutdownAccepted, ShutdownReason } from './local-control.js';
+export declare class LocalControlUnavailableError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class LocalControlResponseError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export declare function getLocalControlStatus(state: RuntimeState, timeoutMs?: number): Promise<LocalControlStatus>;
+export declare function requestLocalControlShutdown(state: RuntimeState, reason: ShutdownReason, options?: {
+    jobId?: string;
+    targetVersion?: string;
+}, timeoutMs?: number): Promise<ShutdownAccepted>;

package/dist/local-control-client.js

@@ -0,0 +1,100 @@
+import { request as httpRequest } from 'http';
+import { randomUUID } from 'crypto';
+export class LocalControlUnavailableError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'LocalControlUnavailableError';
+    }
+}
+export class LocalControlResponseError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'LocalControlResponseError';
+    }
+}
+async function callControl(state, method, path, body, timeoutMs = 1500) {
+    const discovery = state.controlPlane;
+    if (!discovery || discovery.apiVersion !== 1 || discovery.host !== '127.0.0.1') {
+        throw new LocalControlUnavailableError('Agent does not advertise Local Control Plane v1');
+    }
+    if (!Number.isSafeInteger(discovery.port) || discovery.port < 1 || discovery.port > 65535 || !discovery.token) {
+        throw new LocalControlUnavailableError('Agent local control discovery is invalid');
+    }
+    const requestId = randomUUID();
+    const payload = body ? JSON.stringify({ ...body, requestId }) : undefined;
+    return new Promise((resolve, reject) => {
+        const request = httpRequest({
+            host: discovery.host,
+            port: discovery.port,
+            path,
+            method,
+            headers: {
+                Host: `${discovery.host}:${discovery.port}`,
+                Authorization: `Bearer ${discovery.token}`,
+                'X-Request-Id': requestId,
+                ...(payload ? {
+                    'Content-Type': 'application/json',
+                    'Content-Length': Buffer.byteLength(payload),
+                    'Idempotency-Key': requestId,
+                } : {}),
+            },
+        }, (response) => {
+            const chunks = [];
+            let size = 0;
+            response.on('data', (chunk) => {
+                size += chunk.length;
+                if (size > 64 * 1024) {
+                    request.destroy(new Error('Local control response exceeded 64 KiB'));
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            response.on('end', () => {
+                let envelope;
+                try {
+                    envelope = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+                }
+                catch (error) {
+                    reject(new LocalControlResponseError(502, 'INVALID_RESPONSE', 'Local control returned invalid JSON'));
+                    return;
+                }
+                if (!response.statusCode || response.statusCode < 200 || response.statusCode >= 300 || !envelope.ok) {
+                    reject(new LocalControlResponseError(response.statusCode ?? 500, envelope.error?.code ?? 'CONTROL_ERROR', envelope.error?.message ?? 'Local control request failed'));
+                    return;
+                }
+                if (envelope.data === undefined) {
+                    reject(new LocalControlResponseError(502, 'INVALID_RESPONSE', 'Local control response did not include data'));
+                    return;
+                }
+                resolve(envelope.data);
+            });
+        });
+        request.setTimeout(timeoutMs, () => {
+            request.destroy(new Error(`Local control request timed out after ${timeoutMs}ms`));
+        });
+        request.on('error', (error) => {
+            reject(new LocalControlUnavailableError(`Local control is unavailable: ${error.message}`, { cause: error }));
+        });
+        if (payload)
+            request.write(payload);
+        request.end();
+    });
+}
+export function getLocalControlStatus(state, timeoutMs) {
+    return callControl(state, 'GET', '/v1/status', undefined, timeoutMs);
+}
+export function requestLocalControlShutdown(state, reason, options = {}, timeoutMs) {
+    if (!state.controlPlane?.capabilities.includes('lifecycle.shutdown')) {
+        throw new LocalControlUnavailableError('Agent does not advertise lifecycle.shutdown');
+    }
+    return callControl(state, 'POST', '/v1/lifecycle/shutdown', {
+        reason,
+        expectedPid: state.pid,
+        ...options,
+    }, timeoutMs);
+}
+//# sourceMappingURL=local-control-client.js.map

package/dist/local-control-client.js.map

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

package/dist/local-control-http.d.ts

@@ -0,0 +1,7 @@
+import { type LocalControlService } from './local-control.js';
+import type { ControlPlaneDiscovery } from './config.js';
+export interface LocalControlServer {
+    discovery: ControlPlaneDiscovery;
+    close(): Promise<void>;
+}
+export declare function startLocalControlServer(service: LocalControlService): Promise<LocalControlServer>;

package/dist/local-control-http.js

@@ -0,0 +1,208 @@
+import { createServer } from 'http';
+import { randomBytes, randomUUID, timingSafeEqual } from 'crypto';
+import { LOCAL_CONTROL_API_VERSION, LocalControlError, } from './local-control.js';
+const HOST = '127.0.0.1';
+const MAX_BODY_BYTES = 16 * 1024;
+const MAX_AUTH_FAILURES_PER_MINUTE = 30;
+const VALID_REASONS = new Set(['upgrade', 'stop', 'service']);
+function writeJson(response, status, envelope) {
+    const payload = JSON.stringify(envelope);
+    response.writeHead(status, {
+        'Content-Type': 'application/json; charset=utf-8',
+        'Content-Length': Buffer.byteLength(payload),
+        'Cache-Control': 'no-store',
+        'X-Content-Type-Options': 'nosniff',
+    });
+    response.end(payload);
+}
+function safeTokenEqual(actual, expected) {
+    const actualBuffer = Buffer.from(actual);
+    const expectedBuffer = Buffer.from(expected);
+    return actualBuffer.length === expectedBuffer.length
+        && timingSafeEqual(actualBuffer, expectedBuffer);
+}
+function isAllowedHost(host, port) {
+    if (!host)
+        return false;
+    const normalized = host.toLowerCase();
+    return normalized === HOST
+        || normalized === 'localhost'
+        || normalized === `${HOST}:${port}`
+        || normalized === `localhost:${port}`;
+}
+async function readJsonBody(request) {
+    const contentType = request.headers['content-type'] ?? '';
+    if (!contentType.toLowerCase().startsWith('application/json')) {
+        throw new LocalControlError(415, 'UNSUPPORTED_MEDIA_TYPE', 'Content-Type must be application/json');
+    }
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buffer.length;
+        if (size > MAX_BODY_BYTES) {
+            throw new LocalControlError(413, 'BODY_TOO_LARGE', `Request body exceeds ${MAX_BODY_BYTES} bytes`);
+        }
+        chunks.push(buffer);
+    }
+    try {
+        return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    }
+    catch {
+        throw new LocalControlError(400, 'INVALID_JSON', 'Request body must contain valid JSON');
+    }
+}
+function parseShutdownRequest(value, headerRequestId) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new LocalControlError(400, 'INVALID_REQUEST', 'Shutdown request must be a JSON object');
+    }
+    const body = value;
+    const allowedKeys = new Set(['reason', 'requestId', 'expectedPid', 'jobId', 'targetVersion']);
+    const unknownKey = Object.keys(body).find((key) => !allowedKeys.has(key));
+    if (unknownKey) {
+        throw new LocalControlError(400, 'UNKNOWN_FIELD', `Unknown shutdown field: ${unknownKey}`);
+    }
+    if (typeof body.reason !== 'string' || !VALID_REASONS.has(body.reason)) {
+        throw new LocalControlError(400, 'INVALID_REASON', 'reason must be upgrade, stop, or service');
+    }
+    const requestId = body.requestId ?? headerRequestId;
+    if (typeof requestId !== 'string' || requestId.length < 1 || requestId.length > 128) {
+        throw new LocalControlError(400, 'INVALID_REQUEST_ID', 'requestId must be a non-empty string up to 128 characters');
+    }
+    if (body.expectedPid !== undefined
+        && (!Number.isSafeInteger(body.expectedPid) || body.expectedPid <= 0)) {
+        throw new LocalControlError(400, 'INVALID_EXPECTED_PID', 'expectedPid must be a positive integer');
+    }
+    for (const field of ['jobId', 'targetVersion']) {
+        if (body[field] !== undefined
+            && (typeof body[field] !== 'string' || body[field].length < 1 || body[field].length > 128)) {
+            throw new LocalControlError(400, 'INVALID_REQUEST', `${field} must be a non-empty string up to 128 characters`);
+        }
+    }
+    return {
+        reason: body.reason,
+        requestId,
+        expectedPid: body.expectedPid,
+        jobId: body.jobId,
+        targetVersion: body.targetVersion,
+    };
+}
+function getRequestId(request) {
+    const idempotencyKey = request.headers['idempotency-key'];
+    const headerRequestId = request.headers['x-request-id'];
+    const candidate = Array.isArray(idempotencyKey) ? idempotencyKey[0] : idempotencyKey
+        ?? (Array.isArray(headerRequestId) ? headerRequestId[0] : headerRequestId);
+    return typeof candidate === 'string' && candidate.length > 0 && candidate.length <= 128
+        ? candidate
+        : randomUUID();
+}
+export async function startLocalControlServer(service) {
+    const token = randomBytes(32).toString('base64url');
+    const sockets = new Set();
+    let authWindowStartedAt = Date.now();
+    let authFailures = 0;
+    let port = 0;
+    const server = createServer(async (request, response) => {
+        const requestId = getRequestId(request);
+        try {
+            if (!isAllowedHost(request.headers.host, port)) {
+                throw new LocalControlError(400, 'INVALID_HOST', 'Host header must target the local control endpoint');
+            }
+            if (request.headers.origin !== undefined) {
+                throw new LocalControlError(403, 'BROWSER_REQUEST_REJECTED', 'Browser-originated requests are not allowed');
+            }
+            if (request.method === 'OPTIONS') {
+                throw new LocalControlError(405, 'METHOD_NOT_ALLOWED', 'CORS preflight is not supported');
+            }
+            if (Date.now() - authWindowStartedAt >= 60_000) {
+                authWindowStartedAt = Date.now();
+                authFailures = 0;
+            }
+            const authorization = request.headers.authorization ?? '';
+            const suppliedToken = authorization.startsWith('Bearer ') ? authorization.slice(7) : '';
+            if (!safeTokenEqual(suppliedToken, token)) {
+                authFailures++;
+                if (authFailures > MAX_AUTH_FAILURES_PER_MINUTE) {
+                    throw new LocalControlError(429, 'AUTH_RATE_LIMITED', 'Too many authentication failures');
+                }
+                throw new LocalControlError(401, 'UNAUTHORIZED', 'A valid bearer token is required');
+            }
+            if (request.method === 'GET' && request.url === '/v1/health') {
+                writeJson(response, 200, { ok: true, requestId, data: service.health() });
+                return;
+            }
+            if (request.method === 'GET' && request.url === '/v1/status') {
+                writeJson(response, 200, { ok: true, requestId, data: service.status() });
+                return;
+            }
+            if (request.method === 'POST' && request.url === '/v1/lifecycle/shutdown') {
+                const body = await readJsonBody(request);
+                const shutdownRequest = parseShutdownRequest(body, requestId);
+                const accepted = service.shutdown(shutdownRequest);
+                writeJson(response, 202, { ok: true, requestId: shutdownRequest.requestId, data: accepted });
+                return;
+            }
+            throw new LocalControlError(404, 'NOT_FOUND', 'Unknown local control route');
+        }
+        catch (error) {
+            const controlError = error instanceof LocalControlError
+                ? error
+                : new LocalControlError(500, 'INTERNAL_ERROR', 'Local control request failed');
+            console.warn(`[Control] ${request.method} ${request.url} -> ${controlError.status} ${controlError.code} (requestId=${requestId})`);
+            if (!response.headersSent) {
+                writeJson(response, controlError.status, {
+                    ok: false,
+                    requestId,
+                    error: { code: controlError.code, message: controlError.message },
+                });
+            }
+            else {
+                response.destroy();
+            }
+        }
+    });
+    server.on('connection', (socket) => {
+        sockets.add(socket);
+        socket.on('close', () => sockets.delete(socket));
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(0, HOST, () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    if (!address || typeof address === 'string') {
+        await new Promise((resolve) => server.close(() => resolve()));
+        throw new Error('Local control server did not receive a TCP address');
+    }
+    port = address.port;
+    return {
+        discovery: {
+            apiVersion: LOCAL_CONTROL_API_VERSION,
+            host: HOST,
+            port,
+            token,
+            capabilities: [...service.health().capabilities],
+        },
+        async close() {
+            if (!server.listening)
+                return;
+            await new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    for (const socket of sockets)
+                        socket.destroy();
+                    resolve();
+                }, 1000);
+                timer.unref();
+                server.close(() => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+                server.closeIdleConnections?.();
+            });
+        },
+    };
+}
+//# sourceMappingURL=local-control-http.js.map

package/dist/local-control-http.js.map

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

package/dist/local-control.d.ts

@@ -0,0 +1,74 @@
+import type { AgentConfig } from './config.js';
+export declare const LOCAL_CONTROL_API_VERSION = 1;
+export declare const LOCAL_CONTROL_CAPABILITIES: readonly ["health.read", "status.read", "lifecycle.shutdown"];
+export type LocalControlCapability = typeof LOCAL_CONTROL_CAPABILITIES[number];
+export type ShutdownReason = 'upgrade' | 'stop' | 'service';
+export type ShutdownPhase = 'idle' | 'accepted' | 'shutting-down' | 'completed' | 'failed';
+export interface ShutdownRequest {
+    reason: ShutdownReason;
+    requestId: string;
+    expectedPid?: number;
+    jobId?: string;
+    targetVersion?: string;
+}
+export interface ShutdownAccepted {
+    requestId: string;
+    reason: ShutdownReason;
+    acceptedAt: string;
+    phase: ShutdownPhase;
+}
+export interface ConnectionStatus {
+    websocketConnected: boolean;
+    relayReady: boolean;
+    acceptingWork: boolean;
+    sessionId: string | null;
+    workDir: string;
+    backend: string;
+    conversations: number;
+}
+export interface LocalControlStatus {
+    apiVersion: number;
+    capabilities: readonly LocalControlCapability[];
+    pid: number;
+    version: string;
+    startedAt: string;
+    uptimeSeconds: number;
+    shutdown: {
+        phase: ShutdownPhase;
+        requestId?: string;
+        reason?: ShutdownReason;
+    };
+    connection: ConnectionStatus;
+    config: {
+        server: string;
+        dir: string;
+        name: string;
+        agent: string;
+        entra: boolean;
+        autoStart: boolean | null;
+        passwordConfigured: boolean;
+    };
+}
+export declare class LocalControlError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface LocalControlService {
+    health(): {
+        status: 'ok';
+        apiVersion: number;
+        capabilities: readonly LocalControlCapability[];
+    };
+    status(): LocalControlStatus;
+    shutdown(request: ShutdownRequest): ShutdownAccepted;
+}
+export interface LocalControlServiceDeps {
+    version: string;
+    startedAt: string;
+    config: AgentConfig;
+    getConnectionStatus: () => ConnectionStatus;
+    getShutdownStatus: () => LocalControlStatus['shutdown'];
+    requestShutdown: (request: ShutdownRequest) => ShutdownAccepted;
+}
+export declare function createLocalControlService(deps: LocalControlServiceDeps): LocalControlService;

package/dist/local-control.js

@@ -0,0 +1,55 @@
+export const LOCAL_CONTROL_API_VERSION = 1;
+export const LOCAL_CONTROL_CAPABILITIES = [
+    'health.read',
+    'status.read',
+    'lifecycle.shutdown',
+];
+export class LocalControlError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'LocalControlError';
+    }
+}
+export function createLocalControlService(deps) {
+    return {
+        health() {
+            return {
+                status: 'ok',
+                apiVersion: LOCAL_CONTROL_API_VERSION,
+                capabilities: LOCAL_CONTROL_CAPABILITIES,
+            };
+        },
+        status() {
+            return {
+                apiVersion: LOCAL_CONTROL_API_VERSION,
+                capabilities: LOCAL_CONTROL_CAPABILITIES,
+                pid: process.pid,
+                version: deps.version,
+                startedAt: deps.startedAt,
+                uptimeSeconds: Math.max(0, Math.floor(process.uptime())),
+                shutdown: deps.getShutdownStatus(),
+                connection: deps.getConnectionStatus(),
+                config: {
+                    server: deps.config.server,
+                    dir: deps.config.dir,
+                    name: deps.config.name,
+                    agent: deps.config.agent ?? 'claude',
+                    entra: deps.config.entra === true,
+                    autoStart: deps.config.autoStart ?? null,
+                    passwordConfigured: Boolean(deps.config.password),
+                },
+            };
+        },
+        shutdown(request) {
+            if (request.expectedPid !== undefined && request.expectedPid !== process.pid) {
+                throw new LocalControlError(409, 'PID_MISMATCH', `Control request expected PID ${request.expectedPid}, but agent PID is ${process.pid}`);
+            }
+            return deps.requestShutdown(request);
+        },
+    };
+}
+//# sourceMappingURL=local-control.js.map

package/dist/local-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-control.js","sourceRoot":"","sources":["../src/local-control.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,aAAa;IACb,aAAa;IACb,oBAAoB;CACZ,CAAC;AAuDX,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAExB;IACA;IAFlB,YACkB,MAAc,EACd,IAAY,EAC5B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QAI5B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAiBD,MAAM,UAAU,yBAAyB,CAAC,IAA6B;IACrE,OAAO;QACL,MAAM;YACJ,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,yBAAyB;gBACrC,YAAY,EAAE,0BAA0B;aACzC,CAAC;QACJ,CAAC;QAED,MAAM;YACJ,OAAO;gBACL,UAAU,EAAE,yBAAyB;gBACrC,YAAY,EAAE,0BAA0B;gBACxC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACxD,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE;gBAClC,UAAU,EAAE,IAAI,CAAC,mBAAmB,EAAE;gBACtC,MAAM,EAAE;oBACN,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;oBACpB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;oBACtB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,QAAQ;oBACpC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;oBACjC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI;oBACxC,kBAAkB,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;iBAClD;aACF,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,OAAO;YACd,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC7E,MAAM,IAAI,iBAAiB,CACzB,GAAG,EACH,cAAc,EACd,gCAAgC,OAAO,CAAC,WAAW,sBAAsB,OAAO,CAAC,GAAG,EAAE,CACvF,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/process-control.d.ts

@@ -0,0 +1,17 @@
+import { type RuntimeState } from './config.js';
+import type { ShutdownReason } from './local-control.js';
+export type StopMode = 'control-plane' | 'legacy-force-kill' | 'control-timeout-force-kill';
+export interface StopAgentOptions {
+    controlTimeoutMs?: number;
+    exitTimeoutMs?: number;
+    afterControlAccepted?: () => void | Promise<void>;
+    beforeForceKill?: () => void | Promise<void>;
+    isAlive?: (pid: number) => boolean;
+    forceKill?: (pid: number) => boolean;
+    sleep?: (milliseconds: number) => Promise<void>;
+    shutdownMetadata?: {
+        jobId?: string;
+        targetVersion?: string;
+    };
+}
+export declare function stopAgentProcess(state: RuntimeState, reason: ShutdownReason, options?: StopAgentOptions): Promise<StopMode>;