Skip to main content

Module client

Module client 

Source
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.
InspectorDisconnected
The inspector connection ended or failed during a request.
InspectorRequestTimeout
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.