mirror of
https://github.com/profullstack/logicsrc.git
synced 2026-08-14 06:47:28 +00:00
Anthony Ettinger
60ba38a575
AgentAd is a disclosed, agent-readable advertising contract for CLI tools
and AI agents. LogicSRC owns the canonical schemas; cl1s.tech is the
reference network built on them.
- packages/schemas: agentad-{ad,placement,ad-request,ad-response,
impression,click,campaign} schemas (id under schemas.logicsrc.com) +
ad/placement fixtures, exported from @logicsrc/schemas
- packages/validators: register the 7 agentad kinds, wire fixture
validation, add tests (disclosure.sponsored must be true)
- docs/agentad.md: the AgentAd spec
- README: list AgentAd under v1 priorities
Validators build clean; all fixtures validate; vitest 4/4 green.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
31 lines
1.4 KiB
JSON
31 lines
1.4 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://schemas.logicsrc.com/agentad-ad-response.schema.json",
|
|
"title": "AgentAd Ad Response",
|
|
"description": "The network's response to an ad request: zero or more filled ads plus signed tracking tokens for impression/click events.",
|
|
"type": "object",
|
|
"required": ["type", "version", "request_id", "ads"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"type": { "const": "agentad.ad_response" },
|
|
"version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
|
|
"request_id": { "type": "string", "minLength": 1 },
|
|
"ads": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["ad", "impression_token"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"ad": { "type": "object", "description": "An agentad.ad document; validate separately against agentad-ad.schema.json." },
|
|
"impression_token": { "type": "string", "minLength": 1, "description": "Opaque token to confirm the impression and to mint a click token." },
|
|
"rendered": { "type": "string", "description": "Server-rendered representation in the requested format." }
|
|
}
|
|
}
|
|
},
|
|
"no_fill_reason": {
|
|
"type": "string",
|
|
"enum": ["no_inventory", "frequency_capped", "blocked_category", "invalid_request"]
|
|
}
|
|
}
|
|
}
|