Skip to content

Add AgentAd ad schemas as a LogicSRC primitive#10

Open
ralyodio wants to merge 2 commits into
masterfrom
agentad-spec
Open

Add AgentAd ad schemas as a LogicSRC primitive#10
ralyodio wants to merge 2 commits into
masterfrom
agentad-spec

Conversation

@ralyodio

Copy link
Copy Markdown
Contributor

Adds AgentAd — a disclosed, agent-readable advertising contract for CLI tools and AI agents — as a LogicSRC primitive family. LogicSRC owns the canonical schemas; cl1s.tech is the reference network built on them.

What's added

  • packages/schemas/schemas/agentad-*.schema.json — ad, placement, ad-request, ad-response, impression, click, campaign ($id under https://schemas.logicsrc.com/)
  • packages/schemas/fixtures/agentad-{ad,placement}.yaml, exported from @logicsrc/schemas
  • packages/validators — registers the 7 agentad-* kinds, wires fixture validation, adds tests (an ad with disclosure.sponsored: false is rejected)
  • docs/agentad.md — the AgentAd spec
  • README — AgentAd listed under v1 priorities

Design

  • Disclosure is mandatory: every agentad.ad requires disclosure.sponsored: true and a visible label, so a unit can never be mistaken for organic output.
  • Agent-readable: ads carry an optional machine_readable payload; consumer: agent requests get the structured view with an explicit sponsored flag.

Verification

  • @logicsrc/validators builds clean (tsc)
  • validate:fixtures passes for task, agent, agentad-ad, agentad-placement
  • vitest 4/4 green

🤖 Generated with Claude Code

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>
@github-actions

Copy link
Copy Markdown

vu1nz Security Review

0 finding(s) in PR #?

No security issues found.

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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant