pi-maestro-mobile 0.1.2

package/dist/maestro-state.js

@@ -0,0 +1,219 @@
+/**
+ * MaestroStateReader — 只读读取 flow-schedule store 文件，投影为移动端友好类型
+ *
+ * 不依赖 pi-maestro-flow 的 store 类（避免进程内锁竞争），直接读文件快照。
+ * store 文件路径：<projectRoot>/.pi/flow-schedule/v1/schedules/<id>.json
+ */
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+const FLOW_SCHEDULE_DIR = ".pi/flow-schedule/v1";
+const SCHEDULES_DIR = "schedules";
+const DISPATCHES_DIR = "dispatches";
+const MAX_FILE_SIZE = 1 * 1024 * 1024; // 1MB
+export class MaestroStateReader {
+    projectRoot;
+    schedulesDir;
+    dispatchesDir;
+    lastReadAt = 0;
+    lastStateJson;
+    constructor(options = {}) {
+        this.projectRoot = options.projectRoot ?? process.cwd();
+        this.schedulesDir = join(this.projectRoot, FLOW_SCHEDULE_DIR, SCHEDULES_DIR);
+        this.dispatchesDir = join(this.projectRoot, FLOW_SCHEDULE_DIR, DISPATCHES_DIR);
+    }
+    get root() {
+        return this.projectRoot;
+    }
+    /** 检测 flow-schedule 目录是否存在（判断是否安装了 pi-maestro-flow） */
+    async detectMaestro() {
+        try {
+            const dir = join(this.projectRoot, FLOW_SCHEDULE_DIR);
+            const s = await stat(dir);
+            return s.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /** 读取所有活跃的调度快照（带变更检测：状态未变时返回 null）
+     *  只比较 schedules 内容，observedAt 每次不同不参与变更检测 */
+    async readStateChanged() {
+        const state = await this.readState();
+        const json = JSON.stringify(state.schedules);
+        if (json === this.lastStateJson) {
+            return null;
+        }
+        this.lastStateJson = json;
+        return state;
+    }
+    /** 重置变更检测缓存（会话切换/重连时调用） */
+    resetChangeDetection() {
+        this.lastStateJson = undefined;
+    }
+    /** 读取所有活跃的调度快照 */
+    async readState() {
+        const schedules = await this.readAllSchedules();
+        return {
+            schedules,
+            observedAt: new Date().toISOString(),
+        };
+    }
+    async readAllSchedules() {
+        let entries;
+        try {
+            entries = await readdir(this.schedulesDir);
+        }
+        catch {
+            return [];
+        }
+        const results = [];
+        for (const entry of entries) {
+            if (!entry.endsWith(".json"))
+                continue;
+            const scheduleId = entry.slice(0, -5);
+            const summary = await this.readSchedule(scheduleId);
+            if (summary)
+                results.push(summary);
+        }
+        return results.sort((a, b) => a.scheduleId.localeCompare(b.scheduleId));
+    }
+    async readSchedule(scheduleId) {
+        const filePath = join(this.schedulesDir, `${scheduleId}.json`);
+        try {
+            const raw = await readFile(filePath, "utf8");
+            if (raw.length > MAX_FILE_SIZE)
+                return undefined;
+            const record = JSON.parse(raw);
+            const steps = record.steps;
+            const stepIds = record.stepIds ?? Object.keys(steps ?? {});
+            const stepSummaries = [];
+            let completedCount = 0;
+            let totalCount = stepIds.length;
+            for (const stepId of stepIds) {
+                const step = steps?.[stepId];
+                const stepState = String(step?.state ?? "pending");
+                const dispatchIds = step?.attempts ?? [];
+                const dispatches = await this.readDispatches(dispatchIds, scheduleId);
+                const isDone = stepState === "completed" || stepState === "failed" || stepState === "cancelled";
+                if (isDone)
+                    completedCount++;
+                stepSummaries.push({
+                    stepId,
+                    title: String(step?.prompt ?? "").slice(0, 80),
+                    state: stepState,
+                    dispatches,
+                });
+            }
+            const state = this.normalizeScheduleState(String(record.state ?? "draft"));
+            const targetIdentity = record.targetIdentity;
+            const id = targetIdentity
+                ? {
+                    workspaceId: String(targetIdentity.workspaceId ?? ""),
+                    ownerId: String(targetIdentity.ownerId ?? ""),
+                    endpointId: String(targetIdentity.endpointId ?? ""),
+                }
+                : undefined;
+            return {
+                scheduleId,
+                title: String(record.reason ?? record.scheduleId ?? ""),
+                state,
+                progress: { completed: completedCount, total: totalCount },
+                steps: stepSummaries,
+                createdAt: new Date(Number(record.createdAt) ?? 0).toISOString(),
+                updatedAt: new Date(Number(record.updatedAt) ?? 0).toISOString(),
+                targetIdentity: id,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async readDispatches(dispatchIds, scheduleId) {
+        const results = [];
+        for (const dispatchId of dispatchIds) {
+            const summary = await this.readDispatch(dispatchId, scheduleId);
+            if (summary)
+                results.push(summary);
+        }
+        return results;
+    }
+    async readDispatch(dispatchId, scheduleId) {
+        const dir = join(this.dispatchesDir, dispatchId);
+        try {
+            const intentPath = join(dir, "intent.json");
+            const completionPath = join(dir, "completion.json");
+            let state = "prepared";
+            let completedAt;
+            let error;
+            let resultSummary;
+            // 检查 completion 文件
+            try {
+                const completionRaw = await readFile(completionPath, "utf8");
+                const completion = JSON.parse(completionRaw);
+                state = String(completion.outcome ?? "completed");
+                if (state === "failed" || state === "timeout") {
+                    error = String(completion.summary ?? "Unknown error");
+                }
+                resultSummary = String(completion.summary ?? "");
+                completedAt = new Date(Number(completion.settledAt ?? completion.createdAt ?? 0)).toISOString();
+            }
+            catch {
+                // 检查 published 文件
+                try {
+                    await stat(join(dir, "published.json"));
+                    state = "published";
+                }
+                catch {
+                    // 检查 accepted 文件
+                    try {
+                        await stat(join(dir, "accepted.json"));
+                        state = "accepted";
+                    }
+                    catch {
+                        state = "prepared";
+                    }
+                }
+            }
+            // 读取 intent 获取 agent / task 信息
+            let agent;
+            let task;
+            try {
+                const intentRaw = await readFile(intentPath, "utf8");
+                const intent = JSON.parse(intentRaw);
+                agent = String(intent.agent ?? intent.targetSelector ?? "");
+                task = String(intent.instruction ?? "").slice(0, 120);
+            }
+            catch {
+                // ignore
+            }
+            return {
+                dispatchId,
+                state,
+                agent,
+                task,
+                startedAt: undefined,
+                completedAt,
+                resultSummary,
+                error,
+                attempt: 0,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    normalizeScheduleState(raw) {
+        switch (raw) {
+            case "draft":
+            case "active":
+            case "paused":
+            case "completed":
+            case "failed":
+            case "cancelled":
+                return raw;
+            default:
+                return "draft";
+        }
+    }
+}
+//# sourceMappingURL=maestro-state.js.map

package/dist/maestro-state.js.map

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

package/dist/mobile-agent.d.ts

@@ -0,0 +1,86 @@
+/**
+ * mobile-agent 接口类型 — 定义 host 需要的 Pi SDK 会话最小接口
+ * 通过鸭类型兼容 @earendil-works/pi-coding-agent 的 AgentSession
+ */
+import type { ExtensionUIContext, AgentSessionEvent, SessionInfo } from "@earendil-works/pi-coding-agent";
+export interface MobileAgentSession {
+    sessionId: string;
+    sessionName?: string;
+    sessionFile?: string;
+    messages: unknown[];
+    pendingMessageCount: number;
+    isStreaming: boolean;
+    isCompacting: boolean;
+    model?: unknown;
+    thinkingLevel?: string;
+    modelRegistry?: {
+        getAll(): {
+            id?: string;
+            provider?: string;
+            name?: string;
+            reasoning?: boolean;
+            input?: string[];
+        }[];
+        getAvailable?(): {
+            id?: string;
+            provider?: string;
+            name?: string;
+            reasoning?: boolean;
+            input?: string[];
+        }[];
+        getById?(id: string): {
+            id?: string;
+            provider?: string;
+            name?: string;
+        } | undefined;
+    };
+    resourceLoader?: {
+        getSkills?(): {
+            skills: {
+                name: string;
+                description?: string;
+            }[];
+        };
+    };
+    prompt(message: string, options?: {
+        streamingBehavior?: "steer" | "followUp";
+        source?: "rpc" | "extension";
+        images?: unknown[];
+        preflightResult?: (success: boolean) => void;
+    }): Promise<unknown>;
+    steer(message: string, images?: unknown[]): Promise<unknown>;
+    followUp(message: string, images?: unknown[]): Promise<unknown>;
+    setModel?(model: unknown): Promise<void>;
+    setThinkingLevel?(level: string): void;
+    compact?(customInstructions?: string): Promise<unknown>;
+    setSessionName?(name: string): void;
+    abort(): Promise<void>;
+    subscribe(listener: (event: AgentSessionEvent) => void): () => void;
+    bindExtensions(options: {
+        mode?: "tui" | "rpc";
+        uiContext?: ExtensionUIContext;
+        commandContextActions?: Record<string, unknown>;
+        shutdownHandler?: () => void;
+        onError?: (error: {
+            event: string;
+            error: string;
+        }) => void;
+    }): Promise<void>;
+}
+export interface MobileAgentRuntime {
+    session: MobileAgentSession;
+    cwd: string;
+    dispose(): Promise<void>;
+    newSession?(options: unknown): Promise<unknown>;
+    switchSession?(sessionPath: string, options: unknown): Promise<unknown>;
+}
+export interface RuntimeFactory {
+    createRuntime(request: {
+        cwd: string;
+        mode?: "create" | "continue";
+        sessionFile?: string;
+    }): Promise<MobileAgentRuntime>;
+    listSessions(cwd?: string): Promise<SessionInfo[]>;
+}
+export type { SessionInfo };
+//# sourceMappingURL=mobile-agent.d.ts.map

package/dist/mobile-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-agent.d.ts","sourceRoot":"","sources":["../src/mobile-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACZ,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE;QACd,MAAM,IAAI;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QACrG,YAAY,CAAC,IAAI;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QAC5G,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC;KACrF,CAAC;IACF,cAAc,CAAC,EAAE;QACf,SAAS,CAAC,IAAI;YAAE,MAAM,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,WAAW,CAAC,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAAE,CAAC;KACpE,CAAC;IAEF,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,iBAAiB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;QACzC,MAAM,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC;QAC7B,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QACnB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;KAC9C,GACA,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,QAAQ,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,gBAAgB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,OAAO,CAAC,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACpE,cAAc,CAAC,OAAO,EAAE;QACtB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;QACrB,SAAS,CAAC,EAAE,kBAAkB,CAAC;QAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChD,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;QAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;KAC7D,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,aAAa,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzH,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACpD;AAED,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/mobile-agent.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mobile-agent.js.map

package/dist/mobile-agent.js.map

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

package/dist/mobile-ui-context.d.ts

@@ -0,0 +1,26 @@
+import type { ExtensionUIContext } from "@earendil-works/pi-coding-agent";
+import type { ExtensionUiResponse, HostEvent } from "./vendor/shared/index.js";
+/**
+ * MobileExtensionUiBridge — 将 Pi SDK 的 ExtensionUIContext 桥接到移动端
+ *
+ * 这是解决 maestro ask-user-question 在 remote 环境失效的核心：
+ * - maestro 的 ask 工具在 RPC 模式下调用 ctx.ui.select/input/confirm
+ * - 本 bridge 将这些调用转为 extension_ui_request 事件，通过 WS 推给移动端
+ * - 移动端弹窗渲染，用户作答后返回 extension_ui_response
+ */
+export declare class MobileExtensionUiBridge {
+    private readonly sessionId;
+    private readonly emit;
+    private readonly now;
+    private readonly pendingDialogs;
+    constructor(sessionId: string, emit: (event: HostEvent) => void, now?: () => number);
+    createContext(): ExtensionUIContext;
+    respond(requestId: string, response: ExtensionUiResponse): boolean;
+    /** 关闭所有挂起的弹窗（会话中止/关闭时调用），返回已取消的数量 */
+    cancelAll(): number;
+    get pendingCount(): number;
+    private dialog;
+    private recordFireAndForget;
+    private recordRequest;
+}
+//# sourceMappingURL=mobile-ui-context.d.ts.map

package/dist/mobile-ui-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-ui-context.d.ts","sourceRoot":"","sources":["../src/mobile-ui-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAsB,mBAAmB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEnG;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAOhC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG1B;gBAGc,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,EAChC,GAAG,GAAE,MAAM,MAAiB;IAG/C,aAAa,IAAI,kBAAkB;IAmGnC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAelE,qCAAqC;IACrC,SAAS,IAAI,MAAM;IAWnB,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,OAAO,CAAC,MAAM;IAmBd,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,aAAa;CAQtB"}

package/dist/mobile-ui-context.js

@@ -0,0 +1,164 @@
+import { randomUUID } from "node:crypto";
+/**
+ * MobileExtensionUiBridge — 将 Pi SDK 的 ExtensionUIContext 桥接到移动端
+ *
+ * 这是解决 maestro ask-user-question 在 remote 环境失效的核心：
+ * - maestro 的 ask 工具在 RPC 模式下调用 ctx.ui.select/input/confirm
+ * - 本 bridge 将这些调用转为 extension_ui_request 事件，通过 WS 推给移动端
+ * - 移动端弹窗渲染，用户作答后返回 extension_ui_response
+ */
+export class MobileExtensionUiBridge {
+    sessionId;
+    emit;
+    now;
+    pendingDialogs = new Map();
+    constructor(sessionId, emit, now = Date.now) {
+        this.sessionId = sessionId;
+        this.emit = emit;
+        this.now = now;
+    }
+    createContext() {
+        const context = {
+            select: (title, options, opts) => this.dialog({
+                method: "select",
+                title,
+                options,
+                ...(opts?.timeout ? { timeout: opts.timeout } : {}),
+            }, (response) => {
+                if (response.cancelled)
+                    return undefined;
+                // select 为单选：优先 value（字符串）；兼容 selected 数组取其首项
+                if ("value" in response && typeof response.value === "string")
+                    return response.value;
+                if ("selected" in response)
+                    return response.selected[0];
+                return undefined;
+            }),
+            confirm: (title, message, opts) => this.dialog({
+                method: "confirm",
+                title,
+                ...(message ? { message } : {}),
+                ...(opts?.timeout ? { timeout: opts.timeout } : {}),
+            }, (response) => {
+                if (response.cancelled)
+                    return false;
+                return "confirmed" in response ? response.confirmed === true : false;
+            }),
+            input: (title, placeholder, opts) => this.dialog({
+                method: "input",
+                title,
+                ...(placeholder ? { placeholder } : {}),
+                ...(opts?.timeout ? { timeout: opts.timeout } : {}),
+            }, (response) => {
+                if (response.cancelled)
+                    return undefined;
+                return "value" in response ? response.value : undefined;
+            }),
+            editor: (title, prefill) => this.dialog({ method: "editor", title, ...(prefill ? { prefill } : {}) }, (response) => {
+                if (response.cancelled)
+                    return undefined;
+                return "value" in response ? response.value : undefined;
+            }),
+            notify: (message, type) => {
+                this.recordFireAndForget({ method: "notify", message, ...(type ? { notifyType: type } : {}) });
+            },
+            setStatus: (key, text) => {
+                this.recordFireAndForget({ method: "setStatus", statusKey: key, ...(text ? { statusText: text } : {}) });
+            },
+            setWidget: (key, content, options) => {
+                if (content === undefined || Array.isArray(content)) {
+                    this.recordFireAndForget({
+                        method: "setWidget",
+                        widgetKey: key,
+                        ...(content ? { widgetLines: content } : {}),
+                        ...(options?.placement ? { widgetPlacement: options.placement } : {}),
+                    });
+                }
+            },
+            setTitle: (title) => {
+                this.recordFireAndForget({ method: "setTitle", title });
+            },
+            setEditorText: (text) => {
+                this.recordFireAndForget({ method: "set_editor_text", text });
+            },
+            pasteToEditor: (text) => {
+                context.setEditorText(text);
+            },
+            getEditorText: () => "",
+            onTerminalInput: () => () => { },
+            setWorkingMessage: () => { },
+            setWorkingVisible: () => { },
+            setWorkingIndicator: () => { },
+            setHiddenThinkingLabel: () => { },
+            setFooter: () => { },
+            setHeader: () => { },
+            custom: async () => undefined,
+            addAutocompleteProvider: () => { },
+            setEditorComponent: () => { },
+            getEditorComponent: () => undefined,
+            theme: {},
+            getAllThemes: () => [],
+            getTheme: () => undefined,
+            setTheme: () => ({ success: false, error: "Theme switching not supported by maestro-mobile host" }),
+            getToolsExpanded: () => false,
+            setToolsExpanded: () => { },
+        };
+        return context;
+    }
+    respond(requestId, response) {
+        const pending = this.pendingDialogs.get(requestId);
+        if (!pending)
+            return false;
+        clearTimeout(pending.timeout);
+        this.pendingDialogs.delete(requestId);
+        pending.resolve(response);
+        this.emit({
+            type: "extension_ui_cleared",
+            sessionId: this.sessionId,
+            requestId,
+            seq: this.now(),
+        });
+        return true;
+    }
+    /** 关闭所有挂起的弹窗（会话中止/关闭时调用），返回已取消的数量 */
+    cancelAll() {
+        let count = 0;
+        for (const [requestId, pending] of this.pendingDialogs) {
+            clearTimeout(pending.timeout);
+            pending.resolve({ id: requestId, cancelled: true });
+            count++;
+        }
+        this.pendingDialogs.clear();
+        return count;
+    }
+    get pendingCount() {
+        return this.pendingDialogs.size;
+    }
+    dialog(request, parse) {
+        const id = randomUUID();
+        return new Promise((resolve) => {
+            const timeoutMs = typeof request.timeout === "number" ? request.timeout : 120_000;
+            const timeout = setTimeout(() => {
+                this.pendingDialogs.delete(id);
+                resolve(parse({ id, cancelled: true }));
+            }, timeoutMs);
+            this.pendingDialogs.set(id, {
+                resolve: (response) => resolve(parse(response)),
+                timeout,
+            });
+            this.recordRequest({ id, sessionId: this.sessionId, ...request });
+        });
+    }
+    recordFireAndForget(request) {
+        this.recordRequest({ id: randomUUID(), sessionId: this.sessionId, ...request });
+    }
+    recordRequest(request) {
+        this.emit({
+            type: "extension_ui_request",
+            sessionId: this.sessionId,
+            request,
+            seq: this.now(),
+        });
+    }
+}
+//# sourceMappingURL=mobile-ui-context.js.map

package/dist/mobile-ui-context.js.map

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

package/dist/monitor-projection.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Monitor 状态投影 — WorkspaceTelemetry → MonitorState（host/移动端共享的单一投影源）
+ *
+ * 合同要点：
+ *  - outputTail 截断至有界行数/宽度，避免 WS 广播无界数据
+ *  - 变更检测使用稳定键（不含 ageMs/observedAt 等时间派生字段）
+ */
+import type { HostEvent, MonitorState, MonitorWindowSummary, WorkspaceOwnerState, WorkspaceTelemetryState } from "./vendor/shared/index.js";
+export declare function projectWindow(o: WorkspaceOwnerState): MonitorWindowSummary;
+export declare function projectMonitorState(t: WorkspaceTelemetryState): MonitorState;
+/**
+ * 稳定变更键 — 不含 ageMs/observedAt 等时间派生字段。
+ * 对与广播相同的有界投影做确定性 JSON 序列化：投影可见的字段变化必然触发广播，
+ * 且 JSON.stringify 无分隔符碰撞问题。
+ */
+export declare function telemetryStableKey(t: WorkspaceTelemetryState): string;
+/** 从 monitor_state 构造 HostEvent（供 controller emit） */
+export declare function monitorStateEvent(state: MonitorState): HostEvent;
+//# sourceMappingURL=monitor-projection.d.ts.map

package/dist/monitor-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-projection.d.ts","sourceRoot":"","sources":["../src/monitor-projection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,oBAAoB,EAGpB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AA+BlC,wBAAgB,aAAa,CAAC,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CA+B1E;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,uBAAuB,GAAG,YAAY,CAK5E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAKrE;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAEhE"}

package/dist/monitor-projection.js

@@ -0,0 +1,79 @@
+/** outputTail 广播上限：每 agent 最多 8 行、每行 200 字符 */
+const OUTPUT_TAIL_MAX_LINES = 8;
+const OUTPUT_TAIL_MAX_CHARS = 200;
+/** agents 投影上限：每 owner 最多 12 个 agent */
+const AGENTS_MAX = 12;
+function truncateTail(lines) {
+    if (!Array.isArray(lines))
+        return undefined;
+    const tail = lines
+        .slice(-OUTPUT_TAIL_MAX_LINES)
+        .map((l) => String(l).slice(0, OUTPUT_TAIL_MAX_CHARS));
+    return tail.length > 0 ? tail : undefined;
+}
+function projectAgent(a) {
+    if (typeof a !== "object" || a === null)
+        return null;
+    const d = a;
+    return {
+        correlationId: typeof d.correlationId === "string" ? d.correlationId : undefined,
+        name: typeof d.name === "string" ? d.name : undefined,
+        agent: typeof d.agent === "string" ? d.agent : undefined,
+        status: typeof d.status === "string" ? d.status : undefined,
+        phase: typeof d.phase === "string" ? d.phase : undefined,
+        outputTail: truncateTail(d.outputTail),
+        pendingInteractions: typeof d.pendingInteractions === "number" ? d.pendingInteractions : undefined,
+    };
+}
+export function projectWindow(o) {
+    const identity = {
+        workspaceId: o.workspaceId,
+        ownerId: o.ownerId,
+        ownerNonce: "",
+        endpointId: o.sessionId,
+    };
+    const agents = (o.agents ?? []).slice(0, AGENTS_MAX)
+        .map(projectAgent)
+        .filter((a) => a !== null);
+    const facet = {
+        kind: "teammate-agents",
+        target: { identity },
+        revision: String(o.publishedAt),
+        data: {
+            agents,
+            backgroundJobs: Array.isArray(o.backgroundJobs) ? o.backgroundJobs.slice(0, 8) : [],
+            contextPressure: o.contextPressure,
+        },
+    };
+    return {
+        identity,
+        name: o.normalizedCwd.split("/").filter(Boolean).pop() ?? o.normalizedCwd,
+        cwd: o.normalizedCwd,
+        status: o.alive ? "running" : "sleeping",
+        lifecycle: o.alive ? "running" : "disconnected",
+        workStatus: agents.length > 0 ? "active" : "idle",
+        todos: [],
+        attention: [],
+        facets: [facet],
+    };
+}
+export function projectMonitorState(t) {
+    return {
+        windows: t.owners.map(projectWindow),
+        observedAt: t.observedAt,
+    };
+}
+/**
+ * 稳定变更键 — 不含 ageMs/observedAt 等时间派生字段。
+ * 对与广播相同的有界投影做确定性 JSON 序列化：投影可见的字段变化必然触发广播，
+ * 且 JSON.stringify 无分隔符碰撞问题。
+ */
+export function telemetryStableKey(t) {
+    const projected = t.owners.map(projectWindow).sort((a, b) => a.identity.ownerId < b.identity.ownerId ? -1 : a.identity.ownerId > b.identity.ownerId ? 1 : 0);
+    return JSON.stringify(projected);
+}
+/** 从 monitor_state 构造 HostEvent（供 controller emit） */
+export function monitorStateEvent(state) {
+    return { type: "monitor_state", state };
+}
+//# sourceMappingURL=monitor-projection.js.map

package/dist/monitor-projection.js.map

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