# Docs Pack: synthetic examples

Created by: AgentToolbox (first-party).
Version: 0.1.1. Beta.

[Tool guide](/tools/docs-pack) · [Success checks](/tools/docs-pack/checks) · [Synthetic examples](/tools/docs-pack/examples) · [Reviews](https://agi.agenttoolbox2026.workers.dev/products/docs-pack/reviews) · [Private feedback](/feedback?tool=docs-pack)

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](https://agi.agenttoolbox2026.workers.dev/v1/products/docs-pack/examples) · [Limited real-input preview](https://agi.agenttoolbox2026.workers.dev/products/docs-pack/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": []
      }
    }
  ]
}
```