@coda-console/protocol 2.6.0 → 3.1.0

package/schemas/executor/v1/common.json

@@ -1,89 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://coda.pub/schemas/executor/v1/common.json",
-  "title": "运行器协议共享静态定义",
-  "definitions": {
-    "opaqueId": {"type": "string", "minLength": 1, "maxLength": 2048, "description": "适配层给出的不透明标识；不解析或拼接机器路由"},
-    "resourceRef": {
-      "type": "object",
-      "properties": {"kind": {"type": "string", "minLength": 1, "maxLength": 128}, "id": {"$ref": "common.json#/definitions/opaqueId"}},
-      "required": ["kind", "id"],
-      "additionalProperties": false
-    },
-    "executorRef": {
-      "type": "object",
-      "properties": {"kind": {"const": "executor"}, "id": {"$ref": "common.json#/definitions/opaqueId"}},
-      "required": ["kind", "id"],
-      "additionalProperties": false
-    },
-    "snapshotRef": {
-      "type": "object",
-      "properties": {"kind": {"const": "sourceSnapshot"}, "id": {"$ref": "common.json#/definitions/opaqueId"}},
-      "required": ["kind", "id"],
-      "additionalProperties": false
-    },
-    "repositoryRef": {
-      "type": "object",
-      "properties": {"kind": {"const": "gitSource"}, "id": {"$ref": "common.json#/definitions/opaqueId"}},
-      "required": ["kind", "id"],
-      "additionalProperties": false
-    },
-    "labels": {
-      "type": "array",
-      "items": {"type": "string", "minLength": 1, "maxLength": 40, "pattern": "^[a-z0-9][a-z0-9._-]*$(?![\\s\\S])"},
-      "maxItems": 64,
-      "uniqueItems": true
-    },
-    "userLabels": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "minLength": 1,
-        "maxLength": 40,
-        "pattern": "^[a-z0-9][a-z0-9._-]*$(?![\\s\\S])",
-        "not": {
-          "pattern": "^(darwin|linux|win32|aix|android|freebsd|openbsd|sunos|cygwin|netbsd|haiku|arm|arm64|ia32|x64|loong64|mips|mipsel|ppc|ppc64|riscv64|s390|s390x|gui)$|^(xcode|ios|node)-"
-        }
-      },
-      "maxItems": 64,
-      "uniqueItems": true,
-      "description": "用户自定义标签，不占用 OS、架构、gui 与 xcode-/ios-/node- 探测命名空间"
-    },
-    "resourceName": {
-      "type": "string",
-      "pattern": "^(?:slots|group:(?!host$(?![\\s\\S]))[^\\s\\u0000-\\u001f\\u007f]{1,100})$(?![\\s\\S])",
-      "description": "slots 对应 host；其他本机命名组用 group:<原名>，不将不同组折叠为 slots"
-    },
-    "resourceAmounts": {
-      "type": "object",
-      "propertyNames": {"$ref": "common.json#/definitions/resourceName"},
-      "maxProperties": 128,
-      "additionalProperties": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
-      "description": "可报告多个独立资源的容量；每个请求仍至多申请一个资源的一单位"
-    },
-    "reason": {
-      "type": "object",
-      "properties": {
-        "code": {"type": "string", "minLength": 1, "maxLength": 128},
-        "message": {"type": "string", "minLength": 1, "maxLength": 4096}
-      },
-      "required": ["code", "message"],
-      "additionalProperties": false
-    },
-    "timestamp": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 40,
-      "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d{1,9})?Z$(?![\\s\\S])",
-      "description": "UTC 时间文字；schema 检查形状，真实日历时间由写入方保证"
-    },
-    "assignmentId": {"type": "string", "minLength": 1, "maxLength": 256, "description": "每次绑定生成的新 token，与 executor 同次 CAS 更新"},
-    "workingDirectory": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 4096,
-      "pattern": "^(?!/)(?![A-Za-z]:)(?!.*\\\\)(?!.*[\\u0000-\\u001f\\u007f])(?!.*(?:^|/)\\.\\.(?:/|$)).+$",
-      "description": "工作根下的相对路径；拒绝绝对路径、反斜线和 .. 段，真实落点与符号链接仍须执行方检查"
-    }
-  }
-}

package/schemas/executor/v1/execution.json

@@ -1,246 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://coda.pub/schemas/executor/v1/execution.json",
-  "title": "execution：一次执行尝试的请求与完整结果",
-  "type": "object",
-  "properties": {
-    "spec": {
-      "type": "object",
-      "properties": {
-        "protocolVersion": {"const": 1},
-        "run": {"$ref": "common.json#/definitions/resourceRef"},
-        "step": {"type": "string", "minLength": 1, "maxLength": 256},
-        "attempt": {"type": "integer", "minimum": 1, "maximum": 9007199254740991},
-        "source": {
-          "oneOf": [
-            {"type": "null"},
-            {
-              "type": "object",
-              "properties": {"snapshot": {"$ref": "common.json#/definitions/snapshotRef"}},
-              "required": ["snapshot"],
-              "additionalProperties": false
-            },
-            {
-              "type": "object",
-              "properties": {
-                "repository": {"$ref": "common.json#/definitions/repositoryRef"},
-                "commit": {"type": "string", "minLength": 1, "maxLength": 64, "pattern": "^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$(?![\\s\\S])"}
-              },
-              "required": ["repository", "commit"],
-              "additionalProperties": false
-            }
-          ]
-        },
-        "requirements": {
-          "type": "object",
-          "properties": {"labels": {"$ref": "common.json#/definitions/labels"}},
-          "required": ["labels"],
-          "additionalProperties": false
-        },
-        "placement": {
-          "type": "object",
-          "properties": {
-            "locality": {"enum": ["local", "any"], "default": "any"},
-            "executor": {"$ref": "common.json#/definitions/executorRef"}
-          },
-          "additionalProperties": false,
-          "description": "生产者的硬约束，不是调度绑定；省略等同 any。指定 executor 与 locality 必须同时满足，不能隐式回退"
-        },
-        "resources": {
-          "type": "object",
-          "propertyNames": {"$ref": "common.json#/definitions/resourceName"},
-          "maxProperties": 1,
-          "additionalProperties": {"const": 1},
-          "description": "空对象表示不占资源；否则只申请一个资源的一单位，不接受多单位或资源向量"
-        },
-        "exclusiveResources": {
-          "type": "array",
-          "items": {"$ref": "common.json#/definitions/resourceName"},
-          "maxItems": 1,
-          "uniqueItems": true,
-          "default": [],
-          "description": "空数组或独占申请的那一个资源；执行方核对与 resources 的键一致，不换算成容量数字"
-        },
-        "context": {
-          "type": "object",
-          "properties": {
-            "workflow": {
-              "type": "object",
-              "properties": {
-                "name": {"type": "string", "minLength": 1, "maxLength": 256},
-                "job": {"type": "string", "minLength": 1, "maxLength": 256},
-                "runId": {"$ref": "common.json#/definitions/opaqueId"},
-                "runAttempt": {"type": "integer", "minimum": 1, "maximum": 9007199254740991},
-                "sha": {"type": "string", "pattern": "^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})?$(?![\\s\\S])"},
-                "ref": {"type": "string", "maxLength": 1024},
-                "repository": {"type": "string", "maxLength": 2048}
-              },
-              "required": ["name", "job", "runId", "runAttempt", "sha", "ref", "repository"],
-              "additionalProperties": false
-            },
-            "plugin": {
-              "type": "object",
-              "properties": {
-                "id": {"type": "string", "pattern": "^[a-z][a-z0-9-]{0,39}$(?![\\s\\S])"},
-                "version": {"type": "string", "minLength": 1, "maxLength": 128}
-              },
-              "required": ["id", "version"],
-              "additionalProperties": false
-            },
-            "audience": {"const": "user"},
-            "outputNames": {"type": "array", "maxItems": 64, "uniqueItems": true,
-              "items": {"type": "string", "minLength": 1, "maxLength": 128}}
-          },
-          "additionalProperties": false,
-          "description": "可信生产者给出的运行上下文与输出声明；不是环境快照或授权凭证，本机路径和密文不进入此字段"
-        },
-        "task": {
-          "oneOf": [
-            {
-              "type": "object",
-              "properties": {
-                "script": {"type": "string", "minLength": 1, "maxLength": 65536},
-                "shell": {"type": "string", "minLength": 1, "maxLength": 4096}
-              },
-              "required": ["script", "shell"],
-              "additionalProperties": false
-            },
-            {
-              "type": "object",
-              "properties": {
-                "command": {"type": "string", "minLength": 1, "maxLength": 4096},
-                "args": {"type": "array", "items": {"type": "string", "minLength": 0, "maxLength": 16384}, "maxItems": 256}
-              },
-              "required": ["command", "args"],
-              "additionalProperties": false
-            }
-          ]
-        },
-        "workingDirectory": {"$ref": "common.json#/definitions/workingDirectory", "default": "."},
-        "env": {
-          "type": "object",
-          "propertyNames": {"pattern": "^[A-Za-z_][A-Za-z0-9_]{0,127}$(?![\\s\\S])"},
-          "maxProperties": 128,
-          "additionalProperties": {"type": "string", "minLength": 0, "maxLength": 16384}
-        },
-        "timeoutMs": {"type": "integer", "minimum": 1, "maximum": 9007199254740991},
-        "cancelGraceMs": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
-        "cancel": {"type": "boolean", "default": false},
-        "executor": {
-          "oneOf": [{"type": "null"}, {"$ref": "common.json#/definitions/executorRef"}],
-          "description": "scheduler 写入的顶层单值绑定，与 assignmentId 同次 CAS 更新，不参与补充合并"
-        },
-        "assignmentId": {"oneOf": [{"type": "null"}, {"$ref": "common.json#/definitions/assignmentId"}]}
-      },
-      "required": ["protocolVersion", "run", "attempt", "source", "requirements", "resources", "task", "env", "executor", "assignmentId"],
-      "additionalProperties": false,
-      "allOf": [
-        {
-          "if": {"properties": {"resources": {"maxProperties": 0}}},
-          "then": {"properties": {"exclusiveResources": {"maxItems": 0}}}
-        },
-        {
-          "if": {"properties": {"executor": {"type": "null"}}},
-          "then": {"properties": {"assignmentId": {"type": "null"}}},
-          "else": {"properties": {"assignmentId": {"$ref": "common.json#/definitions/assignmentId"}}}
-        }
-      ],
-      "description": "一次执行尝试；绑定后任务、源码和需求冻结，取消为单向意图"
-    },
-    "status": {
-      "type": "object",
-      "properties": {
-        "phase": {"enum": ["queued", "preparing", "running", "finished"]},
-        "reason": {"$ref": "common.json#/definitions/reason"},
-        "assignmentId": {"oneOf": [{"type": "null"}, {"$ref": "common.json#/definitions/assignmentId"}]},
-        "startedAt": {"$ref": "common.json#/definitions/timestamp"},
-        "finishedAt": {"$ref": "common.json#/definitions/timestamp"},
-        "executionRun": {"$ref": "common.json#/definitions/resourceRef"},
-        "admission": {"oneOf": [{"type": "null"}, {
-          "type": "object",
-          "properties": {
-            "resource": {"$ref": "common.json#/definitions/resourceName"},
-            "lease": {"$ref": "common.json#/definitions/opaqueId"},
-            "slots": {
-              "type": "array",
-              "items": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
-              "maxItems": 4096,
-              "minItems": 1,
-              "uniqueItems": true
-            }
-          },
-          "required": ["lease", "slots"],
-          "additionalProperties": false
-        }], "description": "无资源请求为 null；占资源须有真实 lease 与名额，resource 省略表示 slots。执行方按请求核对，不用 null 绕过准入"},
-        "outcome": {"enum": ["succeeded", "failed", "cancelled", "rejected"]},
-        "exitCode": {"type": ["integer", "null"]},
-        "outputs": {
-          "type": "object",
-          "maxProperties": 64,
-          "propertyNames": {"type": "string", "minLength": 1, "maxLength": 128},
-          "additionalProperties": {"type": "string", "minLength": 0, "maxLength": 4096}
-        },
-        "summary": {"type": "string", "minLength": 0, "maxLength": 4096},
-        "outputTail": {"type": "string", "minLength": 0, "maxLength": 16384},
-        "logs": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "ref": {"$ref": "common.json#/definitions/resourceRef"},
-              "cursor": {"type": "string", "minLength": 1, "maxLength": 2048}
-            },
-            "required": ["ref"],
-            "additionalProperties": false
-          },
-          "maxItems": 64
-        },
-        "artifacts": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "ref": {"$ref": "common.json#/definitions/resourceRef"},
-              "name": {"type": "string", "minLength": 1, "maxLength": 256},
-              "sha256": {"type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-fA-F]{64}$"},
-              "size": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
-              "mediaType": {"type": "string", "minLength": 1, "maxLength": 256}
-            },
-            "required": ["ref", "name"],
-            "additionalProperties": false
-          },
-          "maxItems": 64
-        }
-      },
-      "required": [],
-      "additionalProperties": false,
-      "anyOf": [{"maxProperties": 0}, {"required": ["phase", "assignmentId"]}],
-      "allOf": [
-        {
-          "if": {"properties": {"phase": {"const": "finished"}}, "required": ["phase"]},
-          "then": {"required": ["outcome", "finishedAt"]},
-          "else": {"not": {"anyOf": [{"required": ["outcome"]}, {"required": ["exitCode"]}, {"required": ["finishedAt"]}]}}
-        },
-        {
-          "if": {"properties": {"phase": {"enum": ["preparing", "running"]}}, "required": ["phase"]},
-          "then": {"properties": {"assignmentId": {"$ref": "common.json#/definitions/assignmentId"}}}
-        },
-        {
-          "if": {"properties": {"phase": {"const": "running"}}, "required": ["phase"]},
-          "then": {"required": ["startedAt", "executionRun", "admission"]}
-        },
-        {
-          "if": {"properties": {"outcome": {"enum": ["succeeded", "failed"]}}, "required": ["outcome"]},
-          "then": {"properties": {"assignmentId": {"$ref": "common.json#/definitions/assignmentId"}}, "required": ["startedAt"]}
-        },
-        {
-          "if": {"properties": {"outcome": {"const": "rejected"}}, "required": ["outcome"]},
-          "then": {"not": {"required": ["startedAt"]}, "properties": {"exitCode": {"type": "null"}}}
-        }
-      ],
-      "description": "空对象表示未知；绑定后由执行方完整回传，按 assignmentId 区分旧回答"
-    }
-  },
-  "required": ["spec", "status"],
-  "additionalProperties": false
-}

package/schemas/executor/v1/executor.json

@@ -1,98 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://coda.pub/schemas/executor/v1/executor.json",
-  "title": "executor：运行器配置意图与持有端事实",
-  "type": "object",
-  "properties": {
-    "spec": {
-      "type": "object",
-      "properties": {
-        "protocolVersion": {"const": 1},
-        "enabled": {"type": "boolean"},
-        "capacity": {"$ref": "common.json#/definitions/resourceAmounts"},
-        "labels": {"$ref": "common.json#/definitions/userLabels"},
-        "title": {"type": "string", "minLength": 1, "maxLength": 200}
-      },
-      "required": ["protocolVersion", "enabled", "capacity", "labels"],
-      "additionalProperties": false,
-      "description": "运行器配置意图；无 target，由持有端维护"
-    },
-    "status": {
-      "type": "object",
-      "properties": {
-        "detectedLabels": {"$ref": "common.json#/definitions/labels"},
-        "capabilities": {
-          "type": "object",
-          "properties": {
-            "os": {"type": "string", "minLength": 1, "maxLength": 40},
-            "arch": {"type": "string", "minLength": 1, "maxLength": 40},
-            "nodeVersion": {"type": "string", "minLength": 1, "maxLength": 128},
-            "xcode": {
-              "type": "object",
-              "properties": {
-                "version": {"type": "string", "minLength": 1, "maxLength": 128},
-                "build": {"type": "string", "minLength": 1, "maxLength": 128}
-              },
-              "required": ["version", "build"],
-              "additionalProperties": false
-            },
-            "simulatorRuntimes": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "id": {"type": "string", "minLength": 1, "maxLength": 256},
-                  "version": {"type": "string", "minLength": 1, "maxLength": 128},
-                  "available": {"type": "boolean"}
-                },
-                "required": ["id", "version", "available"],
-                "additionalProperties": false
-              },
-              "maxItems": 256
-            },
-            "graphicalSession": {"type": ["boolean", "null"]}
-          },
-          "required": ["os", "arch", "nodeVersion", "graphicalSession"],
-          "additionalProperties": false
-        },
-        "capacity": {"$ref": "common.json#/definitions/resourceAmounts"},
-        "occupied": {"$ref": "common.json#/definitions/resourceAmounts"},
-        "available": {"$ref": "common.json#/definitions/resourceAmounts"},
-        "accepting": {"type": "boolean"},
-        "reason": {"$ref": "common.json#/definitions/reason"},
-        "observedAt": {"$ref": "common.json#/definitions/timestamp"},
-        "observedRevision": {"$ref": "common.json#/definitions/opaqueId"},
-        "executionFeatures": {
-          "type": "object",
-          "properties": {
-            "multiResource": {"const": false}, "multiUnit": {"const": false}, "exclusive": {"type": "boolean"},
-            "noResources": {"type": "boolean"}, "namedResources": {"type": "boolean"}, "context": {"type": "boolean"}
-          },
-          "required": ["multiResource", "multiUnit", "exclusive"],
-          "additionalProperties": false
-        }
-      },
-      "required": [],
-      "additionalProperties": false,
-      "anyOf": [
-        {"maxProperties": 0},
-        {
-          "required": [
-            "detectedLabels",
-            "capabilities",
-            "capacity",
-            "occupied",
-            "available",
-            "accepting",
-            "observedAt",
-            "observedRevision",
-            "executionFeatures"
-          ]
-        }
-      ],
-      "description": "空对象表示未知；非空为持有端完整事实，不是在线或预留保证"
-    }
-  },
-  "required": ["spec", "status"],
-  "additionalProperties": false
-}