pilotswarm 0.4.1 → 0.5.1

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.1",
   "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.1",
     "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/app.js

@@ -264,6 +264,14 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
             requestExit();
             return;
         }
+        // Stop the current turn — the TUI equivalent of the portal Stop button.
+        // ctrl-x is reliable across terminals; ctrl-esc also fires where the
+        // terminal sends it distinctly from a bare Esc. The controller no-ops
+        // (status message) when no turn is running.
+        if (key.ctrl && (input === "x" || key.escape)) {
+            controller.handleCommand(UI_COMMANDS.STOP_TURN).catch(() => {});
+            return;
+        }
         if (focus !== "prompt" && input === "q" && quitStateRef.current.armedUntil > Date.now()) {
             clearQuitArm(false);
             requestExit();
@@ -398,7 +406,7 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
                 }
                 return;
             }
-            if (key.escape || input === "q" || (modal.type === "artifactPicker" && input === "a")) {
+            if (key.escape || input === "q" || (modal.type === "artifactPicker" && input === "a") || (modal.type === "help" && input === "?")) {
                 controller.handleCommand(UI_COMMANDS.CLOSE_MODAL).catch(() => {});
                 return;
             }
@@ -602,21 +610,40 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
                 return;
             }
         }
+        // Sequence tab: j/k move the turn cursor across completed turns, enter
+        // expands/collapses the selected turn (paging/g-G still scroll).
+        if (focus === "inspector" && inspectorTab === "sequence") {
+            if (key.return) {
+                controller.handleCommand(UI_COMMANDS.TOGGLE_SEQUENCE_TURN).catch(() => {});
+                return;
+            }
+            if (key.upArrow || input === "k") {
+                controller.handleCommand(UI_COMMANDS.SEQUENCE_SELECT_PREV).catch(() => {});
+                return;
+            }
+            if (key.downArrow || input === "j") {
+                controller.handleCommand(UI_COMMANDS.SEQUENCE_SELECT_NEXT).catch(() => {});
+                return;
+            }
+        }
 
+        // [ / ] resize the vertical pane of whatever is focused (sessions/chat
+        // share the left split; inspector/activity share the right split).
+        // { / } resize the horizontal left/right column split.
         if (focus !== "prompt" && input === "[") {
-            controller.handleCommand(UI_COMMANDS.GROW_LEFT_PANE).catch(() => {});
+            controller.handleCommand(UI_COMMANDS.SHRINK_FOCUSED_PANE).catch(() => {});
             return;
         }
         if (focus !== "prompt" && input === "]") {
-            controller.handleCommand(UI_COMMANDS.GROW_RIGHT_PANE).catch(() => {});
+            controller.handleCommand(UI_COMMANDS.GROW_FOCUSED_PANE).catch(() => {});
             return;
         }
         if (focus !== "prompt" && input === "{") {
-            controller.handleCommand(UI_COMMANDS.SHRINK_SESSION_PANE).catch(() => {});
+            controller.handleCommand(UI_COMMANDS.GROW_LEFT_PANE).catch(() => {});
             return;
         }
         if (focus !== "prompt" && input === "}") {
-            controller.handleCommand(UI_COMMANDS.GROW_SESSION_PANE).catch(() => {});
+            controller.handleCommand(UI_COMMANDS.GROW_RIGHT_PANE).catch(() => {});
             return;
         }
 
@@ -718,6 +745,10 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
             controller.handleCommand(UI_COMMANDS.OPEN_ARTIFACT_PICKER).catch(() => {});
             return;
         }
+        if (focus !== "prompt" && input === "?") {
+            controller.handleCommand(UI_COMMANDS.OPEN_HELP).catch(() => {});
+            return;
+        }
         if (plainShortcut && input === "m") {
             controller.handleCommand(UI_COMMANDS.CYCLE_INSPECTOR_TAB).catch(() => {});
             return;

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/commands.js

@@ -45,7 +45,13 @@ export const UI_COMMANDS = {
     GROW_RIGHT_PANE: "growRightPane",
     GROW_SESSION_PANE: "growSessionPane",
     SHRINK_SESSION_PANE: "shrinkSessionPane",
+    GROW_FOCUSED_PANE: "growFocusedPane",
+    SHRINK_FOCUSED_PANE: "shrinkFocusedPane",
     OPEN_ARTIFACT_PICKER: "openArtifactPicker",
+    OPEN_HELP: "openHelp",
+    SEQUENCE_SELECT_PREV: "sequenceSelectPrev",
+    SEQUENCE_SELECT_NEXT: "sequenceSelectNext",
+    TOGGLE_SEQUENCE_TURN: "toggleSequenceTurn",
     TOGGLE_LOG_TAIL: "toggleLogTail",
     TOGGLE_STATS_VIEW: "toggleStatsView",
     OPEN_LOG_FILTER: "openLogFilter",