abelien-harness 0.20.0 → 0.22.0

package/skills/abelien-workspace/contract/host-tools.generated.json

@@ -519,13 +519,165 @@
     },
     {
       "action_id": "image.generate",
-      "contract_version": 1,
-      "definition_digest": "5197e044ce3b5ba45cc204f35a6138addb9f62f8589ea532818ca1ce7b0b4743",
+      "contract_version": 2,
+      "definition_digest": "d3dab05bac6e752a1ab4d03329b52e38e227214f33086a44df849b0d52fb02c1",
       "audience": "agent",
       "description": "生成概念图：等待已结算回执并冻结外观参考；可能收费，未知或在途的调用只按原身份恢复",
       "input_schema": {
+        "title": "image-task.v1",
         "type": "object",
-        "properties": {},
+        "required": [
+          "schema",
+          "purpose",
+          "requirements_ref",
+          "source_images",
+          "confirmation_ref",
+          "view_specs",
+          "output_role"
+        ],
+        "properties": {
+          "schema": {
+            "const": "image.task.v1"
+          },
+          "purpose": {
+            "enum": [
+              "concept",
+              "spatial_views"
+            ]
+          },
+          "requirements_ref": {
+            "description": "不可变对象引用：id 固定一条谱系，version 固定其中一个版本，digest 是该版本内容的摘要。设计里写的 ref@version 指的就是这个对象；摘要用来区分同版本号下内容不同的对象（例如同一需求修订下重画的图）。",
+            "type": "object",
+            "required": [
+              "id",
+              "version",
+              "digest"
+            ],
+            "properties": {
+              "id": {
+                "description": "稳定标识符：字母或数字开头，可含 _ . : -，最长 128。与硬件选型、Studio 回执现有的标识符规则相同；不含 @（@ 留给 id@version 的写法）。",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"
+              },
+              "version": {
+                "description": "对象版本号，按字符串比较相等，不比较大小（例如 \"7\"、\"r-1a2b3c4d5e6f\"）。",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$"
+              },
+              "digest": {
+                "description": "sha256 小写十六进制（64 位，不带 sha256: 前缀）。对 JSON 值一律取 harness scripts/web/common.mjs 的 digest()，即对 canonical()（键排序、无空白）后的字节求 sha256。",
+                "type": "string",
+                "pattern": "^[0-9a-f]{64}$"
+              }
+            },
+            "additionalProperties": false
+          },
+          "source_images": {
+            "type": "array",
+            "maxItems": 8,
+            "items": {
+              "description": "不可变对象引用：id 固定一条谱系，version 固定其中一个版本，digest 是该版本内容的摘要。设计里写的 ref@version 指的就是这个对象；摘要用来区分同版本号下内容不同的对象（例如同一需求修订下重画的图）。",
+              "type": "object",
+              "required": [
+                "id",
+                "version",
+                "digest"
+              ],
+              "properties": {
+                "id": {
+                  "description": "稳定标识符：字母或数字开头，可含 _ . : -，最长 128。与硬件选型、Studio 回执现有的标识符规则相同；不含 @（@ 留给 id@version 的写法）。",
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"
+                },
+                "version": {
+                  "description": "对象版本号，按字符串比较相等，不比较大小（例如 \"7\"、\"r-1a2b3c4d5e6f\"）。",
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$"
+                },
+                "digest": {
+                  "description": "sha256 小写十六进制（64 位，不带 sha256: 前缀）。对 JSON 值一律取 harness scripts/web/common.mjs 的 digest()，即对 canonical()（键排序、无空白）后的字节求 sha256。",
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$"
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "confirmation_ref": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "description": "不可变对象引用：id 固定一条谱系，version 固定其中一个版本，digest 是该版本内容的摘要。设计里写的 ref@version 指的就是这个对象；摘要用来区分同版本号下内容不同的对象（例如同一需求修订下重画的图）。",
+                "type": "object",
+                "required": [
+                  "id",
+                  "version",
+                  "digest"
+                ],
+                "properties": {
+                  "id": {
+                    "description": "稳定标识符：字母或数字开头，可含 _ . : -，最长 128。与硬件选型、Studio 回执现有的标识符规则相同；不含 @（@ 留给 id@version 的写法）。",
+                    "type": "string",
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"
+                  },
+                  "version": {
+                    "description": "对象版本号，按字符串比较相等，不比较大小（例如 \"7\"、\"r-1a2b3c4d5e6f\"）。",
+                    "type": "string",
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$"
+                  },
+                  "digest": {
+                    "description": "sha256 小写十六进制（64 位，不带 sha256: 前缀）。对 JSON 值一律取 harness scripts/web/common.mjs 的 digest()，即对 canonical()（键排序、无空白）后的字节求 sha256。",
+                    "type": "string",
+                    "pattern": "^[0-9a-f]{64}$"
+                  }
+                },
+                "additionalProperties": false
+              }
+            ]
+          },
+          "view_specs": {
+            "type": "array",
+            "maxItems": 7,
+            "items": {
+              "type": "object",
+              "required": [
+                "view_id",
+                "orientation",
+                "purpose"
+              ],
+              "properties": {
+                "view_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "orientation": {
+                  "enum": [
+                    "front",
+                    "back",
+                    "left",
+                    "right",
+                    "top",
+                    "bottom",
+                    "custom"
+                  ]
+                },
+                "purpose": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "output_role": {
+            "enum": [
+              "user_concept",
+              "internal_spatial_reference"
+            ]
+          }
+        },
         "additionalProperties": false
       },
       "output_schema": {
@@ -960,15 +1112,15 @@
     {
       "action_id": "step.tool-result",
       "contract_version": 1,
-      "definition_digest": "c72dcd86aa71d9e09b8ad57815608240ffbfdc519c942d0f7d02ac686201057d",
+      "definition_digest": "b097fa2dc29e766e86e718194ed52cdf0d9b92c0fd2e7a7beb76bddcf9013178",
       "audience": "agent",
-      "description": "按 result_id 回读本模型步骤此前的一条工具结果（同一执行实例、同一任务视图版本），按字符分页（start/length，sha256 为全文摘要）；用于取回被压缩成摘要（compacted）的结果，不回 already_read，回读的字节再次计入本步骤的读取预算",
+      "description": "按 result_id 回读本模型步骤此前的原工具结果（同一执行实例、同一任务视图）。无 pointer 时保留原全文字符分页与 sha256 校验；pointer 模式须同时提供原全文 sha256 和选中值 value_sha256，回读原值 canonical JSON 的 UTF-16 分页，不重跑原工具。读取字节再次计入本步骤预算，不回 already_read。",
       "input_schema": {
         "type": "object",
         "required": [
           "result_id"
         ],
-        "description": "本模型步骤一条工具结果的一页：result_id 取自压缩摘要（compacted 的 result_id）或此前工具结果的 tool-call 结果 ID；start/length 按 UTF-16 字符分页，sha256 给出时须与全文摘要一致",
+        "description": "本模型步骤的原工具结果回读。无 pointer 时保持原全文 UTF-16 分页；可选 sha256 校验原工具消息 UTF-8 全文。指定 pointer（RFC 6901，空串为根）时必须同时给 sha256 与 value_sha256：前者绑定原全文，后者绑定选中原值的 canonical JSON UTF-8 摘要；分页针对该 canonical JSON，不重新执行工具、不跨执行实例或视图。",
         "properties": {
           "result_id": {
             "type": "string",
@@ -985,17 +1137,38 @@
           },
           "sha256": {
             "type": "string",
-            "pattern": "^[0-9a-f]{64}$"
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "原工具消息完整原文的 UTF-8 SHA-256；pointer 模式必填。"
+          },
+          "pointer": {
+            "type": "string",
+            "pattern": "^(?:/(?:[^~/]|~[01])*)*$(?![\\s\\S])",
+            "description": "严格 RFC 6901 JSON Pointer；空串选根，~0/~1 分别表示 ~ 与 /。仅选择已归档原 JSON 值。"
+          },
+          "value_sha256": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "选中值 canonical JSON 的 UTF-8 SHA-256；不是原工具全文摘要，也不是本页摘要。"
           }
         },
-        "additionalProperties": false
+        "additionalProperties": false,
+        "dependentRequired": {
+          "pointer": [
+            "sha256",
+            "value_sha256"
+          ],
+          "value_sha256": [
+            "pointer",
+            "sha256"
+          ]
+        }
       },
       "output_schema": {
         "type": "object",
         "required": [
           "ok"
         ],
-        "description": "工具结果原文的一段：content 是模型当时收到的工具消息正文（JSON 文本）从 start 到 end 的字符，sha256 是全文 UTF-8 摘要，next 为下一页起点；ok 为 false 时 error 带错误码",
+        "description": "无 pointer 的旧调用原样回原工具消息 UTF-16 分页。pointer 模式回选中值 canonical JSON 的 UTF-16 分页：pointer 回显定位，sha256 与 source_sha256 均为原工具消息全文摘要，value_sha256 为选中值完整 canonical JSON 摘要；bytes/totalCharacters/start/end/content/next 针对选中值序列化文本。原文和摘要由宿主校验，不重跑工具。",
         "properties": {
           "ok": {
             "type": "boolean"
@@ -1041,8 +1214,110 @@
           },
           "error": {
             "type": "object"
+          },
+          "pointer": {
+            "type": "string",
+            "pattern": "^(?:/(?:[^~/]|~[01])*)*$(?![\\s\\S])",
+            "description": "严格 RFC 6901 JSON Pointer；空串选根，~0/~1 分别表示 ~ 与 /。仅选择已归档原 JSON 值。"
+          },
+          "source_sha256": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "原工具消息完整原文的 UTF-8 SHA-256，与 sha256 相同；仅 pointer 模式返回。"
+          },
+          "value_sha256": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "选中值完整 canonical JSON 的 UTF-8 SHA-256；不是分页片段的摘要。"
+          },
+          "archive_references": {
+            "type": "array",
+            "description": "仅 pointer 模式可选：选中原值内已验证旧引用的位置及同 journal 归档目标。content 保持原值，映射不代表跨 scope/step/view 权限。",
+            "items": {
+              "type": "object",
+              "required": [
+                "at",
+                "result_id",
+                "sha256",
+                "pointer",
+                "value_sha256"
+              ],
+              "properties": {
+                "at": {
+                  "type": "string",
+                  "pattern": "^(?:/(?:[^~/]|~[01])*)*$(?![\\s\\S])",
+                  "description": "选中值内旧引用 marker 的相对 JSON Pointer；空串表示选中值本身就是 marker。"
+                },
+                "result_id": {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$",
+                  "description": "同一 journal 中引用目标原结果的身份。"
+                },
+                "sha256": {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$",
+                  "description": "目标原工具消息完整原文 UTF-8 SHA-256。"
+                },
+                "pointer": {
+                  "type": "string",
+                  "pattern": "^(?:/(?:[^~/]|~[01])*)*$(?![\\s\\S])",
+                  "description": "严格 RFC 6901 JSON Pointer；空串选根，~0/~1 分别表示 ~ 与 /。仅选择已归档原 JSON 值。"
+                },
+                "value_sha256": {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$",
+                  "description": "目标值 canonical JSON 的 UTF-8 SHA-256。"
+                }
+              },
+              "additionalProperties": false
+            }
           }
-        }
+        },
+        "dependentRequired": {
+          "pointer": [
+            "result_id",
+            "action_id",
+            "format",
+            "sha256",
+            "source_sha256",
+            "value_sha256",
+            "bytes",
+            "totalCharacters",
+            "start",
+            "end",
+            "complete",
+            "content",
+            "next"
+          ],
+          "source_sha256": [
+            "pointer",
+            "value_sha256"
+          ],
+          "value_sha256": [
+            "pointer",
+            "source_sha256"
+          ],
+          "archive_references": [
+            "pointer"
+          ]
+        },
+        "allOf": [
+          {
+            "if": {
+              "required": [
+                "pointer"
+              ]
+            },
+            "then": {
+              "properties": {
+                "sha256": {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$"
+                }
+              }
+            }
+          }
+        ]
       }
     },
     {
@@ -10656,8 +10931,8 @@
     {
       "tool": "harness_image_generate",
       "action_id": "image.generate",
-      "contract_version": 1,
-      "definition_digest": "5197e044ce3b5ba45cc204f35a6138addb9f62f8589ea532818ca1ce7b0b4743",
+      "contract_version": 2,
+      "definition_digest": "d3dab05bac6e752a1ab4d03329b52e38e227214f33086a44df849b0d52fb02c1",
       "transport": "studio_tool",
       "implementation_id": "web-host.harness_image_generate",
       "input_owner": "action",
@@ -10666,7 +10941,158 @@
       "required": [],
       "input_schema": {
         "type": "object",
-        "properties": {},
+        "required": [
+          "schema",
+          "purpose",
+          "requirements_ref",
+          "source_images",
+          "confirmation_ref",
+          "view_specs",
+          "output_role"
+        ],
+        "properties": {
+          "schema": {
+            "const": "image.task.v1"
+          },
+          "purpose": {
+            "enum": [
+              "concept",
+              "spatial_views"
+            ]
+          },
+          "requirements_ref": {
+            "description": "不可变对象引用：id 固定一条谱系，version 固定其中一个版本，digest 是该版本内容的摘要。设计里写的 ref@version 指的就是这个对象；摘要用来区分同版本号下内容不同的对象（例如同一需求修订下重画的图）。",
+            "type": "object",
+            "required": [
+              "id",
+              "version",
+              "digest"
+            ],
+            "properties": {
+              "id": {
+                "description": "稳定标识符：字母或数字开头，可含 _ . : -，最长 128。与硬件选型、Studio 回执现有的标识符规则相同；不含 @（@ 留给 id@version 的写法）。",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"
+              },
+              "version": {
+                "description": "对象版本号，按字符串比较相等，不比较大小（例如 \"7\"、\"r-1a2b3c4d5e6f\"）。",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$"
+              },
+              "digest": {
+                "description": "sha256 小写十六进制（64 位，不带 sha256: 前缀）。对 JSON 值一律取 harness scripts/web/common.mjs 的 digest()，即对 canonical()（键排序、无空白）后的字节求 sha256。",
+                "type": "string",
+                "pattern": "^[0-9a-f]{64}$"
+              }
+            },
+            "additionalProperties": false
+          },
+          "source_images": {
+            "type": "array",
+            "maxItems": 8,
+            "items": {
+              "description": "不可变对象引用：id 固定一条谱系，version 固定其中一个版本，digest 是该版本内容的摘要。设计里写的 ref@version 指的就是这个对象；摘要用来区分同版本号下内容不同的对象（例如同一需求修订下重画的图）。",
+              "type": "object",
+              "required": [
+                "id",
+                "version",
+                "digest"
+              ],
+              "properties": {
+                "id": {
+                  "description": "稳定标识符：字母或数字开头，可含 _ . : -，最长 128。与硬件选型、Studio 回执现有的标识符规则相同；不含 @（@ 留给 id@version 的写法）。",
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"
+                },
+                "version": {
+                  "description": "对象版本号，按字符串比较相等，不比较大小（例如 \"7\"、\"r-1a2b3c4d5e6f\"）。",
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$"
+                },
+                "digest": {
+                  "description": "sha256 小写十六进制（64 位，不带 sha256: 前缀）。对 JSON 值一律取 harness scripts/web/common.mjs 的 digest()，即对 canonical()（键排序、无空白）后的字节求 sha256。",
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$"
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "confirmation_ref": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "description": "不可变对象引用：id 固定一条谱系，version 固定其中一个版本，digest 是该版本内容的摘要。设计里写的 ref@version 指的就是这个对象；摘要用来区分同版本号下内容不同的对象（例如同一需求修订下重画的图）。",
+                "type": "object",
+                "required": [
+                  "id",
+                  "version",
+                  "digest"
+                ],
+                "properties": {
+                  "id": {
+                    "description": "稳定标识符：字母或数字开头，可含 _ . : -，最长 128。与硬件选型、Studio 回执现有的标识符规则相同；不含 @（@ 留给 id@version 的写法）。",
+                    "type": "string",
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"
+                  },
+                  "version": {
+                    "description": "对象版本号，按字符串比较相等，不比较大小（例如 \"7\"、\"r-1a2b3c4d5e6f\"）。",
+                    "type": "string",
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$"
+                  },
+                  "digest": {
+                    "description": "sha256 小写十六进制（64 位，不带 sha256: 前缀）。对 JSON 值一律取 harness scripts/web/common.mjs 的 digest()，即对 canonical()（键排序、无空白）后的字节求 sha256。",
+                    "type": "string",
+                    "pattern": "^[0-9a-f]{64}$"
+                  }
+                },
+                "additionalProperties": false
+              }
+            ]
+          },
+          "view_specs": {
+            "type": "array",
+            "maxItems": 7,
+            "items": {
+              "type": "object",
+              "required": [
+                "view_id",
+                "orientation",
+                "purpose"
+              ],
+              "properties": {
+                "view_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "orientation": {
+                  "enum": [
+                    "front",
+                    "back",
+                    "left",
+                    "right",
+                    "top",
+                    "bottom",
+                    "custom"
+                  ]
+                },
+                "purpose": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "output_role": {
+            "enum": [
+              "user_concept",
+              "internal_spatial_reference"
+            ]
+          }
+        },
         "additionalProperties": false
       }
     },
@@ -10691,7 +11117,7 @@
       "tool": "harness_step_tool_result",
       "action_id": "step.tool-result",
       "contract_version": 1,
-      "definition_digest": "c72dcd86aa71d9e09b8ad57815608240ffbfdc519c942d0f7d02ac686201057d",
+      "definition_digest": "b097fa2dc29e766e86e718194ed52cdf0d9b92c0fd2e7a7beb76bddcf9013178",
       "transport": "studio_tool",
       "implementation_id": "web-host.harness_step_tool_result",
       "input_owner": "action",
@@ -10719,10 +11145,31 @@
           },
           "sha256": {
             "type": "string",
-            "pattern": "^[0-9a-f]{64}$"
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "原工具消息完整原文的 UTF-8 SHA-256；pointer 模式必填。"
+          },
+          "pointer": {
+            "type": "string",
+            "pattern": "^(?:/(?:[^~/]|~[01])*)*$(?![\\s\\S])",
+            "description": "严格 RFC 6901 JSON Pointer；空串选根，~0/~1 分别表示 ~ 与 /。仅选择已归档原 JSON 值。"
+          },
+          "value_sha256": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$",
+            "description": "选中值 canonical JSON 的 UTF-8 SHA-256；不是原工具全文摘要，也不是本页摘要。"
           }
         },
-        "additionalProperties": false
+        "additionalProperties": false,
+        "dependentRequired": {
+          "pointer": [
+            "sha256",
+            "value_sha256"
+          ],
+          "value_sha256": [
+            "pointer",
+            "sha256"
+          ]
+        }
       }
     },
     {