Expand description
SPDX-License-Identifier: AGPL-3.0-or-later Copyright (C) Alexander R. Croft
Component 02 — Interpreter.
Consumes ordered raw Connector bytes + dialect binding, assembles complete provider-neutral canonical units, and publishes them immediately. Never emits tokens, text deltas, or partial tool JSON as canonical content.
See doc/INTERPRETER.md.
Structs§
- AcpDialect
- ACP dialect helpers.
- Bytes
- A cheaply cloneable and sliceable chunk of contiguous memory.
- Canonical
Event Stream - Cloneable receiver handle for canonical events from one Interpretation.
- Canonical
Unit Snapshot - Correlation + lifecycle envelope for one unit generation.
- Completed
Sentence - One completed sentence from the segmenter, with buffer consumption.
- Connection
Id - Local logical transport attachment identity for one connection scope.
- Default
Interpreter Factory - Default factory supporting Test + ACP/GrokBuild dialects.
- Dialect
Binding - Immutable input/output dialect pair for one opened connection.
- Dialect
Descriptor - Stable, bounded, versioned dialect descriptor.
- External
Session Id - Opaque externally owned session identity (e.g. Grok
sessionId). - FlowId
- Flow identity (one logical dialect exchange/response).
- Interpretation
- Handle returned by the factory.
- Interpretation
End - Exactly one terminal report per interpretation.
- Interpretation
Id - Interpretation instance identity.
- Interpretation
Input - Cloneable input handle for raw Connector output chunks.
- Interpretation
Limits - Interpretation assembly and output bounds.
- Interpreter
Error - Interpreter error with safe diagnostics.
- LaneId
- Lane identity within a flow.
- Open
AiSse State - Incremental SSE assembler for one interpretation.
- Sentence
Segmenter - Deterministic sentence boundary finder.
- Source
Time Observation - Dialect-observed source time for a complete (or lifecycle) unit.
- Start
Interpretation - Request to start an interpretation on one connection output.
- Text
Sentence - Complete sentence atom (immutable after emission).
- Tool
Action Id - Tool action identity (dialect-provided or interpretation-scoped).
- UnitId
- Stable unit identity within one interpretation.
Enums§
- Boundary
Kind - Boundary kinds.
- Canonical
Unit - Closed top-level canonical unit vocabulary.
- Canonical
Unit Event - Unit lifecycle event (closed vocabulary).
- Dialect
Family - High-level dialect family (not an encoder/decoder implementation).
- Interpretation
EndKind - Interpretation terminal kinds.
- Interpreter
Error Kind - Interpreter error classification.
- Interpreter
Output Event - Stream events delivered to subscribers (Interpreter output + end).
- Support
Level - How well a factory supports a dialect binding.
- Text
Channel - Canonical text channel.
- Unit
State - Lifecycle state of a canonical unit.
Constants§
- DEFAULT_
CHOICE_ INDEX - Default accepted choice index for the first product path.
- SENTENCE_
SEGMENTER_ VERSION - Version label for the segmenter (recorded in interpretation diagnostics).
Traits§
- Interpreter
Factory - Creates Interpretation instances for supported dialects.