pmx-canvas 0.6.4 → 0.7.0

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

@@ -17,10 +17,14 @@ 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';
 import './commands/webview.js';
+import './commands/record.js';
 import './commands/apps.js';
 import './commands/copilot.js';
 import './commands/skills.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/commands/record.d.ts

@@ -0,0 +1,12 @@
+export declare function parseRecordOptions(flags: Record<string, string | boolean>): {
+    theme: "dark" | "light" | "high-contrast" | "midnight" | "sepia" | "arctic" | "ember" | "forest" | "volt" | undefined;
+    present: boolean;
+    tourFile: string | undefined;
+    chromePath: string | undefined;
+    width: number;
+    height: number;
+    fps: number;
+    mode: "realtime" | "deterministic";
+    output: string;
+    duration?: number | undefined;
+};

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/canvas/Presentation.d.ts

@@ -0,0 +1,13 @@
+import { type Camera } from '../../shared/tour.js';
+import { canvasArea } from './canvas-area';
+declare global {
+    interface Window {
+        pmxCapture?: {
+            ready: () => boolean;
+            area: typeof canvasArea;
+            camera: () => Camera;
+            frame: (camera: Camera) => Promise<Camera>;
+        };
+    }
+}
+export declare function Presentation(): import("preact/jsx-runtime").JSX.Element | null;

package/dist/types/client/canvas/use-node-drag.d.ts

@@ -5,11 +5,12 @@ interface NodeDragOptions {
     viewport: Signal<ViewportState>;
     onMove: (id: string, x: number, y: number) => void;
     onDragEnd: () => void;
+    onClick?: () => void;
 }
 /**
  * Hook for dragging canvas nodes by their title bar.
  * Converts screen-space pointer delta to canvas-space position delta
  * (accounting for current viewport scale).
  */
-export declare function useNodeDrag({ nodeId, viewport, onMove, onDragEnd }: NodeDragOptions): (e: PointerEvent, currentX: number, currentY: number) => void;
+export declare function useNodeDrag({ nodeId, viewport, onMove, onDragEnd, onClick }: NodeDragOptions): (e: PointerEvent, currentX: number, currentY: number) => void;
 export {};

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/nodes/McpAppNode.d.ts

@@ -1,6 +1,29 @@
+import type { RefObject } from 'preact';
 import type { CanvasNodeState } from '../types';
 export declare function isSameOriginFrameDocumentUrl(url: string, origin?: string): boolean;
+type ViewerFrameSource = {
+    src?: string;
+    srcdoc?: string;
+};
+/**
+ * Keep the last painted viewer in front while its replacement navigates. Viewer
+ * specs are immutable documents, so updates normally change `?v=` and reload the
+ * iframe; putting the new document in a hidden sibling avoids exposing Chromium's
+ * white navigation paint. Two animation frames after load gives the new document
+ * a composited paint before the old one is removed.
+ */
+export declare function RefreshingViewerFrame({ source, iframeRef, onLoad, title, className, sandbox, allow, tabIndex, }: {
+    source: ViewerFrameSource;
+    iframeRef: RefObject<HTMLIFrameElement>;
+    onLoad: () => void;
+    title: string;
+    className?: string;
+    sandbox?: string;
+    allow?: string;
+    tabIndex?: number;
+}): import("preact").JSX.Element;
 export declare function McpAppNode({ node, expanded }: {
     node: CanvasNodeState;
     expanded?: boolean;
-}): import("preact/jsx-runtime").JSX.Element;
+}): import("preact").JSX.Element;
+export {};

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/presentation.d.ts

@@ -0,0 +1,3 @@
+export declare const presenting: import("@preact/signals-core").Signal<boolean>;
+export declare const recordingCamera: import("@preact/signals-core").Signal<boolean>;
+export declare function ownsCamera(): boolean;

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<"html" | "markdown" | "mcp-app" | "webpage" | "json-render" | "graph" | "prompt" | "response" | "status" | "context" | "ledger" | "trace" | "file" | "diff" | "mermaid" | "image" | "group">;
+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<{
@@ -474,10 +474,10 @@ export declare const allComponentDefinitions: {
             text: z.ZodString;
             variant: z.ZodNullable<z.ZodEnum<{
                 error: "error";
+                success: "success";
+                default: "default";
                 info: "info";
                 warning: "warning";
-                default: "default";
-                success: "success";
                 secondary: "secondary";
                 destructive: "destructive";
                 outline: "outline";

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,8 +63,11 @@ 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. */
+export declare function jsonRenderFormWarnings(spec: JsonRenderSpec): string[];
 export declare function normalizeGraphType(value: string): GraphChartType;
 export declare function buildGraphSpec(input: GraphNodeInput): JsonRenderSpec;
 export declare function buildGraphConfig(input: GraphNodeInput): Record<string, unknown>;
@@ -84,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;