@xpert-ai/plugin-excalidraw 0.1.0

package/dist/lib/remote-components/excalidraw-workbench/src/styles.ts

@@ -0,0 +1,323 @@
+export function injectStyles() {
+  if (document.getElementById('excalidraw-workbench-styles')) {
+    return
+  }
+  const style = document.createElement('style')
+  style.id = 'excalidraw-workbench-styles'
+  style.textContent = `
+    html, body, #root {
+      width: 100%;
+      height: 100%;
+      min-height: 100%;
+      margin: 0;
+      overflow: hidden;
+      background: var(--xps-background);
+      color: var(--xps-foreground);
+      font-family: var(--xps-font-sans);
+    }
+    * {
+      box-sizing: border-box;
+    }
+    button, input, select, textarea {
+      font: inherit;
+    }
+    .exw-shell {
+      --exw-rail-width: var(--xps-sidebar-rail-width, 44px);
+      --exw-panel-header-height: 2.5rem;
+      --exw-left-width: minmax(var(--exw-rail-width), clamp(240px, 20vw, 300px));
+      --exw-right-width: var(--exw-rail-width);
+      --exw-right-panel-width: min(320px, calc(100vw - var(--exw-rail-width) - 96px));
+      width: 100%;
+      height: 100vh;
+      min-height: 720px;
+      display: grid;
+      grid-template-columns: var(--exw-left-width) minmax(0, 1fr) var(--exw-right-width);
+      background: var(--xps-background);
+      overflow: hidden;
+      transition: grid-template-columns 160ms ease;
+    }
+    .exw-shell.left-collapsed {
+      --exw-left-width: var(--exw-rail-width);
+    }
+    .exw-shell.right-collapsed {
+      --exw-right-width: var(--exw-rail-width);
+    }
+    .exw-shell.left-collapsed.right-collapsed {
+      --exw-left-width: var(--exw-rail-width);
+      --exw-right-width: var(--exw-rail-width);
+    }
+    .exw-sidebar, .exw-inspector {
+      min-width: 0;
+      height: 100vh;
+      min-height: 720px;
+    }
+    .exw-inspector.xps-sidebar {
+      position: relative;
+      z-index: 30;
+      overflow: visible;
+    }
+    .exw-inspector[aria-expanded="true"] {
+      background: color-mix(in srgb, var(--xps-card) 94%, var(--xps-muted) 6%);
+    }
+    .exw-inspector[aria-expanded="true"] > .xps-sidebar-header,
+    .exw-inspector[aria-expanded="true"] > .xps-sidebar-content {
+      position: absolute;
+      right: 0;
+      width: var(--exw-right-panel-width);
+      max-width: calc(100vw - 16px);
+      z-index: 31;
+      background: var(--xps-card);
+      border-left: 1px solid var(--xps-border);
+      border-right: 1px solid var(--xps-border);
+      box-shadow: -12px 0 28px color-mix(in srgb, var(--xps-foreground) 14%, transparent);
+    }
+    .exw-inspector[aria-expanded="true"] > .xps-sidebar-header {
+      top: 0;
+      min-height: var(--exw-panel-header-height);
+      border-bottom: 1px solid var(--xps-border);
+    }
+    .exw-inspector[aria-expanded="true"] > .xps-sidebar-content {
+      top: var(--exw-panel-header-height);
+      bottom: 0;
+      min-height: 0;
+      overflow: hidden;
+    }
+    .exw-sidebar-title-truncate {
+      flex: 1 1 auto;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    .exw-sidebar-trigger-right {
+      margin-left: auto;
+    }
+    .exw-inspector-actions {
+      min-width: 0;
+      flex: 0 0 auto;
+      display: flex;
+      align-items: center;
+      gap: 6px;
+    }
+    .exw-inspector-actions .xps-button,
+    .exw-inspector-actions .xps-badge {
+      flex: 0 0 auto;
+      white-space: nowrap;
+    }
+    .exw-sidebar-controls {
+      padding: 8px;
+      display: flex;
+      flex-direction: column;
+      gap: 8px;
+      border-bottom: 1px solid var(--xps-border);
+    }
+    .exw-main {
+      min-width: 0;
+      height: 100vh;
+      min-height: 720px;
+      display: grid;
+      grid-template-rows: auto minmax(0, 1fr);
+      background: var(--xps-background);
+    }
+    .exw-toolbar {
+      display: grid;
+      grid-template-columns: minmax(150px, 220px) minmax(0, 1fr);
+      align-items: center;
+      gap: 8px 10px;
+      min-height: 48px;
+      padding: 8px 12px;
+      background: var(--xps-card);
+      border-bottom: 1px solid var(--xps-border);
+      min-width: 0;
+      overflow: visible;
+    }
+    .exw-toolbar-title {
+      min-width: 0;
+    }
+    .exw-toolbar-actions {
+      min-width: 0;
+      display: flex;
+      flex-wrap: wrap;
+      align-items: center;
+      gap: 8px;
+    }
+    .exw-toolbar-actions .xps-button,
+    .exw-toolbar-actions .xps-badge {
+      flex: 0 0 auto;
+    }
+    .exw-title-input {
+      width: 100%;
+    }
+    .exw-button-icon {
+      width: 1rem;
+      height: 1rem;
+      flex: 0 0 auto;
+      stroke-width: 2;
+    }
+    .exw-canvas {
+      min-height: 0;
+      height: 100%;
+      background: var(--xps-background);
+      position: relative;
+      overflow: hidden;
+    }
+    .exw-canvas .excalidraw {
+      --color-primary: var(--xps-primary);
+    }
+    .exw-list {
+      flex: 1 1 auto;
+      min-height: 0;
+      padding: 6px;
+    }
+    .exw-item-title {
+      display: block;
+      width: 100%;
+      color: var(--xps-foreground);
+      font-weight: 650;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    .exw-item-meta, .exw-muted {
+      color: var(--xps-muted-foreground);
+      font-size: 12px;
+      min-width: 0;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    .exw-status {
+      margin-left: auto;
+      flex: 0 0 auto;
+    }
+    .exw-inspector-scroll {
+      min-height: 0;
+      height: 100%;
+      flex: 1 1 auto;
+    }
+    .exw-inspector-stack {
+      padding: 10px;
+      padding-right: 12px;
+      display: flex;
+      flex-direction: column;
+      gap: 10px;
+      min-width: 0;
+      max-width: 100%;
+    }
+    .exw-section {
+      display: flex;
+      flex-direction: column;
+      gap: 8px;
+      min-width: 0;
+      max-width: 100%;
+    }
+    .exw-section-title {
+      font-size: 13px;
+      font-weight: 700;
+      color: var(--xps-foreground);
+    }
+    .exw-inline-actions {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+    }
+    .exw-version {
+      border: 1px solid var(--xps-border);
+      border-radius: var(--xps-radius);
+      background: color-mix(in srgb, var(--xps-card) 94%, var(--xps-muted) 6%);
+      padding: 8px;
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) var(--xps-control-height);
+      align-items: center;
+      gap: 8px;
+      width: 100%;
+      min-width: 0;
+      overflow: hidden;
+    }
+    .exw-version > div {
+      min-width: 0;
+      overflow: hidden;
+    }
+    .exw-version > div > div {
+      min-width: 0;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    .exw-version-action.xps-button {
+      width: var(--xps-control-height);
+      height: var(--xps-control-height);
+      padding: 0;
+      justify-self: end;
+    }
+    .exw-inspector .xps-input,
+    .exw-inspector .xps-textarea,
+    .exw-inspector .xps-scroll-area,
+    .exw-inspector .xps-scroll-area-viewport {
+      min-width: 0;
+      max-width: 100%;
+    }
+    .exw-inspector .xps-textarea {
+      overflow-x: hidden;
+      overflow-wrap: anywhere;
+      word-break: break-word;
+    }
+    .exw-inspector .exw-muted {
+      overflow: visible;
+      text-overflow: clip;
+      white-space: normal;
+      overflow-wrap: anywhere;
+    }
+    .exw-empty {
+      height: 100%;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      color: var(--xps-muted-foreground);
+    }
+    .exw-hidden-file {
+      display: none;
+    }
+    @media (max-width: 1040px) {
+      .exw-shell,
+      .exw-shell.left-collapsed,
+      .exw-shell.right-collapsed,
+      .exw-shell.left-collapsed.right-collapsed {
+        --exw-left-width: var(--exw-rail-width);
+        --exw-right-width: var(--exw-rail-width);
+        --exw-right-panel-width: min(300px, calc(100vw - var(--exw-rail-width) - 32px));
+        grid-template-columns: var(--exw-left-width) minmax(0, 1fr) var(--exw-right-width);
+      }
+      .exw-sidebar:not([aria-expanded="false"]),
+      .exw-inspector:not([aria-expanded="false"]) {
+        width: var(--exw-rail-width);
+      }
+      .exw-sidebar .xps-sidebar-content,
+      .exw-inspector-scroll {
+        display: none;
+      }
+      .exw-inspector[aria-expanded="true"] .exw-inspector-scroll {
+        display: block;
+      }
+      .exw-sidebar .xps-sidebar-header .xps-sidebar-title,
+      .exw-sidebar .xps-sidebar-header .xps-badge,
+      .exw-sidebar .xps-sidebar-header .xps-button:not(.xps-sidebar-trigger),
+      .exw-inspector[aria-expanded="false"] .xps-sidebar-header .xps-sidebar-title,
+      .exw-inspector[aria-expanded="false"] .xps-sidebar-header .xps-badge,
+      .exw-inspector[aria-expanded="false"] .xps-sidebar-header .xps-button:not(.xps-sidebar-trigger) {
+        display: none;
+      }
+      .xps-sidebar-rail {
+        display: flex;
+      }
+    }
+    @media (max-width: 920px) {
+      .exw-toolbar {
+        grid-template-columns: minmax(0, 1fr);
+      }
+      .exw-status {
+        margin-left: 0;
+      }
+    }
+  `
+  document.head.appendChild(style)
+}

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

@@ -0,0 +1,4 @@
+export declare const React: any;
+export declare const ReactDOM: any;
+export declare const h: any;
+//# sourceMappingURL=vendor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.d.ts","sourceRoot":"","sources":["../../../../../src/lib/remote-components/excalidraw-workbench/src/vendor.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,KAAwB,CAAA;AAC1C,eAAO,MAAM,QAAQ,KAA2B,CAAA;AAChD,eAAO,MAAM,CAAC,KAAsB,CAAA"}

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

@@ -0,0 +1,4 @@
+export const React = window.React;
+export const ReactDOM = window.ReactDOM;
+export const h = React.createElement;
+//# sourceMappingURL=vendor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.js","sourceRoot":"","sources":["../../../../../src/lib/remote-components/excalidraw-workbench/src/vendor.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAI,MAAc,CAAC,KAAK,CAAA;AAC1C,MAAM,CAAC,MAAM,QAAQ,GAAI,MAAc,CAAC,QAAQ,CAAA;AAChD,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAA"}

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

@@ -0,0 +1,3 @@
+export const React = (window as any).React
+export const ReactDOM = (window as any).ReactDOM
+export const h = React.createElement

package/dist/lib/types.d.ts

@@ -0,0 +1,74 @@
+export type ExcalidrawDrawingStatus = 'draft' | 'reviewed' | 'archived';
+export type ExcalidrawDrawingKind = 'diagram' | 'whiteboard' | 'flowchart' | 'architecture' | 'wireframe' | 'other';
+export type ExcalidrawVersionSource = 'agent_json' | 'agent_patch' | 'agent_mermaid' | 'workbench' | 'workbench_mermaid' | 'import' | 'restore';
+export type ExcalidrawActorType = 'agent' | 'user' | 'system';
+export type ExcalidrawActionType = 'drawing_created' | 'version_saved' | 'scene_patched' | 'mermaid_draft_saved' | 'status_updated' | 'version_restored' | 'drawing_archived' | 'failure_reported';
+export interface ExcalidrawScope {
+    tenantId: string;
+    organizationId?: string | null;
+    workspaceId?: string | null;
+    projectId?: string | null;
+    userId?: string | null;
+    assistantId?: string | null;
+    conversationId?: string | null;
+}
+export interface ExcalidrawSceneInput {
+    elements?: unknown[];
+    appState?: Record<string, unknown> | null;
+    files?: Record<string, unknown> | null;
+    mermaidSource?: string | null;
+}
+export interface CreateExcalidrawDrawingInput extends ExcalidrawSceneInput {
+    title: string;
+    description?: string;
+    kind?: ExcalidrawDrawingKind;
+    tags?: string[];
+    source?: string;
+    changeSummary?: string;
+}
+export interface SaveExcalidrawSceneVersionInput extends ExcalidrawSceneInput {
+    drawingId: string;
+    sourceType?: ExcalidrawVersionSource;
+    changeSummary?: string;
+}
+export interface PatchExcalidrawSceneInput {
+    drawingId: string;
+    addElements?: unknown[];
+    updateElements?: Array<Record<string, unknown> & {
+        id: string;
+    }>;
+    deleteElementIds?: string[];
+    appStatePatch?: Record<string, unknown>;
+    files?: Record<string, unknown> | null;
+    mermaidSource?: string | null;
+    changeSummary?: string;
+}
+export interface SaveExcalidrawMermaidDraftInput {
+    drawingId?: string;
+    title?: string;
+    description?: string;
+    kind?: ExcalidrawDrawingKind;
+    mermaidSource: string;
+    changeSummary?: string;
+}
+export interface SearchExcalidrawDrawingsInput {
+    status?: ExcalidrawDrawingStatus;
+    kind?: ExcalidrawDrawingKind;
+    search?: string;
+    page?: number;
+    pageSize?: number;
+}
+export interface UpdateExcalidrawDrawingStatusInput {
+    drawingId: string;
+    status: ExcalidrawDrawingStatus;
+    reason?: string;
+}
+export interface ReportExcalidrawFailureInput {
+    drawingId?: string;
+    versionId?: string;
+    operation: string;
+    errorMessage: string;
+    recoverable?: boolean;
+    evidence?: unknown;
+}
+//# 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 {};
+//# 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":""}

package/dist/xpert-excalidraw-assistant.yaml

@@ -0,0 +1,129 @@
+team:
+  name: excalidraw-assistant
+  type: agent
+  title: Excalidraw 绘图助手
+  description: 面向流程图、架构图、线框图和自由白板的 Agentic Drawing 助手
+  avatar:
+    emoji:
+      id: art
+    background: rgb(219, 234, 254)
+  options:
+    templateKey: excalidraw-assistant
+    dataXpert:
+      managedBy: data-xpert
+      templateKey: excalidraw-assistant
+      assistantKind: business-assistant
+      businessDomain: excalidraw
+      requiredPlugin: '@xpert-ai/plugin-excalidraw'
+      requiredPlugins:
+        - '@xpert-ai/plugin-excalidraw'
+      requiredCapabilities:
+        - excalidraw
+        - diagram-workbench
+        - agent-drawing
+  agentConfig:
+    stateVariables:
+      - name: currentDrawingId
+        type: string
+        default: ""
+        description: Current Excalidraw drawing id selected in the workbench
+        operation: null
+      - name: currentVersionId
+        type: string
+        default: ""
+        description: Current Excalidraw version id selected in the workbench
+        operation: null
+    recursionLimit: 10000
+  features:
+    sandbox:
+      enabled: true
+      provider: docker-sandbox
+  version: "1"
+  agent:
+    key: Agent_Excalidraw
+  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_Excalidraw
+    position:
+      x: 860
+      y: 20
+    entity:
+      key: Agent_Excalidraw
+      name: excalidraw-assistant
+      title: Excalidraw 绘图助手
+      description: 面向流程图、架构图、线框图和自由白板的 Agentic Drawing 助手
+      avatar:
+        emoji:
+          id: art
+        background: rgb(219, 234, 254)
+      prompt: >
+        You are Excalidraw Drawing Assistant, a data-xpert business assistant for
+        creating and managing reviewable Excalidraw drawings.
+
+        Use Excalidraw middleware tools as the system of record. Do not claim that a
+        drawing was saved unless a tool call succeeded. Keep every drawing reviewable,
+        editable, and versioned.
+
+        Drawing workflow:
+        1. Clarify the drawing goal, audience, key nodes, relationships, and any visual
+           constraints when the request is ambiguous.
+        2. Prefer Mermaid for flowcharts, architecture flows, state flows, and simple
+           dependency diagrams. Save Mermaid with excalidraw_save_mermaid_draft so the
+           workbench can auto-preview it as an Excalidraw scene for user review.
+        3. Use direct Excalidraw JSON elements when the user needs precise layout,
+           annotations, freeform whiteboarding, wireframes, or a targeted edit.
+        4. When updating an existing drawing, call excalidraw_get_drawing first, preserve
+           existing user edits, then call excalidraw_patch_scene for small changes or
+           excalidraw_save_scene_version for a full replacement.
+        5. Use clear titles, short change summaries, and tags when useful.
+        6. If source material cannot be converted or the request conflicts with the
+           current drawing, call excalidraw_report_failure and explain the smallest
+           useful next step.
+
+        Mermaid rules:
+        - Flowcharts convert to editable Excalidraw elements best.
+        - For Mermaid diagram types that may convert as an image, warn the user that
+          manual editing may be limited after conversion.
+        - Keep Mermaid source concise, syntactically valid, and readable.
+
+        Excalidraw JSON rules:
+        - Elements must be serializable JSON and include stable ids.
+        - Use simple shapes, text labels, arrows, and grouping by visual proximity.
+        - Avoid overwriting files or appState unless required.
+        - Report uncertainty in the response instead of inventing missing domain facts.
+
+        Prefer concise Chinese responses for end users unless they ask otherwise.
+      collaboratorNames: []
+      toolsetIds: []
+      knowledgebaseIds: []
+    hash: excalidraw-agent-v1
+  - type: workflow
+    key: Middleware_Excalidraw
+    position:
+      x: 1160
+      y: 332
+    entity:
+      type: middleware
+      key: Middleware_Excalidraw
+      title: Excalidraw Agent Tools
+      provider: ExcalidrawMiddleware
+      required: true
+    hash: excalidraw-middleware-v1
+connections:
+  - type: workflow
+    key: Agent_Excalidraw/Middleware_Excalidraw
+    from: Agent_Excalidraw
+    to: Middleware_Excalidraw

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@xpert-ai/plugin-excalidraw",
+  "version": "0.1.0",
+  "description": "Excalidraw app plugin for agent-created diagrams, reviewable drawing versions, Mermaid drafts, 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/excalidraw"
+  },
+  "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": {
+    "@excalidraw/excalidraw": "0.18.1",
+    "@excalidraw/mermaid-to-excalidraw": "2.2.2",
+    "tslib": "^2.3.0",
+    "@xpert-ai/plugin-shadcn-ui": "0.1.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",
+    "@xpert-ai/contracts": "3.10.1",
+    "@xpert-ai/plugin-sdk": "^3.10.1",
+    "esbuild": "^0.27.0",
+    "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"
+  },
+  "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": "tsc -p tsconfig.spec.json --noEmit && node scripts/build-remote-components.mjs --check",
+    "typecheck": "tsc -p tsconfig.spec.json --noEmit && node scripts/build-remote-components.mjs --check"
+  }
+}