Skip to main content
Source diagnostics is a Seller Page for call-level investigation of one inventory source. It shows how the source is configured, what recent buyer traffic did, which operations are failing and who has to act. The Page also repairs one thing: an active external-Agent source that has no registered Agent relationship.

​
Open the Page

sourceId comes from search({ "kind": "inventory_source" }). Leave it out to open the Page with no source selected and choose one there. Only a Seller Account can open the Page. A Buyer Account is refused with a wrong-account error.
Source activity does not prove demand. A Seller Account that is not ready can correctly show no source calls, because work stops before a buyer request reaches a source. Call get_status first. Its blockers name the pre-dispatch problem and the next tool or Page.

​
What the Page shows

Choose Source health on a source to read its health object one section at a time:
  • Source. The seller account, the source and its connection type, the Agent that powers it, and whether buyer requests reach it, with reason codes when they do not. When setup is incomplete, the steps still to finish are listed, and each opens Seller Setup.
  • Health by operation. One row for each AdCP operation Apostra performs against the source, with its status, call counts, the last success and the last failure, and who acts on it.
  • Diagnosis. Each finding with its severity, the operation it is about, who acts, the next step, and Show calls to expand the calls behind it.
  • Open operations. Work still waiting at this source, what it waits for and who it waits on.
Technical details holds the source tests, protocol calls, transport evidence, tool declarations and request signing. It is for investigating a fault, not for routine setup. Health uses one vocabulary: Healthy, Degraded, Erroring and Unknown. A source that has never been observed reads Unknown. A timeout condition means a call did not finish inside the observer’s time budget. It is degraded evidence, not an error response from the source. Setup, request eligibility and health are separate. A degraded or erroring source still receives buyer requests unless it is paused, not set up, or mapped to an ineligible Agent. When an active external-Agent source has no registered Agent relationship, the source’s owner can create or attach the Agent from this Page. This is the only write the Page owns, and open_page carries no input for it. The person who owns the source does it in the Page. Credentials and authority changes stay human steps in the Page and never pass through a model.

​
Read the same evidence without the Page

V3 has typed reads and one action beside the Page: refresh_inventory_source_health works only on an external sales-agent source. Managed and modular sources have their own diagnostics.

​
What V3 covers and what it does not

V3 opens this Page with an optional sourceId. It does not provide a tool for the Page’s run histories: the intelligence runs and the agent test runs. Those are Page reads that a person uses. An agent that needs that detail opens the Page and points the person at it rather than describing runs it cannot read.