pi-maestro-mobile 0.1.2

package/dist/pi/pi-sdk-runtime.d.ts

@@ -0,0 +1,17 @@
+import { type SessionInfo } from "@earendil-works/pi-coding-agent";
+import type { MobileAgentRuntime } from "../mobile-agent.js";
+import type { RuntimeFactory } from "../types.js";
+export interface OpenSessionRequest {
+    cwd: string;
+    mode?: "create" | "continue";
+    sessionFile?: string;
+}
+/**
+ * PiSdkRuntimeFactory — 通过 Pi SDK 创建 AgentSessionRuntime
+ * 与 pi-mobile/apps/host 同源（参考实现），保证与桌面 TUI 共享同一份会话文件
+ */
+export declare class PiSdkRuntimeFactory implements RuntimeFactory {
+    createRuntime(request: OpenSessionRequest): Promise<MobileAgentRuntime>;
+    listSessions(cwd?: string): Promise<SessionInfo[]>;
+}
+//# sourceMappingURL=pi-sdk-runtime.d.ts.map

package/dist/pi/pi-sdk-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-sdk-runtime.d.ts","sourceRoot":"","sources":["../../src/pi/pi-sdk-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IAClD,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmCvE,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAIzD"}

package/dist/pi/pi-sdk-runtime.js

@@ -0,0 +1,57 @@
+import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, getAgentDir, SessionManager, } from "@earendil-works/pi-coding-agent";
+/**
+ * PiSdkRuntimeFactory — 通过 Pi SDK 创建 AgentSessionRuntime
+ * 与 pi-mobile/apps/host 同源（参考实现），保证与桌面 TUI 共享同一份会话文件
+ */
+export class PiSdkRuntimeFactory {
+    async createRuntime(request) {
+        const sessionManager = createSessionManager(request);
+        const createRuntime = async ({ cwd, sessionManager: sm, sessionStartEvent }) => {
+            const services = await createAgentSessionServices({
+                cwd,
+                // 过滤 pi-maestro-teammate：host 进程与真实 Pi 会话共享工作区时
+                // 会触发 workspace owner claim 冲突（同一 cwd 只能有一个 live owner）。
+                // host 只做只读会话浏览/驱动，不需要 teammate 的 peer 运行时。
+                resourceLoaderOptions: {
+                    extensionsOverride: (base) => ({
+                        ...base,
+                        extensions: base.extensions.filter((e) => !isTeammateExtension(e.path)),
+                    }),
+                },
+            });
+            return {
+                ...(await createAgentSessionFromServices({
+                    services,
+                    sessionManager: sm,
+                    ...(sessionStartEvent ? { sessionStartEvent } : {}),
+                })),
+                services,
+                diagnostics: services.diagnostics,
+            };
+        };
+        const runtime = await createAgentSessionRuntime(createRuntime, {
+            cwd: request.cwd,
+            agentDir: getAgentDir(),
+            sessionManager,
+        });
+        return runtime;
+    }
+    async listSessions(cwd) {
+        const sessions = cwd ? await SessionManager.list(cwd) : await SessionManager.listAll();
+        return sessions;
+    }
+}
+function createSessionManager(request) {
+    if (request.mode === "continue") {
+        return SessionManager.continueRecent(request.cwd);
+    }
+    if (request.sessionFile) {
+        return SessionManager.open(request.sessionFile, undefined, request.cwd);
+    }
+    return SessionManager.create(request.cwd);
+}
+/** 判断扩展路径是否属于 pi-maestro-teammate（其 workspace peer 会与真实 Pi 冲突） */
+function isTeammateExtension(path) {
+    return path.includes("pi-maestro-teammate");
+}
+//# sourceMappingURL=pi-sdk-runtime.js.map

package/dist/pi/pi-sdk-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-sdk-runtime.js","sourceRoot":"","sources":["../../src/pi/pi-sdk-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,0BAA0B,EAC1B,WAAW,EACX,cAAc,GAGf,MAAM,iCAAiC,CAAC;AAUzC;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B,KAAK,CAAC,aAAa,CAAC,OAA2B;QAC7C,MAAM,cAAc,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,aAAa,GAAqC,KAAK,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;YAC/G,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;gBAChD,GAAG;gBACH,gDAAgD;gBAChD,yDAAyD;gBACzD,4CAA4C;gBAC5C,qBAAqB,EAAE;oBACrB,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBAC7B,GAAG,IAAI;wBACP,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBACxE,CAAC;iBACH;aACF,CAAC,CAAC;YACH,OAAO;gBACL,GAAG,CAAC,MAAM,8BAA8B,CAAC;oBACvC,QAAQ;oBACR,cAAc,EAAE,EAAE;oBAClB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACpD,CAAC,CAAC;gBACH,QAAQ;gBACR,WAAW,EAAE,QAAQ,CAAC,WAAW;aAClC,CAAC;QACJ,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,aAAa,EAAE;YAC7D,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,WAAW,EAAE;YACvB,cAAc;SACf,CAAC,CAAC;QAEH,OAAO,OAAwC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAY;QAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;QACvF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,SAAS,oBAAoB,CAAC,OAA2B;IACvD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,cAAc,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,kEAAkE;AAClE,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAC9C,CAAC"}

package/dist/server/helpers.d.ts

@@ -0,0 +1,23 @@
+import type { HostSessionList } from "../vendor/shared/index.js";
+/**
+ * 将 SessionManager 返回的完整 SessionInfo 裁剪为移动端友好的摘要。
+ * 关键：不携带 allMessagesText 等大字段，避免移动端流量/内存浪费。
+ */
+export declare function toSessionSummaryList(records: unknown[]): Promise<HostSessionList>;
+/** 协议 images 元素 → Pi SDK ImageContent（type/data/mimeType）；非法返回 undefined */
+export declare function toSdkImageContent(img: {
+    data: string;
+    mime: string;
+}): {
+    type: "image";
+    data: string;
+    mimeType: string;
+} | undefined;
+/** 扫描可用的 skill 名录（agent 全局 + 项目本地） */
+export declare function listSkills(cwd: string): Promise<string[]>;
+/** 安全读取本地图片：绝对路径 + 图片扩展名 + 大小限制 + realpath 防 symlink 绕过 */
+export declare function serveImageFile(filePath: string): Promise<{
+    data: Buffer;
+    mime: string;
+} | undefined>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/server/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/server/helpers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,2BAA2B,CAAC;AAIrF;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAuBvF;AAgDD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIpI;AAID,sCAAsC;AACtC,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB/D;AAqBD,2DAA2D;AAC3D,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAsB1G"}

package/dist/server/helpers.js

@@ -0,0 +1,179 @@
+/**
+ * server/helpers — MobileHostServer 与 ws-command-handlers 共用的纯函数
+ * （H9 拆分：会话摘要、图片编解码、skill 扫描、安全文件读取）
+ */
+import { readFile, open, stat, readdir } from "node:fs/promises";
+import { realpath } from "node:fs/promises";
+import { isAbsolute, normalize, join } from "node:path";
+import { homedir, tmpdir } from "node:os";
+// ── 会话摘要 ─────────────────────────────────────────────────────────────────
+/**
+ * 将 SessionManager 返回的完整 SessionInfo 裁剪为移动端友好的摘要。
+ * 关键：不携带 allMessagesText 等大字段，避免移动端流量/内存浪费。
+ */
+export async function toSessionSummaryList(records) {
+    const sessions = [];
+    for (const raw of records) {
+        const r = raw;
+        const cwd = String(r.cwd ?? "");
+        const title = String(r.firstMessage ?? r.title ?? "");
+        const id = String(r.id ?? "");
+        const path = String(r.path ?? r.sessionFile ?? "");
+        sessions.push({
+            id,
+            cwd,
+            cwdName: cwd.split("/").filter(Boolean).pop() ?? cwd,
+            path,
+            title: title.length > 80 ? `${title.slice(0, 80)}…` : title,
+            name: typeof r.name === "string" && r.name ? r.name : undefined,
+            model: await latestModelFromJsonl(path),
+            messageCount: typeof r.messageCount === "number" ? r.messageCount : 0,
+            // 规范化为 ISO 字符串：Hermes（iOS）解析不了 "Thu Sep 03 2026 ..." 这种本地化格式
+            updatedAt: normalizeIso(String(r.modified ?? r.updatedAt ?? "")),
+            ...(r.created ? { createdAt: normalizeIso(String(r.created)) } : {}),
+        });
+    }
+    return { sessions, observedAt: new Date().toISOString() };
+}
+/** 从 jsonl 里找最近的 model_change，返回 provider/modelId 精简名 */
+async function latestModelFromJsonl(path) {
+    if (!path || !path.endsWith(".jsonl"))
+        return undefined;
+    try {
+        // 只读尾部 256KB（model_change 通常在会话活跃期靠后出现），避免整文件扫描
+        const handle = await open(path, "r");
+        try {
+            const { size } = await handle.stat();
+            const readLen = Math.min(TRAIL_READ_BYTES, size);
+            const buf = Buffer.alloc(readLen);
+            await handle.read(buf, 0, readLen, size - readLen);
+            const tail = buf.toString("utf8");
+            const lines = tail.split("\n");
+            for (let i = lines.length - 1; i >= 0; i--) {
+                const line = lines[i];
+                if (!line.includes("model_change"))
+                    continue;
+                try {
+                    const o = JSON.parse(line);
+                    if (o.modelId) {
+                        const provider = o.provider ? `${o.provider}/` : "";
+                        return `${provider}${o.modelId}`;
+                    }
+                }
+                catch {
+                    // ignore malformed
+                }
+            }
+            return undefined;
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+const TRAIL_READ_BYTES = 256 * 1024;
+/** 尝试解析为 ISO；无法解析时保留原字符串（App 端需兜底） */
+function normalizeIso(raw) {
+    if (!raw)
+        return "";
+    const t = Date.parse(raw);
+    return Number.isFinite(t) ? new Date(t).toISOString() : raw;
+}
+// ── 图片协议转换 ─────────────────────────────────────────────────────────────
+/** 协议 images 元素 → Pi SDK ImageContent（type/data/mimeType）；非法返回 undefined */
+export function toSdkImageContent(img) {
+    if (typeof img?.data !== "string" || img.data.length === 0)
+        return undefined;
+    if (typeof img?.mime !== "string" || !img.mime.startsWith("image/"))
+        return undefined;
+    return { type: "image", data: img.data, mimeType: img.mime };
+}
+// ── skill 扫描 ───────────────────────────────────────────────────────────────
+/** 扫描可用的 skill 名录（agent 全局 + 项目本地） */
+export async function listSkills(cwd) {
+    const dirs = [];
+    try {
+        dirs.push(join(homedir(), ".pi", "agent", "skills"));
+    }
+    catch { /* skip */ }
+    try {
+        dirs.push(join(cwd, ".pi", "skills"));
+    }
+    catch { /* skip */ }
+    const names = new Set();
+    for (const dir of dirs) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const e of entries) {
+                if (e.isDirectory() && !e.name.startsWith("."))
+                    names.add(e.name);
+            }
+        }
+        catch {
+            // skip
+        }
+    }
+    return [...names].sort();
+}
+// ── 安全文件读取（图片预览）───────────────────────────────────────────────
+const IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".bmp"]);
+const MAX_IMAGE_BYTES = 20 * 1024 * 1024; // 20MB
+const IMAGE_MIME = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".bmp": "image/bmp",
+};
+/** stat 包装（抛错由调用方捕获） */
+function fstat(p) {
+    return stat(p);
+}
+/** 安全读取本地图片：绝对路径 + 图片扩展名 + 大小限制 + realpath 防 symlink 绕过 */
+export async function serveImageFile(filePath) {
+    const trimmed = filePath.trim();
+    if (!trimmed || !isAbsolute(trimmed))
+        return undefined;
+    // 防止路径穿越：normalize 后必须仍是绝对路径且不含 ..
+    const normalized = normalize(trimmed);
+    if (!isAbsolute(normalized) || normalized.includes(".."))
+        return undefined;
+    const ext = normalized.slice(normalized.lastIndexOf(".")).toLowerCase();
+    if (!IMAGE_EXTENSIONS.has(ext))
+        return undefined;
+    try {
+        // P3-3：先解析真实路径，防止指向任意位置的 symlink 绕过绝对路径约束
+        const resolved = await realpath(normalized);
+        if (!(await isUnderAllowedRoot(resolved)))
+            return undefined;
+        // 先 stat 校验大小再读取，避免超大文件先耗尽内存
+        const st = await fstat(resolved);
+        if (st.size === 0 || st.size > MAX_IMAGE_BYTES)
+            return undefined;
+        const data = await readFile(resolved);
+        return { data, mime: IMAGE_MIME[ext] ?? "application/octet-stream" };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 允许读取的根目录：用户目录、系统临时目录、进程工作目录（会话产物、图片预览所在）。取 realpath 以兼容 /tmp → /private/tmp */
+async function isUnderAllowedRoot(resolved) {
+    const roots = [homedir(), tmpdir(), process.cwd()];
+    for (const root of roots) {
+        try {
+            const rp = await realpath(root);
+            if (resolved === rp || resolved.startsWith(rp + "/"))
+                return true;
+        }
+        catch {
+            // root 不存在时跳过
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/server/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/server/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAG1C,4EAA4E;AAE5E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAkB;IAC3D,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE;YACF,GAAG;YACH,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG;YACpD,IAAI;YACJ,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK;YAC3D,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAC/D,KAAK,EAAE,MAAM,oBAAoB,CAAC,IAAI,CAAC;YACvC,YAAY,EAAE,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACrE,6DAA6D;YAC7D,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;YAChE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED,yDAAyD;AACzD,KAAK,UAAU,oBAAoB,CAAC,IAAY;IAC9C,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACxD,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClC,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;oBAAE,SAAS;gBAC7C,IAAI,CAAC;oBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4C,CAAC;oBACtE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;wBACd,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpD,OAAO,GAAG,QAAQ,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;oBACnC,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,mBAAmB;gBACrB,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEpC,sCAAsC;AACtC,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED,0EAA0E;AAE1E,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,GAAmC;IACnE,IAAI,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7E,IAAI,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED,8EAA8E;AAE9E,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,CAAC;QAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAClF,IAAI,CAAC;QAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,iEAAiE;AAEjE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACrF,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;AAEjD,MAAM,UAAU,GAA2B;IACzC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,wBAAwB;AACxB,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,IAAI,CAAC,CAAC,CAAyC,CAAC;AACzD,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,mCAAmC;IACnC,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3E,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACxE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEjD,IAAI,CAAC;QACH,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,CAAC,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5D,6BAA6B;QAC7B,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,eAAe;YAAE,OAAO,SAAS,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,0BAA0B,EAAE,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IAChD,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/server/mobile-host-server.d.ts

@@ -0,0 +1,43 @@
+import type { HostController } from "../host-controller.js";
+export interface MobileHostServerOptions {
+    token?: string;
+    corsOrigin?: string;
+    /** WS Origin 额外白名单（除 loopback 与绑定 host 外的受信来源，如显式 LAN IP） */
+    allowedOrigins?: string[];
+}
+/**
+ * MobileHostServer — 移动端直连服务器（HTTP REST + WebSocket）
+ *
+ * 直连模式：同一局域网/同机，无 relay。
+ * - WS: /ws 实时事件流 + 客户端命令
+ * - HTTP: /api/health, /api/status, /api/sessions, /api/maestro
+ *
+ * 安全：token 可选（Bearer header 或 ?token=）
+ */
+export declare class MobileHostServer {
+    private readonly controller;
+    private readonly options;
+    private readonly server;
+    private readonly webSocketServer;
+    private readonly clients;
+    /** 单客户端并发命令上限：超过则拒绝，防命令洪泛（DoS） */
+    private static readonly MAX_CONNECTIONS;
+    private static readonly MAX_CONCURRENT_COMMANDS;
+    private unsubscribeController;
+    private boundHost;
+    constructor(controller: HostController, options?: MobileHostServerOptions);
+    listen(port: number, hostname?: string): Promise<void>;
+    address(): {
+        port: number;
+    };
+    close(): Promise<void>;
+    private handleHttp;
+    private authorized;
+    private handleUpgrade;
+    /** WS 握手 Origin 白名单：loopback 变体 + 绑定 host（非 0.0.0.0 时）+ 显式配置 */
+    private isOriginAllowed;
+    private handleClientMessage;
+    private sendAck;
+    private sendError;
+}
+//# sourceMappingURL=mobile-host-server.d.ts.map

package/dist/server/mobile-host-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-host-server.d.ts","sourceRoot":"","sources":["../../src/server/mobile-host-server.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AASD;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAWzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwE;IACxG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,kCAAkC;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAM;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAK;IACpD,OAAO,CAAC,qBAAqB,CAA2B;IACxD,OAAO,CAAC,SAAS,CAAa;gBAGX,UAAU,EAAE,cAAc,EAC1B,OAAO,GAAE,uBAA4B;IA4CxD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzD,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAQrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAcd,UAAU;IAwFxB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,aAAa;IAuBrB,gEAAgE;IAChE,OAAO,CAAC,eAAe;YA4BT,mBAAmB;IAkOjC,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,SAAS;CAQlB"}