Class: Thought

Defined in: lib/classes/thought.ts:156

An immutable, validated internal reasoning trace produced by an agent.

Remarks

Represents an agent's internal thinking — distinct from @nhtio/adk!Message (which is part of the visible conversation) and never shown to end users directly. Carries an identity so reasoning traces can be attributed to a specific agent in multi-agent conversations. Constructed from a RawThought via rawThoughtSchema. The content field is always a @nhtio/adk!Tokenizable so token cost can be estimated inline.

Constructors

Constructor

new Thought(raw: RawThought): Thought;

Defined in: lib/classes/thought.ts:212

Parameters

Parameter	Type	Description
raw	RawThought	The raw thought input validated against rawThoughtSchema.

Returns

Thought

Throws

@nhtio/adk!E_INVALID_INITIAL_THOUGHT_VALUE when raw does not satisfy the schema.

Properties

Property	Modifier	Type	Default value	Description	Defined in
content	readonly	Tokenizable	undefined	The reasoning content as a @nhtio/adk!Tokenizable for inline token estimation.	lib/classes/thought.ts:182
createdAt	readonly	DateTime	undefined	When this thought was recorded.	lib/classes/thought.ts:196
id	readonly	string	undefined	Stable unique identifier for this thought.	lib/classes/thought.ts:180
identity	readonly	Identity	undefined	The identity of the agent who produced this thought.	lib/classes/thought.ts:184
payload	readonly	unknown	undefined	Optional vendor-opaque payload that round-trips back to a matching model wire. See RawThought.payload.	lib/classes/thought.ts:189
replayCompatibility	readonly	string | undefined	undefined	Optional wire-shape identifier describing which adapter can safely replay this thought. See RawThought.replayCompatibility.	lib/classes/thought.ts:194
updatedAt	readonly	DateTime	undefined	When this thought was last modified.	lib/classes/thought.ts:198
schema	static	ObjectSchema<RawThought>	rawThoughtSchema	Validator schema that accepts a RawThought object. Remarks Reusable fragment for any schema that needs to validate or nest a thought entry.	lib/classes/thought.ts:163

Methods

isThought()

static isThought(value: unknown): value is Thought;

Defined in: lib/classes/thought.ts:175

Returns true if value is a Thought instance.

Parameters

Parameter	Type	Description
value	unknown	The value to test.

Returns

value is Thought

true when value is a Thought instance.

Remarks

Uses @nhtio/adk!isInstanceOf for cross-realm safety — instanceof would fail for instances created in a different module copy or VM context.