pi-maestro-mobile 0.1.2

package/README.md

@@ -0,0 +1,85 @@
+# pi-maestro-mobile
+
+PC 端常驻服务：把 Pi agent 会话、Monitor 窗口 telemetry、maestro 调度状态投影给手机 App（Maestro Mobile）。
+
+```
+手机 App  ←—— 局域网 WS/HTTP ——→  pi-maestro-mobile  ←→  Pi SDK AgentSession / ~/.pi 文件状态
+```
+
+## 安装
+
+### 方式一：npm 全局安装（推荐，launchd/systemd 常驻）
+
+```bash
+npm install -g pi-maestro-mobile
+pi-maestro-mobile --port 4739
+```
+
+开机常驻见下方 [守护进程](#守护进程)。
+
+### 方式二：pi 扩展安装
+
+```bash
+pi install npm:pi-maestro-mobile
+```
+
+（薄扩展入口：`/maestro-host` 命令管理守护进程，规划中；当前版本请用方式一。）
+
+### 方式三：Docker（看板模式）
+
+```bash
+docker run -d --name maestro-mobile \
+  -p 4739:4739 \
+  -v ~/.pi/agent/sessions:/home/node/.pi/agent/sessions:ro \
+  -v ~/.pi/teammate:/home/node/.pi/teammate:ro \
+  -e MAESTRO_MOBILE_TOKEN=your-secret \
+  maestro-mobile
+```
+
+容器模式能力边界：Dashboard / Monitor 看板、会话历史浏览、usage 统计**可用**；
+`open_session` / `steer_window` 的会话接管**不可用**（需要容器内安装 pi 及认证上下文）。
+详细说明见仓库 `docs/deploy.md`。
+
+## 使用
+
+```bash
+pi-maestro-mobile [--port 4739] [--host 0.0.0.0] [--token <secret>] [--project-root <dir>] [--poll-ms 5000]
+```
+
+| 参数 | 环境变量 | 默认 | 说明 |
+|---|---|---|---|
+| `--port` | `MAESTRO_MOBILE_PORT` | 4739 | HTTP+WS 端口 |
+| `--host` | `MAESTRO_MOBILE_HOST` | 0.0.0.0 | 监听地址 |
+| `--token` | `MAESTRO_MOBILE_TOKEN` | 随机（启动时打印） | Bearer/`?token=` 鉴权 |
+| `--project-root` | `MAESTRO_MOBILE_PROJECT_ROOT` | cwd | maestro flow-schedule 读取根 |
+| `--poll-ms` | `MAESTRO_MOBILE_POLL_MS` | 5000 | telemetry/调度轮询间隔 |
+
+手机 App 里填 `ws://<PC 局域网 IP>:4739/ws`（有 token 时加 `?token=`）。
+
+## 守护进程
+
+**macOS（launchd）**：
+
+```bash
+cp deploy/com.maestro-mobile.host.plist ~/Library/LaunchAgents/
+# 编辑 plist 里的安装路径、WorkingDirectory、token
+launchctl load ~/Library/LaunchAgents/com.maestro-mobile.host.plist
+```
+
+**Linux（systemd）**：
+
+```bash
+sudo cp deploy/maestro-mobile.service /etc/systemd/system/
+sudo systemctl enable --now maestro-mobile
+```
+
+## HTTP 接口速览
+
+| 路由 | 说明 |
+|---|---|
+| `GET /api/health` | 存活检查 |
+| `GET /api/status` | 版本/uptime/sessions（含 pi/flow/CLI 版本探测） |
+| `GET /api/workspace-telemetry` | Monitor 窗口 owners（pid/sessionId/agents/contextPressure） |
+| `GET /api/maestro` | flow-schedule 调度状态 |
+| `GET /api/live-sessions` | 活跃 Pi 会话扫描 |
+| `WS /ws` | 实时事件流 + 客户端命令（协议见 `@maestro-mobile/shared`） |

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+/**
+ * maestro-mobile — Host 守护进程入口
+ *
+ * 用法：
+ *   maestro-mobile [--port 4739] [--host 0.0.0.0] [--token <secret>] [--project-root <dir>] [--poll-ms 5000]
+ *
+ * 环境变量（与 CLI 参数等价）：
+ *   MAESTRO_MOBILE_PORT / MAESTRO_MOBILE_HOST / MAESTRO_MOBILE_TOKEN / MAESTRO_MOBILE_PROJECT_ROOT
+ *
+ * 安全：token 强制启用 —— 未提供 --token/环境变量时自动生成随机 token 并打印到 stdout。
+ * WS 握手校验 Origin（loopback 与绑定 host 白名单）。
+ */
+import { HostController } from "./host-controller.js";
+import { MobileHostServer } from "./server/mobile-host-server.js";
+import { MaestroStateReader } from "./maestro-state.js";
+import { PiSdkRuntimeFactory } from "./pi/pi-sdk-runtime.js";
+import { randomBytes } from "node:crypto";
+function parseArgs(argv) {
+    const args = new Map();
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const value = argv[i + 1] && !argv[i + 1].startsWith("--") ? argv[i + 1] : "true";
+            args.set(key, value);
+            if (value !== "true")
+                i++;
+        }
+    }
+    const port = Number(args.get("port") ?? process.env.MAESTRO_MOBILE_PORT ?? "4739");
+    // 安全默认：仅监听 loopback；显式 --host 0.0.0.0 才对 LAN 开放（README 安全节提醒配 token）
+    const host = args.get("host") ?? process.env.MAESTRO_MOBILE_HOST ?? "127.0.0.1";
+    const token = args.get("token") ?? process.env.MAESTRO_MOBILE_TOKEN ?? undefined;
+    const projectRoot = args.get("project-root") ?? process.env.MAESTRO_MOBILE_PROJECT_ROOT ?? process.cwd();
+    const pollMs = Number(args.get("poll-ms") ?? process.env.MAESTRO_MOBILE_POLL_MS ?? "5000");
+    if (!Number.isInteger(port) || port <= 0 || port > 65535) {
+        throw new Error(`Invalid port: ${port}`);
+    }
+    return { port, host, token, projectRoot, pollMs };
+}
+async function main() {
+    const cli = parseArgs(process.argv.slice(2));
+    // P0-1：无 token 拒绝裸奔 —— 自动生成随机会话 token 并打印，避免 LAN 内无鉴权全权暴露
+    const token = cli.token ?? randomBytes(24).toString("hex");
+    if (!cli.token) {
+        console.log("[maestro-mobile] no --token provided; generated an ephemeral token for this run:");
+        console.log(`[maestro-mobile]   token: ${token}`);
+        console.log("[maestro-mobile]   (set MAESTRO_MOBILE_TOKEN or pass --token to reuse a stable token)");
+    }
+    console.log(`[maestro-mobile] starting on ${cli.host}:${cli.port} (project: ${cli.projectRoot})`);
+    const runtimeFactory = new PiSdkRuntimeFactory();
+    const maestroReader = new MaestroStateReader({ projectRoot: cli.projectRoot });
+    const controller = new HostController(runtimeFactory, maestroReader);
+    const server = new MobileHostServer(controller, { token });
+    await server.listen(cli.port, cli.host);
+    await controller.startMaestroPoll(cli.pollMs);
+    console.log(`[maestro-mobile] listening on http://${cli.host}:${server.address().port}`);
+    console.log(`[maestro-mobile] token auth enabled (use ?token= or Bearer header)`);
+    // 优雅关闭
+    let shuttingDown = false;
+    async function shutdown(signal) {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.log(`[maestro-mobile] received ${signal}, shutting down...`);
+        await controller.dispose();
+        await server.close();
+        console.log("[maestro-mobile] shutdown complete");
+        process.exit(0);
+    }
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    process.on("uncaughtException", (error) => {
+        // P3-6：未捕获异常后进程状态不可信，记录后带清理退出，避免带伤继续服务
+        console.error("[maestro-mobile] uncaught exception, shutting down:", error);
+        void shutdown("uncaughtException").finally(() => process.exit(1));
+    });
+}
+main().catch((error) => {
+    console.error("[maestro-mobile] fatal:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/event-log.d.ts

@@ -0,0 +1,18 @@
+import type { HostEvent } from "./vendor/shared/index.js";
+/** 分布式 Omit：对联合类型的每个成员分别 Omit（TS 默认 Omit 不是分布式的） */
+export type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+/**
+ * EventLog — 事件日志（顺序序列号 + 持久化支持）
+ * 用于断线重连后的增量同步
+ */
+export declare class EventLog {
+    private readonly events;
+    private nextSeq;
+    private readonly maxEntries;
+    constructor(maxEntries?: number);
+    get nextSequence(): number;
+    record(event: DistributiveOmit<HostEvent, "seq">): HostEvent;
+    eventsSince(seq: number): HostEvent[];
+    get all(): HostEvent[];
+}
+//# sourceMappingURL=event-log.d.ts.map

package/dist/event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../src/event-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAEhG;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,SAAS;IAI/B,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,SAAS;IAU5D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE;IAIrC,IAAI,GAAG,IAAI,SAAS,EAAE,CAErB;CACF"}

package/dist/event-log.js

@@ -0,0 +1,31 @@
+/**
+ * EventLog — 事件日志（顺序序列号 + 持久化支持）
+ * 用于断线重连后的增量同步
+ */
+export class EventLog {
+    events = [];
+    nextSeq = 1;
+    maxEntries;
+    constructor(maxEntries = 10_000) {
+        this.maxEntries = maxEntries;
+    }
+    get nextSequence() {
+        return this.nextSeq;
+    }
+    record(event) {
+        const seq = this.nextSeq++;
+        const full = { ...event, seq };
+        this.events.push(full);
+        if (this.events.length > this.maxEntries) {
+            this.events.splice(0, this.events.length - this.maxEntries);
+        }
+        return full;
+    }
+    eventsSince(seq) {
+        return this.events.filter((e) => e.seq > seq);
+    }
+    get all() {
+        return [...this.events];
+    }
+}
+//# sourceMappingURL=event-log.js.map

package/dist/event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../src/event-log.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACF,MAAM,GAAgB,EAAE,CAAC;IAClC,OAAO,GAAG,CAAC,CAAC;IACH,UAAU,CAAS;IAEpC,YAAY,UAAU,GAAG,MAAM;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,KAAyC;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAc,EAAE,GAAG,KAAK,EAAE,GAAG,EAAe,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,GAAW;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,GAAG;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/extension.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function maestroHostExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AA6CpE,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAiEnE"}

package/dist/extension.js

@@ -0,0 +1,118 @@
+/**
+ * maestro-mobile extension — 薄遥控器（用户提案：pi 扩展自动拉起 npm 包的 host）
+ *
+ * 职责边界（刻意保持薄）：
+ *  - start:  幂等启动 host 子进程（detached；已在监听则跳过）
+ *  - status: 探测 /api/health + /api/status
+ *  - stop:   杀掉由本扩展启动的 host（PID 文件校验，防误杀外部 launchd/systemd 实例）
+ *
+ * host 仍是独立常驻进程（不随 Pi 会话生灭）；本扩展只做生命周期遥控。
+ * 无 npm 包的 host 时（pi install 场景），spawn 同包 dist/cli.js。
+ */
+import { spawn } from "node:child_process";
+import { readFile, writeFile, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+const PID_FILE = join(homedir(), ".pi", "maestro-mobile.pid");
+const DEFAULT_PORT = 4739;
+function hostPort() {
+    const raw = process.env.MAESTRO_MOBILE_PORT;
+    const n = raw ? Number(raw) : NaN;
+    return Number.isInteger(n) && n > 0 && n < 65536 ? n : DEFAULT_PORT;
+}
+/** 探测 host 是否在监听：/api/health 200 或 401 都算 alive（401 = 服务在，仅缺 token） */
+function probeHealth(port, timeoutMs = 800) {
+    return new Promise((resolve) => {
+        fetch(`http://127.0.0.1:${port}/api/health`, { signal: AbortSignal.timeout(timeoutMs) })
+            .then((r) => resolve(r.status === 200 || r.status === 401))
+            .catch(() => resolve(false));
+    });
+}
+function hostStatus(port, timeoutMs = 800) {
+    return new Promise((resolve) => {
+        fetch(`http://127.0.0.1:${port}/api/status`, { signal: AbortSignal.timeout(timeoutMs) })
+            .then(async (r) => (r.ok ? (await r.json()) : null))
+            .then((d) => resolve(d ?? null))
+            .catch(() => resolve(null));
+    });
+}
+/** host cli.js 入口：同包 dist（pi install npm:pi-maestro-mobile 时随包分发） */
+function hostCliPath() {
+    // dist/extension.js 与 dist/cli.js 同目录
+    return join(fileURLToPath(new URL(".", import.meta.url)), "cli.js");
+}
+async function readPid() {
+    try {
+        const raw = await readFile(PID_FILE, "utf8");
+        const pid = Number(raw.trim());
+        return Number.isInteger(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+export default function maestroHostExtension(pi) {
+    pi.registerCommand("maestro-mobile", {
+        description: "Maestro Mobile Host 遥控（status / start / stop）",
+        handler: async (args, ctx) => {
+            const sub = (args ?? "").trim().split(/\s+/)[0] || "status";
+            const port = hostPort();
+            const alive = await probeHealth(port);
+            if (sub === "status") {
+                if (!alive) {
+                    ctx.ui.notify(`maestro-mobile: 未运行（端口 ${port} 无响应）`, "info");
+                    return;
+                }
+                const s = await hostStatus(port);
+                const ver = s
+                    ? `${s.version} · pi ${s.piVersion ?? "?"} · flow ${s.flowVersion ?? "?"} · cli ${s.maestroCliVersion ?? "?"}`
+                    : "运行中（未配 token，版本详情需在 host 侧设置 MAESTRO_MOBILE_TOKEN 后由手机 App 查看）";
+                ctx.ui.notify(`maestro-mobile: 运行中 :${port} — ${ver}`, "info");
+                return;
+            }
+            if (sub === "start") {
+                if (alive) {
+                    ctx.ui.notify(`maestro-mobile: 已在运行（:${port}），跳过启动`, "info");
+                    return;
+                }
+                const child = spawn(process.execPath, [hostCliPath(), "--port", String(port)], {
+                    detached: true,
+                    stdio: "ignore",
+                    env: { ...process.env, MAESTRO_MOBILE_PORT: String(port) },
+                });
+                child.unref();
+                await writeFile(PID_FILE, String(child.pid ?? ""), "utf8");
+                // 等待端口就绪（最多 3s）
+                for (let i = 0; i < 10; i++) {
+                    await new Promise((r) => setTimeout(r, 300));
+                    if (await probeHealth(port)) {
+                        ctx.ui.notify(`maestro-mobile: 已启动 :${port} pid=${child.pid}`, "info");
+                        return;
+                    }
+                }
+                ctx.ui.notify("maestro-mobile: 启动后 3s 内未见 health 通过，请查日志", "warning");
+                return;
+            }
+            if (sub === "stop") {
+                const pid = await readPid();
+                if (!pid) {
+                    ctx.ui.notify("maestro-mobile: 无本扩展启动的实例（PID 文件不存在）；launchd/systemd 管理的实例请用对应服务命令停", "warning");
+                    return;
+                }
+                try {
+                    process.kill(pid, "SIGTERM");
+                    await unlink(PID_FILE).catch(() => { });
+                    ctx.ui.notify(`maestro-mobile: 已发送 SIGTERM 到 pid=${pid}`, "info");
+                }
+                catch {
+                    await unlink(PID_FILE).catch(() => { });
+                    ctx.ui.notify(`maestro-mobile: pid=${pid} 已不存在，清理 PID 文件`, "info");
+                }
+                return;
+            }
+            ctx.ui.notify(`maestro-mobile: 未知子命令 "${sub}"（可用：status / start / stop）`, "warning");
+        },
+    });
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

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

package/dist/host-controller.d.ts

@@ -0,0 +1,69 @@
+import type { ExtensionUiResponse } from "./vendor/shared/index.js";
+import type { RuntimeFactory, SessionRunner, OpenSessionRequest, HostEventListener } from "./types.js";
+import { MaestroStateReader } from "./maestro-state.js";
+import { type ComponentVersions } from "./version-detector.js";
+/**
+ * HostController — 集中管理所有会话 + Maestro 状态 + 事件分发
+ *
+ * 职责：
+ * - 管理 SessionRunner 实例生命周期
+ * - 注册 HostEventListener 事件监听（给 WebSocket 广播用）
+ * - 调度 MaestroStateReader 定期读取
+ * - 处理 client commands
+ */
+export declare class HostController {
+    private readonly runtimeFactory;
+    private readonly sessions;
+    private readonly eventLog;
+    private readonly listeners;
+    private readonly maestroReader;
+    private readonly liveSessions;
+    private readonly telemetryReader;
+    private telemetryCache;
+    private telemetryInFlight;
+    private readonly emitToListeners;
+    private maestroPollTimer;
+    private maestroDetected;
+    private readonly versionDetector;
+    private componentVersions;
+    private _startedAt;
+    constructor(runtimeFactory: RuntimeFactory, maestroReader?: MaestroStateReader);
+    get startedAt(): number;
+    get activeSessionIds(): string[];
+    /** 读取活跃会话列表（只读，不 claim owner） */
+    listLiveSessions(): Promise<import("./live-sessions.js").LiveSessionList>;
+    /** 读取 workspace telemetry（owner 状态，Monitor/Teammate 合同） */
+    readTelemetry(): Promise<import("./vendor/shared/protocol.js").WorkspaceTelemetryState>;
+    /** 轮询 telemetry，状态变化时推送 monitor_state 事件（single-flight + 稳定键变更检测） */
+    pollTelemetry(): Promise<void>;
+    /** 注册事件监听（WebSocket 层订阅） */
+    onEvent(listener: HostEventListener): () => void;
+    /** 获取状态信息 */
+    getStatus(): {
+        ok: boolean;
+        version: string;
+        maestroDetected: boolean;
+        sessions: number;
+        uptimeMs: number;
+    } & ComponentVersions;
+    /** 启动 Maestro 状态轮询 */
+    startMaestroPoll(intervalMs?: number): Promise<void>;
+    /** 立即读取一次 Maestro 状态（HTTP 路由用） */
+    readMaestroStateNow(): Promise<import("./vendor/shared/protocol.js").MaestroState>;
+    stopMaestroPoll(): void;
+    /** 列出所有会话（透传 runtimeFactory） */
+    listSessions(cwd?: string): Promise<unknown[]>;
+    /** 打开会话 */
+    openSession(request: OpenSessionRequest): Promise<SessionRunner>;
+    /** 获取会话 */
+    getSession(sessionId: string): SessionRunner | undefined;
+    /** 关闭会话 */
+    closeSession(sessionId: string): Promise<boolean>;
+    /** 处理 extension_ui_response */
+    respondToExtensionUi(sessionId: string, requestId: string, response: ExtensionUiResponse): boolean;
+    /** 刷新 Maestro 状态（仅状态变化时推送） */
+    private refreshMaestroState;
+    /** 释放所有资源（关闭时调用） */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=host-controller.d.ts.map

package/dist/host-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-controller.d.ts","sourceRoot":"","sources":["../src/host-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEvG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGhF;;;;;;;;GAQG;AACH,qBAAa,cAAc;IAiBvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAhBjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,UAAU,CAAc;gBAGb,cAAc,EAAE,cAAc,EAC/C,aAAa,CAAC,EAAE,kBAAkB;IAYpC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,gBAAgB,IAAI,MAAM,EAAE,CAE/B;IAED,iCAAiC;IAC3B,gBAAgB;IAItB,2DAA2D;IACrD,aAAa;IAInB,qEAAqE;IAC/D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBpC,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAKhD,aAAa;IACb,SAAS,IAAI;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB;IAY/H,sBAAsB;IAChB,gBAAgB,CAAC,UAAU,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxD,kCAAkC;IAC5B,mBAAmB;IAIzB,eAAe,IAAI,IAAI;IAOvB,gCAAgC;IAC1B,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIpD,WAAW;IACL,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBtE,WAAW;IACX,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIxD,WAAW;IACL,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvD,+BAA+B;IAC/B,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAMlG,8BAA8B;YAChB,mBAAmB;IAmBjC,oBAAoB;IACd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}

package/dist/host-controller.js

@@ -0,0 +1,195 @@
+import { SdkSessionRunner } from "./session-runner.js";
+import { MaestroStateReader } from "./maestro-state.js";
+import { LiveSessionsService } from "./live-sessions.js";
+import { WorkspaceTelemetryReader } from "./workspace-telemetry.js";
+import { projectMonitorState, telemetryStableKey, monitorStateEvent } from "./monitor-projection.js";
+import { VersionDetector } from "./version-detector.js";
+import { EventLog } from "./event-log.js";
+/**
+ * HostController — 集中管理所有会话 + Maestro 状态 + 事件分发
+ *
+ * 职责：
+ * - 管理 SessionRunner 实例生命周期
+ * - 注册 HostEventListener 事件监听（给 WebSocket 广播用）
+ * - 调度 MaestroStateReader 定期读取
+ * - 处理 client commands
+ */
+export class HostController {
+    runtimeFactory;
+    sessions = new Map();
+    eventLog = new EventLog();
+    listeners = new Set();
+    maestroReader;
+    liveSessions;
+    telemetryReader;
+    telemetryCache = null;
+    telemetryInFlight = false;
+    emitToListeners;
+    maestroPollTimer = null;
+    maestroDetected = false;
+    versionDetector = new VersionDetector();
+    componentVersions = {};
+    _startedAt = Date.now();
+    constructor(runtimeFactory, maestroReader) {
+        this.runtimeFactory = runtimeFactory;
+        this.maestroReader = maestroReader ?? new MaestroStateReader();
+        this.liveSessions = new LiveSessionsService();
+        this.telemetryReader = new WorkspaceTelemetryReader();
+        this.emitToListeners = (event) => {
+            for (const listener of this.listeners) {
+                try {
+                    listener(event);
+                }
+                catch { /* ignore */ }
+            }
+        };
+    }
+    get startedAt() {
+        return this._startedAt;
+    }
+    get activeSessionIds() {
+        return [...this.sessions.keys()];
+    }
+    /** 读取活跃会话列表（只读，不 claim owner） */
+    async listLiveSessions() {
+        return this.liveSessions.list();
+    }
+    /** 读取 workspace telemetry（owner 状态，Monitor/Teammate 合同） */
+    async readTelemetry() {
+        return this.telemetryReader.read();
+    }
+    /** 轮询 telemetry，状态变化时推送 monitor_state 事件（single-flight + 稳定键变更检测） */
+    async pollTelemetry() {
+        if (this.telemetryInFlight)
+            return;
+        this.telemetryInFlight = true;
+        try {
+            const t = await this.telemetryReader.read();
+            const key = telemetryStableKey(t);
+            if (key === this.telemetryCache)
+                return;
+            this.telemetryCache = key;
+            this.emitToListeners(this.eventLog.record(monitorStateEvent(projectMonitorState(t))));
+        }
+        catch {
+            // 读取失败保留上次快照，不广播空窗口
+        }
+        finally {
+            this.telemetryInFlight = false;
+        }
+    }
+    /** 注册事件监听（WebSocket 层订阅） */
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** 获取状态信息 */
+    getStatus() {
+        const uptimeMs = Date.now() - this._startedAt;
+        return {
+            ok: true,
+            version: "0.1.0",
+            maestroDetected: this.maestroDetected,
+            ...this.componentVersions,
+            sessions: this.sessions.size,
+            uptimeMs,
+        };
+    }
+    /** 启动 Maestro 状态轮询 */
+    async startMaestroPoll(intervalMs = 5000) {
+        if (this.maestroPollTimer)
+            return; // 重复启动防护
+        // 启动时探测一次组件版本（内部带缓存，失败字段留空由 UI 显示待接入）
+        this.componentVersions = await this.versionDetector.detect();
+        await this.refreshMaestroState();
+        await this.pollTelemetry();
+        this.maestroPollTimer = setInterval(() => {
+            void this.refreshMaestroState();
+            void this.pollTelemetry();
+        }, intervalMs);
+    }
+    /** 立即读取一次 Maestro 状态（HTTP 路由用） */
+    async readMaestroStateNow() {
+        return this.maestroReader.readState();
+    }
+    stopMaestroPoll() {
+        if (this.maestroPollTimer) {
+            clearInterval(this.maestroPollTimer);
+            this.maestroPollTimer = null;
+        }
+    }
+    /** 列出所有会话（透传 runtimeFactory） */
+    async listSessions(cwd) {
+        return this.runtimeFactory.listSessions(cwd);
+    }
+    /** 打开会话 */
+    async openSession(request) {
+        const runner = await SdkSessionRunner.open(this.runtimeFactory, request, (event) => {
+            this.emitToListeners(this.eventLog.record(event));
+        });
+        // P2-4：同一会话（continue 同一 sessionFile 时 id 相同）重复 open 时，
+        // 先释放旧 runner（否则旧实例仍在订阅 SDK 事件并广播，且 runtime 常驻内存），再登记新实例。
+        const existing = this.sessions.get(runner.id);
+        if (existing && existing !== runner) {
+            await existing.dispose();
+        }
+        this.sessions.set(runner.id, runner);
+        this.emitToListeners(this.eventLog.record({
+            type: "host_status",
+            status: `session ${runner.id} opened`,
+        }));
+        return runner;
+    }
+    /** 获取会话 */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /** 关闭会话 */
+    async closeSession(sessionId) {
+        const runner = this.sessions.get(sessionId);
+        if (!runner)
+            return false;
+        this.sessions.delete(sessionId);
+        await runner.dispose();
+        return true;
+    }
+    /** 处理 extension_ui_response */
+    respondToExtensionUi(sessionId, requestId, response) {
+        const runner = this.sessions.get(sessionId);
+        if (!runner)
+            return false;
+        return runner.respondToExtensionUi(requestId, response);
+    }
+    /** 刷新 Maestro 状态（仅状态变化时推送） */
+    async refreshMaestroState() {
+        try {
+            // P3-1：接线 detectMaestro，使 getStatus().maestroDetected 反映真实检测结果
+            this.maestroDetected = await this.maestroReader.detectMaestro();
+        }
+        catch {
+            // ignore
+        }
+        try {
+            const state = await this.maestroReader.readStateChanged();
+            if (state === null)
+                return;
+            this.emitToListeners(this.eventLog.record({
+                type: "maestro_state",
+                state,
+            }));
+        }
+        catch {
+            // ignore
+        }
+    }
+    /** 释放所有资源（关闭时调用） */
+    async dispose() {
+        this.stopMaestroPoll();
+        for (const runner of this.sessions.values()) {
+            await runner.dispose();
+        }
+        this.sessions.clear();
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=host-controller.js.map