@xpert-ai/plugin-lucidchart 0.1.0

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@xpert-ai/plugin-lucidchart",
+  "version": "0.1.0",
+  "description": "Lucidchart app plugin for agent-created Standard Import drafts, Lucid document references, reviewable versions, and a 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/lucidchart"
+  },
+  "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": {
+    "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"
+  }
+}

package/skills/index/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: index
+description: "Use when an Agent needs to create, update, review, or manage Lucidchart drafts through the Xpert Lucidchart plugin, including Lucid Standard Import document.json, Mermaid drafts, external Lucid links, versioning, import/export, and failure reporting."
+---
+
+# Lucidchart Agent Drawing
+
+Use this skill when a user asks to create, edit, review, import, export, or manage a Lucidchart-oriented diagram draft in Xpert.
+
+## Plugin Purpose
+
+The Lucidchart plugin gives an Agent a reviewable draft loop without pretending to control Lucid's proprietary editor directly:
+
+- Save Lucid Standard Import `document.json` drafts.
+- Save Mermaid drafts while the structure is still being refined.
+- Register real Lucid document IDs, Lucid URLs, or Embed URLs when they exist.
+- Preserve versions, status, logs, and failure evidence for Workbench review.
+
+## Workflow
+
+1. Identify whether the user needs a Lucid-importable draft, a conceptual flow draft, or a reference to an existing Lucid document.
+2. Prefer Lucid Standard Import JSON when the structure is ready to become a Lucidchart document.
+3. Use Mermaid with `lucidchart_save_mermaid_draft` when the diagram is still being explored or when a flow is easier to communicate first.
+4. Use `lucidchart_register_external_document` only when a real Lucid document ID, document URL, or Embed URL is available.
+5. Before updating an existing plugin document, call `lucidchart_get_document` and preserve user-edited Standard Import content.
+6. If a requested diagram cannot be safely represented as Standard Import JSON, Mermaid, or a real Lucid reference, call `lucidchart_report_failure`.
+
+## Tool Selection
+
+- `lucidchart_create_document`: create a managed Lucidchart plugin document record.
+- `lucidchart_save_standard_import_version`: save complete Lucid Standard Import JSON as a version.
+- `lucidchart_patch_standard_import`: patch or replace current Standard Import JSON after reading it.
+- `lucidchart_save_mermaid_draft`: save Mermaid source for Workbench review.
+- `lucidchart_register_external_document`: register an actual Lucid document or embed link.
+- `lucidchart_search_documents`: find existing managed documents.
+- `lucidchart_get_document`: read current version, links, versions, and logs before edits.
+- `lucidchart_update_document_status`: mark draft, reviewed, or archived after user confirmation.
+- `lucidchart_report_failure`: record Standard Import, Mermaid, link, or import/export failures.
+
+## Lucid Boundary
+
+Do not claim that a real Lucidchart file exists unless a real Lucid document link or embed has been registered. Standard Import JSON is a draft artifact that can be imported into Lucid through an external Lucid import flow.
+
+## Response Style
+
+Keep responses concise. Tell the user whether you saved Standard Import JSON, Mermaid, or a Lucid link, and what they can review next in the Workbench.

package/skills/index/agents/xpertai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Lucidchart Agent Drawing"
+  short_description: "Create, update, version, and review Lucidchart drafts with Standard Import JSON, Mermaid, and Lucid links."
+  default_prompt: "Create a Lucidchart Standard Import architecture draft"
+policy:
+  allow_implicit_invocation: true