@nhtio/adk/types

Type-only export surface for raw shapes, callbacks, events, hooks, and internal contracts.

Remarks

Type-only barrel — re-exports every shape consumers might annotate against: raw constructor inputs, callback function signatures, event payloads, hook event maps, middleware function signatures, validator-resolved configuration shapes, and the runtime-internal context/exception types (TurnContext, DispatchContext, BaseException, TurnGate) for which only a type and a runtime guard (see the guards barrel) are exposed.

No runtime values are re-exported here; importing this barrel produces no JavaScript output after type-erasure. Use this when you want one place to grab types without dragging in the corresponding runtime classes.

Interfaces

Interface	Description
DispatchContext	Context object for a single LLM execution call.
RawDispatchContext	Plain input object supplied to DispatchContext at construction time.
RawTurnContext	Plain input object supplied to TurnContext at construction time.
TurnContext	The validated, strongly-typed context object threaded through every middleware step in a single agent turn.

Type Aliases

Type Alias	Description
ConduitBytes	Payload accepted by the byte-persistence conduits — text, raw bytes, or a stream.
DispatchContextHookRegistrations	Optional hook registrations supplied to @nhtio/adk!DispatchContext at construction time.
DispatchContextHooks	Hook event map for @nhtio/adk!DispatchContext.
DispatchMediaBytesStoreFn	Persists tool-generated media bytes into consumer storage and returns a @nhtio/adk!MediaReader (LLM execution context variant). Unlike the store* mutation callbacks this returns a value and does NOT add anything to the turn Sets — the handler builds a @nhtio/adk!Media from the reader and persists it via storeMessage/storeToolCall separately.
DispatchMemoryDeleteFn	Removes a memory by ID (LLM execution context variant).
DispatchMemoryMutateFn	Updates an existing memory (LLM execution context variant).
DispatchMemoryRetrievalFn	Retrieves memories for an LLM execution context.
DispatchMemoryStoreFn	Stores a new memory (LLM execution context variant).
DispatchMessageDeleteFn	Removes a message by ID (LLM execution context variant).
DispatchMessageMutateFn	Updates an existing message (LLM execution context variant).
DispatchMessageRetrievalFn	Retrieves messages for an LLM execution context.
DispatchMessageStoreFn	Stores a new message (LLM execution context variant).
DispatchRetrievableBytesStoreFn	Persists extracted retrievable text bytes into consumer storage and returns a @nhtio/adk!SpoolReader (LLM execution context variant). The handler wraps the reader in a @nhtio/adk!SpooledArtifact for new Retrievable({ content }) and persists the record via storeRetrievable separately. Returns a value; does NOT touch the turn Sets.
DispatchRetrievableDeleteFn	Removes a retrievable record by ID (LLM execution context variant).
DispatchRetrievableMutateFn	Updates an existing retrievable record (LLM execution context variant).
DispatchRetrievableRetrievalFn	Retrieves retrievable records for an LLM execution context.
DispatchRetrievableStoreFn	Stores a new retrievable record (LLM execution context variant).
DispatchStandingInstructionDeleteFn	Removes a standing instruction (LLM execution context variant).
DispatchStandingInstructionMutateFn	Updates an existing standing instruction (LLM execution context variant).
DispatchStandingInstructionsRefreshFn	Refreshes and returns standing instructions for an LLM execution context.
DispatchStandingInstructionStoreFn	Stores a new standing instruction (LLM execution context variant).
DispatchThoughtDeleteFn	Removes a thought by ID (LLM execution context variant).
DispatchThoughtMutateFn	Updates an existing thought (LLM execution context variant).
DispatchThoughtRetrievalFn	Retrieves thoughts for an LLM execution context.
DispatchThoughtStoreFn	Stores a new thought (LLM execution context variant).
DispatchToolCallDeleteFn	Removes a tool call by ID (LLM execution context variant).
DispatchToolCallMutateFn	Updates an existing tool call (LLM execution context variant).
DispatchToolCallRetrievalFn	Retrieves tool calls for an LLM execution context.
DispatchToolCallStoreFn	Stores a new tool call (LLM execution context variant).
DispatchToolsRetrievalFn	Retrieves tools for an LLM execution context.
MediaBytesStoreFn	Persists tool-generated media bytes into consumer storage and returns a @nhtio/adk!MediaReader. A byte-persistence conduit, not a mutation — returns a value and touches no turn state.
MemoryDeleteFn	Removes a memory from the persistence layer by ID.
MemoryMutateFn	Updates an existing memory in the persistence layer.
MemoryRetrievalFn	A function that retrieves the memories relevant to the current turn.
MemoryStoreFn	Stores a new memory in the persistence layer.
MessageDeleteFn	Removes a message from the persistence layer by ID.
MessageMutateFn	Updates an existing message in the persistence layer.
MessageRetrievalFn	A function that retrieves the conversation messages relevant to the current turn.
MessageStoreFn	Stores a new message in the persistence layer.
ResolvedTurnContext	A fully-resolved RawTurnContext where all optional fields have been filled in by the schema (e.g. stash defaulted to {}).
RetrievableBytesStoreFn	Persists extracted retrievable text bytes into consumer storage and returns a @nhtio/adk!SpoolReader. A byte-persistence conduit, not a mutation.
RetrievableDeleteFn	Removes a retrievable record from the persistence layer by ID.
RetrievableMutateFn	Updates an existing retrievable record in the persistence layer.
RetrievableRetrievalFn	A function that retrieves the retrievable (RAG) records relevant to the current turn.
RetrievableStoreFn	Stores a new retrievable record in the persistence layer.
StandingInstructionDeleteFn	Removes a standing instruction from the persistence layer.
StandingInstructionMutateFn	Updates an existing standing instruction in the persistence layer.
StandingInstructionsRefreshFn	A function that refreshes and returns the standing instructions for the current turn.
StandingInstructionStoreFn	Stores a new standing instruction in the persistence layer.
ThoughtDeleteFn	Removes a thought from the persistence layer by ID.
ThoughtMutateFn	Updates an existing thought in the persistence layer.
ThoughtRetrievalFn	A function that retrieves the thought traces relevant to the current turn.
ThoughtStoreFn	Stores a new thought in the persistence layer.
ToolCallDeleteFn	Removes a tool call from the persistence layer by ID.
ToolCallMutateFn	Updates an existing tool call in the persistence layer.
ToolCallRetrievalFn	A function that retrieves the tool call records relevant to the current turn.
ToolCallStoreFn	Stores a new tool call in the persistence layer.
ToolsRetrievalFn	A function that retrieves the tools available for the current turn.

References

ArtifactToolHandler

Re-exports ArtifactToolHandler

---

BaseException

Re-exports BaseException

---

DispatchEndEvent

Re-exports DispatchEndEvent

---

DispatchExecutorFn

Re-exports DispatchExecutorFn

---

DispatchExecutorHelpers

Re-exports DispatchExecutorHelpers

---

DispatchExecutorLogChannel

Re-exports DispatchExecutorLogChannel

---

DispatchExecutorLogEntry

Re-exports DispatchExecutorLogEntry

---

DispatchExecutorLogLevel

Re-exports DispatchExecutorLogLevel

---

DispatchPipelineMiddlewareFn

Re-exports DispatchPipelineMiddlewareFn

---

DispatchRunnerFunctionalHookRegistrations

Re-exports DispatchRunnerFunctionalHookRegistrations

---

DispatchRunnerFunctionalHooks

Re-exports DispatchRunnerFunctionalHooks

---

DispatchRunnerObservabilityHookRegistrations

Re-exports DispatchRunnerObservabilityHookRegistrations

---

DispatchRunnerObservabilityHooks

Re-exports DispatchRunnerObservabilityHooks

---

DispatchStartEvent

Re-exports DispatchStartEvent

---

EmitMessageFn

Re-exports EmitMessageFn

---

EmitThoughtFn

Re-exports EmitThoughtFn

---

EmitToolCallFn

Re-exports EmitToolCallFn

---

EmitToolExecutionEndFn

Re-exports EmitToolExecutionEndFn

---

EmitToolExecutionStartFn

Re-exports EmitToolExecutionStartFn

---

IterationEndEvent

Re-exports IterationEndEvent

---

IterationStartEvent

Re-exports IterationStartEvent

---

JsonArtifactFormat

Re-exports JsonArtifactFormat

---

LogEvent

Re-exports LogEvent

---

MarkdownCodeEntry

Re-exports MarkdownCodeEntry

---

MarkdownHeadingEntry

Re-exports MarkdownHeadingEntry

---

MarkdownSection

Re-exports MarkdownSection

---

MergeOptions

Re-exports MergeOptions

---

MessageRole

Re-exports MessageRole

---

OpenGateFn

Re-exports OpenGateFn

---

RawArtifactTool

Re-exports RawArtifactTool

---

RawDispatchRunnerInput

Re-exports RawDispatchRunnerInput

---

RawIdentity

Re-exports RawIdentity

---

RawMemory

Re-exports RawMemory

---

RawMessage

Re-exports RawMessage

---

RawThought

Re-exports RawThought

---

RawTool

Re-exports RawTool

---

RawToolCall

Re-exports RawToolCall

---

RawTurnGate

Re-exports RawTurnGate

---

ResolvedTurnRunnerConfig

Re-exports ResolvedTurnRunnerConfig

---

SpooledArtifactConstructor

Re-exports SpooledArtifactConstructor

---

SpoolReader

Re-exports SpoolReader

---

TokenEncoding

Re-exports TokenEncoding

---

TokenEncodingId

Re-exports TokenEncodingId

---

TokenEstimatorFn

Re-exports TokenEstimatorFn

---

ToolExecutionEndEvent

Re-exports ToolExecutionEndEvent

---

ToolExecutionStartEvent

Re-exports ToolExecutionStartEvent

---

ToolHandler

Re-exports ToolHandler

---

ToolMethodDescriptor

Re-exports ToolMethodDescriptor

---

TurnEndEvent

Re-exports TurnEndEvent

---

TurnEvent

Re-exports TurnEvent

---

TurnEventListener

Re-exports TurnEventListener

---

TurnEvents

Re-exports TurnEvents

---

TurnGate

Re-exports TurnGate

---

TurnGateClosedEvent

Re-exports TurnGateClosedEvent

---

TurnObservabilityEvent

Re-exports TurnObservabilityEvent

---

TurnObservabilityEventListener

Re-exports TurnObservabilityEventListener

---

TurnObservabilityEvents

Re-exports TurnObservabilityEvents

---

TurnPipelineMiddlewareFn

Re-exports TurnPipelineMiddlewareFn

---

TurnRunnerConfig

Re-exports TurnRunnerConfig

---

TurnStartEvent

Re-exports TurnStartEvent

---

TurnStreamableContent

Re-exports TurnStreamableContent

---

TurnToolCallContent

Re-exports TurnToolCallContent

---

WarningEvent

Re-exports WarningEvent