@xpert-ai/plugin-canvas 0.1.0

package/.xpertai-plugin/plugin.json

@@ -0,0 +1,121 @@
+{
+  "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": "XpertAI",
+  "homepage": "https://github.com/xpert-ai/xpert-plugins/tree/main/xpertai/apps/canvas",
+  "repository": "https://github.com/xpert-ai/xpert-plugins/tree/main/xpertai/apps/canvas",
+  "license": "AGPL-3.0",
+  "keywords": [
+    "canvas",
+    "tldraw",
+    "whiteboard",
+    "image-generation",
+    "annotation",
+    "agent-canvas",
+    "workbench"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Canvas",
+    "shortDescription": "Agent-managed tldraw canvases",
+    "longDescription": "Create, update, version, review, annotate, insert images, import, and export Agent-managed tldraw infinite canvases. The plugin includes an installable Xpert skill, Assistant template, middleware tools, and a Canvas Workbench for human review.",
+    "developerName": "XpertAI",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://xpertai.cn",
+    "privacyPolicyURL": "https://xpertai.cn",
+    "termsOfServiceURL": "https://xpertai.cn",
+    "defaultPrompt": [
+      "Open a new visual canvas for planning this project.",
+      "Create AI image slots on a canvas for these product concepts.",
+      "Insert this generated image into the selected Canvas image holder."
+    ],
+    "composerIcon": "./assets/composerIcon.svg",
+    "logo": "./assets/logo.svg",
+    "brandColor": "#0F766E",
+    "screenshots": []
+  },
+  "policy": {
+    "installation": "AVAILABLE",
+    "authentication": "ON_FIRST_USE",
+    "pluginSharing": true
+  },
+  "source": {
+    "source": "local",
+    "path": ".",
+    "url": "https://github.com/xpert-ai/xpert-plugins",
+    "sparsePath": "xpertai/apps/canvas"
+  },
+  "assets": {
+    "composerIcon": "./assets/composerIcon.svg",
+    "logo": "./assets/logo.svg",
+    "screenshots": []
+  },
+  "targetApps": [
+    "data-xpert",
+    "xpert"
+  ],
+  "targetAppMeta": {
+    "xpert": {
+      "types": [
+        "assistant-template",
+        "skill",
+        "app",
+        "xpertai-bundle"
+      ],
+      "capabilities": [
+        "canvas",
+        "canvas-workbench",
+        "agent-canvas",
+        "canvas-assistant-template"
+      ],
+      "marketplace": {
+        "contents": [
+          {
+            "type": "skill",
+            "name": "canvas-agent-skill",
+            "displayName": "Canvas Agent Skill",
+            "description": "Skill for using Canvas middleware tools, Workbench selection context, tldraw snapshot inspection, record patching, image insertion, versioning, and recovery.",
+            "tags": [
+              "skill",
+              "canvas",
+              "tldraw",
+              "agent-canvas",
+              "middleware-tools"
+            ]
+          },
+          {
+            "type": "assistant-template",
+            "name": "canvas-assistant",
+            "displayName": "Canvas Assistant",
+            "description": "Assistant template for Canvas visual workflows."
+          },
+          {
+            "type": "app",
+            "name": "canvas",
+            "displayName": "Canvas",
+            "description": "Workbench and Agent middleware tools for tldraw canvases."
+          }
+        ]
+      }
+    },
+    "data-xpert": {
+      "types": [
+        "workbench-view",
+        "assistant-tool",
+        "business-app"
+      ],
+      "capabilities": [
+        "canvas",
+        "canvas-workbench",
+        "agent-canvas",
+        "canvas-assistant-template"
+      ]
+    }
+  }
+}

package/README.md

@@ -0,0 +1,14 @@
+# Canvas Plugin
+
+Agentic Canvas plugin for Xpert and data-xpert. It provides Agent middleware tools, a tldraw-powered Canvas Workbench, Assistant templates, and an installable Xpert skill for creating, versioning, reviewing, annotating, and inserting images on infinite canvases.
+
+The Workbench autosaves the current tldraw working copy and writes a viewport snapshot image to the Xpert workspace at `files/canvas/documents/{documentId}/snapshots/current.png`. Explicit versions keep their own image file under `files/canvas/documents/{documentId}/snapshots/versions/`. Canvas Assistant templates include `@xpert-ai/plugin-view-image` so Agents can call `view_image` against the latest snapshot path before reasoning about visual layout or annotations.
+
+Installable skills live under `skills/` and are advertised through `.xpertai-plugin/plugin.json`.
+
+## Verify
+
+```bash
+pnpm test
+pnpm build
+```

package/assets/composerIcon.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64" fill="none">
+  <rect width="64" height="64" rx="16" fill="#F8FAFC"/>
+  <rect x="14" y="14" width="36" height="36" rx="7" fill="#FFFFFF" stroke="#0F766E" stroke-width="4"/>
+  <path d="M22 25H35" stroke="#0F172A" stroke-width="4" stroke-linecap="round"/>
+  <path d="M22 33H30" stroke="#64748B" stroke-width="3" stroke-linecap="round"/>
+  <path d="M22 43C30 35 39 34 48 40" stroke="#0F766E" stroke-width="4" stroke-linecap="round"/>
+  <path d="M39 22L47 30L39 38" stroke="#2563EB" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/assets/logo.svg

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 19.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 64 64" style="enable-background:new 0 0 64 64;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#4F5D73;}
+	.st1{opacity:0.2;}
+	.st2{fill:#231F20;}
+	.st3{fill:#F5CF87;stroke:#E0995E;stroke-width:3;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;}
+	.st4{fill:none;stroke:#E0995E;stroke-width:3;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;}
+	.st5{opacity:0.2;fill:#231F20;}
+	.st6{fill:#FFFFFF;}
+	.st7{fill:none;stroke:#F5CF87;stroke-width:3;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;}
+	.st8{fill:none;stroke:#C75C5C;stroke-width:3;stroke-linecap:round;stroke-miterlimit:10;}
+</style>
+<circle class="st0" cx="32" cy="32" r="32"/>
+<g class="st1">
+	<line class="st2" x1="28" y1="14" x2="19" y2="54"/>
+	<path class="st2" d="M19,55.5c-0.1,0-0.2,0-0.3,0c-0.8-0.2-1.3-1-1.1-1.8l9-40c0.2-0.8,1-1.3,1.8-1.1c0.8,0.2,1.3,1,1.1,1.8l-9,40
+		C20.3,55,19.7,55.5,19,55.5z"/>
+</g>
+<g class="st1">
+	<line class="st2" x1="37" y1="14" x2="45" y2="54"/>
+	<path class="st2" d="M45,55.5c-0.7,0-1.3-0.5-1.5-1.2l-8-40c-0.2-0.8,0.4-1.6,1.2-1.8c0.8-0.2,1.6,0.4,1.8,1.2l8,40
+		c0.2,0.8-0.4,1.6-1.2,1.8C45.2,55.5,45.1,55.5,45,55.5z"/>
+</g>
+<g class="st1">
+	<path class="st2" d="M32,55.5c-0.8,0-1.5-0.7-1.5-1.5V37.4c0-0.8,0.7-1.5,1.5-1.5c0.8,0,1.5,0.7,1.5,1.5V54
+		C33.5,54.8,32.8,55.5,32,55.5z"/>
+</g>
+<line class="st3" x1="28" y1="12" x2="19" y2="52"/>
+<line class="st3" x1="37" y1="12" x2="45" y2="52"/>
+<line class="st4" x1="32" y1="35.4" x2="32" y2="52"/>
+<path class="st5" d="M49,40.2c0,1-1,1.8-2.1,1.8H17.1C16,42,15,41.2,15,40.2V21.8c0-1,1-1.8,2.1-1.8h29.8c1.2,0,2.1,0.8,2.1,1.8
+	V40.2z"/>
+<path class="st6" d="M49,38.2c0,1-1,1.8-2.1,1.8H17.1C16,40,15,39.2,15,38.2V19.8c0-1,1-1.8,2.1-1.8h29.8c1.2,0,2.1,0.8,2.1,1.8
+	V38.2z"/>
+<g class="st1">
+	<path class="st2" d="M41,21.5H23c-0.8,0-1.5-0.7-1.5-1.5s0.7-1.5,1.5-1.5h18c0.8,0,1.5,0.7,1.5,1.5S41.8,21.5,41,21.5z"/>
+</g>
+<g class="st1">
+	<path class="st2" d="M41,43.5H23c-0.8,0-1.5-0.7-1.5-1.5s0.7-1.5,1.5-1.5h18c0.8,0,1.5,0.7,1.5,1.5S41.8,43.5,41,43.5z"/>
+</g>
+<line class="st7" x1="23" y1="18.5" x2="41" y2="18.5"/>
+<line class="st7" x1="23" y1="40.5" x2="41" y2="40.5"/>
+<path class="st8" d="M19.5,36c0,0,11-18,11-10s0,10,2,8s7-8,12-9"/>
+</svg>

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { XpertPlugin } from '@xpert-ai/plugin-sdk';
+declare const ConfigSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+declare const plugin: XpertPlugin<z.infer<typeof ConfigSchema>>;
+export default plugin;
+export * from './lib/constants.js';
+export * from './lib/types.js';
+export * from './lib/entities/index.js';
+export * from './lib/canvas.plugin.js';
+export * from './lib/canvas.service.js';
+export * from './lib/canvas.middleware.js';
+export * from './lib/canvas-view.provider.js';
+export * from './lib/canvas.templates.js';
+export * from './lib/canvas-snapshot.validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAuBvD,QAAA,MAAM,YAAY,gDAAe,CAAA;AAEjC,QAAA,MAAM,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CA4HrD,CAAA;AAED,eAAe,MAAM,CAAA;AACrB,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,qCAAqC,CAAA"}

package/dist/index.js

@@ -0,0 +1,144 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+import { CANVAS_AGENT_CAPABILITY, CANVAS_FEATURE, CANVAS_ICON, CANVAS_MIDDLEWARE_NAME, CANVAS_PROVIDER_KEY, CANVAS_TEMPLATE_CAPABILITY, CANVAS_TEMPLATE_PROVIDER_KEY, CANVAS_WORKBENCH_CAPABILITY, CANVAS_WORKBENCH_VIEW_KEY } from './lib/constants.js';
+import { CanvasPlugin } from './lib/canvas.plugin.js';
+import { canvasTemplates } from './lib/canvas.templates.js';
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(readFileSync(join(moduleDir, '../package.json'), 'utf8'));
+const ConfigSchema = z.object({});
+const plugin = {
+    meta: {
+        name: packageJson.name,
+        version: packageJson.version,
+        level: 'system',
+        targetApps: ['data-xpert', 'xpert'],
+        targetAppMeta: {
+            'data-xpert': {
+                types: ['workbench-view', 'assistant-tool', 'business-app'],
+                capabilities: [CANVAS_FEATURE, CANVAS_WORKBENCH_CAPABILITY, CANVAS_AGENT_CAPABILITY, CANVAS_TEMPLATE_CAPABILITY],
+                marketplace: {
+                    contents: [
+                        {
+                            type: 'app',
+                            name: 'canvas',
+                            displayName: 'Canvas',
+                            description: 'Create, annotate, insert images, review, import, export, and version Agent-managed tldraw canvases.',
+                            icon: {
+                                type: 'svg',
+                                value: CANVAS_ICON,
+                                color: '#0f766e'
+                            },
+                            operations: [
+                                {
+                                    name: 'create-canvas-documents',
+                                    displayName: 'Create Canvas documents',
+                                    description: 'Create reviewable infinite canvases and visual planning boards.',
+                                    access: 'write'
+                                },
+                                {
+                                    name: 'save-canvas-versions',
+                                    displayName: 'Save Canvas versions',
+                                    description: 'Persist tldraw snapshots, record patches, image insertions, and Workbench edits.',
+                                    access: 'write'
+                                },
+                                {
+                                    name: 'review-canvas-workbench',
+                                    displayName: 'Review Canvas Workbench',
+                                    description: 'Open the Canvas Workbench to inspect, annotate, import, export, and manually edit canvases.',
+                                    access: 'read'
+                                }
+                            ]
+                        },
+                        {
+                            type: 'view',
+                            name: CANVAS_WORKBENCH_VIEW_KEY,
+                            displayName: 'Canvas Workbench',
+                            description: 'Workbench view for tldraw canvas editing, AI image holders, annotations, versions, and logs.'
+                        },
+                        {
+                            type: 'tool',
+                            name: CANVAS_MIDDLEWARE_NAME,
+                            displayName: 'Canvas Agent Tools',
+                            description: 'Assistant middleware tools for creating canvases, saving snapshots, patching records, inserting images, searching documents, and reporting failures.'
+                        },
+                        {
+                            type: 'assistant-template',
+                            name: 'canvas-assistant',
+                            displayName: 'Canvas Assistant Template',
+                            description: 'Prebuilt assistant template for Agent-managed canvas creation, image holder, and annotation workflows.'
+                        }
+                    ]
+                },
+                runtime: {
+                    middlewareProviders: [CANVAS_MIDDLEWARE_NAME],
+                    viewProviders: [CANVAS_PROVIDER_KEY],
+                    templateProviders: [CANVAS_TEMPLATE_PROVIDER_KEY]
+                }
+            },
+            xpert: {
+                types: ['assistant-template', 'skill', 'app', 'xpertai-bundle'],
+                capabilities: [CANVAS_FEATURE, CANVAS_WORKBENCH_CAPABILITY, CANVAS_AGENT_CAPABILITY, CANVAS_TEMPLATE_CAPABILITY],
+                marketplace: {
+                    contents: [
+                        {
+                            type: 'skill',
+                            name: 'canvas-agent-skill',
+                            displayName: 'Canvas Agent Skill',
+                            description: 'Skill for using Canvas middleware tools, Workbench selection context, tldraw snapshot inspection, record patching, image insertion, versioning, and recovery.',
+                            tags: ['skill', 'canvas', 'tldraw', 'agent-canvas', 'middleware-tools']
+                        },
+                        {
+                            type: 'assistant-template',
+                            name: 'canvas-assistant',
+                            displayName: 'Canvas Assistant',
+                            description: 'Assistant template for Canvas visual workflows.'
+                        },
+                        {
+                            type: 'app',
+                            name: 'canvas',
+                            displayName: 'Canvas',
+                            description: 'Workbench and Agent middleware tools for tldraw canvases.'
+                        }
+                    ]
+                }
+            }
+        },
+        category: 'middleware',
+        icon: {
+            type: 'svg',
+            value: CANVAS_ICON,
+            color: '#0f766e'
+        },
+        displayName: 'Canvas',
+        description: 'Agentic Canvas plugin for tldraw whiteboards, AI image holders, annotation workflows, versioning, and review.',
+        keywords: ['canvas', 'tldraw', 'whiteboard', 'image-generation', 'annotation', 'middleware', 'view-extension', 'assistant-template'],
+        author: 'XpertAI Team'
+    },
+    config: {
+        schema: ConfigSchema
+    },
+    templates: canvasTemplates,
+    register(ctx) {
+        ctx.logger.log('register canvas plugin');
+        return { module: CanvasPlugin, global: true };
+    },
+    async onStart(ctx) {
+        ctx.logger.log('canvas plugin started');
+    },
+    async onStop(ctx) {
+        ctx.logger.log('canvas plugin stopped');
+    }
+};
+export default plugin;
+export * from './lib/constants.js';
+export * from './lib/types.js';
+export * from './lib/entities/index.js';
+export * from './lib/canvas.plugin.js';
+export * from './lib/canvas.service.js';
+export * from './lib/canvas.middleware.js';
+export * from './lib/canvas-view.provider.js';
+export * from './lib/canvas.templates.js';
+export * from './lib/canvas-snapshot.validation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/canvas-agent-response.d.ts

@@ -0,0 +1,40 @@
+import type { CanvasJsonValue } from './types.js';
+type AgentToolResultValue = CanvasJsonValue | object | null | undefined;
+type AgentResultValue = AgentToolResultValue | Date | AgentResultValue[];
+export declare function stringifyAgentToolResult(value: AgentToolResultValue): string;
+export declare function summarizeDocumentMutationResult(result: object, message: string): {
+    success: boolean;
+    message: string;
+    documentId: AgentResultValue;
+    title: AgentResultValue;
+    status: AgentResultValue;
+    currentVersionId: AgentResultValue;
+    currentVersionNumber: AgentResultValue;
+    sceneSource: AgentResultValue;
+    snapshotImagePath: AgentResultValue;
+    snapshotImageUpdatedAt: AgentResultValue;
+    snapshotSummary: AgentResultValue;
+    next: string;
+};
+export declare function summarizeSearchResult(result: object): {
+    items: {
+        id: AgentResultValue;
+        title: AgentResultValue;
+        kind: AgentResultValue;
+        status: AgentResultValue;
+        currentVersionId: AgentResultValue;
+        currentVersionNumber: AgentResultValue;
+        snapshotImagePath: AgentResultValue;
+        updatedAt: AgentResultValue;
+    }[];
+    total: number;
+    page: number;
+    pageSize: number;
+    search: string;
+};
+export declare function summarizeFailureResult(result: object): {
+    success: boolean;
+    message: string;
+};
+export {};
+//# sourceMappingURL=canvas-agent-response.d.ts.map

package/dist/lib/canvas-agent-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-agent-response.d.ts","sourceRoot":"","sources":["../../src/lib/canvas-agent-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,KAAK,oBAAoB,GAAG,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AACvE,KAAK,gBAAgB,GAAG,oBAAoB,GAAG,IAAI,GAAG,gBAAgB,EAAE,CAAA;AAKxE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,UAEnE;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;;;;;;;EAmB9E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;EAmBnD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM;;;EAMpD"}

package/dist/lib/canvas-agent-response.js

@@ -0,0 +1,54 @@
+export function stringifyAgentToolResult(value) {
+    return JSON.stringify(value, null, 2);
+}
+export function summarizeDocumentMutationResult(result, message) {
+    const resultObject = asObject(result) ?? {};
+    const resultDocument = asObject(resultObject.document) ?? {};
+    const document = asObject(resultDocument.item) ?? (Object.keys(resultDocument).length ? resultDocument : null) ?? asObject(resultObject.item);
+    const version = asObject(resultObject.version) || asObject(resultDocument.currentVersion);
+    return {
+        success: typeof resultObject.success === 'boolean' ? resultObject.success : true,
+        message: typeof resultObject.message === 'string' ? resultObject.message : message,
+        documentId: document?.id,
+        title: document?.title,
+        status: document?.status,
+        currentVersionId: document?.currentVersionId ?? version?.id,
+        currentVersionNumber: document?.currentVersionNumber ?? version?.versionNumber,
+        sceneSource: resultDocument.sceneSource,
+        snapshotImagePath: resultDocument.snapshotImagePath ?? document?.snapshotImagePath ?? version?.snapshotImagePath,
+        snapshotImageUpdatedAt: resultDocument.snapshotImageUpdatedAt,
+        snapshotSummary: resultDocument.snapshotSummary ?? version?.snapshotSummary,
+        next: 'Open the Canvas Workbench to review, edit, annotate, or export the canvas.'
+    };
+}
+export function summarizeSearchResult(result) {
+    const resultObject = asObject(result) ?? {};
+    const items = Array.isArray(resultObject.items) ? resultObject.items.map(asObject).filter((item) => Boolean(item)) : [];
+    return {
+        items: items.map((item) => ({
+            id: item.id,
+            title: item.title,
+            kind: item.kind,
+            status: item.status,
+            currentVersionId: item.currentVersionId,
+            currentVersionNumber: item.currentVersionNumber,
+            snapshotImagePath: item.snapshotImagePath,
+            updatedAt: item.updatedAt
+        })),
+        total: typeof resultObject.total === 'number' ? resultObject.total : 0,
+        page: typeof resultObject.page === 'number' ? resultObject.page : 1,
+        pageSize: typeof resultObject.pageSize === 'number' ? resultObject.pageSize : 20,
+        search: typeof resultObject.search === 'string' ? resultObject.search : ''
+    };
+}
+export function summarizeFailureResult(result) {
+    const resultObject = asObject(result) ?? {};
+    return {
+        success: Boolean(resultObject.success),
+        message: typeof resultObject.message === 'string' ? resultObject.message : 'Canvas failure was recorded.'
+    };
+}
+function asObject(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+//# sourceMappingURL=canvas-agent-response.js.map

package/dist/lib/canvas-agent-response.js.map

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

package/dist/lib/canvas-snapshot.validation.d.ts

@@ -0,0 +1,52 @@
+import type { CanvasJsonObject, CanvasJsonValue, CanvasSnapshotData } from './types.js';
+export declare class CanvasSnapshotValidationError extends Error {
+    readonly issues: CanvasSnapshotIssue[];
+    constructor(issues: CanvasSnapshotIssue[]);
+}
+export interface CanvasSnapshotIssue {
+    id: string;
+    typeName: string;
+    type: string | null;
+    reason: string;
+}
+export type NormalizedCanvasSnapshot = CanvasSnapshotData;
+type CanvasSnapshotCandidate = CanvasJsonValue | object | null | undefined;
+export declare function isCanvasSnapshot(value: CanvasSnapshotCandidate): value is CanvasSnapshotData;
+export declare function createEmptyCanvasSnapshot(): NormalizedCanvasSnapshot;
+export declare function normalizeCanvasSnapshot(snapshot: CanvasSnapshotCandidate): NormalizedCanvasSnapshot;
+export declare function sanitizeCanvasSnapshot(snapshot: CanvasSnapshotCandidate): {
+    snapshot: NormalizedCanvasSnapshot | null;
+    skippedRecords: CanvasSnapshotIssue[];
+};
+export declare function summarizeSnapshot(snapshot: CanvasSnapshotCandidate): {
+    recordCount: number;
+    pageCount: number;
+    shapeCount: number;
+    assetCount: number;
+};
+export declare function compactSnapshotForAgent(snapshot: CanvasSnapshotCandidate): {
+    pages: {
+        id: string;
+        name: CanvasJsonValue;
+        index: string;
+    }[];
+    shapes: {
+        id: string;
+        typeName: string;
+        type: string;
+        parentId: string;
+        index: string;
+        x: number;
+        y: number;
+        rotation: number;
+        meta: CanvasJsonObject;
+        props: CanvasJsonObject;
+    }[];
+    recordCount: number;
+    pageCount: number;
+    shapeCount: number;
+    assetCount: number;
+};
+export declare function compactRecordForAgent(record: CanvasSnapshotCandidate): string | number | boolean | object;
+export {};
+//# sourceMappingURL=canvas-snapshot.validation.d.ts.map

package/dist/lib/canvas-snapshot.validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-snapshot.validation.d.ts","sourceRoot":"","sources":["../../src/lib/canvas-snapshot.validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAgB,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAErG,qBAAa,6BAA8B,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE;gBAA7B,MAAM,EAAE,mBAAmB,EAAE;CAInD;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAA;AAEzD,KAAK,uBAAuB,GAAG,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AAS1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,GAAG,KAAK,IAAI,kBAAkB,CAE5F;AAED,wBAAgB,yBAAyB,IAAI,wBAAwB,CAOpE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,wBAAwB,CAMnG;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,uBAAuB,GAAG;IAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAsD9J;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,uBAAuB;;;;;EAgBlE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,uBAAuB;;;;;;;;;;;;;;;;;;;;;;EAexE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,sCAsBpE"}