@measurelab/seam-core

Core library for SEAM, the intelligence layer between AI agents and the data sources they query. Built by Measurelab.

This package contains the loader, validator, compiler and resolver. It is consumed by @measurelab/seam-cli and the SEAM MCP server.

Install

npm install @measurelab/seam-core

Usage

import { loadDefinitions, validate, compile, resolve } from "@measurelab/seam-core";

const defs = await loadDefinitions("./definitions");
const errors = validate(defs);
if (errors.length === 0) {
  const manifest = compile(defs);
  const result = resolve("monthly revenue", manifest);
}

What's inside

• Loader: reads YAML definition files (metric:, entity:, connection:, resource:) from a directory tree
• Validator: JSON Schema validation plus cross-reference, governance and SQL semantic-model checks
• Compiler: produces a manifest.json with cross-refs (sources, entity systems, resource hierarchy)
• Resolver: maps natural-language queries to canonical metric or entity handles with governance metadata

Docs

• Concepts (intelligence layer, intelligence model, manifest, resolver): https://measurelab.ai/docs/concepts/
• Glossary (every SEAM term, defined): https://measurelab.ai/docs/glossary/
• CLI (install, commands, examples): https://measurelab.ai/docs/cli/

License

Apache-2.0