Reference

Техническая справка по формату и SDK.

Формат

• Ontology — entities, intents, roles, invariants, rules, projections
• Intent particles — α (move), effects, conditions, parameters, witnesses
• Invariant kinds — referential / aggregate / transition / cardinality / role-capability / expression
• Role / permission model — base roles (owner / viewer / agent / observer / admin), permittedFor, multi-owner
• Rules engine — event-condition-action + 4 extensions (aggregation / threshold / schedule / condition)

SDK API

8 пакетов в @intent-driven/*:

Пакет	Назначение
core	engine, fold, crystallize_v2, invariants, materializers, salience, patterns
renderer	ProjectionRendererV2, 7 архетипов, primitives
adapter-mantine / adapter-shadcn / adapter-apple / adapter-antd	4 UI-kit реализации
canvas-kit	9 SVG/canvas утилит
cli	create-idf-app scaffold-генератор
server	BFF-handlers для document / voice / agent
auth	JWT + Supabase providers + useAuth hook
effect-runner-http	HTTP CRUD-runner
mcp-server	MCP-server для Claude Desktop

Agent API

• GET /api/agent/:domain/schema — доступные intent'ы и роли
• GET /api/agent/:domain/world?as=role — viewer-scoped Φ-срез
• POST /api/agent/:domain/exec — выполнить intent (с preapproval check)
• Preapproval guards — 5 predicate kinds: active / notExpired / maxAmount / csvInclude / dailySum

Материализации

• /api/document/:domain/:projection?format=html|json&as=role
• /api/voice/:domain/:projection?format=json|ssml|plain
• /api/agent/:domain/exec — агентская
• Pixels — через ProjectionRendererV2 в React

:::note Подробная справка — в процессе Полная документация API генерируется из JSDoc + typedoc. Пока что — исходники в idf-sdk остаются источником истины. :::