@naswerks/periscope 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -8,6 +8,12 @@ removed export. The package version and the wire protocol version are separate n
 
 ## [Unreleased]
 
+## [1.0.1] - 2026-09-17
+
+- The package carries `src/` (without its tests) and `contracts/wire-vectors/`, so a controller in
+  another language, and a consumer that generates types from the wire, read the contract from the
+  installed package rather than from the repository. No wire or API change.
+
 ## [1.0.0] - 2026-09-17
 
 Initial public release.

package/README.md

@@ -67,8 +67,8 @@ with a signed-in identity instead of a machine credential: [identity](docs/ident
 A controller serves two transports: the WebSocket the host dials, and an HTTP endpoint the host
 POSTs each permission decision to. The second is easy to miss, because nothing on the wire announces
 it. `@naswerks/periscope/protocol` ships the wire types and the codec without anything that can
-reach a process or a disk; `contracts/wire-vectors/` is the same contract as bytes, for a controller
-in any language.
+reach a process or a disk; `contracts/wire-vectors/`, shipped in the package, is the same contract
+as bytes, for a controller in any language.
 
 ```sh
 git clone https://github.com/naswerks/periscope && cd periscope && npm ci && npm run build

package/contracts/wire-vectors/bulk_delivered.full.json

@@ -0,0 +1,21 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "bulk_delivered",
+      "deliveryId": "delivery-1",
+      "byteCount": 512,
+      "sizeBytes": 4608,
+      "mtimeMs": 1700000000000
+    }
+  },
+  "name": "bulk_delivered.full",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"bulk_delivered\",\"deliveryId\":\"delivery-1\",\"byteCount\":512,\"sizeBytes\":4608,\"mtimeMs\":1700000000000}}"
+}

package/contracts/wire-vectors/bulk_delivered.minimal.json

@@ -0,0 +1,21 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "bulk_delivered",
+      "deliveryId": "delivery-1",
+      "byteCount": 0,
+      "sizeBytes": null,
+      "mtimeMs": null
+    }
+  },
+  "name": "bulk_delivered.minimal",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"bulk_delivered\",\"deliveryId\":\"delivery-1\",\"byteCount\":0,\"sizeBytes\":null,\"mtimeMs\":null}}"
+}

package/contracts/wire-vectors/bulk_delivered.without-stat-pair.json

@@ -0,0 +1,22 @@
+{
+  "decoded": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "bulk_delivered",
+      "deliveryId": "delivery-1",
+      "byteCount": 7,
+      "sizeBytes": null,
+      "mtimeMs": null
+    }
+  },
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": null,
+  "name": "bulk_delivered.without-stat-pair",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"bulk_delivered\",\"deliveryId\":\"delivery-1\",\"byteCount\":7}}"
+}

package/contracts/wire-vectors/bulk_failed.declared-reason.json

@@ -0,0 +1,22 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "bulk_failed",
+      "deliveryId": "delivery-1",
+      "refusal": {
+        "reason": "bulk-delivery-failed",
+        "detail": "the controller answered 503"
+      }
+    }
+  },
+  "name": "bulk_failed.declared-reason",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"bulk_failed\",\"deliveryId\":\"delivery-1\",\"refusal\":{\"reason\":\"bulk-delivery-failed\",\"detail\":\"the controller answered 503\"}}}"
+}

package/contracts/wire-vectors/bulk_failed.unknown-reason.json

@@ -0,0 +1,23 @@
+{
+  "decoded": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "bulk_failed",
+      "deliveryId": "delivery-1",
+      "refusal": {
+        "reason": "a-reason-from-a-newer-peer",
+        "detail": "the controller answered 503"
+      }
+    }
+  },
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": null,
+  "name": "bulk_failed.unknown-reason",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"bulk_failed\",\"deliveryId\":\"delivery-1\",\"refusal\":{\"reason\":\"a-reason-from-a-newer-peer\",\"detail\":\"the controller answered 503\"}}}"
+}

package/contracts/wire-vectors/bulk_request.full.json

@@ -0,0 +1,21 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "bulk_request",
+      "deliveryId": "delivery-1",
+      "what": "claude-transcript:slug/agent-session-1",
+      "fromOffset": 4096,
+      "postUrl": "https://controller.example/bulk/delivery-1"
+    }
+  },
+  "name": "bulk_request.full",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"bulk_request\",\"deliveryId\":\"delivery-1\",\"what\":\"claude-transcript:slug/agent-session-1\",\"fromOffset\":4096,\"postUrl\":\"https://controller.example/bulk/delivery-1\"}}"
+}

package/contracts/wire-vectors/host_configure.set-and-remove.json

@@ -0,0 +1,28 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "host_configure",
+      "requestId": "request-6",
+      "entries": [
+        {
+          "key": "PERISCOPE_BRANCH_SCHEME",
+          "value": "{repo}/{key}"
+        },
+        {
+          "key": "PERISCOPE_AGENT_HOME",
+          "value": null
+        }
+      ]
+    }
+  },
+  "name": "host_configure.set-and-remove",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"host_configure\",\"requestId\":\"request-6\",\"entries\":[{\"key\":\"PERISCOPE_BRANCH_SCHEME\",\"value\":\"{repo}/{key}\"},{\"key\":\"PERISCOPE_AGENT_HOME\",\"value\":null}]}}"
+}

package/contracts/wire-vectors/host_configure_result.applied.json

@@ -0,0 +1,34 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "host_configure_result",
+      "requestId": "request-6",
+      "configuration": {
+        "repositoryRoot": "/srv/repo",
+        "workspaceRoot": "/srv/repo-workspaces",
+        "branchScheme": "{repo}/{key}",
+        "transcriptsRoot": "/home/agent/.claude/projects",
+        "controllerUrl": "wss://controller.example/periscope/link",
+        "decisionUrl": "https://controller.example/periscope/decision",
+        "agentHome": "/home/agent/.claude"
+      },
+      "overriddenByEnvironment": [
+        "PERISCOPE_REPOSITORY_ROOT"
+      ],
+      "pendingRestart": [
+        "PERISCOPE_CONTROLLER_URL"
+      ],
+      "refusal": null
+    }
+  },
+  "name": "host_configure_result.applied",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"host_configure_result\",\"requestId\":\"request-6\",\"configuration\":{\"repositoryRoot\":\"/srv/repo\",\"workspaceRoot\":\"/srv/repo-workspaces\",\"branchScheme\":\"{repo}/{key}\",\"transcriptsRoot\":\"/home/agent/.claude/projects\",\"controllerUrl\":\"wss://controller.example/periscope/link\",\"decisionUrl\":\"https://controller.example/periscope/decision\",\"agentHome\":\"/home/agent/.claude\"},\"overriddenByEnvironment\":[\"PERISCOPE_REPOSITORY_ROOT\"],\"pendingRestart\":[\"PERISCOPE_CONTROLLER_URL\"],\"refusal\":null}}"
+}

package/contracts/wire-vectors/host_configure_result.refused.json

@@ -0,0 +1,33 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "host_configure_result",
+      "requestId": "request-6",
+      "configuration": {
+        "repositoryRoot": null,
+        "workspaceRoot": null,
+        "branchScheme": null,
+        "transcriptsRoot": null,
+        "controllerUrl": null,
+        "decisionUrl": null,
+        "agentHome": null
+      },
+      "overriddenByEnvironment": [],
+      "pendingRestart": [],
+      "refusal": {
+        "reason": "config-key-unknown",
+        "detail": "PERISCOPE_HOST_ID is not a key this host takes over the wire"
+      }
+    }
+  },
+  "name": "host_configure_result.refused",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"session\",\"sessionId\":\"session-1\",\"seq\":1,\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"host_configure_result\",\"requestId\":\"request-6\",\"configuration\":{\"repositoryRoot\":null,\"workspaceRoot\":null,\"branchScheme\":null,\"transcriptsRoot\":null,\"controllerUrl\":null,\"decisionUrl\":null,\"agentHome\":null},\"overriddenByEnvironment\":[],\"pendingRestart\":[],\"refusal\":{\"reason\":\"config-key-unknown\",\"detail\":\"PERISCOPE_HOST_ID is not a key this host takes over the wire\"}}}"
+}

package/contracts/wire-vectors/link_ack.cursors.json

@@ -0,0 +1,25 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_ack",
+      "cursors": [
+        {
+          "sessionId": "session-1",
+          "seq": 4
+        },
+        {
+          "sessionId": "session-2",
+          "seq": 0
+        }
+      ]
+    }
+  },
+  "name": "link_ack.cursors",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_ack\",\"cursors\":[{\"sessionId\":\"session-1\",\"seq\":4},{\"sessionId\":\"session-2\",\"seq\":0}]}}"
+}

package/contracts/wire-vectors/link_ack.empty.json

@@ -0,0 +1,16 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_ack",
+      "cursors": []
+    }
+  },
+  "name": "link_ack.empty",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_ack\",\"cursors\":[]}}"
+}

package/contracts/wire-vectors/link_bye.cause.json

@@ -0,0 +1,16 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_bye",
+      "cause": "shutdown"
+    }
+  },
+  "name": "link_bye.cause",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_bye\",\"cause\":\"shutdown\"}}"
+}

package/contracts/wire-vectors/link_hello.empty.json

@@ -0,0 +1,33 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_hello",
+      "protocolVersion": 9,
+      "hostId": "host-1",
+      "capabilities": [],
+      "cursors": [],
+      "configuration": {
+        "repositoryRoot": null,
+        "workspaceRoot": null,
+        "branchScheme": null,
+        "transcriptsRoot": null,
+        "controllerUrl": null,
+        "decisionUrl": null,
+        "agentHome": null
+      },
+      "pendingRestart": [],
+      "protocolRange": {
+        "min": 9,
+        "max": 9
+      }
+    }
+  },
+  "name": "link_hello.empty",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_hello\",\"protocolVersion\":9,\"hostId\":\"host-1\",\"capabilities\":[],\"cursors\":[],\"configuration\":{\"repositoryRoot\":null,\"workspaceRoot\":null,\"branchScheme\":null,\"transcriptsRoot\":null,\"controllerUrl\":null,\"decisionUrl\":null,\"agentHome\":null},\"pendingRestart\":[],\"protocolRange\":{\"min\":9,\"max\":9}}}"
+}

package/contracts/wire-vectors/link_hello.full.json

@@ -0,0 +1,44 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_hello",
+      "protocolVersion": 9,
+      "hostId": "host-1",
+      "capabilities": [
+        "bulk-post",
+        "workspace:git-worktree",
+        "workspace:branch-scheme"
+      ],
+      "cursors": [
+        {
+          "sessionId": "session-1",
+          "seq": 4
+        }
+      ],
+      "configuration": {
+        "repositoryRoot": "/srv/repo",
+        "workspaceRoot": "/srv/repo-workspaces",
+        "branchScheme": "{repo}/{key}",
+        "transcriptsRoot": "/home/agent/.claude/projects",
+        "controllerUrl": "wss://controller.example/periscope/link",
+        "decisionUrl": "https://controller.example/periscope/decision",
+        "agentHome": "/home/agent/.claude"
+      },
+      "pendingRestart": [
+        "PERISCOPE_DECISION_URL"
+      ],
+      "protocolRange": {
+        "min": 9,
+        "max": 9
+      }
+    }
+  },
+  "name": "link_hello.full",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_hello\",\"protocolVersion\":9,\"hostId\":\"host-1\",\"capabilities\":[\"bulk-post\",\"workspace:git-worktree\",\"workspace:branch-scheme\"],\"cursors\":[{\"sessionId\":\"session-1\",\"seq\":4}],\"configuration\":{\"repositoryRoot\":\"/srv/repo\",\"workspaceRoot\":\"/srv/repo-workspaces\",\"branchScheme\":\"{repo}/{key}\",\"transcriptsRoot\":\"/home/agent/.claude/projects\",\"controllerUrl\":\"wss://controller.example/periscope/link\",\"decisionUrl\":\"https://controller.example/periscope/decision\",\"agentHome\":\"/home/agent/.claude\"},\"pendingRestart\":[\"PERISCOPE_DECISION_URL\"],\"protocolRange\":{\"min\":9,\"max\":9}}}"
+}

package/contracts/wire-vectors/link_ping.nonce.json

@@ -0,0 +1,16 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_ping",
+      "nonce": "nonce-1"
+    }
+  },
+  "name": "link_ping.nonce",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_ping\",\"nonce\":\"nonce-1\"}}"
+}

package/contracts/wire-vectors/link_ping.unknown-payload-key.json

@@ -0,0 +1,18 @@
+{
+  "decoded": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_ping",
+      "nonce": "nonce-1",
+      "futureField": "from a newer peer"
+    }
+  },
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": null,
+  "name": "link_ping.unknown-payload-key",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_ping\",\"nonce\":\"nonce-1\",\"futureField\":\"from a newer peer\"}}"
+}

package/contracts/wire-vectors/link_pong.nonce.json

@@ -0,0 +1,16 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_pong",
+      "nonce": "nonce-1"
+    }
+  },
+  "name": "link_pong.nonce",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_pong\",\"nonce\":\"nonce-1\"}}"
+}

package/contracts/wire-vectors/link_welcome.empty.json

@@ -0,0 +1,18 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_welcome",
+      "protocolVersion": 9,
+      "capabilities": [],
+      "cursors": []
+    }
+  },
+  "name": "link_welcome.empty",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_welcome\",\"protocolVersion\":9,\"capabilities\":[],\"cursors\":[]}}"
+}

package/contracts/wire-vectors/link_welcome.full.json

@@ -0,0 +1,25 @@
+{
+  "expect": {
+    "decode": "ok"
+  },
+  "frame": {
+    "frame": "control",
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "link_welcome",
+      "protocolVersion": 9,
+      "capabilities": [
+        "bulk-post"
+      ],
+      "cursors": [
+        {
+          "sessionId": "session-1",
+          "seq": 3
+        }
+      ]
+    }
+  },
+  "name": "link_welcome.full",
+  "protocolVersion": 9,
+  "wire": "{\"frame\":\"control\",\"at\":\"2000-01-01T00:00:00.000Z\",\"payload\":{\"kind\":\"link_welcome\",\"protocolVersion\":9,\"capabilities\":[\"bulk-post\"],\"cursors\":[{\"sessionId\":\"session-1\",\"seq\":3}]}}"
+}

package/contracts/wire-vectors/refused.empty.json

@@ -0,0 +1,10 @@
+{
+  "expect": {
+    "decode": "refused",
+    "reason": "frame-not-json"
+  },
+  "frame": null,
+  "name": "refused.empty",
+  "protocolVersion": 9,
+  "wire": ""
+}

package/contracts/wire-vectors/refused.encode.empty-at.json

@@ -0,0 +1,18 @@
+{
+  "expect": {
+    "encode": "refused",
+    "reason": "frame-malformed"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "",
+    "payload": {
+      "kind": "session_cancel"
+    }
+  },
+  "name": "refused.encode.empty-at",
+  "protocolVersion": 9,
+  "wire": null
+}

package/contracts/wire-vectors/refused.encode.empty-session-id.json

@@ -0,0 +1,18 @@
+{
+  "expect": {
+    "encode": "refused",
+    "reason": "frame-malformed"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "session_cancel"
+    }
+  },
+  "name": "refused.encode.empty-session-id",
+  "protocolVersion": 9,
+  "wire": null
+}

package/contracts/wire-vectors/refused.encode.missing-member.json

@@ -0,0 +1,22 @@
+{
+  "expect": {
+    "encode": "refused",
+    "reason": "frame-malformed"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "session_new",
+      "cwd": "/work/repo",
+      "correlationId": null,
+      "request": null,
+      "gate": null
+    }
+  },
+  "name": "refused.encode.missing-member",
+  "protocolVersion": 9,
+  "wire": null
+}

package/contracts/wire-vectors/refused.encode.seq-zero.json

@@ -0,0 +1,18 @@
+{
+  "expect": {
+    "encode": "refused",
+    "reason": "frame-malformed"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 0,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "session_cancel"
+    }
+  },
+  "name": "refused.encode.seq-zero",
+  "protocolVersion": 9,
+  "wire": null
+}

package/contracts/wire-vectors/refused.encode.undeclared-configure-refusal.json

@@ -0,0 +1,34 @@
+{
+  "expect": {
+    "encode": "refused",
+    "reason": "frame-malformed"
+  },
+  "frame": {
+    "frame": "session",
+    "sessionId": "session-1",
+    "seq": 1,
+    "at": "2000-01-01T00:00:00.000Z",
+    "payload": {
+      "kind": "host_configure_result",
+      "requestId": "request-1",
+      "configuration": {
+        "repositoryRoot": null,
+        "workspaceRoot": null,
+        "branchScheme": null,
+        "transcriptsRoot": null,
+        "controllerUrl": null,
+        "decisionUrl": null,
+        "agentHome": null
+      },
+      "overriddenByEnvironment": [],
+      "pendingRestart": [],
+      "refusal": {
+        "reason": "a-reason-this-host-does-not-declare",
+        "detail": ""
+      }
+    }
+  },
+  "name": "refused.encode.undeclared-configure-refusal",
+  "protocolVersion": 9,
+  "wire": null
+}