pmx-canvas 0.9.2 → 0.10.0

package/skills/pmx-canvas/SKILL.md

@@ -106,7 +106,7 @@ for the authoritative stop, viewport, persistence, reset, group-order, and captu
 
 ## Runtime prerequisites
 
-PMX Canvas 0.9.2 requires **Bun >=1.4.4**, including when installed through npm.
+PMX Canvas 0.10.0 requires **Bun >=1.4.4**, including when installed through npm.
 Check `bun --version` and ensure Bun is on the MCP host's PATH, not just your shell's;
 use an absolute executable path if needed. Install/configure only when requested.
 For pinned installation, MCP configuration, managed services, and disposable verification,
@@ -264,10 +264,15 @@ json-render, a graph, or an HTML primitive is sufficient.
 
 ## Current MCP Composites
 
-The live MCP surface is **24 tools**: the 18 composites below plus 6 standalones. This table is
+The live MCP surface is **25 tools**: the 18 composites below plus 7 standalones. This table is
 kept in sync with the server's composite registry; `tools/list` on a fresh `pmx-canvas --mcp` is
 always authoritative, independent of the installed release version.
 
+Use `canvas_help {}` to list MCP registry operation names, then `canvas_help { op: "node.add" }`
+for that operation's public tool, argument schema and guidance. Help does not start or read a
+canvas. The schema includes routing selectors and required fields; handlers still enforce
+conditional requirements. Use `tools/list` for non-registry tools such as `canvas_screenshot`.
+
 | Composite | Actions |
 |-----------|---------|
 | `canvas_import` | `list`, `read`, `submit`, `unavailable` |
@@ -303,7 +308,7 @@ Important routing:
 As of v0.3.0, the 57 legacy single-purpose tools from the v0.2 compatibility window are removed.
 The composites above plus the retained standalones are now the whole MCP surface: `canvas_batch`,
 `canvas_pin_nodes`, `canvas_screenshot`, `canvas_ax_interaction`, `canvas_ingest_activity`, and
-`canvas_invoke_command`. Snapshots are the `canvas_snapshot` composite (actions
+`canvas_invoke_command`, plus `canvas_help`. Snapshots are the `canvas_snapshot` composite (actions
 `save | list | restore | restore-node | delete | gc | diff`); the 6 legacy snapshot standalones were removed in
 v0.4.0 after their deprecated 0.3.x window.
 
@@ -389,9 +394,9 @@ If the documented receipts or warnings are unexpectedly absent, do not guess aro
 payload reads: verify that the CLI/MCP host and daemon use the same 0.7 installation and workspace,
 restart the matching daemon after upgrade, and re-check `/health`.
 
-**Token hygiene.** For routine state checks use `canvas_ax_state { action: "get" }` WITHOUT
-`includeContext` — the full AX context payload is ~10× larger; request it only when you are
-actually consuming context.
+**Token hygiene.** For routine state checks use
+`canvas_ax_state { action: "get", includeContext: false }` to omit the serialized AX context.
+Omitting `includeContext` defaults to `true`; request full context only when actually consuming it.
 
 ## Context Pins
 
@@ -683,7 +688,7 @@ Single-card and layout reads record content delivery, not incident relations.
 Graph cards and complete brief relations carry a captured `linksRevision`: reads
 acknowledge that version, not later changes. Brief delivery is qualified by source board.
 Reads never switch boards or mark full content read; pull needed cards in full separately. MCP remains
-24 tools and 15 static canvas resources, with two canvas templates (context/graph).
+25 tools and 15 static canvas resources, with two canvas templates (context/graph).
 
 Markdown saves bind `[[Board]]`, `[[Board#Card]]`, and `|alias` forms to durable
 IDs; code spans/fences are ignored. Ambiguous/missing targets never guess or

package/skills/pmx-canvas/references/full-reference.md

@@ -431,10 +431,15 @@ When you do set a color (group/graph), use this palette consistently to convey m
 ## MCP Tools Reference
 
 PMX Canvas exposes **18 action-discriminated composites** (the whole recommended surface) plus
-**6 first-class standalones** — 24 tools total. The composites fold the older
+**7 first-class standalones** — 25 tools total. The composites fold the older
 single-purpose tools behind an `action` (and, for `canvas_ax_gate`, a `kind`) discriminator —
 **field names are unchanged**; only the tool name + the `action`/`kind` selector differ.
 
+`canvas_help {}` lists MCP registry operation names. `canvas_help { op: "node.add" }`
+returns that operation's public tool, description and JSON argument schema, including
+routing selectors and required fields. It does not start or read a canvas. Handlers still
+enforce conditional requirements. Non-registry tools use `tools/list` instead.
+
 > **Legacy single-purpose tools were removed in v0.3.0.** The old names (`canvas_add_node`,
 > `canvas_update_node`, `canvas_request_approval`, `canvas_add_work_item`, …) are no longer
 > registered — use the composites below and fresh MCP `tools/list` for the installed runtime's
@@ -531,7 +536,7 @@ AX excerpts and annotation anchors, including `canvas://ax-context` and
 or brief relation entry instead.
 Single-card and layout reads record content delivery, not incident relations.
 Reads never switch boards or record full content reads. Pull cards in full
-when needed. Counts stay 24 tools, 15 static canvas resources; there are now two
+when needed. Counts are 25 tools, 15 static canvas resources; there are now two
 canvas templates, context and graph, besides the skill file template.
 
 Markdown save resolves `[[Board]]`, `[[Board#Card]]`, and `|alias` forms into
@@ -1124,11 +1129,39 @@ Use native `json-render` and `graph` nodes when the output should stay fully ins
 
 Spec elements support an `on` map (`on.press`, `on.change`, …) binding events to actions (`{ action, params }`) — built-in actions (`setState`, `pushState`, …) or, when named after an AX interaction type, a capability-gated AX emit. e.g. a Button with `on: { press: { action: 'ax.work.create', params: { title: '…' } } }` lets a human turn a panel control into a tracked work item; the viewer forwards it to the canvas, which validates and submits it server-side (clamped to the node's own id). See **Node AX Interactions** above.
 
+## MCP results and cancellation (0.10)
+
+The 25-tool catalog remains on MCP SDK v1. Each tool advertises `outputSchema`
+and effect annotations. Help returns `structuredContent.result` with operation
+metadata (or the name list); it records no content reads. Registry-dispatched tools expose
+`structuredContent.result = { operation, outcome, data }`, where `outcome` is
+`success`, `error` or `partial`; `data` matches the existing compact text JSON,
+or `{message}` for prose. Exceptions use `operation: null`; they do not prove no
+writes occurred. Interaction, activity-ingestion and screenshot tools instead
+use direct structured objects matching their schemas. Check `isError` and domain
+outcomes. A composite's annotations cover all its actions, not just reads.
+
+Cancellation releases supported AX waits, aborts webpage fetches before late
+content writes, and stops subsequent batch operations. Completed writes remain;
+batch partial results retain `results` and `refs`. A created webpage can remain
+with `fetch.cancelled: true`. External app builds/runtime calls and local WebView
+captures are not interruptible mid-call. After a disconnect, inspect state before
+retrying because the response may not arrive. `_meta.progressToken` enables batch
+and supported AX wait progress notifications, including through the daemon connection. Without
+a token, calls return their normal result without progress notifications.
+
 ## MCP Resources
 
 These resources give you read access to canvas intelligence. Read them to understand
 what the human has set up and what they're focusing on.
 
+As of 0.10, live resource updates require `resources/subscribe` on each connection.
+Subscribe to the exact URI you read, including context/graph query parameters;
+`resources/unsubscribe` stops it, and reconnecting requires a new subscription.
+Notifications invalidate cached data but do not deliver content, record a read, or
+advance a consumer cursor. Explicit `resources/read` remains available without
+subscriptions. Static schema and bundled skills do not support subscriptions.
+
 | Resource | What it provides |
 |----------|-----------------|
 | `canvas://context{?budget,consumer,since}` | Budgeted cross-board map brief with optional durable consumer cursor |

package/skills/pmx-canvas/references/github-copilot-app-adapter.md

@@ -4,7 +4,7 @@ Use this reference when PMX Canvas is running inside the GitHub Copilot app as a
 extension. The adapter is intentionally thin: PMX Canvas remains the state owner, and the extension
 maps Copilot SDK features onto PMX AX primitives.
 
-The [standalone agent plugin](../../../docs/agent-plugin.md) bundles this adapter and PMX's
+The [standalone agent plugin](https://github.com/pskoett/pmx-canvas/blob/main/docs/agent-plugin.md) bundles this adapter and PMX's
 MCP launcher. Its native canvas is Copilot-only; other Agent Plugins-compatible clients use
 the portable MCP tools and browser workbench.
 
@@ -125,7 +125,7 @@ imports the Copilot SDK.
 - **Await gates** with `canvas_ax_gate { kind, action: "await", id }` (or surface a native modal
   and await the PMX result) so an approval gate actually blocks the agent until the human resolves it.
 
-See [`docs/ax-host-adapter-contract.md`](../../../docs/ax-host-adapter-contract.md).
+See [`docs/ax-host-adapter-contract.md`](https://github.com/pskoett/pmx-canvas/blob/main/docs/ax-host-adapter-contract.md).
 - Keeps all persistent PMX state in `.pmx-canvas/canvas.db`; the extension does not own canvas
   state.
 

package/skills/pmx-canvas/references/installing-pmx-canvas.md

@@ -4,7 +4,7 @@ Use this reference when the `pmx-canvas` skill is installed but the `pmx-canvas`
 
 ## Prerequisites and version
 
-The examples pin **PMX Canvas 0.9.2**, which requires **Bun >=1.4.4** even when
+The examples pin **PMX Canvas 0.10.0**, which requires **Bun >=1.4.4** even when
 installed through npm: the CLI runs through Bun, not Node. Check `bun --version`
 first. If missing or older, follow the [Bun installation instructions](https://bun.sh/docs/installation)
 with the user's authorization. Ensure Bun is on the MCP host's PATH as well as the
@@ -22,11 +22,11 @@ in `SKILL.md`. Do not pair newer checkout guidance with an older runtime unknowi
 ## Install from npm
 
 ```bash
-npm install -g pmx-canvas@0.9.2
+npm install -g pmx-canvas@0.10.0
 pmx-canvas --version
 ```
 
-Without a global install, use `bunx pmx-canvas@0.9.2` in place of `pmx-canvas` in
+Without a global install, use `bunx pmx-canvas@0.10.0` in place of `pmx-canvas` in
 the commands below. Do not use unpinned `bunx pmx-canvas` for a version-specific check.
 
 ## Choose the workspace and target
@@ -96,7 +96,7 @@ discards empty env values, remove `PMX_CANVAS_URL` from its launch environment i
   "mcpServers": {
     "canvas": {
       "command": "bunx",
-      "args": ["pmx-canvas@0.9.2", "--mcp"],
+      "args": ["pmx-canvas@0.10.0", "--mcp"],
       "env": {
         "PMX_CANVAS_WORKSPACE_ROOT": "/absolute/path/to/project",
         "PMX_CANVAS_PORT": "14313",
@@ -140,7 +140,7 @@ Amp executes, not only on the user's laptop. Merge this into that workspace's
   "amp.mcpServers": {
     "canvas": {
       "command": "bunx",
-      "args": ["pmx-canvas@0.9.2", "--mcp"],
+      "args": ["pmx-canvas@0.10.0", "--mcp"],
       "includeTools": ["canvas_*"],
       "env": {
         "PMX_CANVAS_WORKSPACE_ROOT": "/absolute/path/to/project",
@@ -174,8 +174,8 @@ The agent must not run this approval itself or move the command to global settin
 `--mcp-config` to bypass workspace trust. Approval authorizes execution of this MCP
 command; it is not a new Canvas import consent or permission to mutate arbitrary boards.
 After approval, reload MCP connections (`reload_mcp` in Amp) and require `connected`.
-Discover `canvas` tools with `tool_search`; for the full unfiltered 0.9.2 server there
-are 24 tools. If still absent, inspect the server status, command/PATH and target instead
+Discover `canvas` tools with `tool_search`; the full unfiltered 0.10.0 server has 25 tools,
+including `canvas_help`. If still absent, inspect the server status, command/PATH and target instead
 of reinstalling blindly. See [Amp MCP documentation](https://ampcode.com/docs/customize/mcp).
 
 ### Verify native tools, then steering

package/src/client/canvas/BoardCopyDialog.tsx

@@ -7,6 +7,7 @@ import {
   type BoardSummary,
 } from '../state/boards-store';
 import { useFocusTrap } from './use-focus-trap';
+import { submitWithoutNavigation } from './submit-without-navigation';
 
 export function BoardCopyDialog({ board, onClose }: { board: BoardSummary; onClose: () => void }) {
   const dialogRef = useRef<HTMLDivElement>(null);
@@ -63,7 +64,7 @@ export function BoardCopyDialog({ board, onClose }: { board: BoardSummary; onClo
         aria-labelledby="board-copy-title"
         onMouseDown={(e) => e.stopPropagation()}
       >
-        <form onSubmit={submit}>
+        <form onClick={submitWithoutNavigation} onSubmit={submit}>
           <h2 id="board-copy-title">Create from {board.name}</h2>
           <label class="board-copy-field">
             Board name

package/src/client/canvas/KnowledgeDialog.tsx

@@ -8,6 +8,7 @@ import { requestJson } from '../state/intent-bridge';
 import { cleanLifecycle, DEFAULT_LIFECYCLE, LifecycleFields } from './LifecycleFields';
 import { useFocusTrap } from './use-focus-trap';
 import { ChoiceMenu } from './ChoiceMenu';
+import { submitWithoutNavigation } from './submit-without-navigation';
 
 export function KnowledgeDialog({ folder, onClose }: { folder?: string; onClose: () => void }) {
   const enabled = knowledgeLifecycleEnabled.value;
@@ -158,6 +159,7 @@ export function KnowledgeDialog({ folder, onClose }: { folder?: string; onClose:
           <p>Knowledge settings unavailable. Close and retry.</p>
         ) : folder ? (
           <form
+            onClick={submitWithoutNavigation}
             onSubmit={async (event) => {
               event.preventDefault();
               if (!knowledgeLifecycleEnabled.value || busy) return;
@@ -286,6 +288,7 @@ export function KnowledgeDialog({ folder, onClose }: { folder?: string; onClose:
                 <form
                   class="category-inspector"
                   noValidate
+                  onClick={submitWithoutNavigation}
                   onSubmit={async (event) => {
                     event.preventDefault();
                     if (!knowledgeLifecycleEnabled.value || busy) return;

package/src/client/canvas/LifecyclePanel.tsx

@@ -20,6 +20,7 @@ import {
 import { sendSteering } from '../state/session-store';
 import { hasUnsavedMarkdown } from '../nodes/MarkdownNode';
 import { cleanLifecycle, DEFAULT_LIFECYCLE, LifecycleFields } from './LifecycleFields';
+import { submitWithoutNavigation } from './submit-without-navigation';
 
 export function LifecyclePanel() {
   const target = lifecycleTarget.value;
@@ -264,6 +265,7 @@ function LifecycleDialog({ target }: { target: NonNullable<typeof lifecycleTarge
                 <form
                   class="lifecycle-quick-review"
                   noValidate
+                  onClick={submitWithoutNavigation}
                   onSubmit={(event) => {
                     event.preventDefault();
                     void recordReview('retain', true).then((ok) => {
@@ -345,6 +347,7 @@ function LifecycleDialog({ target }: { target: NonNullable<typeof lifecycleTarge
                 · category belongs to the folder
               </p>
               <form
+                onClick={submitWithoutNavigation}
                 onSubmit={(event) => {
                   event.preventDefault();
                   void mutate('/lifecycle', { lifecycleOverride: override ? cleanLifecycle(policy) : null });
@@ -446,6 +449,7 @@ function LifecycleDialog({ target }: { target: NonNullable<typeof lifecycleTarge
               ) : (
                 <form
                   class="lifecycle-review"
+                  onClick={submitWithoutNavigation}
                   onSubmit={(event) => {
                     event.preventDefault();
                     void recordReview(outcome, applied);

package/src/client/canvas/RelationPresetsDialog.tsx

@@ -4,6 +4,7 @@ import { boardList, updateBoard } from '../state/boards-store';
 import { requestJson } from '../state/intent-bridge';
 import { knowledge, refreshKnowledge } from '../state/knowledge-store';
 import { useFocusTrap } from './use-focus-trap';
+import { submitWithoutNavigation } from './submit-without-navigation';
 
 /** Shared templates live in Home; applying one never rewrites connection kinds. */
 export function RelationPresetsDialog({ onClose }: { onClose: () => void }) {
@@ -152,6 +153,7 @@ export function RelationPresetsDialog({ onClose }: { onClose: () => void }) {
                 {editing ? (
                   <form
                     class="relation-vocabulary"
+                    onClick={submitWithoutNavigation}
                     onSubmit={async (event) => {
                       event.preventDefault();
                       if (busy) return;

package/src/client/canvas/ToolRail.tsx

@@ -97,6 +97,8 @@ function RailButton({
 }) {
   const [hint, setHint] = useState<{ left: number; top: number } | null>(null);
   const show = (e: Event) => {
+    // Closing the menu restores focus before it unmounts; that must not reopen the hint.
+    if (menuOpen) return;
     const rect = (e.currentTarget as HTMLElement).getBoundingClientRect();
     setHint({ left: rect.right + 10, top: rect.top + rect.height / 2 });
   };

package/src/client/canvas/submit-without-navigation.ts

@@ -0,0 +1,14 @@
+import type { JSX } from 'preact';
+
+/** A scripts-only host blocks native submission before onSubmit can run. */
+export function submitWithoutNavigation(event: JSX.TargetedMouseEvent<HTMLFormElement>): void {
+  if (event.defaultPrevented || !(event.target instanceof Element)) return;
+  const button = event.target.closest('button');
+  const form = event.currentTarget;
+  if (button?.type !== 'submit' || button.form !== form || button.matches(':disabled')) return;
+  // Enter in a form input also activates its submit button. Keep native
+  // validation, but dispatch only the JS event, never a navigation/submission.
+  event.preventDefault();
+  if (!form.noValidate && !button.formNoValidate && !form.reportValidity()) return;
+  form.dispatchEvent(new SubmitEvent('submit', { bubbles: true, cancelable: true, submitter: button }));
+}

package/src/client/state/canvas-store.ts

@@ -768,31 +768,19 @@ export function animateViewport(
   duration = 300,
   options: { recordHistory?: boolean } = {},
 ): void {
-  if (animationId !== null) cancelAnimationFrame(animationId);
-
   const from = { ...viewport.value };
-  const start = performance.now();
-
-  function tick(now: number) {
-    const elapsed = now - start;
-    const t = Math.min(1, elapsed / duration);
-    const e = easeOutCubic(t);
-
-    viewport.value = {
-      x: from.x + (target.x - from.x) * e,
-      y: from.y + (target.y - from.y) * e,
-      scale: from.scale + (target.scale - from.scale) * e,
-    };
-
-    if (t < 1) {
-      animationId = requestAnimationFrame(tick);
-    } else {
-      animationId = null;
-      commitViewport(target, options);
-    }
-  }
-
-  animationId = requestAnimationFrame(tick);
+  animateCameraPath(
+    (t) => {
+      const e = easeOutCubic(t);
+      return {
+        x: from.x + (target.x - from.x) * e,
+        y: from.y + (target.y - from.y) * e,
+        scale: from.scale + (target.scale - from.scale) * e,
+      };
+    },
+    duration,
+    () => commitViewport(target, options),
+  );
 }
 
 /**

package/src/client/state/intent-bridge.ts

@@ -1,7 +1,6 @@
 import { canvasArea, canvasFitInsets } from '../canvas/canvas-area';
 import { showToast } from './attention-bridge';
 import { isHostedWorkbench, workbenchFetch } from './workbench-transport';
-import type { AgentPresenceSnapshot } from '../../shared/agent-presence.js';
 import type { CanvasEdge, CanvasNodeState } from '../types';
 import { addEdge, canvasInteractionEpoch, nodes } from './canvas-store';
 import { activeBoardId, boardsLoaded } from './boards-store';
@@ -401,11 +400,6 @@ export async function fetchAxSurfaceState(): Promise<unknown> {
   return requestJson<unknown>('fetchAxSurfaceState', '/api/canvas/ax/surface-snapshot', null);
 }
 
-/** Connect-time agent-presence read; live updates arrive as `agent-presence` SSE frames. */
-export async function fetchAgentPresence(): Promise<Partial<AgentPresenceSnapshot> | null> {
-  return requestJson<Partial<AgentPresenceSnapshot> | null>('fetchAgentPresence', '/api/canvas/ax/presence', null);
-}
-
 /** Ask the server to open a node's surface in the system browser. */
 export async function openNodeInSystemBrowserRequest(
   nodeId: string,

package/src/client/state/presence-store.ts

@@ -12,9 +12,9 @@ import {
 } from '../../shared/agent-presence.js';
 
 /**
- * Agent presence (rail-chrome-v2 phase 2). Fed by the server's `agent-presence`
- * SSE snapshot (every change, including TTL expiry) and the connect-time read,
- * so this store never runs its own expiry ticker.
+ * Agent presence (rail-chrome-v2 phase 2). Fed by the server's ordered
+ * `agent-presence` frames: a connect snapshot and every change, including TTL
+ * expiry, over SSE or polling. This store never runs its own expiry ticker.
  *
  * `sessionActive` is the ONE selector every agent surface reads — the session
  * panel, command bar, presence layer, and top-bar chip all mount on it.

package/src/client/state/sse-bridge.ts

@@ -14,7 +14,6 @@ import {
   axSurfaceState,
   bringToFront,
   cancelViewportAnimation,
-  commitViewport,
   canvasTheme,
   connectionStatus,
   contextPinsRevision,
@@ -50,12 +49,12 @@ import {
 import { applyContextStatus, refreshContextStatus } from './context-status-store';
 import { refreshContextChip } from './context-chip-store';
 import {
-  fetchAgentPresence,
   fetchAxSurfaceState,
   fetchCanvasState,
   reportClientViewportSize,
   requestJson,
   tabAgentKey,
+  updateViewportFromClient,
 } from './intent-bridge';
 import { agentActivity, applyPresenceSnapshot, sessionActive } from './presence-store';
 import { applyHumanSnapshot, humanClientId, startHumanPresence, stopHumanPresence } from './human-store';
@@ -577,9 +576,8 @@ function handleConnected(data: Record<string, unknown>): void {
   // Reconnect marker for holders of server-minted URLs (Finding S).
   workbenchConnectionEpoch.value += 1;
   reloadIfServerUpgraded(data.version, data.bundleStamp);
-  // Agent presence: read the snapshot on (re)connect; `agent-presence` frames
-  // keep it live from here on.
-  void fetchAgentPresence().then(applyPresenceSnapshot);
+  // Both transports send an ordered `agent-presence` connect snapshot, then
+  // live frames. A separate HTTP read can arrive late and overwrite newer state.
   void refreshContextStatus();
   refreshContextChip();
   // Human collaborators (phase 8): announce this tab and read who else is here.
@@ -1123,7 +1121,14 @@ function handleCanvasCameraMove(data: Record<string, unknown>): void {
   try {
     // The presentation camera is local; otherwise the end camera becomes the
     // board viewport — unrecorded, so a camera move is never an undo step.
-    playStop(stop.data, presenting.value ? undefined : (end) => commitViewport(end, { recordHistory: false }));
+    playStop(
+      stop.data,
+      presenting.value
+        ? undefined
+        : (end) => {
+            void updateViewportFromClient(end, { recordHistory: false });
+          },
+    );
   } catch {
     // Target not in this tab's layout yet: take the server's resolved camera.
     const fallback = cameraSchema.safeParse(data.viewport);

package/src/client/theme/global.css

@@ -4050,8 +4050,14 @@ kbd.toolbar-menu-hint {
 }
 
 /* ── Markdown reader mode (expanded view) ──────────────────── */
+.md-expanded-document {
+  display: flex;
+  flex-direction: column;
+}
+
 .md-reader {
-  height: 100%;
+  flex: 1;
+  min-height: 0;
   overflow-y: auto;
   display: flex;
   justify-content: center;
@@ -4205,11 +4211,11 @@ kbd.toolbar-menu-hint {
   background: var(--c-surface-subtle);
 }
 
-/* Source-mode FAB in expanded document view */
+/* Source stays below the scroll viewport, never over the document text. */
 .md-edit-fab {
-  position: absolute;
-  bottom: 16px;
-  right: 16px;
+  align-self: flex-end;
+  flex-shrink: 0;
+  margin: 16px;
   padding: 8px 18px;
   font-size: 13px;
   font-weight: 600;
@@ -5991,21 +5997,10 @@ html.is-node-resizing .ext-app-preview-catcher {
   /* Its sticky/backdrop-filter context must paint hints above the Source FAB. */
   z-index: 2;
 }
-.expanded-overlay-panel:has(.ax-step-dock) .md-expanded-document {
-  display: flex;
-  flex-direction: column;
-}
-.expanded-overlay-panel:has(.ax-step-dock) .md-reader {
-  flex: 1;
-  min-height: 0;
-}
 .expanded-overlay-panel:has(.ax-step-dock) .md-edit-fab {
   /* Keep Source and the document out of the bottom dock's hint area. */
-  position: static;
   order: -1;
-  align-self: flex-end;
-  flex-shrink: 0;
-  margin-bottom: 16px;
+  margin: 0 0 16px;
 }
 .ax-step-dock:has(.toolbar-tooltip-anchor:hover) .toolbar-tooltip-anchor:not(:hover) > :focus-visible + .toolbar-tooltip {
   /* Pointer exploration temporarily takes precedence without moving keyboard focus. */

package/src/mcp/canvas-access.ts

@@ -2,7 +2,6 @@ import { realpathSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { basename, dirname, resolve } from 'node:path';
 import { createCanvas, canvasState, type CanvasLayout, type CanvasNodeState, type PmxCanvas } from '../server/index.js';
-import type { PmxAxSource } from '../server/ax-state.js';
 import type { ContextReadInput } from '../server/context-reads.js';
 import { HttpOperationInvoker, LocalOperationInvoker, type OperationInvoker } from '../server/operations/index.js';
 
@@ -14,13 +13,9 @@ import { HttpOperationInvoker, LocalOperationInvoker, type OperationInvoker } fr
 // not CanvasAccess. The public SDK PmxCanvas methods are unchanged.
 type AxStateResult = ReturnType<PmxCanvas['getAxState']>;
 type AxContextResult = ReturnType<PmxCanvas['getAxContext']>;
-type SubmitAxInteractionInput = Parameters<PmxCanvas['submitAxInteraction']>[0];
-type SubmitAxInteractionResult = ReturnType<PmxCanvas['submitAxInteraction']>;
 type GetPendingSteeringResult = ReturnType<PmxCanvas['getPendingSteering']>;
 type ListElicitationsResult = ReturnType<PmxCanvas['listElicitations']>;
 type ListModeRequestsResult = ReturnType<PmxCanvas['listModeRequests']>;
-type IngestActivityInput = Parameters<PmxCanvas['ingestActivity']>[0];
-type IngestActivityResult = ReturnType<PmxCanvas['ingestActivity']>;
 type GetPolicyResult = ReturnType<PmxCanvas['getPolicy']>;
 type GetAxTimelineQuery = Parameters<PmxCanvas['getAxTimeline']>[0];
 type GetAxTimelineResult = ReturnType<PmxCanvas['getAxTimeline']>;
@@ -56,14 +51,9 @@ export interface CanvasAccess {
   listWorkItems(): Promise<ListWorkItemsResult>;
   listApprovalGates(): Promise<ListApprovalGatesResult>;
   listReviewAnnotations(): Promise<ListReviewAnnotationsResult>;
-  submitAxInteraction(
-    input: SubmitAxInteractionInput,
-    options?: { source?: PmxAxSource },
-  ): Promise<SubmitAxInteractionResult>;
   getPendingSteering(options?: { consumer?: string; limit?: number }): Promise<GetPendingSteeringResult>;
   listElicitations(): Promise<ListElicitationsResult>;
   listModeRequests(): Promise<ListModeRequestsResult>;
-  ingestActivity(input: IngestActivityInput, options?: { source?: PmxAxSource }): Promise<IngestActivityResult>;
   getPolicy(): Promise<GetPolicyResult>;
   getHistory(): Promise<HistoryResult>;
   getPinnedNodeIds(board?: string): Promise<string[]>;
@@ -75,7 +65,7 @@ export interface CanvasAccess {
   // canvas_screenshot (still hand-written — binary payload) is the only webview
   // tool left on CanvasAccess; it needs the status + screenshot accessors.
   getAutomationWebViewStatus(): Promise<AutomationWebViewStatus>;
-  screenshotAutomationWebView(options?: AutomationScreenshotOptions): Promise<Uint8Array>;
+  screenshotAutomationWebView(options?: AutomationScreenshotOptions, signal?: AbortSignal): Promise<Uint8Array>;
 }
 
 class LocalCanvasAccess implements CanvasAccess {
@@ -123,13 +113,6 @@ class LocalCanvasAccess implements CanvasAccess {
     return this.canvas.getAxTimeline(query);
   }
 
-  async submitAxInteraction(
-    input: SubmitAxInteractionInput,
-    options?: { source?: PmxAxSource },
-  ): Promise<SubmitAxInteractionResult> {
-    return this.canvas.submitAxInteraction(input, { source: options?.source ?? 'mcp' });
-  }
-
   async getPendingSteering(options?: { consumer?: string; limit?: number }): Promise<GetPendingSteeringResult> {
     return this.canvas.getPendingSteering(options);
   }
@@ -142,10 +125,6 @@ class LocalCanvasAccess implements CanvasAccess {
     return this.canvas.listModeRequests();
   }
 
-  async ingestActivity(input: IngestActivityInput, options?: { source?: PmxAxSource }): Promise<IngestActivityResult> {
-    return this.canvas.ingestActivity(input, { source: options?.source ?? 'mcp' });
-  }
-
   async getPolicy(): Promise<GetPolicyResult> {
     return this.canvas.getPolicy();
   }
@@ -299,23 +278,6 @@ class RemoteCanvasAccess implements CanvasAccess {
     return await this.requestJson<GetAxTimelineResult>('GET', `/api/canvas/ax/timeline${qs}`);
   }
 
-  async submitAxInteraction(
-    input: SubmitAxInteractionInput,
-    options?: { source?: PmxAxSource },
-  ): Promise<SubmitAxInteractionResult> {
-    // The interaction endpoint returns its structured outcome (ok/code/error) in
-    // the body for both accepted and rejected interactions, so read the body
-    // regardless of HTTP status rather than throwing on a denial.
-    const response = await fetch(`${this.remoteBaseUrl}/api/canvas/ax/interaction`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ ...input, source: options?.source ?? 'mcp' }),
-    });
-    const body = await response.json().catch(() => null);
-    if (body && typeof body === 'object') return body as SubmitAxInteractionResult;
-    throw new Error(`Remote canvas interaction failed with HTTP ${response.status}`);
-  }
-
   async getPendingSteering(options?: { consumer?: string; limit?: number }): Promise<GetPendingSteeringResult> {
     const params = new URLSearchParams();
     if (options?.consumer) params.set('consumer', options.consumer);
@@ -338,13 +300,6 @@ class RemoteCanvasAccess implements CanvasAccess {
     return r.modeRequests ?? [];
   }
 
-  async ingestActivity(input: IngestActivityInput, options?: { source?: PmxAxSource }): Promise<IngestActivityResult> {
-    return await this.requestJson<IngestActivityResult>('POST', '/api/canvas/ax/activity', {
-      ...input,
-      source: options?.source ?? 'mcp',
-    });
-  }
-
   async getPolicy(): Promise<GetPolicyResult> {
     const r = await this.requestJson<{ policy?: GetPolicyResult }>('GET', '/api/canvas/ax/policy');
     if (!r.policy) throw new Error('Remote canvas did not return a policy.');
@@ -404,11 +359,15 @@ class RemoteCanvasAccess implements CanvasAccess {
     return await this.requestJson<AutomationWebViewStatus>('GET', '/api/workbench/webview');
   }
 
-  async screenshotAutomationWebView(options: AutomationScreenshotOptions = {}): Promise<Uint8Array> {
+  async screenshotAutomationWebView(
+    options: AutomationScreenshotOptions = {},
+    signal?: AbortSignal,
+  ): Promise<Uint8Array> {
     const response = await fetch(`${this.remoteBaseUrl}/api/workbench/webview/screenshot`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(options),
+      signal,
     });
     if (!response.ok) {
       const text = await response.text();