logicsrc/packages/schemas
Anthony Ettinger 7eba9efd10
Some checks are pending
CI / build (push) Waiting to run
test / test (push) Waiting to run
Make the @logicsrc packages publishable (#134)
@logicsrc/opencontext could not be installed from npm. Three defects, each of
which alone breaks a published tarball:

1. opencontext depended on "@logicsrc/validators": "file:../validators". A
   file: specifier is unresolvable for anyone installing from the registry, so
   `npm install @logicsrc/opencontext` failed outright.

2. validators imported all 50 schemas by relative path across the repository
   ("../../schemas/schemas/*.json"). That resolves inside the monorepo and
   escapes the package once published, so an installed validators could not
   load a single schema. Now imported through @logicsrc/schemas package
   exports, with a real dependency declared.

3. Three of those schemas — repo, pull-request, openprd-prd — had no entry in
   the schemas exports map, so they were unreachable by package specifier.
   Added; the map is now sorted so it stays readable as it grows.

validators also gained files/publishConfig/license so it publishes the same way
its siblings do.

Verified the way a stranger would: npm pack all three, install the tarballs
into a clean project outside the monorepo, and run the installed binary —
version, init, validate --strict (which exercises schema loading through the
package exports), and resolve --explain all succeed. Full workspace suite green.

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-09 12:03:41 -07:00
..
fixtures Add the LogicSRC OpenContext specification (#132) 2026-08-09 11:46:11 -07:00
schemas Add the LogicSRC OpenContext specification (#132) 2026-08-09 11:46:11 -07:00
package.json Make the @logicsrc packages publishable (#134) 2026-08-09 12:03:41 -07:00
README.md Add AgentAd ad schemas as a LogicSRC primitive (#10) 2026-06-11 21:02:43 -07:00

@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.