# Oak & Sparrow Buying Guide: buyer-to-agent handoff

The buying guide is an Oak & Sparrow product research experience, not a personal guide by an advisor. It is available at [the guided page](https://oakandsparrow.io/buying-guide), with a copyable plain-text brief, downloadable JSON request, and a response return step. A visitor can take the brief to an external AI agent and paste the reply back in the same browser session.

## Machine-readable contract

Use the [request and response JSON Schema](https://oakandsparrow.io/buying-guide.schema.json) for independent agents. The request object has `kind: "oasse.buying-guide.request"`, `version: "1.0"`, selection fields, source URLs, a bounded task, and the expected response format. Agent responses should use `kind: "oasse.buying-guide.response"`, `version: "1.0"`, `summary`, `recommendedPath`, `evidence`, `risks`, `questions`, and `humanReviewRequired: true`.

`recommendedPath` must be one of `standalone-policy-packs`, `gatekeeper`, `both-evaluate-separately`, `no-product-fit`, or `needs-review`. Each item of `evidence` has `claim`, `source`, and `status` equal to `verified` or `unverified`. The response is an **agent-produced assertion**, not proof of independent verification by Oak & Sparrow.

## Browser agent capabilities

When supported by the visitor's browser and agent, the guided page progressively registers browser-local WebMCP tools: `oasse_read_buying_guide`, `oasse_select_buying_guide_option`, and `oasse_return_buying_guide_agent_reply`. These tools inspect the public request, change visible local selection state using allowlisted values, or place an agent reply into the human-review step. The interface works without these tools through ordinary accessible HTML controls. **There is no public remote buying-guide action API.**

The guide does not send prompts to outside AI providers, create leads, execute Gatekeeper calls, initiate transactions, upload agent replies, or persist them in an application database. Visitors copy or download a brief and separately choose whether to share it. Internal navigation to Public AI or the scan preserves the draft in memory. Refreshing or leaving the application clears it.

All five allowlisted selections must be complete before a handoff or agent return is accepted. The read tool reports `intakeComplete` and returns `handoff: null` until then. Changing a selection clears the previous agent response so it cannot be reviewed against a different scope. Exporting a review requires a complete intake, a bounded agent response, and the visitor's explicit review acknowledgment. The review displays the agent's risks and open questions as well as its evidence claims. Browser tools are scoped to the mounted page and are removed on navigation.

## Optional agentic scan routing

The guide first distinguishes the actor and its actions. If a visitor selects **AI agent** and an external or consequential action such as sending, publishing, transferring funds, changing records, or another consequential action, the guide may show a third option: [the public-evidence readiness scan](https://oakandsparrow.io/readiness-scan). The scan is not suggested just because a workflow is automated or AI helps with reading and drafting. The route is accessible directly if needed. This remains a review of public website evidence, **not** an internal autonomous-agent audit or verification of enforcement.

## Research boundaries

Standalone [Policy Packs](https://oakandsparrow.io/policypacks) are separately licensed source software. [Gatekeeper](https://oakandsparrow.io/gatekeeper/) is an independent runtime authorization offering. This guide does not imply interoperability, compliance certification, execution authority, legal advice, guaranteed current statutory coverage, or product pricing. Read the [public agent discovery page](https://oakandsparrow.io/llms.txt) and only cite sources actually retrieved.

The unpublished Chatham House review editions, CEO Twin personal memories, protected implementations, and private Master Matter Ledger are not retrieval sources for this guide.
