Changelog · semver · MIT

Every wire-format change. In plain text.

The protocol is semver. Major bumps ship in parallel package versions with an 18-month deprecation window. Minor and patch releases never break the wire format.

v0.3.0 2026-04-25 breaking

Vendor-neutral chat loop

The orchestrator and CLI no longer depend on any one LLM vendor. Point at any chat-completions endpoint — hosted or local.

BREAKING @openkarta/orchestrator: chatOnce now uses the standard chat/completions wire format. Options: { baseURL, model, apiKey? }. Dropped @anthropic-ai/sdk dependency.
BREAKING @openkarta/orchestrator: tool definitions renamed AnthropicToolDef → ToolDef; field input_schema → parameters.
BREAKING @openkarta/cli: openkarta chat now takes --base-url, --model, --api-key. Defaults point at OpenRouter.
WHY Bring your own provider, key, and model — Ollama, llama.cpp, vLLM, or any hosted endpoint.

v0.2.0 2026-04-25 minor

Orchestrator + CLI go public

First consumer-side library: registry → fan-out search → homogeneous cart → signed-quote checkout → order tracking.

ADDED @openkarta/sdk-node: createClient(opts) — typed client wrapping all 8 verbs.
ADDED @openkarta/orchestrator: consumer-side library with registry, fan-out search, homogeneous cart, signed-quote checkout, order tracking.
ADDED @openkarta/cli: openkarta with search / cart / checkout / orders / chat subcommands.
DOCS docs/orchestrator.md and docs/cli.md.

v0.1.0 2026-04-15 minor

Initial public release

The protocol, the SDK, three reference agents, and the conformance suite.

ADDED @openkarta/spec: five item types, discriminated unions, homogeneous cart, CapabilitiesManifest v0.2, closed-enum errors, user-token delegation.
ADDED @openkarta/sdk-node: Fastify server, typed client, HMAC-signed quote tokens, error helpers.
ADDED Reference agents — Halcyon Shop (product + quick-commerce), Halcyon Stays (stay + service), Halcyon Travel (flight + bus).
ADDED @openkarta/conformance-tests: core pack (8) + five per-type packs (22 total). Auto-detects supportedItemTypes; emits a signed badge.
ADDED @openkarta/demo-cli: end-to-end flows for product, stay, and flight.

Watch the GitHub repo or the npm packages directly. Releases are tagged on commit.

GitHub releases ↗