Docs Pack: synthetic examples
Created by: AgentToolbox (first-party).
Version: 0.1.1. Beta.
Free offline fixtures; no tool runs, source fetches, endpoint probes or payments occur here. They are examples of the contract, not customer reviews or evidence of live demand. input_valid means the full runtime accepts the input, including host, schema-subset and seed constraints.
Canonical fixture JSON · Limited real-input preview
```json
{
"api_version": "1",
"fixture_version": "1",
"product_id": "docs-pack",
"version": "0.1.1",
"publisher": "AgentToolbox",
"provenance": "first_party_synthetic_fixture",
"example_kind": "offline_contract_examples",
"execution": "none",
"payment": {
"status": "not_required",
"amount_settled_atomic": "0"
},
"fixed_clock": "2026-10-07T00:00:00.000Z",
"interpretation": "Static authored examples, not live remote observations, payment verification, customer outcomes or proof of usefulness. Fixture URLs identify mocked responses; do not invoke the live service with these fixture inputs.",
"expected_format": "input_valid means the complete handler input validation passed, including runtime restrictions such as supported hosts, schema keywords and a valid seed. It is not just validation against the published JSON Schema, which cannot express every runtime restriction. outcome_qualifies tests the handler success predicate, not a payment. checks compare exact values at RFC 6901 JSON Pointers into the output; unlisted fields are not asserted. failure_reason names the handler failure code when no output is returned.",
"contract_path": "/v1/products/docs-pack",
"criteria_path": "/v1/products/docs-pack/criteria",
"purpose": "Inspect exact query-matched excerpts and their hashes/offsets before deciding whether the bounded pack is useful.",
"independent_check": "SHA-256 the fixture bytes; trim its final newline for normalized text, then slice each excerpt at its UTF-16 offsets and check the literal query match.",
"live_example_path": "/v1/products/docs-pack/example",
"real_input_preview": {
"supported": true,
"path": "/v1/products/docs-pack/prepare",
"scope": "Optional limited private preview; full output withheld. Separate capability, budget, quote and payment flow applies."
},
"cases": [
{
"id": "matched_excerpt",
"description": "A short Markdown source contains the query. This is invented fixture prose, not Python documentation.",
"input": {
"urls": [
"https://docs.python.org/3/agenttoolbox-fixture.txt"
],
"query": "retries",
"max_excerpt_chars": 1000
},
"fixture": {
"kind": "http_responses",
"responses": [
{
"url": "https://docs.python.org/robots.txt",
"status": 200,
"headers": {
"Content-Type": "text/plain"
},
"body": "User-agent: *\nAllow: /"
},
{
"url": "https://docs.python.org/3/agenttoolbox-fixture.txt",
"status": 200,
"headers": {
"Content-Type": "text/markdown"
},
"body": "# Fixture guide\n\nRetries wait before the next request.\n"
}
]
},
"expected": {
"input_valid": true,
"outcome_qualifies": true,
"checks": [
{
"pointer": "/fetched_at",
"value": "2026-10-07T00:00:00.000Z"
},
{
"pointer": "/excerpt_chars",
"value": 54
},
{
"pointer": "/sources/0/source_bytes",
"value": 55
},
{
"pointer": "/sources/0/source_sha256",
"value": "525016463d3005964dc57581da43669f8c8934d62e95b12870ce0a829569f0b3"
},
{
"pointer": "/sources/0/text_sha256",
"value": "8fc0078e21ab3599d0f3020dbf212132a26f5a3e43a2615ef8e8c6aae1aaed6a"
},
{
"pointer": "/sources/0/excerpts",
"value": [
{
"text": "# Fixture guide\n\nRetries wait before the next request.",
"start_char": 0,
"end_char": 54,
"heading": "Fixture guide",
"anchor": null,
"matched_terms": [
"retries"
]
}
]
}
]
}
},
{
"id": "no_match",
"description": "Valid input with no literal source match fails the whole pack before settlement.",
"input": {
"urls": [
"https://docs.python.org/3/agenttoolbox-fixture.txt"
],
"query": "cancellation",
"max_excerpt_chars": 1000
},
"fixture": {
"kind": "http_responses",
"responses": [
{
"url": "https://docs.python.org/robots.txt",
"status": 200,
"headers": {
"Content-Type": "text/plain"
},
"body": "User-agent: *\nAllow: /"
},
{
"url": "https://docs.python.org/3/agenttoolbox-fixture.txt",
"status": 200,
"headers": {
"Content-Type": "text/markdown"
},
"body": "# Fixture guide\n\nRetries wait before the next request.\n"
}
]
},
"expected": {
"input_valid": true,
"outcome_qualifies": false,
"checks": [],
"failure_reason": "no_matching_excerpt"
}
},
{
"id": "unsupported_host",
"description": "Arbitrary hosts are rejected by the input contract without a fetch.",
"input": {
"urls": [
"https://example.invalid/guide"
],
"query": "retries",
"max_excerpt_chars": 1000
},
"fixture": {
"kind": "none"
},
"expected": {
"input_valid": false,
"outcome_qualifies": false,
"checks": []
}
}
]
}
```