@clowder-ai/enterprise-workflow 0.0.0-stage → 0.1.0-alpha.4

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@clowder-ai/enterprise-workflow",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-alpha.4",
+  "description": "WeCom and Lark enterprise workflow tools for Clowder AI hosts",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./manifest": "./plugin.yaml"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "plugin.yaml",
+    "README.md",
+    "assets",
+    "skills",
+    "npm-shrinkwrap.json",
+    "README.en.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "pnpm clean && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit && tsc -p tsconfig.test.json",
+    "test": "node --import tsx --test src/**/*.test.ts",
+    "lint": "tsc -p tsconfig.build.json --noEmit && tsc -p tsconfig.test.json",
+    "clean": "rm -rf dist",
+    "prepack": "pnpm build"
+  },
+  "dependencies": {
+    "@clowder-ai/plugin-sdk": "0.2.0-beta.23",
+    "ajv": "8.20.0"
+  },
+  "devDependencies": {
+    "@clowder-ai/plugin-contract": "0.1.0-beta.37",
+    "@types/node": "^20.17.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "yaml": "2.9.0"
+  },
+  "keywords": [
+    "clowder-ai",
+    "enterprise",
+    "feishu",
+    "lark",
+    "plugin",
+    "wecom",
+    "workflow"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zts212653/clowder-ai-plugins.git",
+    "directory": "packages/enterprise-workflow"
+  }
+}

package/plugin.yaml

@@ -0,0 +1,220 @@
+pluginId: official.enterprise-workflow
+version: 0.1.0-alpha.4
+contractVersion: 0.1.0
+name: Enterprise Workflow
+description:
+  default: Create governed WeCom and Lark documents, tasks, tables, meetings, and workflows.
+  translations:
+    zh-CN: 通过受治理的企微与飞书工具创建文档、任务、表格、会议和工作流。
+icon:
+  type: svg
+  src: assets/icon.svg
+configuration:
+  - key: wecomCliPath
+    label: wecom-cli path
+    description: Executable name or absolute path for the locally installed wecom-cli.
+    kind: string
+    required: true
+    default: wecom-cli
+  - key: larkCliPath
+    label: lark-cli path
+    description: Executable name or absolute path for the locally installed lark-cli.
+    kind: string
+    required: true
+    default: lark-cli
+contributions:
+  - type: tool
+    id: wecom-actions
+    name: wecom_action
+    description: Create a governed WeCom document, smart table, todo, meeting, or complete workflow.
+    inputSchema:
+      type: object
+      oneOf:
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_doc }
+            docName: { type: string, minLength: 1, maxLength: 200 }
+            content: { type: string, maxLength: 500000 }
+          required: [action, docName]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_smart_table }
+            tableName: { type: string, minLength: 1, maxLength: 200 }
+            fields:
+              type: array
+              maxItems: 50
+              items:
+                type: object
+                additionalProperties: false
+                properties:
+                  fieldTitle: { type: string }
+                  fieldType: { type: string }
+                required: [fieldTitle, fieldType]
+            records:
+              type: array
+              maxItems: 200
+              items: { type: object }
+          required: [action, tableName, fields, records]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_todo }
+            content: { type: string, minLength: 1, maxLength: 2000 }
+            followerUserIds:
+              type: array
+              minItems: 1
+              maxItems: 50
+              items: { type: string }
+            remindTime: { type: string }
+          required: [action, content, followerUserIds]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_meeting }
+            title: { type: string, minLength: 1, maxLength: 200 }
+            startDatetime: { type: string, minLength: 1 }
+            durationSeconds: { type: integer, minimum: 300, maximum: 86400 }
+            inviteeUserIds:
+              type: array
+              minItems: 1
+              maxItems: 100
+              items: { type: string }
+          required: [action, title, startDatetime, durationSeconds, inviteeUserIds]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: golden_chain }
+            docName: { type: string, minLength: 1, maxLength: 200 }
+            docContent: { type: string, minLength: 1, maxLength: 500000 }
+            tableName: { type: string, minLength: 1, maxLength: 200 }
+            tasks:
+              type: array
+              minItems: 1
+              maxItems: 50
+              items:
+                type: object
+                additionalProperties: false
+                properties:
+                  content: { type: string, minLength: 1 }
+                  assigneeUserId: { type: string, minLength: 1 }
+                  remindTime: { type: string }
+                required: [content, assigneeUserId]
+            meetingTitle: { type: string, minLength: 1, maxLength: 200 }
+            meetingStart: { type: string, minLength: 1 }
+            meetingDurationSeconds: { type: integer, minimum: 300, maximum: 86400 }
+            meetingInviteeUserIds:
+              type: array
+              minItems: 1
+              maxItems: 100
+              items: { type: string }
+          required: [action, docName, docContent, tableName, tasks, meetingTitle, meetingStart, meetingDurationSeconds, meetingInviteeUserIds]
+    action:
+      method: wecom.action
+  - type: tool
+    id: lark-actions
+    name: lark_action
+    description: Create a governed Lark document, Base, task, calendar event, slides deck, or complete workflow.
+    inputSchema:
+      type: object
+      oneOf:
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_doc }
+            title: { type: string, minLength: 1, maxLength: 200 }
+            markdown: { type: string, maxLength: 500000 }
+            folderToken: { type: string }
+          required: [action, title]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_base }
+            name: { type: string, minLength: 1, maxLength: 200 }
+            folderToken: { type: string }
+            timeZone: { type: string }
+          required: [action, name]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_task }
+            summary: { type: string, minLength: 1, maxLength: 500 }
+            description: { type: string, maxLength: 10000 }
+            assigneeOpenId: { type: string }
+            due: { type: string }
+            idempotencyKey: { type: string }
+          required: [action, summary]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_calendar_event }
+            summary: { type: string, minLength: 1, maxLength: 200 }
+            description: { type: string, maxLength: 10000 }
+            start: { type: string, minLength: 1 }
+            end: { type: string, minLength: 1 }
+            attendeeOpenIds:
+              type: array
+              maxItems: 100
+              items: { type: string }
+            calendarId: { type: string }
+            rrule: { type: string }
+          required: [action, summary, start, end]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: create_slides }
+            title: { type: string, minLength: 1, maxLength: 200 }
+            folderToken: { type: string }
+          required: [action, title]
+        - type: object
+          additionalProperties: false
+          properties:
+            action: { const: golden_chain }
+            docTitle: { type: string, minLength: 1, maxLength: 200 }
+            docMarkdown: { type: string, minLength: 1, maxLength: 500000 }
+            baseName: { type: string, minLength: 1, maxLength: 200 }
+            tasks:
+              type: array
+              minItems: 1
+              maxItems: 50
+              items:
+                type: object
+                additionalProperties: false
+                properties:
+                  summary: { type: string, minLength: 1 }
+                  assigneeOpenId: { type: string, minLength: 1 }
+                  due: { type: string }
+                  description: { type: string }
+                required: [summary, assigneeOpenId]
+            calendarSummary: { type: string, minLength: 1, maxLength: 200 }
+            calendarStart: { type: string, minLength: 1 }
+            calendarEnd: { type: string, minLength: 1 }
+            calendarAttendeeOpenIds:
+              type: array
+              minItems: 1
+              maxItems: 100
+              items: { type: string }
+            includeSlides: { type: boolean }
+          required: [action, docTitle, docMarkdown, baseName, tasks, calendarSummary, calendarStart, calendarEnd, calendarAttendeeOpenIds]
+    action:
+      method: lark.action
+  - type: skill
+    id: enterprise-workflow-skill
+    path: skills/enterprise-workflow
+features:
+  - id: enterprise-actions
+    name: Enterprise workflow actions
+    resources: []
+    contributions:
+      - type: tool
+        id: wecom-actions
+      - type: tool
+        id: lark-actions
+      - type: skill
+        id: enterprise-workflow-skill
+    capabilities:
+      - plugin.config.read
+runtime:
+  transport: builtin
+  entrypoint: dist/plugin-entrypoint.js

package/skills/enterprise-workflow/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: enterprise-workflow
+description: >
+  企业 IM 工作流自动化：文档、表格、待办/任务、会议/日程一键创建。
+  Use when: operator要求创建企微/飞书的文档、表格、待办、会议、日程、幻灯片，或一句话生成完整工作流。
+  Not for: 普通聊天、消息收发、会议纪要 intake，或插件安装与配置。
+  Output: 通过 Host 的 plugin_call 返回企业资源 handle 与链接。
+triggers:
+  - 创建文档
+  - 创建表格
+  - 创建待办
+  - 创建任务
+  - 创建会议
+  - 创建日程
+  - 幻灯片
+  - golden chain
+  - 工作流
+  - 飞书
+  - lark
+  - 企微
+  - wecom
+---
+
+# Enterprise Workflow — 企业 IM 工作流自动化
+
+这个 skill 使用已安装插件 `official.enterprise-workflow` 的声明式工具。Host 负责调用身份、
+审计、实时实例与授权校验；插件负责通过本机官方 CLI 创建资源。
+
+## 调用纪律
+
+1. 先用 `plugin_get` 确认插件已启用且运行。
+2. 每次操作前用 `plugin_list_tools({ pluginId: "official.enterprise-workflow" })` 读取实时 schema。
+3. 只从返回结果选择以下精确坐标之一：
+   - `contributionId: "wecom-actions"`, `toolName: "wecom_action"`
+   - `contributionId: "lark-actions"`, `toolName: "lark_action"`
+4. 用 `plugin_call`，把 action 参数放入 `arguments`。
+5. 不猜 schema，不传 `invocationId` / `callbackToken`，不调用旧 `/api/callbacks/*-action`，不裸调 CLI。
+
+调用外壳：
+
+```json
+{
+  "pluginId": "official.enterprise-workflow",
+  "contributionId": "wecom-actions",
+  "toolName": "wecom_action",
+  "arguments": {
+    "action": "create_doc",
+    "docName": "会议纪要",
+    "content": "# 纪要"
+  }
+}
+```
+
+## 平台选择
+
+| operator 提到 | 工具 |
+|---|---|
+| 企微 / WeCom / 企业微信 | `wecom_action` |
+| 飞书 / Feishu / Lark | `lark_action` |
+| 只说企业 IM | 先问平台；不要自行跨租户创建 |
+
+## WeCom actions
+
+### 创建文档
+
+```json
+{ "action": "create_doc", "docName": "会议纪要", "content": "# 纪要\n..." }
+```
+
+### 创建智能表格
+
+```json
+{
+  "action": "create_smart_table",
+  "tableName": "Bug 跟踪表",
+  "fields": [
+    { "fieldTitle": "Bug", "fieldType": "FIELD_TYPE_TEXT" },
+    { "fieldTitle": "优先级", "fieldType": "FIELD_TYPE_SINGLE_SELECT" }
+  ],
+  "records": [{ "Bug": "登录超时", "优先级": "P1" }]
+}
+```
+
+### 创建待办
+
+```json
+{
+  "action": "create_todo",
+  "content": "Review PRD",
+  "followerUserIds": ["zhangsan"],
+  "remindTime": "2026-04-20 09:00:00"
+}
+```
+
+### 创建会议
+
+```json
+{
+  "action": "create_meeting",
+  "title": "评审",
+  "startDatetime": "2026-04-20 14:00",
+  "durationSeconds": 3600,
+  "inviteeUserIds": ["zhangsan"]
+}
+```
+
+### WeCom golden chain
+
+```json
+{
+  "action": "golden_chain",
+  "docName": "Q2 产品 PRD",
+  "docContent": "# Q2 产品规划\n...",
+  "tableName": "Q2 任务跟踪表",
+  "tasks": [
+    { "content": "完成 API 设计", "assigneeUserId": "zhangsan", "remindTime": "2026-04-20 09:00:00" }
+  ],
+  "meetingTitle": "Q2 PRD 评审会",
+  "meetingStart": "2026-04-20 14:00",
+  "meetingDurationSeconds": 3600,
+  "meetingInviteeUserIds": ["zhangsan", "lisi"]
+}
+```
+
+## Lark actions
+
+### 创建文档
+
+```json
+{ "action": "create_doc", "title": "会议纪要", "markdown": "# 纪要\n..." }
+```
+
+### 创建多维表
+
+```json
+{ "action": "create_base", "name": "Bug 跟踪表", "timeZone": "Asia/Shanghai" }
+```
+
+### 创建任务
+
+```json
+{
+  "action": "create_task",
+  "summary": "Review PRD",
+  "assigneeOpenId": "ou_xxx",
+  "due": "2026-04-20"
+}
+```
+
+### 创建日程
+
+```json
+{
+  "action": "create_calendar_event",
+  "summary": "评审",
+  "start": "2026-04-20T14:00:00+08:00",
+  "end": "2026-04-20T15:00:00+08:00",
+  "attendeeOpenIds": ["ou_xxx"]
+}
+```
+
+### 创建幻灯片
+
+```json
+{ "action": "create_slides", "title": "Q2 Deck" }
+```
+
+### Lark golden chain
+
+```json
+{
+  "action": "golden_chain",
+  "docTitle": "Q2 产品 PRD",
+  "docMarkdown": "# Q2 产品规划\n...",
+  "baseName": "Q2 任务跟踪表",
+  "tasks": [
+    { "summary": "完成 API 设计", "assigneeOpenId": "ou_xxx", "due": "+3d" }
+  ],
+  "calendarSummary": "Q2 PRD 评审会",
+  "calendarStart": "2026-04-20T14:00:00+08:00",
+  "calendarEnd": "2026-04-20T15:00:00+08:00",
+  "calendarAttendeeOpenIds": ["ou_xxx", "ou_yyy"],
+  "includeSlides": true
+}
+```
+
+## 结果与失败
+
+- 成功结果直接是所选 action 的资源 handle；`golden_chain` 还包含可回贴的 `summary`。
+- `INVALID_INPUT`：参数不符合 `plugin_list_tools` 返回的 schema；修正参数，不要重试原请求。
+- `VENDOR_API_ERROR`：厂商 API 拒绝，等价于旧回调的 502；根据错误码和权限处理。
+- `CLI_UNAVAILABLE`：CLI 路径无效、未安装、未登录或超时，等价于旧回调的 503；请 operator 修复本机配置。
+- `CLI_PROTOCOL_ERROR`：CLI 输出与已验证协议不符；停止操作并报告，不要把它降级成“没找到资源”。
+
+## 回贴格式
+
+只回贴实际返回的 handle，不虚构 URL、用户或会议链接。示例：
+
+```text
+已完成工作流创建：
+
+📄 文档: Q2 产品 PRD — <returned URL>
+📊 表格: Q2 任务跟踪表 — <returned URL>
+✅ 任务: 2 条已分发
+🗓 日程: Q2 PRD 评审会
+```
+
+未知 user ID / open ID 时先向 operator 索取或使用已授权的通讯录能力；本插件没有用户搜索工具，
+不得绕过 `plugin_call` 直接调用 CLI 搜索。