echo-cli-agent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 api_ocra contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# echo-cli-agent
+
+Local CLI bridge agent. Connects coding CLI tools (Codex, Claude Code, Kiro) to your workspace.
+
+## Install
+
+```bash
+npm install -g echo-cli-agent
+```
+
+Requires Node.js ≥ 20.
+
+## Usage
+
+```bash
+# Check local environment
+echo-cli-agent doctor
+
+# Register this device
+echo-cli-agent enroll --server <server-url> --code <pairing-code>
+
+# Start the agent
+echo-cli-agent run
+```
+
+## System Service
+
+```bash
+# Register as a background service (launchd on macOS, systemd on Linux)
+echo-cli-agent service:install
+
+# Remove the service
+echo-cli-agent service:uninstall
+```
+
+## License
+
+MIT

package/dist/src/config.d.ts

@@ -0,0 +1,33 @@
+import type { LogLevel } from './logging/diagnostic-log.js';
+export type AgentConfig = {
+    wsUrl: string;
+    authMode: 'mcp' | 'bearer';
+    authToken: string;
+    deviceId: string;
+    deviceName: string;
+    endpoint: 'window' | 'cli';
+    capabilities: string[];
+    platform: NodeJS.Platform;
+    allowedRoots: string[];
+    allowExecutableOverride: boolean;
+    dataDir: string;
+    stateFile: string;
+    logFile: string;
+    healthHost: string;
+    healthPort: number;
+    logLevel: LogLevel;
+};
+export declare function defaultDataDir(): string;
+export declare function defaultConfigPath(dataDir?: string): string;
+export type EnrollmentOptions = {
+    serverUrl: string;
+    code: string;
+    deviceName?: string;
+    configPath?: string;
+};
+export declare function enrollDevice(options: EnrollmentOptions): Promise<{
+    deviceId: string;
+    configPath: string;
+}>;
+export declare function loadAgentConfig(): AgentConfig;
+export declare function redactedConfig(config: AgentConfig): Record<string, unknown>;

package/dist/src/config.js

@@ -0,0 +1,154 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { chmod, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { homedir, hostname, platform } from 'node:os';
+import { delimiter, dirname, join, resolve } from 'node:path';
+import { z } from 'zod';
+const FileConfigSchema = z
+    .object({
+    wsUrl: z.string().url().optional(),
+    authMode: z.enum(['mcp', 'bearer']).optional(),
+    authToken: z.string().min(1).optional(),
+    deviceId: z.string().min(1).optional(),
+    deviceName: z.string().min(1).optional(),
+    endpoint: z.enum(['window', 'cli']).optional(),
+    allowedRoots: z.array(z.string()).optional(),
+    allowExecutableOverride: z.boolean().optional(),
+    healthHost: z.string().optional(),
+    healthPort: z.number().int().min(0).max(65535).optional(),
+    logLevel: z.enum(['error', 'warn', 'info', 'debug']).optional()
+})
+    .strict();
+const EnrollResponseSchema = z.object({
+    device_id: z.string().min(1),
+    device_token: z.string().min(1),
+    ws_url: z.string().url(),
+    device_name: z.string().min(1)
+});
+export function defaultDataDir() {
+    if (process.platform === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'echo-cli-agent');
+    }
+    if (process.platform === 'win32') {
+        return join(process.env.APPDATA ?? homedir(), 'echo-cli-agent');
+    }
+    return join(process.env.XDG_STATE_HOME ?? join(homedir(), '.local', 'state'), 'echo-cli-agent');
+}
+export function defaultConfigPath(dataDir = resolve(process.env.ECHO_AGENT_DATA_DIR ?? defaultDataDir())) {
+    return resolve(process.env.ECHO_AGENT_CONFIG ?? join(dataDir, 'config.json'));
+}
+export async function enrollDevice(options) {
+    const endpoint = new URL('echo/device-enrollment/exchange', ensureTrailingSlash(options.serverUrl));
+    const response = await fetch(endpoint, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({
+            code: options.code,
+            ...(options.deviceName ? { device_name: options.deviceName } : {}),
+            platform: platform()
+        })
+    });
+    if (!response.ok)
+        throw new Error(`device enrollment failed (${response.status})`);
+    const enrolled = EnrollResponseSchema.parse(await response.json());
+    const dataDir = resolve(process.env.ECHO_AGENT_DATA_DIR ?? defaultDataDir());
+    const configPath = resolve(options.configPath ?? defaultConfigPath(dataDir));
+    await mkdir(dirname(configPath), { recursive: true, mode: 0o700 });
+    const existing = existsSync(configPath)
+        ? FileConfigSchema.parse(JSON.parse(await readFile(configPath, 'utf8')))
+        : {};
+    const serialized = JSON.stringify({
+        ...existing,
+        wsUrl: enrolled.ws_url,
+        authMode: 'mcp',
+        authToken: enrolled.device_token,
+        deviceId: enrolled.device_id,
+        deviceName: enrolled.device_name,
+        endpoint: 'cli'
+    }, null, 2);
+    const temporary = `${configPath}.${process.pid}.tmp`;
+    await writeFile(temporary, serialized, { mode: 0o600 });
+    await rename(temporary, configPath);
+    await chmod(configPath, 0o600);
+    return { deviceId: enrolled.device_id, configPath };
+}
+function ensureTrailingSlash(value) {
+    const url = new URL(value);
+    if (!url.pathname.endsWith('/'))
+        url.pathname += '/';
+    return url.toString();
+}
+function parseRoots(value) {
+    if (!value?.trim())
+        return undefined;
+    const separator = process.platform === 'win32' ? ';' : delimiter;
+    return value
+        .split(separator)
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+export function loadAgentConfig() {
+    const dataDir = resolve(process.env.ECHO_AGENT_DATA_DIR ?? defaultDataDir());
+    const configPath = defaultConfigPath(dataDir);
+    let fileConfig = {};
+    if (existsSync(configPath)) {
+        fileConfig = FileConfigSchema.parse(JSON.parse(readFileSync(configPath, 'utf8')));
+    }
+    const wsUrl = process.env.TASKMCP_WS_URL ?? fileConfig.wsUrl;
+    const authToken = process.env.TASKMCP_AUTH_TOKEN ?? fileConfig.authToken;
+    const deviceId = process.env.TASKMCP_DEVICE_ID ?? fileConfig.deviceId;
+    if (!wsUrl)
+        throw new Error('TASKMCP_WS_URL or config.wsUrl is required');
+    if (!authToken)
+        throw new Error('TASKMCP_AUTH_TOKEN or config.authToken is required');
+    if (!deviceId)
+        throw new Error('TASKMCP_DEVICE_ID is required from api_user route context');
+    const roots = parseRoots(process.env.TASKMCP_ALLOWED_ROOTS) ?? fileConfig.allowedRoots ?? [homedir()];
+    const healthPortText = process.env.ECHO_AGENT_HEALTH_PORT;
+    const healthPort = healthPortText ? Number.parseInt(healthPortText, 10) : (fileConfig.healthPort ?? 17329);
+    if (!Number.isInteger(healthPort) || healthPort < 0 || healthPort > 65535) {
+        throw new Error('ECHO_AGENT_HEALTH_PORT must be between 0 and 65535');
+    }
+    return {
+        wsUrl,
+        authMode: process.env.TASKMCP_AUTH_MODE ??
+            fileConfig.authMode ??
+            'mcp',
+        authToken,
+        deviceId,
+        deviceName: process.env.TASKMCP_DEVICE_NAME ?? fileConfig.deviceName ?? hostname(),
+        endpoint: process.env.TASKMCP_ENDPOINT ?? fileConfig.endpoint ?? 'cli',
+        capabilities: (process.env.ECHO_AGENT_CAPABILITIES ?? '')
+            .split(',')
+            .map((value) => value.trim().toLowerCase())
+            .filter(Boolean),
+        platform: platform(),
+        allowedRoots: roots.map((root) => resolve(root)),
+        allowExecutableOverride: process.env.ECHO_AGENT_ALLOW_EXECUTABLE_OVERRIDE === 'true' ||
+            fileConfig.allowExecutableOverride === true,
+        dataDir,
+        stateFile: join(dataDir, 'state.json'),
+        logFile: join(dataDir, 'logs', 'agent.log'),
+        healthHost: process.env.ECHO_AGENT_HEALTH_HOST ?? fileConfig.healthHost ?? '127.0.0.1',
+        healthPort,
+        logLevel: process.env.ECHO_AGENT_LOG_LEVEL ?? fileConfig.logLevel ?? 'info'
+    };
+}
+export function redactedConfig(config) {
+    return {
+        wsUrl: config.wsUrl,
+        authMode: config.authMode,
+        authToken: '[redacted]',
+        deviceId: '[runtime-only]',
+        deviceName: config.deviceName,
+        endpoint: config.endpoint,
+        capabilities: config.capabilities,
+        platform: config.platform,
+        allowedRoots: config.allowedRoots,
+        allowExecutableOverride: config.allowExecutableOverride,
+        dataDir: config.dataDir,
+        healthHost: config.healthHost,
+        healthPort: config.healthPort,
+        logLevel: config.logLevel
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IACzD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;CAChE,CAAC;KACD,MAAM,EAAE,CAAA;AAEX,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAA;AAqBF,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,gBAAgB,CAAC,CAAA;IAC5E,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAA;AACjG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,cAAc,EAAE,CAAC;IACtG,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAA;AAC/E,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA0B;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,iCAAiC,EAAE,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;IACnG,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;QACrC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,QAAQ,EAAE,QAAQ,EAAE;SACrB,CAAC;KACH,CAAC,CAAA;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;IAClF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,cAAc,EAAE,CAAC,CAAA;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAA;IAC5E,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC;QACrC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QACxE,CAAC,CAAC,EAAE,CAAA;IACN,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,GAAG,QAAQ;QACX,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,QAAQ,CAAC,YAAY;QAChC,QAAQ,EAAE,QAAQ,CAAC,SAAS;QAC5B,UAAU,EAAE,QAAQ,CAAC,WAAW;QAChC,QAAQ,EAAE,KAAK;KAChB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACX,MAAM,SAAS,GAAG,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,MAAM,CAAA;IACpD,MAAM,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACvD,MAAM,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACnC,MAAM,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAC9B,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,CAAA;AACrD,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAA;IACpD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB;IAC3C,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;QAAE,OAAO,SAAS,CAAA;IACpC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;IAChE,OAAO,KAAK;SACT,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,cAAc,EAAE,CAAC,CAAA;IAC5E,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC7C,IAAI,UAAU,GAAqC,EAAE,CAAA;IACrD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACnF,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,UAAU,CAAC,KAAK,CAAA;IAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,CAAC,SAAS,CAAA;IACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,UAAU,CAAC,QAAQ,CAAA;IACrE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IACzE,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACrF,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAE3F,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,UAAU,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IACrG,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAA;IACzD,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,IAAI,KAAK,CAAC,CAAA;IAC1G,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,KAAK,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACvE,CAAC;IAED,OAAO;QACL,KAAK;QACL,QAAQ,EACL,OAAO,CAAC,GAAG,CAAC,iBAAkD;YAC/D,UAAU,CAAC,QAAQ;YACnB,KAAK;QACP,SAAS;QACT,QAAQ;QACR,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,UAAU,CAAC,UAAU,IAAI,QAAQ,EAAE;QAClF,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,gBAAiD,IAAI,UAAU,CAAC,QAAQ,IAAI,KAAK;QACxG,YAAY,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC;aACtD,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;aAC1C,MAAM,CAAC,OAAO,CAAC;QAClB,QAAQ,EAAE,QAAQ,EAAE;QACpB,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD,uBAAuB,EACrB,OAAO,CAAC,GAAG,CAAC,oCAAoC,KAAK,MAAM;YAC3D,UAAU,CAAC,uBAAuB,KAAK,IAAI;QAC7C,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC;QACtC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC;QAC3C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,UAAU,CAAC,UAAU,IAAI,WAAW;QACtF,UAAU;QACV,QAAQ,EACL,OAAO,CAAC,GAAG,CAAC,oBAA6C,IAAI,UAAU,CAAC,QAAQ,IAAI,MAAM;KAC9F,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,gBAAgB;QAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;QACvD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAA;AACH,CAAC"}

package/dist/src/dispatch/dispatcher.d.ts

@@ -0,0 +1,34 @@
+import type { DiagnosticLogger } from '../logging/diagnostic-log.js';
+import type { DeliveryHooks } from '../session/session-manager.js';
+import type { CliWindowRecord, RunRecord, RunStatus } from '../state/state-store.js';
+import { type AgentCliAck, type AgentCliControlAck, type AgentCliEvent, type AgentCliRequest, type DeliveryResult } from '../types/protocol.js';
+export type SessionDelivery = {
+    deliver(request: AgentCliRequest, hooks: DeliveryHooks): Promise<DeliveryResult>;
+    cancelRun?(runId: string): boolean;
+    createWindow?(request: AgentCliRequest): Promise<CliWindowRecord>;
+    listWindows?(agentType?: string): CliWindowRecord[];
+};
+export type DeliveryState = {
+    getRun(runId: string): RunRecord | undefined;
+    markRun(runId: string, status: RunStatus, sessionId?: string): Promise<void>;
+};
+export type EventSender = {
+    sendEvent(event: AgentCliEvent): Promise<void>;
+    sendAck(ack: AgentCliAck): Promise<void>;
+    sendControlAck(ack: AgentCliControlAck): Promise<void>;
+};
+export declare class Dispatcher {
+    private readonly sessions;
+    private readonly state;
+    private readonly client;
+    private readonly logger;
+    private readonly queues;
+    constructor(sessions: SessionDelivery, state: DeliveryState, client: EventSender, logger: DiagnosticLogger);
+    accept(message: unknown): void;
+    waitForIdle(): Promise<void>;
+    private dispatch;
+    private control;
+    private completeRun;
+    private event;
+    private message;
+}

package/dist/src/dispatch/dispatcher.js

@@ -0,0 +1,216 @@
+import { AgentCliRequestSchema } from '../types/protocol.js';
+import { readAgentModelCatalog } from '../providers/model-catalog.js';
+export class Dispatcher {
+    sessions;
+    state;
+    client;
+    logger;
+    queues = new Map();
+    constructor(sessions, state, client, logger) {
+        this.sessions = sessions;
+        this.state = state;
+        this.client = client;
+        this.logger = logger;
+    }
+    accept(message) {
+        const parsed = AgentCliRequestSchema.safeParse(message);
+        if (!parsed.success)
+            return;
+        const request = parsed.data;
+        this.logger.info('agent-received', {
+            runId: request.run_id,
+            taskId: request.task_id,
+            agentType: request.agent_type
+        });
+        if (request.action !== 'prompt') {
+            void this.control(request);
+            return;
+        }
+        void this.event(request.run_id, 'agent_received', undefined, {}).catch((error) => {
+            this.logger.warn('agent-received-report-failed', {
+                runId: request.run_id,
+                error: this.message(error)
+            });
+        });
+        const queueKey = `${request.task_id}:${request.agent_type.toLowerCase()}`;
+        const previous = this.queues.get(queueKey) ?? Promise.resolve();
+        const next = previous
+            .then(() => this.dispatch(request))
+            .catch((error) => {
+            this.logger.error('dispatch-unhandled-error', { runId: request.run_id, error: this.message(error) });
+        })
+            .finally(() => {
+            if (this.queues.get(queueKey) === next)
+                this.queues.delete(queueKey);
+        });
+        this.queues.set(queueKey, next);
+    }
+    async waitForIdle() {
+        await Promise.all([...this.queues.values()]);
+    }
+    async dispatch(request) {
+        const previous = this.state.getRun(request.run_id);
+        if (previous?.status === 'completed') {
+            await this.event(request.run_id, 'prompt_delivered', previous.sessionId, { duplicate: true });
+            await this.event(request.run_id, 'completed', previous.sessionId, {
+                delivery: 'prompt_delivered',
+                duplicate: true
+            });
+            return;
+        }
+        await this.state.markRun(request.run_id, 'received');
+        try {
+            const result = await this.sessions.deliver(request, {
+                onProcessStarted: (sessionId, pid) => this.event(request.run_id, 'process_started', sessionId, { pid }),
+                onSessionInitialized: (sessionId, created) => this.event(request.run_id, 'session_initialized', sessionId, { created }),
+                onProcessExited: (sessionId, result) => this.completeRun(request, sessionId, result)
+            });
+            await this.state.markRun(request.run_id, 'delivered', result.sessionId);
+            await this.event(request.run_id, 'prompt_delivered', result.sessionId, {
+                delivered: true,
+                created: result.created
+            });
+        }
+        catch (error) {
+            await this.state.markRun(request.run_id, 'failed');
+            await this.event(request.run_id, 'failed', undefined, { message: this.message(error) }).catch(() => undefined);
+            this.logger.error('prompt-delivery-failed', {
+                runId: request.run_id,
+                agentType: request.agent_type,
+                error: this.message(error)
+            });
+        }
+    }
+    async control(request) {
+        try {
+            if (request.action === 'session_create') {
+                if (!this.sessions.createWindow)
+                    throw new Error('当前 Agent 不支持创建窗口');
+                const window = await this.sessions.createWindow(request);
+                await this.client.sendControlAck({
+                    type: 'agent_cli.control_ack',
+                    run_id: request.run_id,
+                    action: 'session_create',
+                    status: 'done',
+                    task_id: window.taskId,
+                    agent_type: window.agentType,
+                    name: window.name,
+                    ...(window.providerSessionId ? { session_id: window.providerSessionId } : {})
+                });
+                return;
+            }
+            if (request.action === 'model_catalog') {
+                const agentType = request.agent_type.toLowerCase();
+                await this.client.sendControlAck({
+                    type: 'agent_cli.control_ack',
+                    run_id: request.run_id,
+                    action: 'model_catalog',
+                    status: 'done',
+                    agent_type: agentType,
+                    catalog: await readAgentModelCatalog(agentType)
+                });
+                return;
+            }
+            if (request.action === 'run_cancel') {
+                if (!this.sessions.cancelRun?.(request.run_id)) {
+                    throw new Error('未找到可停止的本机 CLI 进程');
+                }
+                await this.client.sendControlAck({
+                    type: 'agent_cli.control_ack',
+                    run_id: request.run_id,
+                    action: 'run_cancel',
+                    status: 'done',
+                    task_id: request.task_id,
+                    agent_type: request.agent_type
+                });
+                return;
+            }
+            const windows = this.sessions.listWindows?.(request.agent_type) ?? [];
+            await this.client.sendControlAck({
+                type: 'agent_cli.control_ack',
+                run_id: request.run_id,
+                action: 'session_list',
+                status: 'done',
+                windows: windows.map((window) => ({
+                    task_id: window.taskId,
+                    agent_type: window.agentType,
+                    name: window.name,
+                    ...(window.providerSessionId ? { session_id: window.providerSessionId } : {})
+                }))
+            });
+        }
+        catch (error) {
+            const action = request.action === 'prompt' ? 'session_list' : request.action;
+            await this.client.sendControlAck({
+                type: 'agent_cli.control_ack',
+                run_id: request.run_id,
+                action,
+                status: 'failed',
+                ...(request.action === 'session_create'
+                    ? { task_id: request.task_id, agent_type: request.agent_type }
+                    : {}),
+                error: this.message(error)
+            }).catch(() => undefined);
+            this.logger.warn('cli-window-control-failed', {
+                runId: request.run_id,
+                action,
+                error: this.message(error)
+            });
+        }
+    }
+    async completeRun(request, sessionId, result) {
+        await this.event(request.run_id, 'process_exited', sessionId, {
+            exit_code: result.exitCode,
+            ...(result.signal ? { signal: result.signal } : {}),
+            duration_ms: result.durationMs
+        }).catch(() => undefined);
+        const status = result.cancelled ? 'cancelled' : (result.exitCode === 0 ? 'done' : 'failed');
+        const failureText = status === 'failed'
+            ? result.finalText?.trim().slice(0, 500) || `CLI exited with code ${result.exitCode}`
+            : undefined;
+        const ack = {
+            type: 'agent_cli.ack',
+            run_id: request.run_id,
+            ...(request.task_id ? { task_id: request.task_id } : {}),
+            ...(request.conversation_id ? { conversation_id: request.conversation_id } : {}),
+            ...(request.user_message_id ? { user_message_id: request.user_message_id } : {}),
+            agent_type: request.agent_type,
+            session_id: sessionId,
+            status,
+            exit_code: result.exitCode,
+            ...(failureText ? { stderr: failureText } : {}),
+            duration_ms: result.durationMs
+        };
+        try {
+            await this.client.sendAck(ack);
+            await this.state.markRun(request.run_id, status === 'done' ? 'completed' : 'failed', sessionId);
+            this.logger.info('cli-result-reported', {
+                runId: request.run_id,
+                agentType: request.agent_type,
+                status,
+                exitCode: result.exitCode,
+                durationMs: result.durationMs
+            });
+        }
+        catch (error) {
+            this.logger.warn('cli-result-report-failed', {
+                runId: request.run_id,
+                error: this.message(error)
+            });
+        }
+    }
+    event(runId, stage, sessionId, data) {
+        const event = {
+            type: 'agent_cli.event',
+            run_id: runId,
+            stage,
+            ...(sessionId ? { session_id: sessionId } : {}),
+            data
+        };
+        return this.client.sendEvent(event);
+    }
+    message(error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/src/dispatch/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../../src/dispatch/dispatcher.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,qBAAqB,EAKtB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAoBrE,MAAM,OAAO,UAAU;IAIF;IACA;IACA;IACA;IANF,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAA;IAE1D,YACmB,QAAyB,EACzB,KAAoB,EACpB,MAAmB,EACnB,MAAwB;QAHxB,aAAQ,GAAR,QAAQ,CAAiB;QACzB,UAAK,GAAL,KAAK,CAAe;QACpB,WAAM,GAAN,MAAM,CAAa;QACnB,WAAM,GAAN,MAAM,CAAkB;IACxC,CAAC;IAEJ,MAAM,CAAC,OAAgB;QACrB,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QACvD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAM;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAA;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACjC,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,MAAM,EAAE,OAAO,CAAC,OAAO;YACvB,SAAS,EAAE,OAAO,CAAC,UAAU;SAC9B,CAAC,CAAA;QACF,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAC1B,OAAM;QACR,CAAC;QACD,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC/C,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aAC3B,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAA;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;QAC/D,MAAM,IAAI,GAAG,QAAQ;aAClB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAClC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACtG,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACtE,CAAC,CAAC,CAAA;QACJ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC9C,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,OAAwB;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAClD,IAAI,QAAQ,EAAE,MAAM,KAAK,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAC7F,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,SAAS,EAAE;gBAChE,QAAQ,EAAE,kBAAkB;gBAC5B,SAAS,EAAE,IAAI;aAChB,CAAC,CAAA;YACF,OAAM;QACR,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE;gBAClD,gBAAgB,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC;gBACnE,oBAAoB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC;gBAC3E,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;aACrF,CAAC,CAAA;YACF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;YACvE,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE;gBACrE,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;YAClD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAC3F,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;gBAC1C,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,SAAS,EAAE,OAAO,CAAC,UAAU;gBAC7B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aAC3B,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAwB;QAC5C,IAAI,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY;oBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;gBACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;gBACxD,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;oBAC/B,IAAI,EAAE,uBAAuB;oBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,gBAAgB;oBACxB,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,MAAM,CAAC,MAAM;oBACtB,UAAU,EAAE,MAAM,CAAC,SAAS;oBAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9E,CAAC,CAAA;gBACF,OAAM;YACR,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;gBACvC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA;gBAClD,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;oBAC/B,IAAI,EAAE,uBAAuB;oBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,eAAe;oBACvB,MAAM,EAAE,MAAM;oBACd,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,MAAM,qBAAqB,CAAC,SAAS,CAAC;iBAChD,CAAC,CAAA;gBACF,OAAM;YACR,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/C,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;gBACrC,CAAC;gBACD,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;oBAC/B,IAAI,EAAE,uBAAuB;oBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,YAAY;oBACpB,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,UAAU,EAAE,OAAO,CAAC,UAAU;iBAC/B,CAAC,CAAA;gBACF,OAAM;YACR,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;YACrE,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;gBAC/B,IAAI,EAAE,uBAAuB;gBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,cAAc;gBACtB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAChC,OAAO,EAAE,MAAM,CAAC,MAAM;oBACtB,UAAU,EAAE,MAAM,CAAC,SAAS;oBAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9E,CAAC,CAAC;aACJ,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;YAC5E,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;gBAC/B,IAAI,EAAE,uBAAuB;gBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM;gBACN,MAAM,EAAE,QAAQ;gBAChB,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,gBAAgB;oBACrC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE;oBAC9D,CAAC,CAAC,EAAE,CAAC;gBACP,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aAC3B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;gBAC5C,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,MAAM;gBACN,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aAC3B,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,OAAwB,EACxB,SAAiB,EACjB,MAA0G;QAE1G,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE;YAC5D,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,WAAW,EAAE,MAAM,CAAC,UAAU;SAC/B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAEzB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QAC3F,MAAM,WAAW,GAAG,MAAM,KAAK,QAAQ;YACrC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,wBAAwB,MAAM,CAAC,QAAQ,EAAE;YACrF,CAAC,CAAC,SAAS,CAAA;QACb,MAAM,GAAG,GAAgB;YACvB,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,SAAS;YACrB,MAAM;YACN,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,WAAW,EAAE,MAAM,CAAC,UAAU;SAC/B,CAAA;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;YAC/F,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE;gBACtC,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,SAAS,EAAE,OAAO,CAAC,UAAU;gBAC7B,MAAM;gBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;gBAC3C,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;aAC3B,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CACX,KAAa,EACb,KAAoB,EACpB,SAA6B,EAC7B,IAA6B;QAE7B,MAAM,KAAK,GAAkB;YAC3B,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,KAAK;YACb,KAAK;YACL,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,IAAI;SACL,CAAA;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;IAEO,OAAO,CAAC,KAAc;QAC5B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC/D,CAAC;CACF"}

package/dist/src/health/server.d.ts

@@ -0,0 +1,25 @@
+import type { DiagnosticLogger } from '../logging/diagnostic-log.js';
+import type { RunRecord } from '../state/state-store.js';
+export type HealthSnapshot = {
+    deviceId: string;
+    connected: boolean;
+    activeSessions: number;
+    storedRuns: number;
+    startedAt: string;
+    runs: RunRecord[];
+};
+export declare class HealthServer {
+    private readonly host;
+    private readonly port;
+    private readonly snapshot;
+    private readonly logFile;
+    private readonly logger;
+    private server;
+    constructor(host: string, port: number, snapshot: () => HealthSnapshot, logFile: string, logger: DiagnosticLogger);
+    get boundPort(): number;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handle;
+    private json;
+    private recentEvents;
+}