@nhtio/adk 0.1.0-master-f0aa531d

package/thought-CDb457b4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thought-CDb457b4.mjs","names":["#identifier","#representation","#id","#content","#confidence","#importance","#createdAt","#updatedAt","#id","#role","#content","#attachments","#identity","#createdAt","#updatedAt","#id","#content","#identity","#payload","#replayCompatibility","#createdAt","#updatedAt"],"sources":["../src/lib/classes/identity.ts","../src/lib/classes/memory.ts","../src/lib/classes/message.ts","../src/lib/classes/thought.ts"],"sourcesContent":["import { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError } from '../utils/guards'\nimport { E_INVALID_INITIAL_IDENTITY_VALUE } from '../exceptions/runtime'\n\n/**\n * Plain input object supplied to {@link Identity} at construction time.\n *\n * @remarks\n * Validated against `rawIdentitySchema` before the `Identity` instance is created.\n */\nexport interface RawIdentity {\n  /**\n   * The system-facing identifier for this participant.\n   *\n   * @remarks\n   * Used internally to correlate messages to a specific participant — e.g. a database ID or\n   * a username. Never sent to the model directly; use `representation` for that.\n   */\n  identifier: string | number\n  /**\n   * How this participant should be presented to the model.\n   *\n   * @remarks\n   * Accepts a plain string or an existing {@link @nhtio/adk!Tokenizable} instance. This is what the model\n   * sees when it needs to distinguish between participants of the same role.\n   */\n  representation: string | Tokenizable\n}\n\n/**\n * A fully-resolved {@link RawIdentity} where `representation` has been normalised to a\n * {@link @nhtio/adk!Tokenizable} instance.\n *\n * @remarks\n * Used internally by the {@link Identity} constructor to assign private fields with\n * guaranteed types.\n */\ninterface ResolvedIdentity {\n  identifier: string | number\n  representation: Tokenizable\n}\n\n/**\n * Validator schema used to validate a {@link RawIdentity} before constructing an {@link Identity}.\n *\n * @remarks\n * Validates both fields of {@link RawIdentity}:\n * - `identifier` — required string or number.\n * - `representation` — required string or {@link @nhtio/adk!Tokenizable}, via {@link @nhtio/adk!Tokenizable.schema}.\n *\n * Throws {@link @nhtio/adk!E_INVALID_INITIAL_IDENTITY_VALUE} (via the {@link Identity} constructor) when\n * validation fails.\n */\nconst rawIdentitySchema = validator.object<RawIdentity>({\n  identifier: validator.alternatives(validator.string(), validator.number()).required(),\n  representation: Tokenizable.schema.required(),\n})\n\n/**\n * An immutable, validated participant identity attached to a {@link @nhtio/adk!Message}.\n *\n * @remarks\n * Carries two distinct representations of the same participant: `identifier` is the\n * system-facing key (e.g. a database ID) used to correlate messages programmatically;\n * `representation` is what the model sees when it needs to distinguish between participants\n * sharing the same role. The `representation` is always a {@link @nhtio/adk!Tokenizable} so token cost\n * can be estimated inline.\n */\nexport class Identity {\n  /**\n   * Validator schema that accepts a {@link RawIdentity} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest an identity — for example,\n   * as a required field inside a message schema.\n   */\n  public static schema = rawIdentitySchema\n\n  /**\n   * Returns `true` if `value` is an {@link Identity} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety — `instanceof` would fail for instances\n   * created in a different module copy or VM context.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is an {@link Identity} instance.\n   */\n  public static isIdentity(value: unknown): value is Identity {\n    return isInstanceOf(value, 'Identity', Identity)\n  }\n\n  /**\n   * The system-facing identifier for this participant — never sent to the model directly.\n   */\n  declare readonly identifier: string | number\n\n  /**\n   * How this participant is presented to the model, as a {@link @nhtio/adk!Tokenizable} for inline\n   * token estimation.\n   */\n  declare readonly representation: Tokenizable\n\n  #identifier: string | number\n  #representation: Tokenizable\n\n  /**\n   * @param raw - The raw identity input validated against `rawIdentitySchema`.\n   * @throws {@link @nhtio/adk!E_INVALID_INITIAL_IDENTITY_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawIdentity) {\n    let resolved: ResolvedIdentity\n    try {\n      resolved = validateOrThrow<ResolvedIdentity>(rawIdentitySchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_IDENTITY_VALUE({ cause: isError(err) ? err : undefined })\n    }\n    this.#identifier = resolved.identifier\n    this.#representation = Tokenizable.isTokenizable(resolved.representation)\n      ? resolved.representation\n      : new Tokenizable(resolved.representation)\n\n    Object.defineProperties(this, {\n      identifier: {\n        get: () => this.#identifier,\n        enumerable: true,\n        configurable: false,\n      },\n      representation: {\n        get: () => this.#representation,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n}\n","import { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError } from '../utils/guards'\nimport { E_INVALID_INITIAL_MEMORY_VALUE } from '../exceptions/runtime'\nimport type { DateTime } from 'luxon'\n\n/**\n * Plain input object supplied to {@link Memory} at construction time.\n *\n * @remarks\n * Validated against `rawMemorySchema` before the `Memory` instance is created.\n * Temporal fields accept any value that Luxon can parse — ISO strings, Unix timestamps,\n * `Date` objects, or existing `DateTime` instances.\n */\nexport interface RawMemory {\n  /** Stable unique identifier for this memory entry. */\n  id: string\n  /** The memory content as a plain string or an existing {@link @nhtio/adk!Tokenizable} instance. */\n  content: string | Tokenizable\n  /** Confidence score in the range `[0, 1]` — how certain the agent is that this memory is accurate. */\n  confidence: number\n  /** Importance score in the range `[0, 1]` — how much weight this memory should carry during retrieval. */\n  importance: number\n  /** When this memory was first recorded. */\n  createdAt: string | number | Date | DateTime\n  /** When this memory was last modified. */\n  updatedAt: string | number | Date | DateTime\n}\n\n/**\n * A fully-resolved {@link RawMemory} where all fields have been validated and temporal values\n * normalised to Luxon `DateTime` instances.\n *\n * @remarks\n * This is the shape returned by `rawMemorySchema` after validation — used internally by the\n * {@link Memory} constructor to assign private fields with guaranteed types.\n */\ninterface ResolvedMemory {\n  id: string\n  content: Tokenizable\n  confidence: number\n  importance: number\n  createdAt: DateTime\n  updatedAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawMemory} before constructing a {@link Memory}.\n *\n * @remarks\n * Validates all six fields of {@link RawMemory}:\n * - `id` — required non-empty string.\n * - `content` — required string or {@link @nhtio/adk!Tokenizable}, via {@link @nhtio/adk!Tokenizable.schema}.\n * - `confidence` — required number in `[0, 1]`.\n * - `importance` — required number in `[0, 1]`.\n * - `createdAt` / `updatedAt` — required datetime-parseable values, normalised to `DateTime`.\n *\n * Throws {@link @nhtio/adk!E_INVALID_INITIAL_MEMORY_VALUE} (via the {@link Memory} constructor) when\n * validation fails.\n */\nconst rawMemorySchema = validator.object<RawMemory>({\n  id: validator.string().required(),\n  content: Tokenizable.schema.required(),\n  confidence: validator.number().min(0).max(1).required(),\n  importance: validator.number().min(0).max(1).required(),\n  createdAt: validator.datetime().required(),\n  updatedAt: validator.datetime().required(),\n})\n\n/**\n * An immutable, validated memory entry held by the agent.\n *\n * @remarks\n * Constructed from a {@link RawMemory} via `rawMemorySchema`. All temporal fields are\n * normalised to Luxon `DateTime` instances at construction time. The `content` field is\n * always a {@link @nhtio/adk!Tokenizable} so callers can estimate token cost without an additional\n * wrapping step.\n */\nexport class Memory {\n  /**\n   * Validator schema that accepts a {@link RawMemory} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a memory entry — for\n   * example, a collection schema that holds an array of memories.\n   */\n  public static schema = rawMemorySchema\n\n  /**\n   * Returns `true` if `value` is a {@link Memory} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety — `instanceof` would fail for instances\n   * created in a different module copy or VM context.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link Memory} instance.\n   */\n  public static isMemory(value: unknown): value is Memory {\n    return isInstanceOf(value, 'Memory', Memory)\n  }\n  /** Stable unique identifier for this memory entry. */\n  declare readonly id: string\n  /** The memory content as a {@link @nhtio/adk!Tokenizable} for inline token estimation. */\n  declare readonly content: Tokenizable\n  /** Confidence score in the range `[0, 1]`. */\n  declare readonly confidence: number\n  /** Importance score in the range `[0, 1]`. */\n  declare readonly importance: number\n  /** When this memory was first recorded. */\n  declare readonly createdAt: DateTime\n  /** When this memory was last modified. */\n  declare readonly updatedAt: DateTime\n\n  #id: string\n  #content: Tokenizable\n  #confidence: number\n  #importance: number\n  #createdAt: DateTime\n  #updatedAt: DateTime\n\n  /**\n   * @param raw - The raw memory input validated against `rawMemorySchema`.\n   * @throws {@link @nhtio/adk!E_INVALID_INITIAL_MEMORY_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawMemory) {\n    let resolved: ResolvedMemory\n    try {\n      resolved = validateOrThrow<ResolvedMemory>(rawMemorySchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_MEMORY_VALUE({ cause: isError(err) ? err : undefined })\n    }\n    this.#id = resolved.id\n    this.#content = Tokenizable.isTokenizable(resolved.content)\n      ? resolved.content\n      : new Tokenizable(resolved.content)\n    this.#confidence = resolved.confidence\n    this.#importance = resolved.importance\n    this.#createdAt = resolved.createdAt\n    this.#updatedAt = resolved.updatedAt\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      content: {\n        get: () => this.#content,\n        enumerable: true,\n        configurable: false,\n      },\n      confidence: {\n        get: () => this.#confidence,\n        enumerable: true,\n        configurable: false,\n      },\n      importance: {\n        get: () => this.#importance,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      updatedAt: {\n        get: () => this.#updatedAt,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n}\n","import { Media } from './media'\nimport { Identity } from './identity'\nimport { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError } from '../utils/guards'\nimport { E_INVALID_INITIAL_MESSAGE_VALUE } from '../exceptions/runtime'\nimport type { DateTime } from 'luxon'\nimport type { RawIdentity } from './identity'\n\n/**\n * The roles a {@link Message} author can hold.\n *\n * @remarks\n * Restricted to `user` and `assistant` — system instructions, developer directives, and\n * tool results are handled separately and never appear in the persisted message history.\n */\nexport type MessageRole = 'user' | 'assistant'\n\n/**\n * Plain input object supplied to {@link Message} at construction time.\n *\n * @remarks\n * Validated against `rawMessageSchema` before the `Message` instance is created.\n * Temporal fields accept any value that Luxon can parse — ISO strings, Unix timestamps,\n * `Date` objects, or existing `DateTime` instances.\n *\n * At least one of `content` or `attachments` (non-empty) must be present — a message with\n * neither throws {@link @nhtio/adk!E_INVALID_INITIAL_MESSAGE_VALUE}.\n */\nexport interface RawMessage {\n  /** Stable unique identifier for this message. */\n  id: string\n  /** Whether this message is from the human participant or the model. */\n  role: MessageRole\n  /**\n   * The message content as a plain string or an existing {@link @nhtio/adk!Tokenizable} instance.\n   *\n   * @remarks\n   * Optional — but required when `attachments` is absent or empty. The cross-field rule on\n   * `rawMessageSchema` enforces that at least one of `content` or `attachments` is present.\n   */\n  content?: string | Tokenizable\n  /**\n   * Media attachments carried by this message — images, audio, video, documents.\n   *\n   * @remarks\n   * Optional and symmetric across roles: both `user` and `assistant` messages may carry\n   * attachments. Each attachment carries its own `trustTier` and `modalityHazard`, which the\n   * renderer uses to wrap the asset in its own trust envelope independent of the message\n   * envelope. How a renderer orders text vs attachments in the on-the-wire content array is\n   * a renderer-policy concern, not a contract of {@link Message}.\n   */\n  attachments?: Media[]\n  /**\n   * The identity of the participant who authored this message.\n   *\n   * @remarks\n   * Optional. When omitted, the `role` value is used as both the system-facing `identifier`\n   * and the model-facing `representation`. Three accepted forms when provided:\n   * - A plain `string` — used as both `identifier` and `representation`.\n   * - A {@link @nhtio/adk!RawIdentity} object — validated and wrapped into an {@link @nhtio/adk!Identity}.\n   * - An existing {@link @nhtio/adk!Identity} instance — passed through unchanged.\n   */\n  identity?: string | RawIdentity | Identity\n  /** When this message was created. */\n  createdAt: string | number | Date | DateTime\n  /** When this message was last modified. */\n  updatedAt: string | number | Date | DateTime\n}\n\n/**\n * A fully-resolved {@link RawMessage} where temporal fields have been normalised to Luxon\n * `DateTime` instances and `identity` is a validated {@link @nhtio/adk!Identity}.\n *\n * @remarks\n * Used internally by the {@link Message} constructor to assign private fields with\n * guaranteed types.\n */\ninterface ResolvedMessage {\n  id: string\n  role: MessageRole\n  content?: Tokenizable\n  attachments: Media[]\n  identity: string | RawIdentity | Identity\n  createdAt: DateTime\n  updatedAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawMessage} before constructing a {@link Message}.\n *\n * @remarks\n * Validates all fields of {@link RawMessage}:\n * - `id` — required non-empty string.\n * - `role` — required; must be `'user'` or `'assistant'`.\n * - `content` — optional string or {@link @nhtio/adk!Tokenizable}, via {@link @nhtio/adk!Tokenizable.schema}.\n * - `attachments` — optional array of {@link @nhtio/adk!Media} instances. Defaults to `[]`.\n * - At least one of `content` or `attachments` must be present and non-empty; a message with\n *   neither is invalid.\n * - `identity` — required string, {@link @nhtio/adk!RawIdentity}, or {@link @nhtio/adk!Identity}; a plain string is\n *   mapped to both `identifier` and `representation` automatically.\n * - `createdAt` / `updatedAt` — required datetime-parseable values, normalised to `DateTime`.\n *\n * Throws {@link @nhtio/adk!E_INVALID_INITIAL_MESSAGE_VALUE} (via the {@link Message} constructor) when\n * validation fails.\n */\nconst rawMessageSchema = validator\n  .object<RawMessage>({\n    id: validator.string().required(),\n    role: validator.string().valid('user', 'assistant').required(),\n    content: Tokenizable.schema.optional(),\n    attachments: validator\n      .array()\n      .items(\n        validator.any().custom((value, helpers) => {\n          if (Media.isMedia(value)) return value\n          return helpers.error('any.invalid')\n        })\n      )\n      .default([]),\n    identity: validator\n      .alternatives(validator.string(), Identity.schema)\n      .default(validator.ref('role')),\n    createdAt: validator.datetime().required(),\n    updatedAt: validator.datetime().required(),\n  })\n  .custom((value, helpers) => {\n    const resolved = value as ResolvedMessage\n    const hasContent = resolved.content !== undefined && resolved.content !== null\n    const hasAttachments = Array.isArray(resolved.attachments) && resolved.attachments.length > 0\n    if (!hasContent && !hasAttachments) {\n      return helpers.error('any.invalid')\n    }\n    return resolved\n  })\n\n/**\n * An immutable, validated conversation message from a human participant or the model.\n *\n * @remarks\n * Covers only `user` and `assistant` roles — system instructions, developer directives, and\n * tool results are not represented here. Constructed from a {@link RawMessage} via\n * `rawMessageSchema`. Temporal fields are normalised to Luxon `DateTime` instances at\n * construction time. Both `content` and `identity.representation` are {@link @nhtio/adk!Tokenizable} so\n * token cost can be estimated inline.\n *\n * A message may carry `content` (text), `attachments` (media), or both. The cross-field rule\n * on `rawMessageSchema` enforces that at least one is present. Downstream code that reaches\n * for `message.content` must handle the attachments-only case where `content` is `undefined`.\n */\nexport class Message {\n  /**\n   * Validator schema that accepts a {@link RawMessage} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a message entry — for\n   * example, a collection schema that holds an array of messages.\n   */\n  public static schema = rawMessageSchema\n\n  /**\n   * Returns `true` if `value` is a {@link Message} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety — `instanceof` would fail for instances\n   * created in a different module copy or VM context.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link Message} instance.\n   */\n  public static isMessage(value: unknown): value is Message {\n    return isInstanceOf(value, 'Message', Message)\n  }\n\n  /** Stable unique identifier for this message. */\n  declare readonly id: string\n  /** Whether this message is from the human participant or the model. */\n  declare readonly role: MessageRole\n  /**\n   * The message content as a {@link @nhtio/adk!Tokenizable} for inline token estimation, or `undefined`\n   * for attachments-only messages.\n   *\n   * @remarks\n   * `undefined` when the message was constructed with only `attachments`. Render code that\n   * needs the text portion must guard for the missing case rather than blindly calling\n   * `message.content.toString()`.\n   */\n  declare readonly content: Tokenizable | undefined\n  /**\n   * Media attachments carried by this message.\n   *\n   * @remarks\n   * Always defined as a frozen array — empty when the message has no attachments. Both\n   * `user` and `assistant` messages may carry attachments. Each entry carries its own\n   * `trustTier` and `modalityHazard`; the renderer wraps each in its own trust envelope\n   * independent of the message envelope.\n   */\n  declare readonly attachments: ReadonlyArray<Media>\n  /** The identity of the participant who authored this message. */\n  declare readonly identity: Identity\n  /** When this message was created. */\n  declare readonly createdAt: DateTime\n  /** When this message was last modified. */\n  declare readonly updatedAt: DateTime\n\n  #id: string\n  #role: MessageRole\n  #content: Tokenizable | undefined\n  #attachments: ReadonlyArray<Media>\n  #identity: Identity\n  #createdAt: DateTime\n  #updatedAt: DateTime\n\n  /**\n   * @param raw - The raw message input validated against `rawMessageSchema`.\n   * @throws {@link @nhtio/adk!E_INVALID_INITIAL_MESSAGE_VALUE} when `raw` does not satisfy the schema —\n   *   including the cross-field rule that at least one of `content` or `attachments` must be\n   *   present and non-empty.\n   */\n  constructor(raw: RawMessage) {\n    let resolved: ResolvedMessage\n    try {\n      resolved = validateOrThrow<ResolvedMessage>(rawMessageSchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_MESSAGE_VALUE({ cause: isError(err) ? err : undefined })\n    }\n    this.#id = resolved.id\n    this.#role = resolved.role\n    this.#content =\n      resolved.content === undefined || resolved.content === null\n        ? undefined\n        : Tokenizable.isTokenizable(resolved.content)\n          ? resolved.content\n          : new Tokenizable(resolved.content)\n    this.#attachments = Object.freeze([...(resolved.attachments ?? [])])\n    const rawIdentity = resolved.identity\n    this.#identity = Identity.isIdentity(rawIdentity)\n      ? rawIdentity\n      : typeof rawIdentity === 'string'\n        ? new Identity({ identifier: rawIdentity, representation: rawIdentity })\n        : new Identity(rawIdentity)\n    this.#createdAt = resolved.createdAt\n    this.#updatedAt = resolved.updatedAt\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      role: {\n        get: () => this.#role,\n        enumerable: true,\n        configurable: false,\n      },\n      content: {\n        get: () => this.#content,\n        enumerable: true,\n        configurable: false,\n      },\n      attachments: {\n        get: () => this.#attachments,\n        enumerable: true,\n        configurable: false,\n      },\n      identity: {\n        get: () => this.#identity,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      updatedAt: {\n        get: () => this.#updatedAt,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n}\n","import { Identity } from './identity'\nimport { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError } from '../utils/guards'\nimport { E_INVALID_INITIAL_THOUGHT_VALUE } from '../exceptions/runtime'\nimport type { DateTime } from 'luxon'\nimport type { RawIdentity } from './identity'\n\n/**\n * Plain input object supplied to {@link Thought} at construction time.\n *\n * @remarks\n * Validated against `rawThoughtSchema` before the `Thought` instance is created.\n * Temporal fields accept any value that Luxon can parse — ISO strings, Unix timestamps,\n * `Date` objects, or existing `DateTime` instances.\n */\nexport interface RawThought {\n  /** Stable unique identifier for this thought. */\n  id: string\n  /** The reasoning content as a plain string or an existing {@link @nhtio/adk!Tokenizable} instance. */\n  content: string | Tokenizable\n  /**\n   * The identity of the agent who produced this thought.\n   *\n   * @remarks\n   * Required in multi-agent conversations to attribute reasoning traces to a specific agent.\n   * Three accepted forms when provided:\n   * - A plain `string` — used as both `identifier` and `representation`.\n   * - A {@link @nhtio/adk!RawIdentity} object — validated and wrapped into an {@link @nhtio/adk!Identity}.\n   * - An existing {@link @nhtio/adk!Identity} instance — passed through unchanged.\n   *\n   * When omitted, defaults to `'assistant'` (both `identifier` and `representation`).\n   */\n  identity?: string | RawIdentity | Identity\n  /**\n   * Optional vendor-opaque payload that round-trips back to a matching model wire.\n   *\n   * @remarks\n   * Carries anything the ADK cannot interpret but a specific provider can — for example,\n   * an Anthropic Messages thinking-block `signature`, an OpenAI Responses\n   * `ResponseReasoningItem.encrypted_content` blob, a DeepSeek server-side reasoning handle,\n   * or an MCP-mediated reasoning item.\n   *\n   * When present, an LLM battery MUST treat the thought as **opaque-mode**: do NOT inline\n   * `content` through the plain `<thought>` envelope; serialise `payload` back to the wire in\n   * whichever shape the matching {@link RawThought.replayCompatibility} identifier specifies.\n   * The plain-text `content` is kept alongside for token-accounting and human/observer\n   * inspection — it is not the thing the model sees.\n   *\n   * Cross-field invariant: a present `payload` REQUIRES a present {@link RawThought.replayCompatibility}.\n   * A `payload` without `replayCompatibility` is malformed (the ADK has no way to know\n   * which adapter can consume it) and {@link Thought.schema} rejects with\n   * {@link @nhtio/adk!E_INVALID_INITIAL_THOUGHT_VALUE}.\n   *\n   * @defaultValue `undefined`\n   */\n  payload?: unknown\n  /**\n   * Optional free-form identifier describing which adapter wire-shape this thought can be\n   * safely replayed into.\n   *\n   * @remarks\n   * Examples (none of these are reserved by the ADK — they are consumer conventions):\n   *   - `'plain-text'` — replayable into every LLM battery\n   *   - `'anthropic-messages-thinking-v1'`\n   *   - `'openai-responses-reasoning-item-v1'`\n   *   - `'deepseek-reasoning-handle-v1'`\n   *\n   * LLM batteries declare via constructor option which tags they can safely replay; matching\n   * opaque thoughts are routed to the wire's typed reasoning channel where it exists, or to a\n   * documented side-channel key on the request body where the wire has none. Non-matching\n   * opaque thoughts are elided from the current dispatch but NOT removed from\n   * `ctx.turnThoughts` — they remain in context so a subsequent dispatch to a different\n   * adapter that DOES declare the matching tag can pick them up.\n   *\n   * Plain-text thoughts (`payload === undefined` AND `replayCompatibility === undefined`, or\n   * explicit `replayCompatibility: 'plain-text'`) are always replayable.\n   *\n   * A `replayCompatibility` without a `payload` is allowed — it documents intent (\"this\n   * plain-text thought is only meaningful to a specific fine-tuned variant\") without\n   * requiring an opaque blob.\n   *\n   * @defaultValue `undefined`\n   */\n  replayCompatibility?: string\n  /** When this thought was recorded. */\n  createdAt: string | number | Date | DateTime\n  /** When this thought was last modified. */\n  updatedAt: string | number | Date | DateTime\n}\n\n/**\n * A fully-resolved {@link RawThought} where temporal fields have been normalised to Luxon\n * `DateTime` instances.\n *\n * @remarks\n * Used internally by the {@link Thought} constructor to assign private fields with\n * guaranteed types.\n */\ninterface ResolvedThought {\n  id: string\n  content: Tokenizable\n  identity: string | RawIdentity | Identity\n  payload?: unknown\n  replayCompatibility?: string\n  createdAt: DateTime\n  updatedAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawThought} before constructing a {@link Thought}.\n *\n * @remarks\n * Validates all fields of {@link RawThought}:\n * - `id` — required non-empty string.\n * - `content` — required string or {@link @nhtio/adk!Tokenizable}, via {@link @nhtio/adk!Tokenizable.schema}.\n * - `identity` — optional string, {@link @nhtio/adk!RawIdentity}, or {@link @nhtio/adk!Identity}; defaults to\n *   `'assistant'` when omitted.\n * - `createdAt` / `updatedAt` — required datetime-parseable values, normalised to `DateTime`.\n *\n * Throws {@link @nhtio/adk!E_INVALID_INITIAL_THOUGHT_VALUE} (via the {@link Thought} constructor) when\n * validation fails.\n */\nconst rawThoughtSchema = validator\n  .object<RawThought>({\n    id: validator.string().required(),\n    content: Tokenizable.schema.required(),\n    identity: validator.alternatives(validator.string(), Identity.schema).default('assistant'),\n    payload: validator.any().optional(),\n    replayCompatibility: validator.string().min(1).optional(),\n    createdAt: validator.datetime().required(),\n    updatedAt: validator.datetime().required(),\n  })\n  .custom((value, helpers) => {\n    const v = value as RawThought\n    if (\n      v.payload !== undefined &&\n      (v.replayCompatibility === undefined || v.replayCompatibility === null)\n    ) {\n      return helpers.error('any.invalid')\n    }\n    return value\n  })\n\n/**\n * An immutable, validated internal reasoning trace produced by an agent.\n *\n * @remarks\n * Represents an agent's internal thinking — distinct from {@link @nhtio/adk!Message} (which is part of\n * the visible conversation) and never shown to end users directly. Carries an `identity` so\n * reasoning traces can be attributed to a specific agent in multi-agent conversations.\n * Constructed from a {@link RawThought} via `rawThoughtSchema`. The `content` field is always\n * a {@link @nhtio/adk!Tokenizable} so token cost can be estimated inline.\n */\nexport class Thought {\n  /**\n   * Validator schema that accepts a {@link RawThought} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a thought entry.\n   */\n  public static schema = rawThoughtSchema\n\n  /**\n   * Returns `true` if `value` is a {@link Thought} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety — `instanceof` would fail for instances\n   * created in a different module copy or VM context.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link Thought} instance.\n   */\n  public static isThought(value: unknown): value is Thought {\n    return isInstanceOf(value, 'Thought', Thought)\n  }\n\n  /** Stable unique identifier for this thought. */\n  declare readonly id: string\n  /** The reasoning content as a {@link @nhtio/adk!Tokenizable} for inline token estimation. */\n  declare readonly content: Tokenizable\n  /** The identity of the agent who produced this thought. */\n  declare readonly identity: Identity\n  /**\n   * Optional vendor-opaque payload that round-trips back to a matching model wire.\n   * See {@link RawThought.payload}.\n   */\n  declare readonly payload: unknown\n  /**\n   * Optional wire-shape identifier describing which adapter can safely replay this thought.\n   * See {@link RawThought.replayCompatibility}.\n   */\n  declare readonly replayCompatibility: string | undefined\n  /** When this thought was recorded. */\n  declare readonly createdAt: DateTime\n  /** When this thought was last modified. */\n  declare readonly updatedAt: DateTime\n\n  #id: string\n  #content: Tokenizable\n  #identity: Identity\n  #payload: unknown\n  #replayCompatibility: string | undefined\n  #createdAt: DateTime\n  #updatedAt: DateTime\n\n  /**\n   * @param raw - The raw thought input validated against `rawThoughtSchema`.\n   * @throws {@link @nhtio/adk!E_INVALID_INITIAL_THOUGHT_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawThought) {\n    let resolved: ResolvedThought\n    try {\n      resolved = validateOrThrow<ResolvedThought>(rawThoughtSchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_THOUGHT_VALUE({ cause: isError(err) ? err : undefined })\n    }\n    this.#id = resolved.id\n    this.#content = Tokenizable.isTokenizable(resolved.content)\n      ? resolved.content\n      : new Tokenizable(resolved.content)\n    const rawIdentity = resolved.identity\n    this.#identity = Identity.isIdentity(rawIdentity)\n      ? rawIdentity\n      : typeof rawIdentity === 'string'\n        ? new Identity({ identifier: rawIdentity, representation: rawIdentity })\n        : new Identity(rawIdentity)\n    this.#payload = resolved.payload\n    this.#replayCompatibility = resolved.replayCompatibility\n    this.#createdAt = resolved.createdAt\n    this.#updatedAt = resolved.updatedAt\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      content: {\n        get: () => this.#content,\n        enumerable: true,\n        configurable: false,\n      },\n      identity: {\n        get: () => this.#identity,\n        enumerable: true,\n        configurable: false,\n      },\n      payload: {\n        get: () => this.#payload,\n        enumerable: true,\n        configurable: false,\n      },\n      replayCompatibility: {\n        get: () => this.#replayCompatibility,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      updatedAt: {\n        get: () => this.#updatedAt,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n}\n"],"mappings":"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"}

package/thought-DuN2PgdO.js

@@ -0,0 +1,494 @@
+require("./chunk-KmRHZBOW.js");
+const require_exceptions = require("./exceptions-D5YrO9Vm.js");
+const require_tool_registry = require("./tool_registry-Dkfprsck.js");
+const require_runtime = require("./runtime-BJVkrGQe.js");
+const require_tool_call = require("./tool_call-DFgzcVcU.js");
+let _nhtio_validation = require("@nhtio/validation");
+//#region src/lib/classes/identity.ts
+/**
+* Validator schema used to validate a {@link RawIdentity} before constructing an {@link Identity}.
+*
+* @remarks
+* Validates both fields of {@link RawIdentity}:
+* - `identifier` — required string or number.
+* - `representation` — required string or {@link @nhtio/adk!Tokenizable}, via {@link @nhtio/adk!Tokenizable.schema}.
+*
+* Throws {@link @nhtio/adk!E_INVALID_INITIAL_IDENTITY_VALUE} (via the {@link Identity} constructor) when
+* validation fails.
+*/
+var rawIdentitySchema = _nhtio_validation.validator.object({
+	identifier: _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string(), _nhtio_validation.validator.number()).required(),
+	representation: require_tool_registry.Tokenizable.schema.required()
+});
+/**
+* An immutable, validated participant identity attached to a {@link @nhtio/adk!Message}.
+*
+* @remarks
+* Carries two distinct representations of the same participant: `identifier` is the
+* system-facing key (e.g. a database ID) used to correlate messages programmatically;
+* `representation` is what the model sees when it needs to distinguish between participants
+* sharing the same role. The `representation` is always a {@link @nhtio/adk!Tokenizable} so token cost
+* can be estimated inline.
+*/
+var Identity = class Identity {
+	/**
+	* Validator schema that accepts a {@link RawIdentity} object.
+	*
+	* @remarks
+	* Reusable fragment for any schema that needs to validate or nest an identity — for example,
+	* as a required field inside a message schema.
+	*/
+	static schema = rawIdentitySchema;
+	/**
+	* Returns `true` if `value` is an {@link Identity} instance.
+	*
+	* @remarks
+	* Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety — `instanceof` would fail for instances
+	* created in a different module copy or VM context.
+	*
+	* @param value - The value to test.
+	* @returns `true` when `value` is an {@link Identity} instance.
+	*/
+	static isIdentity(value) {
+		return require_tool_registry.isInstanceOf(value, "Identity", Identity);
+	}
+	#identifier;
+	#representation;
+	/**
+	* @param raw - The raw identity input validated against `rawIdentitySchema`.
+	* @throws {@link @nhtio/adk!E_INVALID_INITIAL_IDENTITY_VALUE} when `raw` does not satisfy the schema.
+	*/
+	constructor(raw) {
+		let resolved;
+		try {
+			resolved = require_exceptions.validateOrThrow(rawIdentitySchema, raw, true);
+		} catch (err) {
+			throw new require_runtime.E_INVALID_INITIAL_IDENTITY_VALUE({ cause: require_tool_registry.isError(err) ? err : void 0 });
+		}
+		this.#identifier = resolved.identifier;
+		this.#representation = require_tool_registry.Tokenizable.isTokenizable(resolved.representation) ? resolved.representation : new require_tool_registry.Tokenizable(resolved.representation);
+		Object.defineProperties(this, {
+			identifier: {
+				get: () => this.#identifier,
+				enumerable: true,
+				configurable: false
+			},
+			representation: {
+				get: () => this.#representation,
+				enumerable: true,
+				configurable: false
+			}
+		});
+	}
+};
+//#endregion
+//#region src/lib/classes/memory.ts
+/**
+* Validator schema used to validate a {@link RawMemory} before constructing a {@link Memory}.
+*
+* @remarks
+* Validates all six fields of {@link RawMemory}:
+* - `id` — required non-empty string.
+* - `content` — required string or {@link @nhtio/adk!Tokenizable}, via {@link @nhtio/adk!Tokenizable.schema}.
+* - `confidence` — required number in `[0, 1]`.
+* - `importance` — required number in `[0, 1]`.
+* - `createdAt` / `updatedAt` — required datetime-parseable values, normalised to `DateTime`.
+*
+* Throws {@link @nhtio/adk!E_INVALID_INITIAL_MEMORY_VALUE} (via the {@link Memory} constructor) when
+* validation fails.
+*/
+var rawMemorySchema = _nhtio_validation.validator.object({
+	id: _nhtio_validation.validator.string().required(),
+	content: require_tool_registry.Tokenizable.schema.required(),
+	confidence: _nhtio_validation.validator.number().min(0).max(1).required(),
+	importance: _nhtio_validation.validator.number().min(0).max(1).required(),
+	createdAt: _nhtio_validation.validator.datetime().required(),
+	updatedAt: _nhtio_validation.validator.datetime().required()
+});
+/**
+* An immutable, validated memory entry held by the agent.
+*
+* @remarks
+* Constructed from a {@link RawMemory} via `rawMemorySchema`. All temporal fields are
+* normalised to Luxon `DateTime` instances at construction time. The `content` field is
+* always a {@link @nhtio/adk!Tokenizable} so callers can estimate token cost without an additional
+* wrapping step.
+*/
+var Memory = class Memory {
+	/**
+	* Validator schema that accepts a {@link RawMemory} object.
+	*
+	* @remarks
+	* Reusable fragment for any schema that needs to validate or nest a memory entry — for
+	* example, a collection schema that holds an array of memories.
+	*/
+	static schema = rawMemorySchema;
+	/**
+	* Returns `true` if `value` is a {@link Memory} instance.
+	*
+	* @remarks
+	* Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety — `instanceof` would fail for instances
+	* created in a different module copy or VM context.
+	*
+	* @param value - The value to test.
+	* @returns `true` when `value` is a {@link Memory} instance.
+	*/
+	static isMemory(value) {
+		return require_tool_registry.isInstanceOf(value, "Memory", Memory);
+	}
+	#id;
+	#content;
+	#confidence;
+	#importance;
+	#createdAt;
+	#updatedAt;
+	/**
+	* @param raw - The raw memory input validated against `rawMemorySchema`.
+	* @throws {@link @nhtio/adk!E_INVALID_INITIAL_MEMORY_VALUE} when `raw` does not satisfy the schema.
+	*/
+	constructor(raw) {
+		let resolved;
+		try {
+			resolved = require_exceptions.validateOrThrow(rawMemorySchema, raw, true);
+		} catch (err) {
+			throw new require_runtime.E_INVALID_INITIAL_MEMORY_VALUE({ cause: require_tool_registry.isError(err) ? err : void 0 });
+		}
+		this.#id = resolved.id;
+		this.#content = require_tool_registry.Tokenizable.isTokenizable(resolved.content) ? resolved.content : new require_tool_registry.Tokenizable(resolved.content);
+		this.#confidence = resolved.confidence;
+		this.#importance = resolved.importance;
+		this.#createdAt = resolved.createdAt;
+		this.#updatedAt = resolved.updatedAt;
+		Object.defineProperties(this, {
+			id: {
+				get: () => this.#id,
+				enumerable: true,
+				configurable: false
+			},
+			content: {
+				get: () => this.#content,
+				enumerable: true,
+				configurable: false
+			},
+			confidence: {
+				get: () => this.#confidence,
+				enumerable: true,
+				configurable: false
+			},
+			importance: {
+				get: () => this.#importance,
+				enumerable: true,
+				configurable: false
+			},
+			createdAt: {
+				get: () => this.#createdAt,
+				enumerable: true,
+				configurable: false
+			},
+			updatedAt: {
+				get: () => this.#updatedAt,
+				enumerable: true,
+				configurable: false
+			}
+		});
+	}
+};
+//#endregion
+//#region src/lib/classes/message.ts
+/**
+* Validator schema used to validate a {@link RawMessage} before constructing a {@link Message}.
+*
+* @remarks
+* Validates all fields of {@link RawMessage}:
+* - `id` — required non-empty string.
+* - `role` — required; must be `'user'` or `'assistant'`.
+* - `content` — optional string or {@link @nhtio/adk!Tokenizable}, via {@link @nhtio/adk!Tokenizable.schema}.
+* - `attachments` — optional array of {@link @nhtio/adk!Media} instances. Defaults to `[]`.
+* - At least one of `content` or `attachments` must be present and non-empty; a message with
+*   neither is invalid.
+* - `identity` — required string, {@link @nhtio/adk!RawIdentity}, or {@link @nhtio/adk!Identity}; a plain string is
+*   mapped to both `identifier` and `representation` automatically.
+* - `createdAt` / `updatedAt` — required datetime-parseable values, normalised to `DateTime`.
+*
+* Throws {@link @nhtio/adk!E_INVALID_INITIAL_MESSAGE_VALUE} (via the {@link Message} constructor) when
+* validation fails.
+*/
+var rawMessageSchema = _nhtio_validation.validator.object({
+	id: _nhtio_validation.validator.string().required(),
+	role: _nhtio_validation.validator.string().valid("user", "assistant").required(),
+	content: require_tool_registry.Tokenizable.schema.optional(),
+	attachments: _nhtio_validation.validator.array().items(_nhtio_validation.validator.any().custom((value, helpers) => {
+		if (require_tool_call.Media.isMedia(value)) return value;
+		return helpers.error("any.invalid");
+	})).default([]),
+	identity: _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string(), Identity.schema).default(_nhtio_validation.validator.ref("role")),
+	createdAt: _nhtio_validation.validator.datetime().required(),
+	updatedAt: _nhtio_validation.validator.datetime().required()
+}).custom((value, helpers) => {
+	const resolved = value;
+	const hasContent = resolved.content !== void 0 && resolved.content !== null;
+	const hasAttachments = Array.isArray(resolved.attachments) && resolved.attachments.length > 0;
+	if (!hasContent && !hasAttachments) return helpers.error("any.invalid");
+	return resolved;
+});
+/**
+* An immutable, validated conversation message from a human participant or the model.
+*
+* @remarks
+* Covers only `user` and `assistant` roles — system instructions, developer directives, and
+* tool results are not represented here. Constructed from a {@link RawMessage} via
+* `rawMessageSchema`. Temporal fields are normalised to Luxon `DateTime` instances at
+* construction time. Both `content` and `identity.representation` are {@link @nhtio/adk!Tokenizable} so
+* token cost can be estimated inline.
+*
+* A message may carry `content` (text), `attachments` (media), or both. The cross-field rule
+* on `rawMessageSchema` enforces that at least one is present. Downstream code that reaches
+* for `message.content` must handle the attachments-only case where `content` is `undefined`.
+*/
+var Message = class Message {
+	/**
+	* Validator schema that accepts a {@link RawMessage} object.
+	*
+	* @remarks
+	* Reusable fragment for any schema that needs to validate or nest a message entry — for
+	* example, a collection schema that holds an array of messages.
+	*/
+	static schema = rawMessageSchema;
+	/**
+	* Returns `true` if `value` is a {@link Message} instance.
+	*
+	* @remarks
+	* Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety — `instanceof` would fail for instances
+	* created in a different module copy or VM context.
+	*
+	* @param value - The value to test.
+	* @returns `true` when `value` is a {@link Message} instance.
+	*/
+	static isMessage(value) {
+		return require_tool_registry.isInstanceOf(value, "Message", Message);
+	}
+	#id;
+	#role;
+	#content;
+	#attachments;
+	#identity;
+	#createdAt;
+	#updatedAt;
+	/**
+	* @param raw - The raw message input validated against `rawMessageSchema`.
+	* @throws {@link @nhtio/adk!E_INVALID_INITIAL_MESSAGE_VALUE} when `raw` does not satisfy the schema —
+	*   including the cross-field rule that at least one of `content` or `attachments` must be
+	*   present and non-empty.
+	*/
+	constructor(raw) {
+		let resolved;
+		try {
+			resolved = require_exceptions.validateOrThrow(rawMessageSchema, raw, true);
+		} catch (err) {
+			throw new require_runtime.E_INVALID_INITIAL_MESSAGE_VALUE({ cause: require_tool_registry.isError(err) ? err : void 0 });
+		}
+		this.#id = resolved.id;
+		this.#role = resolved.role;
+		this.#content = resolved.content === void 0 || resolved.content === null ? void 0 : require_tool_registry.Tokenizable.isTokenizable(resolved.content) ? resolved.content : new require_tool_registry.Tokenizable(resolved.content);
+		this.#attachments = Object.freeze([...resolved.attachments ?? []]);
+		const rawIdentity = resolved.identity;
+		this.#identity = Identity.isIdentity(rawIdentity) ? rawIdentity : typeof rawIdentity === "string" ? new Identity({
+			identifier: rawIdentity,
+			representation: rawIdentity
+		}) : new Identity(rawIdentity);
+		this.#createdAt = resolved.createdAt;
+		this.#updatedAt = resolved.updatedAt;
+		Object.defineProperties(this, {
+			id: {
+				get: () => this.#id,
+				enumerable: true,
+				configurable: false
+			},
+			role: {
+				get: () => this.#role,
+				enumerable: true,
+				configurable: false
+			},
+			content: {
+				get: () => this.#content,
+				enumerable: true,
+				configurable: false
+			},
+			attachments: {
+				get: () => this.#attachments,
+				enumerable: true,
+				configurable: false
+			},
+			identity: {
+				get: () => this.#identity,
+				enumerable: true,
+				configurable: false
+			},
+			createdAt: {
+				get: () => this.#createdAt,
+				enumerable: true,
+				configurable: false
+			},
+			updatedAt: {
+				get: () => this.#updatedAt,
+				enumerable: true,
+				configurable: false
+			}
+		});
+	}
+};
+//#endregion
+//#region src/lib/classes/thought.ts
+/**
+* Validator schema used to validate a {@link RawThought} before constructing a {@link Thought}.
+*
+* @remarks
+* Validates all fields of {@link RawThought}:
+* - `id` — required non-empty string.
+* - `content` — required string or {@link @nhtio/adk!Tokenizable}, via {@link @nhtio/adk!Tokenizable.schema}.
+* - `identity` — optional string, {@link @nhtio/adk!RawIdentity}, or {@link @nhtio/adk!Identity}; defaults to
+*   `'assistant'` when omitted.
+* - `createdAt` / `updatedAt` — required datetime-parseable values, normalised to `DateTime`.
+*
+* Throws {@link @nhtio/adk!E_INVALID_INITIAL_THOUGHT_VALUE} (via the {@link Thought} constructor) when
+* validation fails.
+*/
+var rawThoughtSchema = _nhtio_validation.validator.object({
+	id: _nhtio_validation.validator.string().required(),
+	content: require_tool_registry.Tokenizable.schema.required(),
+	identity: _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string(), Identity.schema).default("assistant"),
+	payload: _nhtio_validation.validator.any().optional(),
+	replayCompatibility: _nhtio_validation.validator.string().min(1).optional(),
+	createdAt: _nhtio_validation.validator.datetime().required(),
+	updatedAt: _nhtio_validation.validator.datetime().required()
+}).custom((value, helpers) => {
+	const v = value;
+	if (v.payload !== void 0 && (v.replayCompatibility === void 0 || v.replayCompatibility === null)) return helpers.error("any.invalid");
+	return value;
+});
+/**
+* An immutable, validated internal reasoning trace produced by an agent.
+*
+* @remarks
+* Represents an agent's internal thinking — distinct from {@link @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 {@link RawThought} via `rawThoughtSchema`. The `content` field is always
+* a {@link @nhtio/adk!Tokenizable} so token cost can be estimated inline.
+*/
+var Thought = class Thought {
+	/**
+	* Validator schema that accepts a {@link RawThought} object.
+	*
+	* @remarks
+	* Reusable fragment for any schema that needs to validate or nest a thought entry.
+	*/
+	static schema = rawThoughtSchema;
+	/**
+	* Returns `true` if `value` is a {@link Thought} instance.
+	*
+	* @remarks
+	* Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety — `instanceof` would fail for instances
+	* created in a different module copy or VM context.
+	*
+	* @param value - The value to test.
+	* @returns `true` when `value` is a {@link Thought} instance.
+	*/
+	static isThought(value) {
+		return require_tool_registry.isInstanceOf(value, "Thought", Thought);
+	}
+	#id;
+	#content;
+	#identity;
+	#payload;
+	#replayCompatibility;
+	#createdAt;
+	#updatedAt;
+	/**
+	* @param raw - The raw thought input validated against `rawThoughtSchema`.
+	* @throws {@link @nhtio/adk!E_INVALID_INITIAL_THOUGHT_VALUE} when `raw` does not satisfy the schema.
+	*/
+	constructor(raw) {
+		let resolved;
+		try {
+			resolved = require_exceptions.validateOrThrow(rawThoughtSchema, raw, true);
+		} catch (err) {
+			throw new require_runtime.E_INVALID_INITIAL_THOUGHT_VALUE({ cause: require_tool_registry.isError(err) ? err : void 0 });
+		}
+		this.#id = resolved.id;
+		this.#content = require_tool_registry.Tokenizable.isTokenizable(resolved.content) ? resolved.content : new require_tool_registry.Tokenizable(resolved.content);
+		const rawIdentity = resolved.identity;
+		this.#identity = Identity.isIdentity(rawIdentity) ? rawIdentity : typeof rawIdentity === "string" ? new Identity({
+			identifier: rawIdentity,
+			representation: rawIdentity
+		}) : new Identity(rawIdentity);
+		this.#payload = resolved.payload;
+		this.#replayCompatibility = resolved.replayCompatibility;
+		this.#createdAt = resolved.createdAt;
+		this.#updatedAt = resolved.updatedAt;
+		Object.defineProperties(this, {
+			id: {
+				get: () => this.#id,
+				enumerable: true,
+				configurable: false
+			},
+			content: {
+				get: () => this.#content,
+				enumerable: true,
+				configurable: false
+			},
+			identity: {
+				get: () => this.#identity,
+				enumerable: true,
+				configurable: false
+			},
+			payload: {
+				get: () => this.#payload,
+				enumerable: true,
+				configurable: false
+			},
+			replayCompatibility: {
+				get: () => this.#replayCompatibility,
+				enumerable: true,
+				configurable: false
+			},
+			createdAt: {
+				get: () => this.#createdAt,
+				enumerable: true,
+				configurable: false
+			},
+			updatedAt: {
+				get: () => this.#updatedAt,
+				enumerable: true,
+				configurable: false
+			}
+		});
+	}
+};
+//#endregion
+Object.defineProperty(exports, "Identity", {
+	enumerable: true,
+	get: function() {
+		return Identity;
+	}
+});
+Object.defineProperty(exports, "Memory", {
+	enumerable: true,
+	get: function() {
+		return Memory;
+	}
+});
+Object.defineProperty(exports, "Message", {
+	enumerable: true,
+	get: function() {
+		return Message;
+	}
+});
+Object.defineProperty(exports, "Thought", {
+	enumerable: true,
+	get: function() {
+		return Thought;
+	}
+});
+
+//# sourceMappingURL=thought-DuN2PgdO.js.map