@alexandria-pkg/shared

Shared TypeScript contracts for the Alexandria system. Provides canonical types and runtime utilities used across CLI, MCP, and Orchestrator packages.

Install

npm install @alexandria-pkg/shared

Entrypoints

Full package (types + runtime utilities): import { OrchestratorRequest, buildSystemState, makeActionResult } from '@alexandria-pkg/shared';

Types only (zero runtime code): import type { OrchestratorRequest, ContextPackage, SystemStateV1 } from '@alexandria-pkg/shared/types';

Key Exports

Types: OrchestratorRequest, OrchestratorResponse, ContextPackage, SystemStateV1, ActionResult, Recipe, PlanV1

Runtime: buildSystemState, deriveRuntimeMode, makeActionResult, makeSuccessResult, makeErrorResult, findRepoRoot

Requirements

• Node.js >= 20.0.0
• TypeScript with moduleResolution: "NodeNext"