pmx-canvas 0.6.5 → 0.7.0

package/src/client/theme/global.css

@@ -60,6 +60,26 @@
   --hud-bar-height: 44px;
 }
 
+.board-node, .md-card-preview { display: flex; flex-direction: column; height: 100%; min-height: 0; }
+.board-node-content { flex: 1; min-height: 0; overflow: auto; padding: 16px; overflow-wrap: anywhere; }
+.board-node-label { color: var(--c-dim); font-size: 10px; font-weight: 600; text-transform: uppercase; letter-spacing: .1em; margin-bottom: 8px; }
+.board-node-title { display: block; font-size: 17px; line-height: 1.35; margin-bottom: 6px; }
+.board-node-meta { color: var(--c-dim); font-size: 11px; line-height: 1.5; }
+.board-node-summary { color: var(--c-text-soft); font-size: 13px; line-height: 1.6; margin: 14px 0; }
+.board-node-open { display: flex; justify-content: space-between; align-items: center; flex-shrink: 0; width: 100%; padding: 10px 16px; border: 0; border-top: 1px solid var(--c-line); background: var(--c-panel); color: var(--c-accent); font: 500 12px var(--font); text-align: left; cursor: pointer; }
+.board-node-open:hover:not(:disabled) { background: var(--c-accent-8); }
+.board-node-open:disabled { color: var(--c-dim); cursor: default; }
+.md-card-content { flex: 1; min-height: 0; overflow: auto; }
+.md-card-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; border-top: 1px solid var(--c-line); padding: 6px 36px 6px 8px; background: var(--c-panel); }
+.md-card-actions button { border: 1px solid transparent; border-radius: var(--radius-sm); background: transparent; color: var(--c-dim); padding: 4px 8px; font: 500 11px var(--font); cursor: pointer; }
+.md-card-actions button:hover { color: var(--c-text); background: var(--c-accent-8); }
+.md-card-actions .md-readme-btn[aria-pressed="true"] { color: var(--c-accent); background: var(--c-accent-8); border-color: var(--c-accent-25); }
+.md-card-edit { margin-left: auto; }
+.board-node-open:focus-visible, .md-card-actions button:focus-visible { outline: 2px solid var(--c-accent); outline-offset: -2px; }
+.canvas-node[data-node-type="markdown"] .node-body,
+.canvas-node[data-node-type="board"] .node-body { padding: 0; }
+.md-card-content { padding: 10px 14px; }
+
 :root[data-theme="light"] {
   /* ── Core palette (light · paper + ink) ──────────────────── */
   --c-bg: #F4EFE6;
@@ -1251,7 +1271,7 @@ body,
 }
 
 .agent-chip-end:hover {
-  color: var(--c-danger, #ef4444);
+  color: var(--c-danger);
   background: color-mix(in srgb, currentColor 12%, transparent);
 }
 
@@ -3317,29 +3337,6 @@ body,
 }
 
 /* Raw markdown source editor */
-.md-edit-btn {
-  position: absolute;
-  top: 4px;
-  right: 4px;
-  padding: 3px 8px;
-  font-size: 10px;
-  background: var(--c-panel);
-  border: 1px solid var(--c-line);
-  border-radius: 4px;
-  color: var(--c-text-soft);
-  cursor: pointer;
-  opacity: 0;
-  transition: opacity 0.12s ease;
-}
-.canvas-node:hover .md-edit-btn,
-.md-edit-btn:focus-visible {
-  opacity: 1;
-}
-.md-edit-btn:hover {
-  color: var(--c-text);
-  border-color: var(--c-accent-25);
-}
-
 .md-editor-split {
   display: flex;
   height: 100%;
@@ -6862,3 +6859,422 @@ html.is-node-dragging .intent-line-layer {
   background: var(--c-panel);
   color: var(--c-text);
 }
+
+/* ── Many boards (plan 012): top-bar switcher + Home ── */
+.board-switcher {
+  display: inline-flex;
+  /* The board name is the bar's identity: it keeps room for a short name
+     ("Home") when chips crowd a 600px pane; long names still ellipsize. */
+  min-width: 88px;
+  flex-shrink: 1;
+}
+.board-switcher-button {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  max-width: 280px;
+  padding: 4px 8px;
+  margin-left: -8px;
+  background: none;
+  border: 1px solid transparent;
+  border-radius: 8px;
+  cursor: pointer;
+}
+.board-switcher-button:hover,
+.board-switcher-button[aria-expanded='true'] {
+  border-color: var(--c-line);
+  background: var(--c-panel);
+}
+.board-switcher-name {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.board-switcher-caret {
+  font-size: 10px;
+  color: var(--c-text-soft);
+}
+.board-switcher-menu {
+  width: min(340px, calc(100vw - 24px));
+  min-width: 0;
+  padding: 8px;
+  background: var(--c-panel);
+  backdrop-filter: none;
+  overflow: hidden;
+}
+.board-switcher-heading {
+  padding: 8px 10px 10px;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--c-dim);
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  flex-shrink: 0;
+}
+.board-switcher-recents { min-height: 0; overflow-y: auto; }
+.board-switcher-menu .toolbar-menu-item { padding: 10px; gap: 12px; }
+.board-switcher-menu .toolbar-menu-item:hover,
+.board-switcher-menu .toolbar-menu-item:focus-visible {
+  background: var(--c-accent-8);
+  border-color: var(--c-accent-25);
+  outline: none;
+}
+.board-switcher-icon { display: flex; align-items: center; justify-content: center; width: 20px; flex-shrink: 0; color: var(--c-accent); font-size: 22px; }
+.board-switcher-item-copy { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 4px; }
+.board-switcher-item-name {
+  color: var(--c-text);
+  font-weight: 500;
+  line-height: 1.35;
+  overflow-wrap: anywhere;
+  text-align: left;
+}
+.board-switcher-item-folder { font-size: 11px; line-height: 1.4; color: var(--c-dim); overflow-wrap: anywhere; }
+.board-switcher-item-meta {
+  font-size: 10px;
+  color: var(--c-dim);
+  white-space: nowrap;
+  align-self: flex-start;
+  padding-top: 2px;
+}
+.board-switcher-actions { border-top: 1px solid var(--c-line); margin-top: 6px; padding-top: 6px; flex-shrink: 0; }
+
+.home-view {
+  position: absolute;
+  inset: 0;
+  /* Above the canvas's floating chrome (the updates tab sits at 60), below menus and prompts. */
+  z-index: 70;
+  overflow-y: auto;
+  background: var(--c-bg);
+  padding: 32px 16px;
+}
+.home-view-inner {
+  max-width: 720px;
+  margin: 0 auto;
+  display: flex;
+  flex-direction: column;
+  gap: 18px;
+}
+.home-view-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+}
+.home-view-title {
+  margin: 0;
+  font-size: 20px;
+  font-weight: 650;
+  color: var(--c-text);
+}
+.home-view-new {
+  padding: 7px 14px;
+  border-radius: 8px;
+  border: 1px solid var(--c-accent);
+  background: var(--c-accent);
+  color: var(--c-bg);
+  font-weight: 600;
+  cursor: pointer;
+}
+.home-view-empty {
+  color: var(--c-text-soft);
+  font-size: 13px;
+}
+.home-view-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 7px;
+}
+.home-board {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 7px 8px 7px 5px;
+  border: 1px solid var(--c-line);
+  border-radius: 10px;
+  background: var(--c-panel);
+}
+.home-board.is-confirming {
+  border-color: var(--c-danger);
+  padding: 10px 12px;
+  flex-wrap: wrap;
+}
+.home-board-open {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 2px;
+  padding: 6px 8px;
+  background: none;
+  border: none;
+  border-radius: 8px;
+  color: var(--c-text);
+  cursor: pointer;
+  text-align: left;
+}
+.home-board-open:hover {
+  background: color-mix(in srgb, var(--c-accent) 10%, transparent);
+}
+.home-board-name {
+  max-width: 100%;
+  font-size: 14px;
+  font-weight: 600;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.home-board-meta {
+  font: 11px var(--mono);
+  color: var(--c-text-soft);
+}
+.home-board-confirm-text {
+  flex: 1 1 240px;
+  font-size: 13px;
+  color: var(--c-text);
+}
+.home-board-actions {
+  display: flex;
+  gap: 2px;
+  flex-shrink: 0;
+}
+.home-board-action {
+  padding: 6px 7px;
+  border-radius: 6px;
+  border: 1px solid transparent;
+  background: none;
+  color: var(--c-dim);
+  font-size: 11px;
+  cursor: pointer;
+}
+.home-board-action:hover {
+  border-color: var(--c-line);
+  background: color-mix(in srgb, var(--c-text) 5%, transparent);
+  color: var(--c-text-soft);
+}
+.home-board-action.is-danger {
+  border-color: var(--c-danger);
+  background: var(--c-danger);
+  color: var(--c-bg);
+  font-weight: 600;
+}
+.home-board-open:focus-visible,
+.home-board-action:focus-visible,
+.home-view-new:focus-visible,
+.board-switcher-button:focus-visible {
+  outline: 2px solid var(--c-accent);
+  outline-offset: 2px;
+}
+
+/* ── Board export dialog (plan 013) ── */
+.export-dialog {
+  width: min(520px, calc(100% - 32px));
+}
+.export-dialog-note {
+  font-size: 12px;
+  color: var(--c-text-soft);
+}
+.export-dialog-list {
+  margin: 0;
+  padding-left: 18px;
+  font-size: 13px;
+  color: var(--c-text);
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.export-dialog-files {
+  display: flex;
+  gap: 8px;
+  align-items: flex-start;
+  font-size: 12px;
+  color: var(--c-text);
+  word-break: break-all;
+}
+.export-dialog-result {
+  font-size: 12px;
+  color: var(--c-text);
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  word-break: break-all;
+}
+.export-dialog-links {
+  display: flex;
+  gap: 12px;
+}
+.export-dialog-links a {
+  color: var(--c-accent);
+}
+
+/* ── Home categories ── */
+.home-section {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.home-section-head {
+  display: flex;
+  align-items: center;
+  gap: 9px;
+  min-height: 42px;
+  width: 100%;
+  padding: 9px 10px;
+  background: none;
+  border: none;
+  border-radius: 8px;
+  color: var(--c-text-soft);
+  font-size: 12px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  cursor: pointer;
+  text-align: left;
+}
+.home-section-head:hover {
+  color: var(--c-text);
+  background: color-mix(in srgb, var(--c-text) 5%, transparent);
+}
+.home-section-chevron,
+.home-section-folder {
+  flex: 0 0 18px;
+  stroke: currentColor;
+  stroke-width: 1.75;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+}
+.home-section-chevron {
+  transition: transform 120ms ease;
+}
+.home-section-head[aria-expanded='true'] .home-section-chevron {
+  transform: rotate(90deg);
+}
+.home-section-folder { color: var(--c-dim); }
+.home-section-count {
+  font: 11px var(--mono);
+  text-transform: none;
+  color: var(--c-dim);
+  margin-left: auto;
+}
+.home-section-head:focus-visible {
+  outline: 2px solid var(--c-accent);
+  outline-offset: 2px;
+}
+.home-section-head {
+  text-transform: none;
+  letter-spacing: normal;
+  max-width: 100%;
+}
+.home-section-name {
+  font-size: 13px;
+  font-weight: 650;
+  overflow-wrap: anywhere;
+}
+.home-folder-children {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding-left: 12px;
+  border-left: 1px solid var(--c-line);
+}
+.home-search { width: 100%; box-sizing: border-box; }
+.board-copy-dialog,
+.board-link-dialog {
+  width: min(540px, calc(100vw - 32px));
+  max-height: calc(100dvh - 40px);
+  overflow-y: auto;
+  box-sizing: border-box;
+}
+.board-copy-dialog form,
+.board-copy-field,
+.board-copy-options {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.board-copy-dialog h2,
+.board-link-dialog h2 { margin: 0 0 12px; font-size: 17px; }
+.board-copy-field { color: var(--c-text-soft); font-size: 12px; }
+.board-copy-cards {
+  margin: 14px 0;
+  padding: 8px;
+  border: 1px solid var(--c-line);
+  border-radius: 9px;
+  max-height: 230px;
+  overflow-y: auto;
+}
+.board-copy-cards legend { color: var(--c-text-soft); font-size: 12px; }
+.board-copy-card {
+  display: flex;
+  align-items: center;
+  gap: 9px;
+  padding: 8px;
+  border-radius: 7px;
+  cursor: pointer;
+}
+.board-copy-card:hover { background: color-mix(in srgb, var(--c-accent) 9%, transparent); }
+.board-copy-card span { display: flex; flex-direction: column; min-width: 0; }
+.board-copy-card strong { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 13px; }
+.board-copy-card small,
+.board-link-results small { color: var(--c-text-soft); font: 11px var(--mono); }
+.board-copy-options { font-size: 13px; }
+.board-copy-options label { display: flex; gap: 8px; align-items: center; }
+.board-copy-note,
+.board-copy-status { color: var(--c-text-soft); font-size: 12px; line-height: 1.5; }
+.board-copy-error { color: var(--c-danger); font-size: 12px; margin-top: 8px; }
+.board-link-results { display: flex; flex-direction: column; gap: 5px; margin: 12px 0; padding: 0; max-height: 320px; overflow-y: auto; list-style: none; }
+.board-link-results button { width: 100%; display: flex; justify-content: space-between; gap: 12px; padding: 10px; border: 1px solid var(--c-line); border-radius: 8px; background: var(--c-panel); color: var(--c-text); text-align: left; cursor: pointer; }
+.board-link-results button:hover,
+.board-link-results button:focus-visible { border-color: var(--c-accent); outline: none; }
+.home-folder-dialog {
+  width: min(460px, calc(100vw - 32px));
+  max-height: calc(100dvh - 48px);
+  overflow-y: auto;
+  box-sizing: border-box;
+}
+.home-folder-hint {
+  color: var(--c-text-soft);
+  font-size: 12px;
+  line-height: 1.5;
+  overflow-wrap: anywhere;
+}
+.home-folder-options {
+  margin: 12px 0;
+  padding: 8px;
+  border: 1px solid var(--c-line);
+  border-radius: 8px;
+  max-height: 240px;
+  overflow-y: auto;
+}
+.home-folder-options legend { color: var(--c-text-soft); font-size: 12px; }
+.home-folder-option {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px;
+  border-radius: 6px;
+  font-size: 13px;
+  overflow-wrap: anywhere;
+  cursor: pointer;
+}
+.home-folder-option:has(input:checked) { background: color-mix(in srgb, var(--c-accent) 12%, transparent); }
+.home-folder-option input { accent-color: var(--c-accent); flex-shrink: 0; }
+.home-folder-new { display: flex; flex-direction: column; gap: 6px; font-size: 12px; overflow-wrap: anywhere; }
+.attachment-node { padding: 16px; display: flex; flex-direction: column; align-items: flex-start; gap: 10px; font-size: 13px; overflow: auto; height: 100%; box-sizing: border-box; }
+.attachment-node p { margin: 0; color: var(--c-text-soft); line-height: 1.5; }
+.attachment-node a, .md-import-source a { color: var(--c-accent); }
+.attachment-status { font-weight: 600; }
+.attachment-node .home-board-action { border-color: var(--c-line); color: var(--c-text); min-height: 34px; }
+.attachment-node .home-board-action:hover { background: var(--c-panel); border-color: var(--c-accent); }
+.attachment-review { width: 100%; border-top: 1px solid var(--c-line); padding-top: 12px; }
+.attachment-review pre { white-space: pre-wrap; overflow-wrap: anywhere; font: 12px/1.6 var(--mono); padding: 12px; background: var(--c-bg); border-radius: 8px; }
+.attachment-review h4 { margin-bottom: 6px; }
+.md-import-source { padding: 6px 12px; font-size: 11px; overflow-wrap: anywhere; color: var(--c-text-soft); border-top: 1px solid var(--c-line); }
+@media (max-width: 640px) {
+  .home-board { flex-wrap: wrap; }
+  .home-board-open { flex-basis: 100%; }
+  .home-board-actions { padding: 0 8px 4px; }
+}

package/src/client/types.ts

@@ -14,6 +14,7 @@ export interface CanvasNodeState {
     | 'webpage'
     | 'json-render'
     | 'graph'
+    | 'board'
     | 'prompt'
     | 'response'
     | 'status'
@@ -74,6 +75,7 @@ export const TYPE_LABELS: Record<CanvasNodeState['type'], string> = {
   webpage: 'WEB',
   'json-render': 'UI',
   graph: 'GRAPH',
+  board: 'BOARD',
   prompt: 'ASK',
   response: 'ANS',
   status: 'STATUS',

package/src/json-render/server.ts

@@ -149,7 +149,7 @@ function bundleDir(): string {
   return candidates[candidates.length - 1];
 }
 
-function escapeInlineScriptSource(source: string): string {
+export function escapeInlineScriptSource(source: string): string {
   return source.replace(/<\/script/gi, '<\\/script');
 }
 
@@ -956,6 +956,20 @@ export function createJsonRenderNodeData(
   };
 }
 
+/** The viewer bundle's script and stylesheet, as the viewer document inlines them. */
+export async function readJsonRenderBundle(): Promise<{ js: string; css: string }> {
+  await ensureJsonRenderBundle();
+  const dir = bundleDir();
+  const jsPath = join(dir, 'index.js');
+  const cssPath = join(dir, 'index.css');
+  return {
+    js: existsSync(jsPath)
+      ? readFileSync(jsPath, 'utf-8')
+      : 'document.body.innerHTML = "<pre>json-render bundle missing</pre>";',
+    css: existsSync(cssPath) ? readFileSync(cssPath, 'utf-8') : '',
+  };
+}
+
 export async function buildJsonRenderViewerHtml(options: {
   title: string;
   spec: JsonRenderSpec;
@@ -975,14 +989,7 @@ export async function buildJsonRenderViewerHtml(options: {
   const sanitizeAxValue = (v?: string): string =>
     typeof v === 'string' ? v.replace(/[^A-Za-z0-9_-]/g, '').slice(0, 80) : '';
   try {
-    await ensureJsonRenderBundle();
-    const dir = bundleDir();
-    const jsPath = join(dir, 'index.js');
-    const cssPath = join(dir, 'index.css');
-    const jsBundle = existsSync(jsPath)
-      ? readFileSync(jsPath, 'utf-8')
-      : 'document.body.innerHTML = "<pre>json-render bundle missing</pre>";';
-    const cssBundle = existsSync(cssPath) ? readFileSync(cssPath, 'utf-8') : '';
+    const { js: jsBundle, css: cssBundle } = await readJsonRenderBundle();
     const boot = [
       `window.__PMX_CANVAS_JSON_RENDER_SPEC__ = ${JSON.stringify(options.spec)};`,
       ...(options.theme ? [`window.__PMX_CANVAS_JSON_RENDER_THEME__ = ${JSON.stringify(options.theme)};`] : []),

package/src/mcp/canvas-access.ts

@@ -1,15 +1,9 @@
 import { realpathSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { basename, dirname, resolve } from 'node:path';
-import {
-  createCanvas,
-  canvasState,
-  type CanvasEdge,
-  type CanvasLayout,
-  type CanvasNodeState,
-  type PmxCanvas,
-} from '../server/index.js';
+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';
 
 // openMcpApp / addDiagram / buildWebArtifact / refreshWebpageNode / addHtmlNode /
@@ -54,8 +48,8 @@ export interface CanvasAccess {
   readonly remoteBaseUrl: string | null;
   /** Operation-registry invoker (plan-005): local in-process or HTTP, matching the access mode. */
   invoker(): OperationInvoker;
-  getLayout(): Promise<CanvasLayout>;
-  getNode(id: string): Promise<CanvasNodeState | undefined>;
+  getLayout(board?: string): Promise<CanvasLayout>;
+  getNode(id: string, board?: string): Promise<CanvasNodeState | undefined>;
   getAxState(): Promise<AxStateResult>;
   getAxContext(options?: { consumer?: string }): Promise<AxContextResult>;
   getAxTimeline(query?: GetAxTimelineQuery): Promise<GetAxTimelineResult>;
@@ -72,7 +66,10 @@ export interface CanvasAccess {
   ingestActivity(input: IngestActivityInput, options?: { source?: PmxAxSource }): Promise<IngestActivityResult>;
   getPolicy(): Promise<GetPolicyResult>;
   getHistory(): Promise<HistoryResult>;
-  getPinnedNodeIds(): Promise<string[]>;
+  getPinnedNodeIds(board?: string): Promise<string[]>;
+  prepareContextRead(board?: string): Promise<{ boardId: string | null; pinnedNodeIds: string[] }>;
+  /** Record a context read the agent made through this MCP server (plan-011). */
+  recordContextRead(read: ContextReadInput): Promise<void>;
   runBatch(operations: RunBatchInput): Promise<RunBatchResult>;
   getCodeGraph(): Promise<CodeGraphResult>;
   // canvas_screenshot (still hand-written — binary payload) is the only webview
@@ -99,11 +96,15 @@ class LocalCanvasAccess implements CanvasAccess {
     return this.operationInvoker;
   }
 
-  async getLayout(): Promise<CanvasLayout> {
-    return this.canvas.getLayout();
+  async getLayout(board?: string): Promise<CanvasLayout> {
+    return board
+      ? ((await this.operationInvoker.invoke('layout.get', { board, includeBlobs: true })) as CanvasLayout)
+      : this.canvas.getLayout();
   }
 
-  async getNode(id: string): Promise<CanvasNodeState | undefined> {
+  async getNode(id: string, board?: string): Promise<CanvasNodeState | undefined> {
+    if (board)
+      return (await this.operationInvoker.invoke('node.get', { id, board, includeBlobs: true })) as CanvasNodeState;
     return this.canvas.getNode(id);
   }
 
@@ -162,10 +163,23 @@ class LocalCanvasAccess implements CanvasAccess {
     return this.canvas.getHistory();
   }
 
-  async getPinnedNodeIds(): Promise<string[]> {
+  async getPinnedNodeIds(board?: string): Promise<string[]> {
+    if (board) {
+      const result = (await this.operationInvoker.invoke('pinned-context.get', { board })) as { nodeIds?: string[] };
+      return result.nodeIds ?? [];
+    }
     return Array.from(canvasState.contextPinnedNodeIds);
   }
 
+  async prepareContextRead(board?: string): Promise<{ boardId: string | null; pinnedNodeIds: string[] }> {
+    const boardId = board ?? canvasState.activeBoardId;
+    return { boardId, pinnedNodeIds: boardId ? await this.getPinnedNodeIds(boardId) : [] };
+  }
+
+  async recordContextRead(read: ContextReadInput): Promise<void> {
+    canvasState.recordContextRead(read, read.boardId === undefined ? canvasState.activeBoardId : read.boardId);
+  }
+
   async runBatch(operations: RunBatchInput): Promise<RunBatchResult> {
     return await this.canvas.runBatch(operations);
   }
@@ -202,7 +216,12 @@ class RemoteCanvasAccess implements CanvasAccess {
   private async requestJson<T>(method: string, path: string, body?: unknown): Promise<T> {
     const response = await fetch(`${this.remoteBaseUrl}${path}`, {
       method,
-      headers: body === undefined ? undefined : { 'Content-Type': 'application/json' },
+      // These fetches serve the agent's MCP reads, which this server records
+      // itself — the daemon must not record them a second time (plan-011).
+      headers: {
+        'x-pmx-proxied-read': '1',
+        ...(body === undefined ? {} : { 'Content-Type': 'application/json' }),
+      },
       body: body === undefined ? undefined : JSON.stringify(body),
     });
     const text = await response.text();
@@ -227,12 +246,16 @@ class RemoteCanvasAccess implements CanvasAccess {
     return parsed as T;
   }
 
-  async getLayout(): Promise<CanvasLayout> {
-    return await this.requestJson<CanvasLayout>('GET', '/api/canvas/state?includeBlobs=true');
+  async getLayout(board?: string): Promise<CanvasLayout> {
+    const params = new URLSearchParams({ includeBlobs: 'true' });
+    if (board) params.set('board', board);
+    return await this.requestJson<CanvasLayout>('GET', `/api/canvas/state?${params}`);
   }
 
-  async getNode(id: string): Promise<CanvasNodeState | undefined> {
-    const response = await fetch(`${this.remoteBaseUrl}/api/canvas/node/${encodeURIComponent(id)}?includeBlobs=true`);
+  async getNode(id: string, board?: string): Promise<CanvasNodeState | undefined> {
+    const params = new URLSearchParams({ includeBlobs: 'true' });
+    if (board) params.set('board', board);
+    const response = await fetch(`${this.remoteBaseUrl}/api/canvas/node/${encodeURIComponent(id)}?${params}`);
     if (response.status === 404) return undefined;
     const text = await response.text();
     let parsed: unknown;
@@ -346,11 +369,25 @@ class RemoteCanvasAccess implements CanvasAccess {
     return response.reviewAnnotations ?? [];
   }
 
-  async getPinnedNodeIds(): Promise<string[]> {
-    const response = await this.requestJson<{ nodeIds?: string[] }>('GET', '/api/canvas/pinned-context');
+  async getPinnedNodeIds(board?: string): Promise<string[]> {
+    const qs = board ? `?board=${encodeURIComponent(board)}` : '';
+    const response = await this.requestJson<{ nodeIds?: string[] }>('GET', `/api/canvas/pinned-context${qs}`);
     return Array.isArray(response.nodeIds) ? response.nodeIds : [];
   }
 
+  async prepareContextRead(board?: string): Promise<{ boardId: string | null; pinnedNodeIds: string[] }> {
+    let boardId = board;
+    if (!boardId) {
+      const boards = await this.requestJson<{ activeBoardId?: string | null }>('GET', '/api/canvas/boards');
+      boardId = boards.activeBoardId ?? undefined;
+    }
+    return { boardId: boardId ?? null, pinnedNodeIds: boardId ? await this.getPinnedNodeIds(boardId) : [] };
+  }
+
+  async recordContextRead(read: ContextReadInput): Promise<void> {
+    await this.requestJson('POST', '/api/canvas/ax/context-reads', read);
+  }
+
   async runBatch(operations: RunBatchInput): Promise<RunBatchResult> {
     return await this.requestJson<RunBatchResult>('POST', '/api/canvas/batch', { operations });
   }