@warmio/contracts

@warmio/contracts

Machine-readable, side-effect-free contracts for Warm's public API and authenticated/local MCP surfaces. This is a contract package, not a client SDK: it contains schemas, inferred DTOs, endpoint metadata, examples, OpenAPI generation, and MCP descriptors; it does not perform network requests or start a server.

import { API_ORIGIN, apiEndpointManifest } from '@warmio/contracts/manifest';
import { financialContextSchema } from '@warmio/contracts/schemas';
import { buildOpenApiYaml } from '@warmio/contracts/openapi';

@warmio/contracts/manifest is intentionally safe for docs, MCP, app, and edge consumers that need API, product, package-distribution, auth, rate-limit, endpoint, or MCP facts. Authenticated/local MCP definitions are exported from the root or @warmio/contracts/mcp; public discovery MCP tools remain owned by the edge worker.

Warm publishes this package from jasonstockman/warm-app. Warm is pre-public-user, so package versions coordinate exact internal dependency updates rather than promise backwards compatibility. Contract changes are clean cutovers: remove old exports and shapes, update all Warm consumers, and regenerate documentation in the same release. Do not add compatibility re-exports, deprecated aliases, or dual contracts.

The package is publicly readable for Warm's runtime and documentation consumers, but it is not open-source licensed. Public npm visibility does not grant permission to copy or redistribute its source beyond applicable package-use terms.