npm - @harness-control/protocol - Versions diffs - 0.2.0 → 0.4.0 - Mend

@harness-control/protocol 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/dist/index.js CHANGED Viewed

@@ -1,9 +1,13 @@
+import { hcpAccountsReadPayloadSchema, hcpAccountsSnapshotPayloadSchema } from "./accounts.js";
+export * from "./accounts.js";
 import { z } from "zod";
 export const HCP_VERSION = "hcp.v0";
 export const HCP_METADATA_MAX_ENCODED_BYTES = 16 * 1024;
 export const HCP_PAYLOAD_MAX_ENCODED_BYTES = 1024 * 1024;
 export const HCP_MESSAGE_MAX_ENCODED_BYTES = HCP_METADATA_MAX_ENCODED_BYTES + HCP_PAYLOAD_MAX_ENCODED_BYTES + 64 * 1024;
 export const HOST_LIFECYCLE_MESSAGE_TYPES = [
+    "host.accounts.read",
+    "host.accounts.snapshot",
     "host.hello",
     "host.accepted",
     "host.rejected",
@@ -325,9 +329,11 @@ export const hcpMcpStdioProfileSnapshotSchema = z
 export const hcpWorkspaceManagementSchema = z.object({
     revision: z.string().min(1).max(100),
     allowed_roots: z.array(z.string().min(1).max(4096)).max(32),
+    directory_browsing: z.literal(true).optional(),
 }).strict();
 export const hcpWorkspaceOperationSchema = z.discriminatedUnion("kind", [
     z.object({ kind: z.literal("list") }).strict(),
+    z.object({ kind: z.literal("browse"), path: z.string().min(1).max(4096).optional(), cursor: z.string().min(1).max(4096).optional() }).strict(),
     z.object({ kind: z.literal("add"), path: z.string().min(1).max(4096), display_name: z.string().trim().min(1).max(100) }).strict(),
     z.object({ kind: z.literal("rename"), id: z.string().min(1).max(200), display_name: z.string().trim().min(1).max(100) }).strict(),
     z.object({ kind: z.literal("remove"), id: z.string().min(1).max(200) }).strict(),
@@ -341,6 +347,10 @@ export const hcpWorkspacesResultPayloadSchema = z.object({
     request_id: nonEmptyStringSchema,
     outcome: z.discriminatedUnion("kind", [
         z.object({ kind: z.literal("success") }).strict(),
+        z.object({ kind: z.literal("directory"), path: z.string().min(1).max(4096), parent: z.string().min(1).max(4096).optional(),
+            entries: z.array(z.object({ name: z.string().min(1).max(4096), path: z.string().min(1).max(4096) }).strict()).max(200),
+            next_cursor: z.string().min(1).max(4096).optional(),
+        }).strict(),
         z.object({ kind: z.literal("error"), message: z.string().min(1).max(1000) }).strict(),
     ]),
     management: hcpWorkspaceManagementSchema,
@@ -435,11 +445,7 @@ export const localCapabilityGrantSchema = z
 export const localCapabilityLeaseSchema = z
     .object({
     lease_id: nonEmptyStringSchema,
-    org_id: nonEmptyStringSchema,
     actor_id: nonEmptyStringSchema.optional(),
-    workflow_id: nonEmptyStringSchema,
-    run_id: nonEmptyStringSchema,
-    node_id: nonEmptyStringSchema,
     hcp_session_id: nonEmptyStringSchema,
     execution_host_id: nonEmptyStringSchema,
     provider_instance_id: nonEmptyStringSchema,
@@ -583,7 +589,6 @@ const localActionAttributionSchema = z
     turn_id: nonEmptyStringSchema,
     workspace_id: nonEmptyStringSchema,
     provider_instance_id: nonEmptyStringSchema,
-    run_id: nonEmptyStringSchema,
 })
     .strict();
 const localActionLeaseBindingSchema = z
@@ -591,7 +596,6 @@ const localActionLeaseBindingSchema = z
     lease_id: nonEmptyStringSchema,
     capability_id: localActionProtocolCapabilityIdSchema,
     scope: nonEmptyStringSchema,
-    run_id: nonEmptyStringSchema,
     hcp_session_id: nonEmptyStringSchema,
     execution_host_id: nonEmptyStringSchema,
     provider_instance_id: nonEmptyStringSchema,
@@ -1124,9 +1128,6 @@ function refineLocalActionContract(payload, context) {
     if (payload.attribution.provider_instance_id !== payload.lease.provider_instance_id) {
         addLocalActionIssue(context, ["lease", "provider_instance_id"], "Local action lease provider must match request attribution.");
     }
-    if (payload.attribution.run_id !== payload.lease.run_id) {
-        addLocalActionIssue(context, ["lease", "run_id"], "Local action lease run must match request attribution.");
-    }
     const expectedBinding = localActionExpectedBinding(payload.action);
     if (payload.lease.capability_id !== expectedBinding.capabilityId) {
         addLocalActionIssue(context, ["lease", "capability_id"], `Action '${payload.action}' must use the ${expectedBinding.capabilityId} capability.`);
@@ -1387,7 +1388,6 @@ const localCapabilityLeaseEventDataSchema = z
 const localCapabilityActionEventDataSchema = z
     .object({
     lease_id: nonEmptyStringSchema,
-    run_id: nonEmptyStringSchema,
     workspace_id: nonEmptyStringSchema,
     provider_instance_id: nonEmptyStringSchema,
     capability_id: nonEmptyStringSchema,
@@ -1830,7 +1830,11 @@ export const localActionErrorMessageSchema = hcpTypedEnvelopeSchema("local.actio
 export const hcpHarnessEventMessageSchema = hcpTypedEnvelopeSchema("harness.event", hcpHarnessEventPayloadSchema);
 export const hcpWorkspacesRequestMessageSchema = hcpTypedEnvelopeSchema("host.workspaces.request", hcpWorkspacesRequestPayloadSchema);
 export const hcpWorkspacesResultMessageSchema = hcpTypedEnvelopeSchema("host.workspaces.result", hcpWorkspacesResultPayloadSchema);
+export const hcpAccountsReadMessageSchema = hcpTypedEnvelopeSchema("host.accounts.read", hcpAccountsReadPayloadSchema);
+export const hcpAccountsSnapshotMessageSchema = hcpTypedEnvelopeSchema("host.accounts.snapshot", hcpAccountsSnapshotPayloadSchema);
 export const hcpMessageSchema = z.discriminatedUnion("type", [
+    hcpAccountsReadMessageSchema,
+    hcpAccountsSnapshotMessageSchema,
     hcpWorkspacesRequestMessageSchema,
     hcpWorkspacesResultMessageSchema,
     hcpCommandAckMessageSchema,

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

@@ -0,0 +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"
+            }
+          ]
+        }
+      }
+    ]
+  }
+}

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

@@ -0,0 +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"
+  }
+}

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

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-read",
       "capability_id": "git",
       "scope": "workspace_read",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

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

@@ -10,7 +10,6 @@
     "created_at": "2026-01-01T00:00:01.000Z",
     "data": {
       "lease_id": "local-lease-1",
-      "run_id": "run-1",
       "workspace_id": "workspace-1",
       "provider_instance_id": "provider-1",
       "capability_id": "filesystem",

package/fixtures/conformance/invalid/local-action-patch-missing-base-hash.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-patch",
       "capability_id": "filesystem",
       "scope": "workspace_write",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

package/fixtures/conformance/invalid/local-action-shell-missing-approval.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-shell",
       "capability_id": "shell",
       "scope": "workspace",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",
@@ -48,7 +46,9 @@
     },
     "input": {
       "executable": "npm",
-      "argv": ["test"],
+      "argv": [
+        "test"
+      ],
       "cwd": "/tmp/workspace",
       "use_shell": false
     }

package/fixtures/conformance/valid/accounts-read.json ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "id": "account-fixture",
+  "version": "hcp.v0",
+  "sent_at": "2026-09-12T00:00:00Z",
+  "type": "host.accounts.read",
+  "payload": {
+    "provider_instance_ids": [
+      "codex"
+    ]
+  }
+}

package/fixtures/conformance/valid/accounts-snapshot.json ADDED Viewed

@@ -0,0 +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": 95,
+              "resets_at": "2026-09-19T00:00:00Z"
+            }
+          ]
+        }
+      }
+    ]
+  }
+}

package/fixtures/conformance/valid/accounts-unavailable.json ADDED Viewed

@@ -0,0 +1,21 @@
+{
+  "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": "claude",
+        "observation": {
+          "status": "unavailable",
+          "observed_at": "2026-09-12T00:00:00Z",
+          "reason": "unsupported",
+          "message": "Opt-in required."
+        }
+      }
+    ]
+  }
+}

package/fixtures/conformance/valid/local-action-dev-server-start.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-dev-server",
       "capability_id": "dev_server",
       "scope": "workspace",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",
@@ -53,7 +51,10 @@
     "input": {
       "server_id": "web",
       "executable": "npm",
-      "argv": ["run", "dev"],
+      "argv": [
+        "run",
+        "dev"
+      ],
       "cwd": "/tmp/workspace",
       "host": "127.0.0.1",
       "port": 3000,

package/fixtures/conformance/valid/local-action-dev-server-stop.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-dev-server",
       "capability_id": "dev_server",
       "scope": "workspace",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

package/fixtures/conformance/valid/local-action-error.json CHANGED Viewed

@@ -12,14 +12,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-patch",
       "capability_id": "filesystem",
       "scope": "workspace_write",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

package/fixtures/conformance/valid/local-action-filesystem-list.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-list",
       "capability_id": "filesystem",
       "scope": "workspace_read",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

package/fixtures/conformance/valid/local-action-filesystem-patch.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-patch",
       "capability_id": "filesystem",
       "scope": "workspace_write",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

package/fixtures/conformance/valid/local-action-filesystem-read.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-read",
       "capability_id": "filesystem",
       "scope": "workspace_read",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

package/fixtures/conformance/valid/local-action-filesystem-write.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-write",
       "capability_id": "filesystem",
       "scope": "workspace_write",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

package/fixtures/conformance/valid/local-action-git-diff.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-git-diff",
       "capability_id": "git",
       "scope": "workspace_read",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",
@@ -46,7 +44,9 @@
       "failed_event_type": "local_capability.action.failed"
     },
     "input": {
-      "paths": ["README.md"],
+      "paths": [
+        "README.md"
+      ],
       "staged": false
     }
   }

package/fixtures/conformance/valid/local-action-git-status.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-git-status",
       "capability_id": "git",
       "scope": "workspace_read",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",

package/fixtures/conformance/valid/local-action-response.json CHANGED Viewed

@@ -12,14 +12,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-shell",
       "capability_id": "shell",
       "scope": "workspace",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",
@@ -27,7 +25,9 @@
     },
     "output": {
       "executable": "npm",
-      "argv": ["test"],
+      "argv": [
+        "test"
+      ],
       "cwd": "/tmp/workspace",
       "exit_code": 0,
       "signal": null,

package/fixtures/conformance/valid/local-action-shell-exec.json CHANGED Viewed

@@ -11,14 +11,12 @@
       "session_id": "session-1",
       "turn_id": "turn-1",
       "workspace_id": "workspace-1",
-      "provider_instance_id": "provider-1",
-      "run_id": "run-1"
+      "provider_instance_id": "provider-1"
     },
     "lease": {
       "lease_id": "local-lease-shell",
       "capability_id": "shell",
       "scope": "workspace",
-      "run_id": "run-1",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-1",
       "provider_instance_id": "provider-1",
@@ -55,7 +53,9 @@
     },
     "input": {
       "executable": "npm",
-      "argv": ["test"],
+      "argv": [
+        "test"
+      ],
       "cwd": "/tmp/workspace",
       "use_shell": false
     }

package/fixtures/conformance/valid/session-start-with-leases.json CHANGED Viewed

@@ -22,11 +22,7 @@
     },
     "local_capability_lease": {
       "lease_id": "local-lease-1",
-      "org_id": "org-1",
       "actor_id": "user-1",
-      "workflow_id": "workflow-1",
-      "run_id": "run-1",
-      "node_id": "node-harness",
       "hcp_session_id": "session-1",
       "execution_host_id": "host-local",
       "provider_instance_id": "provider-1",
@@ -37,15 +33,24 @@
       "capabilities": [
         {
           "id": "filesystem",
-          "scopes": ["workspace_read", "workspace_write"]
+          "scopes": [
+            "workspace_read",
+            "workspace_write"
+          ]
         },
         {
           "id": "shell",
-          "scopes": ["workspace"],
+          "scopes": [
+            "workspace"
+          ],
           "approval_policy": "ask",
           "command_policy": {
-            "allowed_executables": ["npm"],
-            "denied_executables": ["rm"],
+            "allowed_executables": [
+              "npm"
+            ],
+            "denied_executables": [
+              "rm"
+            ],
             "cwd_policy": "selected_workspace_only",
             "env_policy": "minimal",
             "allow_shell": false,

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@harness-control/protocol",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",