@chore-o-matic/catalog

The capability catalog for Chore-o-matic. Entry manifests describing tools, channels, and (future) agent templates that a chore-agent can be given.

Distributed as an npm package. Downstream components (the interview meta-agent, the generator, the specification validator) depend on this package for tool discovery and use: reference resolution.

Tool and channel implementations live in eve-contrib as generic @chore-o-matic/eve-* eve packages. This catalog adds chore-o-matic-specific metadata: house-voice descriptions, approval defaults, connection slot definitions, and config schemas.

Install

npm install @chore-o-matic/catalog

Use

import { resolveUse, entriesByKind, allEntries } from "@chore-o-matic/catalog";

// Resolve a spec's `use:` reference to a catalog entry.
const entry = resolveUse("google-calendar.read");

// Get all tool entries (grounds the interview meta-agent).
const tools = entriesByKind("tool");

// Get all entries (tools + channels + future templates).
const everything = allEntries();

Entry ids

Ids are dotted, human-readable, and stable across package renames:

• google-calendar.read
• google-calendar.create-event
• sendgrid.send-email
• google-sheets.append-row
• webhook.send
• whatsapp

The spec's use: field holds the id. The resolver maps it to the implementation package and member.

Adding a capability

1. Publish an @chore-o-matic/eve-* package in eve-contrib with the tool/channel factory.
2. Add an entry manifest in src/entries/.
3. Publish a new version of this package.

No downstream component changes required — the interview and generator read entries dynamically.

Develop

npm run build      # tsc -> dist/
npm run typecheck
npm test           # hermetic unit tests