logicsrc/packages/schemas/README.md
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

1.1 KiB

@logicsrc/schemas

Canonical JSON Schemas (draft 2020-12) for the LogicSRC open coordination standards, maintained by Profullstack, Inc.

Two schema families ship from this package:

  • LogicSRC corelogicsrc-*.schema.json: tasks, agents, runs, events, plugins, connected accounts, email messages, social posts.
  • AgentAdagentad-*.schema.json: a disclosed, agent-readable advertising contract for CLI tools and AI agents (ads, placements, requests, responses, impressions, clicks, campaigns). See docs/agentad.md in the repo; cl1s.tech is the reference network.

Install

npm install @logicsrc/schemas

Use

import adSchema from "@logicsrc/schemas/agentad-ad" with { type: "json" };
import taskSchema from "@logicsrc/schemas/task" with { type: "json" };

Schema $ids resolve under https://schemas.logicsrc.com/. Validate with any draft 2020-12 validator (e.g. ajv/dist/2020.js), or use @logicsrc/validators from the monorepo.

License

MIT © Profullstack, Inc.