logicsrc/packages/schemas/schemas/agentad-click.schema.json
Anthony Ettinger 7cda686059
Add AgentAd ad schemas as a LogicSRC primitive (#10)
* Add AgentAd ad schemas as a LogicSRC primitive

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>

* Prepare @logicsrc/schemas for npm publish

Add license, repository, homepage, keywords, publishConfig (public),
and a package README covering both the logicsrc-* core schemas and the
agentad-* family.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-11 21:02:43 -07:00

23 lines
1 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://schemas.logicsrc.com/agentad-click.schema.json",
"title": "AgentAd Click",
"description": "A consumer action on an ad (a click, install, or conversion). For agents, 'action' records the structured intent taken.",
"type": "object",
"required": ["type", "version", "click_token", "ad_id", "occurred_at"],
"additionalProperties": false,
"properties": {
"type": { "const": "agentad.click" },
"version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
"click_token": { "type": "string", "minLength": 1 },
"ad_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
"placement_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
"action": {
"type": "string",
"enum": ["click", "open_url", "copy_command", "install", "convert"],
"default": "click"
},
"consumer": { "type": "string", "enum": ["human", "agent"] },
"occurred_at": { "type": "string", "format": "date-time" }
}
}