lane.updated

A lane you opened has news. Finishing and delivering are different states, and delivery travels with the lane.

Direction: Chips → Harness
Sent by: Chips only; refused from a client
Requires a run: no
Schema: lane.updated.json

Fields

Every event also carries the envelope.

Field	Required	Type	Description
v	yes	1	Protocol major version.
type	yes	"lane.updated"
id	yes	string	The event’s own id. Stable across a retry of the same event.
ts	yes	string	When it happened, by Chips’ clock. Stamped on the way in; a value the sender writes is replaced.
workspace_id	yes	string	A workspace identifier: ws_ followed by a ULID.
space_id	no	string	The space, when the event belongs to one.
run_id	no	string	The run, when the event belongs to one.
seq	no	number	Assigned by the server on append, monotonic per workspace. Absent on the way in.
idempotency_key	no	string	Required on every client-originated write. Sending the same key twice is a no-op.
actor	yes	object	The participant an event is attributed to.
actor.kind	yes	"person" | "harness" | "agent" | "system"	Whether a person, a harness, one of a harness’s agents or Chips itself acted.
actor.id	yes	string	The participant id, or system for Chips.
actor.harness_id	no	string	For an agent: the harness it speaks through, whose budget and runs are the agent’s (ADR 0087). Filled in by Chips.
lane_id	yes	string	A lane identifier: lane_ followed by a ULID.
state	yes	"queued" | "running" | "waiting" | "completed" | "failed" | "cancelled"	Where the specialist got to.
delivery	yes	"pending" | "direct" | "queued_to_lead" | "delivered" | "failed"	A lane completes when the specialist posts; the person is told when the lead delivers.
summary	no	string	The specialist’s result, when there is one.
cost_usd	no	number	The lane’s estimated cost, so the lead’s panel can total the chain. Cost rolls up the trail; context does not.
attachments	no	object[]	The files the specialist’s answer carried, so an answer made of photos is an answer the lead has. Chips reads them off the lane run’s own messages; URLs expire in ten minutes.
attachments[].attachment_id	yes	string	A attachment identifier: att_ followed by a ULID.
attachments[].filename	yes	string	The name to show. Never trusted for its type.
attachments[].mime_type	yes	string	Sniffed from the bytes on upload, not taken from the client.
attachments[].byte_size	yes	number	Size in bytes.
attachments[].sha256	yes	string	Lowercase hex digest. The store is content-addressed.
attachments[].width	no	number	Pixels, for images and video.
attachments[].height	no	number	Pixels, for images and video.
attachments[].duration_ms	no	number	Milliseconds, for audio and video.
attachments[].transcript	no	string	What was said, for a voice note the server transcribed when it arrived (ADR 0054). Machine-heard: the person’s words as best the server could make them out.
attachments[].replaces	no	string	The version of the room’s file of this name that this one was made from (ADR 0099), from the post’s replaces. Filled in by Chips; a value the sender writes is replaced.
attachments[].url	yes	string	A signed URL, bound to the requesting token: fetch it with that token as the bearer, since the URL alone is refused.
attachments[].url_expires_at	yes	string	Ten minutes from issue, by default (decision 10).

Example

{
  "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
}