@chipschat/protocol 0.0.0-stage → 1.0.0

package/fixtures/frames/context.edit.json

@@ -0,0 +1,11 @@
+{
+  "frame": "context.edit",
+  "edit_id": "edt_01JB0000000000000000000000",
+  "harness_id": "hrn_01JB0000000000000000000000",
+  "agent_id": "agt_01JB0000000000000000000000",
+  "name": "PERSONA.md",
+  "text": "# Who you are\n\nPlain, careful, curious.",
+  "base_hash": "a1b2c3",
+  "asked_by": "usr_01JB0000000000000000000000",
+  "asked_at": "2026-10-07T17:42:00.000Z"
+}

package/fixtures/frames/context_window.change.json

@@ -0,0 +1,9 @@
+{
+  "frame": "context_window.change",
+  "change_id": "chg_01JB0000000000000000000000",
+  "harness_id": "hrn_01JB0000000000000000000000",
+  "agent_id": "agt_01JB0000000000000000000000",
+  "at": 70,
+  "asked_by": "usr_01JB0000000000000000000000",
+  "asked_at": "2026-10-09T09:10:00.000Z"
+}

package/fixtures/frames/context_window.compact.json

@@ -0,0 +1,8 @@
+{
+  "frame": "context_window.compact",
+  "change_id": "chg_01JB0000000000000000000000",
+  "harness_id": "hrn_01JB0000000000000000000000",
+  "agent_id": "agt_01JB0000000000000000000000",
+  "asked_by": "usr_01JB0000000000000000000000",
+  "asked_at": "2026-10-09T09:10:00.000Z"
+}

package/fixtures/frames/error.json

@@ -0,0 +1,6 @@
+{
+  "frame": "error",
+  "code": "too_far_behind",
+  "message": "You are more than 1,000 frames behind. Reconnect and resume with `since`.",
+  "idempotency_key": "scout-run-5-step-9"
+}

package/fixtures/frames/event.json

@@ -0,0 +1,20 @@
+{
+  "frame": "event",
+  "event": {
+    "v": 1,
+    "type": "run.status",
+    "id": "evt_01K4ZQPX000000000000000065",
+    "ts": "2026-09-02T14:22:01.004Z",
+    "workspace_id": "ws_01K4ZQPX000000000000000001",
+    "space_id": "spc_01K4ZQPX000000000000000002",
+    "actor": {
+      "kind": "harness",
+      "id": "hrn_01K4ZQPX000000000000000004"
+    },
+    "run_id": "run_01K4ZQPX000000000000000005",
+    "phase": "reading",
+    "verb_phrase": "Reading PO #4471\u2026",
+    "progress": 0.15,
+    "estimate_seconds": 40
+  }
+}

package/fixtures/frames/events.json

@@ -0,0 +1,39 @@
+{
+  "frame": "events",
+  "events": [
+    {
+      "v": 1,
+      "type": "run.status",
+      "id": "evt_01K4ZQPX000000000000000065",
+      "ts": "2026-09-02T14:22:01.004Z",
+      "workspace_id": "ws_01K4ZQPX000000000000000001",
+      "space_id": "spc_01K4ZQPX000000000000000002",
+      "actor": {
+        "kind": "harness",
+        "id": "hrn_01K4ZQPX000000000000000004"
+      },
+      "run_id": "run_01K4ZQPX000000000000000005",
+      "phase": "reading",
+      "verb_phrase": "Reading PO #4471\u2026",
+      "progress": 0.15,
+      "estimate_seconds": 40
+    },
+    {
+      "v": 1,
+      "type": "run.status",
+      "id": "evt_01K4ZQPX000000000000000066",
+      "ts": "2026-09-02T14:22:01.004Z",
+      "workspace_id": "ws_01K4ZQPX000000000000000001",
+      "space_id": "spc_01K4ZQPX000000000000000002",
+      "actor": {
+        "kind": "harness",
+        "id": "hrn_01K4ZQPX000000000000000004"
+      },
+      "run_id": "run_01K4ZQPX000000000000000005",
+      "phase": "writing",
+      "verb_phrase": "Drafting the reply\u2026",
+      "progress": 0.4,
+      "estimate_seconds": 40
+    }
+  ]
+}

package/fixtures/frames/folder.open.json

@@ -0,0 +1,6 @@
+{
+  "frame": "folder.open",
+  "space_id": "spc_01M5M82961AB2TETFXT2RJ0DB0",
+  "asked_from": "iPhone",
+  "asked_at": "2026-10-23T22:05:00.000Z"
+}

package/fixtures/frames/folder.open.page.json

@@ -0,0 +1,7 @@
+{
+  "frame": "folder.open",
+  "space_id": "spc_01M5M82961AB2TETFXT2RJ0DB0",
+  "what": "page",
+  "asked_from": "iPhone",
+  "asked_at": "2026-10-24T18:05:00.000Z"
+}

package/fixtures/frames/folder.run.json

@@ -0,0 +1,8 @@
+{
+  "frame": "folder.run",
+  "space_id": "spc_01M5M82961AB2TETFXT2RJ0DB0",
+  "op": "run",
+  "command": "python3 -m http.server 8000",
+  "asked_from": "iPhone",
+  "asked_at": "2026-10-24T09:05:00.000Z"
+}

package/fixtures/frames/folder.run_state.json

@@ -0,0 +1,12 @@
+{
+  "frame": "folder.run_state",
+  "space_id": "spc_01M5M82961AB2TETFXT2RJ0DB0",
+  "run": {
+    "state": "running",
+    "command": "python3 -m http.server 8000",
+    "since": "2026-10-24T09:05:02.000Z",
+    "opened": "http://localhost:8000",
+    "mac": "Arjun's Mac mini",
+    "said_at": "2026-10-24T09:05:03.000Z"
+  }
+}

package/fixtures/frames/heartbeat.change.json

@@ -0,0 +1,10 @@
+{
+  "frame": "heartbeat.change",
+  "change_id": "chg_01JB0000000000000000000000",
+  "harness_id": "hrn_01JB0000000000000000000000",
+  "agent_id": "agt_01JB0000000000000000000000",
+  "on": true,
+  "every": 60,
+  "asked_by": "usr_01JB0000000000000000000000",
+  "asked_at": "2026-10-09T09:10:00.000Z"
+}

package/fixtures/frames/hello.json

@@ -0,0 +1,18 @@
+{
+  "frame": "hello",
+  "protocol": {
+    "min": 1,
+    "max": 1
+  },
+  "client": {
+    "name": "scout",
+    "version": "0.1.0"
+  },
+  "harnesses": [
+    {
+      "harness_id": "hrn_01K4ZQPX000000000000000004",
+      "autonomy": 2
+    }
+  ],
+  "since": 0
+}

package/fixtures/frames/job.change.json

@@ -0,0 +1,9 @@
+{
+  "frame": "job.change",
+  "change_id": "chg_01JB0000000000000000000000",
+  "harness_id": "hrn_01JB0000000000000000000000",
+  "job_id": "heartbeat:main",
+  "on": false,
+  "asked_by": "usr_01JB0000000000000000000000",
+  "asked_at": "2026-10-31T16:10:00.000Z"
+}

package/fixtures/frames/join.json

@@ -0,0 +1,19 @@
+{
+  "frame": "join",
+  "request": {
+    "request_id": "jrq_01K4ZQPX0000000000000000J1",
+    "kind": "harness",
+    "state": "waiting",
+    "started_by": "requester",
+    "code": "KQ7-M4P",
+    "name": "Tide",
+    "software": "tide 0.4.1",
+    "machine": "vps-fra-1",
+    "from_addr": "100.88.4.12",
+    "wants": ["autonomy", "new_spaces", "restarts"],
+    "capabilities": [],
+    "url": "http://100.64.0.7:4431",
+    "created_at": "2026-10-05T21:04:00.000Z",
+    "expires_at": "2026-10-05T21:14:00.000Z"
+  }
+}

package/fixtures/frames/model.change.json

@@ -0,0 +1,10 @@
+{
+  "frame": "model.change",
+  "change_id": "chg_01JB0000000000000000000000",
+  "harness_id": "hrn_01JB0000000000000000000000",
+  "agent_id": "agt_01JB0000000000000000000000",
+  "model": "heron-2",
+  "effort": "deep",
+  "asked_by": "usr_01JB0000000000000000000000",
+  "asked_at": "2026-10-08T23:10:00.000Z"
+}

package/fixtures/frames/ping.json

@@ -0,0 +1,4 @@
+{
+  "frame": "ping",
+  "ts": 1788357751004
+}

package/fixtures/frames/pong.json

@@ -0,0 +1,4 @@
+{
+  "frame": "pong",
+  "ts": 1788357751004
+}

package/fixtures/frames/presence.json

@@ -0,0 +1,12 @@
+{
+  "frame": "presence",
+  "participant_id": "hrn_01K4ZQPX000000000000000004",
+  "state": {
+    "connected": true,
+    "since": "2026-09-28T18:34:46.205Z",
+    "trouble": {
+      "reason": "Can't reach its gateway",
+      "since": "2026-09-28T18:34:50.000Z"
+    }
+  }
+}

package/fixtures/frames/receipt.json

@@ -0,0 +1,5 @@
+{
+  "frame": "receipt",
+  "idempotency_key": "arjun-msg-7",
+  "disposition": "steered"
+}

package/fixtures/frames/restart.json

@@ -0,0 +1,5 @@
+{
+  "frame": "restart",
+  "asked_by": "usr_01K4ZQPX000000000000000003",
+  "asked_at": "2026-10-02T15:31:04.000Z"
+}

package/fixtures/frames/subscribe.json

@@ -0,0 +1,6 @@
+{
+  "frame": "subscribe",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_ids": ["spc_01K4ZQPX000000000000000002"],
+  "since": 41
+}

package/fixtures/handoff.json

@@ -0,0 +1,20 @@
+{
+  "v": 1,
+  "type": "handoff",
+  "id": "evt_01K4ZQPX00000000000000006C",
+  "ts": "2026-09-02T14:22:08.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "harness",
+    "id": "hrn_01K4ZQPX000000000000000004"
+  },
+  "run_id": "run_01K4ZQPX000000000000000005",
+  "to": "usr_01K4ZQPX000000000000000003",
+  "context_summary": "Northwind has not replied in 48 hours. The PO is confirmed on our side; the tracker is updated.",
+  "open_items": [
+    "Chase Dana for an acknowledgement",
+    "Confirm the pallet count with the warehouse"
+  ],
+  "reason": "Waiting on a person outside the workspace."
+}

package/fixtures/harness.removed.json

@@ -0,0 +1,15 @@
+{
+  "v": 1,
+  "type": "harness.removed",
+  "id": "evt_01K4ZQPX0000000000000000F1",
+  "ts": "2026-09-27T10:00:00.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "harness_id": "hrn_01K4ZQPX000000000000000004",
+  "display_name": "Scout",
+  "homes": ["spc_01K4ZQPX000000000000000002"],
+  "reason": "Only here for a test."
+}

package/fixtures/harness.transferred.json

@@ -0,0 +1,15 @@
+{
+  "v": 1,
+  "type": "harness.transferred",
+  "id": "evt_01K4ZQPX0000000000000000D3",
+  "ts": "2026-09-06T11:00:00.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "harness_id": "hrn_01K4ZQPX000000000000000004",
+  "from_owner_id": "usr_01K4ZQPX000000000000000003",
+  "to_owner_id": "usr_01K4ZQPX000000000000000009",
+  "reason": "Dana runs Scout's projects now."
+}

package/fixtures/hello.json

@@ -0,0 +1,61 @@
+{
+  "v": 1,
+  "type": "hello",
+  "id": "evt_01K4ZQPX000000000000000073",
+  "ts": "2026-09-02T14:22:15.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "system",
+    "id": "system"
+  },
+  "protocol": {
+    "min": 1,
+    "max": 1
+  },
+  "server": {
+    "name": "chipsd",
+    "version": "0.0.0"
+  },
+  "harnesses": [
+    {
+      "harness_id": "hrn_01K4ZQPX000000000000000004",
+      "display_name": "Scout",
+      "owner_id": "usr_01K4ZQPX000000000000000003",
+      "capabilities": ["drive.read", "crm.read", "email.send"],
+      "ephemeral": false
+    }
+  ],
+  "autonomy": 2,
+  "spaces": ["spc_01K4ZQPX000000000000000002"],
+  "policy": {
+    "autonomy": 2,
+    "rules": [
+      {
+        "match": "email.send",
+        "when": {
+          "external": true
+        },
+        "decision": "ask",
+        "approvers": ["owner"],
+        "reason": "External mail always asks."
+      },
+      {
+        "match": "payment.*",
+        "when": {
+          "money_usd_over": 500
+        },
+        "decision": "ask",
+        "approvers": ["role:finance"]
+      },
+      {
+        "match": "drive.read",
+        "decision": "allow"
+      }
+    ]
+  },
+  "budget": {
+    "limit_usd": 25,
+    "spent_usd": 1.47
+  }
+}

package/fixtures/join.allowed.json

@@ -0,0 +1,20 @@
+{
+  "v": 1,
+  "type": "join.allowed",
+  "id": "evt_01K4ZQPX0000000000000000J2",
+  "ts": "2026-10-05T21:05:12.000Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "request_id": "jrq_01K4ZQPX0000000000000000J1",
+  "kind": "harness",
+  "started_by": "requester",
+  "name": "Tide",
+  "software": "tide 0.4.1",
+  "machine": "vps-fra-1",
+  "from_addr": "100.88.4.12",
+  "by": "usr_01K4ZQPX000000000000000003",
+  "capabilities": ["autonomy", "new_spaces"]
+}

package/fixtures/join.denied.json

@@ -0,0 +1,17 @@
+{
+  "v": 1,
+  "type": "join.denied",
+  "id": "evt_01K4ZQPX0000000000000000J3",
+  "ts": "2026-10-05T21:06:40.000Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "request_id": "jrq_01K4ZQPX0000000000000000J4",
+  "kind": "device",
+  "started_by": "requester",
+  "name": "Pixel 9",
+  "from_addr": "192.168.1.41",
+  "by": "usr_01K4ZQPX000000000000000003"
+}

package/fixtures/lane.updated.json

@@ -0,0 +1,17 @@
+{
+  "v": 1,
+  "type": "lane.updated",
+  "id": "evt_01K4ZQPX00000000000000007E",
+  "ts": "2026-09-02T14:22:26.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "system",
+    "id": "system"
+  },
+  "lane_id": "lane_01K4ZQPX00000000000000000A",
+  "state": "completed",
+  "delivery": "queued_to_lead",
+  "summary": "Northwind's unit price is 4 percent under last quarter's average.",
+  "cost_usd": 0.03
+}

package/fixtures/membership.added.json

@@ -0,0 +1,16 @@
+{
+  "v": 1,
+  "type": "membership.added",
+  "id": "evt_01K4ZQPX0000000000000000C9",
+  "ts": "2026-09-02T14:20:05.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "participant_id": "hrn_01K4ZQPX000000000000000004",
+  "participant_kind": "harness",
+  "role": "member",
+  "joined_at": "2026-09-02T14:20:05.004Z"
+}

package/fixtures/membership.removed.json

@@ -0,0 +1,14 @@
+{
+  "v": 1,
+  "type": "membership.removed",
+  "id": "evt_01K4ZQPX0000000000000000CA",
+  "ts": "2026-09-02T18:00:00.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "participant_id": "hrn_01K4ZQPX000000000000000004",
+  "removed_by": "usr_01K4ZQPX000000000000000003"
+}

package/fixtures/membership.replaced.json

@@ -0,0 +1,15 @@
+{
+  "v": 1,
+  "type": "membership.replaced",
+  "id": "evt_01K4ZQPX0000000000000000G3",
+  "ts": "2026-09-30T09:00:00.104Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "system",
+    "id": "system"
+  },
+  "idempotency_key": "replace-spc_01K4ZQPX000000000000000002-hrn_01K4ZQPX000000000000000004",
+  "from": "hrn_01K4ZQPX000000000000000004",
+  "to": "agt_01K4ZQPX0000000000000000A1"
+}

package/fixtures/message.deleted.json

@@ -0,0 +1,15 @@
+{
+  "v": 1,
+  "type": "message.deleted",
+  "id": "evt_01K4ZQPX0000000000000000D5",
+  "ts": "2026-09-06T12:01:00.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "idempotency_key": "delete-1",
+  "message_id": "msg_01K4ZQPX000000000000000067",
+  "reason": "Sent to the wrong room."
+}

package/fixtures/message.edited.json

@@ -0,0 +1,15 @@
+{
+  "v": 1,
+  "type": "message.edited",
+  "id": "evt_01K4ZQPX0000000000000000D4",
+  "ts": "2026-09-06T12:00:00.004Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "idempotency_key": "edit-1",
+  "message_id": "msg_01K4ZQPX000000000000000067",
+  "text": "Working on it \u2014 checking the Northwind quotes first."
+}

package/fixtures/message.handed.json

@@ -0,0 +1,14 @@
+{
+  "v": 1,
+  "type": "message.handed",
+  "id": "evt_01K4ZQPX0000000000000000X2",
+  "ts": "2026-10-02T19:30:00.000Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "system",
+    "id": "system"
+  },
+  "message_id": "msg_01K4ZQPX0000000000000000M9",
+  "agent_id": "agt_01K4ZQPX0000000000000000A1"
+}

package/fixtures/message.heard.json

@@ -0,0 +1,14 @@
+{
+  "v": 1,
+  "type": "message.heard",
+  "id": "evt_01K4ZQPX0000000000000000H7",
+  "ts": "2026-10-03T19:31:00.000Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "agent",
+    "id": "agt_01K4ZQPX0000000000000000A1"
+  },
+  "run_id": "run_01K4ZQPX000000000000000005",
+  "message_id": "msg_01K4ZQPX0000000000000000M9"
+}

package/fixtures/message.held.json

@@ -0,0 +1,14 @@
+{
+  "v": 1,
+  "type": "message.held",
+  "id": "evt_01K4ZQPX0000000000000000G5",
+  "ts": "2026-09-30T09:20:00.000Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "actor": {
+    "kind": "agent",
+    "id": "agt_01K4ZQPX0000000000000000A1",
+    "harness_id": "hrn_01K4ZQPX000000000000000004"
+  },
+  "agent_id": "agt_01K4ZQPX0000000000000000A1",
+  "text": "The nightly price check found the sofa 15% off at West Elm."
+}

package/fixtures/message.hidden.json

@@ -0,0 +1,14 @@
+{
+  "v": 1,
+  "type": "message.hidden",
+  "id": "evt_01K4ZQPX0000000000000000H1",
+  "ts": "2026-10-14T18:41:20.000Z",
+  "workspace_id": "ws_01K4ZQPX000000000000000001",
+  "space_id": "spc_01K4ZQPX000000000000000002",
+  "actor": {
+    "kind": "person",
+    "id": "usr_01K4ZQPX000000000000000003"
+  },
+  "idempotency_key": "hide-1",
+  "message_id": "msg_01K4ZQPX000000000000000067"
+}