Interface: LLMMessage

Defined in: src/adapters/types.ts:21

Properties

content

readonly content: string

Defined in: src/adapters/types.ts:23

---

ephemeral?

readonly optional ephemeral?: boolean

Defined in: src/adapters/types.ts:84

v2.13 — PERSISTENCE flag (NOT a visibility flag). When true: • The message IS sent to the LLM as part of the next request (visible to the model, counts toward its context window). • The message is OBSERVABLE via narrative/recorders/audit log (visible to humans for debugging + forensics). • The message is NOT persisted to scope.history after the gate loop that produced it completes — long-term memory writes, getNarrative() snapshots, and downstream consumers see only non-ephemeral messages.

Use case: Instructor-style schema retry. The reliability gate appends { role: 'user', content: feedbackForLLM, ephemeral: true } before retry — the LLM sees the validation feedback for the next call, but the conversation history (and any memory persistence downstream) sees only the final accepted exchange.

Audit-trail safety: ephemeral DOES NOT mean invisible to security review. getNarrative(), recorders, and the typed-event stream all see ephemeral messages; only the persistent conversation log filters them out. An attacker cannot use the ephemeral marker to construct audit-invisible prompts.

---

role

readonly role: ContextRole

Defined in: src/adapters/types.ts:22

---

thinkingBlocks?

readonly optional thinkingBlocks?: readonly ThinkingBlock[]

Defined in: src/adapters/types.ts:60

v2.14 — Thinking blocks emitted by the LLM on assistant turns.

Required for Anthropic extended-thinking + tool-use flows: signed blocks MUST be echoed BYTE-EXACT in subsequent assistant turns or Anthropic's API rejects with 400. The framework persists blocks here so the AnthropicProvider's serializer (Phase 4b) can restore them on the next request.

Persistence model — DIFFERENT from ephemeral:

• ephemeral messages: NOT persisted to scope.history
• thinkingBlocks: PERSISTED (required for signature round-trip)

Visible to recorders + audit by default. Use RedactionPolicy.thinkingPatterns (Phase 3) to scrub sensitive reasoning content before audit-log adapters fire.

Empty array OR undefined when no thinking is present (most calls).

---

toolCallId?

readonly optional toolCallId?: string

Defined in: src/adapters/types.ts:25

For role: 'tool' — the tool_use id this result corresponds to.

---

toolCalls?

readonly optional toolCalls?: readonly object[]

Defined in: src/adapters/types.ts:36

For role: 'assistant' only — the tool calls the LLM requested in this turn. Required for providers (Anthropic, OpenAI) that need to round-trip tool_use blocks across iterations: when the next complete() includes a role: 'tool' message, the provider reconstructs the matching tool_use block on the previous assistant turn from this field. Empty array on text-only turns; undefined for non-assistant roles.

---

toolName?

readonly optional toolName?: string

Defined in: src/adapters/types.ts:27

For role: 'tool' — the tool name this result corresponds to.