Free digital Offering

What this Offering represents

The agent-safety-handbook-2 Offering represents release 2.1.0 of the Agent Safety Handbook. An Agent can discover the handbook, present its license and described file representations, and offer the advertised PDF download without enrolling with or paying the Service.

{
  "odp_version": "1.0",
  "id": "agent-safety-handbook-2",
  "name": "Agent Safety Handbook",
  "description": "A free handbook covering bounded network access and credential handling for autonomous agents.",
  "web_url": "/handbooks/agent-safety",
  "price": {
    "type": "free"
  },
  "schema": {
    "url": "https://downloads.example/schemas/digital-artifact-2.json"
  },
  "attributes": {
    "version": "2.1.0",
    "license": "CC-BY-4.0",
    "languages": [
      "en"
    ],
    "files": [
      {
        "media_type": "application/pdf",
        "byte_size": 2487310,
        "sha256": "4a44dc15364204a80fe80e9039455cc1608281820fe2b24a4407e5c2250b079d"
      },
      {
        "media_type": "text/markdown",
        "byte_size": 184220,
        "sha256": "f5ca38f748a1d6e4af726b8a42fb575c3c71b5f0b7d1f4e6f5e5d8b7e3c9a101"
      }
    ]
  },
  "actions": [
    {
      "id": "download-pdf",
      "rel": "download",
      "description": "Download the PDF representation without enrollment or payment.",
      "http": {
        "href": "/artifacts/agent-safety-handbook-2.1.0.pdf",
        "method": "GET",
        "response_content_types": [
          "application/pdf"
        ]
      },
      "authentication": "not-required"
    }
  ]
}

Advertise free explicitly

The free Price Preview states that the Service advertises the Offering without a price. Omitting price would mean only that the Offering provides no Price Preview; it would not mean free.

Price, Action purpose, and authentication are separate declarations. free describes price, download describes what the Action does, and not-required describes access to its target. A download Action is not inherently free or anonymous.

Describe the digital artifact

The Attribute Schema defines metadata for this Service's digital artifacts. These fields are not universal ODP properties, and another Service can use a different schema for its own downloadable content.

languages describes the handbook's content. It is separate from ODP's standard language field, which identifies the language of human-readable text in an ODP representation.

Describe each file representation

Each files entry provides a media type, exact byte size, and SHA-256 digest. Applications can display these details before download and use them to check received bytes when appropriate.

File entries are metadata, not download links. ODP does not create an operation from a media type or digest. A Service must advertise an Action or another documented mechanism for every representation it wants an Agent to retrieve.

Download the PDF

The download-pdf Action uses the registered download relation and a compact HTTP target. It provides the method, target, and expected successful response type for the PDF request.

The live response remains authoritative. Its Content-Type determines how the Agent interprets a successful response; response_content_types describes what the Service expects to return. The Service-defined digest can be compared with the received bytes, but ODP does not require every application to store or verify downloaded files.

Follow discovery to download

The Offering separates learning about the handbook from retrieving its bytes. Each network operation happens only when the caller reaches the corresponding step.

Keep digital delivery outside ODP

ODP describes the artifact and identifies the PDF download operation. The Service application hosts the bytes, returns the correct media type, applies any access policy, and keeps the published version and digest metadata accurate. ODP does not define content storage, license enforcement, update delivery, or local file handling.

Inspect the example artifacts

The example domains are illustrative. A deployed Service must host the referenced schema and download target.

• Generated example: open the published example and its source files
• Full Offering: inspect the artifact metadata and PDF download Action
• Attribute Schema: inspect the types and constraints applied to the attributes

Next steps