pilotswarm 0.4.1 → 0.5.0

package/mcp/dist/src/tools/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/tools/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QA8GxE"}

package/mcp/dist/src/tools/system.js

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import { jsonResult, errorResult, withToolErrors } from "../util/respond.js";
+/**
+ * Ops preflight & system tools (proposal G7).
+ *
+ *   get_system_status       workers / log config / session policy / creatable agents
+ *   restart_system_session  bounce sweeper, resourcemgr, ... [admin]
+ *   facts_admin             purge tombstoned facts, prune deleted summaries [admin]
+ *
+ * get_system_status turns the `no_worker_claimed` create_session failure into
+ * a preflight check: workers === 0 means don't bother creating sessions yet.
+ */
+export function registerSystemTools(server, ctx) {
+    // Web-mode only: worker count / log config / policy / agents are Web API
+    // operations with no direct-mode equivalent.
+    if (ctx.api) {
+        server.registerTool("get_system_status", {
+            title: "Get System Status",
+            description: "Deployment status: embedded-worker count (workers running inside the portal process — dedicated "
+                + "worker pods report 0 here and that is normal), session-creation policy, creatable agents, and "
+                + "log-tail availability. include narrows the fetch (default all).",
+            inputSchema: {
+                include: z
+                    .array(z.enum(["workers", "policy", "agents", "log_config"]))
+                    .optional()
+                    .describe("Axes to fetch (default all)"),
+            },
+        }, withToolErrors(async ({ include }) => {
+            const wants = new Set(include ?? ["workers", "policy", "agents", "log_config"]);
+            const result = {};
+            const errors = {};
+            const grab = async (key, fn) => {
+                try {
+                    result[key] = await fn();
+                }
+                catch (err) {
+                    errors[key] = err instanceof Error ? err.message : String(err);
+                }
+            };
+            if (wants.has("workers")) {
+                await grab("workers", async () => {
+                    const w = await ctx.api.call("getWorkerCount");
+                    const count = typeof w === "number" ? w : (w?.count ?? null);
+                    return {
+                        embedded_count: count,
+                        note: "Counts workers embedded in the portal process only. Deployments with dedicated worker pods report 0 here — use worker_claimed on create_session responses for per-run liveness.",
+                    };
+                });
+            }
+            if (wants.has("policy"))
+                await grab("policy", () => ctx.api.call("getSessionCreationPolicy"));
+            if (wants.has("agents"))
+                await grab("agents", () => ctx.api.call("listCreatableAgents"));
+            if (wants.has("log_config"))
+                await grab("log_config", () => ctx.api.call("getLogConfig"));
+            if (Object.keys(errors).length > 0)
+                result.errors = errors;
+            return jsonResult(result);
+        }));
+    }
+    // restart_system_session — [admin] disruptive lifecycle operation on the
+    // deployment's system agents (sweeper, resourcemgr, ...).
+    if (ctx.admin) {
+        server.registerTool("restart_system_session", {
+            title: "Restart System Session",
+            description: "Restart a system session (sweeper, resourcemgr, ...) by agent id or session id. disposition "
+                + "controls what happens to the old session: complete (graceful), terminate, or hard_delete. [admin]",
+            inputSchema: {
+                agent_or_session_id: z.string().min(1).describe("System agent id (e.g. 'sweeper') or its session id"),
+                disposition: z.enum(["complete", "terminate", "hard_delete"]).describe("How to dispose of the old session"),
+                reason: z.string().optional().describe("Reason recorded on the restart"),
+            },
+        }, withToolErrors(async ({ agent_or_session_id, disposition, reason }) => {
+            const result = await ctx.mgmt.restartSystemSession(agent_or_session_id, { disposition, reason });
+            // The system-agent set may have changed identity; refresh the
+            // dynamic resource registrations' source of truth.
+            await ctx.refreshSystemAgentIds();
+            return jsonResult({ restarted: true, ...(result && typeof result === "object" ? result : {}) });
+        }));
+        // facts_admin — destructive housekeeping, action-dispatched.
+        server.registerTool("facts_admin", {
+            title: "Facts Admin",
+            description: "Administrative facts housekeeping. action: 'purge' force-purges soft-deleted (tombstoned) facts; "
+                + "'prune_summaries' prunes summaries of deleted sessions older than a cutoff. Both DESTRUCTIVE. [admin]",
+            inputSchema: {
+                action: z.enum(["purge", "prune_summaries"]).describe("The housekeeping operation"),
+                cutoff: z.string().describe("ISO timestamp — purge/prune anything soft-deleted before this"),
+                key_prefix: z.string().optional().describe("purge: restrict to keys under this prefix"),
+                only_unreconciled: z.boolean().optional().describe("purge: only facts whose graph evidence is not yet reconciled"),
+                limit: z.number().int().positive().optional().describe("purge: max rows per call"),
+            },
+        }, withToolErrors(async ({ action, cutoff, key_prefix, only_unreconciled, limit }) => {
+            const cutoffDate = new Date(cutoff);
+            if (Number.isNaN(cutoffDate.getTime()))
+                return errorResult("cutoff must be a valid ISO timestamp");
+            if (action === "purge") {
+                const purged = await ctx.facts.forcePurgeFacts({
+                    cutoff: cutoffDate,
+                    keyPrefix: key_prefix,
+                    onlyUnreconciled: only_unreconciled,
+                    limit,
+                });
+                return jsonResult({ purged });
+            }
+            const pruned = await ctx.mgmt.pruneDeletedSummaries(cutoffDate);
+            return jsonResult({ pruned });
+        }));
+    }
+}
+//# sourceMappingURL=system.js.map

package/mcp/dist/src/tools/system.js.map

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

package/mcp/dist/src/tools/turn-control.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../context.js";
+/**
+ * Turn- and queue-level session control (proposal G3) — finer levers than
+ * abort_session's whole-session cancel:
+ *
+ *   stop_turn               abort the in-flight turn, keep the session
+ *   complete_session        mark done (distinct from cancelled)
+ *   cancel_pending_messages drop queued messages by client message id
+ *   send_session_event      inject a custom event into the session
+ */
+export declare function registerTurnControlTools(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=turn-control.d.ts.map

package/mcp/dist/src/tools/turn-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-control.d.ts","sourceRoot":"","sources":["../../../src/tools/turn-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QA+G7E"}

package/mcp/dist/src/tools/turn-control.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import { jsonResult, errorResult, withToolErrors } from "../util/respond.js";
+/**
+ * Turn- and queue-level session control (proposal G3) — finer levers than
+ * abort_session's whole-session cancel:
+ *
+ *   stop_turn               abort the in-flight turn, keep the session
+ *   complete_session        mark done (distinct from cancelled)
+ *   cancel_pending_messages drop queued messages by client message id
+ *   send_session_event      inject a custom event into the session
+ */
+export function registerTurnControlTools(server, ctx) {
+    async function requireSession(session_id) {
+        const existing = await ctx.mgmt.getSession(session_id);
+        return existing ?? null;
+    }
+    server.registerTool("stop_turn", {
+        title: "Stop Turn",
+        description: "Abort the in-flight turn of a running PilotSwarm session without cancelling the session — it stays "
+            + "alive and accepts new messages. Use abort_session only when the whole session should end.",
+        inputSchema: {
+            session_id: z.string().uuid({ message: "session_id must be a valid UUID" }).describe("The session whose current turn to stop"),
+            reason: z.string().optional().describe("Optional reason, surfaced to the session"),
+            timeout_ms: z.number().int().positive().optional().describe("Max time to wait for the turn to stop"),
+        },
+    }, withToolErrors(async ({ session_id, reason, timeout_ms }) => {
+        if (!(await requireSession(session_id))) {
+            return errorResult("session not found", { session_id });
+        }
+        const result = await ctx.mgmt.stopSessionTurn(session_id, { reason, timeoutMs: timeout_ms });
+        return jsonResult({ stopped: true, ...(result && typeof result === "object" ? result : {}) });
+    }));
+    server.registerTool("complete_session", {
+        title: "Complete Session",
+        description: "Mark a PilotSwarm session completed (a successful terminal state — distinct from abort_session's "
+            + "cancelled). Use when the session's work is done and it should stop cleanly.",
+        inputSchema: {
+            session_id: z.string().uuid({ message: "session_id must be a valid UUID" }).describe("The session to complete"),
+            reason: z.string().optional().describe("Optional completion reason"),
+        },
+    }, withToolErrors(async ({ session_id, reason }) => {
+        if (!(await requireSession(session_id))) {
+            return errorResult("session not found", { session_id });
+        }
+        await ctx.mgmt.completeSession(session_id, reason);
+        return jsonResult({ completed: true });
+    }));
+    server.registerTool("cancel_pending_messages", {
+        title: "Cancel Pending Messages",
+        description: "Cancel queued (not yet processed) messages in a session, identified by the client_message_ids they "
+            + "were sent with. Pair with send_message's client_message_ids parameter.",
+        inputSchema: {
+            session_id: z.string().uuid({ message: "session_id must be a valid UUID" }).describe("The session holding the queued messages"),
+            client_message_ids: z.array(z.string().min(1)).min(1).describe("Client message ids to cancel"),
+        },
+    }, withToolErrors(async ({ session_id, client_message_ids }) => {
+        if (!(await requireSession(session_id))) {
+            return errorResult("session not found", { session_id });
+        }
+        try {
+            await ctx.mgmt.cancelPendingMessage(session_id, client_message_ids);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/not started|NotFound/i.test(msg)) {
+                // Pending-message cancellation rides the orchestration
+                // command channel, which only exists once the session's
+                // orchestration has started. Explain, don't confuse.
+                return errorResult("cannot cancel yet: this session's orchestration has not started, so the command channel "
+                    + "is not live. Monitor the session (get_session_detail include: ['status']) and retry "
+                    + "once orchestration_status is no longer NotFound.", { session_id, client_message_ids });
+            }
+            throw err;
+        }
+        return jsonResult({ cancelled: true, client_message_ids });
+    }));
+    // sendSessionEvent is a Web API session operation; in direct mode there is
+    // no equivalent seam (events are worker-internal), so web-only.
+    if (ctx.api) {
+        server.registerTool("send_session_event", {
+            title: "Send Session Event",
+            description: "Inject a custom named event into a PilotSwarm session (e.g. a webhook-style signal an agent "
+                + "is waiting on). Not a chat message — use send_message for prompts.",
+            inputSchema: {
+                session_id: z.string().uuid({ message: "session_id must be a valid UUID" }).describe("The target session"),
+                event_name: z.string().min(1).describe("Event name the session listens for"),
+                data: z.record(z.string(), z.any()).optional().describe("Event payload"),
+            },
+        }, withToolErrors(async ({ session_id, event_name, data }) => {
+            if (!(await requireSession(session_id))) {
+                return errorResult("session not found", { session_id });
+            }
+            await ctx.api.call("sendSessionEvent", { sessionId: session_id, eventName: event_name, data });
+            return jsonResult({ sent: true, event_name });
+        }));
+    }
+}
+//# sourceMappingURL=turn-control.js.map

package/mcp/dist/src/tools/turn-control.js.map

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

package/mcp/dist/src/util/respond.d.ts

@@ -0,0 +1,21 @@
+/** Shared MCP tool-response helpers — same content shape the existing tool
+ * files emit inline; new tool modules use these to cut boilerplate. */
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+export declare function jsonResult(payload: unknown): ToolResult;
+export declare function errorResult(message: string, extra?: Record<string, unknown>): ToolResult;
+/**
+ * Map a thrown error to a tool error result. Recognizes the Web API's 403
+ * (admin-gated operation hit without the admin role) and shapes it into
+ * actionable text instead of a bare status line.
+ */
+export declare function errorToResult(err: unknown): ToolResult;
+/** Wrap a tool handler with the standard try/catch → errorToResult mapping. */
+export declare function withToolErrors<A extends unknown[]>(fn: (...args: A) => Promise<ToolResult>): (...args: A) => Promise<ToolResult>;
+//# sourceMappingURL=respond.d.ts.map

package/mcp/dist/src/util/respond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.d.ts","sourceRoot":"","sources":["../../../src/util/respond.ts"],"names":[],"mappings":"AAAA;uEACuE;AAEvE,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAIvD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAQxF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAWtD;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,EAC9C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,GACxC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAQrC"}

package/mcp/dist/src/util/respond.js

@@ -0,0 +1,42 @@
+/** Shared MCP tool-response helpers — same content shape the existing tool
+ * files emit inline; new tool modules use these to cut boilerplate. */
+export function jsonResult(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+    };
+}
+export function errorResult(message, extra) {
+    const text = extra
+        ? JSON.stringify({ error: message, ...extra })
+        : `Error: ${message}`;
+    return {
+        content: [{ type: "text", text }],
+        isError: true,
+    };
+}
+/**
+ * Map a thrown error to a tool error result. Recognizes the Web API's 403
+ * (admin-gated operation hit without the admin role) and shapes it into
+ * actionable text instead of a bare status line.
+ */
+export function errorToResult(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const status = err?.status ?? err?.statusCode;
+    if (status === 403 || /\b403\b|forbidden/i.test(message)) {
+        return errorResult("forbidden: this operation requires the deployment's admin role. "
+            + "The MCP server's credential (PILOTSWARM_API_TOKEN or cached login) does not carry it.", { status: 403 });
+    }
+    return errorResult(message);
+}
+/** Wrap a tool handler with the standard try/catch → errorToResult mapping. */
+export function withToolErrors(fn) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (err) {
+            return errorToResult(err);
+        }
+    };
+}
+//# sourceMappingURL=respond.js.map

package/mcp/dist/src/util/respond.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.js","sourceRoot":"","sources":["../../../src/util/respond.ts"],"names":[],"mappings":"AAAA;uEACuE;AAQvE,MAAM,UAAU,UAAU,CAAC,OAAgB;IACvC,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;AACN,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAA+B;IACxE,MAAM,IAAI,GAAG,KAAK;QACd,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;QAC9C,CAAC,CAAC,UAAU,OAAO,EAAE,CAAC;IAC1B,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI;KAChB,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACtC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,MAAM,GAAI,GAAW,EAAE,MAAM,IAAK,GAAW,EAAE,UAAU,CAAC;IAChE,IAAI,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,OAAO,WAAW,CACd,kEAAkE;cAChE,uFAAuF,EACzF,EAAE,MAAM,EAAE,GAAG,EAAE,CAClB,CAAC;IACN,CAAC;IACD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAC1B,EAAuC;IAEvC,OAAO,KAAK,EAAE,GAAG,IAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pilotswarm",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "PilotSwarm application package: terminal UI, browser portal + Web API server, and MCP server — one install, three bins.",
   "type": "module",
   "license": "MIT",
@@ -62,9 +62,10 @@
     "test:tui": "node --test tui/test/*.test.mjs",
     "test:web": "node --test web/test/*.test.mjs",
     "test:ui": "node --test ui/core/test/*.test.mjs",
-    "test:mcp": "node mcp/test/unit/sendCommandAndWait.unit.mjs",
+    "test:mcp": "node mcp/test/unit/sendCommandAndWait.unit.mjs && node mcp/test/unit/registration.unit.mjs && node mcp/test/unit/dispatch.unit.mjs",
     "test:mcp:integration": "node mcp/test/integration/smoke.live.mjs",
-    "test:mcp:integration:all": "node mcp/test/integration/smoke.live.mjs && node mcp/test/integration/tools.live.mjs && node mcp/test/integration/edge-cases.live.mjs && node mcp/test/integration/verify.live.mjs",
+    "test:mcp:integration:horizondb": "MCP_PARITY_REQUIRE=search,graph node --env-file=../../.env.horizondb mcp/test/integration/parity.live.mjs",
+    "test:mcp:integration:all": "node mcp/test/integration/smoke.live.mjs && node mcp/test/integration/tools.live.mjs && node mcp/test/integration/edge-cases.live.mjs && node mcp/test/integration/verify.live.mjs && node mcp/test/integration/parity.live.mjs",
     "clean": "rm -rf web/dist mcp/dist"
   },
   "dependencies": {
@@ -76,7 +77,7 @@
     "hono": "^4.12.10",
     "ink": "^6.8.0",
     "jose": "^6.2.2",
-    "pilotswarm-sdk": "^0.4.1",
+    "pilotswarm-sdk": "^0.5.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "ws": "^8.18.2"

package/tui/bin/tui.js

@@ -4,9 +4,6 @@
 // explicitly opts into another environment for debugging.
 process.env.NODE_ENV ??= "production";
 
-const { syncBundledWorkspaceUiPackages } = await import("../src/sync-workspace-ui.js");
-syncBundledWorkspaceUiPackages({ linkWorkspacePackages: true });
-
 const argv = process.argv.slice(2);
 if (argv[0] === "auth") {
     const { runAuthCommand } = await import("../src/auth/cli.js");

package/tui/src/node-sdk-transport.js

@@ -782,6 +782,30 @@ export class NodeSdkTransport {
         return this.mgmt.getFleetRetrievalUsage(opts);
     }
 
+    async getSessionRetrievalUsage(sessionId, opts) {
+        return this.mgmt.getSessionRetrievalUsage(sessionId, opts);
+    }
+
+    async getSessionTreeRetrievalUsage(sessionId, opts) {
+        return this.mgmt.getSessionTreeRetrievalUsage(sessionId, opts);
+    }
+
+    async getSessionGraphNodeUsage(sessionId, opts) {
+        return this.mgmt.getSessionGraphNodeUsage(sessionId, opts);
+    }
+
+    async getSessionGraphEdgeSearchUsage(sessionId, opts) {
+        return this.mgmt.getSessionGraphEdgeSearchUsage(sessionId, opts);
+    }
+
+    async getSessionGraphSearches(sessionId, limit) {
+        return this.mgmt.getSessionGraphSearches(sessionId, limit);
+    }
+
+    async getFleetGraphNodeUsage(opts) {
+        return this.mgmt.getFleetGraphNodeUsage(opts);
+    }
+
     async getSessionFactsStats(sessionId) {
         return this.mgmt.getSessionFactsStats(sessionId);
     }

package/ui/core/src/selectors.js

@@ -1706,9 +1706,17 @@ function splashArtWidth(text) {
 function buildChatMessageLines(message, maxWidth, options = {}) {
     if (message?.splash) {
         // Swap in the narrow-viewport variant when the main art would
-        // overflow the pane (mobile portal, narrow terminals).
+        // overflow the pane (mobile portal, narrow terminals). When the
+        // width metrics keep the desktop art, still hand renderers the
+        // mobile variant (splashAlt) so environments with real media
+        // queries (the browser) can make the final call by CSS viewport —
+        // character metrics and device width can disagree.
         const useMobile = message.mobileText && splashArtWidth(message.text) > maxWidth;
-        return [{ kind: "markup", value: useMobile ? message.mobileText : message.text }];
+        return [{
+            kind: "markup",
+            value: useMobile ? message.mobileText : message.text,
+            splashAlt: !useMobile && message.mobileText ? message.mobileText : null,
+        }];
     }
 
     if (message?.thinking) {
@@ -2848,6 +2856,15 @@ function formatCompactBytes(value) {
     return `${mb >= 10 ? Math.round(mb) : mb.toFixed(1)} MB`;
 }
 
+/** "12.4×" compression ratio (raw / stored); null when either is missing. */
+function formatCompressionRatio(rawBytes, storedBytes) {
+    const raw = Number(rawBytes);
+    const stored = Number(storedBytes);
+    if (!Number.isFinite(raw) || !Number.isFinite(stored) || raw <= 0 || stored <= 0) return null;
+    const ratio = raw / stored;
+    return `${ratio >= 10 ? ratio.toFixed(0) : ratio.toFixed(1)}×`;
+}
+
 function summarizeEventPreview(text, maxLength = 18) {
     const normalized = String(text || "")
         .replace(/\s+/g, " ")
@@ -4463,6 +4480,8 @@ function buildSessionStatsLines(state, session, maxWidth) {
         title: "Persistence",
         body: formatKeyValueTable([
             ["Snapshot",        formatCompactBytes(summary.snapshotSizeBytes)],
+            ["Uncompressed",    summary.rawSizeBytes ? formatCompactBytes(summary.rawSizeBytes) : null],
+            ["Compression",     formatCompressionRatio(summary.rawSizeBytes, summary.snapshotSizeBytes)],
             ["Dehydrations",    String(summary.dehydrationCount)],
             ["Hydrations",      String(summary.hydrationCount)],
             ["Lossy Handoffs",  String(summary.lossyHandoffCount)],
@@ -4492,6 +4511,8 @@ function buildSessionStatsLines(state, session, maxWidth) {
                 ["Cache Write",  formatCompactNumber(tree.totalTokensCacheWrite)],
                 ["Hit Ratio",    treeHitLabel],
                 ["Snapshot",     formatCompactBytes(tree.totalSnapshotSizeBytes)],
+                ["Uncompressed", tree.totalRawSizeBytes ? formatCompactBytes(tree.totalRawSizeBytes) : null],
+                ["Compression",  formatCompressionRatio(tree.totalRawSizeBytes, tree.totalSnapshotSizeBytes)],
                 ["Dehydrations", String(tree.totalDehydrationCount)],
                 ["Hydrations",   String(tree.totalHydrationCount)],
             ]),

package/ui/react/src/web-app.js

@@ -342,9 +342,17 @@ function normalizeLines(lines) {
             // Markup lines carry preformatted art (splash screens). Tag them
             // so the chat renderer keeps each line intact: the pane's
             // pre-wrap/overflow-wrap rules would rewrap wide art lines at
-            // arbitrary points and scramble the image.
-            for (const parsedLine of parseTerminalMarkupRuns(line.value || "")) {
-                normalized.push({ kind: "runs", runs: parsedLine, preserve: true });
+            // arbitrary points and scramble the image. When a splashAlt is
+            // present, emit BOTH variants tagged by name — CSS shows exactly
+            // one based on the real device viewport, which beats character
+            // metrics at deciding what actually fits.
+            const variants = line.splashAlt
+                ? [{ text: line.value, variant: "desktop" }, { text: line.splashAlt, variant: "mobile" }]
+                : [{ text: line.value, variant: null }];
+            for (const v of variants) {
+                for (const parsedLine of parseTerminalMarkupRuns(v.text || "")) {
+                    normalized.push({ kind: "runs", runs: parsedLine, preserve: true, splashVariant: v.variant });
+                }
             }
             continue;
         }
@@ -1322,12 +1330,13 @@ function parseStructuredChatBlocks(lines = []) {
         // detection entirely and render as one preserve block, so no line
         // ever rewraps or gets reinterpreted as a structured element.
         if (currentLine?.preserve) {
+            const variant = currentLine.splashVariant || null;
             const preserveLines = [];
-            while (index < lines.length && lines[index]?.preserve) {
+            while (index < lines.length && lines[index]?.preserve && (lines[index].splashVariant || null) === variant) {
                 preserveLines.push(lines[index]);
                 index += 1;
             }
-            blocks.push({ type: "preserve", lines: preserveLines });
+            blocks.push({ type: "preserve", lines: preserveLines, splashVariant: variant });
             continue;
         }
 
@@ -1483,7 +1492,8 @@ function StructuredChatBlocks({ lines, theme }) {
     return React.createElement(React.Fragment, null,
         blocks.map((block, index) => {
             if (block.type === "preserve") {
-                return React.createElement("div", { key: `preserve:${index}`, className: "ps-chat-preserve-block" },
+                const variantClass = block.splashVariant ? ` is-splash-${block.splashVariant}` : "";
+                return React.createElement("div", { key: `preserve:${index}`, className: `ps-chat-preserve-block${variantClass}` },
                     block.lines.map((line, lineIndex) => React.createElement(Line, {
                         key: `preserve:${index}:${lineIndex}`,
                         line,
@@ -4145,6 +4155,41 @@ export function PilotSwarmWebApp({ controller }) {
     const viewport = useMeasuredViewport(viewportRef);
     const mainGridViewport = useMeasuredViewport(mainGridRef);
     const gridViewport = computeGridViewport(viewport);
+
+    // Publish the real viewport in character cells. Without this the ui-core
+    // layout model runs on its 120×40 fallback everywhere in the browser, so
+    // width-derived behavior (markdown wrap width, render metrics, the
+    // splashMobile width swap) assumed a ~120-column terminal regardless of
+    // device — phones kept getting desktop splash art narrower than ~76 cols.
+    React.useEffect(() => {
+        const publish = () => {
+            const probe = document.createElement("span");
+            probe.style.cssText = "position:absolute;visibility:hidden;white-space:pre;";
+            // Measure with the font real lines render in — an off-context
+            // probe can inherit a different size and skew the column count.
+            const sample = document.querySelector(".ps-scroll-panel .ps-line") || document.querySelector(".ps-line");
+            if (sample) probe.style.font = window.getComputedStyle(sample).font;
+            probe.textContent = "0".repeat(100);
+            (sample?.parentElement || document.body).appendChild(probe);
+            const charWidth = (probe.getBoundingClientRect().width / 100) || 8;
+            probe.remove();
+            controller.dispatch({
+                type: "ui/viewport",
+                width: Math.floor(window.innerWidth / charWidth),
+                height: Math.floor(window.innerHeight / SCROLL_ROW_HEIGHT),
+            });
+        };
+        publish();
+        let timer;
+        const onResize = () => { clearTimeout(timer); timer = setTimeout(publish, 150); };
+        window.addEventListener("resize", onResize);
+        window.addEventListener("orientationchange", onResize);
+        return () => {
+            clearTimeout(timer);
+            window.removeEventListener("resize", onResize);
+            window.removeEventListener("orientationchange", onResize);
+        };
+    }, [controller]);
     const [chatFocusMode, setChatFocusMode] = React.useState(false);
     const [chatFocusPane, setChatFocusPane] = React.useState(null);
     const state = useControllerSelector(controller, (rootState) => ({