Core

Core contracts and deterministic baseline behavior for the child-safe agent runtime.

v1 Public API (import from '@child-agent/core')

The root barrel is the stable public surface. It exports:

• policy — classification types, interfaces, and deterministic classifier
• profiles — age/language profile contracts
• session — session and interaction identity contracts
• safety — sanitized input and signal contracts
• events — minimized parent-event derivation
• voice — interface-only voice boundaries
• response — response mode selection contracts
• conversation — language, thread, continuation, and constraint contracts
• orchestration — canonical decision-flow composition
• output — output planning contracts

Subpath Modules (SUBPATH_API)

Import via explicit subpaths. Not available from the root barrel. Shape may change without notice:

import { ... } from '@child-agent/core/render';
import { ... } from '@child-agent/core/text';
import { ... } from '@child-agent/core/audio';
import { ... } from '@child-agent/core/presentation';
import { ... } from '@child-agent/core/catalog';
import { ... } from '@child-agent/core/conversation';
import { ... } from '@child-agent/core/text-realization';
import { ... } from '@child-agent/core/audio-realization';
import { ... } from '@child-agent/core/bundle';

Design Rules

• keep policy outside of the model
• prefer interfaces over fake integrations
• make refusal and adult escalation first-class outcomes
• keep memory minimal, explicit, and internal until the public API is defined
• do not import internal helpers (normalize, keywords, signals, mapping rules) from outside packages/core

See contracts.md for full classification details.