@coda-console/protocol 1.7.0 → 1.9.0

package/schemas/agent/review.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/agent/v1/review.json",
+  "type": "object",
+  "description": "审核须为对象",
+  "properties": {
+    "state": {
+      "enum": [
+        "reviewing",
+        "approved",
+        "denied"
+      ],
+      "description": "state 只能是 reviewing、approved、denied"
+    },
+    "reason": {
+      "type": "string",
+      "description": "reason 须为不超过 4000 字的文本",
+      "x-length": 4000
+    },
+    "risk": {
+      "description": "不认识的 risk 不记；不因此丢弃审核。已知值见 $defs/risk。"
+    }
+  },
+  "required": [
+    "state"
+  ],
+  "$defs": {
+    "risk": {
+      "enum": [
+        "low",
+        "medium",
+        "high",
+        "critical"
+      ],
+      "description": "risk 只能是 low、medium、high 或 critical"
+    }
+  }
+}

package/schemas/agent/steering.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/agent/v1/steering.json",
+  "description": "生态的 _session/steering 扩展中 Coda 使用的部分；prompt 的内容块仍交 ACP SDK 校验。",
+  "$defs": {
+    "capabilities": {
+      "type": "object",
+      "description": "initialize 的 _meta 须为对象",
+      "properties": {
+        "steering": {
+          "type": "object",
+          "description": "steering 须为对象",
+          "properties": {
+            "supported": {
+              "type": "boolean",
+              "description": "supported 须为 true 或 false"
+            }
+          }
+        }
+      }
+    },
+    "params": {
+      "type": "object",
+      "description": "插话参数须为对象",
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "description": "缺 sessionId",
+          "minLength": 1
+        },
+        "prompt": {
+          "description": "与 session/prompt 相同，由 ACP SDK 校验；Coda 发一个文本块"
+        },
+        "_meta": {
+          "type": "object",
+          "description": "_meta 须为对象",
+          "properties": {
+            "steering": {
+              "type": "object",
+              "description": "steering 须为对象",
+              "properties": {
+                "idleBehavior": {
+                  "const": "promptRequired",
+                  "description": "idleBehavior 须为 promptRequired"
+                }
+              },
+              "required": [
+                "idleBehavior"
+              ]
+            }
+          },
+          "required": [
+            "steering"
+          ]
+        }
+      },
+      "required": [
+        "sessionId",
+        "prompt",
+        "_meta"
+      ]
+    },
+    "result": {
+      "type": "object",
+      "description": "插话答复须为对象",
+      "properties": {
+        "outcome": {
+          "enum": [
+            "injected",
+            "promptRequired"
+          ],
+          "description": "插话须回答 injected 或 promptRequired；其他结果的投递状态未知"
+        },
+        "reason": {
+          "description": "原因由 Agent 给出，Coda 只按 outcome 判断投递结果"
+        }
+      },
+      "required": [
+        "outcome"
+      ]
+    }
+  }
+}

package/schemas/agent/usage.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/agent/v1/usage.json",
+  "type": "object",
+  "description": "须为不超过 4096 字节的 JSON 对象",
+  "x-json": {
+    "schema": {
+      "type": "object",
+      "description": "须为不超过 4096 字节的 JSON 对象"
+    },
+    "maxBytes": 4096
+  }
+}

package/schemas/agent/wait-stop.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/agent/v1/wait-stop.json",
+  "description": "停止一项活动；答复只表示收到，是否已停止由之后的活动报告确认。",
+  "$defs": {
+    "params": {
+      "type": "object",
+      "description": "params 须为对象",
+      "properties": {
+        "sessionId": {
+          "$ref": "wait.json#/properties/sessionId"
+        },
+        "waitId": {
+          "$ref": "wait.json#/properties/waitId"
+        }
+      },
+      "required": [
+        "sessionId",
+        "waitId"
+      ]
+    },
+    "result": {
+      "type": "object",
+      "description": "Agent 回 {}；回复只表示收到",
+      "properties": {}
+    }
+  }
+}

package/schemas/agent/wait.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coda.pub/schemas/agent/v1/wait.json",
+  "type": "object",
+  "description": "params 须为对象",
+  "properties": {
+    "sessionId": {
+      "allOf": [
+        {
+          "type": "string",
+          "description": "缺 sessionId",
+          "minLength": 1
+        },
+        {
+          "type": "string",
+          "description": "sessionId 须为不超过 200 字的文本",
+          "x-length": 200
+        }
+      ]
+    },
+    "waitId": {
+      "allOf": [
+        {
+          "type": "string",
+          "description": "缺 waitId",
+          "minLength": 1
+        },
+        {
+          "type": "string",
+          "description": "waitId 须为不超过 200 字的文本",
+          "x-length": 200
+        }
+      ]
+    },
+    "state": {
+      "enum": [
+        "waiting",
+        "handling",
+        "done",
+        "failed",
+        "cancelled"
+      ],
+      "description": "state 只能是 waiting、handling、done、failed、cancelled"
+    },
+    "kind": {
+      "type": "string",
+      "description": "kind 须为不超过 50 字的文本",
+      "x-length": 50
+    },
+    "title": {
+      "type": "string",
+      "description": "title 须为不超过 500 字的文本",
+      "x-length": 500
+    },
+    "detail": {
+      "type": "string",
+      "description": "detail 须为不超过 4000 字的文本",
+      "x-length": 4000
+    },
+    "childSessionId": {
+      "type": "string",
+      "description": "childSessionId 须为不超过 200 字的文本",
+      "x-length": 200
+    },
+    "model": {
+      "type": "string",
+      "description": "model 须为不超过 200 字的文本",
+      "x-length": 200
+    },
+    "outputFile": {
+      "type": "string",
+      "description": "outputFile 须为不超过 4096 字的文本",
+      "x-length": 4096
+    },
+    "toolCallId": {
+      "type": "string",
+      "description": "toolCallId 须为不超过 200 字的文本",
+      "x-length": 200
+    },
+    "stoppable": {
+      "type": "boolean",
+      "description": "stoppable 须为 true 或 false"
+    },
+    "recurring": {
+      "type": "boolean",
+      "description": "recurring 须为 true 或 false"
+    },
+    "at": {
+      "type": "string",
+      "description": "at 读不出时间",
+      "format": "date-parse"
+    }
+  },
+  "required": [
+    "sessionId",
+    "waitId",
+    "state"
+  ]
+}

package/workflow/dialect.json

@@ -14,6 +14,7 @@
     "workflow.dispatch": "手动发起（workflow_run、客户端的按钮）：由事件启动的流程也订阅它，才能手动发起",
     "workflow.cancel": "要它停下：在等它的运行被告知，走到自己的结束，以取消结束"
   },
+  "eventRoles": {"lifecycleStart": "session.opened", "lifecycleFacts": "session.facts", "dispatch": "workflow.dispatch", "cancel": "workflow.cancel"},
   "userMessage": "^user\\.[a-z][a-z0-9-]{0,39}$",
   "stepFailed": "STEP_FAILED",
   "variables": ["inputs", "run", "github", "vars"],

package/workflow/keywords.mjs

@@ -5,7 +5,7 @@ import { isAbsolute } from 'node:path';
 
 // The byte length of a JSON value, without recursion or serializing the whole object. Stop as soon as the budget is
 // exceeded. Only JSON values count: cycles, non-finite numbers and non-JSON objects cannot turn into a different value.
-function jsonFits(value, max) {
+export function jsonFits(value, max) {
   let bytes = 0;
   const active = new Set(), stack = [{ value }];
   while (stack.length && bytes <= max) {