@dcrays/dcgchat-test 0.7.0 → 0.7.1

package/openclaw.plugin.json

@@ -12,8 +12,7 @@
   },
   "contracts": {
     "tools": [
-      "dcgchat_message",
-      "agent_send"
+      "dcgchat_message"
     ]
   },
   "channelConfigs": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcrays/dcgchat-test",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "type": "module",
   "description": "书灵墨宝Channel插件",
   "main": "index.js",

package/schemas/gateway-cron-event.payload.json

@@ -0,0 +1,221 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dcgchat.local/schemas/gateway-cron-finished.payload.json",
+  "title": "Gateway WS event: cron finished (dcgchat contract)",
+  "description": "网关下行 `event: \"cron\"` 且 `payload.action === \"finished\"` 时的 payload 契约。当前插件 finished 分支强依赖 `jobId` 反查 OpenClaw cron job，`status !== \"ok\"` 会按失败处理，并优先从 `summary`、`error.message`、`diagnostics.summary` 生成用户可见失败提示。定时任务生成文件时，应在任务执行期间调用 `dcgchat_message`，使用 `media: [{ \"file\": \"绝对路径\" }]` 发送附件；finished 事件只负责收尾，不承载附件投递。cron 创建侧会把任务规范化为 `sessionTarget: \"current\"`、`wakeMode: \"now\"`、`delivery.mode: \"announce\"`、`delivery.to: \"dcg-cron:${sessionKey}\"`、`payload.kind: \"agentTurn\"`、`payload.timeoutSeconds >= 600`；若 finished 事件携带 `job`，建议使用同一形态。",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["action", "jobId", "status"],
+  "properties": {
+    "action": {
+      "const": "finished",
+      "description": "cron 生命周期动作；本 schema 仅描述 finished。"
+    },
+    "jobId": {
+      "$ref": "#/$defs/nonEmptyString",
+      "description": "OpenClaw cron job id；插件用它调用 `cron.get` 反查 sessionKey、标题和描述。"
+    },
+    "runId": {
+      "$ref": "#/$defs/nonEmptyString",
+      "description": "本次运行 id；如宿主支持 cron run 记录，建议携带。"
+    },
+    "status": {
+      "type": "string",
+      "minLength": 1,
+      "description": "`ok` 表示成功；当前插件会把任何非 `ok` 值视作失败，并向用户发送失败提示。",
+      "examples": ["ok", "failed", "error", "timeout", "cancelled"]
+    },
+    "summary": {
+      "type": "string",
+      "description": "运行摘要。失败时会作为首选失败详情；成功时当前 finished 分支不会主动发送该正文。"
+    },
+    "error": {
+      "$ref": "#/$defs/errorLike",
+      "description": "失败详情；当 `summary` 为空时，插件会读取字符串值或对象中的 `message`。"
+    },
+    "diagnostics": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "宿主诊断信息；当前插件会在失败时读取 `diagnostics.summary` 作为兜底详情。",
+      "properties": {
+        "summary": { "type": "string" },
+        "status": { "type": "string" },
+        "error": { "$ref": "#/$defs/errorLike" },
+        "durationMs": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "sessionKey": {
+      "$ref": "#/$defs/nonEmptyString",
+      "description": "可选冗余字段。DCG 会话 key；如果携带，应与 `job.sessionKey` 或 `job.delivery.to` 去掉 `dcg-cron:` 前缀后一致。"
+    },
+    "sessionId": {
+      "type": "string",
+      "description": "可选冗余字段。当前 finished 分支不直接使用，实际路由以 `cron.get(jobId)` 返回的 sessionKey 为准。"
+    },
+    "delivery": {
+      "$ref": "#/$defs/delivery",
+      "description": "可选冗余字段。建议与 `job.delivery` 保持一致，便于日志和外部消费者定位投递目标。"
+    },
+    "job": {
+      "$ref": "#/$defs/cronJob",
+      "description": "可选 cron job 快照。若宿主在 finished 事件中携带，建议使用 DCG 创建侧规范化后的完整 job。"
+    },
+    "startedAtMs": { "$ref": "#/$defs/epochMs" },
+    "finishedAtMs": { "$ref": "#/$defs/epochMs" },
+    "durationMs": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "本次运行耗时，单位毫秒。"
+    },
+    "delivered": {
+      "type": "boolean",
+      "description": "宿主 delivery 层是否已完成投递尝试；当前插件不依赖该字段。"
+    },
+    "deliveryStatus": {
+      "type": "string",
+      "description": "宿主 delivery 层状态；当前插件不依赖该字段。",
+      "examples": ["sent", "skipped", "failed", "best-effort"]
+    }
+  },
+  "$defs": {
+    "nonEmptyString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "epochMs": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Unix epoch milliseconds。"
+    },
+    "errorLike": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "message": { "type": "string" },
+            "code": { "type": ["string", "number"] },
+            "name": { "type": "string" },
+            "stack": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "delivery": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "mode": {
+          "const": "announce",
+          "description": "DCG cron 创建侧固定为 announce。"
+        },
+        "channel": {
+          "enum": ["dcgchat", "dcgchat-test"],
+          "description": "DCG channel id；生产为 `dcgchat`，测试默认是 `dcgchat-test`。"
+        },
+        "to": {
+          "type": "string",
+          "pattern": "^dcg-cron:.+",
+          "description": "投递目标，固定使用 `dcg-cron:${sessionKey}`。"
+        },
+        "bestEffort": {
+          "const": true,
+          "description": "DCG cron 创建侧固定为 true。"
+        },
+        "accountId": {
+          "type": "string",
+          "description": "从 sessionKey 解析出的 agentId。"
+        },
+        "intended": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "to": { "type": "string" }
+          }
+        },
+        "resolved": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "to": { "type": "string" }
+          }
+        }
+      }
+    },
+    "schedule": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "kind": {
+          "type": "string",
+          "examples": ["cron", "at", "every"]
+        },
+        "cron": { "type": "string" },
+        "expr": { "type": "string" },
+        "tz": {
+          "type": "string",
+          "description": "cron 表达式任务由 DCG 创建侧补为 `Asia/Shanghai`。"
+        },
+        "at": { "type": "string" },
+        "atMs": { "$ref": "#/$defs/epochMs" },
+        "every": { "type": "string" },
+        "everyMs": { "type": "integer", "minimum": 1 },
+        "anchorMs": { "$ref": "#/$defs/epochMs" },
+        "stagger": { "type": "string" },
+        "staggerMs": { "type": "integer", "minimum": 0 },
+        "exact": { "type": "boolean" }
+      }
+    },
+    "cronPayload": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "kind": {
+          "type": "string",
+          "description": "普通 DCG cron 创建侧默认为 `agentTurn`；`systemEvent` 会保留并使用 `text`。"
+        },
+        "message": { "type": "string" },
+        "text": { "type": "string" },
+        "timeoutSeconds": {
+          "type": "number",
+          "minimum": 600,
+          "description": "普通 agentTurn cron 由 DCG 创建侧补为至少 600 秒。"
+        },
+        "model": { "type": "string" },
+        "fallbacks": { "type": "array" },
+        "thinking": {},
+        "toolsAllow": { "type": "array", "items": { "type": "string" } },
+        "lightContext": { "type": "boolean" },
+        "allowUnsafeExternalContent": { "type": "boolean" }
+      }
+    },
+    "cronJob": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "name": { "type": "string" },
+        "description": { "type": "string" },
+        "enabled": { "type": "boolean" },
+        "deleteAfterRun": { "type": "boolean" },
+        "sessionKey": { "$ref": "#/$defs/nonEmptyString" },
+        "sessionTarget": {
+          "const": "current",
+          "description": "DCG cron 创建侧固定为 current。"
+        },
+        "wakeMode": {
+          "const": "now",
+          "description": "DCG cron 创建侧固定为 now。"
+        },
+        "delivery": { "$ref": "#/$defs/delivery" },
+        "schedule": { "$ref": "#/$defs/schedule" },
+        "payload": { "$ref": "#/$defs/cronPayload" },
+        "failureAlert": {},
+        "agentId": { "type": "string" },
+        "createdAtMs": { "$ref": "#/$defs/epochMs" },
+        "updatedAtMs": { "$ref": "#/$defs/epochMs" }
+      }
+    }
+  }
+}

package/schemas/gateway-cron-finished.payload.json

@@ -1,39 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://dcgchat.local/schemas/gateway-cron-finished.payload.json",
-  "title": "Gateway WS event: cron finished (dcgchat contract)",
-  "description": "网关下行 `event: \"cron\"` 且 `payload.action === \"finished\"` 时，书灵通道插件读取的约定字段。`attachments` 为首选：须为 Gateway 进程可读的绝对路径，经通道 sendMedia 发送。若宿主未提供 `attachments`，插件会回退为仅在工作区/挂载规则下从 `summary` 提取路径（与 dcgchat_message 一致），直至宿主实现本字段。",
-  "type": "object",
-  "properties": {
-    "jobId": { "type": "string" },
-    "action": { "const": "finished" },
-    "status": { "type": "string" },
-    "summary": { "type": "string" },
-    "delivered": { "type": "boolean" },
-    "deliveryStatus": { "type": "string" },
-    "sessionId": { "type": "string" },
-    "sessionKey": { "type": "string" },
-    "attachments": {
-      "type": "array",
-      "description": "本轮定时任务产出的本地文件路径，按顺序经通道发送为附件",
-      "items": {
-        "oneOf": [
-          {
-            "type": "string",
-            "minLength": 1,
-            "description": "绝对路径"
-          },
-          {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-              "path": { "type": "string", "minLength": 1 },
-              "file": { "type": "string", "minLength": 1 }
-            },
-            "description": "对象形式：优先读取 `path`，否则 `file`"
-          }
-        ]
-      }
-    }
-  }
-}