@xpert-ai/plugin-canvas 0.1.0

package/dist/lib/remote-components/canvas-workbench/src/tool-event-refresh.js

@@ -0,0 +1,19 @@
+const CANVAS_TOOL_NAMES = new Set([
+    'canvas_create_document',
+    'canvas_save_snapshot',
+    'canvas_patch_records',
+    'canvas_insert_image',
+    'canvas_update_document_status',
+    'canvas_report_failure'
+]);
+export function shouldRefreshForCanvasToolEvent(event) {
+    if (!isToolEventObject(event)) {
+        return false;
+    }
+    const toolName = event.toolName ?? event.name ?? event.payload?.toolName ?? event.data?.toolName;
+    return typeof toolName === 'string' && CANVAS_TOOL_NAMES.has(toolName);
+}
+function isToolEventObject(event) {
+    return Boolean(event && typeof event === 'object' && !Array.isArray(event));
+}
+//# sourceMappingURL=tool-event-refresh.js.map

package/dist/lib/remote-components/canvas-workbench/src/tool-event-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-event-refresh.js","sourceRoot":"","sources":["../../../../../src/lib/remote-components/canvas-workbench/src/tool-event-refresh.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,wBAAwB;IACxB,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,+BAA+B;IAC/B,uBAAuB;CACxB,CAAC,CAAA;AAeF,MAAM,UAAU,+BAA+B,CAAC,KAA+B;IAC7E,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAA;IAChG,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AACxE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA+B;IACxD,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;AAC7E,CAAC"}

package/dist/lib/remote-components/canvas-workbench/src/vendor.d.ts

@@ -0,0 +1,9 @@
+import type * as ReactNamespace from 'react';
+import type * as ReactDOMNamespace from 'react-dom';
+import type * as ReactDOMClientNamespace from 'react-dom/client';
+type ReactDOMGlobal = typeof ReactDOMNamespace & typeof ReactDOMClientNamespace;
+export declare const React: typeof ReactNamespace;
+export declare const ReactDOM: ReactDOMGlobal;
+export declare const h: typeof ReactNamespace.createElement;
+export {};
+//# sourceMappingURL=vendor.d.ts.map

package/dist/lib/remote-components/canvas-workbench/src/vendor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.d.ts","sourceRoot":"","sources":["../../../../../src/lib/remote-components/canvas-workbench/src/vendor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,cAAc,MAAM,OAAO,CAAA;AAC5C,OAAO,KAAK,KAAK,iBAAiB,MAAM,WAAW,CAAA;AACnD,OAAO,KAAK,KAAK,uBAAuB,MAAM,kBAAkB,CAAA;AAEhE,KAAK,cAAc,GAAG,OAAO,iBAAiB,GAAG,OAAO,uBAAuB,CAAA;AAM/E,eAAO,MAAM,KAAK,uBAAmD,CAAA;AACrE,eAAO,MAAM,QAAQ,gBAA+C,CAAA;AACpE,eAAO,MAAM,CAAC,EAAE,OAAO,cAAc,CAAC,aAAmC,CAAA"}

package/dist/lib/remote-components/canvas-workbench/src/vendor.js

@@ -0,0 +1,7 @@
+function readWindowGlobal(key) {
+    return window[key];
+}
+export const React = readWindowGlobal('React');
+export const ReactDOM = readWindowGlobal('ReactDOM');
+export const h = React.createElement;
+//# sourceMappingURL=vendor.js.map

package/dist/lib/remote-components/canvas-workbench/src/vendor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.js","sourceRoot":"","sources":["../../../../../src/lib/remote-components/canvas-workbench/src/vendor.ts"],"names":[],"mappings":"AAMA,SAAS,gBAAgB,CAAI,GAAyB;IACpD,OAAO,MAAM,CAAC,GAAmB,CAAM,CAAA;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,gBAAgB,CAAwB,OAAO,CAAC,CAAA;AACrE,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAiB,UAAU,CAAC,CAAA;AACpE,MAAM,CAAC,MAAM,CAAC,GAAwC,KAAK,CAAC,aAAa,CAAA"}

package/dist/lib/types.d.ts

@@ -0,0 +1,180 @@
+export type CanvasDocumentStatus = 'draft' | 'reviewed' | 'archived';
+export type CanvasDocumentKind = 'canvas' | 'whiteboard' | 'moodboard' | 'wireframe' | 'annotation' | 'image-board' | 'other';
+export type CanvasVersionSource = 'agent_snapshot' | 'agent_patch' | 'agent_image' | 'workbench' | 'import' | 'restore';
+export type CanvasActorType = 'agent' | 'user' | 'system';
+export type CanvasWorkspaceCatalog = 'xperts' | 'projects';
+export type CanvasActionType = 'document_created' | 'snapshot_saved' | 'records_patched' | 'image_inserted' | 'status_updated' | 'version_restored' | 'document_archived' | 'failure_reported';
+export declare const CANVAS_WORKSPACE_FILES_RUNTIME_CAPABILITY = "platform.workspace.files";
+export type CanvasJsonPrimitive = string | number | boolean | null;
+export type CanvasJsonValue = CanvasJsonPrimitive | CanvasJsonObject | CanvasJsonArray;
+export interface CanvasJsonObject {
+    [key: string]: CanvasJsonValue | undefined;
+}
+export type CanvasJsonArray = CanvasJsonValue[];
+export interface CanvasRecord extends CanvasJsonObject {
+    id: string;
+    typeName?: string;
+    type?: string;
+    parentId?: string;
+    index?: string;
+    x?: number;
+    y?: number;
+    rotation?: number;
+    props?: CanvasJsonObject;
+    meta?: CanvasJsonObject;
+}
+export interface CanvasSnapshotData extends CanvasJsonObject {
+    schema: CanvasJsonValue;
+    store: Record<string, CanvasRecord>;
+}
+export interface CanvasScope {
+    tenantId: string;
+    organizationId?: string | null;
+    workspaceId?: string | null;
+    projectId?: string | null;
+    userId?: string | null;
+    assistantId?: string | null;
+    conversationId?: string | null;
+}
+export interface CanvasWorkspaceFileScope {
+    tenantId?: string | null;
+    userId?: string | null;
+    catalog: CanvasWorkspaceCatalog;
+    scopeId: string;
+    xpertId?: string | null;
+    projectId?: string | null;
+    isolateByUser?: boolean | null;
+}
+export interface CanvasWorkspaceFileRecord {
+    name?: string;
+    filePath: string;
+    workspacePath?: string;
+    fileUrl?: string;
+    url?: string;
+    mimeType?: string;
+    size?: number;
+    catalog?: CanvasWorkspaceCatalog;
+    scopeId?: string;
+}
+export interface CanvasWorkspaceFilesApi {
+    uploadBuffer(input: CanvasWorkspaceFileScope & {
+        buffer: Buffer;
+        originalName: string;
+        mimeType?: string | null;
+        size?: number | null;
+        folder?: string | null;
+        fileName?: string | null;
+        metadata?: CanvasJsonObject;
+    }): Promise<CanvasWorkspaceFileRecord>;
+    deleteFile(input: CanvasWorkspaceFileScope & {
+        filePath: string;
+    }): Promise<void>;
+}
+export interface CanvasSnapshotImageInput {
+    dataUrl?: string | null;
+    base64?: string | null;
+    mimeType?: string | null;
+    fileName?: string | null;
+    width?: number | null;
+    height?: number | null;
+    pageId?: string | null;
+    camera?: CanvasJsonValue;
+    capturedAt?: string | null;
+}
+export interface CanvasSnapshotInput {
+    snapshot?: CanvasSnapshotData | null;
+    viewState?: CanvasJsonObject | null;
+    selectionSummary?: CanvasJsonObject | null;
+    snapshotImage?: CanvasSnapshotImageInput | null;
+}
+export interface CreateCanvasDocumentInput extends CanvasSnapshotInput {
+    title: string;
+    description?: string;
+    kind?: CanvasDocumentKind;
+    tags?: string[];
+    source?: string;
+    changeSummary?: string;
+}
+export interface SaveCanvasSnapshotInput extends CanvasSnapshotInput {
+    documentId: string;
+    sourceType?: CanvasVersionSource;
+    changeSummary?: string;
+}
+export interface AutosaveCanvasSnapshotInput extends CanvasSnapshotInput {
+    documentId: string;
+    snapshot: CanvasSnapshotData;
+    snapshotImage: CanvasSnapshotImageInput;
+    changeSummary?: string | null;
+}
+export interface PatchCanvasRecordsInput {
+    documentId: string;
+    putRecords?: CanvasRecord[];
+    removeRecordIds?: string[];
+    viewStatePatch?: CanvasJsonObject;
+    selectionSummary?: CanvasJsonObject | null;
+    changeSummary?: string;
+}
+export interface InsertCanvasImageInput {
+    documentId?: string;
+    title?: string;
+    description?: string;
+    kind?: CanvasDocumentKind;
+    dataUrl?: string;
+    base64?: string;
+    mimeType?: string;
+    fileName?: string;
+    width?: number;
+    height?: number;
+    displayWidth?: number;
+    displayHeight?: number;
+    pageId?: string;
+    anchorShapeId?: string;
+    placement?: 'right' | 'left' | 'below' | 'center';
+    margin?: number;
+    matchAnchor?: boolean;
+    altText?: string;
+    shapeMeta?: CanvasJsonObject;
+    assetMeta?: CanvasJsonObject;
+    changeSummary?: string;
+}
+export interface SearchCanvasDocumentsInput {
+    status?: CanvasDocumentStatus;
+    kind?: CanvasDocumentKind;
+    search?: string;
+    page?: number;
+    pageSize?: number;
+}
+export interface GetCanvasDocumentInput {
+    documentId: string;
+    versionId?: string;
+    versionNumber?: number;
+    includeSnapshot?: boolean;
+    versionLimit?: number;
+    includeLogs?: boolean;
+    logLimit?: number;
+}
+export interface GetCanvasRecordInput {
+    documentId: string;
+    recordId: string;
+    versionId?: string;
+    versionNumber?: number;
+}
+export interface UpdateCanvasDocumentStatusInput {
+    documentId: string;
+    status: CanvasDocumentStatus;
+    reason?: string;
+}
+export interface ReportCanvasFailureInput {
+    documentId?: string;
+    versionId?: string;
+    operation: string;
+    errorMessage: string;
+    recoverable?: boolean;
+    evidence?: CanvasJsonValue;
+}
+export interface PrepareCanvasAssistantPromptInput {
+    documentId: string;
+    instruction?: string | null;
+    includeSceneSummary?: boolean | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+export const CANVAS_WORKSPACE_FILES_RUNTIME_CAPABILITY = 'platform.workspace.files';
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,yCAAyC,GAAG,0BAA0B,CAAA"}

package/dist/xpert-canvas-assistant.yaml

@@ -0,0 +1,168 @@
+team:
+  name: canvas-assistant
+  type: agent
+  title: Canvas Assistant
+  description: Agentic visual canvas assistant for infinite whiteboards, AI image slots, annotation workflows, and moodboards
+  avatar:
+    emoji:
+      id: art
+    background: rgb(204, 251, 241)
+  options:
+    templateKey: canvas-assistant
+    dataXpert:
+      managedBy: data-xpert
+      templateKey: canvas-assistant
+      assistantKind: business-assistant
+      businessDomain: canvas
+      requiredPlugin: '@xpert-ai/plugin-canvas'
+      requiredPlugins:
+        - '@xpert-ai/plugin-canvas'
+        - '@xpert-ai/plugin-view-image'
+      requiredCapabilities:
+        - canvas
+        - canvas-workbench
+        - agent-canvas
+  agentConfig:
+    stateVariables:
+      - name: currentCanvasDocumentId
+        type: string
+        default: ""
+        description: Current Canvas document id selected in the workbench
+        operation: null
+      - name: currentCanvasVersionId
+        type: string
+        default: ""
+        description: Current Canvas version id selected in the workbench
+        operation: null
+    recursionLimit: 10000
+  features:
+    sandbox:
+      enabled: true
+      provider: docker-sandbox
+  version: "1"
+  agent:
+    key: Agent_Canvas
+  copilotModel:
+    referencedId: null
+    modelType: llm
+    model: qwen3.6-plus
+    options:
+      context_size: 1000000
+      temperature: 0.2
+      maxRetries: 6
+      max_tokens: 8192
+      top_p: 0.95
+  knowledgebases: []
+  toolsets: []
+  tags: []
+nodes:
+  - type: agent
+    key: Agent_Canvas
+    position:
+      x: 860
+      y: 20
+    entity:
+      key: Agent_Canvas
+      name: canvas-assistant
+      title: Canvas Assistant
+      description: Agentic visual canvas assistant for infinite whiteboards, AI image slots, annotation workflows, and moodboards
+      avatar:
+        emoji:
+          id: art
+        background: rgb(204, 251, 241)
+      prompt: >
+        You are Canvas Assistant, a data-xpert business assistant for creating and
+        managing reviewable tldraw infinite canvases.
+
+        Use Canvas middleware tools as the system of record. Do not claim that a
+        canvas was saved unless a tool call succeeded. Keep every canvas reviewable,
+        editable, and versioned.
+
+        Runtime Canvas Workbench context rendered from request state variables may be
+        empty when no canvas or shape is selected:
+        - canvasDocumentId: {{env.canvasDocumentId}}
+        - canvasVersionId: {{env.canvasVersionId}}
+        - canvasPageId: {{env.canvasPageId}}
+        - canvasSelectionJson: {{{env.canvasSelectionJson}}}
+        - canvasSceneDirty: {{env.canvasSceneDirty}}
+        - canvasContextJson: {{{env.canvasContextJson}}}
+        - canvasSnapshotImagePath: {{env.canvasSnapshotImagePath}}
+        - canvasSnapshotImageUpdatedAt: {{env.canvasSnapshotImageUpdatedAt}}
+        - canvasSceneSource: {{env.canvasSceneSource}}
+
+        If canvasContextJson is non-empty, parse it as the current Workbench Canvas
+        context. Treat currentCanvas.selection.type = "canvas.selection.v1" as the
+        explicit machine-readable current selection for this turn.
+
+        If canvasSnapshotImagePath is non-empty and the user asks you to understand
+        visual content, inspect layout, follow annotations, describe the board, or
+        edit an image based on marked-up feedback, first call view_image with path
+        equal to canvasSnapshotImagePath. Do not guess the current visual contents
+        from tldraw JSON alone when a viewport snapshot image is available.
+
+        Canvas workflow:
+        1. Clarify the visual goal, audience, key regions, labels, and image needs
+           when the request is ambiguous.
+        2. Create a canvas with canvas_create_document, then save generated tldraw
+           snapshots with canvas_save_snapshot or targeted record changes with
+           canvas_patch_records.
+        3. Use canvas_insert_image only after an image has been generated or provided.
+           Pass dataUrl or base64. If a selected shape is an AI image holder frame,
+           pass its id as anchorShapeId so the image fills that slot.
+        4. When updating an existing canvas, call canvas_get_document first. Use
+           canvas_get_record for exact record JSON before patching selected shapes,
+           assets, bindings, image holders, or pages.
+        5. When request context contains currentCanvas.selection with type
+           "canvas.selection.v1", treat selectedShapeIds as the explicit user
+           selection. Only modify selected shapes unless the user explicitly asks to
+           affect other content.
+        6. Keep changeSummary short and operational. Use canvas_report_failure when
+           a snapshot, patch, image insertion, or requested edit cannot be completed.
+
+        tldraw rules:
+        - Preserve user-created records and pages unless the user asks for removal.
+        - Prefer small record patches for edits; use full snapshots for imports or
+          intentional complete replacements.
+        - Use AI image holder frames for future generated images and annotation
+          arrows/text for visible edit briefs.
+        - Do not include secrets, tokens, tenant ids, or organization ids in canvas
+          records.
+
+        Match the user's language. If the user's language is unclear, respond in English.
+      collaboratorNames: []
+      toolsetIds: []
+      knowledgebaseIds: []
+    hash: canvas-agent-v1
+  - type: workflow
+    key: Middleware_Canvas
+    position:
+      x: 1160
+      y: 332
+    entity:
+      type: middleware
+      key: Middleware_Canvas
+      title: Canvas Agent Tools
+      provider: CanvasMiddleware
+      required: true
+    hash: canvas-middleware-v1
+  - type: workflow
+    key: Middleware_ViewImage
+    position:
+      x: 1160
+      y: 480
+    entity:
+      type: middleware
+      key: Middleware_ViewImage
+      title: View Canvas Snapshot Images
+      provider: ViewImageMiddleware
+      required: true
+    hash: canvas-view-image-middleware-v1
+connections:
+  - type: workflow
+    key: Agent_Canvas/Middleware_Canvas
+    from: Agent_Canvas
+    to: Middleware_Canvas
+  - type: workflow
+    key: Agent_Canvas/Middleware_ViewImage
+    from: Agent_Canvas
+    to: Middleware_ViewImage

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@xpert-ai/plugin-canvas",
+  "version": "0.1.0",
+  "description": "Canvas app plugin for agent-managed tldraw infinite canvases, image holders, annotation workflows, reviewable versions, and an editable workbench.",
+  "author": {
+    "name": "XpertAI",
+    "url": "https://xpertai.cn"
+  },
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xpert-ai/xpert-plugins.git",
+    "directory": "xpertai/apps/canvas"
+  },
+  "bugs": {
+    "url": "https://github.com/xpert-ai/xpert-plugins/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@xpert-plugins-starter/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    ".xpertai-plugin",
+    "assets",
+    "skills",
+    "README.md",
+    "!**/*.tsbuildinfo"
+  ],
+  "xpert": {
+    "plugin": {
+      "level": "system"
+    }
+  },
+  "dependencies": {
+    "@tldraw/tlschema": "5.1.1",
+    "fractional-indexing": "^3.2.0",
+    "tldraw": "5.1.1",
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=0.3.0",
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/typeorm": "^11.0.0",
+    "@xpert-ai/contracts": "^3.10.1",
+    "@xpert-ai/plugin-sdk": "^3.10.1",
+    "react": ">=18",
+    "react-dom": ">=18",
+    "typeorm": "^0.3.24",
+    "zod": "3.25.67"
+  },
+  "devDependencies": {
+    "@langchain/core": "0.3.72",
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/typeorm": "^11.0.0",
+    "@types/node": "^20.19.9",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.7",
+    "@xpert-ai/contracts": "3.10.1",
+    "@xpert-ai/plugin-sdk": "^3.10.1",
+    "esbuild": "^0.27.0",
+    "jest": "^30.0.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "reflect-metadata": "^0.2.2",
+    "typeorm": "^0.3.24",
+    "typescript": "^5.9.2",
+    "zod": "3.25.67",
+    "@xpert-ai/plugin-shadcn-ui": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node scripts/build-remote-components.mjs && tsc -p tsconfig.lib.json && node scripts/copy-assets.mjs",
+    "lint": "echo \"(todo) add lint\"",
+    "test": "jest --config jest.config.ts && tsc -p tsconfig.spec.json --noEmit && tsc -p tsconfig.remote.json --noEmit && node scripts/build-remote-components.mjs --check",
+    "typecheck": "tsc -p tsconfig.spec.json --noEmit && tsc -p tsconfig.remote.json --noEmit && node scripts/build-remote-components.mjs --check"
+  }
+}

package/skills/canvas-agent-skill/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: canvas-agent-skill
+description: "Use when an Agent needs to use @xpert-ai/plugin-canvas middleware tools to create, inspect, patch, version, review, annotate, insert images into, or recover tldraw Canvas documents, including Workbench selection context and AI image holders."
+---
+
+# Canvas Agent Skill
+
+Use this skill when a user asks an Agent to create, update, inspect, review, annotate, or recover a Canvas document through the Xpert Canvas plugin.
+
+The plugin has two surfaces:
+
+- Workbench: the human review and editing surface. It can list canvases, edit the tldraw board, create AI image holders, add annotations, save versions, import/export snapshots, restore versions, mark reviewed/draft, archive, and delete canvases.
+- Middleware tools: the Agent-callable system of record. These tools create canvas records, save snapshots, patch tldraw records, insert image data URLs, search/read metadata, fetch exact records, update lifecycle status, and report failures.
+- View image: the Canvas Assistant template should include `@xpert-ai/plugin-view-image`. Use `view_image` to inspect the latest viewport snapshot image before reasoning about visible layout, annotations, or image feedback.
+
+Do not treat Workbench view actions as Agent middleware tools. Use only the middleware tool names documented below when acting from an Agent.
+
+## Core Rules
+
+1. Do not invent document ids, version ids, page ids, shape ids, asset ids, or binding ids for existing canvases. Use Workbench context, `canvas_search_documents`, `canvas_get_document`, or `canvas_get_record`.
+2. Before editing an existing canvas, call `canvas_get_document` unless the current prompt already contains trustworthy Workbench context with the document id and version ref. By default this reads the latest autosaved working copy.
+3. Prefer `canvas_patch_records` for targeted edits. Use `canvas_save_snapshot` only for a full snapshot import or intentional complete replacement.
+4. Use `canvas_insert_image` only after image generation or when the user provides image data. Pass `dataUrl` or `base64`; the tool stores image data inside tldraw asset records for v1.
+5. If the selected shape is an AI image holder frame, pass that frame id as `anchorShapeId`; the image will be inserted as a child of the frame and sized to the holder.
+6. Do not delete or move annotations unless the user explicitly asks. Annotation arrows and notes are review evidence.
+7. Do not claim a canvas was saved unless the tool call succeeded. Tool results are the source of truth.
+8. Do not route logic from display text or localized labels. Use explicit fields such as `selection.type`, `selectedShapeIds`, `kind`, `status`, and `sourceType`.
+9. When the user asks what is currently visible, asks you to follow markups, asks for layout critique, or asks for image edits based on annotations, call `view_image` first with `env.canvasSnapshotImagePath` or the `snapshotImagePath` returned by `canvas_get_document`.
+
+## Workbench Selection Context
+
+The Workbench can send `assistant.context.set` when the user selects shapes. That request state is not automatically visible to the model unless the assistant prompt renders it through prompt variables.
+
+When the prompt includes these variables, use them before searching broadly:
+
+- `env.canvasDocumentId`
+- `env.canvasVersionId`
+- `env.canvasPageId`
+- `env.canvasSelectionJson`
+- `env.canvasContextJson`
+- `env.canvasSceneDirty`
+- `env.canvasSnapshotImagePath`
+- `env.canvasSnapshotImageUpdatedAt`
+- `env.canvasSceneSource`
+
+If `env.canvasContextJson` is non-empty, parse it as JSON. The expected shape is:
+
+```json
+{
+  "currentCanvas": {
+    "documentId": "document-id",
+    "title": "Canvas title",
+    "currentVersionId": "version-id",
+    "currentVersionNumber": 12,
+    "isDirty": true,
+    "sceneSource": "autosave",
+    "snapshotImagePath": "files/canvas/documents/document-id/snapshots/current.png",
+    "snapshotImageUpdatedAt": "2026-06-25T15:22:28.459Z",
+    "selection": {
+      "type": "canvas.selection.v1",
+      "pageId": "page:page",
+      "selectedShapeIds": ["shape:id"],
+      "selectedShapeCount": 1,
+      "shapes": [
+        {
+          "id": "shape:id",
+          "type": "frame",
+          "x": 10,
+          "y": 20,
+          "w": 512,
+          "h": 683,
+          "isAiImageHolder": true
+        }
+      ],
+      "capturedAt": "2026-06-25T15:22:28.459Z"
+    }
+  }
+}
+```
+
+Selection rules:
+
+- Treat `currentCanvas.selection.type === "canvas.selection.v1"` as the only valid machine-readable selection discriminator.
+- If a valid selection exists, modify only `selectedShapeIds` unless the user explicitly asks to affect neighboring or unselected shapes.
+- Use compact `selection.shapes` only for orientation, bounds, and intent. Fetch full record JSON with `canvas_get_record` before changing exact geometry, style, bindings, text, asset refs, or page membership.
+- If `currentCanvas.isDirty === true` or `env.canvasSceneDirty === "true"`, Workbench may still be autosaving. Use the newest autosaved working copy from `canvas_get_document` before patching.
+- If `currentCanvas.snapshotImagePath` or `env.canvasSnapshotImagePath` is present, it points to the latest fixed viewport snapshot image, usually `files/canvas/documents/{documentId}/snapshots/current.png`.
+
+## Visual Snapshot Reading
+
+Use `view_image` when visual understanding matters:
+
+- Current board description, visual QA, layout critique, or “what did I draw?”
+- Annotation-driven image iteration, such as arrows/text pointing to regions to change
+- Comparing what is visible in the viewport with a requested change
+- Any task where tldraw JSON alone would be a guess about rendered appearance
+
+Call shape:
+
+```json
+{
+  "path": "files/canvas/documents/document-id/snapshots/current.png"
+}
+```
+
+After `view_image` returns, combine the visual evidence with `canvas_get_document` or `canvas_get_record` when exact record edits are needed.
+
+## Tool Contracts
+
+### `canvas_create_document`
+
+Create a managed canvas metadata record. Required input: `title`. Optional inputs: `description`, `kind`, `tags`, `source`, `snapshot`, `viewState`, `selectionSummary`, `changeSummary`.
+
+### `canvas_save_snapshot`
+
+Save a complete valid tldraw snapshot as a new version. Required input: `documentId`, `snapshot`. Optional inputs: `viewState`, `selectionSummary`, `snapshotImage`, `sourceType`, `changeSummary`. Workbench autosaves current viewport images separately; Agents may omit `snapshotImage` when they only have JSON.
+
+### `canvas_patch_records`
+
+Patch the current tldraw snapshot. Required input: `documentId`. Optional inputs: `putRecords`, `removeRecordIds`, `viewStatePatch`, `selectionSummary`, `changeSummary`.
+
+### `canvas_insert_image`
+
+Insert a bitmap into a canvas. Required image input: `dataUrl` or `base64`. Optional positioning inputs: `documentId`, `pageId`, `anchorShapeId`, `placement`, `displayWidth`, `displayHeight`, `matchAnchor`, `shapeMeta`, `assetMeta`.
+
+### `canvas_search_documents`
+
+Find existing canvases by `status`, `kind`, `search`, `page`, and `pageSize`.
+
+### `canvas_get_document`
+
+Read compact canvas metadata, the latest autosaved working-copy scene by default, current version metadata, versions, optional logs, and compact scene summary. Set `includeSnapshot=true` only when a full snapshot is required. Use `versionId` or `versionNumber` to read a historical version.
+
+### `canvas_get_record`
+
+Fetch one exact tldraw record from the latest autosaved working copy by default, or from a requested `versionId` / `versionNumber`. Use this before targeted selected-shape or asset edits.
+
+### `canvas_update_document_status`
+
+Update status to `draft`, `reviewed`, or `archived`. Mark reviewed only after user or workflow confirmation.
+
+### `canvas_report_failure`
+
+Record a failed generation, validation, import, inspection, image insertion, or patch attempt.