pi-maestro-mobile 0.4.0 → 0.5.1

package/README.md

@@ -23,7 +23,17 @@ pi-maestro-mobile --port 4739
 pi install npm:pi-maestro-mobile
 ```
 
-（薄扩展入口：`/maestro-host` 命令管理守护进程，规划中；当前版本请用方式一。）
+安装后可在任意 Pi TUI 中使用薄扩展命令管理独立 Host：
+
+```text
+/maestro-mobile start    # 幂等启动
+/maestro-mobile status   # 查看状态、版本和 token 摘要
+/maestro-mobile status --current # 比较当前 Pi/Plugin/Broker/Host 四层状态
+/maestro-mobile qr       # 生成二维码与 8 位短码
+/maestro-mobile stop     # 停止 PID 文件指向的 Host 实例
+```
+
+扩展只负责启动、探测、配对与停止；Host 是独立常驻进程，不随当前 Pi 会话退出。
 
 ### 方式三：Docker（看板模式）
 
@@ -36,8 +46,7 @@ docker run -d --name maestro-mobile \
   maestro-mobile
 ```
 
-容器模式能力边界：Dashboard / Monitor 看板、会话历史浏览、usage 统计**可用**；
-`open_session` / `steer_window` 的会话接管**不可用**（需要容器内安装 pi 及认证上下文）。
+容器模式能力边界：Dashboard / Monitor 看板、会话历史浏览、usage 统计**可用**；会话控制**不可用**（需要容器内安装 pi 及认证上下文）。
 详细说明见仓库 `docs/deploy.md`。
 
 ## 使用
@@ -54,16 +63,18 @@ pi-maestro-mobile [--port 4739] [--host 0.0.0.0] [--token <secret>] [--project-r
 | `--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=`）。
+`MAESTRO_MOBILE_ROLLOUT` 可设为 `disabled`、`shadow` 或 `enabled`（默认），用于控制 Protocol v2 rollout。
+
+官方 App 推荐通过 `/maestro-mobile qr` 配对。协议端点格式为 `ws://<PC 局域网 IP>:4739/ws`，token 可使用查询参数或 Bearer header 传递。
 
 ## 守护进程
 
 **macOS（launchd）**：
 
 ```bash
-cp deploy/com.maestro-mobile.host.plist ~/Library/LaunchAgents/
+cp deploy/com.maestro-mobile.plist ~/Library/LaunchAgents/
 # 编辑 plist 里的安装路径、WorkingDirectory、token
-launchctl load ~/Library/LaunchAgents/com.maestro-mobile.host.plist
+launchctl load ~/Library/LaunchAgents/com.maestro-mobile.plist
 ```
 
 **Linux（systemd）**：
@@ -75,11 +86,51 @@ sudo systemctl enable --now maestro-mobile
 
 ## HTTP 接口速览
 
+Host CLI 始终启用 token。除 `/api/pair-short` 使用 8 位一次性短码外，下列 HTTP 路由都需要 Bearer 或 `?token=` 鉴权。
+
 | 路由 | 说明 |
 |---|---|
-| `GET /api/health` | 存活检查 |
+| `GET /api/pair-short` | 短码换 token、候选 IP 和端口 |
+| `GET /api/health` | 存活检查；无 token 时 `401` 也表示服务已监听 |
 | `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`） |
+| `GET /api/desktop/current` | 认证的 Broker link、epoch/revision、projection 和 exact target 诊断 |
+| `GET /api/sessions` | 会话列表（`cwd`/`query`/`limit`/`cursor`/`projectCwds`） |
+| `GET /api/pair-ips` | 配对候选 IP 列表 |
+| `GET /api/workspace-telemetry` | Monitor 窗口投影 |
+| `GET /api/maestro` / `GET /api/maestro-settings` | flow-schedule 调度状态 / 设置总览 |
+| `GET /api/file` | 图片只读预览 |
+| `GET /api/extension-ui/pending` | 兼容占位，固定返回 `pending: 0` |
+| `GET /api/live-sessions` | 已弃用，返回 410（不属于 Protocol v2） |
+| `WS /ws` | 实时事件流 + 客户端命令（协议见 `@maestro-mobile/shared`，摘要见 `docs/protocol.md`） |
+
+真实 Ask 状态通过 WS 的 `extension_ui_request` / `extension_ui_cleared` 事件投影。
+
+## Desktop Plugin 与 Singleton Broker（控制桌面 TUI 会话）
+
+| 路径 | owner / 用途 |
+|---|---|
+| `~/.pi/maestro-mobile/ipc/desktop-plugin.sock` | Broker 独占的 Plugin UDS，NDJSON，权限 `0600` |
+| `~/.pi/maestro-mobile/ipc/desktop-broker-host.sock` | Host 独占的 Broker uplink UDS，权限 `0600` |
+| `~/.pi/maestro-mobile-ipc-secret` | Plugin/Broker/Host 共享密钥 |
+| `~/.pi/maestro-mobile/ipc/desktop-plugin-registry.json` | Broker 诊断快照；不是 live authority，不能恢复 transport |
+| `~/.pi/maestro-mobile/desktop-broker.pid` | singleton Broker PID |
+
+行为要点：
+
+- Broker 内存 registry 是唯一 live authority；每次 mutation 有单调 revision，Host 只接受同一 epoch 的 contiguous delta。
+- 所有控制与事件都绑定 exact target：`sessionId + endpointId + normalizedCwd + processGeneration`，不做 cwd/名称/PID/时间推断。
+- Host restart 只重建 Broker uplink projection，不应断开 Plugin；Broker crash 后 Plugin 按 bounded reconnect 重连，旧 JSON 不会伪造在线 target。
+- 升级或协议不兼容时，先执行 `/maestro-mobile stop`，更新 npm 包或重新构建后执行 `/maestro-mobile start`；Desktop Plugin v1 必须 reload/restart 使用 v2。
+- 若 `desktop-plugin.sock` 或 `desktop-broker-host.sock` 被其他进程占用，先停止旧 Host/Broker 实例，确认 PID/lock/log 后再启动，不要删除仍被活进程使用的 socket。
+- `/maestro-mobile status --current` 只读比较四层状态，输出 `synced`、`drift`、`target_missing`、`plugin_disconnected`、`broker_host_disconnected`、`host_unreachable` 或 `broker_flapping`。
+
+完整字段见 [`docs/protocol.md`](../../docs/protocol.md#desktop-plugin-协议)。
+
+
+## 构建与产物耦合（重要）
+
+Host 运行时通过 `@maestro-mobile/shared` 的 **`dist`** 解析协议 validator，而不是 `src`。因此修改 `packages/shared/src` 后：
+
+1. 必须先 `pnpm --filter @maestro-mobile/shared build` 重建 `dist`；
+2. 否则 Host 会按**旧协议**拒绝新帧（表现为新 operation 返回 `invalid_frame` / `desktop_confirmation_unavailable`，而 `typecheck` 与源码测试可能全绿）；
+3. 验证时必须包含真实运行时探针（真实 UDS + 真实 Host 进程），不能只靠单元测试。

package/dist/application/application-command-router.d.ts

@@ -0,0 +1,90 @@
+import type { MonitorReadSnapshot } from "./monitor-read-service.js";
+import type { MonitorQueryService } from "./monitor-query-service.js";
+import type { SessionCommand, CommandResult, SessionCommandService } from "./session-command-service.js";
+import type { SessionListOptions, QueryResult, SessionQueryService } from "./session-query-service.js";
+import type { SessionSnapshot, HostSessionList, TimelineItem, ExtensionUiResponse } from "../vendor/shared/index.js";
+import type { SessionTargetIdentity } from "../control/SessionDirectory.js";
+import type { UsageTotals } from "../usage-reader.js";
+import type { OpenSessionRequest } from "../types.js";
+export interface ApplicationLifecycle {
+    openSession(request: OpenSessionRequest): Promise<{
+        id: string;
+    }>;
+    closeSession(sessionId: string, target?: SessionTargetIdentity): Promise<boolean>;
+    respondToExtensionUi(sessionId: string, requestId: string, response: ExtensionUiResponse, target?: SessionTargetIdentity): Promise<boolean>;
+    sessionOperation?(operation: SessionOperation): Promise<unknown>;
+    readMaestroState?(): Promise<unknown>;
+    readSettings?(): Promise<unknown>;
+    updateSettings?(patch: Record<string, unknown>): Promise<unknown>;
+}
+export type SessionOperation = {
+    kind: "load_more_history";
+    target: SessionTargetIdentity;
+    count?: number;
+} | {
+    kind: "search_history";
+    target: SessionTargetIdentity;
+    keyword: string;
+    maxResults: number;
+    previewLength: number;
+} | {
+    kind: "list_models";
+    target: SessionTargetIdentity;
+} | {
+    kind: "list_skills";
+    target: SessionTargetIdentity;
+} | {
+    kind: "set_model";
+    target: SessionTargetIdentity;
+    modelId: string;
+    provider?: string;
+} | {
+    kind: "compact";
+    target: SessionTargetIdentity;
+    customInstructions?: string;
+} | {
+    kind: "rename_session";
+    target: SessionTargetIdentity;
+    name: string;
+};
+export type ApplicationQuery = {
+    kind: "session_list";
+    options?: SessionListOptions;
+} | {
+    kind: "session_snapshot";
+    target: SessionTargetIdentity;
+} | {
+    kind: "session_history";
+    target: SessionTargetIdentity;
+    count?: number;
+} | {
+    kind: "session_usage";
+    target: SessionTargetIdentity;
+} | {
+    kind: "monitor";
+};
+export type ApplicationQueryResult = HostSessionList | QueryResult<SessionSnapshot> | QueryResult<{
+    items: TimelineItem[];
+    hasMore: boolean;
+    totalEntries: number;
+    historyAvailable?: boolean;
+}> | QueryResult<UsageTotals> | MonitorReadSnapshot;
+export declare class ApplicationCommandRouter {
+    private readonly commands;
+    private readonly sessions;
+    private readonly monitor;
+    private readonly lifecycle?;
+    constructor(commands: SessionCommandService, sessions: SessionQueryService, monitor: MonitorQueryService, lifecycle?: ApplicationLifecycle | undefined);
+    command(command: SessionCommand): Promise<CommandResult>;
+    query(query: ApplicationQuery): Promise<ApplicationQueryResult>;
+    openSession(request: OpenSessionRequest): Promise<{
+        id: string;
+    }>;
+    closeSession(sessionId: string, target?: SessionTargetIdentity): Promise<boolean>;
+    respondToExtensionUi(sessionId: string, requestId: string, response: ExtensionUiResponse, target?: SessionTargetIdentity): Promise<boolean>;
+    sessionOperation(operation: SessionOperation): Promise<unknown>;
+    readMaestroState(): Promise<unknown>;
+    readSettings(): Promise<unknown>;
+    updateSettings(patch: Record<string, unknown>): Promise<unknown>;
+}
+//# sourceMappingURL=application-command-router.d.ts.map

package/dist/application/application-command-router.d.ts.map

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

package/dist/application/application-command-router.js

@@ -0,0 +1,58 @@
+export class ApplicationCommandRouter {
+    commands;
+    sessions;
+    monitor;
+    lifecycle;
+    constructor(commands, sessions, monitor, lifecycle) {
+        this.commands = commands;
+        this.sessions = sessions;
+        this.monitor = monitor;
+        this.lifecycle = lifecycle;
+    }
+    command(command) {
+        return this.commands.execute(command);
+    }
+    query(query) {
+        switch (query.kind) {
+            case "session_list": return this.sessions.list(query.options);
+            case "session_snapshot": return this.sessions.snapshot(query.target);
+            case "session_history": return this.sessions.history(query.target, query.count);
+            case "session_usage": return this.sessions.usage(query.target);
+            case "monitor": return this.monitor.read();
+        }
+    }
+    openSession(request) {
+        if (!this.lifecycle)
+            return Promise.reject(new Error("session lifecycle unavailable"));
+        return this.lifecycle.openSession(request);
+    }
+    closeSession(sessionId, target) {
+        if (!this.lifecycle)
+            return Promise.reject(new Error("session lifecycle unavailable"));
+        return this.lifecycle.closeSession(sessionId, target);
+    }
+    respondToExtensionUi(sessionId, requestId, response, target) {
+        return this.lifecycle?.respondToExtensionUi(sessionId, requestId, response, target) ?? Promise.resolve(false);
+    }
+    sessionOperation(operation) {
+        if (!this.lifecycle?.sessionOperation)
+            return Promise.reject(new Error("session operation unavailable"));
+        return this.lifecycle.sessionOperation(operation);
+    }
+    readMaestroState() {
+        if (!this.lifecycle?.readMaestroState)
+            return Promise.reject(new Error("maestro state unavailable"));
+        return this.lifecycle.readMaestroState();
+    }
+    readSettings() {
+        if (!this.lifecycle?.readSettings)
+            return Promise.reject(new Error("settings unavailable"));
+        return this.lifecycle.readSettings();
+    }
+    updateSettings(patch) {
+        if (!this.lifecycle?.updateSettings)
+            return Promise.reject(new Error("settings unavailable"));
+        return this.lifecycle.updateSettings(patch);
+    }
+}
+//# sourceMappingURL=application-command-router.js.map

package/dist/application/application-command-router.js.map

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

package/dist/application/monitor-query-service.d.ts

@@ -0,0 +1,9 @@
+import type { MonitorState } from "../vendor/shared/index.js";
+import type { MonitorReadService, MonitorReadSnapshot } from "./monitor-read-service.js";
+export declare class MonitorQueryService {
+    private readonly monitor;
+    constructor(monitor: MonitorReadService);
+    read(): Promise<MonitorReadSnapshot>;
+    readState(): Promise<MonitorState>;
+}
+//# sourceMappingURL=monitor-query-service.d.ts.map

package/dist/application/monitor-query-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-query-service.d.ts","sourceRoot":"","sources":["../../src/application/monitor-query-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEzF,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kBAAkB;IAExD,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIpC,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;CAGnC"}

package/dist/application/monitor-query-service.js

@@ -0,0 +1,13 @@
+export class MonitorQueryService {
+    monitor;
+    constructor(monitor) {
+        this.monitor = monitor;
+    }
+    read() {
+        return this.monitor.read();
+    }
+    readState() {
+        return this.monitor.read().then(({ state }) => state);
+    }
+}
+//# sourceMappingURL=monitor-query-service.js.map

package/dist/application/monitor-query-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-query-service.js","sourceRoot":"","sources":["../../src/application/monitor-query-service.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAE5D,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/application/monitor-read-service.d.ts

@@ -0,0 +1,21 @@
+import type { MonitorState, WorkspaceTelemetryState } from "../vendor/shared/index.js";
+import type { WorkspaceTelemetryReader } from "../workspace-telemetry.js";
+export interface MonitorReadSnapshot {
+    state: MonitorState;
+    stableKey: string;
+    revision: number;
+}
+export type MonitorTelemetrySource = Pick<WorkspaceTelemetryReader, "read"> | (() => Promise<WorkspaceTelemetryState>);
+/**
+ * Read-only Monitor query service. Both pull and push callers consume the same
+ * bounded projection and the same revision/stable-key state machine.
+ */
+export declare class MonitorReadService {
+    private readonly source;
+    private lastStableKey;
+    private revision;
+    private readChain;
+    constructor(source: MonitorTelemetrySource);
+    read(): Promise<MonitorReadSnapshot>;
+}
+//# sourceMappingURL=monitor-read-service.d.ts.map

package/dist/application/monitor-read-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-read-service.d.ts","sourceRoot":"","sources":["../../src/application/monitor-read-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,wBAAwB,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC;AAEvH;;;GAGG;AACH,qBAAa,kBAAkB;IAMjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAK;IAErB,OAAO,CAAC,SAAS,CAAoC;gBAExB,MAAM,EAAE,sBAAsB;IAErD,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC;CA+B3C"}

package/dist/application/monitor-read-service.js

@@ -0,0 +1,47 @@
+import { projectMonitorWindows, telemetryStableKeyFromWindows } from "../monitor-projection.js";
+/**
+ * Read-only Monitor query service. Both pull and push callers consume the same
+ * bounded projection and the same revision/stable-key state machine.
+ */
+export class MonitorReadService {
+    source;
+    lastStableKey;
+    revision = 0;
+    readChain = Promise.resolve();
+    constructor(source) {
+        this.source = source;
+    }
+    async read() {
+        let resolveResult;
+        let rejectResult;
+        const result = new Promise((resolve, reject) => {
+            resolveResult = resolve;
+            rejectResult = reject;
+        });
+        const run = this.readChain.then(async () => {
+            try {
+                const telemetry = typeof this.source === "function"
+                    ? await this.source()
+                    : await this.source.read();
+                const windows = projectMonitorWindows(telemetry);
+                const state = { windows, observedAt: telemetry.observedAt };
+                const stableKey = telemetryStableKeyFromWindows(windows);
+                if (stableKey !== this.lastStableKey) {
+                    this.lastStableKey = stableKey;
+                    this.revision += 1;
+                }
+                resolveResult({
+                    state: { ...state, revision: this.revision },
+                    stableKey,
+                    revision: this.revision,
+                });
+            }
+            catch (error) {
+                rejectResult(error);
+            }
+        });
+        this.readChain = run.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+//# sourceMappingURL=monitor-read-service.js.map

package/dist/application/monitor-read-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-read-service.js","sourceRoot":"","sources":["../../src/application/monitor-read-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAWhG;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAMA;IALrB,aAAa,CAAqB;IAClC,QAAQ,GAAG,CAAC,CAAC;IAEb,SAAS,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAErD,YAA6B,MAA8B;QAA9B,WAAM,GAAN,MAAM,CAAwB;IAAG,CAAC;IAE/D,KAAK,CAAC,IAAI;QACR,IAAI,aAAoD,CAAC;QACzD,IAAI,YAAyC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClE,aAAa,GAAG,OAAO,CAAC;YACxB,YAAY,GAAG,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACzC,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU;oBACjD,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE;oBACrB,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;gBACjD,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;gBAC5D,MAAM,SAAS,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;gBACzD,IAAI,SAAS,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;oBACrC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;oBAC/B,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;gBACrB,CAAC;gBACD,aAAa,CAAC;oBACZ,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;oBAC5C,SAAS;oBACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;iBACxB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/application/session-command-service.d.ts

@@ -0,0 +1,33 @@
+import type { JsonValue, OperationReceipt } from "../vendor/shared/index.js";
+import type { SessionDirectory, SessionTargetIdentity } from "../control/SessionDirectory.js";
+export type SessionCommandKind = "prompt" | "steer" | "follow_up" | "abort" | "set_model" | "set_thinking";
+export interface SessionCommand {
+    requestId: string;
+    target: SessionTargetIdentity;
+    kind: SessionCommandKind;
+    message?: string;
+    modelId?: string;
+    provider?: string;
+    level?: string;
+    images?: unknown[];
+}
+export interface CommandResult extends OperationReceipt {
+    error?: {
+        code: string;
+        message?: string;
+    };
+    result?: JsonValue;
+}
+export interface DesktopControlGateway {
+    execute(command: SessionCommand): Promise<CommandResult>;
+    query(target: SessionTargetIdentity, operation: "list_models" | "list_skills"): Promise<unknown>;
+}
+export declare class SessionCommandService {
+    private readonly directory;
+    private readonly desktopGateway?;
+    private readonly ledger;
+    constructor(directory: SessionDirectory, desktopGateway?: DesktopControlGateway | undefined);
+    execute(command: SessionCommand): Promise<CommandResult>;
+    clearIdempotency(): void;
+}
+//# sourceMappingURL=session-command-service.d.ts.map

package/dist/application/session-command-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-command-service.d.ts","sourceRoot":"","sources":["../../src/application/session-command-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAmB,MAAM,2BAA2B,CAAC;AAE9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE9F,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,CAAC;AAE3G,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzD,KAAK,CAAC,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClG;AAqBD,qBAAa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAJlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAG9C,SAAS,EAAE,gBAAgB,EAC3B,cAAc,CAAC,EAAE,qBAAqB,YAAA;IAGzD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAyCxD,gBAAgB,IAAI,IAAI;CAGzB"}

package/dist/application/session-command-service.js

@@ -0,0 +1,80 @@
+import { IdempotencyLedger } from "../control/idempotency-ledger.js";
+function commandScope(command) {
+    return JSON.stringify([command.kind, command.target.sessionId, command.target.endpointId, command.target.normalizedCwd, command.target.processGeneration]);
+}
+function result(command, revision, status, error) {
+    return {
+        requestId: command.requestId,
+        operation: command.kind,
+        status,
+        revision,
+        ...(error ? { error } : {}),
+    };
+}
+export class SessionCommandService {
+    directory;
+    desktopGateway;
+    ledger = new IdempotencyLedger();
+    constructor(directory, desktopGateway) {
+        this.directory = directory;
+        this.desktopGateway = desktopGateway;
+    }
+    execute(command) {
+        return this.ledger.run(command.requestId, commandScope(command), async () => {
+            const target = this.directory.resolve(command.target, command.kind);
+            if (!target)
+                return result(command, this.directory.revision, "unknown", { code: "target_unavailable" });
+            if (target.kind === "desktop") {
+                if (!this.desktopGateway) {
+                    return result(command, this.directory.revision, "unknown", { code: "desktop_gateway_unavailable" });
+                }
+                try {
+                    const response = await this.desktopGateway.execute(command);
+                    return { ...response, requestId: command.requestId, operation: command.kind, revision: this.directory.revision };
+                }
+                catch {
+                    return result(command, this.directory.revision, "unknown", { code: "desktop_confirmation_unavailable" });
+                }
+            }
+            const runner = target.runner;
+            if (!runner)
+                return result(command, this.directory.revision, "unknown", { code: "host_runner_unavailable" });
+            try {
+                if (command.kind === "prompt") {
+                    if (runner.state.runState === "streaming")
+                        await runner.steer(command.message ?? "");
+                    else
+                        await runner.prompt(command.message ?? "", undefined, command.images);
+                }
+                else if (command.kind === "steer")
+                    await runner.steer(command.message ?? "");
+                else if (command.kind === "follow_up")
+                    await runner.followUp(command.message ?? "");
+                else if (command.kind === "set_model") {
+                    if (!command.modelId || typeof runner.setModel !== "function")
+                        throw new Error("model_unavailable");
+                    const changed = await runner.setModel(command.modelId, command.provider);
+                    if (!changed.ok)
+                        return result(command, this.directory.revision, "failed", { code: changed.error ?? "model_change_failed" });
+                }
+                else if (command.kind === "set_thinking") {
+                    if (!command.level || typeof runner.setThinking !== "function")
+                        throw new Error("thinking_unavailable");
+                    const changed = runner.setThinking(command.level);
+                    if (!changed.ok)
+                        return result(command, this.directory.revision, "failed", { code: changed.error ?? "thinking_change_failed" });
+                }
+                else
+                    await runner.abort();
+                return result(command, this.directory.revision, "observed");
+            }
+            catch {
+                return result(command, this.directory.revision, "failed", { code: "host_command_failed" });
+            }
+        });
+    }
+    clearIdempotency() {
+        this.ledger.clear();
+    }
+}
+//# sourceMappingURL=session-command-service.js.map

package/dist/application/session-command-service.js.map

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

package/dist/application/session-query-service.d.ts

@@ -0,0 +1,47 @@
+import type { HostSessionList, MonitorState, OperationStatus, SessionPresentation, SessionSnapshot, TimelineItem } from "../vendor/shared/index.js";
+import type { SessionDirectory, SessionDirectoryTarget, SessionTargetIdentity } from "../control/SessionDirectory.js";
+import type { UsageTotals } from "../usage-reader.js";
+export interface SessionListSource {
+    listSessions(cwd?: string): Promise<unknown[]>;
+}
+export interface SessionListOptions {
+    cwd?: string;
+    projectCwds?: string[];
+    query?: string;
+    limit?: number;
+    cursor?: string;
+    includeMonitor?: boolean;
+    sessionIds?: string[];
+    latestForCwds?: string[];
+}
+export interface QueryResult<T> {
+    ok: boolean;
+    value?: T;
+    status?: Extract<OperationStatus, "unknown" | "failed">;
+    error?: {
+        code: string;
+        message?: string;
+    };
+    revision: number;
+}
+export declare class SessionQueryService {
+    private readonly source;
+    private readonly directory;
+    private readonly presentationFor?;
+    private readonly now;
+    private readonly monitorState?;
+    private readonly targetFor?;
+    private readonly desktopHistory;
+    constructor(source: SessionListSource, directory: SessionDirectory, presentationFor?: ((sessionId: string) => SessionPresentation | undefined) | undefined, now?: () => number, monitorState?: (() => Promise<MonitorState>) | undefined, targetFor?: ((sessionId: string) => SessionDirectoryTarget | undefined) | undefined);
+    list(options?: SessionListOptions): Promise<HostSessionList>;
+    snapshot(target: SessionTargetIdentity): Promise<QueryResult<SessionSnapshot>>;
+    history(target: SessionTargetIdentity, count?: number): Promise<QueryResult<{
+        items: TimelineItem[];
+        hasMore: boolean;
+        totalEntries: number;
+        historyAvailable?: boolean;
+    }>>;
+    usage(target: SessionTargetIdentity): Promise<QueryResult<UsageTotals>>;
+    private withPresentation;
+}
+//# sourceMappingURL=session-query-service.d.ts.map

package/dist/application/session-query-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-query-service.d.ts","sourceRoot":"","sources":["../../src/application/session-query-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAiC,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAwB,eAAe,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzM,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACtH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAyHD,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAR7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+D;gBAG3E,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,gBAAgB,EAC3B,eAAe,CAAC,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,mBAAmB,GAAG,SAAS,aAAA,EACxE,GAAG,GAAE,MAAM,MAAiB,EAC5B,YAAY,CAAC,GAAE,MAAM,OAAO,CAAC,YAAY,CAAC,aAAA,EAC1C,SAAS,CAAC,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,sBAAsB,GAAG,SAAS,aAAA;IAGlF,IAAI,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IAuIhE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAqD9E,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAiB3K,KAAK,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IA2B7E,OAAO,CAAC,gBAAgB;CAMzB"}