@winmatrix/daemon 1.0.4 → 1.0.6

package/dist/core/DaemonClient.js

@@ -0,0 +1,225 @@
+/**
+ * WinMatrix Agent SDK - DaemonClient
+ *
+ * Extends WinMatrixAgentClient for the Computer/Daemon connection model.
+ * After WebSocket connection, sends `computer.register` (instead of `register`)
+ * with the computer's identity, host info, and detected runtimes.
+ *
+ * The Daemon connection acts as a multiplexing channel:
+ *   - computer.heartbeat events keep the Computer alive
+ *   - agent.create / agent.stop events manage Agent lifecycle on the host
+ *   - task.* messages are routed by agentId for individual agents
+ */
+import { METHODS, EVENTS, parseFrame, isEvent, isRequest, isResponse, } from '@winmatrix/protocol';
+import { WinMatrixAgentClient } from './WinMatrixAgentClient.js';
+/* ── DaemonClient ── */
+export class DaemonClient extends WinMatrixAgentClient {
+    daemonOptions;
+    serverComputerId = null;
+    agentCreateHandler = null;
+    agentStopHandler = null;
+    profileCollector = null;
+    /** 心跳执行锁，防止定时器回调并发 */
+    heartbeatInProgress = false;
+    constructor(options) {
+        super({
+            url: options.url,
+            apiKey: options.token,
+            agentId: `computer:${options.installationId}`,
+            name: options.hostname,
+            agentType: 'daemon',
+            capabilities: { streaming: false, toolCall: false, cancellation: false },
+            autoReconnect: options.autoReconnect,
+            bridgeHooks: options.bridgeHooks,
+        });
+        this.daemonOptions = options;
+    }
+    /** Register handler for daemon-specific events */
+    onDaemonEvent(event, handler) {
+        if (event === 'agent.create') {
+            this.agentCreateHandler = handler;
+        }
+        else if (event === 'agent.stop') {
+            this.agentStopHandler = handler;
+        }
+    }
+    /** Get the server-assigned computer ID (available after successful registration) */
+    getComputerId() {
+        return this.serverComputerId;
+    }
+    /** Set the profile collector function (called during heartbeat to attach agentProfiles) */
+    setProfileCollector(fn) {
+        this.profileCollector = fn;
+    }
+    /**
+     * 通过 daemon 连接发送 agent.error 事件。
+     * 替代直接访问私有 ws 属性，用于 agent.create 失败时通知服务端。
+     */
+    sendAgentError(agentId, error) {
+        if (this.getState() !== 'registered')
+            return false;
+        try {
+            this.sendEvent(EVENTS.AGENT_ERROR, { agentId, error });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Immediately send a heartbeat with agent profiles (used for agent create/destroy/rescan) */
+    async sendHeartbeatNow() {
+        if (this.getState() !== 'registered')
+            return;
+        try {
+            const agentProfiles = this.profileCollector ? await this.profileCollector() : undefined;
+            this.sendEvent(EVENTS.COMPUTER_HEARTBEAT, agentProfiles ? { agentProfiles } : undefined);
+        }
+        catch {
+            // best-effort
+        }
+    }
+    /* ── Protected overrides ── */
+    /**
+     * Override register() to send computer.register instead of agent register.
+     */
+    async register() {
+        const params = {
+            installationId: this.daemonOptions.installationId,
+            token: this.daemonOptions.token,
+            hostname: this.daemonOptions.hostname,
+            os: this.daemonOptions.hostOs,
+            arch: this.daemonOptions.hostArch,
+            daemonVersion: this.daemonOptions.daemonVersion,
+            runtimes: this.daemonOptions.runtimes,
+        };
+        if (this.daemonOptions.supportedAgentTypes?.length) {
+            params.supportedAgentTypes = this.daemonOptions.supportedAgentTypes;
+        }
+        const response = await this.sendRequest(METHODS.COMPUTER_REGISTER, params);
+        if (!response.ok) {
+            throw new Error(`Computer registration failed: ${response.error ?? 'unknown error'}`);
+        }
+        const payload = response.payload;
+        if (payload?.computerId) {
+            this.serverComputerId = payload.computerId;
+        }
+    }
+    /**
+     * Override heartbeat for daemon mode — sends computer.heartbeat events with optional agentProfiles.
+     * 使用锁防止定时器回调并发执行，确保上次心跳完成后再调度下次。
+     */
+    startHeartbeat() {
+        const interval = 30000;
+        this.heartbeatTimer = setInterval(async () => {
+            // 如果上次心跳还在执行，跳过本次
+            if (this.heartbeatInProgress)
+                return;
+            if (this.getState() !== 'registered')
+                return;
+            this.heartbeatInProgress = true;
+            try {
+                const agentProfiles = this.profileCollector ? await this.profileCollector() : undefined;
+                this.sendEvent(EVENTS.COMPUTER_HEARTBEAT, agentProfiles ? { agentProfiles } : undefined);
+            }
+            catch {
+                // Ignore transient send failures
+            }
+            finally {
+                this.heartbeatInProgress = false;
+            }
+        }, interval);
+    }
+    /**
+     * Override to extract agentId before parseFrame and intercept daemon events.
+     *
+     * 注意：方案 B 下 onPassthrough 未设置，passthrough 路由代码（task.assign ACK / wrapper 响应）
+     * 当前为 dead code。每个 agent 有独立 WinMatrixAgentClient + WebSocket，消息由
+     * AgentProcessManager 分发到各 agent 的 client，不经过 daemon 连接多路复用。
+     */
+    handleMessage(data) {
+        const raw = typeof data === 'string' ? data : data.toString('utf-8');
+        // Extract top-level agentId before parseFrame (which drops non-standard fields)
+        let agentId = null;
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                if (typeof parsed.agentId === 'string' && parsed.agentId.length > 0) {
+                    agentId = parsed.agentId;
+                }
+            }
+        }
+        catch {
+            return;
+        }
+        // Parse the frame for routing
+        const frame = parseFrame(raw);
+        if (!frame)
+            return;
+        // Intercept daemon events BEFORE parent handling
+        if (isEvent(frame)) {
+            const eventFrame = frame;
+            if (this.handleDaemonEvent(eventFrame.event, eventFrame.payload)) {
+                return;
+            }
+        }
+        // Pass through agent-level messages to daemon for wrapper forwarding
+        if (this.daemonOptions.onPassthrough) {
+            if (isRequest(frame)) {
+                const reqFrame = frame;
+                if (reqFrame.method === METHODS.TASK_ASSIGN) {
+                    // Ack receipt, then pass through
+                    this.sendRaw({ type: 'res', id: reqFrame.id, ok: true });
+                    this.daemonOptions.onPassthrough(frame, raw, agentId);
+                    return;
+                }
+                // Other unrecognized requests → pass through
+                this.daemonOptions.onPassthrough(frame, raw, agentId);
+                return;
+            }
+            if (isEvent(frame)) {
+                const evtFrame = frame;
+                // Pass through task/tool events for agent-level routing
+                if (evtFrame.event.startsWith('task.') || evtFrame.event.startsWith('tool.')) {
+                    this.daemonOptions.onPassthrough(frame, raw, agentId);
+                    return;
+                }
+            }
+        }
+        // Pass through response frames for forwarded wrapper requests
+        // (IDs starting with 'wrapper-'). Daemon-originated responses (IDs
+        // starting with 'sdk-') must be handled by the parent's pendingRequests.
+        if (isResponse(frame) && this.daemonOptions.onPassthrough) {
+            const resFrame = frame;
+            if (typeof resFrame.id === 'string' && resFrame.id.startsWith('wrapper-')) {
+                this.daemonOptions.onPassthrough(frame, raw, agentId);
+                return;
+            }
+        }
+        // Delegate to parent for standard message handling (responses, ping, etc.)
+        super.handleMessage(data);
+    }
+    /**
+     * Handle daemon-specific events. Returns true if the event was handled.
+     */
+    handleDaemonEvent(event, payload) {
+        switch (event) {
+            case EVENTS.AGENT_CREATE: {
+                const createPayload = payload;
+                if (createPayload?.agentId && (createPayload?.runtime || createPayload?.agentType === 'hermes' || createPayload?.agentType === 'openclaw')) {
+                    this.agentCreateHandler?.(createPayload);
+                }
+                return true;
+            }
+            case EVENTS.AGENT_STOP: {
+                const stopPayload = payload;
+                if (stopPayload?.agentId) {
+                    this.agentStopHandler?.(stopPayload);
+                }
+                return true;
+            }
+            default:
+                return false;
+        }
+    }
+}
+//# sourceMappingURL=DaemonClient.js.map

package/dist/core/DaemonClient.js.map

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

package/dist/core/DaemonFileLogger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 将 daemon 运行日志写入 ~/.winmatrix/logs/daemon-YYYY-MM-DD.log，
+ * 并清理超过保留期的历史文件（默认 3 天）。
+ */
+/** 内存中保留供 /api/logs 读取的最近行数 */
+export declare const DEFAULT_LOG_RING_MAX = 800;
+export declare function getLogsDirectory(): string;
+/** 日志行首时间戳：本机本地墙钟，非 UTC（避免 …Z） */
+export declare function formatDaemonLocalTimestamp(d?: Date): string;
+/**
+ * 删除日志目录下超过 retentionMs 的 daemon-*.log（按文件名日期；无法解析则按 mtime）。
+ */
+export declare function pruneOldDaemonLogs(retentionMs?: number): void;
+export declare class DaemonFileLogger {
+    private currentDay;
+    private readonly ring;
+    private readonly ringMax;
+    constructor(ringMax?: number);
+    /** 定时清理（例如每 6 小时） */
+    startRetentionTimer(intervalMs?: number): ReturnType<typeof setInterval>;
+    private rollFileIfNeeded;
+    private currentFilePath;
+    /**
+     * 写入一行带时间戳的文本（无敏感信息过滤；调用方勿记录 token/apiKey 全文）。
+     */
+    writeLine(level: string, message: string): void;
+    getRecentLines(max: number): string[];
+    getLogDirectory(): string;
+}
+/**
+ * 把 console.log / warn / error 镜像到文件 logger（仍保留原控制台输出）。
+ */
+export declare function mirrorConsoleToFile(logger: DaemonFileLogger): void;
+//# sourceMappingURL=DaemonFileLogger.d.ts.map

package/dist/core/DaemonFileLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonFileLogger.d.ts","sourceRoot":"","sources":["../../src/core/DaemonFileLogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAQxC,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AASD,kCAAkC;AAClC,wBAAgB,0BAA0B,CAAC,CAAC,OAAa,GAAG,MAAM,CASjE;AA4BD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,MAA6B,GAAG,IAAI,CAiBnF;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAA6B;IAOlD,qBAAqB;IACrB,mBAAmB,CAAC,UAAU,GAAE,MAA2B,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC;IAO5F,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAS/C,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAKrC,eAAe,IAAI,MAAM;CAG1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAoDlE"}

package/dist/core/DaemonFileLogger.js

@@ -0,0 +1,192 @@
+/**
+ * 将 daemon 运行日志写入 ~/.winmatrix/logs/daemon-YYYY-MM-DD.log，
+ * 并清理超过保留期的历史文件（默认 3 天）。
+ */
+import { appendFileSync, existsSync, mkdirSync, readdirSync, chmodSync, unlinkSync, statSync, } from 'node:fs';
+import path from 'node:path';
+import { homedir } from 'node:os';
+import util from 'node:util';
+const DAEMON_HOME_DIR = '.winmatrix';
+const LOG_SUBDIR = 'logs';
+const LOG_FILE_PREFIX = 'daemon-';
+const LOG_FILE_SUFFIX = '.log';
+/** 默认保留 3 天 */
+const DEFAULT_RETENTION_MS = 3 * 24 * 60 * 60 * 1000;
+/** 内存中保留供 /api/logs 读取的最近行数 */
+export const DEFAULT_LOG_RING_MAX = 800;
+let consoleStreamErrorGuardsInstalled = false;
+function getDaemonHome() {
+    return path.join(homedir(), DAEMON_HOME_DIR);
+}
+export function getLogsDirectory() {
+    return path.join(getDaemonHome(), LOG_SUBDIR);
+}
+function localDateStamp(d = new Date()) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+/** 日志行首时间戳：本机本地墙钟，非 UTC（避免 …Z） */
+export function formatDaemonLocalTimestamp(d = new Date()) {
+    const y = d.getFullYear();
+    const mo = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    const h = String(d.getHours()).padStart(2, '0');
+    const min = String(d.getMinutes()).padStart(2, '0');
+    const sec = String(d.getSeconds()).padStart(2, '0');
+    const ms = String(d.getMilliseconds()).padStart(3, '0');
+    return `${y}-${mo}-${day} ${h}:${min}:${sec}.${ms}`;
+}
+function ensureLogsDir() {
+    const dir = getLogsDirectory();
+    const parent = getDaemonHome();
+    if (!existsSync(parent)) {
+        mkdirSync(parent, { recursive: true, mode: 0o700 });
+        chmodSync(parent, 0o700);
+    }
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+        chmodSync(dir, 0o700);
+    }
+}
+const LOG_NAME_RE = /^daemon-(\d{4})-(\d{2})-(\d{2})\.log$/;
+function parseLogDate(name) {
+    const m = LOG_NAME_RE.exec(name);
+    if (!m)
+        return null;
+    const y = Number(m[1]);
+    const mo = Number(m[2]) - 1;
+    const d = Number(m[3]);
+    const dt = new Date(y, mo, d);
+    if (dt.getFullYear() !== y || dt.getMonth() !== mo || dt.getDate() !== d)
+        return null;
+    return dt;
+}
+/**
+ * 删除日志目录下超过 retentionMs 的 daemon-*.log（按文件名日期；无法解析则按 mtime）。
+ */
+export function pruneOldDaemonLogs(retentionMs = DEFAULT_RETENTION_MS) {
+    const dir = getLogsDirectory();
+    if (!existsSync(dir))
+        return;
+    const cutoff = Date.now() - retentionMs;
+    for (const name of readdirSync(dir)) {
+        if (!name.startsWith(LOG_FILE_PREFIX) || !name.endsWith(LOG_FILE_SUFFIX))
+            continue;
+        const full = path.join(dir, name);
+        try {
+            const fromName = parseLogDate(name);
+            const t = fromName ? fromName.getTime() : statSync(full).mtimeMs;
+            if (t < cutoff) {
+                unlinkSync(full);
+            }
+        }
+        catch {
+            /* ignore per-file errors */
+        }
+    }
+}
+export class DaemonFileLogger {
+    currentDay;
+    ring = [];
+    ringMax;
+    constructor(ringMax = DEFAULT_LOG_RING_MAX) {
+        ensureLogsDir();
+        pruneOldDaemonLogs();
+        this.currentDay = localDateStamp();
+        this.ringMax = ringMax;
+    }
+    /** 定时清理（例如每 6 小时） */
+    startRetentionTimer(intervalMs = 6 * 60 * 60 * 1000) {
+        return setInterval(() => {
+            pruneOldDaemonLogs();
+            this.rollFileIfNeeded();
+        }, intervalMs);
+    }
+    rollFileIfNeeded() {
+        const today = localDateStamp();
+        if (today !== this.currentDay) {
+            this.currentDay = today;
+        }
+    }
+    currentFilePath() {
+        this.rollFileIfNeeded();
+        return path.join(getLogsDirectory(), `${LOG_FILE_PREFIX}${this.currentDay}${LOG_FILE_SUFFIX}`);
+    }
+    /**
+     * 写入一行带时间戳的文本（无敏感信息过滤；调用方勿记录 token/apiKey 全文）。
+     */
+    writeLine(level, message) {
+        const line = `${formatDaemonLocalTimestamp()} [${level}] ${message}\n`;
+        appendFileSync(this.currentFilePath(), line, { encoding: 'utf-8' });
+        this.ring.push(line.replace(/\n$/, ''));
+        if (this.ring.length > this.ringMax) {
+            this.ring.splice(0, this.ring.length - this.ringMax);
+        }
+    }
+    getRecentLines(max) {
+        if (max <= 0)
+            return [];
+        return this.ring.slice(-max);
+    }
+    getLogDirectory() {
+        return getLogsDirectory();
+    }
+}
+/**
+ * 把 console.log / warn / error 镜像到文件 logger（仍保留原控制台输出）。
+ */
+export function mirrorConsoleToFile(logger) {
+    if (!consoleStreamErrorGuardsInstalled) {
+        process.stdout.on('error', (err) => {
+            if (err.code !== 'EPIPE') {
+                throw err;
+            }
+        });
+        process.stderr.on('error', (err) => {
+            if (err.code !== 'EPIPE') {
+                throw err;
+            }
+        });
+        consoleStreamErrorGuardsInstalled = true;
+    }
+    const origLog = console.log.bind(console);
+    const origWarn = console.warn.bind(console);
+    const origError = console.error.bind(console);
+    const fmt = (args) => args.map((a) => (typeof a === 'string' ? a : util.inspect(a, { depth: 6, breakLength: 120 }))).join(' ');
+    console.log = (...args) => {
+        logger.writeLine('log', fmt(args));
+        try {
+            origLog(...args);
+        }
+        catch (err) {
+            if (err.code !== 'EPIPE') {
+                throw err;
+            }
+        }
+    };
+    console.warn = (...args) => {
+        logger.writeLine('warn', fmt(args));
+        try {
+            origWarn(...args);
+        }
+        catch (err) {
+            if (err.code !== 'EPIPE') {
+                throw err;
+            }
+        }
+    };
+    console.error = (...args) => {
+        logger.writeLine('error', fmt(args));
+        try {
+            origError(...args);
+        }
+        catch (err) {
+            if (err.code !== 'EPIPE') {
+                throw err;
+            }
+        }
+    };
+}
+//# sourceMappingURL=DaemonFileLogger.js.map

package/dist/core/DaemonFileLogger.js.map

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

package/dist/core/DaemonLifecycle.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Daemon 运维：首次目录/init、按 PID 平滑重启。
+ */
+/**
+ * 守护进程主循环开始时写入（供 restart 查找）。
+ */
+export declare function writeDaemonPidFile(): void;
+/**
+ * 退出时删除 PID 文件。
+ */
+export declare function clearDaemonPidFile(): void;
+/**
+ * 创建 ~/.winmatrix、installation、logs；写入或合并 daemon.json（serverUrl / computerToken）。
+ * 可选：`winmatrix-daemon setup [--server <ws-url>] [--token <wmc_...>]`
+ */
+export declare function runSetup(setupArgv: string[]): void;
+/**
+ * 向旧进程发 SIGTERM，再后台拉起新进程（参数为 restart 之后的 argv）。
+ */
+export declare function runRestart(forwardArgv: string[]): Promise<void>;
+export declare function printCliHelp(daemonVersion: string): void;
+//# sourceMappingURL=DaemonLifecycle.d.ts.map

package/dist/core/DaemonLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonLifecycle.d.ts","sourceRoot":"","sources":["../../src/core/DaemonLifecycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsCH;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAWzC;AAqBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAsBlD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCrE;AAED,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CA2BxD"}

package/dist/core/DaemonLifecycle.js

@@ -0,0 +1,157 @@
+/**
+ * Daemon 运维：首次目录/init、按 PID 平滑重启。
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, writeFileSync, readFileSync, unlinkSync, chmodSync, mkdirSync, } from 'node:fs';
+import path from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { getOrCreateInstallationId } from './InstallationId.js';
+import { DaemonFileLogger, pruneOldDaemonLogs } from './DaemonFileLogger.js';
+import { DEFAULT_DAEMON_PUBLIC_BASE_URL, DEFAULT_DAEMON_SERVER_URL, getDaemonConfigFilePath, mergeDaemonSetupConfigToDisk, normalizeDaemonServerUrl, parseCliArgs, loadDaemonJson, } from './ConfigLoader.js';
+const DAEMON_HOME = path.join(homedir(), '.winmatrix');
+const PID_FILENAME = 'daemon.pid';
+function getPidFilePath() {
+    return path.join(DAEMON_HOME, PID_FILENAME);
+}
+function isProbablyOurDaemonPid(pid) {
+    return Number.isInteger(pid) && pid > 0;
+}
+/**
+ * 守护进程主循环开始时写入（供 restart 查找）。
+ */
+export function writeDaemonPidFile() {
+    if (!existsSync(DAEMON_HOME)) {
+        mkdirSync(DAEMON_HOME, { recursive: true, mode: 0o700 });
+        chmodSync(DAEMON_HOME, 0o700);
+    }
+    writeFileSync(getPidFilePath(), String(process.pid), { encoding: 'utf-8', mode: 0o600 });
+    chmodSync(getPidFilePath(), 0o600);
+}
+/**
+ * 退出时删除 PID 文件。
+ */
+export function clearDaemonPidFile() {
+    try {
+        if (existsSync(getPidFilePath())) {
+            const raw = readFileSync(getPidFilePath(), 'utf-8').trim();
+            if (raw === String(process.pid)) {
+                unlinkSync(getPidFilePath());
+            }
+        }
+    }
+    catch {
+        /* ignore */
+    }
+}
+function readExistingPid() {
+    try {
+        if (!existsSync(getPidFilePath()))
+            return null;
+        const n = Number.parseInt(readFileSync(getPidFilePath(), 'utf-8').trim(), 10);
+        return isProbablyOurDaemonPid(n) ? n : null;
+    }
+    catch {
+        return null;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function resolveEntryScriptPath() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.join(here, '..', 'index.js');
+}
+/**
+ * 创建 ~/.winmatrix、installation、logs；写入或合并 daemon.json（serverUrl / computerToken）。
+ * 可选：`winmatrix-daemon setup [--server <ws-url>] [--token <wmc_...>]`
+ */
+export function runSetup(setupArgv) {
+    getOrCreateInstallationId();
+    new DaemonFileLogger();
+    pruneOldDaemonLogs();
+    const args = parseCliArgs(setupArgv);
+    const file = loadDaemonJson();
+    const serverUrl = normalizeDaemonServerUrl(args.server ?? file.serverUrl ?? DEFAULT_DAEMON_SERVER_URL);
+    const tokenArg = typeof args.token === 'string' ? args.token.trim() : '';
+    mergeDaemonSetupConfigToDisk({ serverUrl, computerToken: tokenArg });
+    const cfgPath = getDaemonConfigFilePath();
+    console.log(`[daemon] setup: wrote ${cfgPath}`);
+    console.log('[daemon] setup: done.');
+    if (tokenArg.length === 0) {
+        console.log('[daemon] Tip: add Computer token with  winmatrix-daemon setup --token wmc_...  or edit computerToken in daemon.json');
+    }
+    console.log('[daemon] Then:  winmatrix-daemon   or   winmatrix-daemon restart');
+    console.log('[daemon] Local UI: http://127.0.0.1:18767/ (daemon running)');
+}
+/**
+ * 向旧进程发 SIGTERM，再后台拉起新进程（参数为 restart 之后的 argv）。
+ */
+export async function runRestart(forwardArgv) {
+    const oldPid = readExistingPid();
+    if (oldPid !== null) {
+        try {
+            process.kill(oldPid, 'SIGTERM');
+            console.log(`[daemon] restart: sent SIGTERM to pid ${oldPid}`);
+            for (let i = 0; i < 50; i++) {
+                try {
+                    process.kill(oldPid, 0);
+                }
+                catch {
+                    break;
+                }
+                await sleep(100);
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.log(`[daemon] restart: no process for pid ${oldPid} (${msg}), starting fresh`);
+        }
+    }
+    else {
+        console.log('[daemon] restart: no pid file (daemon was not running or first start)');
+    }
+    const entry = resolveEntryScriptPath();
+    if (!existsSync(entry)) {
+        console.error(`[daemon] restart: entry not found: ${entry}`);
+        console.error('[daemon] restart: run from built package (npm run build in clients/daemon)');
+        process.exitCode = 1;
+        return;
+    }
+    const child = spawn(process.execPath, [entry, ...forwardArgv], {
+        detached: true,
+        stdio: 'ignore',
+        env: process.env,
+    });
+    child.unref();
+    console.log(`[daemon] restart: started new daemon (child pid ${child.pid ?? '?'})`);
+}
+export function printCliHelp(daemonVersion) {
+    console.log(`WinMatrix Daemon ${daemonVersion}`);
+    console.log(`
+Usage:
+  winmatrix-daemon [options]          Run daemon (foreground)
+  winmatrix-daemon setup [options]    Create ~/.winmatrix + write/merge daemon.json
+  winmatrix-daemon restart [options]  SIGTERM old daemon (from pid file), start again with options
+  winmatrix-daemon doctor claude      Resolve, verify, and persist Claude Code runtime
+  winmatrix-daemon help               This help
+
+Options (setup / run / restart):
+  --server <server-url> Server base URL or External Agent WebSocket URL
+  --token <wmc_...>     Computer registration token (overrides env + daemon.json)
+  --persist-token       After resolving token (CLI or env), save serverUrl + computerToken to daemon.json
+
+Environment:
+  WINMATRIX_TOKEN           Computer token (wmc_...)
+  WINMATRIX_DAEMON_DIAG_*   Local diagnostics HTTP (see DiagnosticsServer)
+
+Config file:
+  ~/.winmatrix/daemon.json  serverUrl, optional computerToken (read on each start; chmod 600)
+
+Typical:
+  winmatrix-daemon setup --token wmc_...
+  winmatrix-daemon setup --token wmc_... --server ${DEFAULT_DAEMON_PUBLIC_BASE_URL}
+  winmatrix-daemon restart
+`);
+}
+//# sourceMappingURL=DaemonLifecycle.js.map