@oni.bot/core 0.6.3 → 0.8.0

package/CHANGELOG.md

@@ -0,0 +1,111 @@
+# Changelog
+
+All notable changes to @oni.bot/core are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.7.0] - 2026-03-08
+
+### Added
+- Structured error codes with `ONI_<CATEGORY>_<NAME>` taxonomy — every error carries code, category, recoverable flag, suggestion, and context
+- Per-node timeouts via `addNode(name, fn, { timeout: ms })` with `NodeTimeoutError`
+- Global default timeout via `compile({ defaults: { nodeTimeout: ms } })`
+- Circuit breaker pattern: `addNode(name, fn, { circuitBreaker: { threshold, resetAfter, fallback? } })`
+- Dead letter queue: `compile({ deadLetterQueue: true })` captures failed node inputs for recovery
+- OpenTelemetry tracing adapter (`ONITracer`) — zero-dep, user brings own tracer
+- Backpressure streaming with `BoundedBuffer` (drop-oldest and error strategies)
+- Testing utilities: `mockModel()`, `assertGraph()`, `createTestHarness()` via `@oni.bot/core/testing`
+- `oni init` CLI command for project scaffolding
+- 7 new error types: `NodeTimeoutError`, `CircuitBreakerOpenError`, `SwarmDeadlockError`, `ModelRateLimitError`, `ModelContextLengthError`, `CheckpointCorruptError`, `StoreKeyNotFoundError`
+
+### Changed
+- `ONIError` now accepts optional `ONIErrorOptions` as second constructor parameter
+- All existing error classes enhanced with structured codes (backward compatible)
+
+## [0.6.3] - 2026-03-05
+
+### Added
+- `set()` alias for `put()` on `InMemoryStore` and `NamespacedStore`
+
+## [0.6.2] - 2026-03-05
+
+### Fixed
+- `createReactAgent` now accepts `ONIModel` (auto-adapts chat to invoke)
+
+### Changed
+- Package renamed from `@oni-bot/core` to `@oni.bot/core`
+
+## [0.6.1] - 2026-03-05
+
+### Changed
+- Removed all external framework references from codebase and documentation
+
+### Fixed
+- Resolved TypeScript strict errors in swarm template `Send` casts
+
+## [0.6.0] - 2026-03-04
+
+### Added
+- `SwarmGraph` builder for multi-agent orchestration
+- `SwarmGraph.hierarchical()` template — supervisor-workers pattern
+- `SwarmGraph.fanOut()` template — parallel agent execution with reducer
+- `SwarmGraph.pipeline()` template — linear chain with conditional transitions
+- `SwarmGraph.peerNetwork()` template — decentralized agent handoffs
+- `SwarmGraph.mapReduce()` template — parallel map with reducer
+- `SwarmGraph.debate()` template — multi-round parallel debate with judge
+- `SwarmGraph.hierarchicalMesh()` template — nested team coordination
+- Lazy coordination auto-wiring (broker and pubsub) on `SwarmGraph`
+- Handoff execution — agent `Handoff` returns converted to `Command` routing
+- Retry-then-fallback — agents retry on failure, fall back to supervisor
+
+### Changed
+- Replaced `SwarmLLM` with `ONIModel` in supervisor routing
+
+## [0.5.0] - 2026-03-04
+
+### Added
+- `ONIModel` interface and core LLM types
+- Anthropic LLM adapter
+- OpenAI LLM adapter
+- Ollama LLM adapter
+- Google Gemini LLM adapter
+- Models export path and re-exports
+- Tool framework with `defineTool()` and `ToolContext`
+- `AgentContext` and agent types
+- `defineAgent()` declarative agent factory
+- `agent()` functional agent factory
+- `addAgent()` on `StateGraph` to wire agent nodes
+- Request/response and pub/sub coordination patterns
+- Tool permission guardrails
+- Budget tracking and cost control guardrails
+- Content filtering guardrails
+- Audit trail and guardrails exports
+- `EventBus` for structured lifecycle events
+- Guardrails and event bus wired into compile/execution pipeline
+- Integration tests for agents, tools, and guardrails
+
+### Removed
+- Direct `openai` dependency (adapters are now bring-your-own-client)
+
+## [0.4.0] - 2026-03-04
+
+### Added
+- `StateGraph` builder with `addNode()`, `addEdge()`, `addConditionalEdges()`
+- Pregel execution engine (`ONIPregelRunner`) with parallel superstep execution
+- `Command` and `Send` primitives for dynamic routing
+- Subgraph support via `addSubgraph()`
+- Functional API (`entrypoint`, `task`)
+- `MemoryCheckpointer` and `NoopCheckpointer`
+- `InMemoryStore` and `NamespacedStore` for shared key-value state
+- Human-in-the-loop via `interrupt()` and `getUserInput()`
+- Token streaming with `emitToken()` and `TokenStreamWriter`
+- Stream modes: `values`, `updates`, `events`, `messages`, `custom`
+- Graph inspection via `getGraphDef()`
+- `createReactAgent` prebuilt for tool-calling loops
+- `ToolNode` prebuilt for automatic tool dispatch
+- Messages reducer (`messagesReducer`, `addMessages`, `removeMessages`)
+- Retry policies with configurable backoff
+- Swarm primitives: `AgentRegistry`, `AgentPool`, `Mailbox`, `Supervisor`
+- Ephemeral channel support
+- Map-reduce parallel fan-out pattern