mirror of https://github.com/profullstack/logicsrc.git synced 2026-08-13 22:37:29 +00:00

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

2.7 KiB

Raw Blame History

AgentAd

AgentAd is a LogicSRC primitive family for advertising to command-line tools and AI agents. It defines a contract for ads that are disclosed, agent-readable, and terminal-native.

LogicSRC owns the AgentAd schemas; cl1s.tech is the first hosted network built on AgentAd, in the same relationship that CommandBoard.run has to the core LogicSRC primitives. External products may consume the AgentAd contracts directly.

Principles

Disclosure is mandatory. Every ad carries disclosure.sponsored: true and a visible label. An AgentAd unit must never be presentable as organic output.
Agent-readable. Ads may carry a machine_readable payload so an autonomous agent can reason about the offer instead of scraping rendered text.
Terminal-native formats. text, markdown, ansi, banner, json.
Publisher control. Placements declare accepted formats, dimensions, frequency caps, and category blocks.

Primitives

Type	Schema	Validator kind	Purpose
`agentad.ad`	`agentad-ad.schema.json`	`agentad-ad`	A single ad unit
`agentad.placement`	`agentad-placement.schema.json`	`agentad-placement`	A slot in a CLI/agent
`agentad.ad_request`	`agentad-ad-request.schema.json`	`agentad-ad-request`	Request to fill a placement
`agentad.ad_response`	`agentad-ad-response.schema.json`	`agentad-ad-response`	Filled ads + tracking tokens
`agentad.impression`	`agentad-impression.schema.json`	`agentad-impression`	Confirmed display
`agentad.click`	`agentad-click.schema.json`	`agentad-click`	Click / conversion
`agentad.campaign`	`agentad-campaign.schema.json`	`agentad-campaign`	Advertiser campaign

Schemas are published from @logicsrc/schemas and identified under https://schemas.logicsrc.com/.

Validate

npm --workspace @logicsrc/validators run build
node packages/validators/dist/cli.js agentad-ad packages/schemas/fixtures/agentad-ad.yaml
node packages/validators/dist/cli.js agentad-placement packages/schemas/fixtures/agentad-placement.yaml

Human vs. agent consumers

The consumer field on a request changes how an ad is delivered:

human → rendered string with an [Sponsored] header.
agent → structured view with an explicit sponsored: true flag and the machine_readable payload, e.g.

{
  "sponsored": true,
  "advertiser": "Railway",
  "title": "Ship your CLI to production in 60 seconds",
  "url": "https://railway.app/?ref=cl1s",
  "data": { "product": "railway", "install": "npm i -g @railway/cli" }
}

Reference network

cl1s.tech is the hosted AgentAd network: SDK, CLI, and ad-serving service that consume these schemas.

2.7 KiB Raw Blame History