Expand description
The socket transport, connecting half. The socket transport, connecting half: finding a running host, and talking to it.
§Why this is a sibling of the server and not a layer above it
A peer can be both. AgencyZero is driven by agents over this protocol while it drives a browser it embeds, and a QA harness that launches a headless host is a client of one socket in a process that could serve another. The two halves share the vocabulary, the framing and the error taxonomy, and neither is built on the other, so a build takes whichever halves it needs.
Neither half needs blitz. The framing is the protocol; the document is not.
ps-qa takes this feature and nothing else, and cargo tree -p ps-qa
showing no renderer, window runtime or GPU stack is the check that keeps it
that way.
The transport is deliberately not hand-rolled. Frames are length-prefixed
rather than newline-delimited, which is why a naive socket read hangs, and
endpoint_libs’ framed_json_neutral is the same codec the server writes with.
This was ps-qa’s inspector module. It moved here so there is one client
rather than one per consumer: the browser’s own chuzz-inspect had grown a
second one that built its requests as untyped JSON by hand, with a comment
explaining which fields the runtime would and would not accept.
Structs§
- Answer
- Client
- A connected inspector client.
- Descriptor
- Where an inspector announced itself, and what it said.
- Inspector
Disconnected - The inspector connection ended or failed during a request.
- Inspector
Request Timeout - A request exceeded its single transport deadline.
Functions§
- discover
- Locate a running inspector, preferring an explicitly pinned descriptor.
- inspect
- Read the application’s semantic tree and report the inspector round-trip.
- inspect_
subtree - Read only one semantic subtree.
- is_
pending - Whether a host has no completed GPUBuffer write available yet.
- is_
unsupported - Whether a host refused a request because it does not have the thing asked for, rather than because something went wrong.
- safe_
response_ code - Return a bounded response category without exposing the inspector message.