agentic_core 0.1.0

Foundation layer of the agentic framework for Dart and Flutter: immutable message and content models, JSON Schema, a structured error hierarchy, cancellation, retry and circuit-breaker policies, a typ [...]

Changelog

0.1.0

Initial release of the foundation layer.

Added

• Messaging — Message, MessageRole and a sealed ContentPart hierarchy covering text, reasoning, images, files, audio, tool calls and tool results. ConversationHistory extensions for trimming and for finding unanswered tool calls. TokenUsage with cache and reasoning accounting, and addition.
• Schema — JsonSchema, an immutable validating subset of JSON Schema matched to what LLM providers actually accept, with full-violation reporting, coerce for the near-misses models really produce, and toStrict() for guaranteed structured output.
• Errors — AgenticException and eighteen concrete failures, each with a stable code, an isRetryable answer and JSON serialisation. Errors accumulate annotations as they propagate.
• Cancellation — CancellationToken/CancellationTokenSource with callbacks, future racing, stream binding that closes the underlying socket, token merging and clock-driven deadlines.
• Resilience — RetryPolicy with budgets and Retry-After support; ExponentialBackoff, LinearBackoff, ConstantBackoff and FixedScheduleBackoff with four jitter modes; CircuitBreaker with a half-open probe phase.
• Events — AgenticEvent and BroadcastEventBus with bounded replay for late subscribers, typed on<T>() filtering and run-scoped selection.
• Telemetry — StructuredLogger with bound fields, child scopes and credential redaction by default; Tracer with spans, events, sampling and pluggable exporters.
• Primitives — web-safe monotonic Ulid, injectable Clock, Disposable and DisposableBag, checked JSON accessors, Result, typed Registry.
• Context — AgenticContext bundling run identity, logger, bus, tracer, clock, IDs, cancellation and deadlines, with scoped derivation.
• Testing — package:agentic_core/testing.dart exports FakeClock, SequentialIdGenerator, InMemoryLogSink and InMemorySpanExporter.