@ably/ai-transport 0.0.1 → 0.1.0

package/dist/ably-ai-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"ably-ai-transport.js","names":[],"sources":["../src/constants.ts","../src/errors.ts","../src/utils.ts","../src/core/transport/headers.ts","../src/core/transport/pipe-stream.ts","../src/core/transport/turn-manager.ts","../src/core/transport/server-transport.ts","../src/event-emitter.ts","../src/logger.ts","../src/core/transport/conversation-tree.ts","../src/core/transport/decode-history.ts","../src/core/transport/stream-router.ts","../src/core/transport/client-transport.ts","../src/core/codec/decoder.ts","../src/core/codec/encoder.ts","../src/core/codec/lifecycle-tracker.ts"],"sourcesContent":["/**\n * Shared constants used by both codec and transport layers.\n *\n * Header constants define the `x-ably-*` wire protocol. Message and event\n * name constants define the transport lifecycle signals on the channel.\n *\n * These live at the top level (not in codec/ or transport/) because both\n * layers need them — the codec core reads/writes stream and status headers,\n * while the transport layer reads/writes turn, cancel, and role headers.\n */\n\n// ---------------------------------------------------------------------------\n// Stream headers (used by codec encoder/decoder core)\n// ---------------------------------------------------------------------------\n\n/** Header: whether this Ably message uses streaming (message appends) or is discrete. Always \"true\" or \"false\". */\nexport const HEADER_STREAM = 'x-ably-stream';\n\n/** Header: lifecycle status of a streamed message. Only set when x-ably-stream is \"true\". */\nexport const HEADER_STATUS = 'x-ably-status';\n\n/** Header: stream identity. Set by the encoder on every streamed message; read by the decoder to correlate streams. */\nexport const HEADER_STREAM_ID = 'x-ably-stream-id';\n\n// ---------------------------------------------------------------------------\n// Identity headers (used by transport for turn correlation)\n// ---------------------------------------------------------------------------\n\n/** Header: turn correlation ID. Set on every message in a turn. */\nexport const HEADER_TURN_ID = 'x-ably-turn-id';\n\n/** Header: message identity. Assigned per message (user or assistant). Used for optimistic reconciliation on the client. */\nexport const HEADER_MSG_ID = 'x-ably-msg-id';\n\n/** Header: clientId of the user who initiated the turn. Set by the server on stream messages. */\nexport const HEADER_TURN_CLIENT_ID = 'x-ably-turn-client-id';\n\n/** Header: message role (e.g. \"user\", \"assistant\"). */\nexport const HEADER_ROLE = 'x-ably-role';\n\n// ---------------------------------------------------------------------------\n// Cancel headers\n// ---------------------------------------------------------------------------\n\n/** Header: cancel a specific turn by ID. */\nexport const HEADER_CANCEL_TURN_ID = 'x-ably-cancel-turn-id';\n\n/** Header: cancel all turns belonging to the sender's clientId. */\nexport const HEADER_CANCEL_OWN = 'x-ably-cancel-own';\n\n/** Header: cancel all turns on the channel. */\nexport const HEADER_CANCEL_ALL = 'x-ably-cancel-all';\n\n/** Header: cancel all turns belonging to a specific clientId. */\nexport const HEADER_CANCEL_CLIENT_ID = 'x-ably-cancel-client-id';\n\n// ---------------------------------------------------------------------------\n// Fork / branching headers\n// ---------------------------------------------------------------------------\n\n/** Header: the msg-id of the immediately preceding message in this branch. */\nexport const HEADER_PARENT = 'x-ably-parent';\n\n/** Header: the msg-id of the message this one replaces (creates a fork). */\nexport const HEADER_FORK_OF = 'x-ably-fork-of';\n\n// ---------------------------------------------------------------------------\n// Turn lifecycle headers\n// ---------------------------------------------------------------------------\n\n/** Header: reason a turn ended (on x-ably-turn-end messages). */\nexport const HEADER_TURN_REASON = 'x-ably-turn-reason';\n\n// ---------------------------------------------------------------------------\n// Message / event names\n// ---------------------------------------------------------------------------\n\n/** Message name: client->server cancel signal. */\nexport const EVENT_CANCEL = 'x-ably-cancel';\n\n/** Message name: server publishes this to signal a turn has started. */\nexport const EVENT_TURN_START = 'x-ably-turn-start';\n\n/** Message name: server publishes this to signal a turn has ended. */\nexport const EVENT_TURN_END = 'x-ably-turn-end';\n\n/** Message name: transport-level abort signal (stream cancelled). */\nexport const EVENT_ABORT = 'x-ably-abort';\n\n/** Message name: transport-level error signal. */\nexport const EVENT_ERROR = 'x-ably-error';\n\n// ---------------------------------------------------------------------------\n// Domain header prefix (used by codec implementations)\n// ---------------------------------------------------------------------------\n\n/** Prefix for domain-specific headers. Distinguishes codec-layer headers from transport `x-ably-*` headers. */\nexport const DOMAIN_HEADER_PREFIX = 'x-domain-';\n","import * as Ably from 'ably';\n\n/**\n * Error codes for the AI Transport SDK.\n */\nexport enum ErrorCode {\n  /**\n   * The request was invalid.\n   */\n  BadRequest = 40000,\n\n  /**\n   * Invalid argument provided.\n   */\n  InvalidArgument = 40003,\n\n  // 104000 - 104999 are reserved for AI Transport SDK errors\n\n  /**\n   * Encoder recovery failed after flush — one or more updateMessage calls\n   * could not recover a failed append pipeline.\n   */\n  EncoderRecoveryFailed = 104000,\n\n  /**\n   * A transport-level channel subscription callback threw unexpectedly.\n   */\n  TransportSubscriptionError = 104001,\n\n  /**\n   * Cancel listener or onCancel hook threw while processing a cancel message.\n   */\n  CancelListenerError = 104002,\n\n  /**\n   * A turn lifecycle event (turn-start or turn-end) failed to publish.\n   */\n  TurnLifecycleError = 104003,\n\n  /**\n   * An operation was attempted on a transport that has already been closed.\n   */\n  TransportClosed = 104004,\n\n  /**\n   * The HTTP POST to the server endpoint failed (network error or non-2xx response).\n   */\n  TransportSendFailed = 104005,\n}\n\n/**\n * Returns true if the {@link Ably.ErrorInfo} code matches the provided ErrorCode value.\n * @param errorInfo The error info to check.\n * @param error The error code to compare against.\n * @returns true if the error code matches, false otherwise.\n */\n// eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison\nexport const errorInfoIs = (errorInfo: Ably.ErrorInfo, error: ErrorCode): boolean => errorInfo.code === error;\n","/**\n * Shared utilities for working with Ably messages.\n *\n * These are general-purpose helpers used by both the codec and transport\n * layers. They live at the top level to avoid either layer depending on\n * the other.\n */\n\nimport type * as Ably from 'ably';\n\nimport { DOMAIN_HEADER_PREFIX } from './constants.js';\n\n/**\n * Extract extras.headers from an Ably InboundMessage.\n * @param message - The Ably message to extract headers from.\n * @returns The headers record, or an empty object if absent.\n */\nexport const getHeaders = (message: Ably.InboundMessage): Record<string, string> => {\n  // CAST: Ably SDK types `extras` as `any`; runtime checks below guard access.\n  const extras = message.extras as unknown;\n  if (!extras || typeof extras !== 'object') return {};\n  const headers = (extras as { headers?: unknown }).headers;\n  if (!headers || typeof headers !== 'object') return {};\n  // CAST: Ably wire protocol guarantees headers is Record<string, string>\n  // when present, verified by the runtime guards above.\n  return headers as Record<string, string>;\n};\n\n/**\n * Parse a JSON string, returning undefined on failure.\n * @param value - The JSON string to parse.\n * @returns The parsed value, or undefined if parsing fails.\n */\nexport const parseJson = (value: string | undefined): unknown => {\n  if (value === undefined) return undefined;\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Set a header value if defined, skipping undefined and null. Strings are set directly,\n * booleans and numbers are stringified, objects are JSON-serialized.\n * @param headers - The headers object to mutate.\n * @param key - The header key.\n * @param value - The value to set.\n */\nexport const setIfPresent = (headers: Record<string, string>, key: string, value: unknown): void => {\n  if (value === undefined || value === null) return;\n  if (typeof value === 'string') {\n    headers[key] = value;\n  } else if (typeof value === 'boolean' || typeof value === 'number') {\n    headers[key] = String(value);\n  } else if (typeof value === 'object') {\n    headers[key] = JSON.stringify(value);\n  }\n};\n\n/**\n * Set multiple headers at once, skipping entries whose values are undefined or null.\n * Each value is converted using the same rules as {@link setIfPresent}.\n * @param headers - The headers object to mutate.\n * @param entries - Key-value pairs to set.\n */\nexport const setHeadersIfPresent = (headers: Record<string, string>, entries: Record<string, unknown>): void => {\n  for (const [key, value] of Object.entries(entries)) {\n    setIfPresent(headers, key, value);\n  }\n};\n\n/**\n * Merge two header records into a new object. Later values override earlier ones.\n * Undefined inputs are treated as empty.\n * @param base - Base headers (lower priority).\n * @param overrides - Override headers (higher priority).\n * @returns A new merged headers object.\n */\nexport const mergeHeaders = (\n  base: Record<string, string> | undefined,\n  overrides: Record<string, string> | undefined,\n): Record<string, string> => ({\n  ...base,\n  ...overrides,\n});\n\n/**\n * Parse a boolean header (\"true\"/\"false\"), returning undefined if absent.\n * @param value - The header string to parse.\n * @returns True if \"true\", false for any other string, or undefined if absent.\n */\nexport const parseBool = (value: string | undefined): boolean | undefined => {\n  if (value === undefined) return undefined;\n  return value === 'true';\n};\n\n/**\n * Build a domain headers record from key-value pairs. Each key is automatically\n * prefixed with {@link DOMAIN_HEADER_PREFIX}. Values that are undefined or null\n * are skipped; strings are set directly; booleans, numbers, and objects are\n * converted using the same rules as {@link setIfPresent}.\n * @param entries - Unprefixed key-value pairs (e.g. `{ toolCallId: 'tc-1' }` becomes `{ 'x-domain-toolCallId': 'tc-1' }`).\n * @returns A new headers record with prefixed keys.\n */\nexport const domainHeaders = (entries: Record<string, unknown>): Record<string, string> => {\n  const h: Record<string, string> = {};\n  for (const [key, value] of Object.entries(entries)) {\n    setIfPresent(h, DOMAIN_HEADER_PREFIX + key, value);\n  }\n  return h;\n};\n\n/**\n * Read a domain header value from a headers record.\n * @param headers - The headers record to read from.\n * @param key - The unprefixed domain key (e.g. `'toolCallId'` reads `'x-domain-toolCallId'`).\n * @returns The header value, or undefined if absent.\n */\nexport const getDomainHeader = (headers: Record<string, string>, key: string): string | undefined =>\n  headers[DOMAIN_HEADER_PREFIX + key];\n\n/**\n * Mapped type that converts properties whose type includes `undefined`\n * into optional properties with `undefined` excluded from the value.\n * Properties typed as `unknown` are kept required (since `undefined extends unknown`\n * is always true, but `unknown` fields are intentionally broad, not optional).\n */\nexport type Stripped<T> = {\n  [K in keyof T as undefined extends T[K] ? (unknown extends T[K] ? K : never) : K]: T[K];\n} & {\n  [K in keyof T as undefined extends T[K] ? (unknown extends T[K] ? never : K) : never]?: Exclude<T[K], undefined>;\n};\n\n/**\n * Remove all keys whose value is `undefined` from a shallow object.\n * Returns a new object — the input is not mutated. Useful for building\n * chunk literals with optional fields without conditional spread noise.\n *\n * The return type converts `{ foo: T | undefined }` to `{ foo?: T }`,\n * matching the optional-field pattern used by the AI SDK chunk types.\n * @param obj - The object to strip undefined values from.\n * @returns A shallow copy with undefined-valued keys removed.\n */\nexport const stripUndefined = <T extends Record<string, unknown>>(obj: T): Stripped<T> => {\n  const result = {} as Record<string, unknown>;\n  for (const key in obj) {\n    if (Object.prototype.hasOwnProperty.call(obj, key) && obj[key] !== undefined) {\n      result[key] = obj[key];\n    }\n  }\n  // CAST: The runtime strip guarantees the Stripped<T> contract —\n  // required keys are always present, optional keys are absent when undefined.\n  return result as Stripped<T>;\n};\n\n// ---------------------------------------------------------------------------\n// DomainHeaderReader — typed accessors for domain headers\n// ---------------------------------------------------------------------------\n\n/**\n * Typed accessor wrapper around a headers record for reading domain headers.\n * Reduces repetitive `getDomainHeader` + `parseBool` / `parseJson` chains.\n */\nexport interface DomainHeaderReader {\n  /** Read a domain header as a string, or undefined if absent. */\n  str(key: string): string | undefined;\n  /** Read a domain header as a string, falling back to a default if absent. */\n  strOr(key: string, fallback: string): string;\n  /** Read a domain header as a boolean (\"true\"/\"false\"), or undefined if absent. */\n  bool(key: string): boolean | undefined;\n  /** Read a domain header as parsed JSON, or undefined if absent or invalid. */\n  json(key: string): unknown;\n}\n\n/**\n * Create a {@link DomainHeaderReader} over a headers record.\n * @param headers - The raw headers record to read domain headers from.\n * @returns A typed accessor for domain header values.\n */\nexport const headerReader = (headers: Record<string, string>): DomainHeaderReader => ({\n  str: (key: string) => getDomainHeader(headers, key),\n  strOr: (key: string, fallback: string) => getDomainHeader(headers, key) ?? fallback,\n  bool: (key: string) => parseBool(getDomainHeader(headers, key)),\n  json: (key: string) => parseJson(getDomainHeader(headers, key)),\n});\n\n// ---------------------------------------------------------------------------\n// DomainHeaderWriter — typed builder for domain headers\n// ---------------------------------------------------------------------------\n\n/**\n * Fluent builder for constructing domain header records with typed setters.\n * Mirrors {@link DomainHeaderReader} with the same method names for symmetry.\n * Undefined values are silently skipped on all setters.\n */\nexport interface DomainHeaderWriter {\n  /** Set a string domain header. Skips if value is undefined. */\n  str(key: string, value: string | undefined): DomainHeaderWriter;\n  /** Set a boolean domain header (serialized as \"true\"/\"false\"). Skips if value is undefined. */\n  bool(key: string, value: boolean | undefined): DomainHeaderWriter;\n  /** Set a JSON-serialized domain header. Skips if value is undefined or null. */\n  json(key: string, value: unknown): DomainHeaderWriter;\n  /** Return the accumulated headers record. */\n  build(): Record<string, string>;\n}\n\n/**\n * Create a {@link DomainHeaderWriter} for building a domain headers record.\n * @returns A fluent builder that prefixes each key with the domain header prefix.\n */\nexport const headerWriter = (): DomainHeaderWriter => {\n  const h: Record<string, string> = {};\n  const writer: DomainHeaderWriter = {\n    str: (key: string, value: string | undefined) => {\n      if (value !== undefined) h[DOMAIN_HEADER_PREFIX + key] = value;\n      return writer;\n    },\n    bool: (key: string, value: boolean | undefined) => {\n      if (value !== undefined) h[DOMAIN_HEADER_PREFIX + key] = String(value);\n      return writer;\n    },\n    json: (key: string, value: unknown) => {\n      if (value !== undefined && value !== null) h[DOMAIN_HEADER_PREFIX + key] = JSON.stringify(value);\n      return writer;\n    },\n    build: () => h,\n  };\n  return writer;\n};\n","/**\n * Transport header builder.\n *\n * Single source of truth for which `x-ably-*` headers every transport\n * message carries. Used by the server transport (addMessages, streamResponse)\n * and will be used by the client transport (optimistic message stamping).\n */\n\nimport {\n  HEADER_FORK_OF,\n  HEADER_MSG_ID,\n  HEADER_PARENT,\n  HEADER_ROLE,\n  HEADER_TURN_CLIENT_ID,\n  HEADER_TURN_ID,\n} from '../../constants.js';\n\n/**\n * Build the standard transport header set for a message.\n * @param opts - The header values to include.\n * @param opts.role - Message role (e.g. \"user\", \"assistant\").\n * @param opts.turnId - Turn correlation ID.\n * @param opts.msgId - Message identity.\n * @param opts.turnClientId - ClientId of the turn initiator.\n * @param opts.parent - Preceding message's msg-id (for branching). Null means root.\n * @param opts.forkOf - Forked message's msg-id (for edit/regen).\n * @returns A headers record with the `x-ably-*` transport headers set.\n */\nexport const buildTransportHeaders = (opts: {\n  role: string;\n  turnId: string;\n  msgId: string;\n  turnClientId?: string;\n  parent?: string | null;\n  forkOf?: string;\n}): Record<string, string> => {\n  const h: Record<string, string> = {\n    [HEADER_ROLE]: opts.role,\n    [HEADER_TURN_ID]: opts.turnId,\n    [HEADER_MSG_ID]: opts.msgId,\n  };\n  if (opts.turnClientId !== undefined) h[HEADER_TURN_CLIENT_ID] = opts.turnClientId;\n  if (opts.parent) h[HEADER_PARENT] = opts.parent;\n  if (opts.forkOf) h[HEADER_FORK_OF] = opts.forkOf;\n  return h;\n};\n","/**\n * Pure stream piping function.\n *\n * Reads events from a ReadableStream, writes them to a streaming encoder,\n * and handles abort/error. No dependencies on turn state or transport internals.\n */\n\nimport type { Logger } from '../../logger.js';\nimport type { StreamEncoder } from '../codec/types.js';\nimport type { StreamResult } from './types.js';\n\n/**\n * Pipe an event stream through an encoder to the channel.\n *\n * Returns when the stream completes, is cancelled (via signal), or errors.\n * The `reason` field of the result indicates which case occurred.\n * @param stream - The event stream to read from.\n * @param encoder - The streaming encoder to write events through.\n * @param signal - Abort signal to monitor for cancellation.\n * @param onAbort - Optional callback invoked when the stream is cancelled, before the stream ends.\n * @param logger - Optional logger for diagnostic output.\n * @returns The reason the pipe ended.\n */\nexport const pipeStream = async <TEvent, TMessage>(\n  stream: ReadableStream<TEvent>,\n  encoder: StreamEncoder<TEvent, TMessage>,\n  signal: AbortSignal | undefined,\n  onAbort?: (write: (event: TEvent) => Promise<void>) => void | Promise<void>,\n  logger?: Logger,\n): Promise<StreamResult> => {\n  logger?.trace('pipeStream();');\n\n  const reader = stream.getReader();\n\n  let abortListener: (() => void) | undefined;\n  const abortPromise = signal\n    ? new Promise<void>((resolve) => {\n        if (signal.aborted) {\n          resolve();\n          return;\n        }\n        abortListener = () => {\n          resolve();\n        };\n        signal.addEventListener('abort', abortListener, { once: true });\n      })\n    : // eslint-disable-next-line @typescript-eslint/no-empty-function -- never-resolving promise: no signal means no cancellation path\n      new Promise<void>(() => {});\n\n  let reason: StreamResult['reason'] = 'complete';\n\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- intentional infinite loop broken by return/break\n    while (true) {\n      // .then() is intentional: transforms the abort signal into a discriminant\n      // for Promise.race — no async/await equivalent for this pattern.\n      const result = await Promise.race([reader.read(), abortPromise.then(() => 'aborted' as const)]);\n\n      if (result === 'aborted') {\n        reason = 'cancelled';\n        logger?.debug('pipeStream(); stream cancelled by abort signal');\n        if (onAbort) {\n          await onAbort(async (event: TEvent) => encoder.appendEvent(event));\n        }\n        await encoder.abort('cancelled');\n        break;\n      }\n\n      const { done, value } = result;\n      if (done) {\n        await encoder.close();\n        logger?.debug('pipeStream(); stream completed');\n        break;\n      }\n\n      await encoder.appendEvent(value);\n    }\n  } catch (error) {\n    reason = 'error';\n    const errorText = error instanceof Error ? error.message : String(error);\n    logger?.error('pipeStream(); stream error', { error: errorText });\n    try {\n      await encoder.close();\n    } catch {\n      // Best-effort: encoder close in the error path may also fail\n      // (e.g. channel disconnected). The original error is preserved in\n      // the StreamResult reason (\"error\").\n    }\n  } finally {\n    if (abortListener) signal?.removeEventListener('abort', abortListener);\n    reader.releaseLock();\n  }\n\n  return { reason };\n};\n","/**\n * Server-side turn state management and lifecycle event publishing.\n *\n * Owns the authoritative turn lifecycle. Tracks active turns with their\n * AbortControllers and clientIds. Publishes turn-start and turn-end events\n * on the Ably channel so all clients can react to turn state changes.\n */\n\nimport type * as Ably from 'ably';\n\nimport {\n  EVENT_TURN_END,\n  EVENT_TURN_START,\n  HEADER_TURN_CLIENT_ID,\n  HEADER_TURN_ID,\n  HEADER_TURN_REASON,\n} from '../../constants.js';\nimport type { Logger } from '../../logger.js';\nimport type { TurnEndReason } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Interface\n// ---------------------------------------------------------------------------\n\n/** Manages active turns and publishes turn lifecycle events on the channel. */\nexport interface TurnManager {\n  /** Register a new turn. Publishes turn-start on the channel. Returns AbortSignal. */\n  startTurn(turnId: string, clientId?: string, controller?: AbortController): Promise<AbortSignal>;\n  /** End a turn. Publishes turn-end on the channel. Cleans up internal state. */\n  endTurn(turnId: string, reason: TurnEndReason): Promise<void>;\n  /** Get the AbortSignal for a turn. */\n  getSignal(turnId: string): AbortSignal | undefined;\n  /** Get the clientId that owns a turn. */\n  getClientId(turnId: string): string | undefined;\n  /** Abort the signal for a turn. */\n  abort(turnId: string): void;\n  /** Get all active turn IDs. */\n  getActiveTurnIds(): string[];\n  /** Abort all active turns and clear state. */\n  close(): void;\n}\n\n// ---------------------------------------------------------------------------\n// Internal state\n// ---------------------------------------------------------------------------\n\ninterface TurnState {\n  controller: AbortController;\n  clientId: string;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nclass DefaultTurnManager implements TurnManager {\n  private readonly _channel: Ably.RealtimeChannel;\n  private readonly _logger: Logger | undefined;\n  private readonly _activeTurns = new Map<string, TurnState>();\n\n  constructor(channel: Ably.RealtimeChannel, logger?: Logger) {\n    this._channel = channel;\n    this._logger = logger?.withContext({ component: 'TurnManager' });\n  }\n\n  async startTurn(turnId: string, clientId?: string, externalController?: AbortController): Promise<AbortSignal> {\n    this._logger?.trace('DefaultTurnManager.startTurn();', { turnId, clientId });\n\n    const controller = externalController ?? new AbortController();\n    const resolvedClientId = clientId ?? '';\n    this._activeTurns.set(turnId, { controller, clientId: resolvedClientId });\n\n    await this._channel.publish({\n      name: EVENT_TURN_START,\n      extras: {\n        headers: {\n          [HEADER_TURN_ID]: turnId,\n          [HEADER_TURN_CLIENT_ID]: resolvedClientId,\n        },\n      },\n    });\n\n    this._logger?.debug('DefaultTurnManager.startTurn(); turn started', { turnId });\n    return controller.signal;\n  }\n\n  async endTurn(turnId: string, reason: TurnEndReason): Promise<void> {\n    this._logger?.trace('DefaultTurnManager.endTurn();', { turnId, reason });\n\n    const state = this._activeTurns.get(turnId);\n    const resolvedClientId = state?.clientId ?? '';\n\n    // Publish before deleting local state so that if publish fails,\n    // the turn remains in the active set and can be retried or cleaned up.\n    await this._channel.publish({\n      name: EVENT_TURN_END,\n      extras: {\n        headers: {\n          [HEADER_TURN_ID]: turnId,\n          [HEADER_TURN_CLIENT_ID]: resolvedClientId,\n          [HEADER_TURN_REASON]: reason,\n        },\n      },\n    });\n\n    this._activeTurns.delete(turnId);\n    this._logger?.debug('DefaultTurnManager.endTurn(); turn ended', { turnId, reason });\n  }\n\n  getSignal(turnId: string): AbortSignal | undefined {\n    return this._activeTurns.get(turnId)?.controller.signal;\n  }\n\n  getClientId(turnId: string): string | undefined {\n    return this._activeTurns.get(turnId)?.clientId;\n  }\n\n  abort(turnId: string): void {\n    this._logger?.debug('DefaultTurnManager.abort();', { turnId });\n    this._activeTurns.get(turnId)?.controller.abort();\n  }\n\n  getActiveTurnIds(): string[] {\n    return [...this._activeTurns.keys()];\n  }\n\n  close(): void {\n    this._logger?.trace('DefaultTurnManager.close();', { activeTurns: this._activeTurns.size });\n    for (const state of this._activeTurns.values()) {\n      state.controller.abort();\n    }\n    this._activeTurns.clear();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a turn manager bound to the given channel.\n * @param channel - The Ably channel to publish lifecycle events on.\n * @param logger - Optional logger for diagnostic output.\n * @returns A new {@link TurnManager} instance.\n */\nexport const createTurnManager = (channel: Ably.RealtimeChannel, logger?: Logger): TurnManager =>\n  new DefaultTurnManager(channel, logger);\n","/**\n * Core server-side transport, parameterized by codec.\n *\n * Composes TurnManager and pipeStream to handle the full server-side turn\n * lifecycle. Cancel message routing is handled directly by the transport's\n * single channel subscription — no separate cancel manager needed.\n *\n * The transport exposes a single factory method — `newTurn()` — which returns\n * a Turn object with explicit lifecycle methods: start(), addMessages(),\n * streamResponse(), and end().\n */\n\nimport * as Ably from 'ably';\n\nimport {\n  EVENT_CANCEL,\n  HEADER_CANCEL_ALL,\n  HEADER_CANCEL_CLIENT_ID,\n  HEADER_CANCEL_OWN,\n  HEADER_CANCEL_TURN_ID,\n  HEADER_MSG_ID,\n} from '../../constants.js';\nimport { ErrorCode } from '../../errors.js';\nimport type { Logger } from '../../logger.js';\nimport { getHeaders, mergeHeaders } from '../../utils.js';\nimport { buildTransportHeaders } from './headers.js';\nimport { pipeStream } from './pipe-stream.js';\nimport type { TurnManager } from './turn-manager.js';\nimport { createTurnManager } from './turn-manager.js';\nimport type {\n  AddMessageOptions,\n  AddMessagesResult,\n  CancelFilter,\n  CancelRequest,\n  MessageWithHeaders,\n  NewTurnOptions,\n  ServerTransport,\n  ServerTransportOptions,\n  StreamResponseOptions,\n  StreamResult,\n  Turn,\n  TurnEndReason,\n} from './types.js';\n\n// ---------------------------------------------------------------------------\n// Internal turn record for cancel routing\n// ---------------------------------------------------------------------------\n\ninterface RegisteredTurn {\n  turnId: string;\n  clientId: string;\n  controller: AbortController;\n  onCancel?: (request: CancelRequest) => Promise<boolean>;\n  onError?: (error: Ably.ErrorInfo) => void;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-ST1\nclass DefaultServerTransport<TEvent, TMessage> implements ServerTransport<TEvent, TMessage> {\n  private readonly _channel: Ably.RealtimeChannel;\n  private readonly _codec: ServerTransportOptions<TEvent, TMessage>['codec'];\n  private readonly _logger: Logger | undefined;\n  private readonly _onError: ((error: Ably.ErrorInfo) => void) | undefined;\n  private readonly _turnManager: TurnManager;\n  private readonly _registeredTurns = new Map<string, RegisteredTurn>();\n  private readonly _channelListener: (msg: Ably.InboundMessage) => void;\n  private readonly _attachPromise: Promise<void>;\n\n  constructor(options: ServerTransportOptions<TEvent, TMessage>) {\n    this._channel = options.channel;\n    this._codec = options.codec;\n    this._logger = options.logger?.withContext({ component: 'ServerTransport' });\n    this._onError = options.onError;\n    this._turnManager = createTurnManager(this._channel, this._logger);\n\n    this._channelListener = (msg: Ably.InboundMessage) => {\n      this._handleChannelMessage(msg);\n    };\n\n    // Spec: AIT-ST2\n    // Subscribe before attach (RTL7g) — ensures no messages are missed.\n    this._attachPromise = this._channel.subscribe(EVENT_CANCEL, this._channelListener).then(\n      /* eslint-disable @typescript-eslint/no-empty-function -- discard subscription handle */\n      () => {},\n      /* eslint-enable @typescript-eslint/no-empty-function */\n      (error: unknown) => {\n        const errInfo = new Ably.ErrorInfo(\n          `unable to subscribe to cancel messages; ${error instanceof Error ? error.message : String(error)}`,\n          ErrorCode.TransportSubscriptionError,\n          500,\n          error instanceof Ably.ErrorInfo ? error : undefined,\n        );\n        this._logger?.error('DefaultServerTransport(); subscribe failed');\n        this._onError?.(errInfo);\n      },\n    );\n\n    this._logger?.debug('DefaultServerTransport(); transport created');\n  }\n\n  // -------------------------------------------------------------------------\n  // Public API\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-ST3\n  newTurn(turnOpts: NewTurnOptions<TEvent>): Turn<TEvent, TMessage> {\n    this._logger?.trace('DefaultServerTransport.newTurn();', { turnId: turnOpts.turnId });\n    return this._createTurn(turnOpts);\n  }\n\n  // Spec: AIT-ST11\n  close(): void {\n    this._logger?.trace('DefaultServerTransport.close();');\n    this._channel.unsubscribe(EVENT_CANCEL, this._channelListener);\n    for (const reg of this._registeredTurns.values()) {\n      reg.controller.abort();\n    }\n    this._registeredTurns.clear();\n    this._turnManager.close();\n    this._logger?.debug('DefaultServerTransport.close(); transport closed');\n  }\n\n  // -------------------------------------------------------------------------\n  // Cancel message routing\n  // -------------------------------------------------------------------------\n\n  private _resolveFilter(filter: CancelFilter, senderClientId?: string): string[] {\n    const turnIds = [...this._registeredTurns.keys()];\n\n    if (filter.all) return turnIds;\n    if (filter.own && senderClientId) {\n      return turnIds.filter((id) => this._registeredTurns.get(id)?.clientId === senderClientId);\n    }\n    if (filter.clientId) {\n      return turnIds.filter((id) => this._registeredTurns.get(id)?.clientId === filter.clientId);\n    }\n    if (filter.turnId && this._registeredTurns.has(filter.turnId)) {\n      return [filter.turnId];\n    }\n    return [];\n  }\n\n  // Spec: AIT-ST8, AIT-ST9\n  private async _handleCancelMessage(msg: Ably.InboundMessage): Promise<void> {\n    const headers = getHeaders(msg);\n\n    const filter: CancelFilter = {};\n    if (headers[HEADER_CANCEL_TURN_ID]) {\n      filter.turnId = headers[HEADER_CANCEL_TURN_ID];\n    } else if (headers[HEADER_CANCEL_OWN] === 'true') {\n      filter.own = true;\n    } else if (headers[HEADER_CANCEL_CLIENT_ID]) {\n      filter.clientId = headers[HEADER_CANCEL_CLIENT_ID];\n    } else if (headers[HEADER_CANCEL_ALL] === 'true') {\n      filter.all = true;\n    }\n\n    const matchedTurnIds = this._resolveFilter(filter, msg.clientId);\n    if (matchedTurnIds.length === 0) return;\n\n    this._logger?.debug('DefaultServerTransport._handleCancelMessage(); matched turns', {\n      matchedTurnIds,\n      filter,\n    });\n\n    const owners = new Map<string, string>();\n    for (const tid of matchedTurnIds) {\n      const reg = this._registeredTurns.get(tid);\n      owners.set(tid, reg?.clientId ?? '');\n    }\n    const request: CancelRequest = { message: msg, filter, matchedTurnIds, turnOwners: owners };\n\n    for (const turnId of matchedTurnIds) {\n      const reg = this._registeredTurns.get(turnId);\n      if (!reg) continue;\n\n      try {\n        if (reg.onCancel) {\n          const allowed = await reg.onCancel(request);\n          if (!allowed) {\n            this._logger?.debug('DefaultServerTransport._handleCancelMessage(); cancel rejected by onCancel', {\n              turnId,\n            });\n            continue;\n          }\n        }\n        reg.controller.abort();\n        this._logger?.debug('DefaultServerTransport._handleCancelMessage(); turn aborted', { turnId });\n      } catch (error) {\n        // A throwing onCancel handler must not prevent other turns from being cancelled.\n        const errInfo = new Ably.ErrorInfo(\n          `unable to process cancel for turn ${turnId}; onCancel handler threw: ${error instanceof Error ? error.message : String(error)}`,\n          ErrorCode.CancelListenerError,\n          500,\n          error instanceof Ably.ErrorInfo ? error : undefined,\n        );\n        this._logger?.error('DefaultServerTransport._handleCancelMessage(); onCancel threw', { turnId });\n        (reg.onError ?? this._onError)?.(errInfo);\n      }\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Channel subscription handler\n  // -------------------------------------------------------------------------\n\n  private _handleChannelMessage(msg: Ably.InboundMessage): void {\n    try {\n      if (msg.name === EVENT_CANCEL) {\n        // Fire-and-forget async handler — errors are caught internally.\n        this._handleCancelMessage(msg).catch((error: unknown) => {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to route cancel message; ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.CancelListenerError,\n            500,\n            error instanceof Ably.ErrorInfo ? error : undefined,\n          );\n          this._logger?.error('DefaultServerTransport._handleChannelMessage(); cancel routing error');\n          this._onError?.(errInfo);\n        });\n      }\n    } catch (error) {\n      const errInfo = new Ably.ErrorInfo(\n        `unable to process channel message; ${error instanceof Error ? error.message : String(error)}`,\n        ErrorCode.TransportSubscriptionError,\n        500,\n        error instanceof Ably.ErrorInfo ? error : undefined,\n      );\n      this._logger?.error('DefaultServerTransport._handleChannelMessage(); subscription error');\n      this._onError?.(errInfo);\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Turn creation\n  // -------------------------------------------------------------------------\n\n  private _createTurn(turnOpts: NewTurnOptions<TEvent>): Turn<TEvent, TMessage> {\n    const {\n      turnId,\n      clientId: turnClientId,\n      onMessage,\n      onAbort,\n      onCancel,\n      onError: turnOnError,\n      parent: turnParent,\n      forkOf: turnForkOf,\n    } = turnOpts;\n\n    const controller = new AbortController();\n    let started = false;\n    let ended = false;\n\n    // Register immediately so early cancels can fire the abort signal.\n    const registration: RegisteredTurn = {\n      turnId,\n      clientId: turnClientId ?? '',\n      controller,\n      onCancel,\n      onError: turnOnError,\n    };\n    this._registeredTurns.set(turnId, registration);\n\n    // Capture instance members as locals so arrow functions close over them\n    // without needing `this` (avoids unicorn/no-this-assignment).\n    const logger = this._logger;\n    const turnManager = this._turnManager;\n    const attachPromise = this._attachPromise;\n    const codec = this._codec;\n    const channel = this._channel;\n    const registeredTurns = this._registeredTurns;\n\n    const turn: Turn<TEvent, TMessage> = {\n      get turnId() {\n        return turnId;\n      },\n      get abortSignal() {\n        return controller.signal;\n      },\n\n      // Spec: AIT-ST4\n      start: async (): Promise<void> => {\n        logger?.trace('Turn.start();', { turnId });\n\n        if (controller.signal.aborted) {\n          throw new Ably.ErrorInfo(\n            `unable to start turn; turn ${turnId} was cancelled before start()`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        if (started) return;\n        started = true;\n\n        try {\n          await turnManager.startTurn(turnId, turnClientId, controller);\n        } catch (error) {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to publish turn-start for turn ${turnId}; ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.TurnLifecycleError,\n            500,\n            error instanceof Ably.ErrorInfo ? error : undefined,\n          );\n          logger?.error('Turn.start(); failed to publish turn-start', { turnId });\n          turnOnError?.(errInfo);\n          throw errInfo;\n        }\n\n        logger?.debug('Turn.start(); turn started', { turnId });\n      },\n\n      // Spec: AIT-ST5\n      addMessages: async (\n        inputs: MessageWithHeaders<TMessage>[],\n        opts?: AddMessageOptions,\n      ): Promise<AddMessagesResult> => {\n        logger?.trace('Turn.addMessages();', { turnId, count: inputs.length });\n\n        if (!started) {\n          throw new Ably.ErrorInfo(\n            `unable to add messages; start() must be called before addMessages() (turn ${turnId})`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        await attachPromise;\n\n        const msgIds: string[] = [];\n\n        for (const input of inputs) {\n          const msgId = crypto.randomUUID();\n\n          // Transport headers are the defaults; per-message headers from the\n          // client override them. This lets the client's x-ably-msg-id pass\n          // through for optimistic reconciliation with client inserts.\n          const headers = mergeHeaders(\n            buildTransportHeaders({\n              role: 'user',\n              turnId,\n              msgId,\n              turnClientId: opts?.clientId,\n              // Per-operation options override turn-level defaults\n              parent: opts?.parent === undefined ? (turnParent ?? undefined) : (opts.parent ?? undefined),\n              forkOf: opts?.forkOf ?? turnForkOf,\n            }),\n            input.headers,\n          );\n\n          const encoder = codec.createEncoder(channel, {\n            extras: { headers },\n            onMessage,\n          });\n\n          await encoder.writeMessages([input.message], opts?.clientId ? { clientId: opts.clientId } : undefined);\n\n          // Capture the effective msg-id after input.headers may have overridden it.\n          msgIds.push(headers[HEADER_MSG_ID] ?? msgId);\n        }\n\n        logger?.debug('Turn.addMessages(); messages published', { turnId, count: inputs.length });\n        return { msgIds };\n      },\n\n      // Spec: AIT-ST6\n      streamResponse: async (\n        stream: ReadableStream<TEvent>,\n        streamOpts?: StreamResponseOptions,\n      ): Promise<StreamResult> => {\n        logger?.trace('Turn.streamResponse();', { turnId });\n\n        if (!started) {\n          throw new Ably.ErrorInfo(\n            `unable to stream response; start() must be called before streamResponse() (turn ${turnId})`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        await attachPromise;\n\n        const signal = turnManager.getSignal(turnId);\n        const turnOwnerClientId = turnManager.getClientId(turnId);\n\n        // Per-operation parent overrides the turn-level default.\n        const assistantParent =\n          streamOpts?.parent === undefined ? (turnParent ?? undefined) : (streamOpts.parent ?? undefined);\n\n        const defaultHeaders = buildTransportHeaders({\n          role: 'assistant',\n          turnId,\n          msgId: crypto.randomUUID(),\n          turnClientId: turnOwnerClientId,\n          parent: assistantParent,\n          forkOf: streamOpts?.forkOf ?? turnForkOf,\n        });\n        const encoder = codec.createEncoder(channel, {\n          extras: { headers: defaultHeaders },\n          onMessage,\n        });\n\n        const result = await pipeStream(stream, encoder, signal, onAbort, logger);\n\n        logger?.debug('Turn.streamResponse(); stream finished', { turnId, reason: result.reason });\n        return result;\n      },\n\n      // Spec: AIT-ST7\n      end: async (reason: TurnEndReason): Promise<void> => {\n        logger?.trace('Turn.end();', { turnId, reason });\n\n        if (!started) {\n          throw new Ably.ErrorInfo(\n            `unable to end turn; start() must be called before end() (turn ${turnId})`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        if (ended) return;\n        ended = true;\n\n        try {\n          await turnManager.endTurn(turnId, reason);\n        } catch (error) {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to publish turn-end for turn ${turnId}; ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.TurnLifecycleError,\n            500,\n            error instanceof Ably.ErrorInfo ? error : undefined,\n          );\n          logger?.error('Turn.end(); failed to publish turn-end', { turnId });\n          turnOnError?.(errInfo);\n          throw errInfo;\n        } finally {\n          registeredTurns.delete(turnId);\n        }\n\n        logger?.debug('Turn.end(); turn ended', { turnId, reason });\n      },\n    };\n\n    return turn;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a server transport bound to the given channel and codec.\n * @param options - Transport configuration.\n * @returns A new {@link ServerTransport} instance.\n */\nexport const createServerTransport = <TEvent, TMessage>(\n  options: ServerTransportOptions<TEvent, TMessage>,\n): ServerTransport<TEvent, TMessage> => new DefaultServerTransport(options);\n","/**\n * Type-safe EventEmitter wrapping Ably's internal EventEmitter.\n *\n * Takes a single `EventsMap` type parameter — an interface mapping event names\n * to payload types — rather than Ably's three type parameters. Adapted from\n * the ably-chat-js SDK.\n *\n * ```ts\n * interface MyEvents {\n *   reaction: { emoji: string };\n *   status: { online: boolean };\n * }\n *\n * const emitter = new EventEmitter<MyEvents>(logger);\n * emitter.on('reaction', (event) => console.log(event.emoji));\n * emitter.emit('reaction', { emoji: '👍' });\n * ```\n */\n\nimport * as Ably from 'ably';\n\nimport type { Logger } from './logger.js';\n\n/** Callback receiving a union of all possible event payloads. */\ntype Callback<EventsMap> = (arg: EventsMap[keyof EventsMap]) => void;\n\n/** Callback receiving the payload for a single event type. */\ntype CallbackSingle<K> = (arg: K) => void;\n\n/**\n * Type-safe interface for the Ably EventEmitter, parameterized by an EventsMap\n * that maps event names to their payload types.\n */\ninterface InterfaceEventEmitter<EventsMap> extends Ably.EventEmitter<Callback<EventsMap>, void, keyof EventsMap> {\n  /** Emit an event with a type-safe payload. Payload is optional for `undefined`-typed events. */\n  emit<K extends keyof EventsMap>(\n    event: K,\n    ...args: EventsMap[K] extends undefined ? [EventsMap[K]?] : [EventsMap[K]]\n  ): void;\n\n  /** Subscribe to a single event with a typed callback. */\n  on<K extends keyof EventsMap>(event: K, callback: CallbackSingle<EventsMap[K]>): void;\n  /** Subscribe to two events with a union-typed callback. */\n  on<K1 extends keyof EventsMap, K2 extends keyof EventsMap>(\n    events: [K1, K2],\n    callback: CallbackSingle<EventsMap[K1] | EventsMap[K2]>,\n  ): void;\n  /** Subscribe to three events with a union-typed callback. */\n  on<K1 extends keyof EventsMap, K2 extends keyof EventsMap, K3 extends keyof EventsMap>(\n    events: [K1, K2, K3],\n    callback: CallbackSingle<EventsMap[K1] | EventsMap[K2] | EventsMap[K3]>,\n  ): void;\n  /** Subscribe to an array of events. */\n  on(events: (keyof EventsMap)[], callback: Callback<EventsMap>): void;\n  /** Subscribe to all events. */\n  on(callback: Callback<EventsMap>): void;\n\n  /** Unsubscribe a callback from a specific event. */\n  off<K extends keyof EventsMap>(event: K, listener: CallbackSingle<EventsMap[K]>): void;\n  /** Unsubscribe a callback from all events, or remove all listeners if no callback provided. */\n  off(listener?: Callback<EventsMap>): void;\n}\n\n/**\n * Bridge from our {@link Logger} to the Ably EventEmitter's internal logger\n * contract. Ably's EventEmitter calls `logger.logAction(level, action, message)`\n * when a listener throws — we route that to our Logger's `error` method.\n * @param logger - The application logger to delegate to.\n * @returns An object satisfying the Ably EventEmitter's logger interface.\n */\nconst toAblyLogger = (logger: Logger): unknown => ({\n  logAction: (_level: number, action: string, message?: string) => {\n    logger.error(action, { detail: message });\n  },\n  shouldLog: () => true,\n});\n\n// CAST: Access Ably's internal EventEmitter constructor. Not publicly exported\n// but available to other Ably SDKs. The logger parameter ensures listener\n// exceptions are caught and logged rather than crashing.\nconst InternalEventEmitter: new <EventsMap>(logger: unknown) => InterfaceEventEmitter<EventsMap> = (\n  Ably.Realtime as unknown as { EventEmitter: new <EventsMap>(logger: unknown) => InterfaceEventEmitter<EventsMap> }\n).EventEmitter;\n\n/**\n * Type-safe EventEmitter based on Ably's internal EventEmitter.\n *\n * Provides the same semantics as {@link Ably.EventEmitter} (error isolation\n * between listeners, synchronous dispatch) but with a single `EventsMap` type\n * parameter for ergonomic type safety.\n *\n * Requires a {@link Logger} so that listener exceptions are routed through\n * the application's logging infrastructure rather than silently swallowed.\n */\nexport class EventEmitter<EventsMap> extends InternalEventEmitter<EventsMap> {\n  /**\n   * Create a new EventEmitter.\n   * @param logger - Application logger. Listener exceptions are logged at error level.\n   */\n  constructor(logger: Logger) {\n    super(toAblyLogger(logger));\n  }\n}\n","import * as Ably from 'ably';\n\nimport { ErrorCode } from './errors.js';\n\n/**\n * Structured logger with leveled output and hierarchical context.\n * Implementations filter messages by level and delegate to a {@link LogHandler}.\n */\nexport interface Logger {\n  /**\n   * Log a message at the trace level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  trace(message: string, context?: LogContext): void;\n\n  /**\n   * Log a message at the debug level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log a message at the info level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a message at the warn level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log a message at the error level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  error(message: string, context?: LogContext): void;\n\n  /**\n   * Creates a new logger with a context that will be merged with any context provided to individual log calls.\n   * The context will be overridden by any matching keys in the individual log call's context.\n   * @param context The context to use for all log calls.\n   * @returns A new logger instance with the context.\n   */\n  withContext(context: LogContext): Logger;\n}\n\n/**\n * Represents the different levels of logging that can be used.\n */\nexport enum LogLevel {\n  /**\n   * Something routine and expected has occurred. This level will provide logs for the vast majority of operations\n   * and function calls.\n   */\n  Trace = 'trace',\n\n  /**\n   * Development information, messages that are useful when trying to debug library behavior,\n   * but superfluous to normal operation.\n   */\n  Debug = 'debug',\n\n  /**\n   * Informational messages. Operationally significant to the library but not out of the ordinary.\n   */\n  Info = 'info',\n\n  /**\n   * Anything that is not immediately an error, but could cause unexpected behavior in the future. For example,\n   * passing an invalid value to an option. Indicates that some action should be taken to prevent future errors.\n   */\n  Warn = 'warn',\n\n  /**\n   * A given operation has failed and cannot be automatically recovered. The error may threaten the continuity\n   * of operation.\n   */\n  Error = 'error',\n\n  /**\n   * No logging will be performed.\n   */\n  Silent = 'silent',\n}\n\n/**\n * Represents the context of a log message.\n * It is an object of key-value pairs that can be used to provide additional context to a log message.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type LogContext = Record<string, any>;\n\n/**\n * A function that can be used to handle log messages.\n * @param message The message to log.\n * @param level The log level of the message.\n * @param context The context of the log message as key-value pairs.\n */\nexport type LogHandler = (message: string, level: LogLevel, context?: LogContext) => void;\n\n/**\n * A simple console logger that logs messages to the console.\n * @param message The message to log.\n * @param level The log level of the message.\n * @param context - The context of the log message as key-value pairs.\n */\nexport const consoleLogger = (message: string, level: LogLevel, context?: LogContext) => {\n  const contextString = context ? `, context: ${JSON.stringify(context)}` : '';\n  const formattedMessage = `[${new Date().toISOString()}] ${level.valueOf().toUpperCase()} ably-ai-transport: ${message}${contextString}`;\n\n  switch (level) {\n    case LogLevel.Trace:\n    case LogLevel.Debug: {\n      console.log(formattedMessage);\n      break;\n    }\n    case LogLevel.Info: {\n      console.info(formattedMessage);\n      break;\n    }\n    case LogLevel.Warn: {\n      console.warn(formattedMessage);\n      break;\n    }\n    case LogLevel.Error: {\n      console.error(formattedMessage);\n      break;\n    }\n    case LogLevel.Silent: {\n      break;\n    }\n  }\n};\n\n/**\n * Options for creating a logger.\n */\nexport interface LoggerOptions {\n  logHandler?: LogHandler;\n  logLevel: LogLevel;\n}\n\nexport const makeLogger = (options: LoggerOptions): Logger => {\n  const logHandler = options.logHandler ?? consoleLogger;\n\n  return new DefaultLogger(logHandler, options.logLevel);\n};\n\n/**\n * A convenient list of log levels as numbers that can be used for easier comparison.\n */\nenum LogLevelNumber {\n  Trace = 0,\n  Debug = 1,\n  Info = 2,\n  Warn = 3,\n  Error = 4,\n  Silent = 5,\n}\n\n/**\n * A mapping of log levels to their numeric equivalents.\n */\nconst logLevelNumberMap = new Map<LogLevel, LogLevelNumber>([\n  [LogLevel.Trace, LogLevelNumber.Trace],\n  [LogLevel.Debug, LogLevelNumber.Debug],\n  [LogLevel.Info, LogLevelNumber.Info],\n  [LogLevel.Warn, LogLevelNumber.Warn],\n  [LogLevel.Error, LogLevelNumber.Error],\n  [LogLevel.Silent, LogLevelNumber.Silent],\n]);\n\n/**\n * A default logger implementation.\n */\nclass DefaultLogger implements Logger {\n  private readonly _handler: LogHandler;\n  private readonly _levelNumber: LogLevelNumber;\n  private readonly _context?: LogContext;\n\n  constructor(handler: LogHandler, level: LogLevel, context?: LogContext) {\n    this._handler = handler;\n    this._context = context;\n\n    const levelNumber = logLevelNumberMap.get(level);\n    if (levelNumber === undefined) {\n      throw new Ably.ErrorInfo(`unable to create logger; invalid log level: ${level}`, ErrorCode.InvalidArgument, 400);\n    }\n\n    this._levelNumber = levelNumber;\n  }\n\n  trace(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Trace, LogLevelNumber.Trace, context);\n  }\n\n  debug(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Debug, LogLevelNumber.Debug, context);\n  }\n\n  info(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Info, LogLevelNumber.Info, context);\n  }\n\n  warn(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Warn, LogLevelNumber.Warn, context);\n  }\n\n  error(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Error, LogLevelNumber.Error, context);\n  }\n\n  withContext(context: LogContext): Logger {\n    // Get the original log level by finding the key in logLevelNumberMap that matches this._levelNumber\n    const originalLevel =\n      [...logLevelNumberMap.entries()].find(([, value]) => value === this._levelNumber)?.[0] ?? LogLevel.Error;\n\n    return new DefaultLogger(this._handler, originalLevel, this._mergeContext(context));\n  }\n\n  private _write(message: string, level: LogLevel, levelNumber: LogLevelNumber, context?: LogContext): void {\n    if (levelNumber >= this._levelNumber) {\n      this._handler(message, level, this._mergeContext(context));\n    }\n  }\n\n  private _mergeContext(context?: LogContext): LogContext | undefined {\n    if (!this._context) {\n      return context ?? undefined;\n    }\n\n    return context ? { ...this._context, ...context } : this._context;\n  }\n}\n","/**\n * ConversationTree — materializes a branching conversation from a flat\n * oplog of Ably messages using serial-first ordering.\n *\n * Serial order (the total order assigned by Ably) is the primary mechanism\n * for linear message sequences. `x-ably-parent` and `x-ably-fork-of` headers\n * are only structurally meaningful at branch points — where the user is\n * interacting with a visible message and the client always has it loaded.\n *\n * `upsert()` is the sole mutation method. Messages can arrive in any order\n * (live subscription, history pages, seed data) and the tree produces the\n * correct `flatten()` output once all messages are present.\n *\n * The tree owns conversation state. `flatten()` returns the linear message\n * list for the currently selected branches — this is what the transport's\n * `getMessages()` delegates to.\n */\n\nimport { HEADER_FORK_OF, HEADER_PARENT } from '../../constants.js';\nimport type { Logger } from '../../logger.js';\nimport type { ConversationNode, ConversationTree } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Internal node type\n// ---------------------------------------------------------------------------\n\ninterface InternalNode<TMessage> {\n  node: ConversationNode<TMessage>;\n  /** Insertion sequence — tiebreaker for null-serial messages. */\n  insertSeq: number;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CT13\nclass DefaultConversationTree<TMessage> implements ConversationTree<TMessage> {\n  /** All nodes indexed by msgId (x-ably-msg-id). */\n  private readonly _nodeIndex = new Map<string, InternalNode<TMessage>>();\n\n  /** Secondary index: codec message key to msgId. Bridges UIMessage.id to x-ably-msg-id. */\n  private readonly _codecKeyIndex = new Map<string, string>();\n\n  /**\n   * All nodes sorted by serial (lexicographic). Null-serial messages\n   * (optimistic inserts, seed data) sort after all serial-bearing messages,\n   * ordered among themselves by insertion sequence.\n   */\n  private readonly _sortedList: InternalNode<TMessage>[] = [];\n\n  /**\n   * Parent index: parentId to set of child msgIds.\n   * Nodes with no parent are indexed under the key `null`.\n   */\n  private readonly _parentIndex = new Map<string | undefined, Set<string>>();\n\n  /**\n   * Selected sibling index at each fork point, keyed by the msgId of\n   * the first sibling in the group (the fork target). Default: last.\n   */\n  private readonly _selections = new Map<string, number>();\n\n  private readonly _getKey: (message: TMessage) => string;\n  private readonly _logger: Logger;\n\n  /** Monotonically increasing counter for insertion sequence. */\n  private _seqCounter = 0;\n\n  constructor(getKey: (message: TMessage) => string, logger: Logger) {\n    this._getKey = getKey;\n    this._logger = logger;\n  }\n\n  // -------------------------------------------------------------------------\n  // Sorted list maintenance\n  // -------------------------------------------------------------------------\n\n  /**\n   * Compare two nodes for sorted list ordering.\n   * Serial-bearing nodes sort by serial (lexicographic).\n   * Null-serial nodes sort after all serial-bearing nodes.\n   * Among null-serial nodes, sort by insertion sequence.\n   * @param a - First node to compare.\n   * @param b - Second node to compare.\n   * @returns Negative if a sorts before b, positive if after, zero if equal.\n   */\n  // Spec: AIT-CT13a\n  private _compareNodes(a: InternalNode<TMessage>, b: InternalNode<TMessage>): number {\n    const sa = a.node.serial;\n    const sb = b.node.serial;\n    if (sa === undefined && sb === undefined) return a.insertSeq - b.insertSeq;\n    if (sa === undefined) return 1; // a sorts after serial-bearing b\n    if (sb === undefined) return -1; // b sorts after serial-bearing a\n    if (sa < sb) return -1;\n    if (sa > sb) return 1;\n    return a.insertSeq - b.insertSeq; // same serial: preserve insertion order\n  }\n\n  /**\n   * Insert a node into sortedList at the correct position via binary search.\n   * @param internal - The node to insert.\n   */\n  private _insertSorted(internal: InternalNode<TMessage>): void {\n    const serial = internal.node.serial;\n\n    // Fast path: null-serial always appends to end (among other null-serials)\n    if (serial === undefined) {\n      this._sortedList.push(internal);\n      return;\n    }\n\n    // Binary search for insertion point among serial-bearing nodes.\n    let lo = 0;\n    let hi = this._sortedList.length;\n    while (lo < hi) {\n      const mid = (lo + hi) >>> 1;\n      const midNode = this._sortedList[mid];\n      if (!midNode) break; // unreachable: mid is always in bounds\n      if (this._compareNodes(midNode, internal) <= 0) {\n        lo = mid + 1;\n      } else {\n        hi = mid;\n      }\n    }\n    this._sortedList.splice(lo, 0, internal);\n  }\n\n  /**\n   * Remove a node from sortedList.\n   * @param internal - The node to remove.\n   */\n  private _removeSorted(internal: InternalNode<TMessage>): void {\n    const idx = this._sortedList.indexOf(internal);\n    if (idx !== -1) this._sortedList.splice(idx, 1);\n  }\n\n  // -------------------------------------------------------------------------\n  // Parent index maintenance\n  // -------------------------------------------------------------------------\n\n  private _addToParentIndex(parentId: string | undefined, msgId: string): void {\n    let set = this._parentIndex.get(parentId);\n    if (!set) {\n      set = new Set();\n      this._parentIndex.set(parentId, set);\n    }\n    set.add(msgId);\n  }\n\n  private _removeFromParentIndex(parentId: string | undefined, msgId: string): void {\n    const set = this._parentIndex.get(parentId);\n    if (set) {\n      set.delete(msgId);\n      if (set.size === 0) this._parentIndex.delete(parentId);\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Sibling grouping\n  // -------------------------------------------------------------------------\n\n  /**\n   * Get the sibling group that `msgId` belongs to.\n   *\n   * A sibling group is: the original message + all messages whose `forkOf`\n   * points to the original (or transitively to a sibling). We find the\n   * group root by following `forkOf` chains to the earliest ancestor that\n   * has no `forkOf` (or whose `forkOf` target doesn't share the same parent).\n   * @param msgId - The msg-id to look up the sibling group for.\n   * @returns The ordered list of sibling nodes.\n   */\n  // Spec: AIT-CT13b\n  private _getSiblingGroup(msgId: string): ConversationNode<TMessage>[] {\n    const entry = this._nodeIndex.get(msgId);\n    if (!entry) return [];\n\n    // Find the \"original\" — the message at the root of the fork chain\n    // that shares the same parentId. Guard against cycles in forkOf chains.\n    let original = entry.node;\n    const visitedGroup = new Set<string>([original.msgId]);\n    while (original.forkOf) {\n      if (visitedGroup.has(original.forkOf)) break; // cycle guard\n      const forkTarget = this._nodeIndex.get(original.forkOf);\n      if (!forkTarget || forkTarget.node.parentId !== original.parentId) break;\n      original = forkTarget.node;\n      visitedGroup.add(original.msgId);\n    }\n\n    // Collect all siblings: nodes with the same parentId that either\n    // ARE the original, or have a forkOf chain leading to the original.\n    const parentId = original.parentId;\n    const originalId = original.msgId;\n    const siblings: InternalNode<TMessage>[] = [];\n\n    const candidateIds = this._parentIndex.get(parentId);\n    if (candidateIds) {\n      for (const childId of candidateIds) {\n        const childEntry = this._nodeIndex.get(childId);\n        if (childEntry && this._isSiblingOf(childEntry.node, originalId)) {\n          siblings.push(childEntry);\n        }\n      }\n    }\n\n    // Sort by Ably serial (lexicographic). Messages without a serial\n    // (optimistic inserts before server relay) sort after all serial-bearing\n    // siblings — they represent the user's most recent action.\n    siblings.sort((a, b) => this._compareNodes(a, b));\n    return siblings.map((s) => s.node);\n  }\n\n  /**\n   * Check if `node` belongs to the sibling group rooted at `originalId`.\n   * A node is a sibling if it IS the original or its forkOf chain leads\n   * to the original (with the same parentId).\n   * @param node - The node to check.\n   * @param originalId - The group root to match against.\n   * @returns True if the node belongs to the sibling group.\n   */\n  private _isSiblingOf(node: ConversationNode<TMessage>, originalId: string): boolean {\n    if (node.msgId === originalId) return true;\n    let current = node;\n    const visited = new Set<string>([current.msgId]);\n    while (current.forkOf) {\n      if (current.forkOf === originalId) return true;\n      if (visited.has(current.forkOf)) break; // cycle guard\n      const target = this._nodeIndex.get(current.forkOf);\n      if (!target) break;\n      current = target.node;\n      visited.add(current.msgId);\n    }\n    return false;\n  }\n\n  /**\n   * Get the \"group root\" msgId for a sibling group — the original message\n   * that all forks trace back to.\n   * @param msgId - Any msg-id in the sibling group.\n   * @returns The msg-id of the group root.\n   */\n  private _getGroupRoot(msgId: string): string {\n    const entry = this._nodeIndex.get(msgId);\n    if (!entry) return msgId;\n\n    let current = entry.node;\n    const visited = new Set<string>([current.msgId]);\n    while (current.forkOf) {\n      if (visited.has(current.forkOf)) break; // cycle guard\n      const forkTarget = this._nodeIndex.get(current.forkOf);\n      if (!forkTarget || forkTarget.node.parentId !== current.parentId) break;\n      current = forkTarget.node;\n      visited.add(current.msgId);\n    }\n    return current.msgId;\n  }\n\n  // -------------------------------------------------------------------------\n  // Public query methods\n  // -------------------------------------------------------------------------\n\n  flatten(): TMessage[] {\n    const result: TMessage[] = [];\n    const currentPath = new Set<string>();\n    // Track which sibling groups we've already resolved to avoid\n    // re-resolving for every member of the group.\n    const resolvedGroups = new Map<string, string>(); // groupRootId → selected msgId\n\n    for (const internal of this._sortedList) {\n      const node = internal.node;\n      const { msgId, parentId } = node;\n\n      // Step 1: Check parent reachability.\n      if (parentId !== undefined && !currentPath.has(parentId)) {\n        continue;\n      }\n\n      // Step 2: Check sibling selection.\n      const group = this._getSiblingGroup(msgId);\n      if (group.length > 1) {\n        const groupRootId = this._getGroupRoot(msgId);\n        let selectedId = resolvedGroups.get(groupRootId);\n        if (selectedId === undefined) {\n          const selectedIdx = this._selections.get(groupRootId) ?? group.length - 1;\n          const clamped = Math.max(0, Math.min(selectedIdx, group.length - 1));\n          const selected = group[clamped];\n          if (!selected) break; // unreachable: clamped is always in bounds\n          selectedId = selected.msgId;\n          resolvedGroups.set(groupRootId, selectedId);\n        }\n        if (msgId !== selectedId) {\n          continue;\n        }\n      }\n\n      currentPath.add(msgId);\n      result.push(node.message);\n    }\n\n    return result;\n  }\n\n  getSiblings(msgId: string): TMessage[] {\n    return this._getSiblingGroup(msgId).map((n) => n.message);\n  }\n\n  hasSiblings(msgId: string): boolean {\n    return this._getSiblingGroup(msgId).length > 1;\n  }\n\n  getSelectedIndex(msgId: string): number {\n    const group = this._getSiblingGroup(msgId);\n    if (group.length <= 1) return 0;\n    const groupRootId = this._getGroupRoot(msgId);\n    const stored = this._selections.get(groupRootId);\n    if (stored !== undefined) return Math.max(0, Math.min(stored, group.length - 1));\n    return group.length - 1; // default: latest\n  }\n\n  // Spec: AIT-CT13c\n  select(msgId: string, index: number): void {\n    this._logger.debug('ConversationTree.select();', { msgId, index });\n    const group = this._getSiblingGroup(msgId);\n    if (group.length <= 1) return;\n    const groupRootId = this._getGroupRoot(msgId);\n    this._selections.set(groupRootId, Math.max(0, Math.min(index, group.length - 1)));\n  }\n\n  getNode(msgId: string): ConversationNode<TMessage> | undefined {\n    return this._nodeIndex.get(msgId)?.node;\n  }\n\n  getNodeByKey(key: string): ConversationNode<TMessage> | undefined {\n    const msgId = this._codecKeyIndex.get(key);\n    if (!msgId) return undefined;\n    return this._nodeIndex.get(msgId)?.node;\n  }\n\n  getHeaders(msgId: string): Record<string, string> | undefined {\n    return this._nodeIndex.get(msgId)?.node.headers;\n  }\n\n  // -------------------------------------------------------------------------\n  // Mutation\n  // -------------------------------------------------------------------------\n\n  upsert(msgId: string, message: TMessage, headers: Record<string, string>, serial?: string): void {\n    const parentId = headers[HEADER_PARENT] ?? undefined;\n    const forkOf = headers[HEADER_FORK_OF] ?? undefined;\n\n    // Maintain codec key → msgId secondary index\n    this._codecKeyIndex.set(this._getKey(message), msgId);\n\n    const existing = this._nodeIndex.get(msgId);\n    if (existing) {\n      // Update in place — message content may have changed (e.g. streaming).\n      // Only update headers if the new headers are non-empty (prevents\n      // streaming updates from erasing canonical headers).\n      existing.node.message = message;\n      if (Object.keys(headers).length > 0) {\n        existing.node.headers = { ...headers };\n      }\n      // Spec: AIT-CT13d\n      // Promote serial: optimistic (null) → server-assigned on relay.\n      if (serial && !existing.node.serial) {\n        this._logger.debug('ConversationTree.upsert(); promoting serial', { msgId, serial });\n        existing.node.serial = serial;\n        // Re-sort: remove from current position, re-insert at correct position.\n        this._removeSorted(existing);\n        this._insertSorted(existing);\n      }\n      return;\n    }\n\n    this._logger.trace('ConversationTree.upsert(); inserting new node', { msgId, parentId, forkOf });\n\n    const node: ConversationNode<TMessage> = {\n      message,\n      msgId,\n      parentId,\n      forkOf,\n      headers: { ...headers },\n      serial,\n    };\n\n    const internal: InternalNode<TMessage> = { node, insertSeq: this._seqCounter++ };\n    this._nodeIndex.set(msgId, internal);\n    this._addToParentIndex(parentId, msgId);\n    this._insertSorted(internal);\n  }\n\n  delete(msgId: string): void {\n    const entry = this._nodeIndex.get(msgId);\n    if (!entry) return;\n\n    this._logger.debug('ConversationTree.delete();', { msgId });\n\n    const { node } = entry;\n\n    // Clean up secondary index\n    const codecKey = this._getKey(node.message);\n    if (this._codecKeyIndex.get(codecKey) === msgId) {\n      this._codecKeyIndex.delete(codecKey);\n    }\n\n    // Remove from parent index\n    this._removeFromParentIndex(node.parentId, msgId);\n\n    // Remove from sorted list\n    this._removeSorted(entry);\n\n    // Remove from primary index\n    this._nodeIndex.delete(msgId);\n    this._selections.delete(msgId);\n\n    // Children are NOT deleted — they become unreachable in flatten()\n    // because their parent is no longer on the active path.\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a ConversationTree that materializes branching history from a flat oplog.\n * @param getKey - Codec function that returns a stable key for a domain message.\n * @param logger - Logger for diagnostic output.\n * @returns A new {@link ConversationTree} instance.\n */\nexport const createConversationTree = <TMessage>(\n  getKey: (message: TMessage) => string,\n  logger: Logger,\n): ConversationTree<TMessage> => new DefaultConversationTree(getKey, logger);\n","/**\n * decodeHistory — load conversation history from an Ably channel and\n * return decoded messages as a PaginatedMessages result.\n *\n * Uses a fresh decoder (not shared with the live subscription) to avoid\n * state conflicts. Per-turn accumulators handle interleaved turns correctly.\n *\n * The `limit` option controls the number of **messages** returned,\n * not the number of Ably wire messages fetched. The implementation pages\n * back through Ably history until `limit` complete messages have\n * been assembled. Partial turns (incomplete at the page boundary) are\n * buffered internally and completed when `next()` fetches more pages.\n *\n * Only completed messages appear in `items`. A message is complete when\n * its terminal event (finish/abort/error) has been received.\n *\n * Because Ably history returns newest-first while the decoder requires\n * chronological order, all collected Ably messages are re-decoded from\n * oldest to newest after each page fetch. This handles turns that span\n * page boundaries correctly.\n */\n\nimport type * as Ably from 'ably';\n\nimport { HEADER_MSG_ID, HEADER_TURN_ID } from '../../constants.js';\nimport type { Logger } from '../../logger.js';\nimport { getHeaders } from '../../utils.js';\nimport type { Codec, DecoderOutput, MessageAccumulator } from '../codec/types.js';\nimport type { LoadHistoryOptions, PaginatedMessages } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Shared state across pages within one history traversal\n// ---------------------------------------------------------------------------\n\ninterface HistoryState<TEvent, TMessage> {\n  codec: Codec<TEvent, TMessage>;\n  /** All raw Ably messages collected so far, in newest-first order (as received from Ably). */\n  rawMessages: Ably.InboundMessage[];\n  /** How many completed messages have been returned to the consumer so far. */\n  returnedCount: number;\n  /** How many raw Ably messages have been returned to the consumer so far. */\n  returnedRawCount: number;\n  /** The last Ably page cursor for continued pagination. */\n  lastAblyPage: Ably.PaginatedResult<Ably.InboundMessage> | undefined;\n  /** Key function for domain messages (codec.getMessageKey). */\n  getMessageKey: (message: TMessage) => string;\n  logger: Logger;\n}\n\n/** A completed message paired with its canonical wire headers and serial. */\ninterface DecodedItem<TMessage> {\n  message: TMessage;\n  headers: Record<string, string>;\n  /** Ably serial from the first Ably message for this domain message. */\n  serial: string;\n}\n\n// ---------------------------------------------------------------------------\n// Decode all collected messages from scratch (chronological order)\n// ---------------------------------------------------------------------------\n\n/**\n * Re-decode all collected raw messages into completed domain messages.\n * @param state - The shared history traversal state.\n * @returns Completed messages in newest-first order.\n */\nconst decodeAll = <TEvent, TMessage>(state: HistoryState<TEvent, TMessage>): DecodedItem<TMessage>[] => {\n  // Reverse to chronological (oldest first)\n  const chronological = [...state.rawMessages].toReversed();\n\n  // Fresh decoder and per-turn accumulators for each full re-decode.\n  const decoder = state.codec.createDecoder();\n  const turns = new Map<\n    string,\n    {\n      accumulator: MessageAccumulator<TEvent, TMessage>;\n      firstSeen: number;\n      /** Headers from the first Ably message per x-ably-msg-id within this turn. */\n      msgHeaders: Map<string, Record<string, string>>;\n      /** Ably serial from the first Ably message per x-ably-msg-id within this turn. */\n      msgSerials: Map<string, string>;\n    }\n  >();\n  const defaultAccumulator = state.codec.createAccumulator();\n  let orderCounter = 0;\n\n  // Headers for discrete messages (writeMessages output), keyed by codec message key.\n  const discreteHeaders = new Map<string, Record<string, string>>();\n  // Serials for discrete messages, keyed by codec message key.\n  const discreteSerials = new Map<string, string>();\n\n  for (const msg of chronological) {\n    const outputs: DecoderOutput<TEvent, TMessage>[] = decoder.decode(msg);\n    const headers = getHeaders(msg);\n    const turnId = headers[HEADER_TURN_ID];\n    const msgId = headers[HEADER_MSG_ID];\n    const serial = msg.serial;\n\n    if (turnId) {\n      let turn = turns.get(turnId);\n      if (!turn) {\n        turn = {\n          accumulator: state.codec.createAccumulator(),\n          firstSeen: orderCounter++,\n          msgHeaders: new Map(),\n          msgSerials: new Map(),\n        };\n        turns.set(turnId, turn);\n      }\n      // Capture headers per msg-id within this turn. Update on later\n      // messages too (e.g. closing append overrides status from\n      // \"streaming\" to \"finished\"/\"aborted\"). Only merge when the\n      // incoming message has non-empty headers.\n      if (msgId) {\n        const existing = turn.msgHeaders.get(msgId);\n        if (!existing) {\n          turn.msgHeaders.set(msgId, { ...headers });\n          if (serial) turn.msgSerials.set(msgId, serial);\n        } else if (Object.keys(headers).length > 0) {\n          Object.assign(existing, headers);\n        }\n      }\n      turn.accumulator.processOutputs(outputs);\n    } else {\n      defaultAccumulator.processOutputs(outputs);\n    }\n\n    // Capture headers and serial for discrete messages by codec key.\n    for (const output of outputs) {\n      if (output.kind === 'message') {\n        const key = state.getMessageKey(output.message);\n        const existingDiscrete = discreteHeaders.get(key);\n        if (!existingDiscrete) {\n          discreteHeaders.set(key, { ...headers });\n          if (serial) discreteSerials.set(key, serial);\n        } else if (Object.keys(headers).length > 0) {\n          Object.assign(existingDiscrete, headers);\n        }\n      }\n    }\n  }\n\n  // Collect completed messages in chronological order (oldest first) by turn.\n  const completed: DecodedItem<TMessage>[] = [];\n\n  for (const msg of defaultAccumulator.completedMessages) {\n    const key = state.getMessageKey(msg);\n    completed.push({\n      message: msg,\n      headers: discreteHeaders.get(key) ?? {},\n      serial: discreteSerials.get(key) ?? '',\n    });\n  }\n\n  const sorted = [...turns.values()].toSorted((a, b) => a.firstSeen - b.firstSeen);\n  for (const turn of sorted) {\n    // Assign headers and serials to each completed message in this turn.\n    // Discrete messages were already captured by codec key. Accumulated\n    // messages need to be matched to the turn's per-msg-id headers.\n    const claimedMsgIds = new Set<string>();\n\n    // First pass: resolve discrete messages and mark their msg-ids as claimed\n    const turnKeyHeaders = new Map<string, Record<string, string>>();\n    const turnKeySerials = new Map<string, string>();\n    for (const msg of turn.accumulator.completedMessages) {\n      const key = state.getMessageKey(msg);\n      const discrete = discreteHeaders.get(key);\n      if (discrete) {\n        turnKeyHeaders.set(key, discrete);\n        const dSerial = discreteSerials.get(key);\n        if (dSerial) turnKeySerials.set(key, dSerial);\n        const mid = discrete[HEADER_MSG_ID];\n        if (mid) claimedMsgIds.add(mid);\n      }\n    }\n\n    // Second pass: assign unclaimed msg-id entries to remaining messages\n    const unclaimedEntries = [...turn.msgHeaders.entries()].filter(([mid]) => !claimedMsgIds.has(mid));\n    let unclaimedIdx = 0;\n\n    for (const msg of turn.accumulator.completedMessages) {\n      const key = state.getMessageKey(msg);\n      const unclaimed = unclaimedEntries[unclaimedIdx];\n      if (!turnKeyHeaders.has(key) && unclaimed) {\n        const [mid, hdrs] = unclaimed;\n        turnKeyHeaders.set(key, hdrs);\n        const mSerial = turn.msgSerials.get(mid);\n        if (mSerial) turnKeySerials.set(key, mSerial);\n        unclaimedIdx++;\n      }\n    }\n\n    for (const msg of turn.accumulator.completedMessages) {\n      const key = state.getMessageKey(msg);\n      completed.push({\n        message: msg,\n        headers: turnKeyHeaders.get(key) ?? {},\n        serial: turnKeySerials.get(key) ?? '',\n      });\n    }\n  }\n\n  // Reverse to newest-first. The consumer slices from the front for the\n  // most recent page, and progressively deeper for older pages.\n  return completed.toReversed();\n};\n\n// ---------------------------------------------------------------------------\n// Fetch Ably pages until we have enough completed messages\n// ---------------------------------------------------------------------------\n\n/**\n * Fetch Ably history pages until we have enough completed messages.\n * @param state - The shared history traversal state.\n * @param ablyPage - The current Ably paginated result to start from.\n * @param limit - Target number of completed messages beyond what has already been returned.\n */\nconst fetchUntilLimit = async <TEvent, TMessage>(\n  state: HistoryState<TEvent, TMessage>,\n  ablyPage: Ably.PaginatedResult<Ably.InboundMessage>,\n  limit: number,\n): Promise<void> => {\n  state.rawMessages.push(...ablyPage.items);\n  state.lastAblyPage = ablyPage;\n\n  let decodedCount = decodeAll(state).length;\n  while (decodedCount < state.returnedCount + limit && ablyPage.hasNext()) {\n    state.logger.debug('decodeHistory.fetchUntilLimit(); fetching next page', {\n      collected: state.rawMessages.length,\n      decoded: decodedCount,\n    });\n    const nextPage = await ablyPage.next();\n    if (!nextPage) break;\n    ablyPage = nextPage;\n    state.rawMessages.push(...nextPage.items);\n    state.lastAblyPage = nextPage;\n    decodedCount = decodeAll(state).length;\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Build PaginatedMessages result from current state\n// ---------------------------------------------------------------------------\n\n/**\n * Build a PaginatedMessages page from the current decode state.\n * @param state - The shared history traversal state.\n * @param limit - Max messages per page.\n * @returns A page of decoded messages with a `next()` cursor.\n */\nconst buildResult = <TEvent, TMessage>(\n  state: HistoryState<TEvent, TMessage>,\n  limit: number,\n): PaginatedMessages<TMessage> => {\n  // allCompleted is newest-first. Slice from returnedCount for this page,\n  // then reverse to chronological for display.\n  const allCompleted = decodeAll(state);\n\n  const pageSlice = allCompleted.slice(state.returnedCount, state.returnedCount + limit);\n  const chronSlice = [...pageSlice].toReversed();\n  state.returnedCount += pageSlice.length;\n\n  const moreCompleted = allCompleted.length > state.returnedCount;\n  const moreAblyPages = state.lastAblyPage?.hasNext() ?? false;\n\n  // Raw Ably messages for this page in chronological order.\n  const newRawCount = state.rawMessages.length - state.returnedRawCount;\n  const rawSlice = newRawCount > 0 ? state.rawMessages.slice(state.returnedRawCount).toReversed() : [];\n  state.returnedRawCount = state.rawMessages.length;\n\n  return {\n    items: chronSlice.map((d) => d.message),\n    itemHeaders: chronSlice.map((d) => d.headers),\n    itemSerials: chronSlice.map((d) => d.serial),\n    rawMessages: rawSlice,\n    hasNext: () => moreCompleted || moreAblyPages,\n    next: async () => {\n      if (moreCompleted) {\n        return buildResult(state, limit);\n      }\n      if (!moreAblyPages || !state.lastAblyPage) return;\n      const nextAbly = await state.lastAblyPage.next();\n      if (!nextAbly) return;\n      await fetchUntilLimit(state, nextAbly, limit);\n      return buildResult(state, limit);\n    },\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Load conversation history from a channel and return decoded messages.\n *\n * Attaches the channel if not already attached, then calls\n * `channel.history({ untilAttach: true })` to guarantee no gap between\n * historical and live messages. The attach is idempotent.\n *\n * The `limit` option controls the number of complete messages\n * returned per page, not the number of Ably wire messages fetched.\n * @param channel - The Ably channel to load history from.\n * @param codec - The codec for decoding wire messages into domain messages.\n * @param options - Pagination options.\n * @param logger - Logger for diagnostic output.\n * @returns The first page of decoded history messages.\n */\n// Spec: AIT-CT11, AIT-CT11b\nexport const decodeHistory = async <TEvent, TMessage>(\n  channel: Ably.RealtimeChannel,\n  codec: Codec<TEvent, TMessage>,\n  options: LoadHistoryOptions | undefined,\n  logger: Logger,\n): Promise<PaginatedMessages<TMessage>> => {\n  const limit = options?.limit ?? 100;\n  const state: HistoryState<TEvent, TMessage> = {\n    codec,\n    rawMessages: [],\n    returnedCount: 0,\n    returnedRawCount: 0,\n    lastAblyPage: undefined,\n    getMessageKey: codec.getMessageKey.bind(codec),\n    logger,\n  };\n\n  logger.trace('decodeHistory();', { limit });\n\n  // Request more Ably messages than the domain limit to account for\n  // the many-to-one ratio (multiple wire messages per message).\n  const wireLimit = limit * 10;\n\n  await channel.attach();\n  const ablyPage = await channel.history({ untilAttach: true, limit: wireLimit });\n  await fetchUntilLimit(state, ablyPage, limit);\n  return buildResult(state, limit);\n};\n","/**\n * Client-side stream routing.\n *\n * Maintains a map of turnId to ReadableStreamController. Routes decoded events\n * to the correct stream. Closes streams on terminal events or explicit close.\n */\n\nimport * as Ably from 'ably';\n\nimport { ErrorCode } from '../../errors.js';\nimport type { Logger } from '../../logger.js';\nimport type { TurnEntry } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Interface\n// ---------------------------------------------------------------------------\n\n/** Routes decoded events to the correct turn's ReadableStream. */\nexport interface StreamRouter<TEvent> {\n  /** Register a new stream for a turnId. Returns the ReadableStream the consumer reads from. */\n  createStream(turnId: string): ReadableStream<TEvent>;\n  /** Close the stream for a turnId. Returns true if a stream was closed. */\n  closeStream(turnId: string): boolean;\n  /** Enqueue an event to the correct stream. Returns true if routed successfully. */\n  route(turnId: string, event: TEvent): boolean;\n  /** Whether a specific turnId has an active stream. */\n  has(turnId: string): boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CT14\nclass DefaultStreamRouter<TEvent> implements StreamRouter<TEvent> {\n  private readonly _turns = new Map<string, TurnEntry<TEvent>>();\n  private readonly _isTerminal: (event: TEvent) => boolean;\n  private readonly _logger: Logger;\n\n  constructor(isTerminal: (event: TEvent) => boolean, logger: Logger) {\n    this._isTerminal = isTerminal;\n    this._logger = logger;\n  }\n\n  createStream(turnId: string): ReadableStream<TEvent> {\n    this._logger.trace('StreamRouter.createStream();', { turnId });\n\n    // Build stream+controller together. ReadableStream's start() runs synchronously\n    // per spec, so the controller is captured before the constructor returns.\n    const entry: { controller?: ReadableStreamDefaultController<TEvent> } = {};\n    const stream = new ReadableStream<TEvent>({\n      start(controller) {\n        entry.controller = controller;\n      },\n    });\n    if (!entry.controller) {\n      throw new Ably.ErrorInfo(\n        'unable to create stream; ReadableStream start() was not called synchronously',\n        ErrorCode.TransportSubscriptionError,\n        500,\n      );\n    }\n    this._turns.set(turnId, { controller: entry.controller, turnId });\n    return stream;\n  }\n\n  // Spec: AIT-CT14b\n  closeStream(turnId: string): boolean {\n    const turn = this._turns.get(turnId);\n    if (!turn) return false;\n\n    this._logger.debug('StreamRouter.closeStream(); closing stream', { turnId });\n    try {\n      turn.controller.close();\n    } catch {\n      /* already closed */\n    }\n    this._turns.delete(turnId);\n    return true;\n  }\n\n  // Spec: AIT-CT14a\n  route(turnId: string, event: TEvent): boolean {\n    const turn = this._turns.get(turnId);\n    if (!turn) return false;\n\n    try {\n      turn.controller.enqueue(event);\n    } catch {\n      this._turns.delete(turnId);\n      return false;\n    }\n\n    if (this._isTerminal(event)) {\n      this.closeStream(turnId);\n    }\n    return true;\n  }\n\n  has(turnId: string): boolean {\n    return this._turns.has(turnId);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a StreamRouter that routes decoded events to per-turn ReadableStreams.\n * @param isTerminal - Predicate that returns true for events that close the stream.\n * @param logger - Logger for diagnostic output.\n * @returns A new {@link StreamRouter} instance.\n */\nexport const createStreamRouter = <TEvent>(\n  isTerminal: (event: TEvent) => boolean,\n  logger: Logger,\n): StreamRouter<TEvent> => new DefaultStreamRouter(isTerminal, logger);\n","/**\n * Core client-side transport, parameterized by codec.\n *\n * Composes StreamRouter and ConversationTree to handle the full client-side\n * lifecycle. Subscribes to the Ably channel on construction. The same\n * subscription, decoder, and channel are reused across turns.\n *\n * The client never publishes user messages directly. Instead, it sends them\n * to the server via HTTP POST. The server publishes user messages and turn\n * lifecycle events (turn-start, turn-end) on behalf of the client.\n */\n\nimport * as Ably from 'ably';\n\nimport {\n  EVENT_CANCEL,\n  EVENT_TURN_END,\n  EVENT_TURN_START,\n  HEADER_CANCEL_ALL,\n  HEADER_CANCEL_CLIENT_ID,\n  HEADER_CANCEL_OWN,\n  HEADER_CANCEL_TURN_ID,\n  HEADER_MSG_ID,\n  HEADER_PARENT,\n  HEADER_ROLE,\n  HEADER_TURN_CLIENT_ID,\n  HEADER_TURN_ID,\n  HEADER_TURN_REASON,\n} from '../../constants.js';\nimport { ErrorCode } from '../../errors.js';\nimport { EventEmitter } from '../../event-emitter.js';\nimport type { Logger } from '../../logger.js';\nimport { LogLevel, makeLogger } from '../../logger.js';\nimport { getHeaders } from '../../utils.js';\nimport type { DecoderOutput, MessageAccumulator, StreamDecoder } from '../codec/types.js';\nimport { createConversationTree } from './conversation-tree.js';\nimport { decodeHistory } from './decode-history.js';\nimport { buildTransportHeaders } from './headers.js';\nimport type { StreamRouter } from './stream-router.js';\nimport { createStreamRouter } from './stream-router.js';\nimport type {\n  ActiveTurn,\n  CancelFilter,\n  ClientTransport,\n  ClientTransportOptions,\n  CloseOptions,\n  ConversationTree,\n  LoadHistoryOptions,\n  MessageWithHeaders,\n  PaginatedMessages,\n  SendOptions,\n  TurnEndReason,\n  TurnLifecycleEvent,\n} from './types.js';\n\n/**\n * Returned from `on()` when the transport is already closed — the subscription\n * is silently ignored since no further events will fire.\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-function -- intentional no-op\nconst noopUnsubscribe = (): void => {};\n\n// ---------------------------------------------------------------------------\n// Event map for the transport's typed EventEmitter\n// ---------------------------------------------------------------------------\n\ninterface ClientTransportEventsMap {\n  message: undefined;\n  turn: TurnLifecycleEvent;\n  error: Ably.ErrorInfo;\n  'ably-message': undefined;\n}\n\n// ---------------------------------------------------------------------------\n// Per-turn observer state — consolidated to avoid parallel-map bookkeeping\n// ---------------------------------------------------------------------------\n\ninterface TurnObserverState<TEvent, TMessage> {\n  headers: Record<string, string>;\n  serial: string | undefined;\n  accumulator: MessageAccumulator<TEvent, TMessage>;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CT1\nclass DefaultClientTransport<TEvent, TMessage> implements ClientTransport<TEvent, TMessage> {\n  private readonly _channel: Ably.RealtimeChannel;\n  private readonly _codec: ClientTransportOptions<TEvent, TMessage>['codec'];\n  private readonly _clientId: string | undefined;\n  private readonly _api: string;\n  private readonly _credentials: RequestCredentials | undefined;\n  private readonly _headersFn: (() => Record<string, string>) | undefined;\n  private readonly _bodyFn: (() => Record<string, unknown>) | undefined;\n  private readonly _fetchFn: typeof globalThis.fetch;\n  private readonly _logger: Logger;\n\n  // Typed event emitter for all transport events\n  private readonly _emitter: EventEmitter<ClientTransportEventsMap>;\n\n  // Relay detection — tracks msg-ids of optimistic inserts for reconciliation\n  private readonly _ownMsgIds = new Set<string>();\n  private readonly _ownTurnIds = new Set<string>();\n\n  // Track clientId per turn for getActiveTurnIds()\n  private readonly _turnClientIds = new Map<string, string>();\n  // Track msgIds per turn for cleanup on turn-end\n  private readonly _turnMsgIds = new Map<string, Set<string>>();\n\n  // Per-turn observer state: headers, serial, and accumulator in one map.\n  // A single .delete(turnId) cleans up all three.\n  private readonly _turnObservers = new Map<string, TurnObserverState<TEvent, TMessage>>();\n\n  // Raw Ably message log\n  private readonly _ablyMessages: Ably.InboundMessage[] = [];\n\n  // History pagination: withheld messages hidden from getMessages()\n  private readonly _withheldKeys = new Set<string>();\n\n  // Sub-components\n  private readonly _tree: ConversationTree<TMessage>;\n  private readonly _router: StreamRouter<TEvent>;\n  private readonly _decoder: StreamDecoder<TEvent, TMessage>;\n\n  // Channel subscription — subscribe() returns a Promise that resolves when the channel attaches\n  private readonly _attachPromise: Promise<unknown>;\n  private readonly _onMessage: (msg: Ably.InboundMessage) => void;\n\n  private _closed = false;\n\n  constructor(options: ClientTransportOptions<TEvent, TMessage>) {\n    this._channel = options.channel;\n    this._codec = options.codec;\n    this._clientId = options.clientId;\n    this._api = options.api ?? '/api/chat';\n    this._credentials = options.credentials;\n    this._headersFn =\n      typeof options.headers === 'function'\n        ? options.headers\n        : options.headers\n          ? () => options.headers as Record<string, string>\n          : undefined;\n    this._bodyFn =\n      typeof options.body === 'function'\n        ? options.body\n        : options.body\n          ? () => options.body as Record<string, unknown>\n          : undefined;\n    this._fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);\n    this._logger = (options.logger ?? makeLogger({ logLevel: LogLevel.Silent })).withContext({\n      component: 'ClientTransport',\n    });\n\n    this._emitter = new EventEmitter<ClientTransportEventsMap>(this._logger);\n\n    // Compose sub-components\n    this._tree = createConversationTree<TMessage>(this._codec.getMessageKey.bind(this._codec), this._logger);\n    this._router = createStreamRouter<TEvent>(this._codec.isTerminal.bind(this._codec), this._logger);\n    this._decoder = this._codec.createDecoder();\n\n    // Seed tree with initial messages\n    if (options.messages) {\n      let prevMsgId: string | undefined;\n      for (const msg of options.messages) {\n        const msgId = this._codec.getMessageKey(msg);\n        const seedHeaders: Record<string, string> = {};\n        if (prevMsgId) seedHeaders[HEADER_PARENT] = prevMsgId;\n        this._tree.upsert(msgId, msg, seedHeaders);\n        prevMsgId = msgId;\n      }\n      this._emitter.emit('message');\n    }\n\n    // Spec: AIT-CT2\n    // Subscribe before attach (RTL7g)\n    this._onMessage = (ablyMessage: Ably.InboundMessage) => {\n      this._handleMessage(ablyMessage);\n    };\n    this._attachPromise = this._channel.subscribe(this._onMessage);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Message subscription handler\n  // ---------------------------------------------------------------------------\n\n  private _handleMessage(ablyMessage: Ably.InboundMessage): void {\n    if (this._closed) return;\n\n    this._ablyMessages.push(ablyMessage);\n    this._emitter.emit('ably-message');\n\n    try {\n      // Spec: AIT-CT16a\n      // --- Turn lifecycle events from the server ---\n      if (ablyMessage.name === EVENT_TURN_START) {\n        const headers = getHeaders(ablyMessage);\n        const turnId = headers[HEADER_TURN_ID];\n        const turnCid = headers[HEADER_TURN_CLIENT_ID] ?? '';\n        if (turnId) {\n          this._turnClientIds.set(turnId, turnCid);\n          this._emitter.emit('turn', { type: EVENT_TURN_START, turnId, clientId: turnCid });\n        }\n        return;\n      }\n\n      if (ablyMessage.name === EVENT_TURN_END) {\n        const headers = getHeaders(ablyMessage);\n        const turnId = headers[HEADER_TURN_ID];\n        const turnCid = headers[HEADER_TURN_CLIENT_ID] ?? '';\n        // CAST: server always writes a valid TurnEndReason; default to 'complete' for robustness\n        const reason = (headers[HEADER_TURN_REASON] ?? 'complete') as TurnEndReason;\n        if (turnId) {\n          this._router.closeStream(turnId);\n          this._turnObservers.delete(turnId);\n          this._turnClientIds.delete(turnId);\n          // Clean up per-turn relay-detection state\n          const msgIds = this._turnMsgIds.get(turnId);\n          if (msgIds) {\n            for (const mid of msgIds) this._ownMsgIds.delete(mid);\n            this._turnMsgIds.delete(turnId);\n          }\n          this._ownTurnIds.delete(turnId);\n          this._emitter.emit('turn', { type: EVENT_TURN_END, turnId, clientId: turnCid, reason });\n        }\n        return;\n      }\n\n      // --- Codec-decoded messages ---\n      const outputs = this._decoder.decode(ablyMessage);\n      const headers = getHeaders(ablyMessage);\n      const serial = ablyMessage.serial;\n\n      // Always update observer headers, even when the decoder produces no outputs.\n      // This ensures header transitions (e.g. x-ably-status: streaming → aborted)\n      // are captured for events that the decoder suppresses (AIT-CD8: aborted\n      // stream appends emit no events but still carry the updated status header).\n      const turnId = headers[HEADER_TURN_ID];\n      if (turnId) {\n        this._updateTurnObserverHeaders(turnId, headers, serial);\n      }\n\n      for (const output of outputs) {\n        if (output.kind === 'message') {\n          this._handleMessageOutput(output.message, headers, serial, ablyMessage.action);\n        } else {\n          this._handleEventOutput(output, headers);\n        }\n      }\n    } catch (error) {\n      const cause = error instanceof Ably.ErrorInfo ? error : undefined;\n      this._emitter.emit(\n        'error',\n        new Ably.ErrorInfo(\n          `unable to process channel message; ${error instanceof Error ? error.message : String(error)}`,\n          ErrorCode.TransportSubscriptionError,\n          500,\n          cause,\n        ),\n      );\n    }\n  }\n\n  /**\n   * Handle a decoded domain message (user message create or relayed own message).\n   * @param message - The decoded domain message.\n   * @param headers - Ably headers from the wire message.\n   * @param serial - Ably serial for tree ordering.\n   * @param action - Ably message action (e.g. 'message.create').\n   */\n  private _handleMessageOutput(\n    message: TMessage,\n    headers: Record<string, string>,\n    serial: string | undefined,\n    action: string | undefined,\n  ): void {\n    // Spec: AIT-CT15\n    const msgId = headers[HEADER_MSG_ID];\n    if (msgId && this._ownMsgIds.has(msgId)) {\n      // Relayed own message — reconcile optimistic entry with server-assigned fields\n      this._upsertAndNotify(message, headers, serial);\n      return;\n    }\n\n    if (action === 'message.create') {\n      this._upsertAndNotify(message, headers, serial);\n    }\n  }\n\n  /**\n   * Handle a decoded streaming event: route to own-turn stream or accumulate for observer.\n   * @param output - The decoded event output from the codec.\n   * @param headers - Ably headers from the wire message.\n   */\n  private _handleEventOutput(output: DecoderOutput<TEvent, TMessage>, headers: Record<string, string>): void {\n    if (output.kind !== 'event') return;\n    const event = output.event;\n    const turnId = headers[HEADER_TURN_ID];\n    if (!turnId) return;\n\n    // Observer headers are already updated in _handleMessage (before outputs\n    // are iterated) so that header transitions are captured even when the\n    // decoder produces no outputs (e.g. aborted stream appends per AIT-CD8).\n\n    // Active own turn — route to the ReadableStream\n    if (this._router.route(turnId, event)) {\n      this._accumulateAndEmit(turnId, output);\n      if (this._codec.isTerminal(event)) this._turnObservers.delete(turnId);\n      return;\n    }\n\n    // Completed own turn — late arrival, skip\n    if (this._ownTurnIds.has(turnId) && !this._turnObservers.has(turnId)) return;\n\n    // Spec: AIT-CT16\n    // Observer turn — accumulate and emit\n    this._accumulateAndEmit(turnId, output);\n    if (this._codec.isTerminal(event)) this._turnObservers.delete(turnId);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Tree mutation + notification helpers\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Upsert a message into the tree and notify subscribers.\n   * @param message - The domain message to insert or update.\n   * @param headers - Ably headers for the message.\n   * @param serial - Ably serial for tree ordering.\n   */\n  private _upsertAndNotify(message: TMessage, headers: Record<string, string>, serial?: string): void {\n    const key = this._codec.getMessageKey(message);\n    const msgId = headers[HEADER_MSG_ID] ?? key;\n    this._tree.upsert(msgId, message, headers, serial);\n    this._emitter.emit('message');\n  }\n\n  // ---------------------------------------------------------------------------\n  // Observer accumulation\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Ensure a TurnObserverState exists for turnId, updating headers and serial as new events arrive.\n   * @param turnId - The turn to track.\n   * @param headers - Headers from the current event.\n   * @param serial - Ably serial from the current event.\n   */\n  private _updateTurnObserverHeaders(\n    turnId: string,\n    headers: Record<string, string>,\n    serial: string | undefined,\n  ): void {\n    const existing = this._turnObservers.get(turnId);\n    if (existing) {\n      if (Object.keys(headers).length > 0) {\n        Object.assign(existing.headers, headers);\n      }\n      // Always advance the serial so the tree node sorts after all\n      // earlier messages in the turn (e.g. user-message relays that\n      // arrive before the assistant response).\n      if (serial !== undefined) {\n        existing.serial = serial;\n      }\n    } else {\n      this._turnObservers.set(turnId, {\n        headers: { ...headers },\n        serial,\n        accumulator: this._codec.createAccumulator(),\n      });\n    }\n  }\n\n  /**\n   * Process a streaming event through the turn's accumulator and emit the latest message.\n   * @param turnId - The turn this event belongs to.\n   * @param output - The decoded event output to accumulate.\n   */\n  private _accumulateAndEmit(turnId: string, output: DecoderOutput<TEvent, TMessage>): void {\n    const observer = this._turnObservers.get(turnId);\n    if (!observer) return;\n\n    observer.accumulator.processOutputs([output]);\n\n    const messages = observer.accumulator.messages;\n    if (messages.length === 0) return;\n\n    let message: TMessage | undefined;\n    try {\n      message = structuredClone(messages.at(-1));\n    } catch {\n      // CAST: structuredClone can fail if the message contains non-cloneable\n      // values (e.g. functions). Fall back to the reference — the tree upsert\n      // below copies headers independently, so shared message state is the\n      // only risk. Accumulator messages are replaced on each event, so\n      // mutation between events is not a practical concern.\n      message = messages.at(-1);\n    }\n\n    if (message) {\n      this._tree.upsert(\n        observer.headers[HEADER_MSG_ID] ?? this._codec.getMessageKey(message),\n        message,\n        { ...observer.headers },\n        observer.serial,\n      );\n      this._emitter.emit('message');\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cancel helpers\n  // ---------------------------------------------------------------------------\n\n  private async _publishCancel(filter: CancelFilter): Promise<void> {\n    this._logger.trace('ClientTransport._publishCancel();', { filter });\n\n    const headers: Record<string, string> = {};\n    if (filter.turnId) {\n      headers[HEADER_CANCEL_TURN_ID] = filter.turnId;\n    } else if (filter.own) {\n      headers[HEADER_CANCEL_OWN] = 'true';\n    } else if (filter.clientId) {\n      headers[HEADER_CANCEL_CLIENT_ID] = filter.clientId;\n    } else if (filter.all) {\n      headers[HEADER_CANCEL_ALL] = 'true';\n    }\n\n    await this._channel.publish({\n      name: EVENT_CANCEL,\n      extras: { headers },\n    });\n  }\n\n  private _closeMatchingTurnStreams(filter: CancelFilter): void {\n    // Only close the router streams here — do NOT clear _turnObservers.\n    // The observer must remain alive so that late server events (e.g. abort,\n    // x-ably-status: aborted) arriving before turn-end are still accumulated\n    // into the message store. The turn-end handler cleans up observers.\n    if (filter.all) {\n      for (const turnId of this._ownTurnIds) {\n        this._router.closeStream(turnId);\n      }\n    } else if (filter.own) {\n      for (const tid of this._ownTurnIds) {\n        this._router.closeStream(tid);\n      }\n    } else if (filter.clientId) {\n      for (const [tid, cid] of this._turnClientIds) {\n        if (cid === filter.clientId) {\n          this._router.closeStream(tid);\n        }\n      }\n    } else if (filter.turnId) {\n      this._router.closeStream(filter.turnId);\n    }\n  }\n\n  private _getMatchingTurnIds(filter: CancelFilter): Set<string> {\n    const matched = new Set<string>();\n    if (filter.all) {\n      for (const turnId of this._turnClientIds.keys()) matched.add(turnId);\n    } else if (filter.own) {\n      for (const [turnId, cid] of this._turnClientIds) {\n        if (cid === this._clientId) matched.add(turnId);\n      }\n    } else if (filter.clientId) {\n      for (const [turnId, cid] of this._turnClientIds) {\n        if (cid === filter.clientId) matched.add(turnId);\n      }\n    } else if (filter.turnId && this._turnClientIds.has(filter.turnId)) {\n      matched.add(filter.turnId);\n    }\n    return matched;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Input message helpers\n  // ---------------------------------------------------------------------------\n\n  private _getMessagesWithHeaders(): MessageWithHeaders<TMessage>[] {\n    return this._tree.flatten().map((m) => ({\n      message: m,\n      headers: this.getMessageHeaders(m),\n    }));\n  }\n\n  /**\n   * Compute truncated history: everything before the target message.\n   * Used by regenerate so the LLM doesn't see the response being replaced.\n   * @param messageId - The msg-id to truncate history before.\n   * @returns Input messages preceding the target.\n   */\n  private _getHistoryBefore(messageId: string): MessageWithHeaders<TMessage>[] {\n    const all = this._getMessagesWithHeaders();\n    const idx = all.findIndex((inp) => inp.headers?.[HEADER_MSG_ID] === messageId);\n    return idx === -1 ? all : all.slice(0, idx);\n  }\n\n  // ---------------------------------------------------------------------------\n  // History pagination helpers\n  // ---------------------------------------------------------------------------\n\n  private _processHistoryPage(page: PaginatedMessages<TMessage>): void {\n    for (const [i, message] of page.items.entries()) {\n      const headers = page.itemHeaders?.[i] ?? {};\n      const serial = page.itemSerials?.[i];\n      const key = this._codec.getMessageKey(message);\n      const msgId = headers[HEADER_MSG_ID] ?? key;\n      this._tree.upsert(msgId, message, headers, serial);\n    }\n    this._emitter.emit('message');\n\n    // Prepend raw Ably messages (older messages go at the beginning)\n    if (page.rawMessages && page.rawMessages.length > 0) {\n      this._ablyMessages.unshift(...page.rawMessages);\n      this._emitter.emit('ably-message');\n    }\n  }\n\n  private async _loadUntilVisible(\n    firstPage: PaginatedMessages<TMessage>,\n    target: number,\n    beforeKeys: Set<string>,\n  ): Promise<{ newVisible: TMessage[]; lastPage: PaginatedMessages<TMessage> }> {\n    this._processHistoryPage(firstPage);\n    let page = firstPage;\n\n    const newVisibleCount = (): number => {\n      let count = 0;\n      for (const m of this._tree.flatten()) {\n        if (!beforeKeys.has(this._codec.getMessageKey(m))) count++;\n      }\n      return count;\n    };\n\n    while (newVisibleCount() < target && page.hasNext()) {\n      const nextPage = await page.next();\n      if (!nextPage) break;\n      this._processHistoryPage(nextPage);\n      page = nextPage;\n    }\n\n    const newVisible = this._tree.flatten().filter((m) => !beforeKeys.has(this._codec.getMessageKey(m)));\n    return { newVisible, lastPage: page };\n  }\n\n  private _releaseWithheld(messages: TMessage[]): void {\n    for (const m of messages) {\n      this._withheldKeys.delete(this._codec.getMessageKey(m));\n    }\n    if (messages.length > 0) {\n      this._emitter.emit('message');\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Public API\n  // ---------------------------------------------------------------------------\n\n  // Spec: AIT-CT3, AIT-CT4\n  async send(input: TMessage | TMessage[], sendOptions?: SendOptions): Promise<ActiveTurn<TEvent>> {\n    if (this._closed) {\n      throw new Ably.ErrorInfo('unable to send; transport is closed', ErrorCode.TransportClosed, 400);\n    }\n    await this._attachPromise;\n    // CAST: re-check after await — close() may have been called while waiting for attach.\n    // TypeScript's control flow narrows _closed to false after the first check, but the\n    // await yields and close() can mutate _closed concurrently.\n    if (this._closed as boolean) {\n      throw new Ably.ErrorInfo('unable to send; transport is closed', ErrorCode.TransportClosed, 400);\n    }\n\n    this._logger.trace('ClientTransport.send();');\n\n    const msgs = Array.isArray(input) ? input : [input];\n    const turnId = crypto.randomUUID();\n    this._ownTurnIds.add(turnId);\n\n    const msgIds = new Set<string>();\n    const postMessages: { message: TMessage; headers: Record<string, string> }[] = [];\n\n    // Capture history BEFORE optimistic inserts. The optimistic messages are\n    // sent in the `messages` field — including them in `history` too would\n    // cause the server to see them twice.\n    const preInsertHistory = this._getMessagesWithHeaders();\n\n    // Spec: AIT-CT3d\n    // Auto-compute parent from the current thread if not explicitly provided\n    let autoParent: string | undefined;\n    if (sendOptions?.parent === undefined && !sendOptions?.forkOf) {\n      const flat = this._tree.flatten();\n      if (flat.length > 0) {\n        const lastMsg = flat.at(-1);\n        if (lastMsg) {\n          const lastKey = this._codec.getMessageKey(lastMsg);\n          const lastNode = this._tree.getNodeByKey(lastKey);\n          autoParent = lastNode?.msgId ?? lastKey;\n        }\n      }\n    }\n\n    // Capture the first parent for the POST body before the loop advances it.\n    const postParent = sendOptions?.parent === undefined ? autoParent : sendOptions.parent;\n\n    for (const message of msgs) {\n      const msgId = crypto.randomUUID();\n      this._ownMsgIds.add(msgId);\n      msgIds.add(msgId);\n\n      const resolvedParent = sendOptions?.parent === undefined ? autoParent : (sendOptions.parent ?? undefined);\n\n      const optimisticHeaders = buildTransportHeaders({\n        role: 'user',\n        turnId,\n        msgId,\n        turnClientId: this._clientId,\n        parent: resolvedParent,\n        forkOf: sendOptions?.forkOf,\n      });\n      // Spec: AIT-CT3c\n      // Optimistically insert each user message into the tree\n      this._upsertAndNotify(message, optimisticHeaders);\n\n      // Include per-message parent so the server chains messages correctly.\n      const postHeaders: Record<string, string> = { [HEADER_MSG_ID]: msgId, [HEADER_ROLE]: 'user' };\n      if (resolvedParent) postHeaders[HEADER_PARENT] = resolvedParent;\n      postMessages.push({ message, headers: postHeaders });\n\n      // Spec: AIT-CT3e\n      // Chain: each subsequent message in the batch parents off the previous\n      // one, forming a linear conversation thread rather than siblings.\n      if (sendOptions?.parent === undefined && !sendOptions?.forkOf) {\n        autoParent = msgId;\n      }\n    }\n\n    this._turnMsgIds.set(turnId, msgIds);\n\n    // Create ReadableStream via router\n    const stream = this._router.createStream(turnId);\n\n    // Resolve headers and body\n    const resolvedHeaders = this._headersFn?.() ?? {};\n    const resolvedBody = this._bodyFn?.() ?? {};\n\n    const postBody: Record<string, unknown> = {\n      ...resolvedBody,\n      history: preInsertHistory,\n      ...sendOptions?.body,\n      turnId,\n      clientId: this._clientId,\n      messages: postMessages,\n      ...(sendOptions?.forkOf !== undefined && { forkOf: sendOptions.forkOf }),\n      ...(postParent !== undefined && { parent: postParent }),\n    };\n\n    const postHeaders: Record<string, string> = {\n      ...resolvedHeaders,\n      ...sendOptions?.headers,\n    };\n\n    // Spec: AIT-CT3a, AIT-CT3b\n    // Fire-and-forget: POST must not block the stream return to the caller.\n    // .catch() is intentional — async/await would delay stream availability.\n    this._fetchFn(this._api, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        ...postHeaders,\n      },\n      body: JSON.stringify(postBody),\n      ...(this._credentials ? { credentials: this._credentials } : {}),\n    })\n      .then((response) => {\n        if (!response.ok) {\n          this._emitter.emit(\n            'error',\n            new Ably.ErrorInfo(\n              `unable to send; HTTP POST to ${this._api} returned ${String(response.status)} ${response.statusText}`,\n              ErrorCode.TransportSendFailed,\n              response.status,\n            ),\n          );\n          this._router.closeStream(turnId);\n        }\n      })\n      .catch((error: unknown) => {\n        const cause = error instanceof Ably.ErrorInfo ? error : undefined;\n        this._emitter.emit(\n          'error',\n          new Ably.ErrorInfo(\n            `unable to send; HTTP POST to ${this._api} failed: ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.TransportSendFailed,\n            500,\n            cause,\n          ),\n        );\n        this._router.closeStream(turnId);\n      });\n\n    return {\n      stream,\n      turnId,\n      cancel: async () => this.cancel({ turnId }),\n    };\n  }\n\n  // Spec: AIT-CT5\n  async regenerate(messageId: string, sendOptions?: SendOptions): Promise<ActiveTurn<TEvent>> {\n    this._logger.trace('ClientTransport.regenerate();', { messageId });\n\n    const node = this._tree.getNode(messageId);\n    const parentId = node?.parentId;\n\n    return this.send([], {\n      ...sendOptions,\n      body: {\n        history: this._getHistoryBefore(messageId),\n        ...sendOptions?.body,\n      },\n      forkOf: messageId,\n      parent: parentId,\n    });\n  }\n\n  // Spec: AIT-CT6\n  async edit(\n    messageId: string,\n    newMessages: TMessage | TMessage[],\n    sendOptions?: SendOptions,\n  ): Promise<ActiveTurn<TEvent>> {\n    this._logger.trace('ClientTransport.edit();', { messageId });\n\n    const node = this._tree.getNode(messageId);\n    const parentId = node?.parentId;\n\n    return this.send(newMessages, {\n      ...sendOptions,\n      body: {\n        history: this._getHistoryBefore(messageId),\n        ...sendOptions?.body,\n      },\n      forkOf: messageId,\n      parent: parentId,\n    });\n  }\n\n  // Spec: AIT-CT7, AIT-CT7a\n  async cancel(filter?: CancelFilter): Promise<void> {\n    if (this._closed) return;\n    const resolved = filter ?? { own: true };\n    this._logger.debug('ClientTransport.cancel();', { filter: resolved });\n    await this._publishCancel(resolved);\n    this._closeMatchingTurnStreams(resolved);\n  }\n\n  // Spec: AIT-CT18\n  async waitForTurn(filter?: CancelFilter): Promise<void> {\n    if (this._closed) return;\n    const resolved = filter ?? { own: true };\n    const remaining = this._getMatchingTurnIds(resolved);\n    if (remaining.size === 0) return;\n\n    this._logger.debug('ClientTransport.waitForTurn();', { turnIds: [...remaining] });\n\n    return new Promise<void>((resolve) => {\n      const handler = (event: TurnLifecycleEvent): void => {\n        if (event.type !== EVENT_TURN_END) return;\n        remaining.delete(event.turnId);\n        if (remaining.size === 0) {\n          this._emitter.off('turn', handler);\n          resolve();\n        }\n      };\n      this._emitter.on('turn', handler);\n    });\n  }\n\n  // Spec: AIT-CT8, AIT-CT8a, AIT-CT8b, AIT-CT8c, AIT-CT8d\n  on(event: 'message' | 'ably-message', handler: () => void): () => void;\n  on(event: 'turn', handler: (event: TurnLifecycleEvent) => void): () => void;\n  on(event: 'error', handler: (error: Ably.ErrorInfo) => void): () => void;\n  on(\n    eventName: 'message' | 'turn' | 'error' | 'ably-message',\n    handler: (() => void) | ((event: TurnLifecycleEvent) => void) | ((error: Ably.ErrorInfo) => void),\n  ): () => void {\n    if (this._closed) return noopUnsubscribe;\n    // CAST: the overload signatures enforce correct handler types per event name.\n    // The implementation must cast to satisfy the EventEmitter's generic callback type.\n    const cb = handler as (arg: ClientTransportEventsMap[keyof ClientTransportEventsMap]) => void;\n    this._emitter.on(eventName, cb);\n    return () => {\n      this._emitter.off(eventName, cb);\n    };\n  }\n\n  // Spec: AIT-CT10\n  getTree(): ConversationTree<TMessage> {\n    return this._tree;\n  }\n\n  // Spec: AIT-CT17\n  getActiveTurnIds(): Map<string, Set<string>> {\n    const result = new Map<string, Set<string>>();\n    for (const [turnId, cid] of this._turnClientIds) {\n      let set = result.get(cid);\n      if (!set) {\n        set = new Set();\n        result.set(cid, set);\n      }\n      set.add(turnId);\n    }\n    return result;\n  }\n\n  getMessageHeaders(message: TMessage): Record<string, string> | undefined {\n    const key = this._codec.getMessageKey(message);\n    return this._tree.getNodeByKey(key)?.headers;\n  }\n\n  // Spec: AIT-CT9\n  getMessages(): TMessage[] {\n    if (this._withheldKeys.size === 0) return this._tree.flatten();\n    return this._tree.flatten().filter((m) => !this._withheldKeys.has(this._codec.getMessageKey(m)));\n  }\n\n  getMessagesWithHeaders(): MessageWithHeaders<TMessage>[] {\n    return this._getMessagesWithHeaders();\n  }\n\n  getAblyMessages(): Ably.InboundMessage[] {\n    return [...this._ablyMessages];\n  }\n\n  // Spec: AIT-CT11, AIT-CT11a, AIT-CT11b, AIT-CT11c\n  async history(opts?: LoadHistoryOptions): Promise<PaginatedMessages<TMessage>> {\n    if (this._closed) {\n      throw new Ably.ErrorInfo('unable to load history; transport is closed', ErrorCode.TransportClosed, 400);\n    }\n    this._logger.trace('ClientTransport.history();', { limit: opts?.limit });\n    const limit = opts?.limit ?? 100;\n\n    // Snapshot before loading — everything already in the tree stays visible\n    const beforeKeys = new Set(this._tree.flatten().map((m) => this._codec.getMessageKey(m)));\n\n    let lastPage = await decodeHistory(this._channel, this._codec, opts, this._logger);\n\n    const initial = await this._loadUntilVisible(lastPage, limit, beforeKeys);\n    lastPage = initial.lastPage;\n\n    // newVisible is chronological (oldest-first from flatten).\n    // For \"load older\" pagination: release the NEWEST `limit` now,\n    // withhold the older ones for subsequent next() calls.\n    const newVisible = initial.newVisible;\n\n    // Withhold ALL new visible messages first, then release the newest batch\n    for (const m of newVisible) {\n      this._withheldKeys.add(this._codec.getMessageKey(m));\n    }\n\n    const released = newVisible.slice(-limit);\n    // Mutable buffer of older messages, drained newest-first by successive next() calls\n    const withheldBuffer = newVisible.slice(0, -limit);\n    this._releaseWithheld(released);\n\n    const buildPage = (items: TMessage[]): PaginatedMessages<TMessage> => ({\n      items,\n      hasNext: () => withheldBuffer.length > 0 || lastPage.hasNext(),\n      next: async () => {\n        // Drain withheld buffer first (older messages, released newest-first)\n        if (withheldBuffer.length > 0) {\n          // Remove and return the newest `limit` items from the buffer\n          const batch = withheldBuffer.splice(-limit, limit);\n          this._releaseWithheld(batch);\n          return buildPage(batch);\n        }\n\n        // Buffer exhausted — load more pages from decodeHistory\n        if (!lastPage.hasNext()) return;\n\n        const nextInternal = await lastPage.next();\n        if (!nextInternal) return;\n\n        // Everything currently in the tree is \"already known\"\n        const alreadyKnown = new Set(beforeKeys);\n        for (const m of this._tree.flatten()) {\n          alreadyKnown.add(this._codec.getMessageKey(m));\n        }\n\n        const loaded = await this._loadUntilVisible(nextInternal, limit, alreadyKnown);\n        lastPage = loaded.lastPage;\n\n        const moreVisible = loaded.newVisible;\n        for (const m of moreVisible) {\n          this._withheldKeys.add(this._codec.getMessageKey(m));\n        }\n        // Remove and return the newest `limit` items; rest stays in buffer\n        const moreBatch = moreVisible.splice(-limit, limit);\n        withheldBuffer.push(...moreVisible);\n        this._releaseWithheld(moreBatch);\n\n        if (moreBatch.length === 0) return;\n        return buildPage(moreBatch);\n      },\n    });\n\n    return buildPage(released);\n  }\n\n  // Spec: AIT-CT12, AIT-CT12a, AIT-CT12b\n  async close(options?: CloseOptions): Promise<void> {\n    if (this._closed) return;\n    this._closed = true;\n    this._logger.info('ClientTransport.close();');\n\n    // Best-effort cancel publish before tearing down local state\n    if (options?.cancel) {\n      try {\n        await this._publishCancel(options.cancel);\n      } catch {\n        // Swallow: cancel is best-effort during teardown\n      }\n      this._closeMatchingTurnStreams(options.cancel);\n    }\n\n    this._channel.unsubscribe(this._onMessage);\n\n    // Close any remaining active streams\n    for (const turnId of this._ownTurnIds) {\n      this._router.closeStream(turnId);\n    }\n\n    this._turnObservers.clear();\n    this._emitter.off();\n    this._ownTurnIds.clear();\n    this._ownMsgIds.clear();\n    this._turnMsgIds.clear();\n    this._turnClientIds.clear();\n    this._withheldKeys.clear();\n    this._ablyMessages.length = 0;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a client-side transport that manages conversation state over an Ably channel.\n *\n * Subscribes to the channel immediately (before attach per RTL7g). The caller should\n * ensure the channel is attached or will be attached shortly after creation.\n * @param options - Configuration for the client transport.\n * @returns A new {@link ClientTransport} instance.\n */\nexport const createClientTransport = <TEvent, TMessage>(\n  options: ClientTransportOptions<TEvent, TMessage>,\n): ClientTransport<TEvent, TMessage> => new DefaultClientTransport(options);\n","/**\n * Decoder core — action dispatch and serial tracking machinery.\n *\n * Handles the Ably message action patterns (create, append, update, delete)\n * and delegates to domain-specific hooks for event building and discrete\n * event decoding.\n *\n * Domain decoders call `createDecoderCore(hooks, options)` and provide hooks\n * for stream classification, event building, and discrete decoding.\n */\n\nimport type * as Ably from 'ably';\n\nimport { HEADER_MSG_ID, HEADER_STATUS, HEADER_STREAM, HEADER_STREAM_ID } from '../../constants.js';\nimport type { Logger } from '../../logger.js';\nimport { getHeaders } from '../../utils.js';\nimport type { DecoderOutput, MessagePayload, StreamTrackerState } from './types.js';\n\n/**\n * Wrap a domain event as a single-element decoder output array.\n * @param event - The domain event to wrap.\n * @returns A single-element array containing the event as a decoder output.\n */\nexport const eventOutput = <TEvent, TMessage>(event: TEvent): DecoderOutput<TEvent, TMessage>[] => [\n  { kind: 'event', event },\n];\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/** Options for creating a decoder core. */\nexport interface DecoderCoreOptions {\n  /** Called when a tracked stream is replaced (non-prefix update). Receives the tracker with updated state. */\n  onStreamUpdate?: (tracker: StreamTrackerState) => void;\n  /** Called when a message is deleted. Receives the serial and tracker (if one exists). */\n  onStreamDelete?: (serial: string, tracker: StreamTrackerState | undefined) => void;\n  /** Logger instance for diagnostic output. */\n  logger?: Logger;\n}\n\n// ---------------------------------------------------------------------------\n// Domain hooks\n// ---------------------------------------------------------------------------\n\n/** Hooks that a domain codec provides to the decoder core for stream classification and event building. */\nexport interface DecoderCoreHooks<TEvent, TMessage> {\n  /**\n   * Build domain events emitted when a new stream starts. May return multiple\n   * events (e.g. a start event and a start-step event).\n   */\n  buildStartEvents(tracker: StreamTrackerState): DecoderOutput<TEvent, TMessage>[];\n\n  /** Build domain events for a text delta received on a stream. */\n  buildDeltaEvents(tracker: StreamTrackerState, delta: string): DecoderOutput<TEvent, TMessage>[];\n\n  /**\n   * Build domain events emitted when a stream finishes (x-ably-status:finished).\n   * Not called for aborted streams. The closing headers may differ from\n   * tracker.headers if the closing append carried updated headers.\n   */\n  buildEndEvents(\n    tracker: StreamTrackerState,\n    closingHeaders: Record<string, string>,\n  ): DecoderOutput<TEvent, TMessage>[];\n\n  /**\n   * Decode a discrete message (message.create where x-ably-stream is \"false\",\n   * or a non-streamable first-contact update). Handles user messages, lifecycle\n   * events, tool lifecycle, data-*, etc.\n   */\n  decodeDiscrete(input: MessagePayload): DecoderOutput<TEvent, TMessage>[];\n}\n\n// ---------------------------------------------------------------------------\n// Interface\n// ---------------------------------------------------------------------------\n\n/** The decoder core returned by {@link createDecoderCore}. */\nexport interface DecoderCore<TEvent, TMessage> {\n  /** Decode a single Ably message into zero or more domain outputs. */\n  decode(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[];\n}\n\n// ---------------------------------------------------------------------------\n// Default implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CD7\nclass DefaultDecoderCore<TEvent, TMessage> implements DecoderCore<TEvent, TMessage> {\n  private readonly _hooks: DecoderCoreHooks<TEvent, TMessage>;\n  private readonly _logger: Logger | undefined;\n  private readonly _onStreamUpdate: ((tracker: StreamTrackerState) => void) | undefined;\n  private readonly _onStreamDelete: ((serial: string, tracker: StreamTrackerState | undefined) => void) | undefined;\n  private readonly _serialState = new Map<string, StreamTrackerState>();\n\n  constructor(hooks: DecoderCoreHooks<TEvent, TMessage>, options: DecoderCoreOptions = {}) {\n    this._hooks = hooks;\n    this._onStreamUpdate = options.onStreamUpdate;\n    this._onStreamDelete = options.onStreamDelete;\n    this._logger = options.logger?.withContext({ component: 'DecoderCore' });\n  }\n\n  decode(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[] {\n    const action = message.action;\n\n    this._logger?.trace('DefaultDecoderCore.decode();', { action, serial: message.serial, name: message.name });\n\n    let outputs: DecoderOutput<TEvent, TMessage>[];\n\n    switch (action) {\n      // Spec: AIT-CD7a\n      case 'message.create': {\n        const payload = this._toPayload(message);\n\n        outputs =\n          payload.headers?.[HEADER_STREAM] === 'true'\n            ? this._decodeStreamedCreate(payload, message.serial)\n            : this._hooks.decodeDiscrete(payload);\n        break;\n      }\n\n      case 'message.append': {\n        outputs = this._decodeAppend(message);\n        break;\n      }\n\n      case 'message.update': {\n        outputs = this._decodeUpdate(message);\n        break;\n      }\n\n      case 'message.delete': {\n        outputs = this._decodeDelete(message);\n        break;\n      }\n\n      default: {\n        return [];\n      }\n    }\n\n    // Tag all event outputs with the message ID from x-ably-msg-id for accumulator correlation.\n    const messageId = getHeaders(message)[HEADER_MSG_ID];\n    if (messageId) {\n      for (const output of outputs) {\n        if (output.kind === 'event') {\n          output.messageId = messageId;\n        }\n      }\n    }\n\n    return outputs;\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: extract MessagePayload\n  // -------------------------------------------------------------------------\n\n  private _toPayload(message: Ably.InboundMessage): MessagePayload {\n    return {\n      name: message.name ?? '',\n      // CAST: Ably SDK types `data` as `any`; cast to unknown is the safe boundary type.\n      data: message.data as unknown,\n      headers: getHeaders(message),\n    };\n  }\n\n  /**\n   * Extract string data from an Ably message, for stream accumulation paths.\n   * @param message - The Ably message to extract string data from.\n   * @returns The string data, or empty string if data is not a string.\n   */\n  private _stringData(message: Ably.InboundMessage): string {\n    return typeof message.data === 'string' ? message.data : '';\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: safe callback invocation\n  // -------------------------------------------------------------------------\n\n  private _invokeOnStreamUpdate(tracker: StreamTrackerState): void {\n    if (!this._onStreamUpdate) return;\n    try {\n      this._onStreamUpdate(tracker);\n    } catch (error) {\n      this._logger?.error('DefaultDecoderCore._invokeOnStreamUpdate(); callback threw', { error });\n    }\n  }\n\n  private _invokeOnStreamDelete(serial: string, tracker: StreamTrackerState | undefined): void {\n    if (!this._onStreamDelete) return;\n    try {\n      this._onStreamDelete(serial, tracker);\n    } catch (error) {\n      this._logger?.error('DefaultDecoderCore._invokeOnStreamDelete(); callback threw', { error });\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: streamed message create\n  // -------------------------------------------------------------------------\n\n  private _decodeStreamedCreate(\n    payload: MessagePayload,\n    serial: string | undefined,\n  ): DecoderOutput<TEvent, TMessage>[] {\n    if (!serial) return [];\n\n    const streamId = payload.headers?.[HEADER_STREAM_ID] ?? '';\n    const h = payload.headers ?? {};\n\n    const tracker: StreamTrackerState = {\n      name: payload.name,\n      streamId,\n      accumulated: '',\n      headers: { ...h },\n      closed: false,\n    };\n    this._serialState.set(serial, tracker);\n\n    this._logger?.debug('DefaultDecoderCore._decodeStreamedCreate(); new stream', {\n      name: payload.name,\n      streamId,\n      serial,\n    });\n\n    return this._hooks.buildStartEvents(tracker);\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: append handling\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CD8\n  private _decodeAppend(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[] {\n    const serial = message.serial;\n    if (!serial) return [];\n\n    const tracker = this._serialState.get(serial);\n    if (!tracker) {\n      // Unknown serial on append — treat as first-contact update\n      return this._decodeUpdate(message);\n    }\n\n    const h = getHeaders(message);\n    const delta = typeof message.data === 'string' ? message.data : '';\n    const status = h[HEADER_STATUS];\n    const outputs: DecoderOutput<TEvent, TMessage>[] = [];\n\n    if (delta.length > 0) {\n      tracker.accumulated += delta;\n      outputs.push(...this._hooks.buildDeltaEvents(tracker, delta));\n    }\n\n    if (status === 'finished' && !tracker.closed) {\n      tracker.closed = true;\n      outputs.push(...this._hooks.buildEndEvents(tracker, h));\n      this._logger?.debug('DefaultDecoderCore._decodeAppend(); stream finished', { streamId: tracker.streamId });\n    } else if (status === 'aborted' && !tracker.closed) {\n      tracker.closed = true;\n      this._logger?.debug('DefaultDecoderCore._decodeAppend(); stream aborted', { streamId: tracker.streamId });\n    }\n\n    return outputs;\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: update handling (first-contact, prefix-match, replacement)\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CD9\n  private _decodeUpdate(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[] {\n    const serial = message.serial;\n    if (!serial) return [];\n\n    const payload = this._toPayload(message);\n    const h = payload.headers ?? {};\n    const isStreamed = h[HEADER_STREAM] === 'true';\n    const status = h[HEADER_STATUS];\n\n    const tracker = this._serialState.get(serial);\n\n    if (!tracker) {\n      return this._decodeFirstContact(payload, isStreamed, status, serial);\n    }\n\n    // Updates to tracked streams use string data for prefix-match accumulation\n    const data = this._stringData(message);\n\n    // --- Tracker exists: prefix-match or replacement ---\n    if (data.startsWith(tracker.accumulated)) {\n      const delta = data.slice(tracker.accumulated.length);\n      const outputs: DecoderOutput<TEvent, TMessage>[] = [];\n\n      if (delta.length > 0) {\n        tracker.accumulated = data;\n        outputs.push(...this._hooks.buildDeltaEvents(tracker, delta));\n      }\n\n      if (status === 'finished' && !tracker.closed) {\n        tracker.closed = true;\n        outputs.push(...this._hooks.buildEndEvents(tracker, h));\n      } else if (status === 'aborted' && !tracker.closed) {\n        tracker.closed = true;\n      }\n\n      return outputs;\n    }\n\n    // --- Replacement (NOT a prefix match) ---\n    tracker.accumulated = data;\n    tracker.headers = { ...h };\n\n    this._invokeOnStreamUpdate(tracker);\n\n    return [];\n  }\n\n  private _decodeFirstContact(\n    payload: MessagePayload,\n    isStreamed: boolean,\n    status: string | undefined,\n    serial: string,\n  ): DecoderOutput<TEvent, TMessage>[] {\n    // Non-streamed messages are discrete\n    if (!isStreamed) {\n      return this._hooks.decodeDiscrete(payload);\n    }\n\n    const streamId = payload.headers?.[HEADER_STREAM_ID] ?? '';\n    const h = payload.headers ?? {};\n    const data = typeof payload.data === 'string' ? payload.data : '';\n\n    this._logger?.debug('DefaultDecoderCore._decodeFirstContact(); first-contact stream', {\n      name: payload.name,\n      streamId,\n      serial,\n    });\n\n    // Create tracker\n    const newTracker: StreamTrackerState = {\n      name: payload.name,\n      streamId,\n      accumulated: data,\n      headers: { ...h },\n      closed: status === 'finished' || status === 'aborted',\n    };\n    this._serialState.set(serial, newTracker);\n\n    // Emit start + delta (if any) + end (if finished)\n    const outputs = this._hooks.buildStartEvents(newTracker);\n\n    if (data.length > 0) {\n      outputs.push(...this._hooks.buildDeltaEvents(newTracker, data));\n    }\n\n    if (status === 'finished') {\n      outputs.push(...this._hooks.buildEndEvents(newTracker, h));\n    }\n\n    return outputs;\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: delete handling\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CD10\n  private _decodeDelete(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[] {\n    const serial = message.serial;\n    if (!serial) return [];\n\n    const tracker = this._serialState.get(serial);\n\n    this._invokeOnStreamDelete(serial, tracker);\n\n    if (tracker) {\n      tracker.accumulated = '';\n      tracker.closed = true;\n    }\n\n    this._logger?.debug('DefaultDecoderCore._decodeDelete();', { serial });\n\n    return [];\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a decoder core with the given domain hooks.\n * @param hooks - Domain-specific hooks for stream classification, event building, and discrete decoding.\n * @param options - Decoder configuration (callbacks, logger).\n * @returns A new {@link DecoderCore} instance.\n */\nexport const createDecoderCore = <TEvent, TMessage>(\n  hooks: DecoderCoreHooks<TEvent, TMessage>,\n  options: DecoderCoreOptions = {},\n): DecoderCore<TEvent, TMessage> => new DefaultDecoderCore(hooks, options);\n","/**\n * Encoder core — message append lifecycle machinery.\n *\n * Provides Ably primitives (publish, append, close, abort, flush) that\n * domain-specific encoders wire their event types to.\n *\n * Domain encoders call `createEncoderCore(writer, options)` and use the\n * returned core to map domain events to Ably operations without\n * reimplementing the message append lifecycle.\n */\n\nimport * as Ably from 'ably';\n\nimport { HEADER_MSG_ID, HEADER_STATUS, HEADER_STREAM, HEADER_STREAM_ID } from '../../constants.js';\nimport { ErrorCode } from '../../errors.js';\nimport type { Logger } from '../../logger.js';\nimport { mergeHeaders } from '../../utils.js';\nimport type { ChannelWriter, EncoderOptions, Extras, MessagePayload, StreamPayload, WriteOptions } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/** Options for creating an encoder core. Extends {@link EncoderOptions} with a logger. */\nexport interface EncoderCoreOptions extends EncoderOptions {\n  /** Logger instance for diagnostic output. */\n  logger?: Logger;\n}\n\n// ---------------------------------------------------------------------------\n// Stream tracker (internal)\n// ---------------------------------------------------------------------------\n\ninterface StreamState {\n  serial: string;\n  name: string;\n  streamId: string;\n  accumulated: string;\n  persistentHeaders: Record<string, string>;\n  aborted: boolean;\n}\n\ninterface PendingAppend {\n  promise: Promise<Ably.UpdateDeleteResult>;\n  streamId: string;\n}\n\n// ---------------------------------------------------------------------------\n// Encoder core interface\n// ---------------------------------------------------------------------------\n\n/** The core encoder primitives that domain codec encoders delegate to. */\nexport interface EncoderCore {\n  /** Publish a single discrete (non-streaming) message described by a payload. */\n  publishDiscrete(payload: MessagePayload, opts?: WriteOptions): Promise<Ably.PublishResult>;\n\n  /** Publish multiple discrete messages atomically in a single channel publish. */\n  publishDiscreteBatch(payloads: MessagePayload[], opts?: WriteOptions): Promise<Ably.PublishResult>;\n\n  /** Start a streamed message with x-ably-status:streaming. */\n  startStream(streamId: string, payload: StreamPayload, opts?: WriteOptions): Promise<void>;\n\n  /**\n   * Append data to an in-flight streamed message. Fire-and-forget: errors are\n   * collected internally and surfaced by {@link closeStream} or {@link close}.\n   */\n  appendStream(streamId: string, data: string): void;\n\n  /**\n   * Close a streamed message with x-ably-status:finished. Flushes all pending\n   * appends for recovery before returning. Repeats persistent and payload headers.\n   */\n  closeStream(streamId: string, payload: StreamPayload): Promise<void>;\n\n  /**\n   * Abort a single in-progress stream (x-ably-status:aborted) and flush all\n   * pending appends for recovery before returning.\n   */\n  abortStream(streamId: string, opts?: WriteOptions): Promise<void>;\n\n  /**\n   * Abort all in-progress streams (x-ably-status:aborted) and flush all\n   * pending appends for recovery before returning.\n   */\n  abortAllStreams(opts?: WriteOptions): Promise<void>;\n\n  /** Flush + clear trackers. Idempotent. */\n  close(): Promise<void>;\n}\n\n// ---------------------------------------------------------------------------\n// Default implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CD1\nclass DefaultEncoderCore implements EncoderCore {\n  private readonly _writer: ChannelWriter;\n  private readonly _defaultClientId: string | undefined;\n  private readonly _defaultExtras: Extras | undefined;\n  private readonly _onMessageHook: (message: Ably.Message) => void;\n  private readonly _logger: Logger | undefined;\n  private readonly _trackers = new Map<string, StreamState>();\n  private _pending: PendingAppend[] = [];\n  private _flushPromise: Promise<void> | undefined;\n  private _closed = false;\n\n  constructor(writer: ChannelWriter, options: EncoderCoreOptions = {}) {\n    this._writer = writer;\n    this._defaultClientId = options.clientId;\n    this._defaultExtras = options.extras;\n    this._onMessageHook =\n      options.onMessage ??\n      (() => {\n        /* noop */\n      });\n    this._logger = options.logger?.withContext({ component: 'EncoderCore' });\n  }\n\n  // Spec: AIT-CD11\n  async publishDiscrete(payload: MessagePayload, opts?: WriteOptions): Promise<Ably.PublishResult> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.publishDiscrete();', { name: payload.name });\n    const msg = this._buildDiscreteMessage(payload, opts);\n    return this._writer.publish(msg);\n  }\n\n  // Spec: AIT-CD11a\n  async publishDiscreteBatch(payloads: MessagePayload[], opts?: WriteOptions): Promise<Ably.PublishResult> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.publishDiscreteBatch();', { count: payloads.length });\n    const msgs = payloads.map((p) => this._buildDiscreteMessage(p, opts));\n    return this._writer.publish(msgs);\n  }\n\n  // Spec: AIT-CD2\n  async startStream(streamId: string, payload: StreamPayload, opts?: WriteOptions): Promise<void> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.startStream();', { name: payload.name, streamId });\n\n    const allHeaders = this._buildHeaders(payload.headers ?? {}, opts);\n    allHeaders[HEADER_STREAM] = 'true';\n    allHeaders[HEADER_STATUS] = 'streaming';\n    allHeaders[HEADER_STREAM_ID] = streamId;\n\n    const clientId = this._resolveClientId(opts);\n    const msg: Ably.Message = {\n      name: payload.name,\n      data: payload.data,\n      extras: { headers: allHeaders },\n      ...(clientId ? { clientId } : {}),\n    };\n\n    this._invokeOnMessage(msg);\n    const result = await this._writer.publish(msg);\n    const serial = result.serials[0];\n\n    if (!serial) {\n      throw new Ably.ErrorInfo(\n        `unable to start stream; no serial returned for stream '${payload.name}' (streamId: ${streamId})`,\n        ErrorCode.BadRequest,\n        400,\n      );\n    }\n\n    this._trackers.set(streamId, {\n      serial,\n      name: payload.name,\n      streamId,\n      accumulated: payload.data,\n      persistentHeaders: allHeaders,\n      aborted: false,\n    });\n\n    this._logger?.debug('DefaultEncoderCore.startStream(); stream started', {\n      name: payload.name,\n      streamId,\n      serial,\n    });\n  }\n\n  // Spec: AIT-CD3\n  appendStream(streamId: string, data: string): void {\n    this._assertNotClosed();\n    const tracker = this._trackers.get(streamId);\n    if (!tracker) {\n      throw new Ably.ErrorInfo(\n        `unable to append to stream; no active stream for streamId '${streamId}'`,\n        ErrorCode.InvalidArgument,\n        400,\n      );\n    }\n\n    tracker.accumulated += data;\n\n    const appendMsg: Ably.Message = {\n      serial: tracker.serial,\n      data,\n      extras: { headers: { ...tracker.persistentHeaders } },\n    };\n\n    this._invokeOnMessage(appendMsg);\n    const p = this._writer.appendMessage(appendMsg);\n    this._pending.push({ promise: p, streamId });\n  }\n\n  // Spec: AIT-CD4, AIT-CD4a\n  async closeStream(streamId: string, payload: StreamPayload): Promise<void> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.closeStream();', { streamId });\n\n    const tracker = this._trackers.get(streamId);\n    if (!tracker) {\n      throw new Ably.ErrorInfo(\n        `unable to close stream; no active stream for streamId '${streamId}'`,\n        ErrorCode.InvalidArgument,\n        400,\n      );\n    }\n\n    // Accumulate closing data so recovery has the full content\n    tracker.accumulated += payload.data;\n\n    const allHeaders = this._buildClosingHeaders(tracker, payload.headers ?? {});\n    allHeaders[HEADER_STATUS] = 'finished';\n\n    const msg: Ably.Message = {\n      serial: tracker.serial,\n      data: payload.data,\n      extras: { headers: allHeaders },\n    };\n\n    this._invokeOnMessage(msg);\n    const p = this._writer.appendMessage(msg);\n    this._pending.push({ promise: p, streamId });\n\n    await this._flushPending();\n\n    this._logger?.debug('DefaultEncoderCore.closeStream(); stream closed', { streamId });\n  }\n\n  // Spec: AIT-CD5, AIT-CD5b\n  async abortStream(streamId: string, opts?: WriteOptions): Promise<void> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.abortStream();', { streamId });\n\n    const tracker = this._trackers.get(streamId);\n    if (!tracker) {\n      throw new Ably.ErrorInfo(\n        `unable to abort stream; no active stream for streamId '${streamId}'`,\n        ErrorCode.InvalidArgument,\n        400,\n      );\n    }\n\n    tracker.aborted = true;\n\n    const allHeaders = this._buildClosingHeaders(tracker, {}, opts);\n    allHeaders[HEADER_STATUS] = 'aborted';\n\n    const msg: Ably.Message = {\n      serial: tracker.serial,\n      data: '',\n      extras: { headers: allHeaders },\n    };\n\n    this._invokeOnMessage(msg);\n    const p = this._writer.appendMessage(msg);\n    this._pending.push({ promise: p, streamId });\n\n    await this._flushPending();\n\n    this._logger?.debug('DefaultEncoderCore.abortStream(); stream aborted', { streamId });\n  }\n\n  // Spec: AIT-CD5a\n  async abortAllStreams(opts?: WriteOptions): Promise<void> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.abortAllStreams();', { streamCount: this._trackers.size });\n\n    for (const tracker of this._trackers.values()) {\n      tracker.aborted = true;\n\n      const allHeaders = this._buildClosingHeaders(tracker, {}, opts);\n      allHeaders[HEADER_STATUS] = 'aborted';\n\n      const msg: Ably.Message = {\n        serial: tracker.serial,\n        data: '',\n        extras: { headers: allHeaders },\n      };\n\n      this._invokeOnMessage(msg);\n      const p = this._writer.appendMessage(msg);\n      this._pending.push({ promise: p, streamId: tracker.streamId });\n    }\n\n    await this._flushPending();\n  }\n\n  // Spec: AIT-CD6\n  private async _flushPending(): Promise<void> {\n    // Re-entrancy guard: if a flush is already in progress, await it instead of starting a new one.\n    if (this._flushPromise) {\n      return this._flushPromise;\n    }\n\n    const snapshot = this._pending;\n    this._pending = [];\n\n    if (snapshot.length === 0) return;\n\n    this._logger?.trace('DefaultEncoderCore._flushPending();', { count: snapshot.length });\n\n    this._flushPromise = this._doFlush(snapshot);\n    try {\n      await this._flushPromise;\n    } finally {\n      this._flushPromise = undefined;\n    }\n  }\n\n  private async _doFlush(snapshot: PendingAppend[]): Promise<void> {\n    const results = await Promise.allSettled(snapshot.map(async (p) => p.promise));\n    const failures = new Set<string>();\n\n    for (const [i, result] of results.entries()) {\n      const entry = snapshot[i];\n      if (entry && result.status === 'rejected') {\n        failures.add(entry.streamId);\n      }\n    }\n\n    if (failures.size === 0) {\n      this._logger?.debug('DefaultEncoderCore._flushPending(); all appends succeeded');\n      return;\n    }\n\n    this._logger?.warn('DefaultEncoderCore._flushPending(); recovering failed appends', {\n      failedStreams: [...failures],\n    });\n\n    const recoveryErrors: { streamId: string; error: unknown }[] = [];\n\n    for (const streamId of failures) {\n      const tracker = this._trackers.get(streamId);\n      if (!tracker) continue;\n\n      const recoveryStatus = tracker.aborted ? 'aborted' : 'finished';\n      const msg: Ably.Message = {\n        serial: tracker.serial,\n        data: tracker.accumulated,\n        extras: { headers: { ...tracker.persistentHeaders, [HEADER_STATUS]: recoveryStatus } },\n      };\n\n      try {\n        await this._writer.updateMessage(msg);\n      } catch (error) {\n        recoveryErrors.push({ streamId, error });\n      }\n    }\n\n    if (recoveryErrors.length > 0) {\n      const ids = recoveryErrors.map((e) => e.streamId).join(', ');\n      this._logger?.error('DefaultEncoderCore._flushPending(); recovery failed', { failedStreams: ids });\n      throw new Ably.ErrorInfo(\n        `unable to flush pending appends; recovery failed for stream(s): ${ids}`,\n        ErrorCode.EncoderRecoveryFailed,\n        500,\n      );\n    }\n  }\n\n  // Spec: AIT-CD12\n  async close(): Promise<void> {\n    if (this._closed) return;\n    this._logger?.trace('DefaultEncoderCore.close();');\n    this._closed = true;\n    try {\n      await this._flushPending();\n    } finally {\n      this._trackers.clear();\n    }\n    this._logger?.debug('DefaultEncoderCore.close(); encoder closed');\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CD14\n  private _invokeOnMessage(msg: Ably.Message): void {\n    try {\n      this._onMessageHook(msg);\n    } catch (error) {\n      this._logger?.error('DefaultEncoderCore._invokeOnMessage(); hook threw', { error });\n    }\n  }\n\n  private _assertNotClosed(): void {\n    if (this._closed) {\n      throw new Ably.ErrorInfo('unable to write to encoder; encoder has been closed', ErrorCode.InvalidArgument, 400);\n    }\n  }\n\n  private _resolveClientId(opts?: WriteOptions): string | undefined {\n    return opts?.clientId ?? this._defaultClientId;\n  }\n\n  private _buildHeaders(codecHeaders: Record<string, string>, opts?: WriteOptions): Record<string, string> {\n    const callerHeaders = mergeHeaders(this._defaultExtras?.headers, opts?.extras?.headers);\n    const merged = { ...callerHeaders, ...codecHeaders };\n    if (opts?.messageId !== undefined) {\n      merged[HEADER_MSG_ID] = opts.messageId;\n    }\n    return merged;\n  }\n\n  private _buildDiscreteMessage(payload: MessagePayload, opts?: WriteOptions): Ably.Message {\n    const headers = this._buildHeaders(payload.headers ?? {}, opts);\n    headers[HEADER_STREAM] = 'false';\n    const clientId = this._resolveClientId(opts);\n\n    const msg: Ably.Message = {\n      name: payload.name,\n      data: payload.data,\n      extras: {\n        headers,\n        ...(payload.ephemeral ? { ephemeral: true } : {}),\n      },\n      ...(clientId ? { clientId } : {}),\n    };\n\n    this._invokeOnMessage(msg);\n    return msg;\n  }\n\n  /**\n   * Build headers for a closing append. Closing appends must repeat ALL\n   * persistent headers (Ably replaces the entire extras object on append).\n   * Then layer caller and codec overrides.\n   * @param tracker - The stream tracker with persistent headers.\n   * @param codecHeaders - Codec-layer headers to merge.\n   * @param opts - Optional per-write overrides.\n   * @returns Merged headers for the closing append.\n   */\n  private _buildClosingHeaders(\n    tracker: StreamState,\n    codecHeaders: Record<string, string>,\n    opts?: WriteOptions,\n  ): Record<string, string> {\n    const h = { ...tracker.persistentHeaders };\n    const callerHeaders = mergeHeaders(this._defaultExtras?.headers, opts?.extras?.headers);\n    Object.assign(h, callerHeaders);\n    Object.assign(h, codecHeaders);\n    return h;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create an encoder core bound to the given channel writer.\n * @param writer - The channel writer to publish messages through.\n * @param options - Encoder configuration (clientId, extras, hooks, logger).\n * @returns A new {@link EncoderCore} instance.\n */\nexport const createEncoderCore = (writer: ChannelWriter, options: EncoderCoreOptions = {}): EncoderCore =>\n  new DefaultEncoderCore(writer, options);\n","/**\n * Generic lifecycle tracker for codec decoders.\n *\n * Manages per-scope (typically per-turn) tracking of lifecycle phases that\n * must be emitted before content events. When a phase has not been emitted\n * (e.g. mid-stream join), the tracker synthesizes the missing events using\n * codec-provided build functions.\n *\n * Codecs configure the tracker with an ordered list of phases, then compose\n * it into their decoder hooks. The tracker is independent of any specific\n * codec or event type.\n */\n\n// ---------------------------------------------------------------------------\n// Phase configuration\n// ---------------------------------------------------------------------------\n\n/**\n * Configuration for a single lifecycle phase that may need to be\n * synthesized when missing from the wire stream.\n */\nexport interface PhaseConfig<TEvent> {\n  /** Unique key identifying this phase (e.g. \"start\", \"start-step\"). */\n  key: string;\n  /**\n   * Build the synthetic event(s) for this phase. Called with a context\n   * record that codecs populate at the call site — the tracker passes\n   * it through without interpreting it.\n   * @param context - Key-value pairs from the call site (e.g. headers).\n   * @returns One or more synthetic events to emit for this phase.\n   */\n  build(context: Record<string, string | undefined>): TEvent[];\n}\n\n// ---------------------------------------------------------------------------\n// Tracker interface\n// ---------------------------------------------------------------------------\n\n/**\n * Per-scope lifecycle tracker that ensures required phases are emitted\n * before content events, synthesizing missing ones for mid-stream joins.\n *\n * Scoped by an arbitrary string key (typically a turn ID). Each scope\n * tracks independently which phases have been emitted.\n */\nexport interface LifecycleTracker<TEvent> {\n  /**\n   * Ensure all configured phases have been emitted for the given scope.\n   * Returns synthetic events for any phases not yet marked as emitted,\n   * then marks them. Returns an empty array if all phases are current.\n   * @param scopeId - The scope to check (e.g. turn ID).\n   * @param context - Key-value pairs passed through to phase build functions.\n   * @returns Synthetic events for missing phases, in configuration order.\n   */\n  ensurePhases(scopeId: string, context: Record<string, string | undefined>): TEvent[];\n\n  /**\n   * Mark a phase as emitted from the wire (not synthetic). Call this\n   * when the real event arrives so the tracker does not re-synthesize it.\n   * @param scopeId - The scope (e.g. turn ID).\n   * @param phaseKey - The phase key to mark.\n   */\n  markEmitted(scopeId: string, phaseKey: string): void;\n\n  /**\n   * Reset a phase so it will be re-synthesized on the next\n   * {@link ensurePhases} call. Used for repeating phases (e.g. \"start-step\"\n   * resets after \"finish-step\").\n   * @param scopeId - The scope (e.g. turn ID).\n   * @param phaseKey - The phase key to reset.\n   */\n  resetPhase(scopeId: string, phaseKey: string): void;\n\n  /**\n   * Remove all tracking state for a scope. Call on turn completion\n   * (finish, abort) to free memory.\n   * @param scopeId - The scope to clear.\n   */\n  clearScope(scopeId: string): void;\n}\n\n// ---------------------------------------------------------------------------\n// Default implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CD13\nclass DefaultLifecycleTracker<TEvent> implements LifecycleTracker<TEvent> {\n  private readonly _phases: PhaseConfig<TEvent>[];\n  private readonly _emitted = new Map<string, Set<string>>();\n\n  constructor(phases: PhaseConfig<TEvent>[]) {\n    this._phases = phases;\n  }\n\n  ensurePhases(scopeId: string, context: Record<string, string | undefined>): TEvent[] {\n    const emitted = this._getOrCreate(scopeId);\n    const events: TEvent[] = [];\n    for (const phase of this._phases) {\n      if (!emitted.has(phase.key)) {\n        emitted.add(phase.key);\n        events.push(...phase.build(context));\n      }\n    }\n    return events;\n  }\n\n  markEmitted(scopeId: string, phaseKey: string): void {\n    this._getOrCreate(scopeId).add(phaseKey);\n  }\n\n  resetPhase(scopeId: string, phaseKey: string): void {\n    this._emitted.get(scopeId)?.delete(phaseKey);\n  }\n\n  clearScope(scopeId: string): void {\n    this._emitted.delete(scopeId);\n  }\n\n  private _getOrCreate(scopeId: string): Set<string> {\n    let set = this._emitted.get(scopeId);\n    if (!set) {\n      set = new Set();\n      this._emitted.set(scopeId, set);\n    }\n    return set;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a lifecycle tracker configured with the given phases.\n * Phases are checked and synthesized in array order.\n * @param phases - Ordered phase configurations.\n * @returns A new {@link LifecycleTracker} instance.\n */\nexport const createLifecycleTracker = <TEvent>(phases: PhaseConfig<TEvent>[]): LifecycleTracker<TEvent> =>\n  new DefaultLifecycleTracker(phases);\n"],"mappings":"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"}
+{"version":3,"file":"ably-ai-transport.js","names":[],"sources":["../src/constants.ts","../src/errors.ts","../src/utils.ts","../src/core/transport/headers.ts","../src/core/transport/pipe-stream.ts","../src/core/transport/turn-manager.ts","../src/core/transport/server-transport.ts","../src/event-emitter.ts","../src/logger.ts","../src/core/transport/stream-router.ts","../src/core/transport/tree.ts","../src/core/transport/decode-history.ts","../src/core/transport/view.ts","../src/core/transport/client-transport.ts","../src/core/codec/decoder.ts","../src/core/codec/encoder.ts","../src/core/codec/lifecycle-tracker.ts"],"sourcesContent":["/**\n * Shared constants used by both codec and transport layers.\n *\n * Header constants define the `x-ably-*` wire protocol. Message and event\n * name constants define the transport lifecycle signals on the channel.\n *\n * These live at the top level (not in codec/ or transport/) because both\n * layers need them — the codec core reads/writes stream and status headers,\n * while the transport layer reads/writes turn, cancel, and role headers.\n */\n\n// ---------------------------------------------------------------------------\n// Stream headers (used by codec encoder/decoder core)\n// ---------------------------------------------------------------------------\n\n/** Header: whether this Ably message uses streaming (message appends) or is discrete. Always \"true\" or \"false\". */\nexport const HEADER_STREAM = 'x-ably-stream';\n\n/** Header: lifecycle status of a streamed message. Only set when x-ably-stream is \"true\". */\nexport const HEADER_STATUS = 'x-ably-status';\n\n/** Header: stream identity. Set by the encoder on every streamed message; read by the decoder to correlate streams. */\nexport const HEADER_STREAM_ID = 'x-ably-stream-id';\n\n/** Header: marks a message as a discrete message part (from writeMessages). Set by publishDiscreteBatch; not set on lifecycle events from publishDiscrete. */\nexport const HEADER_DISCRETE = 'x-ably-discrete';\n\n// ---------------------------------------------------------------------------\n// Identity headers (used by transport for turn correlation)\n// ---------------------------------------------------------------------------\n\n/** Header: turn correlation ID. Set on every message in a turn. */\nexport const HEADER_TURN_ID = 'x-ably-turn-id';\n\n/** Header: message identity. Assigned per message (user or assistant). Used for optimistic reconciliation on the client. */\nexport const HEADER_MSG_ID = 'x-ably-msg-id';\n\n/** Header: clientId of the user who initiated the turn. Set by the server on stream messages. */\nexport const HEADER_TURN_CLIENT_ID = 'x-ably-turn-client-id';\n\n/** Header: message role (e.g. \"user\", \"assistant\"). */\nexport const HEADER_ROLE = 'x-ably-role';\n\n/** Header: the msg-id of the existing message this Ably message amends. Present on cross-turn amendment events. */\nexport const HEADER_AMEND = 'x-ably-amend';\n\n// ---------------------------------------------------------------------------\n// Cancel headers\n// ---------------------------------------------------------------------------\n\n/** Header: cancel a specific turn by ID. */\nexport const HEADER_CANCEL_TURN_ID = 'x-ably-cancel-turn-id';\n\n/** Header: cancel all turns belonging to the sender's clientId. */\nexport const HEADER_CANCEL_OWN = 'x-ably-cancel-own';\n\n/** Header: cancel all turns on the channel. */\nexport const HEADER_CANCEL_ALL = 'x-ably-cancel-all';\n\n/** Header: cancel all turns belonging to a specific clientId. */\nexport const HEADER_CANCEL_CLIENT_ID = 'x-ably-cancel-client-id';\n\n// ---------------------------------------------------------------------------\n// Fork / branching headers\n// ---------------------------------------------------------------------------\n\n/** Header: the msg-id of the immediately preceding message in this branch. */\nexport const HEADER_PARENT = 'x-ably-parent';\n\n/** Header: the msg-id of the message this one replaces (creates a fork). */\nexport const HEADER_FORK_OF = 'x-ably-fork-of';\n\n// ---------------------------------------------------------------------------\n// Turn lifecycle headers\n// ---------------------------------------------------------------------------\n\n/** Header: reason a turn ended (on x-ably-turn-end messages). */\nexport const HEADER_TURN_REASON = 'x-ably-turn-reason';\n\n// ---------------------------------------------------------------------------\n// Message / event names\n// ---------------------------------------------------------------------------\n\n/** Message name: client->server cancel signal. */\nexport const EVENT_CANCEL = 'x-ably-cancel';\n\n/** Message name: server publishes this to signal a turn has started. */\nexport const EVENT_TURN_START = 'x-ably-turn-start';\n\n/** Message name: server publishes this to signal a turn has ended. */\nexport const EVENT_TURN_END = 'x-ably-turn-end';\n\n/** Message name: transport-level abort signal (stream cancelled). */\nexport const EVENT_ABORT = 'x-ably-abort';\n\n/** Message name: transport-level error signal. */\nexport const EVENT_ERROR = 'x-ably-error';\n\n// ---------------------------------------------------------------------------\n// Domain header prefix (used by codec implementations)\n// ---------------------------------------------------------------------------\n\n/** Prefix for domain-specific headers. Distinguishes codec-layer headers from transport `x-ably-*` headers. */\nexport const DOMAIN_HEADER_PREFIX = 'x-domain-';\n","import * as Ably from 'ably';\n\n/**\n * Error codes for the AI Transport SDK.\n */\nexport enum ErrorCode {\n  /**\n   * The request was invalid.\n   */\n  BadRequest = 40000,\n\n  /**\n   * Invalid argument provided.\n   */\n  InvalidArgument = 40003,\n\n  // 104000 - 104999 are reserved for AI Transport SDK errors\n\n  /**\n   * Encoder recovery failed after flush — one or more updateMessage calls\n   * could not recover a failed append pipeline.\n   */\n  EncoderRecoveryFailed = 104000,\n\n  /**\n   * A transport-level channel subscription callback threw unexpectedly.\n   */\n  TransportSubscriptionError = 104001,\n\n  /**\n   * Cancel listener or onCancel hook threw while processing a cancel message.\n   */\n  CancelListenerError = 104002,\n\n  /**\n   * A publish within a turn failed (lifecycle event, message, or event).\n   */\n  TurnLifecycleError = 104003,\n\n  /**\n   * An operation was attempted on a transport that has already been closed.\n   */\n  TransportClosed = 104004,\n\n  /**\n   * The HTTP POST to the server endpoint failed (network error or non-2xx response).\n   */\n  TransportSendFailed = 104005,\n\n  /**\n   * The Ably channel lost message continuity — the channel entered FAILED,\n   * SUSPENDED, or DETACHED, or re-attached with `resumed: false`. Active\n   * streams can no longer be guaranteed to receive all events.\n   */\n  ChannelContinuityLost = 104006,\n\n  /**\n   * An operation was attempted but the channel is not in a usable state\n   * (not ATTACHED or ATTACHING).\n   */\n  ChannelNotReady = 104007,\n\n  /**\n   * An error occurred while piping a response stream to the channel — either\n   * the source event stream threw (e.g. LLM provider rate limit, model error,\n   * network failure) or an underlying publish failed mid-stream.\n   */\n  StreamError = 104008,\n}\n\n/**\n * Returns true if the {@link Ably.ErrorInfo} code matches the provided ErrorCode value.\n * @param errorInfo The error info to check.\n * @param error The error code to compare against.\n * @returns true if the error code matches, false otherwise.\n */\n// eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison\nexport const errorInfoIs = (errorInfo: Ably.ErrorInfo, error: ErrorCode): boolean => errorInfo.code === error;\n","/**\n * Shared utilities for working with Ably messages.\n *\n * These are general-purpose helpers used by both the codec and transport\n * layers. They live at the top level to avoid either layer depending on\n * the other.\n */\n\nimport type * as Ably from 'ably';\n\nimport { DOMAIN_HEADER_PREFIX } from './constants.js';\n\n/**\n * Extract extras.headers from an Ably InboundMessage.\n * @param message - The Ably message to extract headers from.\n * @returns The headers record, or an empty object if absent.\n */\nexport const getHeaders = (message: Ably.InboundMessage): Record<string, string> => {\n  // CAST: Ably SDK types `extras` as `any`; runtime checks below guard access.\n  const extras = message.extras as unknown;\n  if (!extras || typeof extras !== 'object') return {};\n  const headers = (extras as { headers?: unknown }).headers;\n  if (!headers || typeof headers !== 'object') return {};\n  // CAST: Ably wire protocol guarantees headers is Record<string, string>\n  // when present, verified by the runtime guards above.\n  return headers as Record<string, string>;\n};\n\n/**\n * Parse a JSON string, returning undefined on failure.\n * @param value - The JSON string to parse.\n * @returns The parsed value, or undefined if parsing fails.\n */\nexport const parseJson = (value: string | undefined): unknown => {\n  if (value === undefined) return undefined;\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Set a header value if defined, skipping undefined and null. Strings are set directly,\n * booleans and numbers are stringified, objects are JSON-serialized.\n * @param headers - The headers object to mutate.\n * @param key - The header key.\n * @param value - The value to set.\n */\nexport const setIfPresent = (headers: Record<string, string>, key: string, value: unknown): void => {\n  if (value === undefined || value === null) return;\n  if (typeof value === 'string') {\n    headers[key] = value;\n  } else if (typeof value === 'boolean' || typeof value === 'number') {\n    headers[key] = String(value);\n  } else if (typeof value === 'object') {\n    headers[key] = JSON.stringify(value);\n  }\n};\n\n/**\n * Set multiple headers at once, skipping entries whose values are undefined or null.\n * Each value is converted using the same rules as {@link setIfPresent}.\n * @param headers - The headers object to mutate.\n * @param entries - Key-value pairs to set.\n */\nexport const setHeadersIfPresent = (headers: Record<string, string>, entries: Record<string, unknown>): void => {\n  for (const [key, value] of Object.entries(entries)) {\n    setIfPresent(headers, key, value);\n  }\n};\n\n/**\n * Merge two header records into a new object. Later values override earlier ones.\n * Undefined inputs are treated as empty.\n * @param base - Base headers (lower priority).\n * @param overrides - Override headers (higher priority).\n * @returns A new merged headers object.\n */\nexport const mergeHeaders = (\n  base: Record<string, string> | undefined,\n  overrides: Record<string, string> | undefined,\n): Record<string, string> => ({\n  ...base,\n  ...overrides,\n});\n\n/**\n * Parse a boolean header (\"true\"/\"false\"), returning undefined if absent.\n * @param value - The header string to parse.\n * @returns True if \"true\", false for any other string, or undefined if absent.\n */\nexport const parseBool = (value: string | undefined): boolean | undefined => {\n  if (value === undefined) return undefined;\n  return value === 'true';\n};\n\n/**\n * Build a domain headers record from key-value pairs. Each key is automatically\n * prefixed with {@link DOMAIN_HEADER_PREFIX}. Values that are undefined or null\n * are skipped; strings are set directly; booleans, numbers, and objects are\n * converted using the same rules as {@link setIfPresent}.\n * @param entries - Unprefixed key-value pairs (e.g. `{ toolCallId: 'tc-1' }` becomes `{ 'x-domain-toolCallId': 'tc-1' }`).\n * @returns A new headers record with prefixed keys.\n */\nexport const domainHeaders = (entries: Record<string, unknown>): Record<string, string> => {\n  const h: Record<string, string> = {};\n  for (const [key, value] of Object.entries(entries)) {\n    setIfPresent(h, DOMAIN_HEADER_PREFIX + key, value);\n  }\n  return h;\n};\n\n/**\n * Read a domain header value from a headers record.\n * @param headers - The headers record to read from.\n * @param key - The unprefixed domain key (e.g. `'toolCallId'` reads `'x-domain-toolCallId'`).\n * @returns The header value, or undefined if absent.\n */\nexport const getDomainHeader = (headers: Record<string, string>, key: string): string | undefined =>\n  headers[DOMAIN_HEADER_PREFIX + key];\n\n/**\n * Mapped type that converts properties whose type includes `undefined`\n * into optional properties with `undefined` excluded from the value.\n * Properties typed as `unknown` are kept required (since `undefined extends unknown`\n * is always true, but `unknown` fields are intentionally broad, not optional).\n */\nexport type Stripped<T> = {\n  [K in keyof T as undefined extends T[K] ? (unknown extends T[K] ? K : never) : K]: T[K];\n} & {\n  [K in keyof T as undefined extends T[K] ? (unknown extends T[K] ? never : K) : never]?: Exclude<T[K], undefined>;\n};\n\n/**\n * Remove all keys whose value is `undefined` from a shallow object.\n * Returns a new object — the input is not mutated. Useful for building\n * chunk literals with optional fields without conditional spread noise.\n *\n * The return type converts `{ foo: T | undefined }` to `{ foo?: T }`,\n * matching the optional-field pattern used by the AI SDK chunk types.\n * @param obj - The object to strip undefined values from.\n * @returns A shallow copy with undefined-valued keys removed.\n */\nexport const stripUndefined = <T extends Record<string, unknown>>(obj: T): Stripped<T> => {\n  const result = {} as Record<string, unknown>;\n  for (const key in obj) {\n    if (Object.prototype.hasOwnProperty.call(obj, key) && obj[key] !== undefined) {\n      result[key] = obj[key];\n    }\n  }\n  // CAST: The runtime strip guarantees the Stripped<T> contract —\n  // required keys are always present, optional keys are absent when undefined.\n  return result as Stripped<T>;\n};\n\n// ---------------------------------------------------------------------------\n// DomainHeaderReader — typed accessors for domain headers\n// ---------------------------------------------------------------------------\n\n/**\n * Typed accessor wrapper around a headers record for reading domain headers.\n * Reduces repetitive `getDomainHeader` + `parseBool` / `parseJson` chains.\n */\nexport interface DomainHeaderReader {\n  /** Read a domain header as a string, or undefined if absent. */\n  str(key: string): string | undefined;\n  /** Read a domain header as a string, falling back to a default if absent. */\n  strOr(key: string, fallback: string): string;\n  /** Read a domain header as a boolean (\"true\"/\"false\"), or undefined if absent. */\n  bool(key: string): boolean | undefined;\n  /** Read a domain header as parsed JSON, or undefined if absent or invalid. */\n  json(key: string): unknown;\n}\n\n/**\n * Create a {@link DomainHeaderReader} over a headers record.\n * @param headers - The raw headers record to read domain headers from.\n * @returns A typed accessor for domain header values.\n */\nexport const headerReader = (headers: Record<string, string>): DomainHeaderReader => ({\n  str: (key: string) => getDomainHeader(headers, key),\n  strOr: (key: string, fallback: string) => getDomainHeader(headers, key) ?? fallback,\n  bool: (key: string) => parseBool(getDomainHeader(headers, key)),\n  json: (key: string) => parseJson(getDomainHeader(headers, key)),\n});\n\n// ---------------------------------------------------------------------------\n// DomainHeaderWriter — typed builder for domain headers\n// ---------------------------------------------------------------------------\n\n/**\n * Fluent builder for constructing domain header records with typed setters.\n * Mirrors {@link DomainHeaderReader} with the same method names for symmetry.\n * Undefined values are silently skipped on all setters.\n */\nexport interface DomainHeaderWriter {\n  /** Set a string domain header. Skips if value is undefined. */\n  str(key: string, value: string | undefined): DomainHeaderWriter;\n  /** Set a boolean domain header (serialized as \"true\"/\"false\"). Skips if value is undefined. */\n  bool(key: string, value: boolean | undefined): DomainHeaderWriter;\n  /** Set a JSON-serialized domain header. Skips if value is undefined or null. */\n  json(key: string, value: unknown): DomainHeaderWriter;\n  /** Return the accumulated headers record. */\n  build(): Record<string, string>;\n}\n\n/**\n * Create a {@link DomainHeaderWriter} for building a domain headers record.\n * @returns A fluent builder that prefixes each key with the domain header prefix.\n */\nexport const headerWriter = (): DomainHeaderWriter => {\n  const h: Record<string, string> = {};\n  const writer: DomainHeaderWriter = {\n    str: (key: string, value: string | undefined) => {\n      if (value !== undefined) h[DOMAIN_HEADER_PREFIX + key] = value;\n      return writer;\n    },\n    bool: (key: string, value: boolean | undefined) => {\n      if (value !== undefined) h[DOMAIN_HEADER_PREFIX + key] = String(value);\n      return writer;\n    },\n    json: (key: string, value: unknown) => {\n      if (value !== undefined && value !== null) h[DOMAIN_HEADER_PREFIX + key] = JSON.stringify(value);\n      return writer;\n    },\n    build: () => h,\n  };\n  return writer;\n};\n","/**\n * Transport header builder.\n *\n * Single source of truth for which `x-ably-*` headers every transport\n * message carries. Used by the server transport (addMessages, streamResponse)\n * and will be used by the client transport (optimistic message stamping).\n */\n\nimport {\n  HEADER_AMEND,\n  HEADER_FORK_OF,\n  HEADER_MSG_ID,\n  HEADER_PARENT,\n  HEADER_ROLE,\n  HEADER_TURN_CLIENT_ID,\n  HEADER_TURN_ID,\n} from '../../constants.js';\n\n/**\n * Build the standard transport header set for a message.\n * @param opts - The header values to include.\n * @param opts.role - Message role (e.g. \"user\", \"assistant\").\n * @param opts.turnId - Turn correlation ID.\n * @param opts.msgId - Message identity.\n * @param opts.turnClientId - ClientId of the turn initiator.\n * @param opts.parent - Preceding message's msg-id (for branching).\n * @param opts.forkOf - Forked message's msg-id (for edit/regen).\n * @param opts.amend - The msg-id of the existing message this message targets (cross-turn events).\n * @returns A headers record with the `x-ably-*` transport headers set.\n */\nexport const buildTransportHeaders = (opts: {\n  role: string;\n  turnId: string;\n  msgId: string;\n  turnClientId?: string;\n  parent?: string;\n  forkOf?: string;\n  amend?: string;\n}): Record<string, string> => {\n  const h: Record<string, string> = {\n    [HEADER_ROLE]: opts.role,\n    [HEADER_TURN_ID]: opts.turnId,\n    [HEADER_MSG_ID]: opts.msgId,\n  };\n  if (opts.turnClientId !== undefined) h[HEADER_TURN_CLIENT_ID] = opts.turnClientId;\n  if (opts.parent) h[HEADER_PARENT] = opts.parent;\n  if (opts.forkOf) h[HEADER_FORK_OF] = opts.forkOf;\n  if (opts.amend) h[HEADER_AMEND] = opts.amend;\n  return h;\n};\n","/**\n * Pure stream piping function.\n *\n * Reads events from a ReadableStream, writes them to a streaming encoder,\n * and handles abort/error. No dependencies on turn state or transport internals.\n */\n\nimport type { Logger } from '../../logger.js';\nimport type { StreamEncoder, WriteOptions } from '../codec/types.js';\nimport type { StreamResult } from './types.js';\n\n/**\n * Pipe an event stream through an encoder to the channel.\n *\n * Returns when the stream completes, is cancelled (via signal), or errors.\n * The `reason` field of the result indicates which case occurred.\n * @param stream - The event stream to read from.\n * @param encoder - The streaming encoder to write events through.\n * @param signal - Abort signal to monitor for cancellation.\n * @param onAbort - Optional callback invoked when the stream is cancelled, before the stream ends.\n * @param resolveWriteOptions - Optional per-event hook returning {@link WriteOptions} overrides to pass to `encoder.appendEvent`.\n * @param logger - Optional logger for diagnostic output.\n * @returns The reason the pipe ended.\n */\nexport const pipeStream = async <TEvent, TMessage>(\n  stream: ReadableStream<TEvent>,\n  encoder: StreamEncoder<TEvent, TMessage>,\n  signal: AbortSignal | undefined,\n  onAbort?: (write: (event: TEvent) => Promise<void>) => void | Promise<void>,\n  resolveWriteOptions?: (event: TEvent) => WriteOptions | undefined,\n  logger?: Logger,\n): Promise<StreamResult> => {\n  logger?.trace('pipeStream();');\n\n  const reader = stream.getReader();\n\n  let abortListener: (() => void) | undefined;\n  const abortPromise = signal\n    ? new Promise<void>((resolve) => {\n        if (signal.aborted) {\n          resolve();\n          return;\n        }\n        abortListener = () => {\n          resolve();\n        };\n        signal.addEventListener('abort', abortListener, { once: true });\n      })\n    : // eslint-disable-next-line @typescript-eslint/no-empty-function -- never-resolving promise: no signal means no cancellation path\n      new Promise<void>(() => {});\n\n  let reason: StreamResult['reason'] = 'complete';\n  let caughtError: Error | undefined;\n\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- intentional infinite loop broken by return/break\n    while (true) {\n      // .then() is intentional: transforms the abort signal into a discriminant\n      // for Promise.race — no async/await equivalent for this pattern.\n      const result = await Promise.race([reader.read(), abortPromise.then(() => 'aborted' as const)]);\n\n      if (result === 'aborted') {\n        reason = 'cancelled';\n        logger?.debug('pipeStream(); stream cancelled by abort signal');\n        if (onAbort) {\n          await onAbort(async (event: TEvent) => encoder.appendEvent(event));\n        }\n        await encoder.abort('cancelled');\n        break;\n      }\n\n      const { done, value } = result;\n      if (done) {\n        await encoder.close();\n        logger?.debug('pipeStream(); stream completed');\n        break;\n      }\n\n      await encoder.appendEvent(value, resolveWriteOptions?.(value));\n    }\n  } catch (error) {\n    reason = 'error';\n    caughtError = error instanceof Error ? error : new Error(String(error));\n    logger?.error('pipeStream(); stream error', { error: caughtError.message });\n    try {\n      await encoder.close();\n    } catch {\n      // Best-effort: encoder close in the error path may also fail\n      // (e.g. channel disconnected). The original error is preserved in\n      // the StreamResult reason (\"error\").\n    }\n  } finally {\n    if (abortListener) signal?.removeEventListener('abort', abortListener);\n    reader.releaseLock();\n  }\n\n  return { reason, error: caughtError };\n};\n","/**\n * Server-side turn state management and lifecycle event publishing.\n *\n * Owns the authoritative turn lifecycle. Tracks active turns with their\n * AbortControllers and clientIds. Publishes turn-start and turn-end events\n * on the Ably channel so all clients can react to turn state changes.\n */\n\nimport type * as Ably from 'ably';\n\nimport {\n  EVENT_TURN_END,\n  EVENT_TURN_START,\n  HEADER_FORK_OF,\n  HEADER_PARENT,\n  HEADER_TURN_CLIENT_ID,\n  HEADER_TURN_ID,\n  HEADER_TURN_REASON,\n} from '../../constants.js';\nimport type { Logger } from '../../logger.js';\nimport type { TurnEndReason } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Interface\n// ---------------------------------------------------------------------------\n\n/** Manages active turns and publishes turn lifecycle events on the channel. */\nexport interface TurnManager {\n  /** Register a new turn. Publishes turn-start on the channel. Returns AbortSignal. */\n  startTurn(\n    turnId: string,\n    clientId?: string,\n    controller?: AbortController,\n    metadata?: { parent?: string; forkOf?: string },\n  ): Promise<AbortSignal>;\n  /** End a turn. Publishes turn-end on the channel. Cleans up internal state. */\n  endTurn(turnId: string, reason: TurnEndReason): Promise<void>;\n  /** Get the AbortSignal for a turn. */\n  getSignal(turnId: string): AbortSignal | undefined;\n  /** Get the clientId that owns a turn. */\n  getClientId(turnId: string): string | undefined;\n  /** Abort the signal for a turn. */\n  abort(turnId: string): void;\n  /** Get all active turn IDs. */\n  getActiveTurnIds(): string[];\n  /** Abort all active turns and clear state. */\n  close(): void;\n}\n\n// ---------------------------------------------------------------------------\n// Internal state\n// ---------------------------------------------------------------------------\n\ninterface ActiveTurnsEntry {\n  controller: AbortController;\n  clientId: string;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nclass DefaultTurnManager implements TurnManager {\n  private readonly _channel: Ably.RealtimeChannel;\n  private readonly _logger: Logger | undefined;\n  private readonly _activeTurns = new Map<string, ActiveTurnsEntry>();\n\n  constructor(channel: Ably.RealtimeChannel, logger?: Logger) {\n    this._channel = channel;\n    this._logger = logger?.withContext({ component: 'TurnManager' });\n  }\n\n  async startTurn(\n    turnId: string,\n    clientId?: string,\n    externalController?: AbortController,\n    metadata?: { parent?: string; forkOf?: string },\n  ): Promise<AbortSignal> {\n    this._logger?.trace('DefaultTurnManager.startTurn();', { turnId, clientId });\n\n    const controller = externalController ?? new AbortController();\n    const resolvedClientId = clientId ?? '';\n    this._activeTurns.set(turnId, { controller, clientId: resolvedClientId });\n\n    const headers: Record<string, string> = {\n      [HEADER_TURN_ID]: turnId,\n      [HEADER_TURN_CLIENT_ID]: resolvedClientId,\n    };\n    if (metadata?.parent !== undefined) {\n      headers[HEADER_PARENT] = metadata.parent;\n    }\n    if (metadata?.forkOf !== undefined) {\n      headers[HEADER_FORK_OF] = metadata.forkOf;\n    }\n\n    await this._channel.publish({\n      name: EVENT_TURN_START,\n      extras: { headers },\n    });\n\n    this._logger?.debug('DefaultTurnManager.startTurn(); turn started', { turnId });\n    return controller.signal;\n  }\n\n  async endTurn(turnId: string, reason: TurnEndReason): Promise<void> {\n    this._logger?.trace('DefaultTurnManager.endTurn();', { turnId, reason });\n\n    const state = this._activeTurns.get(turnId);\n    const resolvedClientId = state?.clientId ?? '';\n\n    // Publish before deleting local state so that if publish fails,\n    // the turn remains in the active set and can be retried or cleaned up.\n    await this._channel.publish({\n      name: EVENT_TURN_END,\n      extras: {\n        headers: {\n          [HEADER_TURN_ID]: turnId,\n          [HEADER_TURN_CLIENT_ID]: resolvedClientId,\n          [HEADER_TURN_REASON]: reason,\n        },\n      },\n    });\n\n    this._activeTurns.delete(turnId);\n    this._logger?.debug('DefaultTurnManager.endTurn(); turn ended', { turnId, reason });\n  }\n\n  getSignal(turnId: string): AbortSignal | undefined {\n    return this._activeTurns.get(turnId)?.controller.signal;\n  }\n\n  getClientId(turnId: string): string | undefined {\n    return this._activeTurns.get(turnId)?.clientId;\n  }\n\n  abort(turnId: string): void {\n    this._logger?.debug('DefaultTurnManager.abort();', { turnId });\n    this._activeTurns.get(turnId)?.controller.abort();\n  }\n\n  getActiveTurnIds(): string[] {\n    return [...this._activeTurns.keys()];\n  }\n\n  close(): void {\n    this._logger?.trace('DefaultTurnManager.close();', { activeTurns: this._activeTurns.size });\n    for (const state of this._activeTurns.values()) {\n      state.controller.abort();\n    }\n    this._activeTurns.clear();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a turn manager bound to the given channel.\n * @param channel - The Ably channel to publish lifecycle events on.\n * @param logger - Optional logger for diagnostic output.\n * @returns A new {@link TurnManager} instance.\n */\nexport const createTurnManager = (channel: Ably.RealtimeChannel, logger?: Logger): TurnManager =>\n  new DefaultTurnManager(channel, logger);\n","/**\n * Core server-side transport, parameterized by codec.\n *\n * Composes TurnManager and pipeStream to handle the full server-side turn\n * lifecycle. Cancel message routing is handled directly by the transport's\n * single channel subscription — no separate cancel manager needed.\n *\n * The transport exposes a single factory method — `newTurn()` — which returns\n * a Turn object with explicit lifecycle methods: start(), addMessages(),\n * streamResponse(), and end().\n */\n\nimport * as Ably from 'ably';\n\nimport {\n  EVENT_CANCEL,\n  HEADER_CANCEL_ALL,\n  HEADER_CANCEL_CLIENT_ID,\n  HEADER_CANCEL_OWN,\n  HEADER_CANCEL_TURN_ID,\n} from '../../constants.js';\nimport { ErrorCode } from '../../errors.js';\nimport type { Logger } from '../../logger.js';\nimport { getHeaders, mergeHeaders } from '../../utils.js';\nimport { buildTransportHeaders } from './headers.js';\nimport { pipeStream } from './pipe-stream.js';\nimport type { TurnManager } from './turn-manager.js';\nimport { createTurnManager } from './turn-manager.js';\nimport type {\n  AddMessageOptions,\n  AddMessagesResult,\n  CancelFilter,\n  CancelRequest,\n  EventsNode,\n  MessageNode,\n  NewTurnOptions,\n  ServerTransport,\n  ServerTransportOptions,\n  StreamResponseOptions,\n  StreamResult,\n  Turn,\n  TurnEndReason,\n} from './types.js';\n\n// ---------------------------------------------------------------------------\n// Internal turn record for cancel routing\n// ---------------------------------------------------------------------------\n\ninterface RegisteredTurn {\n  turnId: string;\n  clientId: string;\n  controller: AbortController;\n  /** Composite signal that fires when either the internal controller or the external signal aborts. */\n  signal: AbortSignal;\n  onCancel?: (request: CancelRequest) => Promise<boolean>;\n  onError?: (error: Ably.ErrorInfo) => void;\n}\n\n// ---------------------------------------------------------------------------\n// Internal state machines\n// ---------------------------------------------------------------------------\n\nenum ServerTransportState {\n  READY = 'ready',\n  CLOSED = 'closed',\n}\n\nenum TurnState {\n  INITIALIZED = 'initialized',\n  STARTED = 'started',\n  ENDED = 'ended',\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-ST1\nclass DefaultServerTransport<TEvent, TMessage> implements ServerTransport<TEvent, TMessage> {\n  private readonly _channel: Ably.RealtimeChannel;\n  private readonly _codec: ServerTransportOptions<TEvent, TMessage>['codec'];\n  private readonly _logger: Logger | undefined;\n  private readonly _onError: ((error: Ably.ErrorInfo) => void) | undefined;\n  private readonly _turnManager: TurnManager;\n  private readonly _registeredTurns = new Map<string, RegisteredTurn>();\n  private readonly _channelListener: (msg: Ably.InboundMessage) => void;\n  private readonly _attachPromise: Promise<void>;\n\n  private _state = ServerTransportState.READY;\n  private _hasAttachedOnce: boolean;\n  private readonly _onChannelStateChange: Ably.channelEventCallback;\n\n  constructor(options: ServerTransportOptions<TEvent, TMessage>) {\n    this._channel = options.channel;\n    this._codec = options.codec;\n    this._logger = options.logger?.withContext({ component: 'ServerTransport' });\n    this._onError = options.onError;\n    this._turnManager = createTurnManager(this._channel, this._logger);\n\n    this._channelListener = (msg: Ably.InboundMessage) => {\n      this._handleChannelMessage(msg);\n    };\n\n    // Spec: AIT-ST2\n    // Subscribe before attach (RTL7g) — ensures no messages are missed.\n    this._attachPromise = this._channel.subscribe(EVENT_CANCEL, this._channelListener).then(\n      /* eslint-disable @typescript-eslint/no-empty-function -- discard subscription handle */\n      () => {},\n      /* eslint-enable @typescript-eslint/no-empty-function */\n      (error: unknown) => {\n        const errInfo = new Ably.ErrorInfo(\n          `unable to subscribe to cancel messages; ${error instanceof Error ? error.message : String(error)}`,\n          ErrorCode.TransportSubscriptionError,\n          500,\n          error instanceof Ably.ErrorInfo ? error : undefined,\n        );\n        this._logger?.error('DefaultServerTransport(); subscribe failed');\n        this._onError?.(errInfo);\n      },\n    );\n\n    // Spec: AIT-ST12, AIT-ST12a\n    // Listen for channel state changes that break message continuity. The\n    // server only consumes cancel messages from the channel, so losing one\n    // is survivable — but the developer needs to know so they can decide\n    // whether to abort in-flight work. _hasAttachedOnce is seeded from the\n    // channel's current state so pre-attached channels are handled correctly;\n    // it distinguishes the initial attach from a genuine discontinuity.\n    this._hasAttachedOnce = this._channel.state === 'attached';\n    this._onChannelStateChange = (stateChange: Ably.ChannelStateChange) => {\n      this._handleChannelStateChange(stateChange);\n    };\n    this._channel.on(this._onChannelStateChange);\n\n    this._logger?.debug('DefaultServerTransport(); transport created');\n  }\n\n  // -------------------------------------------------------------------------\n  // Public API\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-ST3\n  newTurn(turnOpts: NewTurnOptions<TEvent>): Turn<TEvent, TMessage> {\n    this._logger?.trace('DefaultServerTransport.newTurn();', { turnId: turnOpts.turnId });\n    return this._createTurn(turnOpts);\n  }\n\n  // Spec: AIT-ST11\n  close(): void {\n    if (this._state === ServerTransportState.CLOSED) return;\n    this._state = ServerTransportState.CLOSED;\n    this._logger?.trace('DefaultServerTransport.close();');\n    this._channel.unsubscribe(EVENT_CANCEL, this._channelListener);\n    this._channel.off(this._onChannelStateChange);\n    for (const reg of this._registeredTurns.values()) {\n      reg.controller.abort();\n    }\n    this._registeredTurns.clear();\n    this._turnManager.close();\n    this._logger?.debug('DefaultServerTransport.close(); transport closed');\n  }\n\n  // -------------------------------------------------------------------------\n  // Cancel message routing\n  // -------------------------------------------------------------------------\n\n  private _resolveFilter(filter: CancelFilter, senderClientId?: string): string[] {\n    const turnIds = [...this._registeredTurns.keys()];\n\n    if (filter.all) return turnIds;\n    if (filter.own && senderClientId) {\n      return turnIds.filter((id) => this._registeredTurns.get(id)?.clientId === senderClientId);\n    }\n    if (filter.clientId) {\n      return turnIds.filter((id) => this._registeredTurns.get(id)?.clientId === filter.clientId);\n    }\n    if (filter.turnId && this._registeredTurns.has(filter.turnId)) {\n      return [filter.turnId];\n    }\n    return [];\n  }\n\n  // Spec: AIT-ST8, AIT-ST8a, AIT-ST8b, AIT-ST8c, AIT-ST8d, AIT-ST9, AIT-ST9a\n  private async _handleCancelMessage(msg: Ably.InboundMessage): Promise<void> {\n    const headers = getHeaders(msg);\n\n    // Spec: AIT-ST8a, AIT-ST8b, AIT-ST8c, AIT-ST8d\n    const filter: CancelFilter = {};\n    if (headers[HEADER_CANCEL_TURN_ID]) {\n      filter.turnId = headers[HEADER_CANCEL_TURN_ID];\n    } else if (headers[HEADER_CANCEL_OWN] === 'true') {\n      filter.own = true;\n    } else if (headers[HEADER_CANCEL_CLIENT_ID]) {\n      filter.clientId = headers[HEADER_CANCEL_CLIENT_ID];\n    } else if (headers[HEADER_CANCEL_ALL] === 'true') {\n      filter.all = true;\n    }\n\n    const matchedTurnIds = this._resolveFilter(filter, msg.clientId);\n    if (matchedTurnIds.length === 0) return;\n\n    this._logger?.debug('DefaultServerTransport._handleCancelMessage(); matched turns', {\n      matchedTurnIds,\n      filter,\n    });\n\n    const owners = new Map<string, string>();\n    for (const tid of matchedTurnIds) {\n      const reg = this._registeredTurns.get(tid);\n      owners.set(tid, reg?.clientId ?? '');\n    }\n    const request: CancelRequest = { message: msg, filter, matchedTurnIds, turnOwners: owners };\n\n    for (const turnId of matchedTurnIds) {\n      const reg = this._registeredTurns.get(turnId);\n      if (!reg) continue;\n\n      try {\n        if (reg.onCancel) {\n          const allowed = await reg.onCancel(request);\n          if (!allowed) {\n            this._logger?.debug('DefaultServerTransport._handleCancelMessage(); cancel rejected by onCancel', {\n              turnId,\n            });\n            continue;\n          }\n        }\n        reg.controller.abort();\n        this._logger?.debug('DefaultServerTransport._handleCancelMessage(); turn aborted', { turnId });\n      } catch (error) {\n        // A throwing onCancel handler must not prevent other turns from being cancelled.\n        const errInfo = new Ably.ErrorInfo(\n          `unable to process cancel for turn ${turnId}; onCancel handler threw: ${error instanceof Error ? error.message : String(error)}`,\n          ErrorCode.CancelListenerError,\n          500,\n          error instanceof Ably.ErrorInfo ? error : undefined,\n        );\n        this._logger?.error('DefaultServerTransport._handleCancelMessage(); onCancel threw', { turnId });\n        (reg.onError ?? this._onError)?.(errInfo);\n      }\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Channel state change handler\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-ST12, AIT-ST12a\n  private _handleChannelStateChange(stateChange: Ably.ChannelStateChange): void {\n    if (this._state === ServerTransportState.CLOSED) return;\n\n    const { current, resumed } = stateChange;\n\n    // Track the initial attach so we don't treat it as a discontinuity\n    if (current === 'attached' && !this._hasAttachedOnce) {\n      this._hasAttachedOnce = true;\n      return;\n    }\n\n    // Continuity-breaking states:\n    // - FAILED, SUSPENDED, DETACHED: no more messages expected (or gap)\n    // - ATTACHED with resumed: false (UPDATE): messages were lost\n    const continuityLost =\n      current === 'failed' || current === 'suspended' || current === 'detached' || (current === 'attached' && !resumed);\n\n    if (!continuityLost) return;\n\n    this._logger?.error('DefaultServerTransport._handleChannelStateChange(); channel continuity lost', {\n      current,\n      resumed,\n      previous: stateChange.previous,\n    });\n\n    const err = new Ably.ErrorInfo(\n      `unable to deliver cancel messages; channel continuity lost (${current}${current === 'attached' ? ', resumed: false' : ''})`,\n      ErrorCode.ChannelContinuityLost,\n      500,\n      stateChange.reason,\n    );\n\n    // Transport-level notification only: continuity loss is not scoped to any\n    // turn. Per-turn onError handlers are reserved for errors from that turn's\n    // own operations (publish failures, encoder errors). Developers that need\n    // per-turn reaction can iterate active turns from the transport handler.\n    this._onError?.(err);\n  }\n\n  // -------------------------------------------------------------------------\n  // Channel subscription handler\n  // -------------------------------------------------------------------------\n\n  private _handleChannelMessage(msg: Ably.InboundMessage): void {\n    try {\n      if (msg.name === EVENT_CANCEL) {\n        // Fire-and-forget async handler — errors are caught internally.\n        this._handleCancelMessage(msg).catch((error: unknown) => {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to route cancel message; ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.CancelListenerError,\n            500,\n            error instanceof Ably.ErrorInfo ? error : undefined,\n          );\n          this._logger?.error('DefaultServerTransport._handleChannelMessage(); cancel routing error');\n          this._onError?.(errInfo);\n        });\n      }\n    } catch (error) {\n      const errInfo = new Ably.ErrorInfo(\n        `unable to process channel message; ${error instanceof Error ? error.message : String(error)}`,\n        ErrorCode.TransportSubscriptionError,\n        500,\n        error instanceof Ably.ErrorInfo ? error : undefined,\n      );\n      this._logger?.error('DefaultServerTransport._handleChannelMessage(); subscription error');\n      this._onError?.(errInfo);\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Turn creation\n  // -------------------------------------------------------------------------\n\n  private _createTurn(turnOpts: NewTurnOptions<TEvent>): Turn<TEvent, TMessage> {\n    const {\n      turnId,\n      clientId: turnClientId,\n      onMessage,\n      onAbort,\n      onCancel,\n      onError: turnOnError,\n      parent: turnParent,\n      forkOf: turnForkOf,\n      signal: externalSignal,\n    } = turnOpts;\n\n    const controller = new AbortController();\n    let state = TurnState.INITIALIZED;\n\n    // Compose the internal controller signal with the external signal (e.g.\n    // req.signal) so platform-level cancellation (request cancellation, function\n    // timeout) aborts the turn through the same path as Ably cancel messages.\n    const signal = externalSignal ? AbortSignal.any([controller.signal, externalSignal]) : controller.signal;\n\n    // Spec: AIT-ST3a — register immediately so early cancels can fire the abort signal.\n    const registration: RegisteredTurn = {\n      turnId,\n      clientId: turnClientId ?? '',\n      controller,\n      signal,\n      onCancel,\n      onError: turnOnError,\n    };\n    this._registeredTurns.set(turnId, registration);\n\n    // Capture instance members as locals so arrow functions close over them\n    // without needing `this` (avoids unicorn/no-this-assignment).\n    const logger = this._logger;\n    const turnManager = this._turnManager;\n    const attachPromise = this._attachPromise;\n    const codec = this._codec;\n    const channel = this._channel;\n    const registeredTurns = this._registeredTurns;\n\n    const turn: Turn<TEvent, TMessage> = {\n      get turnId() {\n        return turnId;\n      },\n      get abortSignal() {\n        return signal;\n      },\n\n      // Spec: AIT-ST4, AIT-ST4a, AIT-ST4b\n      start: async (): Promise<void> => {\n        logger?.trace('Turn.start();', { turnId });\n\n        // Spec: AIT-ST4a\n        if (signal.aborted) {\n          throw new Ably.ErrorInfo(\n            `unable to start turn; turn ${turnId} was cancelled before start()`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        if (state !== TurnState.INITIALIZED) return;\n        state = TurnState.STARTED;\n\n        try {\n          await turnManager.startTurn(turnId, turnClientId, controller, {\n            parent: turnParent,\n            forkOf: turnForkOf,\n          });\n        } catch (error) {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to publish turn-start for turn ${turnId}; ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.TurnLifecycleError,\n            500,\n            error instanceof Ably.ErrorInfo ? error : undefined,\n          );\n          logger?.error('Turn.start(); failed to publish turn-start', { turnId });\n          throw errInfo;\n        }\n\n        logger?.debug('Turn.start(); turn started', { turnId });\n      },\n\n      // Spec: AIT-ST5, AIT-ST5a, AIT-ST5b, AIT-ST5c\n      addMessages: async (nodes: MessageNode<TMessage>[], opts?: AddMessageOptions): Promise<AddMessagesResult> => {\n        logger?.trace('Turn.addMessages();', { turnId, count: nodes.length });\n\n        if (state === TurnState.INITIALIZED) {\n          throw new Ably.ErrorInfo(\n            `unable to add messages; start() must be called before addMessages() (turn ${turnId})`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        await attachPromise;\n\n        const msgIds: string[] = [];\n\n        try {\n          for (const node of nodes) {\n            // Build transport headers from the node's typed fields, then merge\n            // any extra headers from the node (e.g. domain-specific headers).\n            const headers = mergeHeaders(\n              buildTransportHeaders({\n                role: 'user',\n                turnId,\n                msgId: node.msgId,\n                turnClientId: opts?.clientId,\n                parent: node.parentId ?? turnParent,\n                forkOf: node.forkOf ?? turnForkOf,\n              }),\n              node.headers,\n            );\n\n            const encoder = codec.createEncoder(channel, {\n              extras: { headers },\n              onMessage,\n            });\n\n            await encoder.writeMessages([node.message], opts?.clientId ? { clientId: opts.clientId } : undefined);\n\n            msgIds.push(node.msgId);\n          }\n        } catch (error) {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to publish messages for turn ${turnId}; ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.TurnLifecycleError,\n            500,\n            error instanceof Ably.ErrorInfo ? error : undefined,\n          );\n          logger?.error('Turn.addMessages(); publish failed', { turnId });\n          throw errInfo;\n        }\n\n        logger?.debug('Turn.addMessages(); messages published', { turnId, count: nodes.length });\n        return { msgIds };\n      },\n\n      // Spec: AIT-ST5c\n      addEvents: async (nodes: EventsNode<TEvent>[]): Promise<void> => {\n        logger?.trace('Turn.addEvents();', { turnId, count: nodes.length });\n\n        if (state === TurnState.INITIALIZED) {\n          throw new Ably.ErrorInfo(\n            `unable to add events; start() must be called before addEvents() (turn ${turnId})`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        await attachPromise;\n\n        const turnOwnerClientId = turnManager.getClientId(turnId);\n\n        try {\n          for (const node of nodes) {\n            const headers = buildTransportHeaders({\n              role: 'assistant',\n              turnId,\n              msgId: node.msgId,\n              turnClientId: turnOwnerClientId,\n              amend: node.msgId,\n            });\n\n            const encoder = codec.createEncoder(channel, {\n              extras: { headers },\n              onMessage,\n            });\n\n            for (const event of node.events) {\n              await encoder.writeEvent(event);\n            }\n\n            await encoder.close();\n          }\n        } catch (error) {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to publish events for turn ${turnId}; ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.TurnLifecycleError,\n            500,\n            error instanceof Ably.ErrorInfo ? error : undefined,\n          );\n          logger?.error('Turn.addEvents(); publish failed', { turnId });\n          throw errInfo;\n        }\n\n        logger?.debug('Turn.addEvents(); events published', { turnId, count: nodes.length });\n      },\n\n      // Spec: AIT-ST6, AIT-ST6a, AIT-ST6b, AIT-ST6b1, AIT-ST6b2, AIT-ST6b3, AIT-ST6b4, AIT-ST6c\n      streamResponse: async (\n        stream: ReadableStream<TEvent>,\n        streamOpts?: StreamResponseOptions<TEvent>,\n      ): Promise<StreamResult> => {\n        logger?.trace('Turn.streamResponse();', { turnId });\n\n        if (state === TurnState.INITIALIZED) {\n          throw new Ably.ErrorInfo(\n            `unable to stream response; start() must be called before streamResponse() (turn ${turnId})`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        await attachPromise;\n\n        const turnOwnerClientId = turnManager.getClientId(turnId);\n\n        // Per-operation parent overrides the turn-level default.\n        const assistantParent = streamOpts?.parent === undefined ? turnParent : streamOpts.parent;\n\n        const msgId = crypto.randomUUID();\n        const defaultHeaders = buildTransportHeaders({\n          role: 'assistant',\n          turnId,\n          msgId,\n          turnClientId: turnOwnerClientId,\n          parent: assistantParent,\n          forkOf: streamOpts?.forkOf ?? turnForkOf,\n        });\n        const encoder = codec.createEncoder(channel, {\n          extras: { headers: defaultHeaders },\n          onMessage,\n          messageId: msgId,\n        });\n\n        const result = await pipeStream(stream, encoder, signal, onAbort, streamOpts?.resolveWriteOptions, logger);\n\n        if (result.error) {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to stream response for turn ${turnId}; ${result.error.message}`,\n            ErrorCode.StreamError,\n            500,\n            result.error instanceof Ably.ErrorInfo ? result.error : undefined,\n          );\n          logger?.error('Turn.streamResponse(); stream error', { turnId });\n          turnOnError?.(errInfo);\n        }\n\n        logger?.debug('Turn.streamResponse(); stream finished', { turnId, reason: result.reason });\n        return result;\n      },\n\n      // Spec: AIT-ST7, AIT-ST7a, AIT-ST7b\n      end: async (reason: TurnEndReason): Promise<void> => {\n        logger?.trace('Turn.end();', { turnId, reason });\n\n        if (state === TurnState.INITIALIZED) {\n          throw new Ably.ErrorInfo(\n            `unable to end turn; start() must be called before end() (turn ${turnId})`,\n            ErrorCode.InvalidArgument,\n            400,\n          );\n        }\n        if (state === TurnState.ENDED) return;\n        state = TurnState.ENDED;\n\n        try {\n          await turnManager.endTurn(turnId, reason);\n        } catch (error) {\n          const errInfo = new Ably.ErrorInfo(\n            `unable to publish turn-end for turn ${turnId}; ${error instanceof Error ? error.message : String(error)}`,\n            ErrorCode.TurnLifecycleError,\n            500,\n            error instanceof Ably.ErrorInfo ? error : undefined,\n          );\n          logger?.error('Turn.end(); failed to publish turn-end', { turnId });\n          throw errInfo;\n        } finally {\n          registeredTurns.delete(turnId);\n        }\n\n        logger?.debug('Turn.end(); turn ended', { turnId, reason });\n      },\n    };\n\n    return turn;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a server transport bound to the given channel and codec.\n * @param options - Transport configuration.\n * @returns A new {@link ServerTransport} instance.\n */\nexport const createServerTransport = <TEvent, TMessage>(\n  options: ServerTransportOptions<TEvent, TMessage>,\n): ServerTransport<TEvent, TMessage> => new DefaultServerTransport(options);\n","/**\n * Type-safe EventEmitter wrapping Ably's internal EventEmitter.\n *\n * Takes a single `EventsMap` type parameter — an interface mapping event names\n * to payload types — rather than Ably's three type parameters. Adapted from\n * the ably-chat-js SDK.\n *\n * ```ts\n * interface MyEvents {\n *   reaction: { emoji: string };\n *   status: { online: boolean };\n * }\n *\n * const emitter = new EventEmitter<MyEvents>(logger);\n * emitter.on('reaction', (event) => console.log(event.emoji));\n * emitter.emit('reaction', { emoji: '👍' });\n * ```\n */\n\nimport * as Ably from 'ably';\n\nimport type { Logger } from './logger.js';\n\n/** Callback receiving a union of all possible event payloads. */\ntype Callback<EventsMap> = (arg: EventsMap[keyof EventsMap]) => void;\n\n/** Callback receiving the payload for a single event type. */\ntype CallbackSingle<K> = (arg: K) => void;\n\n/**\n * Type-safe interface for the Ably EventEmitter, parameterized by an EventsMap\n * that maps event names to their payload types.\n */\ninterface InterfaceEventEmitter<EventsMap> extends Ably.EventEmitter<Callback<EventsMap>, void, keyof EventsMap> {\n  /** Emit an event with a type-safe payload. Payload is optional for `undefined`-typed events. */\n  emit<K extends keyof EventsMap>(\n    event: K,\n    ...args: EventsMap[K] extends undefined ? [EventsMap[K]?] : [EventsMap[K]]\n  ): void;\n\n  /** Subscribe to a single event with a typed callback. */\n  on<K extends keyof EventsMap>(event: K, callback: CallbackSingle<EventsMap[K]>): void;\n  /** Subscribe to two events with a union-typed callback. */\n  on<K1 extends keyof EventsMap, K2 extends keyof EventsMap>(\n    events: [K1, K2],\n    callback: CallbackSingle<EventsMap[K1] | EventsMap[K2]>,\n  ): void;\n  /** Subscribe to three events with a union-typed callback. */\n  on<K1 extends keyof EventsMap, K2 extends keyof EventsMap, K3 extends keyof EventsMap>(\n    events: [K1, K2, K3],\n    callback: CallbackSingle<EventsMap[K1] | EventsMap[K2] | EventsMap[K3]>,\n  ): void;\n  /** Subscribe to an array of events. */\n  on(events: (keyof EventsMap)[], callback: Callback<EventsMap>): void;\n  /** Subscribe to all events. */\n  on(callback: Callback<EventsMap>): void;\n\n  /** Unsubscribe a callback from a specific event. */\n  off<K extends keyof EventsMap>(event: K, listener: CallbackSingle<EventsMap[K]>): void;\n  /** Unsubscribe a callback from all events, or remove all listeners if no callback provided. */\n  off(listener?: Callback<EventsMap>): void;\n}\n\n/**\n * Bridge from our {@link Logger} to the Ably EventEmitter's internal logger\n * contract. Ably's EventEmitter calls `logger.logAction(level, action, message)`\n * when a listener throws — we route that to our Logger's `error` method.\n * @param logger - The application logger to delegate to.\n * @returns An object satisfying the Ably EventEmitter's logger interface.\n */\nconst toAblyLogger = (logger: Logger): unknown => ({\n  logAction: (_level: number, action: string, message?: string) => {\n    logger.error(action, { detail: message });\n  },\n  shouldLog: () => true,\n});\n\n// CAST: Access Ably's internal EventEmitter constructor. Not publicly exported\n// but available to other Ably SDKs. The logger parameter ensures listener\n// exceptions are caught and logged rather than crashing.\nconst InternalEventEmitter: new <EventsMap>(logger: unknown) => InterfaceEventEmitter<EventsMap> = (\n  Ably.Realtime as unknown as { EventEmitter: new <EventsMap>(logger: unknown) => InterfaceEventEmitter<EventsMap> }\n).EventEmitter;\n\n/**\n * Type-safe EventEmitter based on Ably's internal EventEmitter.\n *\n * Provides the same semantics as {@link Ably.EventEmitter} (error isolation\n * between listeners, synchronous dispatch) but with a single `EventsMap` type\n * parameter for ergonomic type safety.\n *\n * Requires a {@link Logger} so that listener exceptions are routed through\n * the application's logging infrastructure rather than silently swallowed.\n */\nexport class EventEmitter<EventsMap> extends InternalEventEmitter<EventsMap> {\n  /**\n   * Create a new EventEmitter.\n   * @param logger - Application logger. Listener exceptions are logged at error level.\n   */\n  constructor(logger: Logger) {\n    super(toAblyLogger(logger));\n  }\n}\n","import * as Ably from 'ably';\n\nimport { ErrorCode } from './errors.js';\n\n/**\n * Structured logger with leveled output and hierarchical context.\n * Implementations filter messages by level and delegate to a {@link LogHandler}.\n */\nexport interface Logger {\n  /**\n   * Log a message at the trace level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  trace(message: string, context?: LogContext): void;\n\n  /**\n   * Log a message at the debug level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log a message at the info level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a message at the warn level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log a message at the error level.\n   * @param message The message to log.\n   * @param context The context of the log message as key-value pairs.\n   */\n  error(message: string, context?: LogContext): void;\n\n  /**\n   * Creates a new logger with a context that will be merged with any context provided to individual log calls.\n   * The context will be overridden by any matching keys in the individual log call's context.\n   * @param context The context to use for all log calls.\n   * @returns A new logger instance with the context.\n   */\n  withContext(context: LogContext): Logger;\n}\n\n/**\n * Represents the different levels of logging that can be used.\n */\nexport enum LogLevel {\n  /**\n   * Something routine and expected has occurred. This level will provide logs for the vast majority of operations\n   * and function calls.\n   */\n  Trace = 'trace',\n\n  /**\n   * Development information, messages that are useful when trying to debug library behavior,\n   * but superfluous to normal operation.\n   */\n  Debug = 'debug',\n\n  /**\n   * Informational messages. Operationally significant to the library but not out of the ordinary.\n   */\n  Info = 'info',\n\n  /**\n   * Anything that is not immediately an error, but could cause unexpected behavior in the future. For example,\n   * passing an invalid value to an option. Indicates that some action should be taken to prevent future errors.\n   */\n  Warn = 'warn',\n\n  /**\n   * A given operation has failed and cannot be automatically recovered. The error may threaten the continuity\n   * of operation.\n   */\n  Error = 'error',\n\n  /**\n   * No logging will be performed.\n   */\n  Silent = 'silent',\n}\n\n/**\n * Represents the context of a log message.\n * It is an object of key-value pairs that can be used to provide additional context to a log message.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type LogContext = Record<string, any>;\n\n/**\n * A function that can be used to handle log messages.\n * @param message The message to log.\n * @param level The log level of the message.\n * @param context The context of the log message as key-value pairs.\n */\nexport type LogHandler = (message: string, level: LogLevel, context?: LogContext) => void;\n\n/**\n * A simple console logger that logs messages to the console.\n * @param message The message to log.\n * @param level The log level of the message.\n * @param context - The context of the log message as key-value pairs.\n */\nexport const consoleLogger = (message: string, level: LogLevel, context?: LogContext) => {\n  const contextString = context ? `, context: ${JSON.stringify(context)}` : '';\n  const formattedMessage = `[${new Date().toISOString()}] ${level.valueOf().toUpperCase()} ably-ai-transport: ${message}${contextString}`;\n\n  switch (level) {\n    case LogLevel.Trace:\n    case LogLevel.Debug: {\n      console.log(formattedMessage);\n      break;\n    }\n    case LogLevel.Info: {\n      console.info(formattedMessage);\n      break;\n    }\n    case LogLevel.Warn: {\n      console.warn(formattedMessage);\n      break;\n    }\n    case LogLevel.Error: {\n      console.error(formattedMessage);\n      break;\n    }\n    case LogLevel.Silent: {\n      break;\n    }\n  }\n};\n\n/**\n * Options for creating a logger.\n */\nexport interface LoggerOptions {\n  logHandler?: LogHandler;\n  logLevel: LogLevel;\n}\n\nexport const makeLogger = (options: LoggerOptions): Logger => {\n  const logHandler = options.logHandler ?? consoleLogger;\n\n  return new DefaultLogger(logHandler, options.logLevel);\n};\n\n/**\n * A convenient list of log levels as numbers that can be used for easier comparison.\n */\nenum LogLevelNumber {\n  Trace = 0,\n  Debug = 1,\n  Info = 2,\n  Warn = 3,\n  Error = 4,\n  Silent = 5,\n}\n\n/**\n * A mapping of log levels to their numeric equivalents.\n */\nconst logLevelNumberMap = new Map<LogLevel, LogLevelNumber>([\n  [LogLevel.Trace, LogLevelNumber.Trace],\n  [LogLevel.Debug, LogLevelNumber.Debug],\n  [LogLevel.Info, LogLevelNumber.Info],\n  [LogLevel.Warn, LogLevelNumber.Warn],\n  [LogLevel.Error, LogLevelNumber.Error],\n  [LogLevel.Silent, LogLevelNumber.Silent],\n]);\n\n/**\n * A default logger implementation.\n */\nclass DefaultLogger implements Logger {\n  private readonly _handler: LogHandler;\n  private readonly _levelNumber: LogLevelNumber;\n  private readonly _context?: LogContext;\n\n  constructor(handler: LogHandler, level: LogLevel, context?: LogContext) {\n    this._handler = handler;\n    this._context = context;\n\n    const levelNumber = logLevelNumberMap.get(level);\n    if (levelNumber === undefined) {\n      throw new Ably.ErrorInfo(`unable to create logger; invalid log level: ${level}`, ErrorCode.InvalidArgument, 400);\n    }\n\n    this._levelNumber = levelNumber;\n  }\n\n  trace(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Trace, LogLevelNumber.Trace, context);\n  }\n\n  debug(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Debug, LogLevelNumber.Debug, context);\n  }\n\n  info(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Info, LogLevelNumber.Info, context);\n  }\n\n  warn(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Warn, LogLevelNumber.Warn, context);\n  }\n\n  error(message: string, context?: LogContext): void {\n    this._write(message, LogLevel.Error, LogLevelNumber.Error, context);\n  }\n\n  withContext(context: LogContext): Logger {\n    // Get the original log level by finding the key in logLevelNumberMap that matches this._levelNumber\n    const originalLevel =\n      [...logLevelNumberMap.entries()].find(([, value]) => value === this._levelNumber)?.[0] ?? LogLevel.Error;\n\n    return new DefaultLogger(this._handler, originalLevel, this._mergeContext(context));\n  }\n\n  private _write(message: string, level: LogLevel, levelNumber: LogLevelNumber, context?: LogContext): void {\n    if (levelNumber >= this._levelNumber) {\n      this._handler(message, level, this._mergeContext(context));\n    }\n  }\n\n  private _mergeContext(context?: LogContext): LogContext | undefined {\n    if (!this._context) {\n      return context ?? undefined;\n    }\n\n    return context ? { ...this._context, ...context } : this._context;\n  }\n}\n","/**\n * Client-side stream routing.\n *\n * Maintains a map of turnId to ReadableStreamController. Routes decoded events\n * to the correct stream. Closes streams on terminal events, explicit close, or\n * error.\n */\n\nimport * as Ably from 'ably';\n\nimport { ErrorCode } from '../../errors.js';\nimport type { Logger } from '../../logger.js';\nimport type { TurnEntry } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Interface\n// ---------------------------------------------------------------------------\n\n/** Routes decoded events to the correct turn's ReadableStream. */\nexport interface StreamRouter<TEvent> {\n  /** Register a new stream for a turnId. Returns the ReadableStream the consumer reads from. */\n  createStream(turnId: string): ReadableStream<TEvent>;\n  /** Close the stream for a turnId. Returns true if a stream existed. */\n  closeStream(turnId: string): boolean;\n  /** Error the stream for a turnId. The consumer's reader will reject with the given error. Returns true if a stream existed. */\n  errorStream(turnId: string, error: Ably.ErrorInfo): boolean;\n  /** Enqueue an event to the correct stream. Returns true if routed successfully. */\n  route(turnId: string, event: TEvent): boolean;\n  /** Whether a specific turnId has an active stream. */\n  has(turnId: string): boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CT14\nclass DefaultStreamRouter<TEvent> implements StreamRouter<TEvent> {\n  private readonly _turns = new Map<string, TurnEntry<TEvent>>();\n  private readonly _isTerminal: (event: TEvent) => boolean;\n  private readonly _logger: Logger;\n\n  constructor(isTerminal: (event: TEvent) => boolean, logger: Logger) {\n    this._isTerminal = isTerminal;\n    this._logger = logger;\n  }\n\n  createStream(turnId: string): ReadableStream<TEvent> {\n    this._logger.trace('StreamRouter.createStream();', { turnId });\n\n    // Build stream+controller together. ReadableStream's start() runs synchronously\n    // per spec, so the controller is captured before the constructor returns.\n    const entry: { controller?: ReadableStreamDefaultController<TEvent> } = {};\n    const stream = new ReadableStream<TEvent>({\n      start(controller) {\n        entry.controller = controller;\n      },\n    });\n    if (!entry.controller) {\n      throw new Ably.ErrorInfo(\n        'unable to create stream; ReadableStream start() was not called synchronously',\n        ErrorCode.TransportSubscriptionError,\n        500,\n      );\n    }\n    this._turns.set(turnId, { controller: entry.controller, turnId });\n    return stream;\n  }\n\n  // Spec: AIT-CT14b\n  closeStream(turnId: string): boolean {\n    const turn = this._turns.get(turnId);\n    if (!turn) return false;\n\n    this._logger.debug('StreamRouter.closeStream(); closing stream', { turnId });\n    try {\n      turn.controller.close();\n    } catch {\n      /* consumer cancelled the stream */\n    }\n    this._turns.delete(turnId);\n    return true;\n  }\n\n  // Spec: AIT-CT14c\n  errorStream(turnId: string, error: Ably.ErrorInfo): boolean {\n    const turn = this._turns.get(turnId);\n    if (!turn) return false;\n\n    this._logger.debug('StreamRouter.errorStream(); erroring stream', { turnId });\n    try {\n      turn.controller.error(error);\n    } catch {\n      /* consumer cancelled the stream */\n    }\n    this._turns.delete(turnId);\n    return true;\n  }\n\n  // Spec: AIT-CT14a\n  route(turnId: string, event: TEvent): boolean {\n    const turn = this._turns.get(turnId);\n    if (!turn) return false;\n\n    try {\n      turn.controller.enqueue(event);\n    } catch {\n      this._turns.delete(turnId);\n      return false;\n    }\n\n    if (this._isTerminal(event)) {\n      this.closeStream(turnId);\n    }\n    return true;\n  }\n\n  has(turnId: string): boolean {\n    return this._turns.has(turnId);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a StreamRouter that routes decoded events to per-turn ReadableStreams.\n * @param isTerminal - Predicate that returns true for events that close the stream.\n * @param logger - Logger for diagnostic output.\n * @returns A new {@link StreamRouter} instance.\n */\nexport const createStreamRouter = <TEvent>(\n  isTerminal: (event: TEvent) => boolean,\n  logger: Logger,\n): StreamRouter<TEvent> => new DefaultStreamRouter(isTerminal, logger);\n","/**\n * Tree — materializes a branching conversation from a flat\n * oplog of Ably messages using serial-first ordering.\n *\n * Serial order (the total order assigned by Ably) is the primary mechanism\n * for linear message sequences. `x-ably-parent` and `x-ably-fork-of` headers\n * are only structurally meaningful at branch points — where the user is\n * interacting with a visible message and the client always has it loaded.\n *\n * `upsert()` is the sole mutation method. Messages can arrive in any order\n * (live subscription, history pages, seed data) and the tree produces the\n * correct `flattenNodes()` output once all messages are present.\n *\n * The tree owns conversation state. `flattenNodes()` returns the linear node\n * list for the currently selected branches — this is what the transport's\n * `getMessages()` delegates to.\n */\n\nimport type * as Ably from 'ably';\n\nimport { HEADER_FORK_OF, HEADER_PARENT } from '../../constants.js';\nimport { EventEmitter } from '../../event-emitter.js';\nimport type { Logger } from '../../logger.js';\nimport type { MessageNode, Tree, TurnLifecycleEvent } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Internal node type\n// ---------------------------------------------------------------------------\n\ninterface InternalNode<TMessage> {\n  node: MessageNode<TMessage>;\n  /** Insertion sequence — tiebreaker for null-serial messages. */\n  insertSeq: number;\n}\n\n// ---------------------------------------------------------------------------\n// Internal interface — extended surface consumed by View\n// ---------------------------------------------------------------------------\n\n/** Internal tree surface used by View — not part of the public Tree API. */\nexport interface TreeInternal<TMessage> extends Tree<TMessage> {\n  /**\n   * Monotonic counter that increments on structural changes (node insert,\n   * delete, serial promotion/reorder) but NOT on content-only updates\n   * (existing node's message replaced). Allows the View to skip full\n   * tree walks when only message content changed.\n   */\n  readonly structuralVersion: number;\n\n  /**\n   * Flatten the tree along selected branches into a linear node list.\n   * The `selections` map provides the selected sibling's msgId at each\n   * fork point, keyed by group root msgId. Fork points not present in\n   * the map default to the latest sibling. If a selectedMsgId is not\n   * found in the sibling group (stale/deleted), falls back to latest.\n   */\n  flattenNodes(selections: Map<string, string>): MessageNode<TMessage>[];\n\n  /**\n   * Get the \"group root\" msgId for a sibling group — the original message\n   * that all forks in the group trace back to.\n   */\n  getGroupRoot(msgId: string): string;\n\n  /**\n   * Get the sibling group that `msgId` belongs to, as full MessageNode objects.\n   * Allows callers to resolve index ↔ msgId without losing identity.\n   */\n  getSiblingNodes(msgId: string): MessageNode<TMessage>[];\n\n  /** Forward a raw Ably message event to tree subscribers. */\n  emitAblyMessage(msg: Ably.InboundMessage): void;\n  /** Forward a turn lifecycle event to tree subscribers. */\n  emitTurn(event: TurnLifecycleEvent): void;\n  /** Register an active turn. */\n  trackTurn(turnId: string, clientId: string): void;\n  /** Unregister an active turn. */\n  untrackTurn(turnId: string): void;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n/** EventEmitter events map for the tree. */\ninterface TreeEventsMap {\n  update: undefined;\n  'ably-message': Ably.InboundMessage;\n  turn: TurnLifecycleEvent;\n}\n\n// Spec: AIT-CT13\nexport class DefaultTree<TMessage> implements TreeInternal<TMessage> {\n  /** All nodes indexed by msgId (x-ably-msg-id). */\n  private readonly _nodeIndex = new Map<string, InternalNode<TMessage>>();\n\n  /**\n   * All nodes sorted by serial (lexicographic). Null-serial messages\n   * (optimistic inserts, seed data) sort after all serial-bearing messages,\n   * ordered among themselves by insertion sequence.\n   */\n  private readonly _sortedList: InternalNode<TMessage>[] = [];\n\n  /**\n   * Parent index: parentId to set of child msgIds.\n   * Nodes with no parent are indexed under the key `null`.\n   */\n  private readonly _parentIndex = new Map<string | undefined, Set<string>>();\n\n  private readonly _emitter: EventEmitter<TreeEventsMap>;\n  private readonly _logger: Logger;\n\n  /** Active turns: turnId → clientId. */\n  private readonly _turnClientIds = new Map<string, string>();\n\n  /** Monotonically increasing counter for insertion sequence. */\n  private _seqCounter = 0;\n\n  /** Incremented on structural changes; unchanged on content-only updates. */\n  private _structuralVersion = 0;\n\n  get structuralVersion(): number {\n    return this._structuralVersion;\n  }\n\n  constructor(logger: Logger) {\n    this._logger = logger;\n    this._emitter = new EventEmitter<TreeEventsMap>(logger);\n  }\n\n  // -------------------------------------------------------------------------\n  // Sorted list maintenance\n  // -------------------------------------------------------------------------\n\n  /**\n   * Compare two nodes for sorted list ordering.\n   * Serial-bearing nodes sort by serial (lexicographic).\n   * Null-serial nodes sort after all serial-bearing nodes.\n   * Among null-serial nodes, sort by insertion sequence.\n   * @param a - First node to compare.\n   * @param b - Second node to compare.\n   * @returns Negative if a sorts before b, positive if after, zero if equal.\n   */\n  // Spec: AIT-CT13a\n  private _compareNodes(a: InternalNode<TMessage>, b: InternalNode<TMessage>): number {\n    const sa = a.node.serial;\n    const sb = b.node.serial;\n    if (sa === undefined && sb === undefined) return a.insertSeq - b.insertSeq;\n    if (sa === undefined) return 1; // a sorts after serial-bearing b\n    if (sb === undefined) return -1; // b sorts after serial-bearing a\n    if (sa < sb) return -1;\n    if (sa > sb) return 1;\n    return a.insertSeq - b.insertSeq; // same serial: preserve insertion order\n  }\n\n  /**\n   * Insert a node into sortedList at the correct position via binary search.\n   * @param internal - The node to insert.\n   */\n  private _insertSorted(internal: InternalNode<TMessage>): void {\n    const serial = internal.node.serial;\n\n    // Fast path: null-serial always appends to end (among other null-serials)\n    if (serial === undefined) {\n      this._sortedList.push(internal);\n      return;\n    }\n\n    // Binary search for insertion point among serial-bearing nodes.\n    let lo = 0;\n    let hi = this._sortedList.length;\n    while (lo < hi) {\n      const mid = (lo + hi) >>> 1;\n      const midNode = this._sortedList[mid];\n      if (!midNode) break; // unreachable: mid is always in bounds\n      if (this._compareNodes(midNode, internal) <= 0) {\n        lo = mid + 1;\n      } else {\n        hi = mid;\n      }\n    }\n    this._sortedList.splice(lo, 0, internal);\n  }\n\n  /**\n   * Remove a node from sortedList.\n   * @param internal - The node to remove.\n   */\n  private _removeSorted(internal: InternalNode<TMessage>): void {\n    const idx = this._sortedList.indexOf(internal);\n    if (idx !== -1) this._sortedList.splice(idx, 1);\n  }\n\n  // -------------------------------------------------------------------------\n  // Parent index maintenance\n  // -------------------------------------------------------------------------\n\n  private _addToParentIndex(parentId: string | undefined, msgId: string): void {\n    let set = this._parentIndex.get(parentId);\n    if (!set) {\n      set = new Set();\n      this._parentIndex.set(parentId, set);\n    }\n    set.add(msgId);\n  }\n\n  private _removeFromParentIndex(parentId: string | undefined, msgId: string): void {\n    const set = this._parentIndex.get(parentId);\n    if (set) {\n      set.delete(msgId);\n      if (set.size === 0) this._parentIndex.delete(parentId);\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Sibling grouping\n  // -------------------------------------------------------------------------\n\n  /**\n   * Get the sibling group that `msgId` belongs to.\n   *\n   * A sibling group is: the original message + all messages whose `forkOf`\n   * points to the original (or transitively to a sibling). We find the\n   * group root by following `forkOf` chains to the earliest ancestor that\n   * has no `forkOf` (or whose `forkOf` target doesn't share the same parent).\n   * @param msgId - The msg-id to look up the sibling group for.\n   * @returns The ordered list of sibling nodes.\n   */\n  // Spec: AIT-CT13b\n  private _getSiblingGroup(msgId: string): MessageNode<TMessage>[] {\n    const entry = this._nodeIndex.get(msgId);\n    if (!entry) return [];\n\n    // Find the \"original\" — the message at the root of the fork chain\n    // that shares the same parentId. Guard against cycles in forkOf chains.\n    let original = entry.node;\n    const visitedGroup = new Set<string>([original.msgId]);\n    while (original.forkOf) {\n      if (visitedGroup.has(original.forkOf)) break; // cycle guard\n      const forkTarget = this._nodeIndex.get(original.forkOf);\n      if (!forkTarget || forkTarget.node.parentId !== original.parentId) break;\n      original = forkTarget.node;\n      visitedGroup.add(original.msgId);\n    }\n\n    // Collect all siblings: nodes with the same parentId that either\n    // ARE the original, or have a forkOf chain leading to the original.\n    const parentId = original.parentId;\n    const originalId = original.msgId;\n    const siblings: InternalNode<TMessage>[] = [];\n\n    const candidateIds = this._parentIndex.get(parentId);\n    if (candidateIds) {\n      for (const childId of candidateIds) {\n        const childEntry = this._nodeIndex.get(childId);\n        if (childEntry && this._isSiblingOf(childEntry.node, originalId)) {\n          siblings.push(childEntry);\n        }\n      }\n    }\n\n    // Sort by Ably serial (lexicographic). Messages without a serial\n    // (optimistic inserts before server relay) sort after all serial-bearing\n    // siblings — they represent the user's most recent action.\n    siblings.sort((a, b) => this._compareNodes(a, b));\n    return siblings.map((s) => s.node);\n  }\n\n  /**\n   * Check if `node` belongs to the sibling group rooted at `originalId`.\n   * A node is a sibling if it IS the original or its forkOf chain leads\n   * to the original (with the same parentId).\n   * @param node - The node to check.\n   * @param originalId - The group root to match against.\n   * @returns True if the node belongs to the sibling group.\n   */\n  private _isSiblingOf(node: MessageNode<TMessage>, originalId: string): boolean {\n    if (node.msgId === originalId) return true;\n    let current = node;\n    const visited = new Set<string>([current.msgId]);\n    while (current.forkOf) {\n      if (current.forkOf === originalId) return true;\n      if (visited.has(current.forkOf)) break; // cycle guard\n      const target = this._nodeIndex.get(current.forkOf);\n      if (!target) break;\n      current = target.node;\n      visited.add(current.msgId);\n    }\n    return false;\n  }\n\n  /**\n   * Get the \"group root\" msgId for a sibling group — the original message\n   * that all forks trace back to.\n   * @param msgId - Any msg-id in the sibling group.\n   * @returns The msg-id of the group root.\n   */\n  getGroupRoot(msgId: string): string {\n    const entry = this._nodeIndex.get(msgId);\n    if (!entry) return msgId;\n\n    let current = entry.node;\n    const visited = new Set<string>([current.msgId]);\n    while (current.forkOf) {\n      if (visited.has(current.forkOf)) break; // cycle guard\n      const forkTarget = this._nodeIndex.get(current.forkOf);\n      if (!forkTarget || forkTarget.node.parentId !== current.parentId) break;\n      current = forkTarget.node;\n      visited.add(current.msgId);\n    }\n    return current.msgId;\n  }\n\n  // -------------------------------------------------------------------------\n  // Public query methods\n  // -------------------------------------------------------------------------\n\n  flattenNodes(selections: Map<string, string>): MessageNode<TMessage>[] {\n    this._logger.trace('DefaultTree.flattenNodes();');\n    const result: MessageNode<TMessage>[] = [];\n    const currentPath = new Set<string>();\n    // Track which sibling groups we've already resolved to avoid\n    // re-resolving for every member of the group.\n    const resolvedGroups = new Map<string, string>(); // groupRootId → selected msgId\n\n    for (const internal of this._sortedList) {\n      const node = internal.node;\n      const { msgId, parentId } = node;\n\n      // Step 1: Check parent reachability.\n      if (parentId !== undefined && !currentPath.has(parentId)) {\n        continue;\n      }\n\n      // Step 2: Check sibling selection.\n      const group = this._getSiblingGroup(msgId);\n      if (group.length > 1) {\n        const groupRootId = this.getGroupRoot(msgId);\n        let selectedId = resolvedGroups.get(groupRootId);\n        if (selectedId === undefined) {\n          const preferredId = selections.get(groupRootId);\n          // Verify the preferred msgId is in the group, otherwise default to latest\n          if (preferredId && group.some((n) => n.msgId === preferredId)) {\n            selectedId = preferredId;\n          } else {\n            const latest = group.at(-1);\n            if (!latest) break; // unreachable: group.length > 1\n            selectedId = latest.msgId;\n          }\n          resolvedGroups.set(groupRootId, selectedId);\n        }\n        if (msgId !== selectedId) {\n          continue;\n        }\n      }\n\n      currentPath.add(msgId);\n      result.push(node);\n    }\n\n    return result;\n  }\n\n  getSiblings(msgId: string): TMessage[] {\n    this._logger.trace('DefaultTree.getSiblings();', { msgId });\n    return this._getSiblingGroup(msgId).map((n) => n.message);\n  }\n\n  getSiblingNodes(msgId: string): MessageNode<TMessage>[] {\n    return this._getSiblingGroup(msgId);\n  }\n\n  hasSiblings(msgId: string): boolean {\n    return this._getSiblingGroup(msgId).length > 1;\n  }\n\n  getNode(msgId: string): MessageNode<TMessage> | undefined {\n    this._logger.trace('DefaultTree.getNode();', { msgId });\n    return this._nodeIndex.get(msgId)?.node;\n  }\n\n  getHeaders(msgId: string): Record<string, string> | undefined {\n    this._logger.trace('DefaultTree.getHeaders();', { msgId });\n    return this._nodeIndex.get(msgId)?.node.headers;\n  }\n\n  // -------------------------------------------------------------------------\n  // Mutation\n  // -------------------------------------------------------------------------\n\n  upsert(msgId: string, message: TMessage, headers: Record<string, string>, serial?: string): void {\n    const parentId = headers[HEADER_PARENT] ?? undefined;\n    const forkOf = headers[HEADER_FORK_OF] ?? undefined;\n\n    const existing = this._nodeIndex.get(msgId);\n    if (existing) {\n      // Update in place — message content may have changed (e.g. streaming).\n      // Only update headers if the new headers are non-empty (prevents\n      // streaming updates from erasing canonical headers).\n      existing.node.message = message;\n      if (Object.keys(headers).length > 0) {\n        existing.node.headers = { ...headers };\n      }\n      // Spec: AIT-CT13d\n      // Promote serial: optimistic (null) → server-assigned on relay.\n      if (serial && !existing.node.serial) {\n        this._logger.debug('Tree.upsert(); promoting serial', { msgId, serial });\n        existing.node.serial = serial;\n        // Re-sort: remove from current position, re-insert at correct position.\n        this._removeSorted(existing);\n        this._insertSorted(existing);\n        this._structuralVersion++;\n      }\n      this._emitter.emit('update');\n      return;\n    }\n\n    this._logger.trace('Tree.upsert(); inserting new node', { msgId, parentId, forkOf });\n\n    const node: MessageNode<TMessage> = {\n      kind: 'message',\n      message,\n      msgId,\n      parentId,\n      forkOf,\n      headers: { ...headers },\n      serial,\n    };\n\n    const internal: InternalNode<TMessage> = { node, insertSeq: this._seqCounter++ };\n    this._nodeIndex.set(msgId, internal);\n    this._addToParentIndex(parentId, msgId);\n    this._insertSorted(internal);\n    this._structuralVersion++;\n    this._emitter.emit('update');\n  }\n\n  delete(msgId: string): void {\n    const entry = this._nodeIndex.get(msgId);\n    if (!entry) return;\n\n    this._logger.debug('Tree.delete();', { msgId });\n\n    const { node } = entry;\n\n    // Remove from parent index\n    this._removeFromParentIndex(node.parentId, msgId);\n\n    // Remove from sorted list\n    this._removeSorted(entry);\n\n    // Remove from primary index\n    this._nodeIndex.delete(msgId);\n\n    // Children are NOT deleted — they become unreachable in flattenNodes()\n    // because their parent is no longer on the active path.\n    this._structuralVersion++;\n    this._emitter.emit('update');\n  }\n\n  // -------------------------------------------------------------------------\n  // Events\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CT17\n  getActiveTurnIds(): Map<string, Set<string>> {\n    this._logger.trace('DefaultTree.getActiveTurnIds();');\n    const result = new Map<string, Set<string>>();\n    for (const [turnId, clientId] of this._turnClientIds) {\n      let set = result.get(clientId);\n      if (!set) {\n        set = new Set<string>();\n        result.set(clientId, set);\n      }\n      set.add(turnId);\n    }\n    return result;\n  }\n\n  // Spec: AIT-CT8b, AIT-CT8e\n  on(event: 'update', handler: () => void): () => void;\n  on(event: 'ably-message', handler: (msg: Ably.InboundMessage) => void): () => void;\n  on(event: 'turn', handler: (event: TurnLifecycleEvent) => void): () => void;\n  on(\n    event: 'update' | 'ably-message' | 'turn',\n    handler: (() => void) | ((msg: Ably.InboundMessage) => void) | ((event: TurnLifecycleEvent) => void),\n  ): () => void {\n    // CAST: overload signatures enforce correct handler types per event name.\n    const cb = handler as (arg: TreeEventsMap[keyof TreeEventsMap]) => void;\n    this._emitter.on(event, cb);\n    return () => {\n      this._emitter.off(event, cb);\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Internal methods (called by the transport, not part of Tree interface)\n  // -------------------------------------------------------------------------\n\n  /**\n   * Forward a raw Ably message event to tree subscribers.\n   * @param msg - The raw Ably message to emit.\n   */\n  emitAblyMessage(msg: Ably.InboundMessage): void {\n    this._logger.trace('DefaultTree.emitAblyMessage();');\n    this._emitter.emit('ably-message', msg);\n  }\n\n  /**\n   * Forward a turn lifecycle event to tree subscribers.\n   * @param event - The turn lifecycle event to emit.\n   */\n  emitTurn(event: TurnLifecycleEvent): void {\n    this._logger.trace('DefaultTree.emitTurn();', { turnId: event.turnId });\n    this._emitter.emit('turn', event);\n  }\n\n  /**\n   * Register an active turn.\n   * @param turnId - The turn's unique identifier.\n   * @param clientId - The client that owns the turn.\n   */\n  trackTurn(turnId: string, clientId: string): void {\n    this._logger.trace('DefaultTree.trackTurn();', { turnId, clientId });\n    this._turnClientIds.set(turnId, clientId);\n  }\n\n  /**\n   * Unregister an active turn.\n   * @param turnId - The turn to untrack.\n   */\n  untrackTurn(turnId: string): void {\n    this._logger.trace('DefaultTree.untrackTurn();', { turnId });\n    this._turnClientIds.delete(turnId);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a Tree that materializes branching history from a flat oplog.\n * @param logger - Logger for diagnostic output.\n * @returns A new {@link DefaultTree} instance. The transport uses DefaultTree\n *   directly for internal methods (emitAblyMessage, emitTurn, trackTurn, untrackTurn).\n *   Public consumers see the narrower {@link Tree} interface.\n */\nexport const createTree = <TMessage>(logger: Logger): DefaultTree<TMessage> => new DefaultTree(logger);\n","/**\n * decodeHistory — load conversation history from an Ably channel and\n * return decoded messages as a paginated HistoryPage result.\n *\n * Uses a fresh decoder (not shared with the live subscription) to avoid\n * state conflicts. Per-turn accumulators handle interleaved turns correctly.\n *\n * The `limit` option controls the number of **messages** returned,\n * not the number of Ably wire messages fetched. The implementation pages\n * back through Ably history until `limit` complete messages have\n * been assembled. Partial turns (incomplete at the page boundary) are\n * buffered internally and completed when `next()` fetches more pages.\n *\n * Only completed messages appear in `items`. A message is complete when\n * its terminal event (finish/abort/error) has been received.\n *\n * Because Ably history returns newest-first while the decoder requires\n * chronological order, all collected Ably messages are re-decoded from\n * oldest to newest at the point a result is built. This handles turns\n * that span page boundaries correctly. The fetch loop uses a cheap\n * header-based completion counter to decide when to stop paging, so the\n * full decode runs exactly once per traversal regardless of page count.\n */\n\nimport type * as Ably from 'ably';\n\nimport {\n  HEADER_AMEND,\n  HEADER_DISCRETE,\n  HEADER_MSG_ID,\n  HEADER_STATUS,\n  HEADER_STREAM,\n  HEADER_TURN_ID,\n} from '../../constants.js';\nimport type { Logger } from '../../logger.js';\nimport { getHeaders } from '../../utils.js';\nimport type { Codec, DecoderOutput, MessageAccumulator } from '../codec/types.js';\nimport type { HistoryPage, LoadHistoryOptions } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Shared state across pages within one history traversal\n// ---------------------------------------------------------------------------\n\ninterface HistoryState<TEvent, TMessage> {\n  codec: Codec<TEvent, TMessage>;\n  /** All raw Ably messages collected so far, in newest-first order (as received from Ably). */\n  rawMessages: Ably.InboundMessage[];\n  /** How many completed messages have been returned to the consumer so far. */\n  returnedCount: number;\n  /** How many raw Ably messages have been returned to the consumer so far. */\n  returnedRawCount: number;\n  /** The last Ably page cursor for continued pagination. */\n  lastAblyPage: Ably.PaginatedResult<Ably.InboundMessage> | undefined;\n  /**\n   * Cached result of the last {@link decodeAll} call, reused while\n   * `rawMessages` is unchanged. Invalidated implicitly by comparing\n   * {@link cachedAtRawLength} against `rawMessages.length`; `rawMessages`\n   * is append-only within a traversal so length is a sufficient key.\n   */\n  cachedDecode: DecodedItem<TMessage>[] | undefined;\n  /** `rawMessages.length` at the time {@link cachedDecode} was produced. */\n  cachedAtRawLength: number;\n  /**\n   * `x-ably-msg-id`s for which the decoder has something to produce output\n   * from: any `message.create` / `message.update` / `message.append` with\n   * `x-ably-stream: \"true\"` (establishes a tracker via create or\n   * first-contact), or a `message.create` carrying `x-ably-discrete` (a\n   * discrete message, created and terminated in one wire message).\n   */\n  startedMsgIds: Set<string>;\n  /**\n   * `x-ably-msg-id`s with a terminal wire signal: either `x-ably-discrete`\n   * on a `message.create` (discrete message) or `x-ably-status: \"finished\"`\n   * / `\"aborted\"` on any action (closed stream).\n   */\n  terminatedMsgIds: Set<string>;\n  /**\n   * `x-ably-msg-id`s that are both started AND terminated - ready to appear\n   * in the decoded output. The fetch loop reads this set's size to decide\n   * when to stop paging, avoiding a full decode per page. Maintained\n   * incrementally by {@link countNewCompletions}. Grows monotonically.\n   */\n  completedMsgIds: Set<string>;\n  logger: Logger;\n}\n\n/** A completed message paired with its canonical wire headers and serial. */\ninterface DecodedItem<TMessage> {\n  message: TMessage;\n  headers: Record<string, string>;\n  /** Ably serial from the first Ably message for this domain message. */\n  serial: string;\n}\n\n// ---------------------------------------------------------------------------\n// Decode all collected messages from scratch (chronological order)\n// ---------------------------------------------------------------------------\n\n/**\n * Re-decode all collected raw messages into completed domain messages.\n * @param state - The shared history traversal state.\n * @returns Completed messages in newest-first order.\n */\nconst decodeAll = <TEvent, TMessage>(state: HistoryState<TEvent, TMessage>): DecodedItem<TMessage>[] => {\n  // Reverse to chronological (oldest first)\n  const chronological = [...state.rawMessages].toReversed();\n\n  // Fresh decoder and per-turn accumulators for each full re-decode.\n  const decoder = state.codec.createDecoder();\n  const turns = new Map<\n    string,\n    {\n      accumulator: MessageAccumulator<TEvent, TMessage>;\n      firstSeen: number;\n      /** Headers from the first Ably message per x-ably-msg-id within this turn. */\n      msgHeaders: Map<string, Record<string, string>>;\n      /** Ably serial from the first Ably message per x-ably-msg-id within this turn. */\n      msgSerials: Map<string, string>;\n    }\n  >();\n  const defaultAccumulator = state.codec.createAccumulator();\n  let orderCounter = 0;\n\n  // Headers and serials for non-turn discrete messages, keyed by x-ably-msg-id.\n  const discreteHeaders = new Map<string, Record<string, string>>();\n  const discreteSerials = new Map<string, string>();\n  // Track which msgId produced each non-turn discrete message output (in order).\n  const discreteMsgIds: string[] = [];\n\n  // Cross-turn event targets to complete after all events are processed.\n  // Deferred so that finish/abort events that follow the update in serial\n  // order can still process on the active message (e.g. applying messageMetadata).\n  const deferredCompletions: { accumulator: MessageAccumulator<TEvent, TMessage>; messageId: string }[] = [];\n\n  for (const msg of chronological) {\n    const outputs: DecoderOutput<TEvent, TMessage>[] = decoder.decode(msg);\n    const headers = getHeaders(msg);\n    const turnId = headers[HEADER_TURN_ID];\n    const msgId = headers[HEADER_MSG_ID];\n    const serial = msg.serial;\n    const amendTarget = headers[HEADER_AMEND];\n\n    // Cross-turn events target an existing message from a different turn.\n    // Route to the owning turn's accumulator via initMessage lifecycle.\n    if (amendTarget) {\n      for (const turn of turns.values()) {\n        if (turn.msgHeaders.has(amendTarget)) {\n          const headerKeys = [...turn.msgHeaders.keys()];\n          const msgIndex = headerKeys.indexOf(amendTarget);\n          const currentMsg = msgIndex === -1 ? undefined : turn.accumulator.messages[msgIndex];\n          if (currentMsg) {\n            turn.accumulator.initMessage(amendTarget, currentMsg);\n          }\n          turn.accumulator.processOutputs(outputs);\n          deferredCompletions.push({ accumulator: turn.accumulator, messageId: amendTarget });\n          break;\n        }\n      }\n      continue;\n    }\n\n    if (turnId) {\n      let turn = turns.get(turnId);\n      if (!turn) {\n        turn = {\n          accumulator: state.codec.createAccumulator(),\n          firstSeen: orderCounter++,\n          msgHeaders: new Map(),\n          msgSerials: new Map(),\n        };\n        turns.set(turnId, turn);\n      }\n      // Capture headers per msg-id within this turn. Update on later\n      // messages too (e.g. closing append overrides status from\n      // \"streaming\" to \"finished\"/\"aborted\"). Only merge when the\n      // incoming message has non-empty headers.\n      if (msgId) {\n        const existing = turn.msgHeaders.get(msgId);\n        if (!existing) {\n          turn.msgHeaders.set(msgId, { ...headers });\n          if (serial) turn.msgSerials.set(msgId, serial);\n        } else if (Object.keys(headers).length > 0) {\n          Object.assign(existing, headers);\n        }\n      }\n      turn.accumulator.processOutputs(outputs);\n    } else {\n      defaultAccumulator.processOutputs(outputs);\n\n      // Capture headers and serial for non-turn discrete messages by x-ably-msg-id.\n      for (const output of outputs) {\n        if (output.kind === 'message' && msgId) {\n          discreteMsgIds.push(msgId);\n          const existingDiscrete = discreteHeaders.get(msgId);\n          if (!existingDiscrete) {\n            discreteHeaders.set(msgId, { ...headers });\n            if (serial) discreteSerials.set(msgId, serial);\n          } else if (Object.keys(headers).length > 0) {\n            Object.assign(existingDiscrete, headers);\n          }\n        }\n      }\n    }\n  }\n\n  // Complete any messages that were re-activated for cross-turn updates.\n  // Idempotent — if finish already removed the message from active tracking,\n  // completeMessage is a no-op.\n  for (const { accumulator, messageId } of deferredCompletions) {\n    accumulator.completeMessage(messageId);\n  }\n\n  // Collect completed messages in chronological order (oldest first) by turn.\n  const completed: DecodedItem<TMessage>[] = [];\n\n  // Default accumulator messages: pair with their discrete headers by position.\n  for (const [i, msg] of defaultAccumulator.completedMessages.entries()) {\n    const mid = discreteMsgIds[i];\n    completed.push({\n      message: msg,\n      headers: mid ? (discreteHeaders.get(mid) ?? {}) : {},\n      serial: mid ? (discreteSerials.get(mid) ?? '') : '',\n    });\n  }\n\n  const sorted = [...turns.values()].toSorted((a, b) => a.firstSeen - b.firstSeen);\n  for (const turn of sorted) {\n    // Assign headers and serials to each completed message in this turn.\n    // The turn's msgHeaders map is keyed by x-ably-msg-id and ordered by\n    // first-seen. Completed messages are matched positionally.\n    const headerEntries = [...turn.msgHeaders.entries()];\n    let headerIdx = 0;\n\n    for (const msg of turn.accumulator.completedMessages) {\n      const entry = headerEntries[headerIdx];\n      if (entry) {\n        const [mid, hdrs] = entry;\n        completed.push({\n          message: msg,\n          headers: hdrs,\n          serial: turn.msgSerials.get(mid) ?? '',\n        });\n        headerIdx++;\n      } else {\n        completed.push({ message: msg, headers: {}, serial: '' });\n      }\n    }\n  }\n\n  // Reverse to newest-first. The consumer slices from the front for the\n  // most recent page, and progressively deeper for older pages.\n  return completed.toReversed();\n};\n\n/**\n * Cached wrapper around {@link decodeAll}. Returns the previous result when\n * `rawMessages` hasn't changed since the last decode; otherwise re-decodes\n * and updates the cache. The cache key is `rawMessages.length` because\n * `rawMessages` is append-only within a traversal.\n * @param state - The shared history traversal state.\n * @returns Completed messages in newest-first order.\n */\nconst decodeAllCached = <TEvent, TMessage>(state: HistoryState<TEvent, TMessage>): DecodedItem<TMessage>[] => {\n  if (state.cachedDecode && state.cachedAtRawLength === state.rawMessages.length) {\n    return state.cachedDecode;\n  }\n  const result = decodeAll(state);\n  state.cachedDecode = result;\n  state.cachedAtRawLength = state.rawMessages.length;\n  return result;\n};\n\n// ---------------------------------------------------------------------------\n// Incremental completion counting (avoids full decode inside the fetch loop)\n// ---------------------------------------------------------------------------\n\n/**\n * Scan newly-added raw messages and track which `x-ably-msg-id`s have\n * become complete. Used by {@link fetchUntilLimit} to decide when enough\n * completed messages have been collected, without running the decoder.\n *\n * A msg-id is considered complete only when BOTH of these have been seen:\n * - a \"start\" signal: either `x-ably-discrete` on a `message.create`\n *   (discrete messages are created and terminated by the same wire\n *   message), OR any `message.create` / `message.update` / `message.append`\n *   with `x-ably-stream: \"true\"` (the decoder establishes a tracker via\n *   create or first-contact).\n * - a \"terminal\" signal: `x-ably-discrete` on the create, or\n *   `x-ably-status: \"finished\"` / `\"aborted\"` on any later action.\n *\n * Why update and append count as starts: Ably history can compact a live\n * `create + append + ... + append{status:finished}` sequence into a single\n * `message.update` with `STREAM=true` and `STATUS=finished`. The decoder\n * handles that in {@link _decodeUpdate} via first-contact. Counting only\n * `message.create` as a start would cause the fetch loop to page past a\n * compacted turn without ever marking it complete.\n *\n * Requiring both halves matters when a streaming turn spans a page\n * boundary: the terminal arrives in the newer page (fetched first) while\n * the start sits in an older page. Counting the terminal alone would stop\n * the fetch loop prematurely - the decoder would have no stream state to\n * resolve, and the message wouldn't make it into the result.\n *\n * Messages skipped for counting:\n * - Missing `x-ably-msg-id`: lifecycle events not tied to a domain message.\n * - `x-ably-amend` set: amendments target an existing message, not a new\n *   completion.\n * - `message.delete`: clears the tracker, doesn't produce output.\n *\n * Known edge case: if Ably history is truncated and a terminal survives\n * while every start signal for its msg-id has rolled off, the counter will\n * never mark that `msg-id` complete. The loop keeps fetching until it runs\n * out of pages, then returns whatever the decoder actually produced.\n * Matches the existing behaviour for the same truncation scenario.\n * @param state - The shared history traversal state.\n * @param newMessages - The Ably messages just pushed onto `state.rawMessages`.\n */\nconst countNewCompletions = <TEvent, TMessage>(\n  state: HistoryState<TEvent, TMessage>,\n  newMessages: readonly Ably.InboundMessage[],\n): void => {\n  for (const msg of newMessages) {\n    const headers = getHeaders(msg);\n    const msgId = headers[HEADER_MSG_ID];\n    if (!msgId) continue;\n    // Amendments target an existing message, not a new completion.\n    // Defensive: no current encoder path produces an amendment carrying\n    // HEADER_STREAM=true, HEADER_STATUS, or HEADER_DISCRETE.\n    if (headers[HEADER_AMEND]) continue;\n\n    const action = msg.action;\n    const isDiscreteCreate = action === 'message.create' && HEADER_DISCRETE in headers;\n    // Any content-producing action on a streamed serial counts as a start:\n    // the decoder uses create or first-contact (update/append) to establish\n    // its tracker. Delete clears tracker state and emits nothing, so it\n    // never counts as a start.\n    const hasStreamContent =\n      headers[HEADER_STREAM] === 'true' &&\n      (action === 'message.create' || action === 'message.update' || action === 'message.append');\n    const status = headers[HEADER_STATUS];\n    const isTerminal = status === 'finished' || status === 'aborted';\n\n    if (isDiscreteCreate || hasStreamContent) state.startedMsgIds.add(msgId);\n    if (isDiscreteCreate || isTerminal) state.terminatedMsgIds.add(msgId);\n    if (state.startedMsgIds.has(msgId) && state.terminatedMsgIds.has(msgId)) {\n      state.completedMsgIds.add(msgId);\n    }\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Fetch Ably pages until we have enough completed messages\n// ---------------------------------------------------------------------------\n\n/**\n * Fetch Ably history pages until we have enough completed messages.\n *\n * The loop uses {@link countNewCompletions} to decide when to stop -\n * a cheap O(new messages) header scan - rather than running the full\n * decoder per page. The decoder runs exactly once later, in\n * {@link buildResult}, against the fully-collected `rawMessages`.\n * @param state - The shared history traversal state.\n * @param ablyPage - The current Ably paginated result to start from.\n * @param limit - Target number of completed messages beyond what has already been returned.\n */\nconst fetchUntilLimit = async <TEvent, TMessage>(\n  state: HistoryState<TEvent, TMessage>,\n  ablyPage: Ably.PaginatedResult<Ably.InboundMessage>,\n  limit: number,\n): Promise<void> => {\n  state.rawMessages.push(...ablyPage.items);\n  state.lastAblyPage = ablyPage;\n  countNewCompletions(state, ablyPage.items);\n\n  const target = state.returnedCount + limit;\n  while (state.completedMsgIds.size < target && ablyPage.hasNext()) {\n    state.logger.debug('decodeHistory.fetchUntilLimit(); fetching next page', {\n      collected: state.rawMessages.length,\n      completed: state.completedMsgIds.size,\n    });\n    const nextPage = await ablyPage.next();\n    if (!nextPage) break;\n    ablyPage = nextPage;\n    state.rawMessages.push(...nextPage.items);\n    state.lastAblyPage = nextPage;\n    countNewCompletions(state, nextPage.items);\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Build HistoryPage result from current state\n// ---------------------------------------------------------------------------\n\n/**\n * Build a HistoryPage from the current decode state.\n * @param state - The shared history traversal state.\n * @param limit - Max messages per page.\n * @returns A page of decoded history with a `next()` cursor.\n */\nconst buildResult = <TEvent, TMessage>(state: HistoryState<TEvent, TMessage>, limit: number): HistoryPage<TMessage> => {\n  // allCompleted is newest-first. Slice from returnedCount for this page,\n  // then reverse to chronological for display.\n  const allCompleted = decodeAllCached(state);\n\n  const pageSlice = allCompleted.slice(state.returnedCount, state.returnedCount + limit);\n  const chronSlice = [...pageSlice].toReversed();\n  state.returnedCount += pageSlice.length;\n\n  const moreCompleted = allCompleted.length > state.returnedCount;\n  const moreAblyPages = state.lastAblyPage?.hasNext() ?? false;\n\n  // Raw Ably messages for this page in chronological order.\n  const newRawCount = state.rawMessages.length - state.returnedRawCount;\n  const rawSlice = newRawCount > 0 ? state.rawMessages.slice(state.returnedRawCount).toReversed() : [];\n  state.returnedRawCount = state.rawMessages.length;\n\n  return {\n    items: chronSlice.map((d) => ({ message: d.message, headers: d.headers, serial: d.serial })),\n    rawMessages: rawSlice,\n    hasNext: () => moreCompleted || moreAblyPages,\n    next: async () => {\n      if (moreCompleted) {\n        return buildResult(state, limit);\n      }\n      if (!moreAblyPages || !state.lastAblyPage) return;\n      const nextAbly = await state.lastAblyPage.next();\n      if (!nextAbly) return;\n      await fetchUntilLimit(state, nextAbly, limit);\n      return buildResult(state, limit);\n    },\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Load conversation history from a channel and return decoded messages.\n *\n * Attaches the channel if not already attached, then calls\n * `channel.history({ untilAttach: true })` to guarantee no gap between\n * historical and live messages. The attach is idempotent.\n *\n * The `limit` option controls the number of complete messages\n * returned per page, not the number of Ably wire messages fetched.\n * @param channel - The Ably channel to load history from.\n * @param codec - The codec for decoding wire messages into domain messages.\n * @param options - Pagination options.\n * @param logger - Logger for diagnostic output.\n * @returns The first page of decoded history.\n */\n// Spec: AIT-CT11, AIT-CT11b\nexport const decodeHistory = async <TEvent, TMessage>(\n  channel: Ably.RealtimeChannel,\n  codec: Codec<TEvent, TMessage>,\n  options: LoadHistoryOptions | undefined,\n  logger: Logger,\n): Promise<HistoryPage<TMessage>> => {\n  const limit = options?.limit ?? 100;\n  const state: HistoryState<TEvent, TMessage> = {\n    codec,\n    rawMessages: [],\n    returnedCount: 0,\n    returnedRawCount: 0,\n    lastAblyPage: undefined,\n    cachedDecode: undefined,\n    cachedAtRawLength: 0,\n    startedMsgIds: new Set<string>(),\n    terminatedMsgIds: new Set<string>(),\n    completedMsgIds: new Set<string>(),\n    logger,\n  };\n\n  logger.trace('decodeHistory();', { limit });\n\n  // Request more Ably messages than the domain limit to account for\n  // the many-to-one ratio (multiple wire messages per message).\n  const wireLimit = limit * 10;\n\n  await channel.attach();\n  const ablyPage = await channel.history({ untilAttach: true, limit: wireLimit });\n  await fetchUntilLimit(state, ablyPage, limit);\n  return buildResult(state, limit);\n};\n","/**\n * DefaultView — a paginated, branch-aware projection over the Tree.\n *\n * Wraps a Tree and manages a pagination window that controls which nodes\n * are visible to the UI. New live messages appear immediately; older messages\n * are revealed progressively via `loadOlder()`.\n *\n * Each View owns its own branch selection state and pagination window,\n * allowing multiple independent Views over the same Tree.\n *\n * Events are scoped to the visible window — 'update' only fires when the\n * visible output changes, 'ably-message' only for messages corresponding to\n * visible nodes, and 'turn' only for turns with visible messages.\n */\n\nimport * as Ably from 'ably';\n\nimport { EVENT_TURN_END, EVENT_TURN_START, HEADER_MSG_ID, HEADER_TURN_ID } from '../../constants.js';\nimport { ErrorCode } from '../../errors.js';\nimport { EventEmitter } from '../../event-emitter.js';\nimport type { Logger } from '../../logger.js';\nimport { getHeaders } from '../../utils.js';\nimport type { Codec } from '../codec/types.js';\nimport { decodeHistory } from './decode-history.js';\nimport type { TreeInternal } from './tree.js';\nimport type {\n  ActiveTurn,\n  EventsNode,\n  HistoryPage,\n  MessageNode,\n  SendOptions,\n  TurnLifecycleEvent,\n  View,\n} from './types.js';\n\n// ---------------------------------------------------------------------------\n// Events map\n// ---------------------------------------------------------------------------\n\ninterface ViewEventsMap {\n  update: undefined;\n  'ably-message': Ably.InboundMessage;\n  turn: TurnLifecycleEvent;\n}\n\n// ---------------------------------------------------------------------------\n// Send delegate\n// ---------------------------------------------------------------------------\n\n/**\n * Internal delegate function provided by the transport for executing sends.\n * The View pre-computes the visible branch history and passes it directly,\n * so the delegate has no back-reference to the View.\n * When `eventNodes` is provided, the transport includes them in the POST body\n * for the server to publish as cross-turn events.\n */\nexport type SendDelegate<TEvent, TMessage> = (\n  input: TMessage | TMessage[],\n  options: SendOptions | undefined,\n  history: MessageNode<TMessage>[],\n  eventNodes?: EventsNode<TEvent>[],\n) => Promise<ActiveTurn<TEvent>>;\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/** Options for creating a View. */\nexport interface ViewOptions<TEvent, TMessage> {\n  /** The tree to project. */\n  tree: TreeInternal<TMessage>;\n  /** The Ably channel to load history from. */\n  channel: Ably.RealtimeChannel;\n  /** The codec for decoding history messages. */\n  codec: Codec<TEvent, TMessage>;\n  /** Delegate for executing sends through the transport. */\n  sendDelegate: SendDelegate<TEvent, TMessage>;\n  /** Logger for diagnostic output. */\n  logger: Logger;\n  /** Called when the view is closed, allowing the owner to clean up references. */\n  onClose?: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Branch selection\n// ---------------------------------------------------------------------------\n\n/**\n * Tagged union representing why a branch was selected.\n * Stored per group root in the View's `_branchSelections` map.\n */\ntype BranchSelection =\n  /** Explicit navigation via `select()`. */\n  | { kind: 'user'; selectedId: string }\n  /** This view initiated a fork (edit or regenerate) — auto-selected the result. */\n  | { kind: 'auto'; selectedId: string }\n  /** An external fork appeared — pinned to the currently-visible sibling to prevent drift. */\n  | { kind: 'pinned'; selectedId: string }\n  /** This view's `regenerate()` is in flight — select newest when turn's response arrives. */\n  | { kind: 'pending'; turnId: string };\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nexport class DefaultView<TEvent, TMessage> implements View<TEvent, TMessage> {\n  private readonly _tree: TreeInternal<TMessage>;\n  private readonly _channel: Ably.RealtimeChannel;\n  private readonly _codec: Codec<TEvent, TMessage>;\n  private readonly _sendDelegate: SendDelegate<TEvent, TMessage>;\n  private readonly _logger: Logger;\n  private readonly _emitter: EventEmitter<ViewEventsMap>;\n  private readonly _onClose?: () => void;\n\n  /**\n   * View-local branch selections: group root msgId → selection intent.\n   * Fork points not present here default to the latest sibling.\n   * Replaces the previous numeric-index _selections and _pendingForkSelections\n   * with a single tagged-union map that carries the selected msgId (not index)\n   * and the reason for the selection.\n   */\n  private readonly _branchSelections = new Map<string, BranchSelection>();\n\n  /** Spec: AIT-CT11c — msg-ids loaded from history but not yet revealed to the UI. */\n  private readonly _withheldMsgIds = new Set<string>();\n\n  /** Snapshot of visible msgIds — used to detect structural changes and for selection pinning. */\n  private _lastVisibleIds: string[] = [];\n\n  /** Snapshot of visible message references — used to detect in-place content updates (streaming). */\n  private _lastVisibleMessages: TMessage[] = [];\n\n  /** Cached set of turn IDs present on the visible branch — avoids recomputing flattenNodes() on turn events. */\n  private _lastVisibleTurnIds = new Set<string>();\n\n  /** Whether there are more history pages to fetch from the channel. */\n  private _hasMoreHistory = false;\n\n  /** Internal state for continuing history pagination. */\n  private _lastHistoryPage: HistoryPage<TMessage> | undefined;\n\n  /** Buffer of withheld nodes, drained newest-first by successive loadOlder() calls. */\n  private readonly _withheldBuffer: MessageNode<TMessage>[] = [];\n\n  /** Unsubscribe functions for tree event subscriptions. */\n  private readonly _unsubs: (() => void)[] = [];\n\n  /**\n   * Cached result of the last flattenNodes computation. Public `flattenNodes()`\n   * returns this in O(1); internal callers use `_computeFlatNodes()` when a\n   * fresh tree walk is needed (structural changes, selection changes, history reveal).\n   */\n  private _cachedNodes: MessageNode<TMessage>[] = [];\n\n  /** Last seen tree structural version - used to distinguish content-only from structural updates. */\n  private _lastStructuralVersion = -1;\n\n  private _loadingOlder = false;\n  private _processingHistory = false;\n  private _closed = false;\n\n  constructor(options: ViewOptions<TEvent, TMessage>) {\n    this._tree = options.tree;\n    this._channel = options.channel;\n    this._codec = options.codec;\n    this._sendDelegate = options.sendDelegate;\n    this._onClose = options.onClose;\n    this._logger = options.logger.withContext({ component: 'View' });\n    this._logger.trace('DefaultView();');\n    this._emitter = new EventEmitter<ViewEventsMap>(this._logger);\n\n    // Compute initial cache and snapshot visible state\n    this._cachedNodes = this._computeFlatNodes();\n    this._lastStructuralVersion = this._tree.structuralVersion;\n    this._updateVisibleSnapshot(this._cachedNodes);\n\n    // Subscribe to tree events and re-emit scoped versions\n    this._unsubs.push(\n      this._tree.on('update', () => {\n        this._onTreeUpdate();\n      }),\n      this._tree.on('ably-message', (msg) => {\n        this._onTreeAblyMessage(msg);\n      }),\n      this._tree.on('turn', (event) => {\n        this._onTreeTurn(event);\n      }),\n    );\n  }\n\n  // -------------------------------------------------------------------------\n  // Public query methods\n  // -------------------------------------------------------------------------\n\n  getMessages(): TMessage[] {\n    return this.flattenNodes().map((n) => n.message);\n  }\n\n  // Spec: AIT-CT9, AIT-CT11c\n  flattenNodes(): MessageNode<TMessage>[] {\n    return this._cachedNodes;\n  }\n\n  /**\n   * Walk the tree and compute a fresh visible node list, applying branch\n   * selections and withheld-message filtering. Use this instead of the\n   * public `flattenNodes()` when the cache may be stale (structural\n   * changes, selection changes, history reveal).\n   * @returns A fresh array of visible nodes.\n   */\n  private _computeFlatNodes(): MessageNode<TMessage>[] {\n    const nodes = this._tree.flattenNodes(this._resolveSelections());\n    if (this._withheldMsgIds.size === 0) return nodes;\n    return nodes.filter((n) => !this._withheldMsgIds.has(n.msgId));\n  }\n\n  hasOlder(): boolean {\n    return this._withheldBuffer.length > 0 || this._hasMoreHistory;\n  }\n\n  async loadOlder(limit = 100): Promise<void> {\n    if (this._closed || this._loadingOlder) return;\n    this._loadingOlder = true;\n    this._logger.trace('DefaultView.loadOlder();', { limit });\n\n    try {\n      // Drain withheld buffer first (older messages, released newest-first)\n      if (this._withheldBuffer.length > 0) {\n        const batch = this._withheldBuffer.splice(-limit, limit);\n        this._releaseWithheld(batch);\n        return;\n      }\n\n      // Buffer exhausted — load from channel history\n      if (!this._hasMoreHistory && !this._lastHistoryPage) {\n        // First load\n        await this._loadFirstPage(limit);\n        return;\n      }\n\n      if (!this._hasMoreHistory) return;\n\n      // Continue from last page\n      if (!this._lastHistoryPage?.hasNext()) {\n        this._hasMoreHistory = false;\n        return;\n      }\n\n      const nextPage = await this._lastHistoryPage.next();\n      // Re-check: close() may be called during the await from another call stack\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- close() may be called during await\n      if (this._closed || !nextPage) {\n        if (!nextPage) this._hasMoreHistory = false;\n        return;\n      }\n\n      await this._loadAndReveal(nextPage, limit);\n    } catch (error) {\n      this._logger.error('DefaultView.loadOlder(); failed', { error });\n      throw error;\n    } finally {\n      this._loadingOlder = false;\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Branch navigation\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CT13c\n  select(msgId: string, index: number): void {\n    this._logger.trace('DefaultView.select();', { msgId, index });\n    const nodes = this._tree.getSiblingNodes(msgId);\n    if (nodes.length <= 1) return;\n    const groupRootId = this._tree.getGroupRoot(msgId);\n    const clamped = Math.max(0, Math.min(index, nodes.length - 1));\n    const selected = nodes[clamped];\n    if (!selected) return; // unreachable: clamped is always in bounds\n    this._branchSelections.set(groupRootId, { kind: 'user', selectedId: selected.msgId });\n    this._logger.debug('DefaultView.select();', { msgId, index: clamped, selectedId: selected.msgId });\n    this._cachedNodes = this._computeFlatNodes();\n    this._updateVisibleSnapshot(this._cachedNodes);\n    this._emitter.emit('update');\n  }\n\n  getSelectedIndex(msgId: string): number {\n    this._logger.trace('DefaultView.getSelectedIndex();', { msgId });\n    const nodes = this._tree.getSiblingNodes(msgId);\n    if (nodes.length <= 1) return 0;\n    const groupRootId = this._tree.getGroupRoot(msgId);\n    const sel = this._branchSelections.get(groupRootId);\n    if (!sel || sel.kind === 'pending') return nodes.length - 1; // default: latest\n    const idx = nodes.findIndex((n) => n.msgId === sel.selectedId);\n    if (idx === -1) return nodes.length - 1; // fallback if stale\n    return idx;\n  }\n\n  getSiblings(msgId: string): TMessage[] {\n    return this._tree.getSiblings(msgId);\n  }\n\n  hasSiblings(msgId: string): boolean {\n    return this._tree.hasSiblings(msgId);\n  }\n\n  getNode(msgId: string): MessageNode<TMessage> | undefined {\n    return this._tree.getNode(msgId);\n  }\n\n  // -------------------------------------------------------------------------\n  // Write operations\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CT3, AIT-CT4\n  async send(input: TMessage | TMessage[], options?: SendOptions): Promise<ActiveTurn<TEvent>> {\n    this._logger.trace('DefaultView.send();');\n    if (this._closed) {\n      throw new Ably.ErrorInfo('unable to send; view is closed', ErrorCode.InvalidArgument, 400);\n    }\n\n    // Pre-compute visible branch history before the delegate call so the\n    // transport has no back-reference to the View (one-way dependency).\n    const history = this.flattenNodes();\n    const result = await this._sendDelegate(input, options, history);\n\n    // Spec: AIT-CT13e\n    // Auto-select the new fork in this view when creating a fork.\n    if (options?.forkOf) {\n      const groupRoot = this._tree.getGroupRoot(options.forkOf);\n\n      if (result.optimisticMsgIds.length > 0) {\n        // The delegate optimistically inserted user messages (edit path).\n        // Auto-select the last optimistic msgId — this is deterministic and\n        // avoids the sibling-count race that exists when inferring from tree state.\n        const lastMsgId = result.optimisticMsgIds.at(-1);\n        if (lastMsgId) {\n          this._branchSelections.set(groupRoot, { kind: 'auto', selectedId: lastMsgId });\n          this._cachedNodes = this._computeFlatNodes();\n          this._updateVisibleSnapshot(this._cachedNodes);\n          this._emitter.emit('update');\n        }\n      } else {\n        // No optimistic insert (e.g. regenerate sends no user messages). Defer\n        // auto-selection until the server response creates the new sibling.\n        // Store the group root (not the raw forkOf) so _pinBranchSelections\n        // can match it regardless of which sibling is currently visible.\n        this._branchSelections.set(groupRoot, { kind: 'pending', turnId: result.turnId });\n        this._logger.debug('DefaultView.send(); deferring fork auto-selection', {\n          forkOf: options.forkOf,\n          groupRoot,\n          turnId: result.turnId,\n        });\n\n        // Bound pending entry lifetime to the turn — clean up on turn-end.\n        const turnUnsub = this._tree.on('turn', (evt) => {\n          if (evt.type !== EVENT_TURN_END || evt.turnId !== result.turnId) return;\n          const sel = this._branchSelections.get(groupRoot);\n          if (sel?.kind === 'pending' && sel.turnId === result.turnId) {\n            this._branchSelections.delete(groupRoot);\n          }\n          turnUnsub();\n          const idx = this._unsubs.indexOf(turnUnsub);\n          if (idx !== -1) this._unsubs.splice(idx, 1);\n        });\n        this._unsubs.push(turnUnsub);\n      }\n    }\n\n    return result;\n  }\n\n  // Spec: AIT-CT5\n  async regenerate(messageId: string, options?: SendOptions): Promise<ActiveTurn<TEvent>> {\n    this._logger.trace('DefaultView.regenerate();', { messageId });\n\n    const node = this._tree.getNode(messageId);\n    if (!node) {\n      throw new Ably.ErrorInfo(\n        `unable to regenerate; message not found in tree: ${messageId}`,\n        ErrorCode.InvalidArgument,\n        400,\n      );\n    }\n    const parentId = node.parentId;\n\n    return this.send([], {\n      ...options,\n      body: {\n        history: this._getHistoryBefore(messageId),\n        ...options?.body,\n      },\n      forkOf: messageId,\n      parent: parentId,\n    });\n  }\n\n  // Spec: AIT-CT6\n  async edit(\n    messageId: string,\n    newMessages: TMessage | TMessage[],\n    options?: SendOptions,\n  ): Promise<ActiveTurn<TEvent>> {\n    this._logger.trace('DefaultView.edit();', { messageId });\n\n    const node = this._tree.getNode(messageId);\n    if (!node) {\n      throw new Ably.ErrorInfo(\n        `unable to edit; message not found in tree: ${messageId}`,\n        ErrorCode.InvalidArgument,\n        400,\n      );\n    }\n    const parentId = node.parentId;\n\n    return this.send(newMessages, {\n      ...options,\n      body: {\n        history: this._getHistoryBefore(messageId),\n        ...options?.body,\n      },\n      forkOf: messageId,\n      parent: parentId,\n    });\n  }\n\n  async update(msgId: string, events: TEvent[], options?: SendOptions): Promise<ActiveTurn<TEvent>> {\n    if (this._closed) {\n      throw new Ably.ErrorInfo('unable to update; view is closed', ErrorCode.InvalidArgument, 400);\n    }\n    this._logger.trace('DefaultView.update();', { msgId, eventCount: events.length });\n    const eventNodes: EventsNode<TEvent>[] = [{ kind: 'event', msgId, events }];\n    return this._sendDelegate([], options, this.flattenNodes(), eventNodes);\n  }\n\n  private _getHistoryBefore(messageId: string): MessageNode<TMessage>[] {\n    this._logger.trace('DefaultView._getHistoryBefore();', { messageId });\n    const all = this.flattenNodes();\n    const idx = all.findIndex((n) => n.msgId === messageId);\n    if (idx === -1) {\n      this._logger.warn('DefaultView._getHistoryBefore(); target not in visible nodes, returning full list', {\n        messageId,\n      });\n      return all;\n    }\n    return all.slice(0, idx);\n  }\n\n  // -------------------------------------------------------------------------\n  // Observation\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CT17\n  getActiveTurnIds(): Map<string, Set<string>> {\n    this._logger.trace('DefaultView.getActiveTurnIds();');\n    const allTurns = this._tree.getActiveTurnIds();\n    if (this._withheldMsgIds.size === 0) return allTurns;\n\n    // Filter to turns that have at least one visible message\n    const result = new Map<string, Set<string>>();\n    for (const [clientId, turnIds] of allTurns) {\n      const filtered = new Set<string>();\n      for (const turnId of turnIds) {\n        if (this._lastVisibleTurnIds.has(turnId)) filtered.add(turnId);\n      }\n      if (filtered.size > 0) result.set(clientId, filtered);\n    }\n    return result;\n  }\n\n  // -------------------------------------------------------------------------\n  // Event subscription\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CT8a, AIT-CT8b, AIT-CT8e\n  on(event: 'update', handler: () => void): () => void;\n  on(event: 'ably-message', handler: (msg: Ably.InboundMessage) => void): () => void;\n  on(event: 'turn', handler: (event: TurnLifecycleEvent) => void): () => void;\n  on(\n    event: 'update' | 'ably-message' | 'turn',\n    handler: (() => void) | ((msg: Ably.InboundMessage) => void) | ((event: TurnLifecycleEvent) => void),\n  ): () => void {\n    // CAST: overload signatures enforce correct handler types per event name.\n    const cb = handler as (arg: ViewEventsMap[keyof ViewEventsMap]) => void;\n    this._emitter.on(event, cb);\n    return () => {\n      this._emitter.off(event, cb);\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Lifecycle\n  // -------------------------------------------------------------------------\n\n  /**\n   * Tear down the view — unsubscribe from tree events.\n   */\n  close(): void {\n    this._logger.info('DefaultView.close();');\n    this._closed = true;\n    this._loadingOlder = false;\n    for (const unsub of this._unsubs) unsub();\n    this._unsubs.length = 0;\n    this._emitter.off();\n    this._branchSelections.clear();\n    this._withheldMsgIds.clear();\n    this._withheldBuffer.length = 0;\n    this._onClose?.();\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: history loading\n  // -------------------------------------------------------------------------\n\n  private async _loadFirstPage(limit: number): Promise<void> {\n    // Snapshot before loading — everything already in the tree stays visible\n    const beforeMsgIds = new Set(this._tree.flattenNodes(this._resolveSelections()).map((n) => n.msgId));\n\n    const firstPage = await decodeHistory(this._channel, this._codec, { limit }, this._logger);\n    if (this._closed) return;\n    const { newVisible, lastPage } = await this._loadUntilVisible(firstPage, limit, beforeMsgIds);\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- close() may be called during await\n    if (this._closed) return;\n\n    this._lastHistoryPage = lastPage;\n    this._hasMoreHistory = lastPage.hasNext();\n\n    // Split into withheld (older, kept hidden) and released (newest, shown now).\n    // Only add the actually-withheld messages to the set — adding all then\n    // releasing would cause a spurious empty-list update if a tree event fires\n    // between the two operations.\n    const released = newVisible.slice(-limit);\n    const withheld = newVisible.slice(0, -limit);\n    for (const n of withheld) {\n      this._withheldMsgIds.add(n.msgId);\n    }\n    this._withheldBuffer.push(...withheld);\n    this._releaseWithheld(released);\n  }\n\n  private async _loadAndReveal(page: HistoryPage<TMessage>, limit: number): Promise<void> {\n    // Everything currently in the tree is \"already known\"\n    const alreadyKnown = new Set(this._tree.flattenNodes(this._resolveSelections()).map((n) => n.msgId));\n\n    const { newVisible, lastPage } = await this._loadUntilVisible(page, limit, alreadyKnown);\n    if (this._closed) return;\n    this._lastHistoryPage = lastPage;\n    this._hasMoreHistory = lastPage.hasNext();\n\n    // Release the newest `limit` items; rest stays in buffer.\n    // Only add actually-withheld messages to the set — adding all then\n    // releasing would cause a spurious empty-list update if a tree event\n    // fires between the two operations.\n    const batch = newVisible.slice(-limit);\n    const withheld = newVisible.slice(0, -limit);\n    for (const n of withheld) {\n      this._withheldMsgIds.add(n.msgId);\n    }\n    this._withheldBuffer.push(...withheld);\n    this._releaseWithheld(batch);\n  }\n\n  private _processHistoryPage(page: HistoryPage<TMessage>): void {\n    this._processingHistory = true;\n    try {\n      for (const item of page.items) {\n        const msgId = item.headers[HEADER_MSG_ID];\n        if (!msgId) continue;\n        this._tree.upsert(msgId, item.message, item.headers, item.serial);\n      }\n\n      for (const msg of page.rawMessages) {\n        this._tree.emitAblyMessage(msg);\n      }\n    } finally {\n      this._processingHistory = false;\n    }\n  }\n\n  private async _loadUntilVisible(\n    firstPage: HistoryPage<TMessage>,\n    target: number,\n    beforeMsgIds: Set<string>,\n  ): Promise<{ newVisible: MessageNode<TMessage>[]; lastPage: HistoryPage<TMessage> }> {\n    this._processHistoryPage(firstPage);\n    let page = firstPage;\n\n    const newVisibleCount = (): number => {\n      let count = 0;\n      for (const n of this._tree.flattenNodes(this._resolveSelections())) {\n        if (!beforeMsgIds.has(n.msgId)) count++;\n      }\n      return count;\n    };\n\n    while (newVisibleCount() < target && page.hasNext()) {\n      const nextPage = await page.next();\n      if (!nextPage || this._closed) break;\n      this._processHistoryPage(nextPage);\n      page = nextPage;\n    }\n\n    const newVisible = this._tree.flattenNodes(this._resolveSelections()).filter((n) => !beforeMsgIds.has(n.msgId));\n    return { newVisible, lastPage: page };\n  }\n\n  // Spec: AIT-CT11a\n  private _releaseWithheld(nodes: MessageNode<TMessage>[]): void {\n    for (const n of nodes) {\n      this._withheldMsgIds.delete(n.msgId);\n    }\n    if (nodes.length > 0) {\n      this._cachedNodes = this._computeFlatNodes();\n      this._updateVisibleSnapshot(this._cachedNodes);\n      this._emitter.emit('update');\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: scoped event forwarding\n  // -------------------------------------------------------------------------\n\n  private _updateVisibleSnapshot(nodes?: MessageNode<TMessage>[]): void {\n    const resolved = nodes ?? this.flattenNodes();\n    this._lastVisibleIds = resolved.map((n) => n.msgId);\n    this._lastVisibleMessages = resolved.map((n) => n.message);\n    this._lastVisibleTurnIds = new Set<string>();\n    for (const n of resolved) {\n      const turnId = n.headers[HEADER_TURN_ID];\n      if (turnId) this._lastVisibleTurnIds.add(turnId);\n    }\n  }\n\n  private _onTreeUpdate(): void {\n    // Suppress update forwarding while processing history pages. During\n    // _processHistoryPage, each tree.upsert() fires this handler synchronously\n    // — but _withheldMsgIds hasn't been populated yet, so flattenNodes() would\n    // return unfiltered history. Without this guard, subscribers briefly see all\n    // history messages before the pagination window is applied. The final update\n    // is emitted by _releaseWithheld after withholding is set up.\n    // Scoped to _processingHistory (not _loadingOlder) so that live streaming\n    // updates arriving during the async history fetch are still forwarded.\n    if (this._processingHistory) return;\n\n    const currentVersion = this._tree.structuralVersion;\n\n    // Content-only fast path: the tree structure hasn't changed (no new\n    // nodes, deletions, or serial reorders), so the cached node list is\n    // still structurally valid. The tree mutated an existing node's\n    // .message in place - check if any visible message reference changed.\n    // JS single-threaded: structuralVersion cannot change between the\n    // check and the response within this synchronous handler invocation.\n    if (currentVersion === this._lastStructuralVersion) {\n      const changed = this._cachedNodes.some((node, i) => node.message !== this._lastVisibleMessages[i]);\n      if (changed) {\n        this._lastVisibleMessages = this._cachedNodes.map((n) => n.message);\n        this._cachedNodes = [...this._cachedNodes];\n        this._emitter.emit('update');\n      }\n      return;\n    }\n\n    // Structural update: full re-walk required.\n    this._lastStructuralVersion = currentVersion;\n\n    // Pin selections for previously-visible nodes that now have siblings.\n    // This prevents new forks (from other views' edits/regenerates) from\n    // shifting this view to a branch the user didn't navigate to.\n    this._pinBranchSelections();\n    this._resolvePendingSelections();\n\n    const nodes = this._computeFlatNodes();\n    const newIds = nodes.map((n) => n.msgId);\n    const newMessages = nodes.map((n) => n.message);\n    if (this._visibleChanged(newIds, newMessages)) {\n      this._cachedNodes = nodes;\n      this._updateVisibleSnapshot(nodes);\n      this._emitter.emit('update');\n    }\n  }\n\n  /**\n   * Build a resolved selections map from `_branchSelections` for passing\n   * to `tree.flattenNodes()`. Pending entries (no sibling yet) are omitted,\n   * causing the tree to use the default (latest sibling).\n   * @returns Resolved map of groupRoot → selectedMsgId.\n   */\n  private _resolveSelections(): Map<string, string> {\n    const resolved = new Map<string, string>();\n    for (const [groupRoot, sel] of this._branchSelections) {\n      if (sel.kind === 'pending') continue;\n      resolved.set(groupRoot, sel.selectedId);\n    }\n    return resolved;\n  }\n\n  /**\n   * For each previously-visible message that now has siblings but no\n   * explicit selection, pin the selection to that message's msgId.\n   * This preserves the current branch when new forks appear from\n   * other views or external sources.\n   *\n   * Exception: if the fork was initiated by this view (tracked as a\n   * `pending` BranchSelection), select the newest sibling instead of\n   * pinning the old one. This handles regenerate, where no optimistic\n   * insert was possible at send time.\n   */\n  private _pinBranchSelections(): void {\n    for (const msgId of this._lastVisibleIds) {\n      if (!this._tree.hasSiblings(msgId)) continue;\n      const groupRoot = this._tree.getGroupRoot(msgId);\n      const existing = this._branchSelections.get(groupRoot);\n\n      // Spec: AIT-CT13e\n      // Check if this fork was initiated by this view (e.g. regenerate).\n      // If so, select the newest sibling — but only if it belongs to the\n      // pending turn. Without this check, a sibling from another view's\n      // concurrent fork would be incorrectly auto-selected.\n      if (existing?.kind === 'pending') {\n        const nodes = this._tree.getSiblingNodes(msgId);\n        const newest = nodes.at(-1);\n        if (newest && newest.msgId !== msgId) {\n          const newestTurnId = newest.headers[HEADER_TURN_ID];\n          if (newestTurnId === existing.turnId) {\n            this._logger.debug('DefaultView._pinBranchSelections(); auto-selecting pending fork', {\n              msgId,\n              newestId: newest.msgId,\n              turnId: existing.turnId,\n            });\n            this._branchSelections.set(groupRoot, { kind: 'auto', selectedId: newest.msgId });\n          }\n        }\n        continue;\n      }\n\n      // Spec: AIT-CT13f\n      // External fork — pin to the currently-visible sibling.\n      if (existing) continue; // already have a selection\n      this._branchSelections.set(groupRoot, { kind: 'pinned', selectedId: msgId });\n    }\n  }\n\n  /**\n   * Resolve pending selections that are no longer on the visible branch.\n   * `_pinBranchSelections` only checks visible nodes, so if the user navigated\n   * away before the server response arrived, the pending entry would linger.\n   * This pass checks all pending entries against the tree directly.\n   */\n  private _resolvePendingSelections(): void {\n    for (const [groupRoot, sel] of this._branchSelections) {\n      if (sel.kind !== 'pending') continue;\n      const nodes = this._tree.getSiblingNodes(groupRoot);\n      if (nodes.length <= 1) continue;\n      const newest = nodes.at(-1);\n      if (!newest || newest.msgId === groupRoot) continue;\n      const newestTurnId = newest.headers[HEADER_TURN_ID];\n      if (newestTurnId === sel.turnId) {\n        this._logger.debug('DefaultView._resolvePendingSelections(); resolving off-branch pending', {\n          groupRoot,\n          newestId: newest.msgId,\n          turnId: sel.turnId,\n        });\n        this._branchSelections.set(groupRoot, { kind: 'auto', selectedId: newest.msgId });\n      }\n    }\n  }\n\n  private _onTreeAblyMessage(msg: Ably.InboundMessage): void {\n    // Re-emit only if the message corresponds to a visible node\n    const headers = getHeaders(msg);\n    const msgId = headers[HEADER_MSG_ID];\n    if (!msgId) {\n      // Non-message events (turn-start, turn-end, cancel) — always forward\n      this._emitter.emit('ably-message', msg);\n      return;\n    }\n    // Check that msgId is on the visible branch and not withheld\n    if (this._lastVisibleIds.includes(msgId)) {\n      this._emitter.emit('ably-message', msg);\n    }\n  }\n\n  private _onTreeTurn(event: TurnLifecycleEvent): void {\n    // Check if any messages for this turn are already on the visible branch.\n    if (this._lastVisibleTurnIds.has(event.turnId)) {\n      this._emitter.emit('turn', event);\n      return;\n    }\n\n    // For turn-start, use branch metadata to predict visibility before\n    // messages arrive. Own turns have optimistic inserts (caught above).\n    // Remote turns carry parent/forkOf from the server.\n    if (event.type === EVENT_TURN_START && this._isTurnStartVisible(event)) {\n      // Track the predicted turnId so the corresponding turn-end is not\n      // dropped if it arrives before messages update the snapshot.\n      this._lastVisibleTurnIds.add(event.turnId);\n      this._emitter.emit('turn', event);\n    }\n  }\n\n  /**\n   * Predict whether a turn-start's messages will be visible on this view's branch\n   * using the parent/forkOf metadata from the event.\n   * @param event - The turn-start lifecycle event with optional branch metadata.\n   * @returns True if the turn's messages are expected to be visible on this view's branch.\n   */\n  private _isTurnStartVisible(event: TurnLifecycleEvent & { type: typeof EVENT_TURN_START }): boolean {\n    const { parent } = event;\n\n    // No parent metadata — can't determine branch, forward as default.\n    // This covers root turns (parent omitted) and backward compat.\n    if (parent === undefined) return true;\n\n    // Check if the parent is on the visible branch\n    return this._lastVisibleIds.includes(parent);\n  }\n\n  private _visibleChanged(newIds: string[], newMessages: TMessage[]): boolean {\n    if (newIds.length !== this._lastVisibleIds.length) return true;\n    for (const [i, newId] of newIds.entries()) {\n      if (newId !== this._lastVisibleIds[i]) return true;\n    }\n    // Also detect in-place content updates (e.g. streaming) via reference comparison\n    for (const [i, msg] of newMessages.entries()) {\n      if (msg !== this._lastVisibleMessages[i]) return true;\n    }\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a View that projects a paginated window over a Tree.\n * @param options - The tree, channel, codec, and logger to use.\n * @returns A new {@link DefaultView} instance.\n */\nexport const createView = <TEvent, TMessage>(options: ViewOptions<TEvent, TMessage>): DefaultView<TEvent, TMessage> =>\n  new DefaultView(options);\n","/**\n * Core client-side transport, parameterized by codec.\n *\n * Composes StreamRouter and Tree to handle the full client-side\n * lifecycle. Subscribes to the Ably channel on construction. The same\n * subscription, decoder, and channel are reused across turns.\n *\n * The client never publishes user messages directly. Instead, it sends them\n * to the server via HTTP POST. The server publishes user messages and turn\n * lifecycle events (turn-start, turn-end) on behalf of the client.\n */\n\nimport * as Ably from 'ably';\n\nimport {\n  EVENT_CANCEL,\n  EVENT_TURN_END,\n  EVENT_TURN_START,\n  HEADER_AMEND,\n  HEADER_CANCEL_ALL,\n  HEADER_CANCEL_CLIENT_ID,\n  HEADER_CANCEL_OWN,\n  HEADER_CANCEL_TURN_ID,\n  HEADER_FORK_OF,\n  HEADER_MSG_ID,\n  HEADER_PARENT,\n  HEADER_TURN_CLIENT_ID,\n  HEADER_TURN_ID,\n  HEADER_TURN_REASON,\n} from '../../constants.js';\nimport { ErrorCode } from '../../errors.js';\nimport { EventEmitter } from '../../event-emitter.js';\nimport type { Logger } from '../../logger.js';\nimport { LogLevel, makeLogger } from '../../logger.js';\nimport { getHeaders } from '../../utils.js';\nimport type { DecoderOutput, MessageAccumulator, StreamDecoder } from '../codec/types.js';\nimport { buildTransportHeaders } from './headers.js';\nimport type { StreamRouter } from './stream-router.js';\nimport { createStreamRouter } from './stream-router.js';\nimport type { DefaultTree } from './tree.js';\nimport { createTree } from './tree.js';\nimport type {\n  ActiveTurn,\n  CancelFilter,\n  ClientTransport,\n  ClientTransportOptions,\n  CloseOptions,\n  EventsNode,\n  MessageNode,\n  SendOptions,\n  Tree,\n  TurnEndReason,\n  TurnLifecycleEvent,\n  View,\n} from './types.js';\nimport { createView, type DefaultView } from './view.js';\n\n/**\n * Returned from `on()` when the transport is already closed — the subscription\n * is silently ignored since no further events will fire.\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-function -- intentional no-op\nconst noopUnsubscribe = (): void => {};\n\n// ---------------------------------------------------------------------------\n// Internal state machine\n// ---------------------------------------------------------------------------\n\nenum ClientTransportState {\n  READY = 'ready',\n  CLOSED = 'closed',\n}\n\n// ---------------------------------------------------------------------------\n// Event map for the transport's typed EventEmitter\n// ---------------------------------------------------------------------------\n\ninterface ClientTransportEventsMap {\n  error: Ably.ErrorInfo;\n}\n\n// ---------------------------------------------------------------------------\n// Per-turn observer state — consolidated to avoid parallel-map bookkeeping\n// ---------------------------------------------------------------------------\n\ninterface TurnObserverState<TEvent, TMessage> {\n  headers: Record<string, string>;\n  serial: string | undefined;\n  accumulator: MessageAccumulator<TEvent, TMessage>;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CT1\nclass DefaultClientTransport<TEvent, TMessage> implements ClientTransport<TEvent, TMessage> {\n  private readonly _channel: Ably.RealtimeChannel;\n  private readonly _codec: ClientTransportOptions<TEvent, TMessage>['codec'];\n  private readonly _clientId: string | undefined;\n  private readonly _api: string;\n  private readonly _credentials: RequestCredentials | undefined;\n  private readonly _headersFn: (() => Record<string, string>) | undefined;\n  private readonly _bodyFn: (() => Record<string, unknown>) | undefined;\n  private readonly _fetchFn: typeof globalThis.fetch;\n  private readonly _logger: Logger;\n\n  // Typed event emitter — only 'error' remains on the transport\n  private readonly _emitter: EventEmitter<ClientTransportEventsMap>;\n\n  // Relay detection — tracks msg-ids of optimistic inserts for reconciliation\n  private readonly _ownMsgIds = new Set<string>();\n  private readonly _ownTurnIds = new Set<string>();\n\n  // Track msgIds per turn for cleanup on turn-end\n  private readonly _turnMsgIds = new Map<string, Set<string>>();\n\n  // Per-turn observer state: headers, serial, and accumulator in one map.\n  // A single .delete(turnId) cleans up all three.\n  private readonly _turnObservers = new Map<string, TurnObserverState<TEvent, TMessage>>();\n\n  // Callbacks to resolve pending waitForTurn promises on close, preventing leaked subscriptions.\n  private readonly _closeResolvers: (() => void)[] = [];\n\n  // Sub-components\n  private readonly _tree: DefaultTree<TMessage>;\n  private readonly _view: DefaultView<TEvent, TMessage>;\n  private readonly _views = new Set<DefaultView<TEvent, TMessage>>();\n  private readonly _router: StreamRouter<TEvent>;\n  private readonly _decoder: StreamDecoder<TEvent, TMessage>;\n\n  // Spec: AIT-CT10, AIT-CT10a\n  readonly tree: Tree<TMessage>;\n  readonly view: View<TEvent, TMessage>;\n\n  // Channel subscription — subscribe() returns a Promise that resolves when the channel attaches\n  private readonly _attachPromise: Promise<unknown>;\n  private readonly _onMessage: (msg: Ably.InboundMessage) => void;\n\n  private _state = ClientTransportState.READY;\n  private _hasAttachedOnce: boolean;\n  private readonly _onChannelStateChange: Ably.channelEventCallback;\n\n  // Events staged locally via stageEvents(). Flushed into the eventNodes\n  // parameter of _internalSend on the next send operation.\n  private _pendingLocalEvents: EventsNode<TEvent>[] = [];\n\n  constructor(options: ClientTransportOptions<TEvent, TMessage>) {\n    this._channel = options.channel;\n    this._codec = options.codec;\n    this._clientId = options.clientId;\n    this._api = options.api;\n    this._credentials = options.credentials;\n    // CAST: TS can't narrow options.headers/body inside a closure because the outer\n    // object is mutable. The truthiness check on the preceding line guarantees non-nullish.\n    this._headersFn =\n      typeof options.headers === 'function'\n        ? options.headers\n        : options.headers\n          ? () => options.headers as Record<string, string>\n          : undefined;\n    this._bodyFn =\n      typeof options.body === 'function'\n        ? options.body\n        : options.body\n          ? () => options.body as Record<string, unknown>\n          : undefined;\n    this._fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);\n    this._logger = (options.logger ?? makeLogger({ logLevel: LogLevel.Silent })).withContext({\n      component: 'ClientTransport',\n    });\n\n    this._emitter = new EventEmitter<ClientTransportEventsMap>(this._logger);\n    this._hasAttachedOnce = this._channel.state === 'attached';\n\n    // Compose sub-components\n    this._tree = createTree<TMessage>(this._logger);\n    this._view = createView<TEvent, TMessage>({\n      tree: this._tree,\n      channel: this._channel,\n      codec: this._codec,\n      sendDelegate: this._internalSend.bind(this),\n      logger: this._logger,\n      onClose: () => this._views.delete(this._view),\n    });\n    this._router = createStreamRouter<TEvent>(this._codec.isTerminal.bind(this._codec), this._logger);\n    this._decoder = this._codec.createDecoder();\n\n    this._views.add(this._view);\n\n    // Public accessors (typed as narrow interfaces)\n    this.tree = this._tree;\n    this.view = this._view;\n\n    // Seed tree with initial messages — transport assigns its own msgId\n    if (options.messages) {\n      let prevMsgId: string | undefined;\n      for (const msg of options.messages) {\n        const msgId = crypto.randomUUID();\n        const seedHeaders: Record<string, string> = { [HEADER_MSG_ID]: msgId };\n        if (prevMsgId) seedHeaders[HEADER_PARENT] = prevMsgId;\n        this._tree.upsert(msgId, msg, seedHeaders);\n        prevMsgId = msgId;\n      }\n    }\n\n    // Spec: AIT-CT2\n    // Subscribe before attach (RTL7g)\n    this._onMessage = (ablyMessage: Ably.InboundMessage) => {\n      this._handleMessage(ablyMessage);\n    };\n    this._attachPromise = this._channel.subscribe(this._onMessage);\n\n    // Listen for channel state changes that break message continuity.\n    // _hasAttachedOnce is seeded from the channel's current state so that\n    // pre-attached channels are handled correctly. It distinguishes the\n    // initial attach (expected) from a genuine discontinuity.\n    this._onChannelStateChange = (stateChange: Ably.ChannelStateChange) => {\n      this._handleChannelStateChange(stateChange);\n    };\n    this._channel.on(this._onChannelStateChange);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Message subscription handler\n  // ---------------------------------------------------------------------------\n\n  private _handleMessage(ablyMessage: Ably.InboundMessage): void {\n    if (this._state === ClientTransportState.CLOSED) return;\n\n    try {\n      // Spec: AIT-CT16a\n      // --- Turn lifecycle events from the server ---\n      if (ablyMessage.name === EVENT_TURN_START) {\n        const headers = getHeaders(ablyMessage);\n        const turnId = headers[HEADER_TURN_ID];\n        const turnCid = headers[HEADER_TURN_CLIENT_ID] ?? '';\n        if (turnId) {\n          this._tree.trackTurn(turnId, turnCid);\n          const parentRaw = headers[HEADER_PARENT];\n          const forkOf = headers[HEADER_FORK_OF];\n          this._tree.emitTurn({\n            type: EVENT_TURN_START,\n            turnId,\n            clientId: turnCid,\n            ...(parentRaw !== undefined && { parent: parentRaw }),\n            ...(forkOf !== undefined && { forkOf }),\n          });\n        }\n        this._tree.emitAblyMessage(ablyMessage);\n        return;\n      }\n\n      if (ablyMessage.name === EVENT_TURN_END) {\n        const headers = getHeaders(ablyMessage);\n        const turnId = headers[HEADER_TURN_ID];\n        const turnCid = headers[HEADER_TURN_CLIENT_ID] ?? '';\n        // CAST: server always writes a valid TurnEndReason; default to 'complete' for robustness\n        const reason = (headers[HEADER_TURN_REASON] ?? 'complete') as TurnEndReason;\n        if (turnId) {\n          this._router.closeStream(turnId);\n          this._turnObservers.delete(turnId);\n          this._tree.untrackTurn(turnId);\n          // Clean up per-turn relay-detection state\n          const msgIds = this._turnMsgIds.get(turnId);\n          if (msgIds) {\n            for (const mid of msgIds) this._ownMsgIds.delete(mid);\n            this._turnMsgIds.delete(turnId);\n          }\n          this._ownTurnIds.delete(turnId);\n          this._tree.emitTurn({ type: EVENT_TURN_END, turnId, clientId: turnCid, reason });\n        }\n        this._tree.emitAblyMessage(ablyMessage);\n        return;\n      }\n\n      // --- Codec-decoded messages ---\n      const outputs = this._decoder.decode(ablyMessage);\n      const headers = getHeaders(ablyMessage);\n      const serial = ablyMessage.serial;\n\n      // Cross-turn events target an existing message from a prior turn,\n      // bypassing the current turn's accumulator.\n      const amendTarget = headers[HEADER_AMEND];\n      if (amendTarget) {\n        for (const output of outputs) {\n          if (output.kind === 'event') {\n            this._handleAmendmentEvent(amendTarget, output);\n          }\n        }\n        return;\n      }\n\n      // Always update observer headers, even when the decoder produces no outputs.\n      // This ensures header transitions (e.g. x-ably-status: streaming → aborted)\n      // are captured for events that the decoder suppresses (AIT-CD8: aborted\n      // stream appends emit no events but still carry the updated status header).\n      const turnId = headers[HEADER_TURN_ID];\n      if (turnId) {\n        this._updateTurnObserverHeaders(turnId, headers, serial);\n      }\n\n      for (const output of outputs) {\n        if (output.kind === 'message') {\n          this._handleMessageOutput(output.message, headers, serial, ablyMessage.action);\n        } else {\n          this._handleEventOutput(output, headers);\n        }\n      }\n\n      // Emit ably-message AFTER decode/upsert so that View subscribers can\n      // find the node in _lastVisibleIds (which is refreshed by tree 'update'\n      // events triggered during upsert).\n      this._tree.emitAblyMessage(ablyMessage);\n    } catch (error) {\n      const cause = error instanceof Ably.ErrorInfo ? error : undefined;\n      this._emitter.emit(\n        'error',\n        new Ably.ErrorInfo(\n          `unable to process channel message; ${error instanceof Error ? error.message : String(error)}`,\n          ErrorCode.TransportSubscriptionError,\n          500,\n          cause,\n        ),\n      );\n    }\n  }\n\n  /**\n   * Handle a decoded domain message (user message create or relayed own message).\n   * @param message - The decoded domain message.\n   * @param headers - Ably headers from the wire message.\n   * @param serial - Ably serial for tree ordering.\n   * @param action - Ably message action (e.g. 'message.create').\n   */\n  private _handleMessageOutput(\n    message: TMessage,\n    headers: Record<string, string>,\n    serial: string | undefined,\n    action: string | undefined,\n  ): void {\n    // Spec: AIT-CT15\n    const msgId = headers[HEADER_MSG_ID];\n    if (msgId && this._ownMsgIds.has(msgId)) {\n      // Relayed own message — reconcile optimistic entry with server-assigned fields\n      this._upsertAndNotify(message, headers, serial);\n      return;\n    }\n\n    if (action === 'message.create') {\n      this._upsertAndNotify(message, headers, serial);\n    }\n  }\n\n  /**\n   * Handle a decoded streaming event: route to own-turn stream or accumulate for observer.\n   * @param output - The decoded event output from the codec.\n   * @param headers - Ably headers from the wire message.\n   */\n  private _handleEventOutput(output: DecoderOutput<TEvent, TMessage>, headers: Record<string, string>): void {\n    if (output.kind !== 'event') return;\n    const event = output.event;\n    const turnId = headers[HEADER_TURN_ID];\n    if (!turnId) return;\n\n    // Observer headers are already updated in _handleMessage (before outputs\n    // are iterated) so that header transitions are captured even when the\n    // decoder produces no outputs (e.g. aborted stream appends per AIT-CD8).\n\n    // Active own turn — route to the ReadableStream\n    if (this._router.route(turnId, event)) {\n      this._accumulateAndEmit(turnId, output);\n      if (this._codec.isTerminal(event)) this._turnObservers.delete(turnId);\n      return;\n    }\n\n    // Completed own turn — late arrival, skip\n    if (this._ownTurnIds.has(turnId) && !this._turnObservers.has(turnId)) return;\n\n    // Spec: AIT-CT16\n    // Observer turn — accumulate and emit\n    this._accumulateAndEmit(turnId, output);\n    if (this._codec.isTerminal(event)) this._turnObservers.delete(turnId);\n  }\n\n  /**\n   * Handle a cross-turn event targeting an existing message from a prior turn.\n   * Creates a temporary accumulator, seeds it with the existing message,\n   * processes the event, and upserts the updated message into the tree.\n   * @param targetMsgId - The x-ably-msg-id of the message to update.\n   * @param output - The decoded event output to apply.\n   */\n  private _handleAmendmentEvent(targetMsgId: string, output: DecoderOutput<TEvent, TMessage>): void {\n    this._logger.trace('ClientTransport._handleAmendmentEvent();', { targetMsgId });\n\n    const existingNode = this._tree.getNode(targetMsgId);\n    if (!existingNode) {\n      this._logger.debug('ClientTransport._handleAmendmentEvent(); target not found, dropping', { targetMsgId });\n      return;\n    }\n\n    const accumulator = this._codec.createAccumulator();\n    accumulator.initMessage(targetMsgId, existingNode.message);\n    accumulator.processOutputs([output]);\n\n    const updatedMsg = accumulator.messages.at(-1);\n    if (updatedMsg) {\n      this._tree.upsert(targetMsgId, updatedMsg, existingNode.headers, existingNode.serial);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Channel state change handler\n  // ---------------------------------------------------------------------------\n\n  // Spec: AIT-CT19, AIT-CT19a\n  private _handleChannelStateChange(stateChange: Ably.ChannelStateChange): void {\n    if (this._state === ClientTransportState.CLOSED) return;\n\n    const { current, resumed } = stateChange;\n\n    // Track the initial attach so we don't treat it as a discontinuity\n    if (current === 'attached' && !this._hasAttachedOnce) {\n      this._hasAttachedOnce = true;\n      return;\n    }\n\n    // Continuity-breaking states:\n    // - FAILED, SUSPENDED, DETACHED: no more messages expected (or gap)\n    // - ATTACHED with resumed: false (UPDATE): messages were lost\n    const continuityLost =\n      current === 'failed' || current === 'suspended' || current === 'detached' || (current === 'attached' && !resumed);\n\n    if (!continuityLost) return;\n\n    this._logger.error('ClientTransport._handleChannelStateChange(); channel continuity lost', {\n      current,\n      resumed,\n      previous: stateChange.previous,\n    });\n\n    const err = new Ably.ErrorInfo(\n      `unable to deliver events; channel continuity lost (${current}${current === 'attached' ? ', resumed: false' : ''})`,\n      ErrorCode.ChannelContinuityLost,\n      500,\n      stateChange.reason,\n    );\n\n    // As with cancellation (_closeMatchingTurnStreams), do not clear\n    // _ownTurnIds or _turnObservers here — late events must still accumulate\n    // into the tree. The turn-end handler cleans up observers.\n    for (const turnId of this._ownTurnIds) {\n      this._router.errorStream(turnId, err);\n    }\n\n    this._emitter.emit('error', err);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Tree mutation + notification helpers\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Upsert a message into the tree and notify subscribers.\n   * @param message - The domain message to insert or update.\n   * @param headers - Ably headers for the message.\n   * @param serial - Ably serial for tree ordering.\n   */\n  private _upsertAndNotify(message: TMessage, headers: Record<string, string>, serial?: string): void {\n    const msgId = headers[HEADER_MSG_ID];\n    if (!msgId) return;\n    this._tree.upsert(msgId, message, headers, serial);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Observer accumulation\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Ensure a TurnObserverState exists for turnId, updating headers and serial as new events arrive.\n   * @param turnId - The turn to track.\n   * @param headers - Headers from the current event.\n   * @param serial - Ably serial from the current event.\n   */\n  private _updateTurnObserverHeaders(\n    turnId: string,\n    headers: Record<string, string>,\n    serial: string | undefined,\n  ): void {\n    const existing = this._turnObservers.get(turnId);\n    if (existing) {\n      if (Object.keys(headers).length > 0) {\n        Object.assign(existing.headers, headers);\n      }\n      // Always advance the serial so the tree node sorts after all\n      // earlier messages in the turn (e.g. user-message relays that\n      // arrive before the assistant response).\n      if (serial !== undefined) {\n        existing.serial = serial;\n      }\n    } else {\n      this._turnObservers.set(turnId, {\n        headers: { ...headers },\n        serial,\n        accumulator: this._codec.createAccumulator(),\n      });\n    }\n  }\n\n  /**\n   * Process a streaming event through the turn's accumulator and emit the latest message.\n   * @param turnId - The turn this event belongs to.\n   * @param output - The decoded event output to accumulate.\n   */\n  private _accumulateAndEmit(turnId: string, output: DecoderOutput<TEvent, TMessage>): void {\n    const observer = this._turnObservers.get(turnId);\n    if (!observer) return;\n\n    // Sync the accumulator with the tree before processing. If the message\n    // was updated externally (via cross-turn events), initMessage syncs the\n    // accumulator's state so the update isn't lost when processing\n    // late turn events like finish-step/finish.\n    const msgId = observer.headers[HEADER_MSG_ID];\n    if (msgId) {\n      const treeNode = this._tree.getNode(msgId);\n      if (treeNode) {\n        observer.accumulator.initMessage(msgId, treeNode.message);\n      }\n    }\n\n    observer.accumulator.processOutputs([output]);\n\n    const messages = observer.accumulator.messages;\n    if (messages.length === 0) return;\n\n    let message: TMessage | undefined;\n    try {\n      message = structuredClone(messages.at(-1));\n    } catch {\n      // CAST: structuredClone can fail if the message contains non-cloneable\n      // values (e.g. functions). Fall back to the reference — the tree upsert\n      // below copies headers independently, so shared message state is the\n      // only risk. Accumulator messages are replaced on each event, so\n      // mutation between events is not a practical concern.\n      message = messages.at(-1);\n    }\n\n    if (message) {\n      const msgId = observer.headers[HEADER_MSG_ID];\n      if (msgId) {\n        this._tree.upsert(msgId, message, { ...observer.headers }, observer.serial);\n      }\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cancel helpers\n  // ---------------------------------------------------------------------------\n\n  private async _publishCancel(filter: CancelFilter): Promise<void> {\n    this._logger.trace('ClientTransport._publishCancel();', { filter });\n\n    const headers: Record<string, string> = {};\n    if (filter.turnId) {\n      headers[HEADER_CANCEL_TURN_ID] = filter.turnId;\n    } else if (filter.own) {\n      headers[HEADER_CANCEL_OWN] = 'true';\n    } else if (filter.clientId) {\n      headers[HEADER_CANCEL_CLIENT_ID] = filter.clientId;\n    } else if (filter.all) {\n      headers[HEADER_CANCEL_ALL] = 'true';\n    }\n\n    await this._channel.publish({\n      name: EVENT_CANCEL,\n      extras: { headers },\n    });\n  }\n\n  private _closeMatchingTurnStreams(filter: CancelFilter): void {\n    // Only close the router streams here — do NOT clear _turnObservers.\n    // The observer must remain alive so that late server events (e.g. abort,\n    // x-ably-status: aborted) arriving before turn-end are still accumulated\n    // into the message store. The turn-end handler cleans up observers.\n    for (const turnId of this._getMatchingTurnIds(filter)) {\n      this._router.closeStream(turnId);\n    }\n  }\n\n  private _getMatchingTurnIds(filter: CancelFilter): Set<string> {\n    const matched = new Set<string>();\n    const activeTurns = this._tree.getActiveTurnIds();\n\n    if (filter.all) {\n      for (const turnIds of activeTurns.values()) {\n        for (const turnId of turnIds) matched.add(turnId);\n      }\n    } else if (filter.own) {\n      const ownTurns = activeTurns.get(this._clientId ?? '');\n      if (ownTurns) {\n        for (const turnId of ownTurns) matched.add(turnId);\n      }\n    } else if (filter.clientId) {\n      const clientTurns = activeTurns.get(filter.clientId);\n      if (clientTurns) {\n        for (const turnId of clientTurns) matched.add(turnId);\n      }\n    } else if (filter.turnId) {\n      // Check if the turnId exists in any client's turns\n      for (const turnIds of activeTurns.values()) {\n        if (turnIds.has(filter.turnId)) {\n          matched.add(filter.turnId);\n          break;\n        }\n      }\n    }\n    return matched;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Input message helpers\n  // ---------------------------------------------------------------------------\n\n  // ---------------------------------------------------------------------------\n  // Public API\n  // ---------------------------------------------------------------------------\n\n  // Spec: AIT-CT10b\n  createView(): View<TEvent, TMessage> {\n    if (this._state === ClientTransportState.CLOSED) {\n      throw new Ably.ErrorInfo('unable to create view; transport is closed', ErrorCode.TransportClosed, 400);\n    }\n    this._logger.trace('DefaultClientTransport.createView();');\n    const view = createView<TEvent, TMessage>({\n      tree: this._tree,\n      channel: this._channel,\n      codec: this._codec,\n      sendDelegate: this._internalSend.bind(this),\n      logger: this._logger,\n      onClose: () => this._views.delete(view),\n    });\n    this._views.add(view);\n    return view;\n  }\n\n  // Spec: AIT-CT3, AIT-CT4\n  private async _internalSend(\n    input: TMessage | TMessage[],\n    sendOptions: SendOptions | undefined,\n    history: MessageNode<TMessage>[],\n    eventNodes?: EventsNode<TEvent>[],\n  ): Promise<ActiveTurn<TEvent>> {\n    if (this._state === ClientTransportState.CLOSED) {\n      throw new Ably.ErrorInfo('unable to send; transport is closed', ErrorCode.TransportClosed, 400);\n    }\n    await this._attachPromise;\n    // CAST: re-check after await — close() may have been called while waiting for attach.\n    // TypeScript's control flow narrows _state after the first check, but the\n    // await yields and close() can mutate _state concurrently.\n    if ((this._state as ClientTransportState) === ClientTransportState.CLOSED) {\n      throw new Ably.ErrorInfo('unable to send; transport is closed', ErrorCode.TransportClosed, 400);\n    }\n\n    // Spec: AIT-CT20\n    const state = this._channel.state;\n    if (state !== 'attached' && state !== 'attaching') {\n      throw new Ably.ErrorInfo(`unable to send; channel is ${state}`, ErrorCode.ChannelNotReady, 400);\n    }\n\n    this._logger.trace('ClientTransport._internalSend();');\n\n    const msgs = Array.isArray(input) ? input : [input];\n    const turnId = crypto.randomUUID();\n    this._ownTurnIds.add(turnId);\n    this._tree.trackTurn(turnId, this._clientId ?? '');\n\n    // Flush any events staged via stageEvents() since the last send. They\n    // have already been applied to the tree, so merge them into the POST\n    // body without re-applying. External eventNodes (e.g. from view.update)\n    // have NOT been applied yet and need the optimistic tree update below.\n    const flushedStaged = this._pendingLocalEvents;\n    this._pendingLocalEvents = [];\n\n    // Optimistic tree updates for external cross-turn events — must happen\n    // before capturing history so the POST body includes the updated\n    // message state.\n    if (eventNodes && eventNodes.length > 0) {\n      this._applyEventsToTree(eventNodes);\n    }\n\n    const allEventNodes: EventsNode<TEvent>[] = [...flushedStaged, ...(eventNodes ?? [])];\n\n    const msgIds = new Set<string>();\n    const postMessages: MessageNode<TMessage>[] = [];\n\n    // The View pre-computed the visible branch before calling this delegate,\n    // so preInsertHistory reflects the state before any optimistic inserts.\n    const preInsertHistory = history;\n\n    // Spec: AIT-CT3d\n    // Auto-compute parent from the current thread if not explicitly provided\n    let autoParent: string | undefined;\n    if (sendOptions?.parent === undefined && !sendOptions?.forkOf) {\n      const lastNode = preInsertHistory.at(-1);\n      if (lastNode) {\n        autoParent = lastNode.msgId;\n      }\n    }\n\n    // Capture the first parent for the POST body before the loop advances it.\n    const postParent = sendOptions?.parent === undefined ? autoParent : sendOptions.parent;\n\n    for (const message of msgs) {\n      const msgId = crypto.randomUUID();\n      this._ownMsgIds.add(msgId);\n      msgIds.add(msgId);\n\n      const resolvedParent = sendOptions?.parent === undefined ? autoParent : sendOptions.parent;\n\n      const optimisticHeaders = buildTransportHeaders({\n        role: 'user',\n        turnId,\n        msgId,\n        turnClientId: this._clientId,\n        parent: resolvedParent,\n        forkOf: sendOptions?.forkOf,\n      });\n      // Spec: AIT-CT3c\n      // Optimistically insert each user message into the tree\n      this._upsertAndNotify(message, optimisticHeaders);\n\n      // Build MessageNode for the POST body\n      postMessages.push({\n        kind: 'message',\n        message,\n        msgId,\n        parentId: resolvedParent,\n        forkOf: sendOptions?.forkOf,\n        headers: optimisticHeaders,\n        serial: undefined,\n      });\n\n      // Spec: AIT-CT3e\n      // Chain: each subsequent message in the batch parents off the previous\n      // one, forming a linear conversation thread rather than siblings.\n      if (sendOptions?.parent === undefined && !sendOptions?.forkOf) {\n        autoParent = msgId;\n      }\n    }\n\n    this._turnMsgIds.set(turnId, msgIds);\n\n    // Create ReadableStream via router\n    const stream = this._router.createStream(turnId);\n\n    // Resolve headers and body\n    const resolvedHeaders = this._headersFn?.() ?? {};\n    const resolvedBody = this._bodyFn?.() ?? {};\n\n    const postBody: Record<string, unknown> = {\n      ...resolvedBody,\n      history: preInsertHistory,\n      ...sendOptions?.body,\n      turnId,\n      clientId: this._clientId,\n      messages: postMessages,\n      ...(sendOptions?.forkOf !== undefined && { forkOf: sendOptions.forkOf }),\n      ...(postParent !== undefined && { parent: postParent }),\n      ...(allEventNodes.length > 0 && { events: allEventNodes }),\n    };\n\n    const postHeaders: Record<string, string> = {\n      ...resolvedHeaders,\n      ...sendOptions?.headers,\n    };\n\n    // Spec: AIT-CT3a, AIT-CT3b\n    // Fire-and-forget: POST must not block the stream return to the caller.\n    // .catch() is intentional — async/await would delay stream availability.\n    this._fetchFn(this._api, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        ...postHeaders,\n      },\n      body: JSON.stringify(postBody),\n      ...(this._credentials ? { credentials: this._credentials } : {}),\n    })\n      .then((response) => {\n        if (!response.ok) {\n          const err = new Ably.ErrorInfo(\n            `unable to send; HTTP POST to ${this._api} returned ${String(response.status)} ${response.statusText}`,\n            ErrorCode.TransportSendFailed,\n            response.status,\n          );\n          this._emitter.emit('error', err);\n          this._router.errorStream(turnId, err);\n        }\n      })\n      .catch((error: unknown) => {\n        const cause = error instanceof Ably.ErrorInfo ? error : undefined;\n        const err = new Ably.ErrorInfo(\n          `unable to send; HTTP POST to ${this._api} failed: ${error instanceof Error ? error.message : String(error)}`,\n          ErrorCode.TransportSendFailed,\n          500,\n          cause,\n        );\n        this._emitter.emit('error', err);\n        this._router.errorStream(turnId, err);\n      });\n\n    return {\n      stream,\n      turnId,\n      cancel: async () => this.cancel({ turnId }),\n      optimisticMsgIds: [...msgIds],\n    };\n  }\n\n  // Spec: AIT-CT7, AIT-CT7a\n  async cancel(filter?: CancelFilter): Promise<void> {\n    if (this._state === ClientTransportState.CLOSED) return;\n    const resolved = filter ?? { own: true };\n    this._logger.debug('ClientTransport.cancel();', { filter: resolved });\n    await this._publishCancel(resolved);\n    this._closeMatchingTurnStreams(resolved);\n  }\n\n  stageEvents(msgId: string, events: TEvent[]): void {\n    this._logger.trace('ClientTransport.stageEvents();', { msgId, eventCount: events.length });\n    if (this._state === ClientTransportState.CLOSED) {\n      this._logger.warn('ClientTransport.stageEvents(); transport is closed', { msgId });\n      return;\n    }\n    if (!this._tree.getNode(msgId)) {\n      this._logger.warn('ClientTransport.stageEvents(); msgId not found in tree', { msgId });\n      return;\n    }\n    if (events.length === 0) return;\n    const node: EventsNode<TEvent> = { kind: 'event', msgId, events };\n    // Apply immediately so any subsequent useMessageSync / tree observer\n    // sees the merged state — no window where the staged event can be\n    // clobbered by an interleaved observer turn update.\n    this._applyEventsToTree([node]);\n    this._pendingLocalEvents.push(node);\n  }\n\n  stageMessage(msgId: string, message: TMessage): void {\n    this._logger.trace('ClientTransport.stageMessage();', { msgId });\n    if (this._state === ClientTransportState.CLOSED) {\n      this._logger.warn('ClientTransport.stageMessage(); transport is closed', { msgId });\n      return;\n    }\n    const existing = this._tree.getNode(msgId);\n    if (!existing) {\n      this._logger.warn('ClientTransport.stageMessage(); msgId not found in tree', { msgId });\n      return;\n    }\n    // Preserve structural metadata; only the message body changes.\n    this._tree.upsert(msgId, message, existing.headers, existing.serial);\n  }\n\n  // Apply events to the tree using the codec's accumulator. Shared by\n  // stageEvents (local staging) and _internalSend (external eventNodes\n  // arriving via view.update).\n  private _applyEventsToTree(eventNodes: EventsNode<TEvent>[]): void {\n    for (const node of eventNodes) {\n      const existingNode = this._tree.getNode(node.msgId);\n      if (!existingNode) continue;\n      const outputs = node.events.map((event) => ({\n        kind: 'event' as const,\n        event,\n        messageId: node.msgId,\n      }));\n      const accumulator = this._codec.createAccumulator();\n      accumulator.initMessage(node.msgId, existingNode.message);\n      accumulator.processOutputs(outputs);\n      const updatedMsg = accumulator.messages.at(-1);\n      if (updatedMsg) {\n        this._tree.upsert(node.msgId, updatedMsg, existingNode.headers, existingNode.serial);\n      }\n    }\n  }\n\n  // Spec: AIT-CT18\n  async waitForTurn(filter?: CancelFilter): Promise<void> {\n    if (this._state === ClientTransportState.CLOSED) return;\n    const resolved = filter ?? { own: true };\n    const remaining = this._getMatchingTurnIds(resolved);\n    if (remaining.size === 0) return;\n\n    this._logger.debug('ClientTransport.waitForTurn();', { turnIds: [...remaining] });\n\n    return new Promise<void>((resolve) => {\n      let resolved = false;\n      const done = (): void => {\n        if (resolved) return;\n        resolved = true;\n        unsub();\n        const idx = this._closeResolvers.indexOf(done);\n        if (idx !== -1) this._closeResolvers.splice(idx, 1);\n        resolve();\n      };\n\n      const unsub = this._tree.on('turn', (event: TurnLifecycleEvent) => {\n        if (event.type !== EVENT_TURN_END) return;\n        remaining.delete(event.turnId);\n        if (remaining.size === 0) done();\n      });\n\n      // Resolve on transport close to prevent leaked subscriptions\n      this._closeResolvers.push(done);\n    });\n  }\n\n  // Spec: AIT-CT8, AIT-CT8c, AIT-CT8d\n  on(event: 'error', handler: (error: Ably.ErrorInfo) => void): () => void {\n    if (this._state === ClientTransportState.CLOSED) return noopUnsubscribe;\n    // CAST: the overload signature enforces the correct handler type.\n    const cb = handler as (arg: ClientTransportEventsMap[keyof ClientTransportEventsMap]) => void;\n    this._emitter.on(event, cb);\n    return () => {\n      this._emitter.off(event, cb);\n    };\n  }\n\n  // Spec: AIT-CT12, AIT-CT12a, AIT-CT12b, AIT-CT10c\n  async close(options?: CloseOptions): Promise<void> {\n    if (this._state === ClientTransportState.CLOSED) return;\n    this._state = ClientTransportState.CLOSED;\n    this._logger.info('ClientTransport.close();');\n\n    // Best-effort cancel publish before tearing down local state\n    if (options?.cancel) {\n      try {\n        await this._publishCancel(options.cancel);\n      } catch {\n        // Swallow: cancel is best-effort during teardown\n      }\n      this._closeMatchingTurnStreams(options.cancel);\n    }\n\n    this._channel.unsubscribe(this._onMessage);\n    this._channel.off(this._onChannelStateChange);\n\n    // Close any remaining active streams\n    for (const turnId of this._ownTurnIds) {\n      this._router.closeStream(turnId);\n    }\n\n    this._turnObservers.clear();\n    this._emitter.off();\n    for (const v of this._views) v.close();\n    this._views.clear();\n    for (const resolve of this._closeResolvers) resolve();\n    this._closeResolvers.length = 0;\n    this._ownTurnIds.clear();\n    this._ownMsgIds.clear();\n    this._turnMsgIds.clear();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a client-side transport that manages conversation state over an Ably channel.\n *\n * Subscribes to the channel immediately (before attach per RTL7g). The caller should\n * ensure the channel is attached or will be attached shortly after creation.\n * @param options - Configuration for the client transport.\n * @returns A new {@link ClientTransport} instance.\n */\nexport const createClientTransport = <TEvent, TMessage>(\n  options: ClientTransportOptions<TEvent, TMessage>,\n): ClientTransport<TEvent, TMessage> => new DefaultClientTransport(options);\n","/**\n * Decoder core — action dispatch and serial tracking machinery.\n *\n * Handles the Ably message action patterns (create, append, update, delete)\n * and delegates to domain-specific hooks for event building and discrete\n * event decoding.\n *\n * Domain decoders call `createDecoderCore(hooks, options)` and provide hooks\n * for stream classification, event building, and discrete decoding.\n */\n\nimport type * as Ably from 'ably';\n\nimport { HEADER_MSG_ID, HEADER_STATUS, HEADER_STREAM, HEADER_STREAM_ID } from '../../constants.js';\nimport type { Logger } from '../../logger.js';\nimport { getHeaders } from '../../utils.js';\nimport type { DecoderOutput, MessagePayload, StreamTrackerState } from './types.js';\n\n/**\n * Wrap a domain event as a single-element decoder output array.\n * @param event - The domain event to wrap.\n * @returns A single-element array containing the event as a decoder output.\n */\nexport const eventOutput = <TEvent, TMessage>(event: TEvent): DecoderOutput<TEvent, TMessage>[] => [\n  { kind: 'event', event },\n];\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/** Options for creating a decoder core. */\nexport interface DecoderCoreOptions {\n  /** Called when a tracked stream is replaced (non-prefix update). Receives the tracker with updated state. */\n  onStreamUpdate?: (tracker: StreamTrackerState) => void;\n  /** Called when a message is deleted. Receives the serial and tracker (if one exists). */\n  onStreamDelete?: (serial: string, tracker: StreamTrackerState | undefined) => void;\n  /** Logger instance for diagnostic output. */\n  logger?: Logger;\n}\n\n// ---------------------------------------------------------------------------\n// Domain hooks\n// ---------------------------------------------------------------------------\n\n/** Hooks that a domain codec provides to the decoder core for stream classification and event building. */\nexport interface DecoderCoreHooks<TEvent, TMessage> {\n  /**\n   * Build domain events emitted when a new stream starts. May return multiple\n   * events (e.g. a start event and a start-step event).\n   */\n  buildStartEvents(tracker: StreamTrackerState): DecoderOutput<TEvent, TMessage>[];\n\n  /** Build domain events for a text delta received on a stream. */\n  buildDeltaEvents(tracker: StreamTrackerState, delta: string): DecoderOutput<TEvent, TMessage>[];\n\n  /**\n   * Build domain events emitted when a stream finishes (x-ably-status:finished).\n   * Not called for aborted streams. The closing headers may differ from\n   * tracker.headers if the closing append carried updated headers.\n   */\n  buildEndEvents(\n    tracker: StreamTrackerState,\n    closingHeaders: Record<string, string>,\n  ): DecoderOutput<TEvent, TMessage>[];\n\n  /**\n   * Decode a discrete message (message.create where x-ably-stream is \"false\",\n   * or a non-streamable first-contact update). Handles user messages, lifecycle\n   * events, tool lifecycle, data-*, etc.\n   */\n  decodeDiscrete(input: MessagePayload): DecoderOutput<TEvent, TMessage>[];\n}\n\n// ---------------------------------------------------------------------------\n// Interface\n// ---------------------------------------------------------------------------\n\n/** The decoder core returned by {@link createDecoderCore}. */\nexport interface DecoderCore<TEvent, TMessage> {\n  /** Decode a single Ably message into zero or more domain outputs. */\n  decode(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[];\n}\n\n// ---------------------------------------------------------------------------\n// Default implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CD7\nclass DefaultDecoderCore<TEvent, TMessage> implements DecoderCore<TEvent, TMessage> {\n  private readonly _hooks: DecoderCoreHooks<TEvent, TMessage>;\n  private readonly _logger: Logger | undefined;\n  private readonly _onStreamUpdate: ((tracker: StreamTrackerState) => void) | undefined;\n  private readonly _onStreamDelete: ((serial: string, tracker: StreamTrackerState | undefined) => void) | undefined;\n  private readonly _serialState = new Map<string, StreamTrackerState>();\n\n  constructor(hooks: DecoderCoreHooks<TEvent, TMessage>, options: DecoderCoreOptions = {}) {\n    this._hooks = hooks;\n    this._onStreamUpdate = options.onStreamUpdate;\n    this._onStreamDelete = options.onStreamDelete;\n    this._logger = options.logger?.withContext({ component: 'DecoderCore' });\n  }\n\n  decode(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[] {\n    const action = message.action;\n\n    this._logger?.trace('DefaultDecoderCore.decode();', { action, serial: message.serial, name: message.name });\n\n    let outputs: DecoderOutput<TEvent, TMessage>[];\n\n    switch (action) {\n      // Spec: AIT-CD7a\n      case 'message.create': {\n        const payload = this._toPayload(message);\n\n        outputs =\n          payload.headers?.[HEADER_STREAM] === 'true'\n            ? this._decodeStreamedCreate(payload, message.serial)\n            : this._hooks.decodeDiscrete(payload);\n        break;\n      }\n\n      case 'message.append': {\n        outputs = this._decodeAppend(message);\n        break;\n      }\n\n      case 'message.update': {\n        outputs = this._decodeUpdate(message);\n        break;\n      }\n\n      case 'message.delete': {\n        outputs = this._decodeDelete(message);\n        break;\n      }\n\n      default: {\n        return [];\n      }\n    }\n\n    // Tag all event outputs with the message ID from x-ably-msg-id for accumulator correlation.\n    const messageId = getHeaders(message)[HEADER_MSG_ID];\n    if (messageId) {\n      for (const output of outputs) {\n        if (output.kind === 'event') {\n          output.messageId = messageId;\n        }\n      }\n    }\n\n    return outputs;\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: extract MessagePayload\n  // -------------------------------------------------------------------------\n\n  private _toPayload(message: Ably.InboundMessage): MessagePayload {\n    return {\n      name: message.name ?? '',\n      // CAST: Ably SDK types `data` as `any`; cast to unknown is the safe boundary type.\n      data: message.data as unknown,\n      headers: getHeaders(message),\n    };\n  }\n\n  /**\n   * Extract string data from an Ably message, for stream accumulation paths.\n   * @param message - The Ably message to extract string data from.\n   * @returns The string data, or empty string if data is not a string.\n   */\n  private _stringData(message: Ably.InboundMessage): string {\n    return typeof message.data === 'string' ? message.data : '';\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: safe callback invocation\n  // -------------------------------------------------------------------------\n\n  private _invokeOnStreamUpdate(tracker: StreamTrackerState): void {\n    if (!this._onStreamUpdate) return;\n    try {\n      this._onStreamUpdate(tracker);\n    } catch (error) {\n      this._logger?.error('DefaultDecoderCore._invokeOnStreamUpdate(); callback threw', { error });\n    }\n  }\n\n  private _invokeOnStreamDelete(serial: string, tracker: StreamTrackerState | undefined): void {\n    if (!this._onStreamDelete) return;\n    try {\n      this._onStreamDelete(serial, tracker);\n    } catch (error) {\n      this._logger?.error('DefaultDecoderCore._invokeOnStreamDelete(); callback threw', { error });\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: streamed message create\n  // -------------------------------------------------------------------------\n\n  private _decodeStreamedCreate(\n    payload: MessagePayload,\n    serial: string | undefined,\n  ): DecoderOutput<TEvent, TMessage>[] {\n    if (!serial) return [];\n\n    const streamId = payload.headers?.[HEADER_STREAM_ID] ?? '';\n    const h = payload.headers ?? {};\n\n    const tracker: StreamTrackerState = {\n      name: payload.name,\n      streamId,\n      accumulated: '',\n      headers: { ...h },\n      closed: false,\n    };\n    this._serialState.set(serial, tracker);\n\n    this._logger?.debug('DefaultDecoderCore._decodeStreamedCreate(); new stream', {\n      name: payload.name,\n      streamId,\n      serial,\n    });\n\n    return this._hooks.buildStartEvents(tracker);\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: append handling\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CD8\n  private _decodeAppend(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[] {\n    const serial = message.serial;\n    if (!serial) return [];\n\n    const tracker = this._serialState.get(serial);\n    if (!tracker) {\n      // Unknown serial on append — treat as first-contact update\n      return this._decodeUpdate(message);\n    }\n\n    const h = getHeaders(message);\n    const delta = typeof message.data === 'string' ? message.data : '';\n    const status = h[HEADER_STATUS];\n    const outputs: DecoderOutput<TEvent, TMessage>[] = [];\n\n    if (delta.length > 0) {\n      tracker.accumulated += delta;\n      outputs.push(...this._hooks.buildDeltaEvents(tracker, delta));\n    }\n\n    if (status === 'finished' && !tracker.closed) {\n      tracker.closed = true;\n      outputs.push(...this._hooks.buildEndEvents(tracker, h));\n      this._logger?.debug('DefaultDecoderCore._decodeAppend(); stream finished', { streamId: tracker.streamId });\n    } else if (status === 'aborted' && !tracker.closed) {\n      tracker.closed = true;\n      this._logger?.debug('DefaultDecoderCore._decodeAppend(); stream aborted', { streamId: tracker.streamId });\n    }\n\n    return outputs;\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: update handling (first-contact, prefix-match, replacement)\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CD9\n  private _decodeUpdate(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[] {\n    const serial = message.serial;\n    if (!serial) return [];\n\n    const payload = this._toPayload(message);\n    const h = payload.headers ?? {};\n    const isStreamed = h[HEADER_STREAM] === 'true';\n    const status = h[HEADER_STATUS];\n\n    const tracker = this._serialState.get(serial);\n\n    if (!tracker) {\n      return this._decodeFirstContact(payload, isStreamed, status, serial);\n    }\n\n    // Updates to tracked streams use string data for prefix-match accumulation\n    const data = this._stringData(message);\n\n    // --- Tracker exists: prefix-match or replacement ---\n    if (data.startsWith(tracker.accumulated)) {\n      const delta = data.slice(tracker.accumulated.length);\n      const outputs: DecoderOutput<TEvent, TMessage>[] = [];\n\n      if (delta.length > 0) {\n        tracker.accumulated = data;\n        outputs.push(...this._hooks.buildDeltaEvents(tracker, delta));\n      }\n\n      if (status === 'finished' && !tracker.closed) {\n        tracker.closed = true;\n        outputs.push(...this._hooks.buildEndEvents(tracker, h));\n      } else if (status === 'aborted' && !tracker.closed) {\n        tracker.closed = true;\n      }\n\n      return outputs;\n    }\n\n    // --- Replacement (NOT a prefix match) ---\n    tracker.accumulated = data;\n    tracker.headers = { ...h };\n\n    this._invokeOnStreamUpdate(tracker);\n\n    return [];\n  }\n\n  private _decodeFirstContact(\n    payload: MessagePayload,\n    isStreamed: boolean,\n    status: string | undefined,\n    serial: string,\n  ): DecoderOutput<TEvent, TMessage>[] {\n    // Non-streamed messages are discrete\n    if (!isStreamed) {\n      return this._hooks.decodeDiscrete(payload);\n    }\n\n    const streamId = payload.headers?.[HEADER_STREAM_ID] ?? '';\n    const h = payload.headers ?? {};\n    const data = typeof payload.data === 'string' ? payload.data : '';\n\n    this._logger?.debug('DefaultDecoderCore._decodeFirstContact(); first-contact stream', {\n      name: payload.name,\n      streamId,\n      serial,\n    });\n\n    // Create tracker\n    const newTracker: StreamTrackerState = {\n      name: payload.name,\n      streamId,\n      accumulated: data,\n      headers: { ...h },\n      closed: status === 'finished' || status === 'aborted',\n    };\n    this._serialState.set(serial, newTracker);\n\n    // Emit start + delta (if any) + end (if finished)\n    const outputs = this._hooks.buildStartEvents(newTracker);\n\n    if (data.length > 0) {\n      outputs.push(...this._hooks.buildDeltaEvents(newTracker, data));\n    }\n\n    if (status === 'finished') {\n      outputs.push(...this._hooks.buildEndEvents(newTracker, h));\n    }\n\n    return outputs;\n  }\n\n  // -------------------------------------------------------------------------\n  // Private: delete handling\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CD10\n  private _decodeDelete(message: Ably.InboundMessage): DecoderOutput<TEvent, TMessage>[] {\n    const serial = message.serial;\n    if (!serial) return [];\n\n    const tracker = this._serialState.get(serial);\n\n    this._invokeOnStreamDelete(serial, tracker);\n\n    if (tracker) {\n      tracker.accumulated = '';\n      tracker.closed = true;\n    }\n\n    this._logger?.debug('DefaultDecoderCore._decodeDelete();', { serial });\n\n    return [];\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a decoder core with the given domain hooks.\n * @param hooks - Domain-specific hooks for stream classification, event building, and discrete decoding.\n * @param options - Decoder configuration (callbacks, logger).\n * @returns A new {@link DecoderCore} instance.\n */\nexport const createDecoderCore = <TEvent, TMessage>(\n  hooks: DecoderCoreHooks<TEvent, TMessage>,\n  options: DecoderCoreOptions = {},\n): DecoderCore<TEvent, TMessage> => new DefaultDecoderCore(hooks, options);\n","/**\n * Encoder core — message append lifecycle machinery.\n *\n * Provides Ably primitives (publish, append, close, abort, flush) that\n * domain-specific encoders wire their event types to.\n *\n * Domain encoders call `createEncoderCore(writer, options)` and use the\n * returned core to map domain events to Ably operations without\n * reimplementing the message append lifecycle.\n */\n\nimport * as Ably from 'ably';\n\nimport { HEADER_DISCRETE, HEADER_MSG_ID, HEADER_STATUS, HEADER_STREAM, HEADER_STREAM_ID } from '../../constants.js';\nimport { ErrorCode } from '../../errors.js';\nimport type { Logger } from '../../logger.js';\nimport { mergeHeaders } from '../../utils.js';\nimport type { ChannelWriter, EncoderOptions, Extras, MessagePayload, StreamPayload, WriteOptions } from './types.js';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\n/** Options for creating an encoder core. Extends {@link EncoderOptions} with a logger. */\nexport interface EncoderCoreOptions extends EncoderOptions {\n  /** Logger instance for diagnostic output. */\n  logger?: Logger;\n}\n\n// ---------------------------------------------------------------------------\n// Stream tracker (internal)\n// ---------------------------------------------------------------------------\n\ninterface StreamState {\n  serial: string;\n  name: string;\n  streamId: string;\n  accumulated: string;\n  persistentHeaders: Record<string, string>;\n  aborted: boolean;\n}\n\ninterface PendingAppend {\n  promise: Promise<Ably.UpdateDeleteResult>;\n  streamId: string;\n}\n\n// ---------------------------------------------------------------------------\n// Encoder core interface\n// ---------------------------------------------------------------------------\n\n/** The core encoder primitives that domain codec encoders delegate to. */\nexport interface EncoderCore {\n  /** Publish a single discrete (non-streaming) message described by a payload. */\n  publishDiscrete(payload: MessagePayload, opts?: WriteOptions): Promise<Ably.PublishResult>;\n\n  /** Publish multiple discrete messages atomically in a single channel publish. */\n  publishDiscreteBatch(payloads: MessagePayload[], opts?: WriteOptions): Promise<Ably.PublishResult>;\n\n  /** Start a streamed message with x-ably-status:streaming. */\n  startStream(streamId: string, payload: StreamPayload, opts?: WriteOptions): Promise<void>;\n\n  /**\n   * Append data to an in-flight streamed message. Fire-and-forget: errors are\n   * collected internally and surfaced by {@link closeStream} or {@link close}.\n   */\n  appendStream(streamId: string, data: string): void;\n\n  /**\n   * Close a streamed message with x-ably-status:finished. Flushes all pending\n   * appends for recovery before returning. Repeats persistent and payload headers.\n   */\n  closeStream(streamId: string, payload: StreamPayload): Promise<void>;\n\n  /**\n   * Abort a single in-progress stream (x-ably-status:aborted) and flush all\n   * pending appends for recovery before returning.\n   */\n  abortStream(streamId: string, opts?: WriteOptions): Promise<void>;\n\n  /**\n   * Abort all in-progress streams (x-ably-status:aborted) and flush all\n   * pending appends for recovery before returning.\n   */\n  abortAllStreams(opts?: WriteOptions): Promise<void>;\n\n  /** Flush + clear trackers. Idempotent. */\n  close(): Promise<void>;\n}\n\n// ---------------------------------------------------------------------------\n// Default implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CD1\nclass DefaultEncoderCore implements EncoderCore {\n  private readonly _writer: ChannelWriter;\n  private readonly _defaultClientId: string | undefined;\n  private readonly _defaultExtras: Extras | undefined;\n  private readonly _onMessageHook: (message: Ably.Message) => void;\n  private readonly _logger: Logger | undefined;\n  private readonly _trackers = new Map<string, StreamState>();\n  private _pending: PendingAppend[] = [];\n  private _flushPromise: Promise<void> | undefined;\n  private _closed = false;\n\n  constructor(writer: ChannelWriter, options: EncoderCoreOptions = {}) {\n    this._writer = writer;\n    this._defaultClientId = options.clientId;\n    this._defaultExtras = options.extras;\n    this._onMessageHook =\n      options.onMessage ??\n      (() => {\n        /* noop */\n      });\n    this._logger = options.logger?.withContext({ component: 'EncoderCore' });\n  }\n\n  // Spec: AIT-CD11\n  async publishDiscrete(payload: MessagePayload, opts?: WriteOptions): Promise<Ably.PublishResult> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.publishDiscrete();', { name: payload.name });\n    const msg = this._buildDiscreteMessage(payload, opts);\n    return this._writer.publish(msg);\n  }\n\n  // Spec: AIT-CD11a\n  async publishDiscreteBatch(payloads: MessagePayload[], opts?: WriteOptions): Promise<Ably.PublishResult> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.publishDiscreteBatch();', { count: payloads.length });\n    const msgs = payloads.map((p) => this._buildDiscreteMessage(p, opts));\n    // Mark batch-published payloads as discrete message parts (from writeMessages).\n    // The decoder relies on this header to distinguish message parts from lifecycle\n    // events that also happen to be discrete (x-ably-stream: false).\n    for (const msg of msgs) {\n      // CAST: extras is built by _buildDiscreteMessage with a known { headers } shape.\n      (msg.extras as { headers: Record<string, string> }).headers[HEADER_DISCRETE] = 'true';\n    }\n    return this._writer.publish(msgs);\n  }\n\n  // Spec: AIT-CD2\n  async startStream(streamId: string, payload: StreamPayload, opts?: WriteOptions): Promise<void> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.startStream();', { name: payload.name, streamId });\n\n    const allHeaders = this._buildHeaders(payload.headers ?? {}, opts);\n    allHeaders[HEADER_STREAM] = 'true';\n    allHeaders[HEADER_STATUS] = 'streaming';\n    allHeaders[HEADER_STREAM_ID] = streamId;\n\n    const clientId = this._resolveClientId(opts);\n    const msg: Ably.Message = {\n      name: payload.name,\n      data: payload.data,\n      extras: { headers: allHeaders },\n      ...(clientId ? { clientId } : {}),\n    };\n\n    this._invokeOnMessage(msg);\n    const result = await this._writer.publish(msg);\n    const serial = result.serials[0];\n\n    // Spec: AIT-CD2a\n    if (!serial) {\n      throw new Ably.ErrorInfo(\n        `unable to start stream; no serial returned for stream '${payload.name}' (streamId: ${streamId})`,\n        ErrorCode.BadRequest,\n        400,\n      );\n    }\n\n    this._trackers.set(streamId, {\n      serial,\n      name: payload.name,\n      streamId,\n      accumulated: payload.data,\n      persistentHeaders: allHeaders,\n      aborted: false,\n    });\n\n    this._logger?.debug('DefaultEncoderCore.startStream(); stream started', {\n      name: payload.name,\n      streamId,\n      serial,\n    });\n  }\n\n  // Spec: AIT-CD3\n  appendStream(streamId: string, data: string): void {\n    this._assertNotClosed();\n    // Spec: AIT-CD3a\n    const tracker = this._trackers.get(streamId);\n    if (!tracker) {\n      throw new Ably.ErrorInfo(\n        `unable to append to stream; no active stream for streamId '${streamId}'`,\n        ErrorCode.InvalidArgument,\n        400,\n      );\n    }\n\n    tracker.accumulated += data;\n\n    const appendMsg: Ably.Message = {\n      serial: tracker.serial,\n      data,\n      extras: { headers: { ...tracker.persistentHeaders } },\n    };\n\n    this._invokeOnMessage(appendMsg);\n    const p = this._writer.appendMessage(appendMsg);\n    this._pending.push({ promise: p, streamId });\n  }\n\n  // Spec: AIT-CD4, AIT-CD4a\n  async closeStream(streamId: string, payload: StreamPayload): Promise<void> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.closeStream();', { streamId });\n\n    const tracker = this._trackers.get(streamId);\n    if (!tracker) {\n      throw new Ably.ErrorInfo(\n        `unable to close stream; no active stream for streamId '${streamId}'`,\n        ErrorCode.InvalidArgument,\n        400,\n      );\n    }\n\n    // Accumulate closing data so recovery has the full content\n    tracker.accumulated += payload.data;\n\n    const allHeaders = this._buildClosingHeaders(tracker, payload.headers ?? {});\n    allHeaders[HEADER_STATUS] = 'finished';\n\n    const msg: Ably.Message = {\n      serial: tracker.serial,\n      data: payload.data,\n      extras: { headers: allHeaders },\n    };\n\n    this._invokeOnMessage(msg);\n    const p = this._writer.appendMessage(msg);\n    this._pending.push({ promise: p, streamId });\n\n    await this._flushPending();\n\n    this._logger?.debug('DefaultEncoderCore.closeStream(); stream closed', { streamId });\n  }\n\n  // Spec: AIT-CD5, AIT-CD5b\n  async abortStream(streamId: string, opts?: WriteOptions): Promise<void> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.abortStream();', { streamId });\n\n    const tracker = this._trackers.get(streamId);\n    if (!tracker) {\n      throw new Ably.ErrorInfo(\n        `unable to abort stream; no active stream for streamId '${streamId}'`,\n        ErrorCode.InvalidArgument,\n        400,\n      );\n    }\n\n    tracker.aborted = true;\n\n    const allHeaders = this._buildClosingHeaders(tracker, {}, opts);\n    allHeaders[HEADER_STATUS] = 'aborted';\n\n    const msg: Ably.Message = {\n      serial: tracker.serial,\n      data: '',\n      extras: { headers: allHeaders },\n    };\n\n    this._invokeOnMessage(msg);\n    const p = this._writer.appendMessage(msg);\n    this._pending.push({ promise: p, streamId });\n\n    await this._flushPending();\n\n    this._logger?.debug('DefaultEncoderCore.abortStream(); stream aborted', { streamId });\n  }\n\n  // Spec: AIT-CD5a\n  async abortAllStreams(opts?: WriteOptions): Promise<void> {\n    this._assertNotClosed();\n    this._logger?.trace('DefaultEncoderCore.abortAllStreams();', { streamCount: this._trackers.size });\n\n    for (const tracker of this._trackers.values()) {\n      tracker.aborted = true;\n\n      const allHeaders = this._buildClosingHeaders(tracker, {}, opts);\n      allHeaders[HEADER_STATUS] = 'aborted';\n\n      const msg: Ably.Message = {\n        serial: tracker.serial,\n        data: '',\n        extras: { headers: allHeaders },\n      };\n\n      this._invokeOnMessage(msg);\n      const p = this._writer.appendMessage(msg);\n      this._pending.push({ promise: p, streamId: tracker.streamId });\n    }\n\n    await this._flushPending();\n  }\n\n  // Spec: AIT-CD6\n  private async _flushPending(): Promise<void> {\n    // Re-entrancy guard: if a flush is already in progress, await it instead of starting a new one.\n    if (this._flushPromise) {\n      return this._flushPromise;\n    }\n\n    const snapshot = this._pending;\n    this._pending = [];\n\n    if (snapshot.length === 0) return;\n\n    this._logger?.trace('DefaultEncoderCore._flushPending();', { count: snapshot.length });\n\n    this._flushPromise = this._doFlush(snapshot);\n    try {\n      await this._flushPromise;\n    } finally {\n      this._flushPromise = undefined;\n    }\n  }\n\n  private async _doFlush(snapshot: PendingAppend[]): Promise<void> {\n    const results = await Promise.allSettled(snapshot.map(async (p) => p.promise));\n    const failures = new Set<string>();\n\n    for (const [i, result] of results.entries()) {\n      const entry = snapshot[i];\n      if (entry && result.status === 'rejected') {\n        failures.add(entry.streamId);\n      }\n    }\n\n    if (failures.size === 0) {\n      this._logger?.debug('DefaultEncoderCore._flushPending(); all appends succeeded');\n      return;\n    }\n\n    this._logger?.warn('DefaultEncoderCore._flushPending(); recovering failed appends', {\n      failedStreams: [...failures],\n    });\n\n    const recoveryErrors: { streamId: string; error: unknown }[] = [];\n\n    for (const streamId of failures) {\n      const tracker = this._trackers.get(streamId);\n      if (!tracker) continue;\n\n      const recoveryStatus = tracker.aborted ? 'aborted' : 'finished';\n      const msg: Ably.Message = {\n        serial: tracker.serial,\n        data: tracker.accumulated,\n        extras: { headers: { ...tracker.persistentHeaders, [HEADER_STATUS]: recoveryStatus } },\n      };\n\n      try {\n        await this._writer.updateMessage(msg);\n      } catch (error) {\n        recoveryErrors.push({ streamId, error });\n      }\n    }\n\n    if (recoveryErrors.length > 0) {\n      const ids = recoveryErrors.map((e) => e.streamId).join(', ');\n      this._logger?.error('DefaultEncoderCore._flushPending(); recovery failed', { failedStreams: ids });\n      throw new Ably.ErrorInfo(\n        `unable to flush pending appends; recovery failed for stream(s): ${ids}`,\n        ErrorCode.EncoderRecoveryFailed,\n        500,\n      );\n    }\n  }\n\n  // Spec: AIT-CD12\n  async close(): Promise<void> {\n    if (this._closed) return;\n    this._logger?.trace('DefaultEncoderCore.close();');\n    this._closed = true;\n    try {\n      await this._flushPending();\n    } finally {\n      this._trackers.clear();\n    }\n    this._logger?.debug('DefaultEncoderCore.close(); encoder closed');\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  // Spec: AIT-CD14\n  private _invokeOnMessage(msg: Ably.Message): void {\n    try {\n      this._onMessageHook(msg);\n    } catch (error) {\n      this._logger?.error('DefaultEncoderCore._invokeOnMessage(); hook threw', { error });\n    }\n  }\n\n  private _assertNotClosed(): void {\n    if (this._closed) {\n      throw new Ably.ErrorInfo('unable to write to encoder; encoder has been closed', ErrorCode.InvalidArgument, 400);\n    }\n  }\n\n  private _resolveClientId(opts?: WriteOptions): string | undefined {\n    return opts?.clientId ?? this._defaultClientId;\n  }\n\n  private _buildHeaders(codecHeaders: Record<string, string>, opts?: WriteOptions): Record<string, string> {\n    const callerHeaders = mergeHeaders(this._defaultExtras?.headers, opts?.extras?.headers);\n    const merged = { ...callerHeaders, ...codecHeaders };\n    if (opts?.messageId !== undefined) {\n      merged[HEADER_MSG_ID] = opts.messageId;\n    }\n    return merged;\n  }\n\n  private _buildDiscreteMessage(payload: MessagePayload, opts?: WriteOptions): Ably.Message {\n    const headers = this._buildHeaders(payload.headers ?? {}, opts);\n    headers[HEADER_STREAM] = 'false';\n    const clientId = this._resolveClientId(opts);\n\n    const msg: Ably.Message = {\n      name: payload.name,\n      data: payload.data,\n      extras: {\n        headers,\n        ...(payload.ephemeral ? { ephemeral: true } : {}),\n      },\n      ...(clientId ? { clientId } : {}),\n    };\n\n    this._invokeOnMessage(msg);\n    return msg;\n  }\n\n  /**\n   * Build headers for a closing append. Closing appends must repeat ALL\n   * persistent headers (Ably replaces the entire extras object on append).\n   * Then layer caller and codec overrides.\n   * @param tracker - The stream tracker with persistent headers.\n   * @param codecHeaders - Codec-layer headers to merge.\n   * @param opts - Optional per-write overrides.\n   * @returns Merged headers for the closing append.\n   */\n  private _buildClosingHeaders(\n    tracker: StreamState,\n    codecHeaders: Record<string, string>,\n    opts?: WriteOptions,\n  ): Record<string, string> {\n    const h = { ...tracker.persistentHeaders };\n    const callerHeaders = mergeHeaders(this._defaultExtras?.headers, opts?.extras?.headers);\n    Object.assign(h, callerHeaders);\n    Object.assign(h, codecHeaders);\n    return h;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create an encoder core bound to the given channel writer.\n * @param writer - The channel writer to publish messages through.\n * @param options - Encoder configuration (clientId, extras, hooks, logger).\n * @returns A new {@link EncoderCore} instance.\n */\nexport const createEncoderCore = (writer: ChannelWriter, options: EncoderCoreOptions = {}): EncoderCore =>\n  new DefaultEncoderCore(writer, options);\n","/**\n * Generic lifecycle tracker for codec decoders.\n *\n * Manages per-scope (typically per-turn) tracking of lifecycle phases that\n * must be emitted before content events. When a phase has not been emitted\n * (e.g. mid-stream join), the tracker synthesizes the missing events using\n * codec-provided build functions.\n *\n * Codecs configure the tracker with an ordered list of phases, then compose\n * it into their decoder hooks. The tracker is independent of any specific\n * codec or event type.\n */\n\n// ---------------------------------------------------------------------------\n// Phase configuration\n// ---------------------------------------------------------------------------\n\n/**\n * Configuration for a single lifecycle phase that may need to be\n * synthesized when missing from the wire stream.\n */\nexport interface PhaseConfig<TEvent> {\n  /** Unique key identifying this phase (e.g. \"start\", \"start-step\"). */\n  key: string;\n  /**\n   * Build the synthetic event(s) for this phase. Called with a context\n   * record that codecs populate at the call site — the tracker passes\n   * it through without interpreting it.\n   * @param context - Key-value pairs from the call site (e.g. headers).\n   * @returns One or more synthetic events to emit for this phase.\n   */\n  build(context: Record<string, string | undefined>): TEvent[];\n}\n\n// ---------------------------------------------------------------------------\n// Tracker interface\n// ---------------------------------------------------------------------------\n\n/**\n * Per-scope lifecycle tracker that ensures required phases are emitted\n * before content events, synthesizing missing ones for mid-stream joins.\n *\n * Scoped by an arbitrary string key (typically a turn ID). Each scope\n * tracks independently which phases have been emitted.\n */\nexport interface LifecycleTracker<TEvent> {\n  /**\n   * Ensure all configured phases have been emitted for the given scope.\n   * Returns synthetic events for any phases not yet marked as emitted,\n   * then marks them. Returns an empty array if all phases are current.\n   * @param scopeId - The scope to check (e.g. turn ID).\n   * @param context - Key-value pairs passed through to phase build functions.\n   * @returns Synthetic events for missing phases, in configuration order.\n   */\n  ensurePhases(scopeId: string, context: Record<string, string | undefined>): TEvent[];\n\n  /**\n   * Mark a phase as emitted from the wire (not synthetic). Call this\n   * when the real event arrives so the tracker does not re-synthesize it.\n   * @param scopeId - The scope (e.g. turn ID).\n   * @param phaseKey - The phase key to mark.\n   */\n  markEmitted(scopeId: string, phaseKey: string): void;\n\n  /**\n   * Reset a phase so it will be re-synthesized on the next\n   * {@link ensurePhases} call. Used for repeating phases (e.g. \"start-step\"\n   * resets after \"finish-step\").\n   * @param scopeId - The scope (e.g. turn ID).\n   * @param phaseKey - The phase key to reset.\n   */\n  resetPhase(scopeId: string, phaseKey: string): void;\n\n  /**\n   * Remove all tracking state for a scope. Call on turn completion\n   * (finish, abort) to free memory.\n   * @param scopeId - The scope to clear.\n   */\n  clearScope(scopeId: string): void;\n}\n\n// ---------------------------------------------------------------------------\n// Default implementation\n// ---------------------------------------------------------------------------\n\n// Spec: AIT-CD13\nclass DefaultLifecycleTracker<TEvent> implements LifecycleTracker<TEvent> {\n  private readonly _phases: PhaseConfig<TEvent>[];\n  private readonly _emitted = new Map<string, Set<string>>();\n\n  constructor(phases: PhaseConfig<TEvent>[]) {\n    this._phases = phases;\n  }\n\n  ensurePhases(scopeId: string, context: Record<string, string | undefined>): TEvent[] {\n    const emitted = this._getOrCreate(scopeId);\n    const events: TEvent[] = [];\n    for (const phase of this._phases) {\n      if (!emitted.has(phase.key)) {\n        emitted.add(phase.key);\n        events.push(...phase.build(context));\n      }\n    }\n    return events;\n  }\n\n  markEmitted(scopeId: string, phaseKey: string): void {\n    this._getOrCreate(scopeId).add(phaseKey);\n  }\n\n  resetPhase(scopeId: string, phaseKey: string): void {\n    this._emitted.get(scopeId)?.delete(phaseKey);\n  }\n\n  clearScope(scopeId: string): void {\n    this._emitted.delete(scopeId);\n  }\n\n  private _getOrCreate(scopeId: string): Set<string> {\n    let set = this._emitted.get(scopeId);\n    if (!set) {\n      set = new Set();\n      this._emitted.set(scopeId, set);\n    }\n    return set;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a lifecycle tracker configured with the given phases.\n * Phases are checked and synthesized in array order.\n * @param phases - Ordered phase configurations.\n * @returns A new {@link LifecycleTracker} instance.\n */\nexport const createLifecycleTracker = <TEvent>(phases: PhaseConfig<TEvent>[]): LifecycleTracker<TEvent> =>\n  new DefaultLifecycleTracker(phases);\n"],"mappings":"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"}