@agent-ui-kit/schemas

v0.0.2

Shared schema engines for the AgentUI MCP ecosystem. Provides TypeScript types, validation, and runtime engines used by both the agent-ui and workflow-runtime MCP servers.

Install

npm install @agent-ui-kit/schemas

Subpath Imports

// Graph primitives — nodes, edges, containers, traversal
import { Node, Edge, GraphContainer } from '@agent-ui-kit/schemas/graph';

// Control stream — event logging, metrics, replay
import { ControlStream, EventLog, MetricsCollector } from '@agent-ui-kit/schemas/control';
import type { StepReport, PipelineEvent } from '@agent-ui-kit/schemas/control';

// WDS workflows — load, validate, execute workflow definitions
import { WorkflowsEngine } from '@agent-ui-kit/schemas/workflows';
import type { WorkflowDefinition, Stage } from '@agent-ui-kit/schemas/workflows';

// RDS relationships — component-to-component and component-to-token
import { RelationshipsEngine } from '@agent-ui-kit/schemas/relationships';

// Multi-agent orchestration — routing, capability matching
import { OrchestrationEngine } from '@agent-ui-kit/schemas/orchestration';

// Training library — search, domain matching, context slicing
import { TrainingLibraryEngine } from '@agent-ui-kit/schemas/training';

// Skills — load, search, rank skill guides
import { SkillsEngine } from '@agent-ui-kit/schemas/skills';

Engine API Summaries

ControlStream / EventLog / MetricsCollector

Record PipelineEvents with timing data, query event logs with filters, collect boundary metrics (confidence, token utilization, timing). Powers structured logging and replay in both MCP servers.

WorkflowsEngine

Load WDS definitions from JSON/YAML, validate against the schema, register workflows, and execute pipelines with typed inputs/outputs.

RelationshipsEngine

Model and query relationships between components, traits, tokens, and blocks. Used for dependency analysis and context slicing.

OrchestrationEngine

Register MCP agents with capability declarations, route tasks to the best matching agent, score capability overlap.

TrainingLibraryEngine

Search across component/trait/block catalogs by tag, name, category, or free text. Domain matching and context slicing for AI-powered generation.

SkillsEngine

Load markdown skill guides, search by query with ranked results, match trigger phrases.

Package Structure

schemas/
  src/
    graph/           Node, Edge, GraphContainer, traversal, composition
    control/         StepReport, PipelineEvent, ControlStream, EventLog, MetricsCollector
    workflows/       WorkflowDefinition, WorkflowsEngine, WDS validator
    relationships/   RelationshipsEngine, RDS types
    orchestration/   OrchestrationEngine, agent/capability types
    training/        TrainingLibraryEngine, manifest types
    skills/          SkillsEngine, skill metadata types
    index.ts         Top-level barrel
  package.json
  tsconfig.json

Build

npm run build       # tsc → dist/
npm run dev         # tsc --watch
npm run typecheck   # tsc --noEmit

Related

• Agent UI MCP: packages/agent-mcp/servers/agent-ui/ — 24-tool UI generation server
• Workflow Runtime MCP: packages/agent-mcp/servers/workflow-runtime/ — 12-tool generic WDS engine
• Component library: packages/agent-ui/ — @agent-ui-kit/web-components