@harness-control/protocol 0.4.10 → 0.4.11

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 (64) hide show
  1. package/LICENSE +202 -202
  2. package/README.md +26 -26
  3. package/dist/accounts.d.ts +0 -0
  4. package/dist/accounts.js +0 -0
  5. package/dist/bin/conformance.d.ts +0 -0
  6. package/dist/bin/conformance.js +0 -0
  7. package/dist/bin/generate-json-schema.d.ts +0 -0
  8. package/dist/bin/generate-json-schema.js +0 -0
  9. package/dist/conformance.d.ts +0 -0
  10. package/dist/conformance.js +0 -0
  11. package/dist/conversation.d.ts +0 -0
  12. package/dist/conversation.js +0 -0
  13. package/dist/index.d.ts +30 -30
  14. package/dist/index.js +0 -0
  15. package/dist/json-schema.d.ts +0 -0
  16. package/dist/json-schema.js +0 -0
  17. package/dist/mcp-review.d.ts +0 -0
  18. package/dist/mcp-review.js +0 -0
  19. package/dist/native-review.d.ts +0 -0
  20. package/dist/native-review.js +0 -0
  21. package/dist/pairing.d.ts +0 -0
  22. package/dist/pairing.js +0 -0
  23. package/dist/session-reducer.d.ts +0 -0
  24. package/dist/session-reducer.js +0 -0
  25. package/fixtures/conformance/invalid/accounts-negative-quota.json +35 -35
  26. package/fixtures/conformance/invalid/accounts-secret.json +36 -36
  27. package/fixtures/conformance/invalid/arbitrary-event-family.json +13 -13
  28. package/fixtures/conformance/invalid/local-action-lease-binding-mismatch.json +49 -49
  29. package/fixtures/conformance/invalid/local-action-missing-turn-id.json +20 -20
  30. package/fixtures/conformance/invalid/local-action-patch-missing-base-hash.json +51 -51
  31. package/fixtures/conformance/invalid/local-action-shell-missing-approval.json +56 -56
  32. package/fixtures/conformance/invalid/mcp-stdio-attachment.json +27 -27
  33. package/fixtures/conformance/invalid/session-snapshot-unsafe-omission.json +26 -26
  34. package/fixtures/conformance/invalid/terminal-turn-missing-final-output.json +16 -16
  35. package/fixtures/conformance/invalid/unknown-payload-field.json +14 -14
  36. package/fixtures/conformance/invalid/unknown-top-level-field.json +14 -14
  37. package/fixtures/conformance/valid/accounts-read.json +11 -11
  38. package/fixtures/conformance/valid/accounts-snapshot.json +35 -35
  39. package/fixtures/conformance/valid/accounts-unavailable.json +21 -21
  40. package/fixtures/conformance/valid/command-ack.json +11 -11
  41. package/fixtures/conformance/valid/extension-event.json +18 -18
  42. package/fixtures/conformance/valid/host-hello.json +22 -22
  43. package/fixtures/conformance/valid/host-replay-unavailable.json +15 -15
  44. package/fixtures/conformance/valid/local-action-dev-server-start.json +68 -68
  45. package/fixtures/conformance/valid/local-action-dev-server-stop.json +52 -52
  46. package/fixtures/conformance/valid/local-action-error.json +38 -38
  47. package/fixtures/conformance/valid/local-action-filesystem-list.json +52 -52
  48. package/fixtures/conformance/valid/local-action-filesystem-patch.json +53 -53
  49. package/fixtures/conformance/valid/local-action-filesystem-read.json +51 -51
  50. package/fixtures/conformance/valid/local-action-filesystem-write.json +53 -53
  51. package/fixtures/conformance/valid/local-action-git-diff.json +53 -53
  52. package/fixtures/conformance/valid/local-action-git-status.json +51 -51
  53. package/fixtures/conformance/valid/local-action-response.json +49 -49
  54. package/fixtures/conformance/valid/local-action-shell-exec.json +63 -63
  55. package/fixtures/conformance/valid/provider-event.json +18 -18
  56. package/fixtures/conformance/valid/session-snapshot-request.json +9 -9
  57. package/fixtures/conformance/valid/session-snapshot.json +28 -28
  58. package/fixtures/conformance/valid/session-start-with-leases.json +85 -85
  59. package/fixtures/conformance/valid/session-start-with-runner-stdio-profile.json +27 -27
  60. package/fixtures/conformance/valid/turn-completed.json +30 -30
  61. package/fixtures/mcp-review.json +20 -20
  62. package/package.json +68 -68
  63. package/schemas/hcp-message.schema.json +0 -0
  64. package/schemas/mcp-review.json +0 -0
package/fixtures/conformance/valid/local-action-filesystem-read.json CHANGED
@@ -1,51 +1,51 @@
1
- {
2
- "id": "message-local-filesystem-read",
3
- "type": "local.action.request",
4
- "version": "hcp.v0",
5
- "sent_at": "2026-01-01T00:00:00.000Z",
6
- "payload": {
7
- "request_id": "local-action-read-1",
8
- "action": "local.filesystem.read",
9
- "issued_at": "2026-01-01T00:00:01.000Z",
10
- "attribution": {
11
- "session_id": "session-1",
12
- "turn_id": "turn-1",
13
- "workspace_id": "workspace-1",
14
- "provider_instance_id": "provider-1"
15
- },
16
- "lease": {
17
- "lease_id": "local-lease-read",
18
- "capability_id": "filesystem",
19
- "scope": "workspace_read",
20
- "hcp_session_id": "session-1",
21
- "execution_host_id": "host-1",
22
- "provider_instance_id": "provider-1",
23
- "workspace_id": "workspace-1",
24
- "expires_at": "2026-01-01T01:00:00.000Z"
25
- },
26
- "sandbox": {
27
- "mode": "workspace_write",
28
- "workspace_root": "/tmp/workspace",
29
- "cwd": "/tmp/workspace",
30
- "requires_workspace_containment": true
31
- },
32
- "approval": {
33
- "status": "not_required"
34
- },
35
- "output_limits": {
36
- "content_bytes": 65536
37
- },
38
- "cancellation": {
39
- "cancellable": false
40
- },
41
- "audit": {
42
- "started_event_type": "local_capability.action.started",
43
- "completed_event_type": "local_capability.action.completed",
44
- "failed_event_type": "local_capability.action.failed"
45
- },
46
- "input": {
47
- "path": "README.md",
48
- "encoding": "utf8"
49
- }
50
- }
51
- }
1
+ {
2
+ "id": "message-local-filesystem-read",
3
+ "type": "local.action.request",
4
+ "version": "hcp.v0",
5
+ "sent_at": "2026-01-01T00:00:00.000Z",
6
+ "payload": {
7
+ "request_id": "local-action-read-1",
8
+ "action": "local.filesystem.read",
9
+ "issued_at": "2026-01-01T00:00:01.000Z",
10
+ "attribution": {
11
+ "session_id": "session-1",
12
+ "turn_id": "turn-1",
13
+ "workspace_id": "workspace-1",
14
+ "provider_instance_id": "provider-1"
15
+ },
16
+ "lease": {
17
+ "lease_id": "local-lease-read",
18
+ "capability_id": "filesystem",
19
+ "scope": "workspace_read",
20
+ "hcp_session_id": "session-1",
21
+ "execution_host_id": "host-1",
22
+ "provider_instance_id": "provider-1",
23
+ "workspace_id": "workspace-1",
24
+ "expires_at": "2026-01-01T01:00:00.000Z"
25
+ },
26
+ "sandbox": {
27
+ "mode": "workspace_write",
28
+ "workspace_root": "/tmp/workspace",
29
+ "cwd": "/tmp/workspace",
30
+ "requires_workspace_containment": true
31
+ },
32
+ "approval": {
33
+ "status": "not_required"
34
+ },
35
+ "output_limits": {
36
+ "content_bytes": 65536
37
+ },
38
+ "cancellation": {
39
+ "cancellable": false
40
+ },
41
+ "audit": {
42
+ "started_event_type": "local_capability.action.started",
43
+ "completed_event_type": "local_capability.action.completed",
44
+ "failed_event_type": "local_capability.action.failed"
45
+ },
46
+ "input": {
47
+ "path": "README.md",
48
+ "encoding": "utf8"
49
+ }
50
+ }
51
+ }
package/fixtures/conformance/valid/local-action-filesystem-write.json CHANGED
@@ -1,53 +1,53 @@
1
- {
2
- "id": "message-local-filesystem-write",
3
- "type": "local.action.request",
4
- "version": "hcp.v0",
5
- "sent_at": "2026-01-01T00:00:00.000Z",
6
- "payload": {
7
- "request_id": "local-action-write-1",
8
- "action": "local.filesystem.write",
9
- "issued_at": "2026-01-01T00:00:01.000Z",
10
- "attribution": {
11
- "session_id": "session-1",
12
- "turn_id": "turn-1",
13
- "workspace_id": "workspace-1",
14
- "provider_instance_id": "provider-1"
15
- },
16
- "lease": {
17
- "lease_id": "local-lease-write",
18
- "capability_id": "filesystem",
19
- "scope": "workspace_write",
20
- "hcp_session_id": "session-1",
21
- "execution_host_id": "host-1",
22
- "provider_instance_id": "provider-1",
23
- "workspace_id": "workspace-1",
24
- "expires_at": "2026-01-01T01:00:00.000Z"
25
- },
26
- "sandbox": {
27
- "mode": "workspace_write",
28
- "workspace_root": "/tmp/workspace",
29
- "cwd": "/tmp/workspace",
30
- "requires_workspace_containment": true
31
- },
32
- "approval": {
33
- "status": "not_required"
34
- },
35
- "output_limits": {},
36
- "cancellation": {
37
- "cancellable": false
38
- },
39
- "audit": {
40
- "started_event_type": "local_capability.action.started",
41
- "completed_event_type": "local_capability.action.completed",
42
- "failed_event_type": "local_capability.action.failed"
43
- },
44
- "input": {
45
- "path": "README.md",
46
- "content": "updated",
47
- "encoding": "utf8",
48
- "mode": "overwrite",
49
- "create_parents": false,
50
- "expected_base_hash": "sha256:old"
51
- }
52
- }
53
- }
1
+ {
2
+ "id": "message-local-filesystem-write",
3
+ "type": "local.action.request",
4
+ "version": "hcp.v0",
5
+ "sent_at": "2026-01-01T00:00:00.000Z",
6
+ "payload": {
7
+ "request_id": "local-action-write-1",
8
+ "action": "local.filesystem.write",
9
+ "issued_at": "2026-01-01T00:00:01.000Z",
10
+ "attribution": {
11
+ "session_id": "session-1",
12
+ "turn_id": "turn-1",
13
+ "workspace_id": "workspace-1",
14
+ "provider_instance_id": "provider-1"
15
+ },
16
+ "lease": {
17
+ "lease_id": "local-lease-write",
18
+ "capability_id": "filesystem",
19
+ "scope": "workspace_write",
20
+ "hcp_session_id": "session-1",
21
+ "execution_host_id": "host-1",
22
+ "provider_instance_id": "provider-1",
23
+ "workspace_id": "workspace-1",
24
+ "expires_at": "2026-01-01T01:00:00.000Z"
25
+ },
26
+ "sandbox": {
27
+ "mode": "workspace_write",
28
+ "workspace_root": "/tmp/workspace",
29
+ "cwd": "/tmp/workspace",
30
+ "requires_workspace_containment": true
31
+ },
32
+ "approval": {
33
+ "status": "not_required"
34
+ },
35
+ "output_limits": {},
36
+ "cancellation": {
37
+ "cancellable": false
38
+ },
39
+ "audit": {
40
+ "started_event_type": "local_capability.action.started",
41
+ "completed_event_type": "local_capability.action.completed",
42
+ "failed_event_type": "local_capability.action.failed"
43
+ },
44
+ "input": {
45
+ "path": "README.md",
46
+ "content": "updated",
47
+ "encoding": "utf8",
48
+ "mode": "overwrite",
49
+ "create_parents": false,
50
+ "expected_base_hash": "sha256:old"
51
+ }
52
+ }
53
+ }
package/fixtures/conformance/valid/local-action-git-diff.json CHANGED
@@ -1,53 +1,53 @@
1
- {
2
- "id": "message-local-git-diff",
3
- "type": "local.action.request",
4
- "version": "hcp.v0",
5
- "sent_at": "2026-01-01T00:00:00.000Z",
6
- "payload": {
7
- "request_id": "local-action-git-diff-1",
8
- "action": "local.git.diff",
9
- "issued_at": "2026-01-01T00:00:01.000Z",
10
- "attribution": {
11
- "session_id": "session-1",
12
- "turn_id": "turn-1",
13
- "workspace_id": "workspace-1",
14
- "provider_instance_id": "provider-1"
15
- },
16
- "lease": {
17
- "lease_id": "local-lease-git-diff",
18
- "capability_id": "git",
19
- "scope": "workspace_read",
20
- "hcp_session_id": "session-1",
21
- "execution_host_id": "host-1",
22
- "provider_instance_id": "provider-1",
23
- "workspace_id": "workspace-1",
24
- "expires_at": "2026-01-01T01:00:00.000Z"
25
- },
26
- "sandbox": {
27
- "mode": "workspace_write",
28
- "workspace_root": "/tmp/workspace",
29
- "cwd": "/tmp/workspace",
30
- "requires_workspace_containment": true
31
- },
32
- "approval": {
33
- "status": "not_required"
34
- },
35
- "output_limits": {
36
- "diff_bytes": 65536
37
- },
38
- "cancellation": {
39
- "cancellable": false
40
- },
41
- "audit": {
42
- "started_event_type": "local_capability.action.started",
43
- "completed_event_type": "local_capability.action.completed",
44
- "failed_event_type": "local_capability.action.failed"
45
- },
46
- "input": {
47
- "paths": [
48
- "README.md"
49
- ],
50
- "staged": false
51
- }
52
- }
53
- }
1
+ {
2
+ "id": "message-local-git-diff",
3
+ "type": "local.action.request",
4
+ "version": "hcp.v0",
5
+ "sent_at": "2026-01-01T00:00:00.000Z",
6
+ "payload": {
7
+ "request_id": "local-action-git-diff-1",
8
+ "action": "local.git.diff",
9
+ "issued_at": "2026-01-01T00:00:01.000Z",
10
+ "attribution": {
11
+ "session_id": "session-1",
12
+ "turn_id": "turn-1",
13
+ "workspace_id": "workspace-1",
14
+ "provider_instance_id": "provider-1"
15
+ },
16
+ "lease": {
17
+ "lease_id": "local-lease-git-diff",
18
+ "capability_id": "git",
19
+ "scope": "workspace_read",
20
+ "hcp_session_id": "session-1",
21
+ "execution_host_id": "host-1",
22
+ "provider_instance_id": "provider-1",
23
+ "workspace_id": "workspace-1",
24
+ "expires_at": "2026-01-01T01:00:00.000Z"
25
+ },
26
+ "sandbox": {
27
+ "mode": "workspace_write",
28
+ "workspace_root": "/tmp/workspace",
29
+ "cwd": "/tmp/workspace",
30
+ "requires_workspace_containment": true
31
+ },
32
+ "approval": {
33
+ "status": "not_required"
34
+ },
35
+ "output_limits": {
36
+ "diff_bytes": 65536
37
+ },
38
+ "cancellation": {
39
+ "cancellable": false
40
+ },
41
+ "audit": {
42
+ "started_event_type": "local_capability.action.started",
43
+ "completed_event_type": "local_capability.action.completed",
44
+ "failed_event_type": "local_capability.action.failed"
45
+ },
46
+ "input": {
47
+ "paths": [
48
+ "README.md"
49
+ ],
50
+ "staged": false
51
+ }
52
+ }
53
+ }
package/fixtures/conformance/valid/local-action-git-status.json CHANGED
@@ -1,51 +1,51 @@
1
- {
2
- "id": "message-local-git-status",
3
- "type": "local.action.request",
4
- "version": "hcp.v0",
5
- "sent_at": "2026-01-01T00:00:00.000Z",
6
- "payload": {
7
- "request_id": "local-action-git-status-1",
8
- "action": "local.git.status",
9
- "issued_at": "2026-01-01T00:00:01.000Z",
10
- "attribution": {
11
- "session_id": "session-1",
12
- "turn_id": "turn-1",
13
- "workspace_id": "workspace-1",
14
- "provider_instance_id": "provider-1"
15
- },
16
- "lease": {
17
- "lease_id": "local-lease-git-status",
18
- "capability_id": "git",
19
- "scope": "workspace_read",
20
- "hcp_session_id": "session-1",
21
- "execution_host_id": "host-1",
22
- "provider_instance_id": "provider-1",
23
- "workspace_id": "workspace-1",
24
- "expires_at": "2026-01-01T01:00:00.000Z"
25
- },
26
- "sandbox": {
27
- "mode": "workspace_write",
28
- "workspace_root": "/tmp/workspace",
29
- "cwd": "/tmp/workspace",
30
- "requires_workspace_containment": true
31
- },
32
- "approval": {
33
- "status": "not_required"
34
- },
35
- "output_limits": {
36
- "status_bytes": 65536
37
- },
38
- "cancellation": {
39
- "cancellable": false
40
- },
41
- "audit": {
42
- "started_event_type": "local_capability.action.started",
43
- "completed_event_type": "local_capability.action.completed",
44
- "failed_event_type": "local_capability.action.failed"
45
- },
46
- "input": {
47
- "porcelain_version": "v1",
48
- "include_branch": true
49
- }
50
- }
51
- }
1
+ {
2
+ "id": "message-local-git-status",
3
+ "type": "local.action.request",
4
+ "version": "hcp.v0",
5
+ "sent_at": "2026-01-01T00:00:00.000Z",
6
+ "payload": {
7
+ "request_id": "local-action-git-status-1",
8
+ "action": "local.git.status",
9
+ "issued_at": "2026-01-01T00:00:01.000Z",
10
+ "attribution": {
11
+ "session_id": "session-1",
12
+ "turn_id": "turn-1",
13
+ "workspace_id": "workspace-1",
14
+ "provider_instance_id": "provider-1"
15
+ },
16
+ "lease": {
17
+ "lease_id": "local-lease-git-status",
18
+ "capability_id": "git",
19
+ "scope": "workspace_read",
20
+ "hcp_session_id": "session-1",
21
+ "execution_host_id": "host-1",
22
+ "provider_instance_id": "provider-1",
23
+ "workspace_id": "workspace-1",
24
+ "expires_at": "2026-01-01T01:00:00.000Z"
25
+ },
26
+ "sandbox": {
27
+ "mode": "workspace_write",
28
+ "workspace_root": "/tmp/workspace",
29
+ "cwd": "/tmp/workspace",
30
+ "requires_workspace_containment": true
31
+ },
32
+ "approval": {
33
+ "status": "not_required"
34
+ },
35
+ "output_limits": {
36
+ "status_bytes": 65536
37
+ },
38
+ "cancellation": {
39
+ "cancellable": false
40
+ },
41
+ "audit": {
42
+ "started_event_type": "local_capability.action.started",
43
+ "completed_event_type": "local_capability.action.completed",
44
+ "failed_event_type": "local_capability.action.failed"
45
+ },
46
+ "input": {
47
+ "porcelain_version": "v1",
48
+ "include_branch": true
49
+ }
50
+ }
51
+ }
package/fixtures/conformance/valid/local-action-response.json CHANGED
@@ -1,49 +1,49 @@
1
- {
2
- "id": "message-local-action-response",
3
- "type": "local.action.response",
4
- "version": "hcp.v0",
5
- "sent_at": "2026-01-01T00:00:00.000Z",
6
- "payload": {
7
- "request_id": "local-action-shell-1",
8
- "action": "local.shell.exec",
9
- "status": "completed",
10
- "completed_at": "2026-01-01T00:00:03.000Z",
11
- "attribution": {
12
- "session_id": "session-1",
13
- "turn_id": "turn-1",
14
- "workspace_id": "workspace-1",
15
- "provider_instance_id": "provider-1"
16
- },
17
- "lease": {
18
- "lease_id": "local-lease-shell",
19
- "capability_id": "shell",
20
- "scope": "workspace",
21
- "hcp_session_id": "session-1",
22
- "execution_host_id": "host-1",
23
- "provider_instance_id": "provider-1",
24
- "workspace_id": "workspace-1"
25
- },
26
- "output": {
27
- "executable": "npm",
28
- "argv": [
29
- "test"
30
- ],
31
- "cwd": "/tmp/workspace",
32
- "exit_code": 0,
33
- "signal": null,
34
- "stdout": "ok\n",
35
- "stderr": "",
36
- "timed_out": false
37
- },
38
- "audit_events": {
39
- "started": {
40
- "event_type": "local_capability.action.started",
41
- "sequence": 10
42
- },
43
- "completed": {
44
- "event_type": "local_capability.action.completed",
45
- "sequence": 11
46
- }
47
- }
48
- }
49
- }
1
+ {
2
+ "id": "message-local-action-response",
3
+ "type": "local.action.response",
4
+ "version": "hcp.v0",
5
+ "sent_at": "2026-01-01T00:00:00.000Z",
6
+ "payload": {
7
+ "request_id": "local-action-shell-1",
8
+ "action": "local.shell.exec",
9
+ "status": "completed",
10
+ "completed_at": "2026-01-01T00:00:03.000Z",
11
+ "attribution": {
12
+ "session_id": "session-1",
13
+ "turn_id": "turn-1",
14
+ "workspace_id": "workspace-1",
15
+ "provider_instance_id": "provider-1"
16
+ },
17
+ "lease": {
18
+ "lease_id": "local-lease-shell",
19
+ "capability_id": "shell",
20
+ "scope": "workspace",
21
+ "hcp_session_id": "session-1",
22
+ "execution_host_id": "host-1",
23
+ "provider_instance_id": "provider-1",
24
+ "workspace_id": "workspace-1"
25
+ },
26
+ "output": {
27
+ "executable": "npm",
28
+ "argv": [
29
+ "test"
30
+ ],
31
+ "cwd": "/tmp/workspace",
32
+ "exit_code": 0,
33
+ "signal": null,
34
+ "stdout": "ok\n",
35
+ "stderr": "",
36
+ "timed_out": false
37
+ },
38
+ "audit_events": {
39
+ "started": {
40
+ "event_type": "local_capability.action.started",
41
+ "sequence": 10
42
+ },
43
+ "completed": {
44
+ "event_type": "local_capability.action.completed",
45
+ "sequence": 11
46
+ }
47
+ }
48
+ }
49
+ }
package/fixtures/conformance/valid/local-action-shell-exec.json CHANGED
@@ -1,63 +1,63 @@
1
- {
2
- "id": "message-local-shell-exec",
3
- "type": "local.action.request",
4
- "version": "hcp.v0",
5
- "sent_at": "2026-01-01T00:00:00.000Z",
6
- "payload": {
7
- "request_id": "local-action-shell-1",
8
- "action": "local.shell.exec",
9
- "issued_at": "2026-01-01T00:00:01.000Z",
10
- "attribution": {
11
- "session_id": "session-1",
12
- "turn_id": "turn-1",
13
- "workspace_id": "workspace-1",
14
- "provider_instance_id": "provider-1"
15
- },
16
- "lease": {
17
- "lease_id": "local-lease-shell",
18
- "capability_id": "shell",
19
- "scope": "workspace",
20
- "hcp_session_id": "session-1",
21
- "execution_host_id": "host-1",
22
- "provider_instance_id": "provider-1",
23
- "workspace_id": "workspace-1",
24
- "expires_at": "2026-01-01T01:00:00.000Z"
25
- },
26
- "sandbox": {
27
- "mode": "workspace_write",
28
- "workspace_root": "/tmp/workspace",
29
- "cwd": "/tmp/workspace",
30
- "requires_workspace_containment": true
31
- },
32
- "approval": {
33
- "status": "approved",
34
- "request_id": "approval-1",
35
- "action_hash": "sha256:action",
36
- "decision": "accept",
37
- "actor_id": "user-1",
38
- "approved_at": "2026-01-01T00:00:02.000Z"
39
- },
40
- "output_limits": {
41
- "stdout_bytes": 65536,
42
- "stderr_bytes": 65536
43
- },
44
- "cancellation": {
45
- "cancellable": true,
46
- "timeout_ms": 60000,
47
- "token": "cancel-shell-1"
48
- },
49
- "audit": {
50
- "started_event_type": "local_capability.action.started",
51
- "completed_event_type": "local_capability.action.completed",
52
- "failed_event_type": "local_capability.action.failed"
53
- },
54
- "input": {
55
- "executable": "npm",
56
- "argv": [
57
- "test"
58
- ],
59
- "cwd": "/tmp/workspace",
60
- "use_shell": false
61
- }
62
- }
63
- }
1
+ {
2
+ "id": "message-local-shell-exec",
3
+ "type": "local.action.request",
4
+ "version": "hcp.v0",
5
+ "sent_at": "2026-01-01T00:00:00.000Z",
6
+ "payload": {
7
+ "request_id": "local-action-shell-1",
8
+ "action": "local.shell.exec",
9
+ "issued_at": "2026-01-01T00:00:01.000Z",
10
+ "attribution": {
11
+ "session_id": "session-1",
12
+ "turn_id": "turn-1",
13
+ "workspace_id": "workspace-1",
14
+ "provider_instance_id": "provider-1"
15
+ },
16
+ "lease": {
17
+ "lease_id": "local-lease-shell",
18
+ "capability_id": "shell",
19
+ "scope": "workspace",
20
+ "hcp_session_id": "session-1",
21
+ "execution_host_id": "host-1",
22
+ "provider_instance_id": "provider-1",
23
+ "workspace_id": "workspace-1",
24
+ "expires_at": "2026-01-01T01:00:00.000Z"
25
+ },
26
+ "sandbox": {
27
+ "mode": "workspace_write",
28
+ "workspace_root": "/tmp/workspace",
29
+ "cwd": "/tmp/workspace",
30
+ "requires_workspace_containment": true
31
+ },
32
+ "approval": {
33
+ "status": "approved",
34
+ "request_id": "approval-1",
35
+ "action_hash": "sha256:action",
36
+ "decision": "accept",
37
+ "actor_id": "user-1",
38
+ "approved_at": "2026-01-01T00:00:02.000Z"
39
+ },
40
+ "output_limits": {
41
+ "stdout_bytes": 65536,
42
+ "stderr_bytes": 65536
43
+ },
44
+ "cancellation": {
45
+ "cancellable": true,
46
+ "timeout_ms": 60000,
47
+ "token": "cancel-shell-1"
48
+ },
49
+ "audit": {
50
+ "started_event_type": "local_capability.action.started",
51
+ "completed_event_type": "local_capability.action.completed",
52
+ "failed_event_type": "local_capability.action.failed"
53
+ },
54
+ "input": {
55
+ "executable": "npm",
56
+ "argv": [
57
+ "test"
58
+ ],
59
+ "cwd": "/tmp/workspace",
60
+ "use_shell": false
61
+ }
62
+ }
63
+ }