multiclaws 0.4.36 → 0.4.38

package/package.json

@@ -1,56 +1,56 @@
-{
-  "name": "multiclaws",
-  "version": "0.4.36",
-  "description": "MultiClaws plugin for OpenClaw collaboration via A2A protocol",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "openclaw": {
-    "extensions": [
-      "./dist/index.js"
-    ]
-  },
-  "files": [
-    "dist",
-    "skills",
-    "openclaw.plugin.json",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "clean": "rm -rf dist"
-  },
-  "keywords": [
-    "openclaw",
-    "plugin",
-    "multiclaws",
-    "a2a",
-    "collaboration"
-  ],
-  "author": "Eric Sun",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/EricSun0218/multiclaws.git"
-  },
-  "dependencies": {
-    "@a2a-js/sdk": "^0.3.10",
-    "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/sdk-trace-base": "^2.6.0",
-    "@opentelemetry/sdk-trace-node": "^2.6.0",
-    "express": "^5.2.1",
-    "opossum": "^9.0.0",
-    "p-retry": "^7.1.1",
-    "proper-lockfile": "^4.1.2",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.6",
-    "@types/node": "^24.3.0",
-    "@types/opossum": "^8.1.9",
-    "@types/proper-lockfile": "^4.1.4",
-    "typescript": "^5.9.2",
-    "vitest": "^3.2.4"
-  }
-}
+{
+  "name": "multiclaws",
+  "version": "0.4.38",
+  "description": "MultiClaws plugin for OpenClaw collaboration via A2A protocol",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist",
+    "skills",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "multiclaws",
+    "a2a",
+    "collaboration"
+  ],
+  "author": "Eric Sun",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EricSun0218/multiclaws.git"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "^0.3.10",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.6.0",
+    "@opentelemetry/sdk-trace-node": "^2.6.0",
+    "express": "^5.2.1",
+    "opossum": "^9.0.0",
+    "p-retry": "^7.1.1",
+    "proper-lockfile": "^4.1.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.3.0",
+    "@types/opossum": "^8.1.9",
+    "@types/proper-lockfile": "^4.1.4",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}

package/skills/meeting-scheduler/SKILL.md

@@ -0,0 +1,175 @@
+# 会议调度 — 技能行为
+
+以下规则指导 AI 如何利用 MultiClaws 团队协作和 Google Calendar 完成会议调度。
+
+---
+
+## 触发条件
+
+当用户的请求包含以下意图时激活此 Skill：
+- 约会议 / 安排会议 / 组织会议
+- 查询团队成员空闲时间
+- 找一个大家都有空的时间
+
+**关键词示例：** 「约会议」「开会」「安排一个会」「找个时间碰一下」「schedule a meeting」
+
+---
+
+## 工作流
+
+### 步骤 1：解析会议需求
+
+从用户请求中提取：
+- **参会人**：指定的团队成员名单（如「小明和小红」）。若用户说「所有人」或「整个团队」，则查询全部成员
+- **时间范围**：用户期望的日期/时间段（如「明天下午」「本周五」「下周一到周三」）
+- **会议主题**：会议目的（可选）
+- **会议时长**：默认 1 小时，用户可指定
+
+如果用户未指定时间范围，询问用户希望在什么时间段开会。
+
+### 步骤 2：查询本地日历
+
+使用 Google Calendar 工具读取**用户自己**在指定时间范围内的日程：
+
+1. 获取指定时间范围内的所有事件
+2. 计算用户的空闲时段
+3. 如果用户在该时间范围内完全没空，提前告知用户并建议换个时间段
+
+### 步骤 3：获取团队成员信息
+
+```
+multiclaws_agents()
+```
+
+从返回的智能体列表中，根据用户指定的参会人名单匹配对应的智能体。
+
+**匹配规则：**
+- 优先按 `ownerName` 匹配
+- 如果用户说「所有人」，取团队全部成员（排除自己）
+- 找不到的成员告知用户
+
+### 步骤 4：并行委派查询空闲时间
+
+对每个参会成员**分别**调用 `multiclaws_delegate`：
+
+```
+multiclaws_delegate(
+  agentUrl="成员的agentUrl",
+  task="请查询你的主人在 [时间范围] 的日程安排，告诉我哪些时段是空闲的。
+        请以如下格式回复：
+        - 空闲时段1：HH:MM - HH:MM
+        - 空闲时段2：HH:MM - HH:MM
+        如果完全没空，请说明。"
+)
+```
+
+记录每个委派返回的 `taskId`。
+
+### 步骤 5：收集回复（超时机制）
+
+**等待策略：手动检查 + 自动超时**
+
+1. 委派发出后告知用户：「已向 N 位成员查询空闲时间，等待回复中…」
+2. 设定超时：**3 分钟**
+3. 在超时前，如有结果通过子 agent 消息返回则自动收集
+4. 超时后检查各任务状态：
+
+```
+multiclaws_task_status(taskId="xxx")
+```
+
+**处理逻辑：**
+- ✅ **已回复**：提取空闲时段信息
+- ⏳ **未回复（超时）**：标记该成员为「未响应」
+- ❌ **失败**：标记该成员为「查询失败」
+
+如果全部超时/失败，告知用户并建议：
+- 稍后重试
+- 直接问相关人员的空闲时间
+- 跳过未响应成员继续安排
+
+### 步骤 6：汇总与展示
+
+将所有结果汇总为易读的表格，展示给用户：
+
+```
+📅 会议空闲时段汇总（主题：xxx）
+
+| 时段           | 你   | 小明 | 小红 | 可行？ |
+|----------------|------|------|------|--------|
+| 14:00 - 15:00  | ✅   | ✅   | ✅   | ✅ 全员可行 |
+| 15:00 - 16:00  | ✅   | ❌   | ✅   | ⚠️ 小明不行 |
+| 16:00 - 17:00  | ✅   | ✅   | ⏳   | ⚠️ 小红未响应 |
+
+推荐时段：14:00 - 15:00（全员可行）
+```
+
+**推荐逻辑：**
+1. 优先推荐全员都空闲的时段
+2. 若无全员空闲时段，推荐覆盖人数最多的时段
+3. 若有多个等价时段，推荐最早的
+
+### 步骤 7：用户确认
+
+询问用户：
+- 选择哪个时段？
+- 是否接受部分成员缺席？
+- 会议标题需要调整吗？
+- 是否需要添加会议描述或议程？
+
+等待用户明确确认后才继续。
+
+### 步骤 8：创建日历事件
+
+用户确认后，使用 Google Calendar 工具：
+1. 创建日历事件（标题、时间、描述）
+2. 添加所有确认参会的成员为与会者（如果有邮箱信息）
+3. 发送日历邀请
+
+### 步骤 9：通知参会者
+
+对每个确认参会的远端成员调用 `multiclaws_delegate`，通知会议已确定：
+
+```
+multiclaws_delegate(
+  agentUrl="成员的agentUrl",
+  task="会议已确定：[主题]，时间：[日期] [时段]。
+        请在你主人的日历上创建这个事件。"
+)
+```
+
+向用户确认：「会议已创建，日历邀请已发送给所有参会者。」
+
+---
+
+## 边界情况处理
+
+### 跨时区
+- 委派查询时明确指定时区（如 GMT+8）
+- 汇总时统一转换为用户所在时区展示
+
+### 只有一个参会者
+- 跳过汇总表格，直接展示双方都空闲的时段
+- 简化确认流程
+
+### 用户取消
+- 在任何步骤用户都可以说「算了」「取消」
+- 取消时不创建任何事件
+
+### 成员无日历能力
+- 如果某成员的 bio 中没有提到日历相关能力，在委派时明确说明：
+  「请询问你的主人在 [时间范围] 是否有空，由主人口头回答即可」
+
+### 紧急会议
+- 如果用户说「现在」「马上」「尽快」，将时间范围设为今天剩余时间
+- 缩短超时为 1 分钟
+
+---
+
+## 重要规则
+
+- **必须等用户确认后才创建事件**，永远不要自动创建
+- **委派查询时要说明会议主题**（如果有），让对方判断优先级
+- **汇总要直观**，用表格和 emoji 使结果一目了然
+- **尊重隐私**，不在委派消息中透露其他成员的具体日程细节
+- **保持礼貌**，委派消息用协商语气而非命令语气