@harness-control/protocol 0.4.9 → 0.4.11

package/fixtures/mcp-review.json

@@ -1,20 +1,20 @@
-[
-  {
-    "action_json": "{\"kind\":\"mcp_tool\",\"attachment_name\":\"server\",\"tool_name\":\"write\",\"arguments\":{\"text\":\"é🙂\"}}",
-    "valid": true,
-    "sha256": "f56beacaa38c8377403c751206b8c1998b45d6cc9a146d84c3e1ede2652ce7c4"
-  },
-  {
-    "action_json": "{\"kind\":\"mcp_tool\",\"attachment_name\":\"server\",\"tool_name\":\"write\",\"arguments\":{}}",
-    "valid": true,
-    "sha256": "3a571ac3eec173ae039bedda0a3c015b7e3577af92efce1b6c1b6949d06cf8c0"
-  },
-  {
-    "action_json": "{\"kind\":\"mcp_tool\",\"attachment_name\":\"\",\"tool_name\":\"write\",\"arguments\":{}}",
-    "valid": false
-  },
-  {
-    "action_json": "{}",
-    "valid": false
-  }
-]
+[
+  {
+    "action_json": "{\"kind\":\"mcp_tool\",\"attachment_name\":\"server\",\"tool_name\":\"write\",\"arguments\":{\"text\":\"é🙂\"}}",
+    "valid": true,
+    "sha256": "f56beacaa38c8377403c751206b8c1998b45d6cc9a146d84c3e1ede2652ce7c4"
+  },
+  {
+    "action_json": "{\"kind\":\"mcp_tool\",\"attachment_name\":\"server\",\"tool_name\":\"write\",\"arguments\":{}}",
+    "valid": true,
+    "sha256": "3a571ac3eec173ae039bedda0a3c015b7e3577af92efce1b6c1b6949d06cf8c0"
+  },
+  {
+    "action_json": "{\"kind\":\"mcp_tool\",\"attachment_name\":\"\",\"tool_name\":\"write\",\"arguments\":{}}",
+    "valid": false
+  },
+  {
+    "action_json": "{}",
+    "valid": false
+  }
+]

package/package.json

@@ -1,68 +1,68 @@
-{
-  "name": "@harness-control/protocol",
-  "version": "0.4.9",
-  "license": "Apache-2.0",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "hcp-protocol-conformance": "./dist/bin/conformance.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./conformance": {
-      "types": "./dist/conformance.d.ts",
-      "import": "./dist/conformance.js"
-    },
-    "./json-schema": {
-      "types": "./dist/json-schema.d.ts",
-      "import": "./dist/json-schema.js"
-    },
-    "./schema.json": {
-      "default": "./schemas/hcp-message.schema.json"
-    },
-    "./package.json": "./package.json",
-    "./mcp-review.json": {
-      "default": "./schemas/mcp-review.json"
-    },
-    "./mcp-review-fixtures.json": {
-      "default": "./fixtures/mcp-review.json"
-    }
-  },
-  "scripts": {
-    "build": "tsc -b && npm run schema:generate",
-    "check": "tsc -b --pretty false",
-    "conformance": "tsx src/bin/conformance.ts --fixtures fixtures/conformance",
-    "schema:generate": "tsx src/bin/generate-json-schema.ts",
-    "test": "tsx --test src/**/*.test.ts test/**/*.test.ts"
-  },
-  "dependencies": {
-    "zod": "4.4.3"
-  },
-  "description": "Types, validation, JSON Schema and reducers for Harness Control Protocol",
-  "engines": {
-    "node": ">=22"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/qazisaad/harness-control-protocol.git",
-    "directory": "packages/hcp-protocol"
-  },
-  "files": [
-    "dist",
-    "!dist/**/*.test.*",
-    "!dist/**/test/**",
-    "!dist/**/*.map",
-    "README.md",
-    "LICENSE",
-    "schemas",
-    "fixtures/conformance",
-    "fixtures/mcp-review.json"
-  ]
-}
+{
+  "name": "@harness-control/protocol",
+  "version": "0.4.11",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "hcp-protocol-conformance": "./dist/bin/conformance.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./conformance": {
+      "types": "./dist/conformance.d.ts",
+      "import": "./dist/conformance.js"
+    },
+    "./json-schema": {
+      "types": "./dist/json-schema.d.ts",
+      "import": "./dist/json-schema.js"
+    },
+    "./schema.json": {
+      "default": "./schemas/hcp-message.schema.json"
+    },
+    "./package.json": "./package.json",
+    "./mcp-review.json": {
+      "default": "./schemas/mcp-review.json"
+    },
+    "./mcp-review-fixtures.json": {
+      "default": "./fixtures/mcp-review.json"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b && npm run schema:generate",
+    "check": "tsc -b --pretty false",
+    "conformance": "tsx src/bin/conformance.ts --fixtures fixtures/conformance",
+    "schema:generate": "tsx src/bin/generate-json-schema.ts",
+    "test": "tsx --test src/**/*.test.ts test/**/*.test.ts"
+  },
+  "dependencies": {
+    "zod": "4.4.3"
+  },
+  "description": "Types, validation, JSON Schema and reducers for Harness Control Protocol",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qazisaad/harness-control-protocol.git",
+    "directory": "packages/hcp-protocol"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/test/**",
+    "!dist/**/*.map",
+    "README.md",
+    "LICENSE",
+    "schemas",
+    "fixtures/conformance",
+    "fixtures/mcp-review.json"
+  ]
+}

package/schemas/hcp-message.schema.json

@@ -1,6 +1,238 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "type": "string",
+          "const": "harness.conversation.request"
+        },
+        "version": {
+          "type": "string",
+          "const": "hcp.v0"
+        },
+        "sent_at": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+        },
+        "payload": {
+          "type": "object",
+          "properties": {
+            "session_id": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 512
+            },
+            "operation": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "read"
+                    }
+                  },
+                  "required": [
+                    "kind"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "rollback"
+                    },
+                    "num_turns": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 100
+                    },
+                    "expected_history_hash": {
+                      "type": "string",
+                      "pattern": "^[a-f0-9]{64}$"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "num_turns",
+                    "expected_history_hash"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "retire"
+                    }
+                  },
+                  "required": [
+                    "kind"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            }
+          },
+          "required": [
+            "session_id",
+            "operation"
+          ],
+          "additionalProperties": false
+        },
+        "metadata": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "id",
+        "type",
+        "version",
+        "sent_at",
+        "payload"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "type": "string",
+          "const": "harness.conversation.result"
+        },
+        "version": {
+          "type": "string",
+          "const": "hcp.v0"
+        },
+        "sent_at": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+        },
+        "payload": {
+          "type": "object",
+          "properties": {
+            "command_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "session_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "operation": {
+              "type": "string",
+              "enum": [
+                "read",
+                "rollback",
+                "retire"
+              ]
+            },
+            "filesystem_undo": {
+              "type": "boolean",
+              "const": false
+            },
+            "history": {
+              "type": "object",
+              "properties": {
+                "history_hash": {
+                  "type": "string",
+                  "pattern": "^[a-f0-9]{64}$"
+                },
+                "turn_count": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "truncated": {
+                  "type": "boolean"
+                },
+                "turns": {
+                  "maxItems": 100,
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string"
+                      },
+                      "items": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "propertyNames": {
+                            "type": "string"
+                          },
+                          "additionalProperties": {
+                            "$ref": "#/$defs/__schema0"
+                          }
+                        }
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "status",
+                      "items"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "history_hash",
+                "turn_count",
+                "truncated",
+                "turns"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "command_id",
+            "session_id",
+            "operation",
+            "filesystem_undo"
+          ],
+          "additionalProperties": false
+        },
+        "metadata": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "id",
+        "type",
+        "version",
+        "sent_at",
+        "payload"
+      ],
+      "additionalProperties": false
+    },
     {
       "type": "object",
       "properties": {
@@ -1168,6 +1400,15 @@
                       "session_continuation": {
                         "type": "boolean"
                       },
+                      "plan_mode": {
+                        "type": "boolean"
+                      },
+                      "native_history": {
+                        "type": "boolean"
+                      },
+                      "conversation_rollback": {
+                        "type": "boolean"
+                      },
                       "sandbox_modes": {
                         "type": "array",
                         "items": {
@@ -1387,6 +1628,9 @@
                                 ],
                                 "additionalProperties": false
                               }
+                            },
+                            "image_input": {
+                              "type": "boolean"
                             }
                           },
                           "required": [
@@ -2166,6 +2410,66 @@
                   }
                 ]
               }
+            },
+            "first_turn": {
+              "type": "object",
+              "properties": {
+                "turn_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "input": {
+                  "type": "string"
+                },
+                "not_after": {
+                  "type": "string",
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                },
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "execute",
+                    "plan"
+                  ]
+                },
+                "images": {
+                  "minItems": 1,
+                  "maxItems": 4,
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "mime_type": {
+                        "type": "string",
+                        "enum": [
+                          "image/gif",
+                          "image/jpeg",
+                          "image/png",
+                          "image/webp"
+                        ]
+                      },
+                      "data_base64": {
+                        "type": "string",
+                        "minLength": 4,
+                        "maxLength": 524288,
+                        "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
+                      }
+                    },
+                    "required": [
+                      "mime_type",
+                      "data_base64"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "turn_id",
+                "input",
+                "not_after"
+              ],
+              "additionalProperties": false
             }
           },
           "required": [
@@ -2609,6 +2913,43 @@
             "input": {
               "type": "string"
             },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "execute",
+                "plan"
+              ]
+            },
+            "images": {
+              "minItems": 1,
+              "maxItems": 4,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "mime_type": {
+                    "type": "string",
+                    "enum": [
+                      "image/gif",
+                      "image/jpeg",
+                      "image/png",
+                      "image/webp"
+                    ]
+                  },
+                  "data_base64": {
+                    "type": "string",
+                    "minLength": 4,
+                    "maxLength": 524288,
+                    "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
+                  }
+                },
+                "required": [
+                  "mime_type",
+                  "data_base64"
+                ],
+                "additionalProperties": false
+              }
+            },
             "model_selection": {
               "type": "object",
               "properties": {
@@ -7959,6 +8300,10 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
+                "native_conversation_ready": {
+                  "type": "boolean",
+                  "const": true
+                },
                 "local_capabilities": {
                   "type": "array",
                   "items": {
@@ -8153,6 +8498,10 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
+                "native_conversation_ready": {
+                  "type": "boolean",
+                  "const": true
+                },
                 "local_capabilities": {
                   "type": "array",
                   "items": {
@@ -8347,6 +8696,10 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
+                "native_conversation_ready": {
+                  "type": "boolean",
+                  "const": true
+                },
                 "local_capabilities": {
                   "type": "array",
                   "items": {
@@ -8541,6 +8894,10 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
+                "native_conversation_ready": {
+                  "type": "boolean",
+                  "const": true
+                },
                 "local_capabilities": {
                   "type": "array",
                   "items": {
@@ -18962,6 +19319,39 @@
       "additionalProperties": false
     }
   ],
+  "$defs": {
+    "__schema0": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema0"
+          }
+        },
+        {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/__schema0"
+          }
+        }
+      ]
+    }
+  },
   "$id": "https://schemas.harness-control.local/hcp.v0/message.schema.json",
   "title": "HCP protocol message",
   "description": "Structural JSON Schema for known hcp.v0 protocol messages. Runtime parsers enforce additional cross-field invariants such as lease-to-attribution equality."