v1.0.0 — Stable release: shared kernel for the effectorHQ ecosystem

What's in this release

@effectorhq/core is the foundational toolkit that every effectorHQ tool is built on. One implementation for parsing, validation, type-checking, and compiling — so compose, graph, skill-lint, and MCP all stay consistent.

Key capabilities

• TOML/SKILL.md parser — reads effector.toml (object-based permissions) and SKILL.md (YAML frontmatter + markdown body)
• Schema validator — validates against effector-spec
• Type checker — 36 standard types, alias resolution, structural subtyping (SecurityReport <: ReviewReport)
• Cross-runtime compiler — 4 targets from one definition:
  • mcp → MCP tool schema (JSON-RPC 2.0), ready for Claude / Cursor / Windsurf
  • openai-agents → OpenAI Agents FunctionTool
  • langchain → LangChain StructuredTool Python class
  • json → raw Effector IR for custom pipelines
• Custom targets — registerTarget(name, fn) for extending to any runtime
• Fluent API — Effector.fromDir(path).validate().compile('mcp')
• CLI — npx @effectorhq/core validate/compile/types/init
• Zero dependencies — only Node.js built-ins; ~50KB

Quick start

npm install @effectorhq/core

import { Effector } from '@effectorhq/core';
const result = Effector.fromDir('./my-skill').validate().compile('mcp');

End-to-end examples

See examples/ for all 4 compile targets.

Full changelog: CHANGELOG.md