pmx-canvas 0.6.5 → 0.7.1

package/dist/types/cli/agent.d.ts

@@ -17,6 +17,9 @@ import './commands/groups.js';
 import './commands/view.js';
 import './commands/query.js';
 import './commands/pins.js';
+import './commands/boards.js';
+import './commands/backup.js';
+import './commands/export.js';
 import './commands/history.js';
 import './commands/ax.js';
 import './commands/pump.js';

package/dist/types/cli/commands/backup.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/cli/commands/boards.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/cli/commands/export.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/cli/daemon.d.ts

@@ -2,15 +2,15 @@ export declare function outputJson(data: unknown): void;
 export declare function readPidFile(path: string): number | null;
 export declare function isProcessRunning(pid: number): boolean;
 /**
- * Whether pid's command line contains `needle`. Returns null when `ps` cannot
- * answer (no such process, unsupported platform) — callers fall back to the
- * plain liveness signal.
+ * Whether pid's command line contains `needle`. Returns null when the OS probe
+ * cannot answer (no such process or unavailable command). Stop must not treat
+ * an unknown identity as permission to signal a live process.
  */
 export declare function processCommandMatches(pid: number, needle: string): boolean | null;
 /**
  * Liveness with a PID-recycling guard: the pid must be alive AND its command
- * line must still look like our daemon (unless `ps` is unavailable, in which
- * case the plain liveness signal wins).
+ * line must still look like our daemon. Status falls back to plain liveness
+ * when the command probe is unavailable; stop requires a verified match.
  */
 export declare function isOwnDaemonProcess(pid: number, entryNeedle: string): boolean;
 export declare function removePidFile(path: string): void;

package/dist/types/cli/shared.d.ts

@@ -20,7 +20,8 @@ declare function die(message: string, hint?: string): never;
 declare function output(data: unknown): void;
 declare function invokeOperation(name: string, input: Record<string, unknown>): Promise<unknown>;
 /**
- * `options.boolFlags` marks flags that are boolean FOR THIS COMMAND. Value
+ * `options.boolFlags` marks flags that are boolean FOR THIS COMMAND, while
+ * `options.valueFlags` overrides a globally boolean flag for one command. Value
  * flags consume the next token verbatim (so a unified diff beginning with
  * `--- a/file` survives), which makes a flag that is boolean here and
  * value-taking elsewhere ambiguous — `--summary` is boolean in `history` /
@@ -31,6 +32,7 @@ declare function invokeOperation(name: string, input: Record<string, unknown>):
  */
 declare function parseFlags(args: string[], options?: {
     boolFlags?: readonly string[];
+    valueFlags?: readonly string[];
 }): {
     positional: string[];
     flags: Record<string, string | true>;

package/dist/types/client/canvas/BoardCopyDialog.d.ts

@@ -0,0 +1,5 @@
+import { type BoardSummary } from '../state/boards-store';
+export declare function BoardCopyDialog({ board, onClose }: {
+    board: BoardSummary;
+    onClose: () => void;
+}): import("preact/src").JSX.Element;

package/dist/types/client/canvas/BoardFolderDialog.d.ts

@@ -0,0 +1,7 @@
+import { type BoardSummary } from '../state/boards-store';
+/** A destination picker: select an existing folder, optionally create a child, then move. */
+export declare function BoardFolderDialog({ board, folders, onClose, }: {
+    board: BoardSummary;
+    folders: string[];
+    onClose: () => void;
+}): import("preact/jsx-runtime").JSX.Element;

package/dist/types/client/canvas/BoardLinkDialog.d.ts

@@ -0,0 +1,3 @@
+export declare function BoardLinkDialog({ onClose }: {
+    onClose: () => void;
+}): import("preact/src").JSX.Element;

package/dist/types/client/canvas/BoardSwitcher.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The top bar's board identity (plan 012): the open board's name, or "Home".
+ * Clicking it lists recent boards, New board, and Home. The menu is fixed-
+ * positioned so the bar's overflow clip cannot cut it off.
+ */
+export declare function BoardSwitcher({ fallbackName }: {
+    fallbackName: string;
+}): import("preact").JSX.Element;

package/dist/types/client/canvas/ExportDialog.d.ts

@@ -0,0 +1,7 @@
+export declare const exportDialogOpen: import("@preact/signals-core").Signal<boolean>;
+/**
+ * Export the open board as one HTML file (plan 013). An export is a share, so
+ * the dialog lists what goes into the file before it is written; file contents
+ * stay out unless the owner ticks them in.
+ */
+export declare function ExportDialog(): import("preact/src").JSX.Element | null;

package/dist/types/client/canvas/HomeView.d.ts

@@ -0,0 +1,9 @@
+export declare function promptNewBoard(): Promise<void>;
+/**
+ * Home (plan 012): the view when no board is open — every board, filed under
+ * its category (most recently opened first within each). Categories keep the
+ * library findable as it grows into the working memory of many sessions.
+ * Deleting asks in place, naming the board and what it holds; browser confirm
+ * dialogs are no-ops in agent panes.
+ */
+export declare function HomeView(): import("preact").JSX.Element;

package/dist/types/client/nodes/AttachmentNode.d.ts

@@ -0,0 +1,6 @@
+import type { CanvasNodeState } from '../types';
+/** Originals stay useful even when the connected host cannot extract them. */
+export declare function AttachmentNode({ node, expanded }: {
+    node: CanvasNodeState;
+    expanded?: boolean;
+}): import("preact/src").JSX.Element;

package/dist/types/client/nodes/BoardNode.d.ts

@@ -0,0 +1,5 @@
+import type { CanvasNodeState } from '../types';
+/** Native text-only cross-board link. Target identity is the durable board id. */
+export declare function BoardNode({ node }: {
+    node: CanvasNodeState;
+}): import("preact/src").JSX.Element;

package/dist/types/client/state/boards-store.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Many boards (plan 012): the workspace's boards and which one is open. The
+ * server is the authority; this mirrors GET /api/canvas/boards and the
+ * `boards-changed` SSE frame. `activeBoardId === null` is Home.
+ */
+export interface BoardSummary {
+    id: string;
+    name: string;
+    category: string | null;
+    createdAt: string;
+    lastOpenedAt: string | null;
+    nodeCount: number;
+    readmeNodeId?: string | null;
+    summary?: string | null;
+    pinnedTitles?: Array<{
+        nodeId: string;
+        title: string;
+    }>;
+    links?: Array<{
+        nodeId: string;
+        boardId: string;
+        title: string | null;
+        missing: boolean;
+    }>;
+    backlinks?: Array<{
+        boardId: string;
+        title: string;
+        nodeId: string;
+    }>;
+}
+export declare const boardList: import("@preact/signals-core").Signal<BoardSummary[]>;
+export declare const activeBoardId: import("@preact/signals-core").Signal<string | null>;
+/** False until the first list arrives — Home must not flash before the server answers. */
+export declare const boardsLoaded: import("@preact/signals-core").Signal<boolean>;
+/** The SSE bridge resyncs the canvas when the open board changes under it. */
+export declare function setBoardSwitchHandler(handler: (() => void) | null): void;
+export declare function applyBoards(data: {
+    activeBoardId?: unknown;
+    boards?: unknown;
+    reloaded?: unknown;
+} | null): void;
+export declare function loadBoards(): Promise<void>;
+/** Open a board, or Home with null. */
+export declare function openBoard(id: string | null): Promise<void>;
+export declare function createAndOpenBoard(name: string): Promise<void>;
+export interface BoardCopyCard {
+    id: string;
+    type: string;
+    title: string | null;
+    reusable: boolean;
+}
+export interface BoardCopyPreview {
+    sourceBoardId: string;
+    readmeNodeId: string | null;
+    cards: BoardCopyCard[];
+    edges: Array<{
+        id: string;
+        from: string;
+        to: string;
+        type: string;
+    }>;
+}
+export declare function previewBoardCopy(sourceBoardId: string): Promise<BoardCopyPreview | null>;
+export declare function createBoardFrom(opts: {
+    sourceBoardId: string;
+    name: string;
+    category?: string;
+    nodeIds: string[];
+    includeReadme: boolean;
+    includeStructure: boolean;
+}): Promise<BoardSummary | null>;
+/** Rename and/or re-file a board; `category: null` removes it from its category. */
+export declare function updateBoard(id: string, patch: {
+    name?: string;
+    category?: string | null;
+}): Promise<void>;
+export declare function setBoardReadme(id: string, readmeNodeId: string | null): Promise<void>;
+export declare function deleteBoard(id: string): Promise<void>;
+export declare function activeBoard(): BoardSummary | null;

package/dist/types/client/state/canvas-store.d.ts

@@ -50,6 +50,8 @@ export declare const activeNeighborNodeIds: import("@preact/signals-core").Reado
 export declare function toggleSelected(id: string): void;
 export declare function selectNodes(ids: string[]): void;
 export declare function clearSelection(): void;
+/** Clear transient UI state that must never follow a node id onto another board. */
+export declare function resetCanvasInteractionState(): void;
 /**
  * Membership feedback while a node is being dragged: the group it would join
  * on release (`add`), or the parent it would leave (`remove`). Membership

package/dist/types/client/state/intent-bridge.d.ts

@@ -98,6 +98,7 @@ export declare function createNodeFromClient(opts: {
     y?: number;
     width?: number;
     height?: number;
+    boardId?: string;
 }): Promise<{
     ok: boolean;
     id?: string;

package/dist/types/client/state/session-store.d.ts

@@ -17,6 +17,12 @@ export interface ApprovalGateView {
     createdAt: string;
     /** Unattended-approval TTL: when a pending gate auto-holds. */
     expiresAt: string | null;
+    resolvedBy?: {
+        actor: 'human' | 'agent' | 'system' | 'unknown';
+        source: string;
+        agentId?: string;
+    } | null;
+    selfAnswer?: boolean;
 }
 export interface AxEventView {
     id: string;
@@ -69,6 +75,7 @@ export declare const scopeFence: import("@preact/signals-core").ReadonlySignal<S
 export declare function setScopeFence(nodeIds: string[] | null): Promise<boolean>;
 /** Auto-held gates: the policy said no on the human's behalf; they can be reopened. */
 export declare const heldGates: import("@preact/signals-core").ReadonlySignal<ApprovalGateView[]>;
+export declare const resolvedGates: import("@preact/signals-core").ReadonlySignal<ApprovalGateView[]>;
 export interface AxTimelineView {
     events: AxEventView[];
     evidence: AxEvidenceView[];

package/dist/types/client/types.d.ts

@@ -6,7 +6,7 @@ export interface ViewportState {
 }
 export interface CanvasNodeState {
     id: string;
-    type: 'markdown' | 'mcp-app' | 'webpage' | 'json-render' | 'graph' | 'prompt' | 'response' | 'status' | 'context' | 'ledger' | 'trace' | 'file' | 'diff' | 'mermaid' | 'image' | 'html' | 'group';
+    type: 'markdown' | 'mcp-app' | 'webpage' | 'json-render' | 'graph' | 'board' | 'prompt' | 'response' | 'status' | 'context' | 'ledger' | 'trace' | 'file' | 'diff' | 'mermaid' | 'image' | 'html' | 'group';
     position: {
         x: number;
         y: number;
@@ -54,7 +54,7 @@ export type AnnotationTool = 'pen' | 'eraser' | 'text' | null;
 export type ConnectionStatus = 'connecting' | 'connected' | 'disconnected';
 export declare const TYPE_LABELS: Record<CanvasNodeState['type'], string>;
 /** Node types that support the full-viewport expand/focus overlay. */
-export declare const EXPANDABLE_TYPES: Set<"file" | "group" | "html" | "markdown" | "mcp-app" | "webpage" | "json-render" | "graph" | "prompt" | "response" | "status" | "context" | "ledger" | "trace" | "diff" | "mermaid" | "image">;
+export declare const EXPANDABLE_TYPES: Set<"file" | "group" | "html" | "markdown" | "mcp-app" | "webpage" | "json-render" | "graph" | "board" | "prompt" | "response" | "status" | "context" | "ledger" | "trace" | "diff" | "mermaid" | "image">;
 export declare const EXCALIDRAW_SERVER_NAME = "Excalidraw";
 export declare const EXCALIDRAW_CREATE_VIEW_TOOL = "create_view";
 export declare function isExcalidrawNode(node: CanvasNodeState): boolean;

package/dist/types/json-render/catalog.d.ts

@@ -388,8 +388,8 @@ export declare const allComponentDefinitions: {
             height: z.ZodNullable<z.ZodNumber>;
             colorBy: z.ZodNullable<z.ZodEnum<{
                 value: "value";
-                series: "series";
                 category: "category";
+                series: "series";
                 none: "none";
             }>>;
             highlight: z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{

package/dist/types/json-render/charts/definitions.d.ts

@@ -55,8 +55,8 @@ export declare const chartComponentDefinitions: {
             height: z.ZodNullable<z.ZodNumber>;
             colorBy: z.ZodNullable<z.ZodEnum<{
                 value: "value";
-                series: "series";
                 category: "category";
+                series: "series";
                 none: "none";
             }>>;
             highlight: z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodEnum<{

package/dist/types/json-render/server.d.ts

@@ -63,6 +63,7 @@ export declare const GRAPH_NODE_SIZE: {
     height: number;
 };
 export type GraphChartType = 'LineChart' | 'BarChart' | 'PieChart' | 'AreaChart' | 'ScatterChart' | 'RadarChart' | 'StackedBarChart' | 'ComposedChart' | 'Sparkline' | 'DotPlot' | 'BulletChart' | 'Slopegraph';
+export declare function escapeInlineScriptSource(source: string): string;
 export declare function inferJsonRenderNodeTitle(spec: JsonRenderSpec, fallback?: string): string;
 export declare function normalizeAndValidateJsonRenderSpec(spec: unknown): JsonRenderSpec;
 /** shadcn 0.21 ignores these props unless the renderer supplies a two-way binding. */
@@ -86,6 +87,11 @@ export declare function applyJsonRenderStreamPatches(currentSpec: JsonRenderSpec
     skipped: number;
 };
 export declare function createJsonRenderNodeData(nodeId: string, title: string, spec: JsonRenderSpec, extra?: Record<string, unknown>): Record<string, unknown>;
+/** The viewer bundle's script and stylesheet, as the viewer document inlines them. */
+export declare function readJsonRenderBundle(): Promise<{
+    js: string;
+    css: string;
+}>;
 export declare function buildJsonRenderViewerHtml(options: {
     title: string;
     spec: JsonRenderSpec;

package/dist/types/mcp/canvas-access.d.ts

@@ -1,5 +1,6 @@
 import { 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 { type OperationInvoker } from '../server/operations/index.js';
 type AxStateResult = ReturnType<PmxCanvas['getAxState']>;
 type AxContextResult = ReturnType<PmxCanvas['getAxContext']>;
@@ -27,8 +28,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;
@@ -51,7 +52,13 @@ export interface CanvasAccess {
     }): 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>;
     getAutomationWebViewStatus(): Promise<AutomationWebViewStatus>;

package/dist/types/mcp/context-uri-template.d.ts

@@ -0,0 +1,6 @@
+import { UriTemplate } from '@modelcontextprotocol/sdk/shared/uriTemplate.js';
+/** SDK v1 matches {?a,b} as two required, ordered parameters, unlike its expansion. */
+export declare class ContextUriTemplate extends UriTemplate {
+    constructor();
+    match(uri: string): Record<string, string> | null;
+}

package/dist/types/server/agent-presence.d.ts

@@ -86,8 +86,8 @@ export declare const PRESENCE_SET_SHAPE: {
     attached: z.ZodOptional<z.ZodBoolean>;
     parentAgentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     endedBy: z.ZodOptional<z.ZodEnum<{
-        agent: "agent";
         human: "human";
+        agent: "agent";
     }>>;
     contextUsage: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         used: z.ZodNumber;

package/dist/types/server/attribution.d.ts

@@ -0,0 +1,11 @@
+export type AttributionActor = 'human' | 'agent' | 'system' | 'unknown';
+export interface ActorAttribution {
+    actor: AttributionActor;
+    source: string;
+    agentId?: string;
+}
+export declare function setCurrentActor(actor: ActorAttribution | null): void;
+export declare function withCurrentActor<T>(actor: ActorAttribution, action: () => T): T;
+/** Direct state/SDK writes are agents unless an operation installed a narrower context. */
+export declare function currentActor(fallbackSource?: string): ActorAttribution;
+export declare function unknownActor(): ActorAttribution;

package/dist/types/server/ax-context.d.ts

@@ -23,4 +23,6 @@ export interface PmxAxSurfaceSnapshot {
  */
 export declare function buildCanvasAxSurfaceSnapshot(): PmxAxSurfaceSnapshot;
 export declare function buildCanvasAxPinnedContext(): PmxAxPinnedContext;
-export declare function buildCanvasAxContext(consumer?: string): PmxAxContext;
+export declare function buildCanvasAxContext(consumer?: string): PmxAxContext & {
+    boardId: string | null;
+};

package/dist/types/server/ax-interaction.d.ts

@@ -65,15 +65,15 @@ declare const InteractionEnvelopeSchema: z.ZodObject<{
     sourceSurface: z.ZodOptional<z.ZodEnum<{
         "mcp-app": "mcp-app";
         "json-render": "json-render";
+        adapter: "adapter";
         "native-node": "native-node";
         "html-node": "html-node";
-        adapter: "adapter";
     }>>;
     actor: z.ZodOptional<z.ZodObject<{
         kind: z.ZodEnum<{
+            human: "human";
             agent: "agent";
             system: "system";
-            human: "human";
         }>;
         id: z.ZodOptional<z.ZodString>;
         displayName: z.ZodOptional<z.ZodString>;

package/dist/types/server/ax-state.d.ts

@@ -1,6 +1,7 @@
 import type { CanvasLayout, CanvasNodeState } from './canvas-state.js';
 import type { AxApprovalStatus, AxEventKind, AxWorkItemStatus } from '../shared/ax-kinds.js';
 import type { AgentContextNode } from './agent-context.js';
+import type { ActorAttribution } from './attribution.js';
 export type PmxAxSource = 'agent' | 'amp' | 'api' | 'browser' | 'cli' | 'codex' | 'copilot' | 'mcp' | 'sdk' | 'system';
 export interface PmxAxFocusState {
     nodeIds: string[];
@@ -40,6 +41,9 @@ export interface PmxAxApprovalGate {
     resolvedAt: string | null;
     resolution: string | null;
     source: PmxAxSource | null;
+    requestedBy?: ActorAttribution;
+    resolvedBy?: ActorAttribution | null;
+    selfAnswer?: boolean;
 }
 export interface PmxAxReviewRegion {
     line?: number;
@@ -263,13 +267,16 @@ export interface PmxAxElicitation {
     createdAt: string;
     resolvedAt: string | null;
     source: PmxAxSource | null;
+    requestedBy?: ActorAttribution;
+    resolvedBy?: ActorAttribution | null;
+    selfAnswer?: boolean;
 }
 export declare function normalizeAxElicitation(input: unknown, validNodeIds?: Set<string>): PmxAxElicitation | null;
 export declare function createAxElicitation(input: {
     prompt: string;
     fields?: string[];
     nodeIds?: string[];
-}, source: PmxAxSource | null, validNodeIds?: Set<string>): PmxAxElicitation;
+}, source: PmxAxSource | null, validNodeIds?: Set<string>, requestedBy?: ActorAttribution): PmxAxElicitation;
 export type PmxAxMode = 'plan' | 'execute' | 'autonomous';
 export type PmxAxModeRequestStatus = 'pending' | 'approved' | 'rejected';
 export interface PmxAxModeRequest {
@@ -282,13 +289,16 @@ export interface PmxAxModeRequest {
     resolvedAt: string | null;
     resolution: string | null;
     source: PmxAxSource | null;
+    requestedBy?: ActorAttribution;
+    resolvedBy?: ActorAttribution | null;
+    selfAnswer?: boolean;
 }
 export declare function normalizeAxModeRequest(input: unknown, validNodeIds?: Set<string>): PmxAxModeRequest | null;
 export declare function createAxModeRequest(input: {
     mode: PmxAxMode;
     reason?: string | null;
     nodeIds?: string[];
-}, source: PmxAxSource | null, validNodeIds?: Set<string>): PmxAxModeRequest;
+}, source: PmxAxSource | null, validNodeIds?: Set<string>, requestedBy?: ActorAttribution): PmxAxModeRequest;
 export declare function createEmptyAxState(): PmxAxState;
 export declare function createEmptyAxHostCapability(): PmxAxHostCapability;
 export declare function normalizeAxFocusState(input: unknown, validNodeIds?: Set<string>): PmxAxFocusState;
@@ -312,7 +322,7 @@ export declare function createAxApprovalGate(input: {
     action?: string | null;
     nodeIds?: string[];
     ttlMs?: number;
-}, source: PmxAxSource | null, validNodeIds?: Set<string>): PmxAxApprovalGate;
+}, source: PmxAxSource | null, validNodeIds?: Set<string>, requestedBy?: ActorAttribution): PmxAxApprovalGate;
 /** Server default for a gate's TTL: `PMX_CANVAS_GATE_TTL_MS`, else five minutes. */
 export declare function defaultGateTtlMs(): number;
 export declare function createAxReviewAnnotation(input: {

package/dist/types/server/backup.d.ts

@@ -0,0 +1,36 @@
+export interface BackupFile {
+    path: string;
+    bytes: number;
+    at: string;
+}
+export interface BackupStatus {
+    folder: string;
+    keep: number;
+    everyMs: number | null;
+    lastAt: string | null;
+    lastPath: string | null;
+    backups: BackupFile[];
+}
+/** "90s", "30m", "24h", "7d" → milliseconds. */
+export declare function parseBackupInterval(value: string): number | null;
+export declare function getBackupStatus(): BackupStatus;
+/** Back up now; keeps the newest `keep` backups in the folder and removes older ones. */
+export declare function runBackup(options?: {
+    folder?: string;
+    keep?: number;
+}): {
+    backup: BackupFile;
+    removed: string[];
+};
+/** Set the schedule (`everyMs` null turns it off). Folder and keep also apply to manual backups. */
+export declare function setBackupSchedule(options: {
+    everyMs: number | null;
+    folder?: string;
+    keep?: number;
+}): BackupStatus;
+/** Runs a scheduled backup when one is due. Returns whether it ran. */
+export declare function runDueBackup(now?: number): boolean;
+/** Rejects anything that is not a canvas database before the live file is touched. */
+export declare function assertRestorableBackup(file: string): void;
+export declare function startBackupScheduler(): void;
+export declare function stopBackupScheduler(): void;

package/dist/types/server/board-export.d.ts

@@ -0,0 +1,45 @@
+export interface ExportManifest {
+    boardId: string;
+    boardName: string;
+    cards: number;
+    connections: number;
+    /** Cards shown in sandboxed frames: html, charts, diagrams, built apps. */
+    frames: number;
+    placeholders: Array<{
+        nodeId: string;
+        title: string;
+        reason: string;
+    }>;
+    files: Array<{
+        nodeId: string;
+        path: string;
+        included: boolean;
+    }>;
+    attachments: Array<{
+        nodeId: string;
+        name: string;
+    }>;
+    sourceDerivedCards: Array<{
+        nodeId: string;
+        included: boolean;
+    }>;
+    embeddedImages: number;
+    /** Web images the file loads when opened. */
+    remoteImages: string[];
+    /** Navigable links present in markdown and webpage cards. */
+    links: string[];
+    /** Statically visible network destinations in sandboxed HTML frames. */
+    frameNetworkDestinations: string[];
+    /** Scripts in embedded frames can make requests that static inspection cannot enumerate. */
+    embeddedCodeCanAccessNetwork: boolean;
+    includeFiles: boolean;
+}
+/** What an export of `boardId` would put in the file, without building it. */
+export declare function previewBoardExport(boardId: string, includeFiles: boolean, includeDerivedText?: boolean): Promise<ExportManifest | null>;
+export declare function buildBoardExport(boardId: string, includeFiles: boolean, includeDerivedText?: boolean): Promise<{
+    html: string;
+    manifest: ExportManifest;
+} | null>;
+/** Writes the export beside the database (`exports/`) and returns its path. */
+export declare function writeBoardExport(html: string, boardName: string): string;
+export declare function exportsFolder(): string | null;

package/dist/types/server/canvas-db.d.ts

@@ -21,8 +21,27 @@ export interface PersistedCanvasState {
     annotations?: CanvasAnnotation[];
     contextPins: string[];
     ax?: PmxAxState;
+    revisionState?: PersistedRevisionState;
 }
-export declare function openCanvasDb(dbPath: string): Database;
+export interface PersistedRevisionState {
+    revision: number;
+    floor: number;
+    tombstones: Array<{
+        nodeId: string;
+        revision: number;
+        deletedBy: import('./attribution.js').ActorAttribution;
+    }>;
+}
+/** Durable, delivery-based context cursor. This is separate from the bounded diagnostic read log. */
+export declare function readContextBriefCursor(db: Database, boardId: string, consumer: string): number | null;
+/** Monotonic update prevents a stale concurrent response from regressing a consumer. */
+export declare function advanceContextBriefCursor(db: Database, boardId: string, consumer: string, revision: number): void;
+export interface OpenCanvasDbOptions {
+    /** Name for the board a pre-boards (0.6.x) database migrates into. */
+    migratedBoardName?: string;
+}
+export declare function openCanvasDb(dbPath: string, options?: OpenCanvasDbOptions): Database;
+export declare function createBoardId(): string;
 export declare function checkpointCanvasDb(db: Database): void;
 /**
  * Delete blob rows nothing references any more. Blobs are content-addressed and
@@ -39,17 +58,52 @@ export declare function checkpointCanvasDb(db: Database): void;
  */
 export declare function gcBlobsInDB(db: Database): number;
 export declare function finalizeCanvasDbForClose(db: Database): void;
-export declare function saveStateToDB(db: Database, state: PersistedCanvasState): void;
-/** Check if the DB has been populated with canvas state at least once. */
-export declare function isDbPopulated(db: Database): boolean;
-export declare function loadStateFromDB(db: Database): PersistedCanvasState | null;
-export declare function saveSnapshotToDB(db: Database, snapshot: CanvasSnapshot, state: PersistedCanvasState): void;
-export declare function loadSnapshotFromDB(db: Database, idOrName: string): {
+/** The theme is workspace-wide: it is saved even while no board is open. */
+export declare function saveThemeToDB(db: Database, theme: CanvasTheme | undefined): void;
+export declare function readThemeFromDB(db: Database): CanvasTheme | undefined;
+/** Saves one board's state; every other board's rows are untouched. */
+export declare function saveStateToDB(db: Database, boardId: string, state: PersistedCanvasState): void;
+/** Loads one board (the open board when `boardId` is omitted); null when there is no such board. */
+export declare function loadStateFromDB(db: Database, boardId?: string): PersistedCanvasState | null;
+export interface CanvasBoard {
+    id: string;
+    name: string;
+    /** A human-chosen shelf on Home ("Planning", "Research"); null is uncategorized. */
+    category: string | null;
+    createdAt: string;
+    lastOpenedAt: string | null;
+    nodeCount: number;
+    /** Markdown node used as this board's introduction. */
+    readmeNodeId: string | null;
+}
+/** Most recently opened first, then never-opened boards, newest first. */
+export declare function listBoardsFromDB(db: Database): CanvasBoard[];
+export declare function getBoardFromDB(db: Database, id: string): CanvasBoard | null;
+export declare function createBoardInDB(db: Database, name: string, category?: string | null): CanvasBoard;
+/** Rename and/or re-shelve a board; `category: null` removes it from its category. */
+export declare function updateBoardInDB(db: Database, id: string, patch: {
+    name?: string;
+    category?: string | null;
+    readmeNodeId?: string | null;
+}): boolean;
+/** Create and populate an inactive board as one SQLite transaction. */
+export declare function createBoardWithStateInDB(db: Database, name: string, category: string | null, state: PersistedCanvasState, readmeNodeId: string | null): CanvasBoard;
+/** Deletes a board with its rows and its snapshots. */
+export declare function deleteBoardFromDB(db: Database, id: string): boolean;
+export declare function readMetaFromDB(db: Database, key: string): string | null;
+/** Write a workspace-wide meta value; null removes it. */
+export declare function writeMetaToDB(db: Database, key: string, value: string | null): void;
+/** The board that was open last, if it still exists. */
+export declare function getActiveBoardIdFromDB(db: Database): string | null;
+export declare function setActiveBoardIdInDB(db: Database, id: string | null): void;
+export declare function saveSnapshotToDB(db: Database, boardId: string, snapshot: CanvasSnapshot, state: PersistedCanvasState): void;
+/** By id or name (most recent match) on `boardId`. */
+export declare function loadSnapshotFromDB(db: Database, idOrName: string, boardId: string | null): {
     snapshot: CanvasSnapshot;
     state: PersistedCanvasState;
 } | null;
-export declare function listSnapshotsFromDB(db: Database, options?: CanvasSnapshotListOptions): CanvasSnapshot[];
-export declare function renameSnapshotInDB(db: Database, id: string, name: string): boolean;
+export declare function listSnapshotsFromDB(db: Database, boardId: string, options?: CanvasSnapshotListOptions): CanvasSnapshot[];
+export declare function renameSnapshotInDB(db: Database, boardId: string, id: string, name: string): boolean;
 export declare function deleteSnapshotFromDB(db: Database, id: string): boolean;
 export declare function writeBlobToDB(db: Database, sha256: string, jsonValue: string): number;
 export declare function readBlobFromDB(db: Database, sha256: string): string | null;