@harness-control/protocol 0.4.10 → 0.4.11

package/dist/index.d.ts

@@ -731,8 +731,8 @@ export declare const hcpHostHeartbeatPayloadSchema: z.ZodObject<{
 export declare const localCapabilitySnapshotSchema: z.ZodObject<{
     id: z.ZodString;
     status: z.ZodEnum<{
-        unknown: "unknown";
         available: "available";
+        unknown: "unknown";
         unavailable: "unavailable";
         disabled: "disabled";
     }>;
@@ -743,8 +743,8 @@ export declare const localCapabilitySnapshotSchema: z.ZodObject<{
 export declare const providerAuthSnapshotSchema: z.ZodObject<{
     status: z.ZodEnum<{
         unknown: "unknown";
-        authenticated: "authenticated";
         unauthenticated: "unauthenticated";
+        authenticated: "authenticated";
     }>;
     type: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
@@ -836,8 +836,8 @@ export declare const harnessProviderSnapshotSchema: z.ZodObject<{
     auth: z.ZodOptional<z.ZodObject<{
         status: z.ZodEnum<{
             unknown: "unknown";
-            authenticated: "authenticated";
             unauthenticated: "unauthenticated";
+            authenticated: "authenticated";
         }>;
         type: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
@@ -1021,8 +1021,8 @@ export declare const hcpHostCapabilitiesUpdatedPayloadSchema: z.ZodObject<{
         auth: z.ZodOptional<z.ZodObject<{
             status: z.ZodEnum<{
                 unknown: "unknown";
-                authenticated: "authenticated";
                 unauthenticated: "unauthenticated";
+                authenticated: "authenticated";
             }>;
             type: z.ZodOptional<z.ZodString>;
             label: z.ZodOptional<z.ZodString>;
@@ -1074,8 +1074,8 @@ export declare const hcpHostCapabilitiesUpdatedPayloadSchema: z.ZodObject<{
     local_capabilities: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         status: z.ZodEnum<{
-            unknown: "unknown";
             available: "available";
+            unknown: "unknown";
             unavailable: "unavailable";
             disabled: "disabled";
         }>;
@@ -1385,8 +1385,8 @@ export declare const hcpSessionStartPayloadSchema: z.ZodObject<{
         input: z.ZodString;
         not_after: z.ZodString;
         mode: z.ZodOptional<z.ZodEnum<{
-            execute: "execute";
             plan: "plan";
+            execute: "execute";
         }>>;
         images: z.ZodOptional<z.ZodArray<z.ZodObject<{
             mime_type: z.ZodEnum<{
@@ -1407,8 +1407,8 @@ export declare const hcpTurnSendPayloadSchema: z.ZodObject<{
     turn_id: z.ZodString;
     input: z.ZodString;
     mode: z.ZodOptional<z.ZodEnum<{
-        execute: "execute";
         plan: "plan";
+        execute: "execute";
     }>>;
     images: z.ZodOptional<z.ZodArray<z.ZodObject<{
         mime_type: z.ZodEnum<{
@@ -1485,8 +1485,8 @@ export declare const localFilesystemReadRequestPayloadSchema: z.ZodObject<{
     input: z.ZodObject<{
         path: z.ZodString;
         encoding: z.ZodOptional<z.ZodEnum<{
-            utf8: "utf8";
             base64: "base64";
+            utf8: "utf8";
         }>>;
         range: z.ZodOptional<z.ZodObject<{
             start: z.ZodOptional<z.ZodNumber>;
@@ -1619,8 +1619,8 @@ export declare const localFilesystemWriteRequestPayloadSchema: z.ZodObject<{
         path: z.ZodString;
         content: z.ZodString;
         encoding: z.ZodOptional<z.ZodEnum<{
-            utf8: "utf8";
             base64: "base64";
+            utf8: "utf8";
         }>>;
         mode: z.ZodEnum<{
             create: "create";
@@ -2124,8 +2124,8 @@ export declare const localActionRequestPayloadSchema: z.ZodDiscriminatedUnion<[z
     input: z.ZodObject<{
         path: z.ZodString;
         encoding: z.ZodOptional<z.ZodEnum<{
-            utf8: "utf8";
             base64: "base64";
+            utf8: "utf8";
         }>>;
         range: z.ZodOptional<z.ZodObject<{
             start: z.ZodOptional<z.ZodNumber>;
@@ -2256,8 +2256,8 @@ export declare const localActionRequestPayloadSchema: z.ZodDiscriminatedUnion<[z
         path: z.ZodString;
         content: z.ZodString;
         encoding: z.ZodOptional<z.ZodEnum<{
-            utf8: "utf8";
             base64: "base64";
+            utf8: "utf8";
         }>>;
         mode: z.ZodEnum<{
             create: "create";
@@ -2748,8 +2748,8 @@ export declare const localActionResponsePayloadSchema: z.ZodDiscriminatedUnion<[
         path: z.ZodString;
         content: z.ZodString;
         encoding: z.ZodEnum<{
-            utf8: "utf8";
             base64: "base64";
+            utf8: "utf8";
         }>;
         hash: z.ZodString;
         truncated: z.ZodOptional<z.ZodBoolean>;
@@ -3503,8 +3503,8 @@ export declare const hcpHostCapabilitiesUpdatedMessageSchema: z.ZodObject<{
             auth: z.ZodOptional<z.ZodObject<{
                 status: z.ZodEnum<{
                     unknown: "unknown";
-                    authenticated: "authenticated";
                     unauthenticated: "unauthenticated";
+                    authenticated: "authenticated";
                 }>;
                 type: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
@@ -3556,8 +3556,8 @@ export declare const hcpHostCapabilitiesUpdatedMessageSchema: z.ZodObject<{
         local_capabilities: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             status: z.ZodEnum<{
-                unknown: "unknown";
                 available: "available";
+                unknown: "unknown";
                 unavailable: "unavailable";
                 disabled: "disabled";
             }>;
@@ -3705,8 +3705,8 @@ export declare const hcpSessionStartMessageSchema: z.ZodObject<{
             input: z.ZodString;
             not_after: z.ZodString;
             mode: z.ZodOptional<z.ZodEnum<{
-                execute: "execute";
                 plan: "plan";
+                execute: "execute";
             }>>;
             images: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 mime_type: z.ZodEnum<{
@@ -3811,8 +3811,8 @@ export declare const hcpTurnSendMessageSchema: z.ZodObject<{
         turn_id: z.ZodString;
         input: z.ZodString;
         mode: z.ZodOptional<z.ZodEnum<{
-            execute: "execute";
             plan: "plan";
+            execute: "execute";
         }>>;
         images: z.ZodOptional<z.ZodArray<z.ZodObject<{
             mime_type: z.ZodEnum<{
@@ -3931,8 +3931,8 @@ export declare const localActionRequestMessageSchema: z.ZodObject<{
         input: z.ZodObject<{
             path: z.ZodString;
             encoding: z.ZodOptional<z.ZodEnum<{
-                utf8: "utf8";
                 base64: "base64";
+                utf8: "utf8";
             }>>;
             range: z.ZodOptional<z.ZodObject<{
                 start: z.ZodOptional<z.ZodNumber>;
@@ -4063,8 +4063,8 @@ export declare const localActionRequestMessageSchema: z.ZodObject<{
             path: z.ZodString;
             content: z.ZodString;
             encoding: z.ZodOptional<z.ZodEnum<{
-                utf8: "utf8";
                 base64: "base64";
+                utf8: "utf8";
             }>>;
             mode: z.ZodEnum<{
                 create: "create";
@@ -4562,8 +4562,8 @@ export declare const localActionResponseMessageSchema: z.ZodObject<{
             path: z.ZodString;
             content: z.ZodString;
             encoding: z.ZodEnum<{
-                utf8: "utf8";
                 base64: "base64";
+                utf8: "utf8";
             }>;
             hash: z.ZodString;
             truncated: z.ZodOptional<z.ZodBoolean>;
@@ -5090,9 +5090,9 @@ export declare const hcpAccountsSnapshotMessageSchema: z.ZodObject<{
                     key: z.ZodString;
                     provider: z.ZodString;
                     scope_source: z.ZodEnum<{
+                        local: "local";
                         provider: "provider";
                         operator: "operator";
-                        local: "local";
                     }>;
                     label: z.ZodString;
                 }, z.core.$strict>;
@@ -5117,8 +5117,8 @@ export declare const hcpAccountsSnapshotMessageSchema: z.ZodObject<{
                 observed_at: z.ZodISODateTime;
                 reason: z.ZodEnum<{
                     disabled: "disabled";
-                    unauthenticated: "unauthenticated";
                     unsupported: "unsupported";
+                    unauthenticated: "unauthenticated";
                     not_applicable: "not_applicable";
                     timeout: "timeout";
                     provider_error: "provider_error";
@@ -5246,9 +5246,9 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     key: z.ZodString;
                     provider: z.ZodString;
                     scope_source: z.ZodEnum<{
+                        local: "local";
                         provider: "provider";
                         operator: "operator";
-                        local: "local";
                     }>;
                     label: z.ZodString;
                 }, z.core.$strict>;
@@ -5273,8 +5273,8 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 observed_at: z.ZodISODateTime;
                 reason: z.ZodEnum<{
                     disabled: "disabled";
-                    unauthenticated: "unauthenticated";
                     unsupported: "unsupported";
+                    unauthenticated: "unauthenticated";
                     not_applicable: "not_applicable";
                     timeout: "timeout";
                     provider_error: "provider_error";
@@ -5486,8 +5486,8 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             auth: z.ZodOptional<z.ZodObject<{
                 status: z.ZodEnum<{
                     unknown: "unknown";
-                    authenticated: "authenticated";
                     unauthenticated: "unauthenticated";
+                    authenticated: "authenticated";
                 }>;
                 type: z.ZodOptional<z.ZodString>;
                 label: z.ZodOptional<z.ZodString>;
@@ -5539,8 +5539,8 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         local_capabilities: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             status: z.ZodEnum<{
-                unknown: "unknown";
                 available: "available";
+                unknown: "unknown";
                 unavailable: "unavailable";
                 disabled: "disabled";
             }>;
@@ -5686,8 +5686,8 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             input: z.ZodString;
             not_after: z.ZodString;
             mode: z.ZodOptional<z.ZodEnum<{
-                execute: "execute";
                 plan: "plan";
+                execute: "execute";
             }>>;
             images: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 mime_type: z.ZodEnum<{
@@ -5789,8 +5789,8 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         turn_id: z.ZodString;
         input: z.ZodString;
         mode: z.ZodOptional<z.ZodEnum<{
-            execute: "execute";
             plan: "plan";
+            execute: "execute";
         }>>;
         images: z.ZodOptional<z.ZodArray<z.ZodObject<{
             mime_type: z.ZodEnum<{
@@ -5903,8 +5903,8 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         input: z.ZodObject<{
             path: z.ZodString;
             encoding: z.ZodOptional<z.ZodEnum<{
-                utf8: "utf8";
                 base64: "base64";
+                utf8: "utf8";
             }>>;
             range: z.ZodOptional<z.ZodObject<{
                 start: z.ZodOptional<z.ZodNumber>;
@@ -6035,8 +6035,8 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             path: z.ZodString;
             content: z.ZodString;
             encoding: z.ZodOptional<z.ZodEnum<{
-                utf8: "utf8";
                 base64: "base64";
+                utf8: "utf8";
             }>>;
             mode: z.ZodEnum<{
                 create: "create";
@@ -6533,8 +6533,8 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             path: z.ZodString;
             content: z.ZodString;
             encoding: z.ZodEnum<{
-                utf8: "utf8";
                 base64: "base64";
+                utf8: "utf8";
             }>;
             hash: z.ZodString;
             truncated: z.ZodOptional<z.ZodBoolean>;

package/fixtures/conformance/invalid/accounts-negative-quota.json

@@ -1,35 +1,35 @@
-{
-  "id": "account-fixture",
-  "version": "hcp.v0",
-  "sent_at": "2026-09-12T00:00:00Z",
-  "type": "host.accounts.snapshot",
-  "payload": {
-    "request_id": "read-1",
-    "host_id": "host-1",
-    "providers": [
-      {
-        "provider_instance_id": "codex",
-        "observation": {
-          "status": "available",
-          "observed_at": "2026-09-12T00:00:00Z",
-          "account": {
-            "key": "account-1",
-            "provider": "codex",
-            "scope_source": "operator",
-            "label": "Work"
-          },
-          "source": "codex_app_server",
-          "limits": [
-            {
-              "id": "weekly",
-              "label": "Weekly",
-              "kind": "quota",
-              "used_percent": -1,
-              "resets_at": "2026-09-19T00:00:00Z"
-            }
-          ]
-        }
-      }
-    ]
-  }
-}
+{
+  "id": "account-fixture",
+  "version": "hcp.v0",
+  "sent_at": "2026-09-12T00:00:00Z",
+  "type": "host.accounts.snapshot",
+  "payload": {
+    "request_id": "read-1",
+    "host_id": "host-1",
+    "providers": [
+      {
+        "provider_instance_id": "codex",
+        "observation": {
+          "status": "available",
+          "observed_at": "2026-09-12T00:00:00Z",
+          "account": {
+            "key": "account-1",
+            "provider": "codex",
+            "scope_source": "operator",
+            "label": "Work"
+          },
+          "source": "codex_app_server",
+          "limits": [
+            {
+              "id": "weekly",
+              "label": "Weekly",
+              "kind": "quota",
+              "used_percent": -1,
+              "resets_at": "2026-09-19T00:00:00Z"
+            }
+          ]
+        }
+      }
+    ]
+  }
+}

package/fixtures/conformance/invalid/accounts-secret.json

@@ -1,36 +1,36 @@
-{
-  "id": "account-fixture",
-  "version": "hcp.v0",
-  "sent_at": "2026-09-12T00:00:00Z",
-  "type": "host.accounts.snapshot",
-  "payload": {
-    "request_id": "read-1",
-    "host_id": "host-1",
-    "providers": [
-      {
-        "provider_instance_id": "codex",
-        "observation": {
-          "status": "available",
-          "observed_at": "2026-09-12T00:00:00Z",
-          "account": {
-            "key": "account-1",
-            "provider": "codex",
-            "scope_source": "operator",
-            "label": "Work"
-          },
-          "source": "codex_app_server",
-          "limits": [
-            {
-              "id": "weekly",
-              "label": "Weekly",
-              "kind": "quota",
-              "used_percent": 95,
-              "resets_at": "2026-09-19T00:00:00Z"
-            }
-          ]
-        }
-      }
-    ],
-    "api_key": "not-permitted"
-  }
-}
+{
+  "id": "account-fixture",
+  "version": "hcp.v0",
+  "sent_at": "2026-09-12T00:00:00Z",
+  "type": "host.accounts.snapshot",
+  "payload": {
+    "request_id": "read-1",
+    "host_id": "host-1",
+    "providers": [
+      {
+        "provider_instance_id": "codex",
+        "observation": {
+          "status": "available",
+          "observed_at": "2026-09-12T00:00:00Z",
+          "account": {
+            "key": "account-1",
+            "provider": "codex",
+            "scope_source": "operator",
+            "label": "Work"
+          },
+          "source": "codex_app_server",
+          "limits": [
+            {
+              "id": "weekly",
+              "label": "Weekly",
+              "kind": "quota",
+              "used_percent": 95,
+              "resets_at": "2026-09-19T00:00:00Z"
+            }
+          ]
+        }
+      }
+    ],
+    "api_key": "not-permitted"
+  }
+}

package/fixtures/conformance/invalid/arbitrary-event-family.json

@@ -1,13 +1,13 @@
-{
-  "id": "message-arbitrary-event-family",
-  "type": "harness.event",
-  "version": "hcp.v0",
-  "sent_at": "2026-01-01T00:00:00.000Z",
-  "payload": {
-    "session_id": "session-1",
-    "sequence": 1,
-    "event_type": "custom.raw",
-    "created_at": "2026-01-01T00:00:01.000Z",
-    "data": {}
-  }
-}
+{
+  "id": "message-arbitrary-event-family",
+  "type": "harness.event",
+  "version": "hcp.v0",
+  "sent_at": "2026-01-01T00:00:00.000Z",
+  "payload": {
+    "session_id": "session-1",
+    "sequence": 1,
+    "event_type": "custom.raw",
+    "created_at": "2026-01-01T00:00:01.000Z",
+    "data": {}
+  }
+}

package/fixtures/conformance/invalid/local-action-lease-binding-mismatch.json

@@ -1,49 +1,49 @@
-{
-  "id": "message-local-action-lease-binding-mismatch",
-  "type": "local.action.request",
-  "version": "hcp.v0",
-  "sent_at": "2026-01-01T00:00:00.000Z",
-  "payload": {
-    "request_id": "local-action-read-bad",
-    "action": "local.filesystem.read",
-    "issued_at": "2026-01-01T00:00:01.000Z",
-    "attribution": {
-      "session_id": "session-1",
-      "turn_id": "turn-1",
-      "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1"
-    },
-    "lease": {
-      "lease_id": "local-lease-read",
-      "capability_id": "git",
-      "scope": "workspace_read",
-      "hcp_session_id": "session-1",
-      "execution_host_id": "host-1",
-      "provider_instance_id": "provider-1",
-      "workspace_id": "workspace-1"
-    },
-    "sandbox": {
-      "mode": "workspace_write",
-      "workspace_root": "/tmp/workspace",
-      "cwd": "/tmp/workspace",
-      "requires_workspace_containment": true
-    },
-    "approval": {
-      "status": "not_required"
-    },
-    "output_limits": {
-      "content_bytes": 65536
-    },
-    "cancellation": {
-      "cancellable": false
-    },
-    "audit": {
-      "started_event_type": "local_capability.action.started",
-      "completed_event_type": "local_capability.action.completed",
-      "failed_event_type": "local_capability.action.failed"
-    },
-    "input": {
-      "path": "README.md"
-    }
-  }
-}
+{
+  "id": "message-local-action-lease-binding-mismatch",
+  "type": "local.action.request",
+  "version": "hcp.v0",
+  "sent_at": "2026-01-01T00:00:00.000Z",
+  "payload": {
+    "request_id": "local-action-read-bad",
+    "action": "local.filesystem.read",
+    "issued_at": "2026-01-01T00:00:01.000Z",
+    "attribution": {
+      "session_id": "session-1",
+      "turn_id": "turn-1",
+      "workspace_id": "workspace-1",
+      "provider_instance_id": "provider-1"
+    },
+    "lease": {
+      "lease_id": "local-lease-read",
+      "capability_id": "git",
+      "scope": "workspace_read",
+      "hcp_session_id": "session-1",
+      "execution_host_id": "host-1",
+      "provider_instance_id": "provider-1",
+      "workspace_id": "workspace-1"
+    },
+    "sandbox": {
+      "mode": "workspace_write",
+      "workspace_root": "/tmp/workspace",
+      "cwd": "/tmp/workspace",
+      "requires_workspace_containment": true
+    },
+    "approval": {
+      "status": "not_required"
+    },
+    "output_limits": {
+      "content_bytes": 65536
+    },
+    "cancellation": {
+      "cancellable": false
+    },
+    "audit": {
+      "started_event_type": "local_capability.action.started",
+      "completed_event_type": "local_capability.action.completed",
+      "failed_event_type": "local_capability.action.failed"
+    },
+    "input": {
+      "path": "README.md"
+    }
+  }
+}

package/fixtures/conformance/invalid/local-action-missing-turn-id.json

@@ -1,20 +1,20 @@
-{
-  "id": "message-local-action-missing-turn-id",
-  "type": "harness.event",
-  "version": "hcp.v0",
-  "sent_at": "2026-01-01T00:00:00.000Z",
-  "payload": {
-    "session_id": "session-1",
-    "sequence": 1,
-    "event_type": "local_capability.action.started",
-    "created_at": "2026-01-01T00:00:01.000Z",
-    "data": {
-      "lease_id": "local-lease-1",
-      "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "capability_id": "filesystem",
-      "action": "read_file",
-      "status": "started"
-    }
-  }
-}
+{
+  "id": "message-local-action-missing-turn-id",
+  "type": "harness.event",
+  "version": "hcp.v0",
+  "sent_at": "2026-01-01T00:00:00.000Z",
+  "payload": {
+    "session_id": "session-1",
+    "sequence": 1,
+    "event_type": "local_capability.action.started",
+    "created_at": "2026-01-01T00:00:01.000Z",
+    "data": {
+      "lease_id": "local-lease-1",
+      "workspace_id": "workspace-1",
+      "provider_instance_id": "provider-1",
+      "capability_id": "filesystem",
+      "action": "read_file",
+      "status": "started"
+    }
+  }
+}