@ai-matrx/chat 0.1.74 → 0.2.0

package/dist/matrx/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/matrx/data-source.ts","../../src/matrx/transport.ts","../../src/model.ts","../../src/matrx/persistence.ts","../../src/tool-state.ts","../../src/ingest.ts","../../src/config.ts","../../src/ports.ts","../../src/store.ts","../../src/matrx/index.ts"],"sourcesContent":["/**\n * The data seam — a structural subset of `SupabaseClient<Database>`, the\n * `@ai-matrx/associations` precedent. `PromiseLike` rather than `Promise`\n * because supabase-js returns a thenable builder, not a Promise, and typing it\n * as a Promise makes a real client fail to satisfy the interface.\n *\n * Clients read and write the database DIRECTLY (workspace rule: the Python\n * server is for work a client cannot do, never a data middle tier), so this\n * port is a supabase-js client and nothing else is expected to implement it.\n */\n\nexport interface PgError {\n  message: string;\n  code?: string | undefined;\n  details?: string | undefined;\n  hint?: string | undefined;\n}\n\nexport interface PgResult<T> {\n  data: T | null;\n  error: PgError | null;\n}\n\nexport interface ChatSelectQuery extends PromiseLike<PgResult<unknown[]>> {\n  eq(column: string, value: unknown): ChatSelectQuery;\n  is(column: string, value: unknown): ChatSelectQuery;\n  in(column: string, values: readonly unknown[]): ChatSelectQuery;\n  lt(column: string, value: unknown): ChatSelectQuery;\n  order(column: string, options: { ascending: boolean }): ChatSelectQuery;\n  limit(count: number): ChatSelectQuery;\n}\n\nexport interface ChatTableQuery {\n  select(columns: string, options?: { count?: \"exact\"; head?: boolean }): ChatSelectQuery;\n  update(patch: Record<string, unknown>): {\n    eq(column: string, value: unknown): PromiseLike<{ error: PgError | null }>;\n  };\n}\n\nexport interface ChatDataSource {\n  schema(name: string): { from(table: string): ChatTableQuery };\n}\n\n/** The schema this package reads and writes. Renaming it breaks every read. */\nexport const CHAT_SCHEMA = \"chat\";\n\n/** The `chat.*` tables the persistence binding touches. */\nexport const CHAT_TABLES = {\n  conversation: \"conversation\",\n  message: \"message\",\n} as const;\n","/**\n * `@ai-matrx/chat/matrx` — THE PLATFORM TRANSPORT.\n *\n * Wire semantics verified against the aidream SERVER source and against LIVE\n * bytes, never guessed from a client (C22):\n *\n * - `POST /ai/agents/{agent_id}`               — start an agent turn\n * - `POST /ai/mandates/{mandate_key}`          — start a declared mandate\n * - `POST /ai/conversations/{conversation_id}` — continue a stored conversation\n * - `POST /ai/cancel/{request_id}?mode=interrupt` — cooperative stop\n *\n * The conversation-start triple (`conversation_id` / `is_new` / `store`) is\n * sent in full on every start, no defaults — `store: false` is the ONLY\n * ephemeral signal, and the kernel derives it from whether a persistence port\n * exists, so an unpersisted thread never silently writes rows.\n */\n\nimport {\n  cancelAgentRun,\n  continueAgentConversation,\n  startAgentRun,\n  startMandateRun,\n  type MatrxTransport,\n} from \"@ai-matrx/agents/matrx\";\n\nimport type {\n  ChatNotifierPort,\n  ChatSendRequest,\n  ChatStreamFrame,\n  ChatTransportPort,\n  ChatTurnHandle,\n} from \"../ports\";\n\n/** Which brain this thread talks to. */\nexport type MatrxChatTarget =\n  | { kind: \"agent\"; agentId: string }\n  | { kind: \"mandate\"; mandateKey: string };\n\n/**\n * THE REFERENCE SHAPE EVERY CLIENT ALREADY SPEAKS. `AgentListDropdown` hands\n * back an agent id, or `mandate:<key>` for the platform-default row. This is\n * the ONE place that turns those words into a target, so a host wiring the\n * picker does not each invent the same two-line parse — and an empty reference\n * throws by name instead of starting a run against nothing.\n */\nexport function parseMatrxChatTarget(agentRef: string): MatrxChatTarget {\n  const trimmed = agentRef.trim();\n  if (trimmed === \"\") {\n    throw new Error(\n      \"@ai-matrx/chat/matrx: an empty agent reference cannot name who answers. Pass an agent id, or `mandate:<key>` for a mandate.\",\n    );\n  }\n  if (trimmed.startsWith(\"mandate:\")) {\n    const mandateKey = trimmed.slice(\"mandate:\".length).trim();\n    if (mandateKey === \"\") {\n      throw new Error(\n        \"@ai-matrx/chat/matrx: `mandate:` with no key cannot name who answers.\",\n      );\n    }\n    return { kind: \"mandate\", mandateKey };\n  }\n  return { kind: \"agent\", agentId: trimmed };\n}\n\n/** The same target, as the two strings a screen and a test can compare. */\nexport function matrxChatTargetRef(target: MatrxChatTarget): string {\n  return target.kind === \"agent\"\n    ? target.agentId\n    : `mandate:${target.mandateKey}`;\n}\n\n/**\n * THE LIVE CHOICE — what the composer's pickers write into, and what the next\n * send reads.\n *\n * It is a tiny subscribable rather than React state on purpose: the transport\n * is a PURE-layer object built once, outside React, and a transport that closed\n * over the target at construction would keep answering as the agent the reader\n * changed away from. The picker sets it, the transport reads it per turn, and\n * anything that wants to paint the current choice subscribes.\n */\nexport interface MatrxChatTargetRef {\n  get(): MatrxChatTarget;\n  getModel(): string | null;\n  set(target: MatrxChatTarget): void;\n  setModel(model: string | null): void;\n  subscribe(listener: () => void): () => void;\n}\n\nexport function createMatrxChatTargetRef(\n  initial: MatrxChatTarget,\n  initialModel: string | null = null,\n): MatrxChatTargetRef {\n  let target = initial;\n  let model = initialModel;\n  const listeners = new Set<() => void>();\n  const wake = (): void => {\n    for (const listener of listeners) listener();\n  };\n  return {\n    get: () => target,\n    getModel: () => model,\n    set(next) {\n      if (matrxChatTargetRef(next) === matrxChatTargetRef(target)) return;\n      target = next;\n      wake();\n    },\n    setModel(next) {\n      const normalized = next === null || next.trim() === \"\" ? null : next;\n      if (normalized === model) return;\n      model = normalized;\n      wake();\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\nexport const TARGET_IGNORED_ON_CONTINUE =\n  \"This conversation keeps answering as the agent it was started with, so your new choice was not used for that message.\";\nexport const TARGET_IGNORED_ON_CONTINUE_REMEDY =\n  \"Start a new conversation to talk to the one you just picked.\";\n\nexport interface MatrxChatTransportOptions {\n  /**\n   * The `MatrxTransport` port. Build it with\n   * `createMatrxTransport({ baseUrl, credentials, organizationId })` from\n   * `@ai-matrx/agents/matrx` — that is the production pipeline (retry,\n   * connect timeout, the v2→v1 protocol fallback, fresh credentials per call,\n   * the fail-closed org header). Hand-rolling a fetch here loses all of it.\n   */\n  transport: MatrxTransport;\n  /**\n   * Who answers. A FUNCTION is the live form: the pickers change the choice\n   * between turns, and the transport resolves it at the moment of the send\n   * rather than at construction (`createMatrxChatTargetRef().get`).\n   */\n  target: MatrxChatTarget | (() => MatrxChatTarget);\n  /**\n   * The model the reader picked, resolved per turn the same way. It rides\n   * `config_overrides.model` (the server's `LLMParams`), and `null` means the\n   * agent's own configured model is used — the transport never sends a null\n   * override, because a blank override is a silent reconfiguration.\n   */\n  model?: string | null | (() => string | null) | undefined;\n  /** REQUIRED by the server: it never manufactures an organization. */\n  organizationId: string;\n  /**\n   * Attribution. The server REFUSES an unregistered pair with a 422 naming\n   * the registry — that is deliberate, and a caller that invents a slug gets\n   * a loud rejection rather than an unattributable row.\n   */\n  sourceApp: string;\n  sourceFeature: string;\n  /** \"user\" = a person pressed send; \"auto\" = client automation. */\n  initiation?: \"user\" | \"auto\" | undefined;\n  /**\n   * Where this transport sends text. The kernel's confidential-routing rule\n   * reads it, so answering \"local\" for a cloud endpoint defeats the rule.\n   */\n  locality?: \"local\" | \"cloud\" | undefined;\n  /** Extra scope/context merged into every turn body. */\n  extra?: Record<string, unknown> | undefined;\n  /**\n   * Where the transport says what it could not do. It is used for exactly one\n   * sentence today: a CONTINUE cannot change who answers (the server resolves\n   * the conversation's own agent), so a reader who picks a different agent\n   * mid-conversation is TOLD their choice did not apply to that message, once\n   * per conversation, with the remedy. Without it the picker would silently\n   * lie about who just replied.\n   */\n  notifier?: ChatNotifierPort | undefined;\n}\n\nfunction mintConversationId(): string {\n  const cryptoRef: { randomUUID?: () => string } | undefined = (\n    globalThis as { crypto?: { randomUUID?: () => string } }\n  ).crypto;\n  if (typeof cryptoRef?.randomUUID === \"function\") return cryptoRef.randomUUID();\n  throw new Error(\n    \"@ai-matrx/chat/matrx needs crypto.randomUUID to mint a conversation id (the client mints it, by contract). \" +\n      \"Run on Node 19+, a browser, Deno or Bun, or pass an explicit conversationId to the thread.\",\n  );\n}\n\nexport function createMatrxChatTransport(\n  options: MatrxChatTransportOptions,\n): ChatTransportPort {\n  const initiation = options.initiation ?? \"user\";\n  const resolveTarget = (): MatrxChatTarget =>\n    typeof options.target === \"function\" ? options.target() : options.target;\n  const resolveModel = (): string | null => {\n    const model =\n      typeof options.model === \"function\" ? options.model() : (options.model ?? null);\n    return model === null || model.trim() === \"\" ? null : model;\n  };\n  // The target a conversation was STARTED with, so a later continue can tell\n  // the reader their new choice did not reach this transcript. Announced once\n  // per conversation: one sentence is information, one per message is noise.\n  const startedAs = new Map<string, string>();\n  const warned = new Set<string>();\n  const scope = {\n    organization_id: options.organizationId,\n    source_app: options.sourceApp,\n    source_feature: options.sourceFeature,\n    initiation,\n    ...options.extra,\n  };\n\n  return {\n    locality: options.locality ?? \"cloud\",\n\n    async start(request: ChatSendRequest): Promise<ChatTurnHandle> {\n      const signalOption = { signal: request.signal };\n\n      const model = resolveModel();\n      // A null override is NEVER sent: `config_overrides: { model: null }` is a\n      // blank reconfiguration of the agent, not \"leave it alone\".\n      const overrides = model === null ? {} : { config_overrides: { model } };\n\n      if (request.conversationId !== null && !request.isNewConversation) {\n        const openedAs = startedAs.get(request.conversationId);\n        const chosen = matrxChatTargetRef(resolveTarget());\n        if (\n          openedAs !== undefined &&\n          openedAs !== chosen &&\n          !warned.has(request.conversationId)\n        ) {\n          warned.add(request.conversationId);\n          options.notifier?.notify({\n            level: \"warning\",\n            message: TARGET_IGNORED_ON_CONTINUE,\n            remedy: TARGET_IGNORED_ON_CONTINUE_REMEDY,\n          });\n        }\n        const handle = await continueAgentConversation(\n          options.transport,\n          request.conversationId,\n          { ...scope, ...overrides, user_input: request.text },\n          signalOption,\n        );\n        return toChatTurnHandle(handle);\n      }\n\n      const target = resolveTarget();\n      const conversationId = request.conversationId ?? mintConversationId();\n      startedAs.set(conversationId, matrxChatTargetRef(target));\n      const body = {\n        ...scope,\n        ...overrides,\n        // THE CONVERSATION-START TRIPLE, in full, every time.\n        conversation_id: conversationId,\n        is_new: true as const,\n        store: request.store,\n        user_input: request.text,\n      };\n      const handle =\n        target.kind === \"agent\"\n          ? await startAgentRun(\n              options.transport,\n              target.agentId,\n              body as Parameters<typeof startAgentRun>[2],\n              signalOption,\n            )\n          : await startMandateRun(\n              options.transport,\n              target.mandateKey,\n              body as Parameters<typeof startMandateRun>[2],\n              signalOption,\n            );\n      return toChatTurnHandle(handle, conversationId);\n    },\n\n    async cancel(requestId: string): Promise<void> {\n      // `interrupt` is stop-and-fork: the tail after the last clean boundary\n      // persists hidden, so the reader's next message replies to what they\n      // actually saw. A plain cancel loses that.\n      await cancelAgentRun(options.transport, requestId, { mode: \"interrupt\" });\n    },\n  };\n}\n\nfunction toChatTurnHandle(\n  handle: {\n    requestId: string | null;\n    conversationId: string | null;\n    events: AsyncIterable<{\n      event: string;\n      data: unknown;\n      stream_id?: string | undefined;\n      stream_seq?: number | undefined;\n    }>;\n  },\n  mintedConversationId?: string,\n): ChatTurnHandle {\n  return {\n    requestId: handle.requestId,\n    conversationId: handle.conversationId ?? mintedConversationId ?? null,\n    frames: handle.events as AsyncIterable<ChatStreamFrame>,\n  };\n}\n","/**\n * The message / part model — layer 1 of `@ai-matrx/chat`.\n *\n * Deliberately the industry-canonical shape (Vercel AI SDK `UIMessage.parts[]`\n * plus its tool-part state machine), because our own\n * `@ai-matrx/agents/projection/request` already produces its equivalent and a\n * customer's agent already knows it. Nothing here imports React, Redux, a\n * framework, or `window`.\n *\n * Every part type below was chosen against BYTES, not against a guess: the\n * live corpus in `fixtures/corpus/` carries text, reasoning (both wire\n * shapes), tool lifecycle, warnings and a fatal error, and the persisted\n * `chat.message.content` rows carry `text` | `thinking` | `tool_call` |\n * `tool_result`.\n */\n\n/** JSON on the wire. Public JSON boundaries are `unknown`-typed by standard. */\nexport type ChatJsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | ChatJsonValue[]\n  | { [key: string]: ChatJsonValue };\n\nexport type ChatRole = \"user\" | \"assistant\" | \"system\" | \"tool\";\n\n/**\n * THE TOOL STATE MACHINE (the champion's, verbatim). A tool part only ever\n * moves forward along these states; `advanceToolState` in `./tool-state`\n * refuses anything else out loud rather than silently overwriting.\n */\nexport type ChatToolState =\n  | \"input-streaming\"\n  | \"input-available\"\n  | \"approval-requested\"\n  | \"output-available\"\n  | \"output-error\"\n  | \"output-denied\";\n\n/** One tool progress beat — the `tool_event`/`tool_progress` frames. */\nexport interface ChatToolProgress {\n  /** The tool name the SERVER used on this beat: it differs from the call's\n   *  tool name mid-run (`web` → `web_search` → `web_research` in the corpus),\n   *  and flattening them loses what actually ran. */\n  toolName: string;\n  message: string;\n  percent: number | null;\n  /** Server timestamp in seconds, verbatim; null when the frame carried none. */\n  at: number | null;\n}\n\nexport interface ChatTextPart {\n  readonly type: \"text\";\n  text: string;\n}\n\nexport interface ChatReasoningPart {\n  readonly type: \"reasoning\";\n  text: string;\n  state: \"streaming\" | \"done\";\n}\n\nexport interface ChatToolPart {\n  readonly type: \"tool\";\n  /** The provider/server call id — the ONLY identity a tool part has. */\n  toolCallId: string;\n  toolName: string;\n  state: ChatToolState;\n  input: unknown;\n  output: unknown;\n  /** Present only in `output-error`; null otherwise. */\n  errorText: string | null;\n  progress: ChatToolProgress[];\n  /** True once the server emitted `tool_delegated` — the CLIENT must run it. */\n  delegated: boolean;\n}\n\nexport interface ChatFilePart {\n  readonly type: \"file\";\n  /** A durable Matrx file id. A signed URL is a handoff, never an identity. */\n  fileId: string;\n  name: string | null;\n  mediaType: string | null;\n}\n\nexport interface ChatSourcePart {\n  readonly type: \"source\";\n  sourceId: string;\n  url: string | null;\n  title: string | null;\n}\n\nexport interface ChatRenderBlockPart {\n  readonly type: \"render-block\";\n  blockId: string;\n  blockIndex: number;\n  /** The content-IR kind name. */\n  kind: string;\n  content: string | null;\n  data: unknown;\n  status: \"streaming\" | \"complete\" | \"error\";\n}\n\nexport interface ChatAskUserPart {\n  readonly type: \"ask-user\";\n  askId: string;\n  prompt: string;\n  fields: unknown;\n  answered: boolean;\n}\n\n/**\n * A failure the READER must see. `userMessage` is what a screen shows;\n * `remedy` is what the reader can do about it. Law 4 — nothing fails\n * silently, and a stand-in announces itself WITH a remedy.\n */\nexport interface ChatErrorPart {\n  readonly type: \"error\";\n  errorType: string | null;\n  code: string | null;\n  message: string;\n  userMessage: string;\n  recoverable: boolean;\n  remedy: string | null;\n}\n\n/**\n * A non-fatal server notice (`warning` / `info` frames). It is a PART, not a\n * side channel, because the corpus proves a run can lose half its tools and\n * still answer — and a reader who is not told has been lied to.\n */\nexport interface ChatNoticePart {\n  readonly type: \"notice\";\n  level: \"info\" | \"low\" | \"medium\" | \"high\";\n  code: string | null;\n  userMessage: string;\n  remedy: string | null;\n}\n\nexport type ChatPart =\n  | ChatTextPart\n  | ChatReasoningPart\n  | ChatToolPart\n  | ChatFilePart\n  | ChatSourcePart\n  | ChatRenderBlockPart\n  | ChatAskUserPart\n  | ChatErrorPart\n  | ChatNoticePart;\n\nexport type ChatMessageStatus =\n  | \"pending\"\n  | \"streaming\"\n  | \"complete\"\n  | \"error\"\n  | \"cancelled\";\n\nexport interface ChatMessageMetadata {\n  /** The server's `X-Request-ID` for the turn this message belongs to. */\n  requestId: string | null;\n  /** The server `chat.message` row id once `record_update` announced it. */\n  serverMessageId: string | null;\n  /** Model id/name the server reported, when it reported one. Never a UUID on\n   *  screen — `renderModelRef` resolves it (phase 2). */\n  modelRef: string | null;\n  createdAt: string;\n  /** Free-form server metadata (finish_reason, usage, …), verbatim. */\n  raw: Record<string, unknown> | null;\n}\n\nexport interface ChatMessage {\n  id: string;\n  role: ChatRole;\n  parts: ChatPart[];\n  status: ChatMessageStatus;\n  metadata: ChatMessageMetadata;\n}\n\n/**\n * THE THREAD STATE MACHINE.\n * `idle → submitted → streaming → (awaiting-approval) → idle | error`.\n */\nexport type ChatThreadStatus =\n  | \"idle\"\n  | \"submitted\"\n  | \"streaming\"\n  | \"awaiting-approval\"\n  | \"error\";\n\nexport interface ChatThreadSnapshot {\n  conversationId: string | null;\n  /** Ordered oldest-first. */\n  messages: readonly ChatMessage[];\n  status: ChatThreadStatus;\n  /** The server request id of the CURRENT or last turn — the only id the\n   *  server accepts for cancel. */\n  requestId: string | null;\n  /** Last server `phase`, verbatim. */\n  phase: string | null;\n  /**\n   * TRUE when nothing is persisting this thread. The screen must SAY so with\n   * the remedy (`ephemeralReason`) — an unannounced ephemeral thread is the\n   * silent failure Law 4 forbids.\n   */\n  ephemeral: boolean;\n  ephemeralReason: string | null;\n  /** Monotonic; bumps on every applied change so hosts can cheap-compare. */\n  revision: number;\n  /** Last fatal error for the thread, if any. */\n  error: ChatErrorPart | null;\n}\n\nlet idCounter = 0;\n\n/**\n * A collision-resistant local id. `crypto.randomUUID` when the runtime has it\n * (browsers, node >= 19, Deno, Bun), and a counter+random fallback that\n * announces nothing because it is not a stand-in for a capability — it is the\n * same guarantee by other means.\n */\nexport function newLocalId(prefix: string): string {\n  const cryptoRef: { randomUUID?: () => string } | undefined = (\n    globalThis as { crypto?: { randomUUID?: () => string } }\n  ).crypto;\n  if (typeof cryptoRef?.randomUUID === \"function\") {\n    return `${prefix}_${cryptoRef.randomUUID()}`;\n  }\n  idCounter += 1;\n  return `${prefix}_${Date.now().toString(36)}_${idCounter.toString(36)}_${Math.random()\n    .toString(36)\n    .slice(2, 10)}`;\n}\n\nexport function createChatMessage(input: {\n  id?: string | undefined;\n  role: ChatRole;\n  parts?: ChatPart[] | undefined;\n  status?: ChatMessageStatus | undefined;\n  metadata?: Partial<ChatMessageMetadata> | undefined;\n}): ChatMessage {\n  return {\n    id: input.id ?? newLocalId(\"msg\"),\n    role: input.role,\n    parts: input.parts ?? [],\n    status: input.status ?? \"complete\",\n    metadata: {\n      requestId: input.metadata?.requestId ?? null,\n      serverMessageId: input.metadata?.serverMessageId ?? null,\n      modelRef: input.metadata?.modelRef ?? null,\n      createdAt: input.metadata?.createdAt ?? new Date().toISOString(),\n      raw: input.metadata?.raw ?? null,\n    },\n  };\n}\n\n/** Every `text` part concatenated — what a copy button copies. */\nexport function messageText(message: ChatMessage): string {\n  let out = \"\";\n  for (const part of message.parts) if (part.type === \"text\") out += part.text;\n  return out;\n}\n\n/** Every `reasoning` part concatenated. */\nexport function messageReasoning(message: ChatMessage): string {\n  let out = \"\";\n  for (const part of message.parts) if (part.type === \"reasoning\") out += part.text;\n  return out;\n}\n\n/** Tool parts in first-seen order. */\nexport function messageTools(message: ChatMessage): ChatToolPart[] {\n  return message.parts.filter((p): p is ChatToolPart => p.type === \"tool\");\n}\n","/**\n * THE `chat.*` PERSISTENCE BINDING — conversation history and transcript\n * loading, read DIRECTLY from Postgres under RLS (clients never route ordinary\n * reads through the Python server).\n *\n * Verified against the live schema on 2026-09-17:\n *   `chat.conversation(id, title, created_at, updated_at, deleted_at,\n *      message_count, source_app, source_feature, is_ephemeral,\n *      metadata, organization_id, …)`\n *   `chat.message(id, conversation_id, role, position, status, content jsonb,\n *      metadata, created_at, is_visible_to_user, deleted_at, …)`\n *\n * `chat.message.content` is an ARRAY OF PARTS, and the persisted part\n * vocabulary — read off real rows, not guessed — is `text` | `thinking` |\n * `tool_call` | `tool_result`. `mapPersistedContent` is the ONE place that\n * vocabulary is translated into this package's part model; a second translator\n * anywhere is the defect this binding exists to prevent.\n *\n * 🚨 ARCHIVE: `chat.conversation` has no boolean archive column. Archive state\n * lives in `metadata.archived`, which is what the platform already writes, and\n * THE ARCHIVED-ITEMS LAW is honoured in the reader: the default list hides\n * archived rows and REPORTS how many it hid, so the footer can name them.\n */\n\nimport type {\n  ChatConversationListPage,\n  ChatConversationListQuery,\n  ChatConversationSummary,\n  ChatPersistencePort,\n} from \"../ports\";\nimport {\n  createChatMessage,\n  type ChatMessage,\n  type ChatPart,\n  type ChatRole,\n  type ChatToolPart,\n} from \"../model\";\nimport {\n  CHAT_SCHEMA,\n  CHAT_TABLES,\n  type ChatDataSource,\n  type PgError,\n} from \"./data-source\";\n\nconst CONVERSATION_COLUMNS =\n  \"id,title,created_at,updated_at,message_count,source_app,source_feature,metadata\";\n/** Favorites are PER PERSON: the caller's `platform.user_entity_state` row (RLS: own rows only),\n *  never a column on the conversation (dropped by aidream migration 1377). */\nconst FAVORITES_SCHEMA = \"platform\";\nconst FAVORITES_TABLE = \"user_entity_state\";\nconst MESSAGE_COLUMNS =\n  \"id,role,position,status,content,metadata,created_at,is_visible_to_user\";\n\nconst DEFAULT_LIMIT = 50;\n\nexport interface MatrxChatPersistenceOptions {\n  dataSource: ChatDataSource;\n  /**\n   * The host's ACTIVE organization. It NO LONGER narrows any read: a person's\n   * history spans every organization they can access, and access is decided by\n   * RLS (active-org-is-never-a-list-filter.md). Kept optional so existing hosts\n   * compile; a page that wants to narrow passes `organizationFilter` on the\n   * list query instead.\n   */\n  organizationId?: string | undefined;\n  /** Diagnostics for a failed read; absent ⇒ the error is thrown to the caller. */\n  onError?: ((error: PgError, operation: string) => void) | undefined;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\nfunction asString(value: unknown): string | null {\n  return typeof value === \"string\" ? value : null;\n}\n\n/** Whether a persisted conversation row is archived. */\nexport function isArchivedRow(row: Record<string, unknown>): boolean {\n  const metadata = asRecord(row.metadata);\n  return metadata.archived === true;\n}\n\nexport function toConversationSummary(\n  row: Record<string, unknown>,\n  favorites: ReadonlySet<string> = new Set(),\n): ChatConversationSummary {\n  const createdAt = asString(row.created_at) ?? new Date(0).toISOString();\n  return {\n    id: asString(row.id) ?? \"\",\n    title: asString(row.title),\n    createdAt,\n    updatedAt: asString(row.updated_at) ?? createdAt,\n    messageCount: typeof row.message_count === \"number\" ? row.message_count : 0,\n    archived: isArchivedRow(row),\n    isFavorite: favorites.has(asString(row.id) ?? \"\"),\n    sourceApp: asString(row.source_app),\n    sourceFeature: asString(row.source_feature),\n  };\n}\n\n/**\n * Translate ONE persisted `chat.message.content` array into parts.\n *\n * Unknown persisted types are NOT dropped: they become a `notice` part naming\n * the type, because a transcript that silently loses a part is a screen that\n * lies about what was said.\n */\nexport function mapPersistedContent(content: unknown): ChatPart[] {\n  if (!Array.isArray(content)) return [];\n  const parts: ChatPart[] = [];\n  const toolsByCallId = new Map<string, ChatToolPart>();\n\n  for (const entry of content) {\n    const item = asRecord(entry);\n    const type = asString(item.type);\n    switch (type) {\n      case \"text\": {\n        const text = asString(item.text) ?? \"\";\n        if (text) parts.push({ type: \"text\", text });\n        break;\n      }\n      case \"thinking\":\n      case \"reasoning\": {\n        const text = asString(item.text) ?? \"\";\n        // A signature-only thinking block (no text) is a provider round-trip\n        // artefact, not something a reader ever sees.\n        if (text) parts.push({ type: \"reasoning\", text, state: \"done\" });\n        break;\n      }\n      case \"tool_call\": {\n        const callId = asString(item.call_id) ?? asString(item.id);\n        const toolName = asString(item.name) ?? \"tool\";\n        if (callId === null) break;\n        const part: ChatToolPart = {\n          type: \"tool\",\n          toolCallId: callId,\n          toolName,\n          state: \"input-available\",\n          input: item.arguments ?? item.input,\n          output: undefined,\n          errorText: null,\n          progress: [],\n          delegated: false,\n        };\n        toolsByCallId.set(callId, part);\n        parts.push(part);\n        break;\n      }\n      case \"tool_result\": {\n        const callId =\n          asString(item.call_id) ?? asString(item.tool_use_id) ?? asString(item.id);\n        if (callId === null) break;\n        const isError = item.is_error === true;\n        const existing = toolsByCallId.get(callId);\n        if (existing) {\n          existing.state = isError ? \"output-error\" : \"output-available\";\n          existing.output = item.output ?? item.content ?? item.result;\n          existing.errorText = isError\n            ? (asString(item.error) ?? `The ${existing.toolName} tool failed.`)\n            : null;\n          break;\n        }\n        // A result whose call landed in an EARLIER message row (the common\n        // shape: `assistant` holds the call, `tool` holds the result).\n        parts.push({\n          type: \"tool\",\n          toolCallId: callId,\n          toolName: asString(item.name) ?? \"tool\",\n          state: isError ? \"output-error\" : \"output-available\",\n          input: undefined,\n          output: item.output ?? item.content ?? item.result,\n          errorText: isError ? (asString(item.error) ?? \"The tool failed.\") : null,\n          progress: [],\n          delegated: false,\n        });\n        break;\n      }\n      default: {\n        parts.push({\n          type: \"notice\",\n          level: \"low\",\n          code: \"unrenderable_persisted_part\",\n          userMessage: `Part of this message could not be shown (stored as \"${type ?? \"unknown\"}\").`,\n          remedy: null,\n        });\n      }\n    }\n  }\n  return parts;\n}\n\n/**\n * Fold the persisted rows into the thread's messages.\n *\n * A `tool` row carries only results for a call made in the PREVIOUS assistant\n * row; merging it into that row is what makes one tool card instead of two\n * half-cards, and it is exactly the logic every host re-derived.\n */\nexport function mapPersistedMessages(\n  rows: readonly Record<string, unknown>[],\n): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n  for (const row of rows) {\n    if (row.is_visible_to_user === false) continue;\n    const role = (asString(row.role) ?? \"assistant\") as ChatRole;\n    const parts = mapPersistedContent(row.content);\n\n    if (role === \"tool\") {\n      const previous = messages[messages.length - 1];\n      if (previous && previous.role === \"assistant\") {\n        for (const part of parts) {\n          if (part.type !== \"tool\") {\n            previous.parts.push(part);\n            continue;\n          }\n          const match = previous.parts.find(\n            (candidate): candidate is ChatToolPart =>\n              candidate.type === \"tool\" && candidate.toolCallId === part.toolCallId,\n          );\n          if (match) {\n            match.state = part.state;\n            match.output = part.output;\n            match.errorText = part.errorText;\n          } else {\n            previous.parts.push(part);\n          }\n        }\n        continue;\n      }\n    }\n\n    const status = asString(row.status);\n    messages.push(\n      createChatMessage({\n        id: asString(row.id) ?? undefined,\n        role,\n        parts,\n        status: status === \"error\" ? \"error\" : \"complete\",\n        metadata: {\n          serverMessageId: asString(row.id),\n          createdAt: asString(row.created_at) ?? new Date(0).toISOString(),\n          raw: asRecord(row.metadata),\n        },\n      }),\n    );\n  }\n  return messages;\n}\n\nexport function createMatrxChatPersistence(\n  options: MatrxChatPersistenceOptions,\n): ChatPersistencePort {\n  const table = (name: string) =>\n    options.dataSource.schema(CHAT_SCHEMA).from(name);\n\n  const fail = (error: PgError, operation: string): never => {\n    options.onError?.(error, operation);\n    throw new Error(`[ai-matrx/chat] ${operation} failed: ${error.message}`);\n  };\n\n  /** The caller's favorites among these conversations. A failed read is reported and the page is\n   *  still returned (with no stars) — a list never disappears because the star read failed. */\n  const readFavorites = async (ids: string[]): Promise<Set<string>> => {\n    if (ids.length === 0) return new Set();\n    const { data, error } = await options.dataSource\n      .schema(FAVORITES_SCHEMA)\n      .from(FAVORITES_TABLE)\n      .select(\"entity_id\")\n      .eq(\"entity_type\", \"conversation\")\n      .eq(\"is_favorite\", true)\n      .in(\"entity_id\", ids);\n    if (error) {\n      options.onError?.(error, \"listConversations.favorites\");\n      return new Set();\n    }\n    return new Set(((data ?? []) as Record<string, unknown>[]).map((r) => asString(r.entity_id) ?? \"\"));\n  };\n\n  return {\n    async loadThread(conversationId: string): Promise<ChatMessage[]> {\n      const { data, error } = await table(CHAT_TABLES.message)\n        .select(MESSAGE_COLUMNS)\n        .eq(\"conversation_id\", conversationId)\n        .is(\"deleted_at\", null)\n        .order(\"position\", { ascending: true });\n      if (error) fail(error, \"loadThread\");\n      return mapPersistedMessages((data ?? []) as Record<string, unknown>[]);\n    },\n\n    async listConversations(\n      query: ChatConversationListQuery,\n    ): Promise<ChatConversationListPage> {\n      const limit = query.limit ?? DEFAULT_LIMIT;\n      let builder = table(CHAT_TABLES.conversation)\n        .select(CONVERSATION_COLUMNS)\n        .is(\"deleted_at\", null)\n        .order(\"updated_at\", { ascending: false })\n        // Over-read by one so the caller gets an honest `nextBefore` instead\n        // of a \"there might be more\" guess, and by the archive headroom so\n        // hiding archived rows does not silently shorten the page.\n        .limit(limit * 2 + 1);\n      if (query.before !== undefined) builder = builder.lt(\"updated_at\", query.before);\n      // The page's OWN organization filter — absent/null = all organizations.\n      if (query.organizationFilter) {\n        builder = builder.eq(\"organization_id\", query.organizationFilter);\n      }\n      if (query.sourceApp !== undefined) {\n        builder = builder.eq(\"source_app\", query.sourceApp);\n      }\n      if (query.sourceFeature !== undefined) {\n        builder = builder.eq(\"source_feature\", query.sourceFeature);\n      }\n\n      const { data, error } = await builder;\n      if (error) fail(error, \"listConversations\");\n\n      const rows = (data ?? []) as Record<string, unknown>[];\n      const favorites = await readFavorites(rows.map((r) => asString(r.id)).filter((id): id is string => !!id));\n      const includeArchived = query.includeArchived === true;\n      let archivedHidden = 0;\n      const kept: ChatConversationSummary[] = [];\n      let nextBefore: string | null = null;\n\n      for (const row of rows) {\n        const summary = toConversationSummary(row, favorites);\n        if (!includeArchived && summary.archived) {\n          archivedHidden += 1;\n          continue;\n        }\n        if (kept.length === limit) {\n          nextBefore = summary.updatedAt;\n          break;\n        }\n        kept.push(summary);\n      }\n\n      return { conversations: kept, archivedHidden, nextBefore };\n    },\n\n    async setArchived(conversationId: string, archived: boolean): Promise<void> {\n      // `metadata` is jsonb and carries more than this flag, so the write is\n      // READ-MERGE-WRITE and never a blind overwrite — a `{archived:true}`\n      // update would delete every other key in the column.\n      const read = await table(CHAT_TABLES.conversation)\n        .select(\"id,metadata\")\n        .eq(\"id\", conversationId)\n        .limit(1);\n      if (read.error) fail(read.error, \"setArchived\");\n      const row = ((read.data ?? []) as Record<string, unknown>[])[0];\n      if (row === undefined) {\n        throw new Error(\n          `[ai-matrx/chat] Conversation ${conversationId} could not be read, so its archive state was not changed. ` +\n            \"It may have been deleted, or this account may not have access to it.\",\n        );\n      }\n      const merged = { ...asRecord(row.metadata), archived };\n      const { error } = await table(CHAT_TABLES.conversation)\n        .update({ metadata: merged })\n        .eq(\"id\", conversationId);\n      if (error) fail(error, \"setArchived\");\n    },\n\n    async rename(conversationId: string, title: string): Promise<void> {\n      const { error } = await table(CHAT_TABLES.conversation)\n        .update({ title })\n        .eq(\"id\", conversationId);\n      if (error) fail(error, \"rename\");\n    },\n  };\n}\n","/**\n * THE TOOL-CALL STATE MACHINE.\n *\n * `input-streaming → input-available → approval-requested →\n *  output-available | output-error | output-denied`\n *\n * It lives in the kernel, not in a renderer, for the reason C22 names: this is\n * exactly the logic four repositories re-derived four different ways. A tool\n * card that shows \"running\" after the run failed, or that re-opens a settled\n * call because a late duplicate frame arrived, is the class this file closes.\n *\n * The machine is MONOTONIC: the three output states are terminal, and a\n * transition that would move backwards is REFUSED and reported — never applied\n * silently (Law 4).\n */\n\nimport type { ChatMessage, ChatToolPart, ChatToolState } from \"./model\";\n\n/** Rank: a transition is legal only when it strictly increases, or is a\n *  same-state refresh of a non-terminal state (progress beats). */\nconst RANK: Record<ChatToolState, number> = {\n  \"input-streaming\": 0,\n  \"input-available\": 1,\n  \"approval-requested\": 2,\n  \"output-available\": 3,\n  \"output-error\": 3,\n  \"output-denied\": 3,\n};\n\nconst TERMINAL: ReadonlySet<ChatToolState> = new Set<ChatToolState>([\n  \"output-available\",\n  \"output-error\",\n  \"output-denied\",\n]);\n\nexport function isTerminalToolState(state: ChatToolState): boolean {\n  return TERMINAL.has(state);\n}\n\nexport interface ToolStateTransition {\n  /** The state to store. Equal to `from` when the transition was refused. */\n  readonly state: ChatToolState;\n  readonly applied: boolean;\n  /** Present only when `applied` is false — say WHY, out loud. */\n  readonly refusal: string | null;\n}\n\n/**\n * Advance a tool part. Returns the state to keep plus, when the move was\n * refused, a sentence a diagnostic sink can print verbatim.\n */\nexport function advanceToolState(\n  from: ChatToolState,\n  to: ChatToolState,\n): ToolStateTransition {\n  if (from === to) {\n    if (TERMINAL.has(from)) {\n      return {\n        state: from,\n        applied: false,\n        refusal: `tool state '${from}' is terminal and was re-announced; the duplicate frame was ignored`,\n      };\n    }\n    return { state: to, applied: true, refusal: null };\n  }\n  if (TERMINAL.has(from)) {\n    return {\n      state: from,\n      applied: false,\n      refusal: `tool state '${from}' is terminal; refusing to move it to '${to}'`,\n    };\n  }\n  const fromRank = RANK[from];\n  const toRank = RANK[to];\n  if (toRank < fromRank) {\n    return {\n      state: from,\n      applied: false,\n      refusal: `refusing to move a tool call backwards from '${from}' to '${to}'`,\n    };\n  }\n  return { state: to, applied: true, refusal: null };\n}\n\n/**\n * Map ONE aidream tool lifecycle name onto the machine.\n *\n * Server truth, read off the live corpus and\n * `@ai-matrx/agents/projection/request`: the wire emits `tool_started`,\n * `tool_progress`, `tool_step`, `tool_result_preview`, `tool_completed`,\n * `tool_error`, `tool_delegated` — either as a top-level `event` or nested in\n * a `tool_event` frame's `data.event`.\n *\n * `null` means \"this frame carries no state change\" (a progress beat), which\n * is different from an unknown name — an unknown name is returned as\n * `\"unknown\"` so the caller can report it instead of dropping it.\n */\nexport function toolLifecycleToState(\n  lifecycle: string,\n): ChatToolState | null | \"unknown\" {\n  switch (lifecycle) {\n    case \"tool_started\":\n      return \"input-available\";\n    case \"tool_progress\":\n    case \"tool_step\":\n    case \"tool_result_preview\":\n      return null;\n    case \"tool_delegated\":\n      // The server handed the call to the CLIENT: the input is final and\n      // nothing has run yet. It is NOT an approval request (the human is not\n      // being asked) and it is NOT an output.\n      return \"input-available\";\n    case \"tool_approval_requested\":\n      return \"approval-requested\";\n    case \"tool_completed\":\n      return \"output-available\";\n    case \"tool_error\":\n      return \"output-error\";\n    case \"tool_denied\":\n      return \"output-denied\";\n    default:\n      return \"unknown\";\n  }\n}\n\n/** Every lifecycle name this machine understands — the guard's census. */\nexport const KNOWN_TOOL_LIFECYCLES: readonly string[] = [\n  \"tool_started\",\n  \"tool_progress\",\n  \"tool_step\",\n  \"tool_result_preview\",\n  \"tool_delegated\",\n  \"tool_approval_requested\",\n  \"tool_completed\",\n  \"tool_error\",\n  \"tool_denied\",\n];\n\n\n/**\n * THE CLIENT'S OWN ANSWER.\n *\n * When the CLIENT answers a delegated tool (`tool_delegated` → the host runs it\n * → posts the result) the server learns the call is done from that post — but\n * for a delegated call it sends NO completion frame, because it hard-suspended\n * and closed the stream. A store that only moves on frames therefore leaves the\n * card on `input-available` (\"Working…\") for as long as the conversation stays\n * open. This is the defect all four hand-built chats had (found 2026-09-30 in\n * matrx-frontend, matrx-extend and matrx-local): the answerer is the first to\n * know, so it tells ITS OWN store, through this one door, in the same tick.\n */\nexport interface ChatToolAnswer {\n  toolCallId: string;\n  /** The result, on success. */\n  output?: unknown;\n  /** Set when the tool failed — the card goes to `output-error`. */\n  errorText?: string | null;\n  /** Set when the reader refused it — the card goes to `output-denied`. */\n  denied?: boolean;\n}\n\nexport interface ChatToolSettlement {\n  /** The transcript to keep — the SAME array when nothing changed. */\n  readonly messages: readonly ChatMessage[];\n  /** The message whose part changed, for the per-message wake. */\n  readonly messageId: string | null;\n  readonly applied: boolean;\n  /** Present when `applied` is false — say WHY, out loud. */\n  readonly refusal: string | null;\n}\n\n/** Pure: apply a client answer to the transcript, monotonically. */\nexport function settleToolAnswer(\n  messages: readonly ChatMessage[],\n  answer: ChatToolAnswer,\n): ChatToolSettlement {\n  for (let m = messages.length - 1; m >= 0; m -= 1) {\n    const message = messages[m];\n    if (!message) continue;\n    const index = message.parts.findIndex(\n      (part) => part.type === \"tool\" && part.toolCallId === answer.toolCallId,\n    );\n    if (index === -1) continue;\n    const part = message.parts[index] as ChatToolPart;\n    const next: ChatToolState = answer.denied\n      ? \"output-denied\"\n      : answer.errorText != null\n        ? \"output-error\"\n        : \"output-available\";\n    const transition = advanceToolState(part.state, next);\n    if (!transition.applied) {\n      return {\n        messages,\n        messageId: message.id,\n        applied: false,\n        refusal: transition.refusal,\n      };\n    }\n    const settled: ChatToolPart = {\n      ...part,\n      state: transition.state,\n      output: answer.output !== undefined ? answer.output : part.output,\n      errorText: next === \"output-error\" ? (answer.errorText ?? null) : null,\n    };\n    const parts = message.parts.slice();\n    parts[index] = settled;\n    const copy = messages.slice();\n    copy[m] = { ...message, parts };\n    return { messages: copy, messageId: message.id, applied: true, refusal: null };\n  }\n  return {\n    messages,\n    messageId: null,\n    applied: false,\n    refusal: `no tool call ${answer.toolCallId} is in this transcript, so there was nothing to settle`,\n  };\n}\n","/**\n * THE REDUCER — one live stream frame becomes message parts.\n *\n * Every branch below exists because the LIVE corpus in `fixtures/corpus/`\n * contains that frame. Nothing here was guessed from a client: the wire\n * vocabulary was read off bytes recorded from `server.app.matrxserver.com` on\n * 2026-09-17 and cross-checked against\n * `@ai-matrx/agents/projection/request`.\n *\n * The projector is deliberately MUTABLE. A streaming turn applies one frame\n * per token; rebuilding an immutable tree per token is the classic reason a\n * chat janks at 2,000 tokens. Immutability is provided where React needs it —\n * `snapshot()` hands back a fresh `ChatMessage` with a fresh `parts` array —\n * and the store coalesces those snapshots per animation frame.\n */\n\nimport {\n  advanceToolState,\n  toolLifecycleToState,\n} from \"./tool-state\";\nimport type { ChatFeatures } from \"./config\";\nimport {\n  createChatMessage,\n  type ChatErrorPart,\n  type ChatMessage,\n  type ChatNoticePart,\n  type ChatPart,\n  type ChatRenderBlockPart,\n  type ChatReasoningPart,\n  type ChatTextPart,\n  type ChatToolPart,\n} from \"./model\";\nimport type { ChatStreamFrame } from \"./ports\";\n\n/** The reasoning sentinel the Google path wraps thinking text in. */\nexport const REASONING_OPEN = \"<reasoning>\";\nexport const REASONING_CLOSE = \"</reasoning>\";\n\nexport type ChatTurnOutcome =\n  | \"streaming\"\n  | \"awaiting-tools\"\n  | \"complete\"\n  | \"error\"\n  | \"cancelled\";\n\nexport interface ChatTurnRefusal {\n  code: string;\n  message: string;\n  detail?: unknown;\n}\n\nexport interface ChatTurnProjectorOptions {\n  features: ChatFeatures;\n  /** The message id for the assistant turn (kept stable across the stream). */\n  messageId?: string | undefined;\n  /** Every refusal / unknown frame — reported, never dropped (Law 4). */\n  onRefusal?: ((refusal: ChatTurnRefusal) => void) | undefined;\n}\n\nexport interface ChatTurnProjector {\n  apply(frame: ChatStreamFrame): void;\n  /** A fresh, structurally-shared assistant message. */\n  snapshot(): ChatMessage;\n  readonly state: ChatTurnState;\n}\n\nexport interface ChatTurnState {\n  outcome: ChatTurnOutcome;\n  conversationId: string | null;\n  requestId: string | null;\n  phase: string | null;\n  /** The `chat.message` row ids the server reserved, by role. */\n  serverMessageIds: { user: string | null; assistant: string | null };\n  completion: Record<string, unknown> | null;\n  error: ChatErrorPart | null;\n  /** Bumps on every applied frame — the store's cheap dirty check. */\n  revision: number;\n  lastTransportSeq: number;\n  transportStreamId: string | null;\n  /** Frames the projector did not understand; never silently zero. */\n  unknownEvents: string[];\n}\n\nconst asRecord = (value: unknown): Record<string, unknown> =>\n  value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n\nconst asString = (value: unknown): string | null =>\n  typeof value === \"string\" ? value : null;\n\nconst asNumber = (value: unknown): number | null =>\n  typeof value === \"number\" && Number.isFinite(value) ? value : null;\n\n/** Events the projector deliberately ignores — real frames with no part. */\nconst IGNORED_EVENTS: ReadonlySet<string> = new Set([\n  \"heartbeat\",\n  \"context_state\",\n  \"context_trimmed\",\n  \"record_update\",\n  \"ping\",\n  \"debug\",\n  // `init`/`completion` pairs exist for five operations; only the\n  // `user_request` completion is terminal, and `init` carries no part.\n  \"init\",\n]);\n\nexport function createChatTurnProjector(\n  options: ChatTurnProjectorOptions,\n): ChatTurnProjector {\n  const features = options.features;\n  const messageId = options.messageId ?? createChatMessage({ role: \"assistant\" }).id;\n  const parts: ChatPart[] = [];\n  const toolsByCallId = new Map<string, ChatToolPart>();\n  const blocksById = new Map<string, ChatRenderBlockPart>();\n\n  /** True between `reasoning {started}` and `reasoning {stopped}`. */\n  let reasoningActive = false;\n  /** True while inside an unterminated `<reasoning>` span in chunk text. */\n  let insideSentinel = false;\n\n  const state: ChatTurnState = {\n    outcome: \"streaming\",\n    conversationId: null,\n    requestId: null,\n    phase: null,\n    serverMessageIds: { user: null, assistant: null },\n    completion: null,\n    error: null,\n    revision: 0,\n    lastTransportSeq: 0,\n    transportStreamId: null,\n    unknownEvents: [],\n  };\n\n  const refuse = (refusal: ChatTurnRefusal): void => {\n    options.onRefusal?.(refusal);\n  };\n\n  const lastPart = (): ChatPart | undefined => parts[parts.length - 1];\n\n  const appendText = (text: string): void => {\n    const tail = lastPart();\n    if (tail && tail.type === \"text\") {\n      tail.text += text;\n      return;\n    }\n    const part: ChatTextPart = { type: \"text\", text };\n    parts.push(part);\n  };\n\n  const appendReasoning = (text: string): void => {\n    const tail = lastPart();\n    if (tail && tail.type === \"reasoning\" && tail.state === \"streaming\") {\n      tail.text += text;\n      return;\n    }\n    const part: ChatReasoningPart = { type: \"reasoning\", text, state: \"streaming\" };\n    parts.push(part);\n  };\n\n  const closeReasoning = (): void => {\n    for (let i = parts.length - 1; i >= 0; i -= 1) {\n      const part = parts[i];\n      if (part && part.type === \"reasoning\" && part.state === \"streaming\") {\n        part.state = \"done\";\n        return;\n      }\n    }\n  };\n\n  /**\n   * Route ONE chunk of answer text.\n   *\n   * With `reasoningSentinel: \"inline\"` the text goes straight to the answer,\n   * byte-for-byte identical to the shipped projection's `answer`. With\n   * `\"split\"` (the platform default) the `<reasoning>…</reasoning>` span\n   * becomes a reasoning part, so a reader never sees the raw sentinel.\n   */\n  const routeChunk = (text: string): void => {\n    if (features.reasoningSentinel === \"inline\") {\n      appendText(text);\n      return;\n    }\n    let rest = text;\n    while (rest.length > 0) {\n      if (insideSentinel) {\n        const close = rest.indexOf(REASONING_CLOSE);\n        if (close === -1) {\n          appendReasoning(rest);\n          return;\n        }\n        appendReasoning(rest.slice(0, close));\n        closeReasoning();\n        insideSentinel = false;\n        rest = rest.slice(close + REASONING_CLOSE.length);\n        continue;\n      }\n      const open = rest.indexOf(REASONING_OPEN);\n      if (open === -1) {\n        appendText(rest);\n        return;\n      }\n      if (open > 0) appendText(rest.slice(0, open));\n      insideSentinel = true;\n      rest = rest.slice(open + REASONING_OPEN.length);\n    }\n  };\n\n  const toolFor = (callId: string, toolName: string): ChatToolPart => {\n    const existing = toolsByCallId.get(callId);\n    if (existing) return existing;\n    const part: ChatToolPart = {\n      type: \"tool\",\n      toolCallId: callId,\n      toolName,\n      state: \"input-streaming\",\n      input: undefined,\n      output: undefined,\n      errorText: null,\n      progress: [],\n      delegated: false,\n    };\n    toolsByCallId.set(callId, part);\n    parts.push(part);\n    return part;\n  };\n\n  const applyToolLifecycle = (\n    lifecycle: string,\n    data: Record<string, unknown>,\n  ): void => {\n    const callId = asString(data.call_id);\n    const toolName = asString(data.tool_name);\n    if (callId === null || toolName === null) {\n      refuse({\n        code: \"tool_frame_without_identity\",\n        message: `a '${lifecycle}' frame arrived without call_id/tool_name and was ignored`,\n        detail: data,\n      });\n      return;\n    }\n    const part = toolFor(callId, toolName);\n    const payload = asRecord(data.data);\n    const message = asString(data.message) ?? \"\";\n\n    const next = toolLifecycleToState(lifecycle);\n    if (next === \"unknown\") {\n      state.unknownEvents.push(lifecycle);\n      refuse({\n        code: \"unknown_tool_lifecycle\",\n        message: `tool lifecycle '${lifecycle}' is not in this package's state machine; the frame was recorded but not applied`,\n        detail: data,\n      });\n      return;\n    }\n\n    if (lifecycle === \"tool_started\" && \"arguments\" in payload) {\n      part.input = payload.arguments;\n    }\n    if (lifecycle === \"tool_delegated\") {\n      part.delegated = true;\n      if (\"arguments\" in payload) part.input = payload.arguments;\n    }\n    if (lifecycle === \"tool_completed\" && \"result\" in payload) {\n      part.output = payload.result;\n    }\n    if (lifecycle === \"tool_error\") {\n      part.errorText =\n        asString(payload.error) ?? (message || `The ${toolName} tool failed.`);\n    }\n\n    if (next === null) {\n      part.progress.push({\n        toolName,\n        message,\n        percent: asNumber(payload.percent),\n        at: asNumber(data.timestamp),\n      });\n      return;\n    }\n\n    const transition = advanceToolState(part.state, next);\n    if (!transition.applied) {\n      refuse({\n        code: \"tool_state_transition_refused\",\n        message: `${transition.refusal ?? \"refused\"} (call ${callId}, tool ${toolName})`,\n        detail: data,\n      });\n      return;\n    }\n    part.state = transition.state;\n    if (next === \"input-available\" && part.delegated) {\n      state.outcome = \"awaiting-tools\";\n    } else if (\n      state.outcome === \"awaiting-tools\" &&\n      (next === \"output-available\" || next === \"output-error\")\n    ) {\n      state.outcome = \"streaming\";\n    }\n  };\n\n  const pushNotice = (\n    level: ChatNoticePart[\"level\"],\n    data: Record<string, unknown>,\n  ): void => {\n    const userMessage = asString(data.user_message) ?? \"\";\n    if (!userMessage) return;\n    const part: ChatNoticePart = {\n      type: \"notice\",\n      level,\n      code: asString(data.code),\n      userMessage,\n      remedy: asString(asRecord(data.metadata).remedy),\n    };\n    parts.push(part);\n  };\n\n  const apply = (frame: ChatStreamFrame): void => {\n    const streamSeq = asNumber(frame.stream_seq);\n    const streamId = asString(frame.stream_id);\n    const sameSegment = streamId === null || streamId === state.transportStreamId;\n    if (sameSegment && streamSeq !== null && streamSeq <= state.lastTransportSeq) {\n      // A replayed frame after a reconnect. Dropping it is the whole point of\n      // the sequence: applying it doubles text.\n      return;\n    }\n    state.lastTransportSeq =\n      streamSeq === null\n        ? state.lastTransportSeq\n        : sameSegment\n          ? Math.max(state.lastTransportSeq, streamSeq)\n          : streamSeq;\n    if (streamId !== null) state.transportStreamId = streamId;\n    state.revision += 1;\n\n    const data = asRecord(frame.data);\n\n    switch (frame.event) {\n      case \"chunk\": {\n        const text = asString(data.text);\n        if (text !== null) routeChunk(text);\n        return;\n      }\n      case \"reasoning_chunk\": {\n        const text = asString(data.text);\n        if (text !== null) {\n          reasoningActive = true;\n          appendReasoning(text);\n        }\n        return;\n      }\n      case \"reasoning\": {\n        const started = data.state === \"started\";\n        reasoningActive = started;\n        if (!started) closeReasoning();\n        return;\n      }\n      case \"phase\": {\n        const phase = asString(data.phase);\n        if (phase !== null) state.phase = phase;\n        return;\n      }\n      case \"data\": {\n        if (data.type === \"conversation_id\") {\n          const conversationId = asString(data.conversation_id);\n          if (conversationId !== null) state.conversationId = conversationId;\n        }\n        return;\n      }\n      case \"record_reserved\": {\n        // The server names the `chat.message` rows it reserved and, in\n        // `metadata.role`, which side each one is. This is how an optimistic\n        // user bubble learns its durable row id without a re-read.\n        if (asString(data.table) !== \"message\") return;\n        const recordId = asString(data.record_id);\n        const role = asString(asRecord(data.metadata).role);\n        if (recordId === null) return;\n        if (role === \"user\") state.serverMessageIds.user = recordId;\n        else if (role === \"assistant\") state.serverMessageIds.assistant = recordId;\n        return;\n      }\n      case \"tool_event\": {\n        const lifecycle = asString(data.event);\n        if (lifecycle === null) {\n          refuse({\n            code: \"tool_event_without_lifecycle\",\n            message: \"a tool_event frame carried no data.event and was ignored\",\n            detail: data,\n          });\n          return;\n        }\n        applyToolLifecycle(lifecycle, data);\n        return;\n      }\n      case \"tool_started\":\n      case \"tool_progress\":\n      case \"tool_step\":\n      case \"tool_result_preview\":\n      case \"tool_completed\":\n      case \"tool_error\":\n      case \"tool_delegated\": {\n        applyToolLifecycle(frame.event, data);\n        return;\n      }\n      case \"render_block\": {\n        const blockId = asString(data.blockId);\n        const blockIndex = asNumber(data.blockIndex);\n        const kind = asString(data.type);\n        if (blockId === null || blockIndex === null || kind === null) {\n          refuse({\n            code: \"render_block_without_identity\",\n            message: \"a render_block frame lacked blockId/blockIndex/type and was ignored\",\n            detail: data,\n          });\n          return;\n        }\n        const status =\n          data.status === \"complete\" || data.status === \"error\"\n            ? (data.status as \"complete\" | \"error\")\n            : \"streaming\";\n        const existing = blocksById.get(blockId);\n        if (existing) {\n          existing.status = status;\n          existing.content = asString(data.content);\n          existing.data = data.data;\n          return;\n        }\n        const part: ChatRenderBlockPart = {\n          type: \"render-block\",\n          blockId,\n          blockIndex,\n          kind,\n          content: asString(data.content),\n          data: data.data,\n          status,\n        };\n        blocksById.set(blockId, part);\n        parts.push(part);\n        return;\n      }\n      case \"warning\": {\n        const level = asString(data.level);\n        pushNotice(\n          level === \"high\" || level === \"medium\" || level === \"low\" ? level : \"low\",\n          data,\n        );\n        return;\n      }\n      case \"info\": {\n        // `initial_message` is chrome (\"Initializing Matrx Chat…\"), not news.\n        if (asString(data.code) === \"initial_message\") return;\n        pushNotice(\"info\", data);\n        return;\n      }\n      case \"error\": {\n        const message =\n          asString(data.message) ?? asString(data.user_message) ?? \"The run failed.\";\n        const part: ChatErrorPart = {\n          type: \"error\",\n          errorType: asString(data.error_type),\n          code: asString(data.code),\n          message,\n          userMessage: asString(data.user_message) ?? message,\n          recoverable: data.recoverable === true,\n          remedy: asString(asRecord(data.details).remedy),\n        };\n        parts.push(part);\n        state.error = part;\n        state.outcome = \"error\";\n        return;\n      }\n      case \"completion\": {\n        if (asString(data.operation) !== \"user_request\") return;\n        state.completion = data;\n        const status = asString(data.status);\n        if (status === \"failed\") {\n          state.outcome = \"error\";\n          if (state.error === null) {\n            const result = asRecord(data.result);\n            const message =\n              asString(result.error) ??\n              asString(result.user_message) ??\n              \"The run failed.\";\n            const part: ChatErrorPart = {\n              type: \"error\",\n              errorType: \"run_failed\",\n              code: null,\n              message,\n              userMessage: message,\n              recoverable: true,\n              remedy: null,\n            };\n            parts.push(part);\n            state.error = part;\n          }\n        } else if (status === \"cancelled\") {\n          state.outcome = \"cancelled\";\n        } else if (state.outcome !== \"error\") {\n          state.outcome = \"complete\";\n        }\n        return;\n      }\n      case \"end\": {\n        if (state.outcome === \"streaming\" || state.outcome === \"awaiting-tools\") {\n          state.outcome = \"complete\";\n        }\n        if (insideSentinel || reasoningActive) {\n          closeReasoning();\n          insideSentinel = false;\n          reasoningActive = false;\n        }\n        return;\n      }\n      default: {\n        if (IGNORED_EVENTS.has(frame.event)) return;\n        state.unknownEvents.push(frame.event);\n        refuse({\n          code: \"unknown_stream_event\",\n          message: `stream event '${frame.event}' is not in this package's vocabulary; it was recorded, not dropped`,\n          detail: frame.data,\n        });\n      }\n    }\n  };\n\n  const snapshot = (): ChatMessage => {\n    const status =\n      state.outcome === \"error\"\n        ? \"error\"\n        : state.outcome === \"cancelled\"\n          ? \"cancelled\"\n          : state.outcome === \"complete\"\n            ? \"complete\"\n            : \"streaming\";\n    const completion = state.completion;\n    return {\n      id: messageId,\n      role: \"assistant\",\n      // Fresh array + fresh part objects: React compares by identity, and a\n      // mutated-in-place part never re-renders.\n      parts: parts.map((part) => ({ ...part }) as ChatPart),\n      status,\n      metadata: {\n        requestId: state.requestId,\n        serverMessageId: state.serverMessageIds.assistant,\n        modelRef: completion ? extractModelRef(completion) : null,\n        createdAt: new Date(0).toISOString(),\n        raw: completion,\n      },\n    };\n  };\n\n  return {\n    apply,\n    snapshot,\n    get state() {\n      return state;\n    },\n  };\n}\n\n/**\n * The model the server actually billed, from the completion's usage block\n * (`result.total_usage.by_model` — one key per model that ran). Returns null\n * rather than a UUID or a guess: a screen never prints an id, and \"unknown\" is\n * the honest answer when the completion carried no usage.\n */\nexport function extractModelRef(\n  completion: Record<string, unknown>,\n): string | null {\n  const result = asRecord(completion.result);\n  const usage = asRecord(result.total_usage);\n  const byModel = asRecord(usage.by_model);\n  const names = Object.keys(byModel);\n  return names.length > 0 ? (names[names.length - 1] ?? null) : null;\n}\n","/**\n * OPINIONS BECOME KNOBS (Law 6) — resolved in the kernel, never hardcoded and\n * never a question for a customer.\n *\n * Four layers, lowest to highest: **platform default → organization setting →\n * surface config → per-user preference**. Every knob has a platform default,\n * so a host that sets nothing still gets the platform's taste.\n *\n * One of these knobs is a SAFETY RULE and it lives here on purpose (C22):\n * `routing` carries matrx-local's \"a confidential thread never reaches a cloud\n * provider\". In the kernel it is a thread-level constraint the store ENFORCES\n * with a refusal — it never silently falls back to a cloud target.\n */\n\nexport type ChatSendKey = \"enter\" | \"mod-enter\";\nexport type ChatDensity = \"comfortable\" | \"compact\";\n\n/**\n * Where a thread's text is allowed to go.\n * - `\"any\"` — the platform default: any target the host offers.\n * - `\"local-only\"` — CONFIDENTIAL. The thread refuses a cloud target and says\n *   why. This is the highest-severity rule in the design (§12 risk 4).\n */\nexport type ChatRoutingPolicy = \"any\" | \"local-only\";\n\n/** What a transport declares about itself so the kernel can judge it. */\nexport type ChatTargetLocality = \"local\" | \"cloud\";\n\nexport interface ChatFeatures {\n  /** Enter sends, or Cmd/Ctrl+Enter sends. */\n  sendKey: ChatSendKey;\n  density: ChatDensity;\n  /** Reasoning parts visible without a click. */\n  showReasoningByDefault: boolean;\n  /** Tool cards start expanded. */\n  expandToolCardsByDefault: boolean;\n  /** Transcript sticks to the bottom while the reader is at the bottom. */\n  autoScroll: boolean;\n  /** Read new assistant turns aloud as they arrive. */\n  readAloudAutoPlay: boolean;\n  /** Keep an unsent composer draft per conversation across reloads. */\n  retainDrafts: boolean;\n  /**\n   * The composer may send while an answer is still arriving. OFF by the\n   * platform default (a kernel thread runs one turn at a time). A host whose\n   * send QUEUES the message behind the live turn — a coding session, where\n   * the engine holds a per-session queue — turns it on; the composer then\n   * shows Send (queue) beside Stop instead of Stop alone.\n   */\n  sendWhileBusy: boolean;\n  /** THE ARCHIVED-ITEMS LAW: the conversation list hides archived by default. */\n  hideArchivedConversations: boolean;\n  /**\n   * The per-turn action bar (copy, ask again, edit and send again, plus the\n   * host's own). ON by the platform default — every serious chat has one, and\n   * a reader who cannot copy an answer retypes it. An organization that does\n   * not want it turns it OFF here rather than a host forking the transcript.\n   */\n  messageActions: boolean;\n  /** Largest attachment the composer accepts, in BYTES. */\n  attachmentMaxBytes: number;\n  /**\n   * How the platform's inline reasoning sentinel is treated.\n   *\n   * Ground truth (captured live 2026-09-17): the Google path does NOT emit\n   * `reasoning_chunk`. It emits `reasoning {state:\"started\"}`, then ordinary\n   * `chunk` frames whose text opens with `<reasoning>` and closes with\n   * `</reasoning>`, then `reasoning {state:\"stopped\"}`.\n   *\n   * - `\"split\"` (platform default) — that span becomes a `reasoning` part, so\n   *   a reader never sees the raw sentinel in the answer.\n   * - `\"inline\"` — the span stays in the answer text, byte-for-byte identical\n   *   to `@ai-matrx/agents/projection/request`'s `answer`. This exists so the\n   *   parity harness can prove EXACT equality with the shipped projection, and\n   *   so a host mid-migration can keep its current screen.\n   */\n  reasoningSentinel: \"split\" | \"inline\";\n  /** Where this thread's text may go. */\n  routing: ChatRoutingPolicy;\n}\n\nexport const CHAT_PLATFORM_DEFAULTS: Readonly<ChatFeatures> = Object.freeze({\n  sendKey: \"enter\",\n  density: \"comfortable\",\n  showReasoningByDefault: false,\n  expandToolCardsByDefault: false,\n  autoScroll: true,\n  readAloudAutoPlay: false,\n  retainDrafts: true,\n  sendWhileBusy: false,\n  hideArchivedConversations: true,\n  messageActions: true,\n  attachmentMaxBytes: 25 * 1024 * 1024,\n  reasoningSentinel: \"split\",\n  routing: \"any\",\n});\n\nexport interface ChatConfigLayers {\n  /** Organization setting rows, resolved by the host. */\n  organization?: Partial<ChatFeatures>;\n  /** This surface's configuration (a dock is not the full page). */\n  surface?: Partial<ChatFeatures>;\n  /** This person's preference. */\n  user?: Partial<ChatFeatures>;\n}\n\n/** Resolve the four layers. Later layers win, key by key. */\nexport function resolveChatFeatures(layers: ChatConfigLayers = {}): ChatFeatures {\n  return {\n    ...CHAT_PLATFORM_DEFAULTS,\n    ...stripUndefined(layers.organization),\n    ...stripUndefined(layers.surface),\n    ...stripUndefined(layers.user),\n  };\n}\n\nfunction stripUndefined(\n  value: Partial<ChatFeatures> | undefined,\n): Partial<ChatFeatures> {\n  if (!value) return {};\n  const out: Record<string, unknown> = {};\n  for (const [key, entry] of Object.entries(value)) {\n    if (entry !== undefined) out[key] = entry;\n  }\n  return out as Partial<ChatFeatures>;\n}\n\n/** The refusal a confidential thread produces instead of a silent fallback. */\nexport interface ChatRoutingRefusal {\n  readonly allowed: false;\n  readonly code: \"confidential_thread_cloud_target_refused\";\n  readonly userMessage: string;\n  readonly remedy: string;\n}\n\nexport type ChatRoutingDecision = { readonly allowed: true } | ChatRoutingRefusal;\n\n/**\n * THE CONFIDENTIAL-ROUTING RULE, in the kernel where it belongs.\n *\n * A thread pinned `local-only` REFUSES a cloud target. It does not downgrade,\n * it does not warn-and-send, and it does not quietly pick a different target:\n * the send fails with a named reason and a remedy. Re-deriving this per host\n * is how private text reaches a provider.\n */\nexport function decideRouting(\n  policy: ChatRoutingPolicy,\n  target: ChatTargetLocality,\n): ChatRoutingDecision {\n  if (policy === \"local-only\" && target === \"cloud\") {\n    return {\n      allowed: false,\n      code: \"confidential_thread_cloud_target_refused\",\n      userMessage:\n        \"This conversation is marked confidential, so it cannot be sent to a cloud AI provider.\",\n      remedy:\n        \"Choose a local engine for this conversation, or start a new conversation that is not marked confidential.\",\n    };\n  }\n  return { allowed: true };\n}\n","/**\n * HOST INJECTION SEAMS — the ports a host may override.\n *\n * Per THE ALL-INCLUSIVE LAW every port here either ships a working default in\n * this package (`./matrx`, or the in-file defaults below) or is genuinely host\n * identity. A host injects identity and nothing else to be up and running.\n *\n * Phase 1 declares the ports the KERNEL uses. `files`, `nav`, `shell`,\n * `renderContent`, `renderModelRef` and `capabilities` are phase 2's — they\n * are deliberately ABSENT here rather than declared-and-unused, because a port\n * nothing calls is untested theory that rots (C25's reasoning).\n */\n\nimport type { ChatMessage, ChatRole } from \"./model\";\nimport type { ChatTargetLocality } from \"./config\";\n\n/** The ONE true injection. Read from the client's own session, never a cached copy. */\nexport interface ChatIdentityPort {\n  /** A fresh access token per call. Cached copies rot when the cookie rotates. */\n  getAccessToken(): Promise<string | null> | string | null;\n  userId: string;\n  organizationId?: string | undefined;\n}\n\n/** One frame off the wire, already normalized by `@ai-matrx/agents/stream/ndjson`. */\nexport interface ChatStreamFrame {\n  event: string;\n  data: unknown;\n  stream_id?: string | undefined;\n  stream_seq?: number | undefined;\n}\n\n/** What a started turn hands back before any frame arrives. */\nexport interface ChatTurnHandle {\n  /** The server's `X-Request-ID` — the ONLY id cancel accepts. */\n  requestId: string | null;\n  conversationId: string | null;\n  frames: AsyncIterable<ChatStreamFrame>;\n}\n\nexport interface ChatSendRequest {\n  conversationId: string | null;\n  /** True when this turn creates the conversation. */\n  isNewConversation: boolean;\n  /** False for an ephemeral run: nothing read, nothing written. */\n  store: boolean;\n  text: string;\n  /** Durable Matrx file ids attached to this turn. */\n  fileIds: readonly string[];\n  signal: AbortSignal;\n}\n\n/**\n * THE TRANSPORT PORT — subscribe-shaped, NOT a fetch.\n *\n * It is this shape because matrx-extend's MV3 stream lives in an offscreen\n * document and is relayed over `chrome.runtime`: an API that has only ever met\n * `fetch` ossifies wrong. A host that does use fetch implements this in a few\n * lines (`./matrx` is that implementation).\n */\nexport interface ChatTransportPort {\n  /** Where this transport sends text. The kernel refuses `\"cloud\"` for a\n   *  confidential thread — so a transport that lies here defeats the rule, and\n   *  it is the transport author's obligation to be honest. */\n  readonly locality: ChatTargetLocality;\n  start(request: ChatSendRequest): Promise<ChatTurnHandle>;\n  /** Cooperative stop at the next iteration boundary. */\n  cancel(requestId: string): Promise<void>;\n}\n\n/** A conversation as the history list shows it. */\nexport interface ChatConversationSummary {\n  id: string;\n  title: string | null;\n  updatedAt: string;\n  createdAt: string;\n  messageCount: number;\n  archived: boolean;\n  isFavorite: boolean;\n  /** Which surface produced it — the history list's source filter. */\n  sourceApp: string | null;\n  sourceFeature: string | null;\n}\n\nexport interface ChatConversationListQuery {\n  limit?: number | undefined;\n  /** Keyset cursor: return rows older than this ISO timestamp. */\n  before?: string | undefined;\n  /**\n   * THE ARCHIVED-ITEMS LAW. Default false — archived rows are hidden, and the\n   * caller that shows the list must name what it hides.\n   */\n  includeArchived?: boolean | undefined;\n  sourceApp?: string | undefined;\n  sourceFeature?: string | undefined;\n  /**\n   * The page's own organization filter (`?org_filter=`). Absent/null = ALL the\n   * person's organizations, the default on every visit — never the active\n   * organization (active-org-is-never-a-list-filter.md).\n   */\n  organizationFilter?: string | null | undefined;\n}\n\nexport interface ChatConversationListPage {\n  conversations: ChatConversationSummary[];\n  /** How many rows the archive filter hid, so the footer can say so. */\n  archivedHidden: number;\n  /** Cursor for the next page, or null at the end. */\n  nextBefore: string | null;\n}\n\n/**\n * THE PERSISTENCE BOUNDARY (C10). The `chat.*` schema belongs to aidream, so\n * this package does not OWN it — but `./matrx` ships the complete binding, so\n * a host gets working persistence for free and only a customer on their own\n * tables ever implements this.\n *\n * With no binding the thread runs ephemeral AND SAYS SO on screen\n * (`ChatThreadSnapshot.ephemeral` + `ephemeralReason`).\n */\nexport interface ChatPersistencePort {\n  /** Full transcript of one conversation, oldest first. */\n  loadThread(conversationId: string): Promise<ChatMessage[]>;\n  listConversations(\n    query: ChatConversationListQuery,\n  ): Promise<ChatConversationListPage>;\n  setArchived(conversationId: string, archived: boolean): Promise<void>;\n  rename(conversationId: string, title: string): Promise<void>;\n}\n\n/** Typed diagnostic sink. Default: `console`. */\nexport interface ChatErrorSinkPort {\n  capture(event: {\n    code: string;\n    message: string;\n    detail?: unknown;\n  }): void;\n}\n\n/** Toast / banner sink. Default: a no-op that still reaches the errorSink. */\nexport interface ChatNotifierPort {\n  notify(event: {\n    level: \"info\" | \"warning\" | \"error\";\n    message: string;\n    remedy?: string | undefined;\n  }): void;\n}\n\n/** Drafts, density, sidebar state. Default: in-memory, announced once. */\nexport interface ChatPrefsPort {\n  get(key: string): string | null;\n  set(key: string, value: string): void;\n  remove(key: string): void;\n}\n\nexport function createConsoleErrorSink(): ChatErrorSinkPort {\n  return {\n    capture(event) {\n      console.error(`[ai-matrx/chat] ${event.code}: ${event.message}`, event.detail);\n    },\n  };\n}\n\n/**\n * The default notifier. It never swallows: everything it is handed also\n * reaches the console, with the remedy, because a notice nobody renders is a\n * silent failure.\n */\nexport function createConsoleNotifier(): ChatNotifierPort {\n  return {\n    notify(event) {\n      const line = event.remedy\n        ? `[ai-matrx/chat] ${event.message} — ${event.remedy}`\n        : `[ai-matrx/chat] ${event.message}`;\n      if (event.level === \"error\") console.error(line);\n      else if (event.level === \"warning\") console.warn(line);\n      else console.info(line);\n    },\n  };\n}\n\n/**\n * The memory prefs fallback. It ANNOUNCES ITSELF ONCE with the remedy the\n * first time it is written to, because a draft that silently evaporates on\n * reload is exactly the class Law 4 forbids.\n */\nexport function createMemoryPrefs(\n  notifier: ChatNotifierPort = createConsoleNotifier(),\n): ChatPrefsPort {\n  const map = new Map<string, string>();\n  let announced = false;\n  const announce = (): void => {\n    if (announced) return;\n    announced = true;\n    notifier.notify({\n      level: \"warning\",\n      message:\n        \"Chat preferences and drafts are being kept in memory only, so they will be lost when this page reloads.\",\n      remedy:\n        \"Give the chat a `prefs` port backed by localStorage (or your own store) to keep drafts across reloads.\",\n    });\n  };\n  return {\n    get: (key) => map.get(key) ?? null,\n    set: (key, value) => {\n      announce();\n      map.set(key, value);\n    },\n    remove: (key) => {\n      map.delete(key);\n    },\n  };\n}\n\n/**\n * `localStorage` prefs with the memory fallback. Every read AND write is\n * wrapped: a private window, blocked site data, or a full quota makes the\n * accessor THROW, and an unguarded prefs port takes the whole chat down with\n * it.\n */\nexport function createWebPrefs(\n  notifier: ChatNotifierPort = createConsoleNotifier(),\n): ChatPrefsPort {\n  const fallback = createMemoryPrefs(notifier);\n  let store: Storage | null = null;\n  try {\n    store = (globalThis as { localStorage?: Storage }).localStorage ?? null;\n    if (store) {\n      const probe = \"__ai_matrx_chat_probe__\";\n      store.setItem(probe, \"1\");\n      store.removeItem(probe);\n    }\n  } catch {\n    store = null;\n  }\n  if (!store) return fallback;\n  const live = store;\n  return {\n    get: (key) => {\n      // A write that fell back to memory (quota, or a storage that accepts the\n      // probe and rejects real writes) is INVISIBLE to `getItem` — it returns\n      // null rather than throwing, so a read that trusted it alone would hand\n      // back an empty draft and the reader would watch their message vanish.\n      try {\n        const stored = live.getItem(key);\n        if (stored !== null) return stored;\n      } catch {\n        /* fall through to the memory fallback */\n      }\n      return fallback.get(key);\n    },\n    set: (key, value) => {\n      try {\n        live.setItem(key, value);\n      } catch {\n        fallback.set(key, value);\n      }\n    },\n    remove: (key) => {\n      try {\n        live.removeItem(key);\n      } catch {\n        /* the durable copy may not exist; the memory copy still must go */\n      }\n      fallback.remove(key);\n    },\n  };\n}\n\n/** Roles the kernel renders. Anything else is reported, never dropped. */\nexport const CHAT_ROLES: readonly ChatRole[] = [\n  \"user\",\n  \"assistant\",\n  \"system\",\n  \"tool\",\n];\n","/**\n * THE THREAD STORE — layer 1 of `@ai-matrx/chat`.\n *\n * `getSnapshot()` / `subscribe()` is the `useSyncExternalStore` source shape\n * (the AI SDK's proven one), plus `subscribeToMessage(id)` so ONE streaming\n * bubble re-renders without touching the list. There is no React here, no\n * Redux here, and no `window` touched at import time.\n *\n * Performance rules that are code, not prose:\n *  1. store writes are COALESCED per frame tick, never per token;\n *  2. only the streaming message's per-message subscribers are woken on a\n *     token; the thread subscribers are woken on the same coalesced tick but\n *     the message objects of every OTHER message keep their identity, so a\n *     memoized list re-renders one row.\n */\n\nimport {\n  createChatTurnProjector,\n  type ChatTurnRefusal,\n} from \"./ingest\";\nimport {\n  decideRouting,\n  resolveChatFeatures,\n  type ChatConfigLayers,\n  type ChatFeatures,\n} from \"./config\";\nimport {\n  createChatMessage,\n  newLocalId,\n  type ChatErrorPart,\n  type ChatMessage,\n  type ChatThreadSnapshot,\n  type ChatThreadStatus,\n} from \"./model\";\nimport {\n  createConsoleErrorSink,\n  createConsoleNotifier,\n  type ChatErrorSinkPort,\n  type ChatNotifierPort,\n  type ChatPersistencePort,\n  type ChatTransportPort,\n} from \"./ports\";\nimport {\n  settleToolAnswer,\n  type ChatToolAnswer,\n  type ChatToolSettlement,\n} from \"./tool-state\";\n\nexport interface ChatThreadConfig {\n  transport: ChatTransportPort;\n  /** Absent ⇒ the thread is EPHEMERAL and says so in its snapshot. */\n  persistence?: ChatPersistencePort | undefined;\n  /** Existing conversation to continue. Omit to start a new one on first send. */\n  conversationId?: string | undefined;\n  features?: ChatConfigLayers | undefined;\n  errorSink?: ChatErrorSinkPort | undefined;\n  notifier?: ChatNotifierPort | undefined;\n  /**\n   * Coalescing window. The default `null` means \"schedule on the runtime's\n   * frame clock\" (`requestAnimationFrame` when there is one, a microtask\n   * otherwise). A number is a millisecond timer, which is what tests use so\n   * they never depend on a browser clock.\n   */\n  coalesceMs?: number | null | undefined;\n}\n\nexport interface ChatSendInput {\n  text: string;\n  fileIds?: readonly string[] | undefined;\n}\n\nexport interface ChatSendResult {\n  /** False when the send was refused BEFORE anything left the machine. */\n  accepted: boolean;\n  /** Present when `accepted` is false — the reason, in the reader's words. */\n  refusal: ChatErrorPart | null;\n}\n\nexport interface ChatThreadStore {\n  getSnapshot(): ChatThreadSnapshot;\n  subscribe(listener: () => void): () => void;\n  /** Wake ONLY on this message. The whole point of the per-message seam. */\n  subscribeToMessage(messageId: string, listener: () => void): () => void;\n  getMessageSnapshot(messageId: string): ChatMessage | undefined;\n  readonly features: ChatFeatures;\n  send(input: ChatSendInput): Promise<ChatSendResult>;\n  /** Cooperative stop. Resolves once the server acknowledged (or failed to). */\n  cancel(): Promise<void>;\n  /** Replace the transcript — used by history load and by tests. */\n  setMessages(messages: readonly ChatMessage[]): void;\n  /** Load a stored conversation through the persistence port. */\n  loadConversation(conversationId: string): Promise<void>;\n  /**\n   * Whether `startNewConversation()` actually does anything here. The kernel\n   * answers true; `/external-store` answers true only when the host gave it a\n   * handler. A shell reads THIS to decide whether a \"New conversation\" control\n   * exists at all — a New button that cannot start one is the dead control Law\n   * 4 forbids.\n   */\n  readonly canStartNewConversation: boolean;\n  /**\n   * Empty this thread and forget its conversation id, so the NEXT send starts a\n   * fresh conversation the server names.\n   *\n   * 🚨 WHY THIS IS ON THE KERNEL AND NOT THE HOST'S JOB. Until the lane merge\n   * the conversation id was fixed for the life of the store, so \"New\n   * conversation\" on the shipped `chat.conversation` source could only work if\n   * the host threw the whole thread away and built another — which every\n   * consumer would then have had to reimplement, including the timer, the abort\n   * and the draft carry. The client still never invents an id: this clears the\n   * id and lets the FIRST TURN mint it, which is exactly what the platform\n   * does for a conversation that never existed.\n   */\n  startNewConversation(): Promise<void>;\n  /**\n   * The client answered a delegated tool — mark the call done HERE, now.\n   *\n   * The server sends no completion frame for a delegated call (it hard-suspended\n   * and closed the stream), so a transcript that only moves on frames shows\n   * \"Working…\" forever after the agent has visibly moved on. The host's answer\n   * funnel calls this in the same tick it posts the result. Monotonic and\n   * idempotent: a call already terminal is left alone and the refusal says why.\n   */\n  settleToolCall(answer: ChatToolAnswer): ChatToolSettlement;\n  /** Release timers and abort an in-flight turn. */\n  dispose(): void;\n}\n\ntype Scheduler = (run: () => void) => () => void;\n\nfunction createScheduler(coalesceMs: number | null | undefined): Scheduler {\n  if (typeof coalesceMs === \"number\") {\n    return (run) => {\n      const handle = setTimeout(run, coalesceMs);\n      return () => clearTimeout(handle);\n    };\n  }\n  const raf = (\n    globalThis as {\n      requestAnimationFrame?: (cb: () => void) => number;\n      cancelAnimationFrame?: (handle: number) => void;\n    }\n  ).requestAnimationFrame;\n  if (typeof raf === \"function\") {\n    const cancel = (globalThis as { cancelAnimationFrame?: (h: number) => void })\n      .cancelAnimationFrame;\n    return (run) => {\n      const handle = raf(run);\n      return () => cancel?.(handle);\n    };\n  }\n  return (run) => {\n    let cancelled = false;\n    queueMicrotask(() => {\n      if (!cancelled) run();\n    });\n    return () => {\n      cancelled = true;\n    };\n  };\n}\n\nconst EPHEMERAL_REASON =\n  \"This conversation is not being saved: no persistence is connected, so it disappears when you leave the page.\";\nconst EPHEMERAL_REMEDY =\n  \"Pass a `persistence` port (createMatrxChatPersistence from @ai-matrx/chat/matrx) to keep conversations.\";\n\nexport function createChatThread(config: ChatThreadConfig): ChatThreadStore {\n  const features = resolveChatFeatures(config.features);\n  const errorSink = config.errorSink ?? createConsoleErrorSink();\n  const notifier = config.notifier ?? createConsoleNotifier();\n  const schedule = createScheduler(config.coalesceMs);\n\n  let messages: ChatMessage[] = [];\n  let status: ChatThreadStatus = \"idle\";\n  let conversationId: string | null = config.conversationId ?? null;\n  let requestId: string | null = null;\n  let phase: string | null = null;\n  let error: ChatErrorPart | null = null;\n  let revision = 0;\n  let snapshot: ChatThreadSnapshot = buildSnapshot();\n  let abort: AbortController | null = null;\n  let disposed = false;\n  let announcedEphemeral = false;\n\n  /**\n   * WHICH CONVERSATION THE TRANSCRIPT IS SHOWING, as a number.\n   *\n   * 🚨 The defect this closes, found by the lane-merge test that switched away\n   * mid-answer: cancelling a turn aborts the CONTROLLER, but a transport whose\n   * frames are already queued (or one that ignores the signal, which a host may\n   * legitimately write) delivers one more. `replaceMessage` appends when it\n   * cannot find the id — so that late frame resurrected the previous\n   * conversation's half-answer INTO the empty transcript the reader was now\n   * looking at, under the new conversation's id. A stale write must be dropped,\n   * not raced. Every write in `send` is stamped with the epoch it started in,\n   * and `startNewConversation` / `loadConversation` bump it.\n   */\n  let epoch = 0;\n\n  const threadListeners = new Set<() => void>();\n  const messageListeners = new Map<string, Set<() => void>>();\n  const dirtyMessages = new Set<string>();\n  let cancelScheduled: (() => void) | null = null;\n\n  function buildSnapshot(): ChatThreadSnapshot {\n    return {\n      conversationId,\n      messages,\n      status,\n      requestId,\n      phase,\n      ephemeral: config.persistence === undefined,\n      ephemeralReason:\n        config.persistence === undefined\n          ? `${EPHEMERAL_REASON} ${EPHEMERAL_REMEDY}`\n          : null,\n      revision,\n      error,\n    };\n  }\n\n  function commit(): void {\n    revision += 1;\n    snapshot = buildSnapshot();\n    const woken = [...dirtyMessages];\n    dirtyMessages.clear();\n    for (const id of woken) {\n      const listeners = messageListeners.get(id);\n      if (!listeners) continue;\n      for (const listener of listeners) listener();\n    }\n    for (const listener of threadListeners) listener();\n  }\n\n  function markDirty(messageId: string | null): void {\n    if (messageId !== null) dirtyMessages.add(messageId);\n    if (cancelScheduled !== null) return;\n    cancelScheduled = schedule(() => {\n      cancelScheduled = null;\n      if (!disposed) commit();\n    });\n  }\n\n  /** Commit immediately — state changes a caller must observe synchronously. */\n  function commitNow(messageId: string | null): void {\n    if (messageId !== null) dirtyMessages.add(messageId);\n    cancelScheduled?.();\n    cancelScheduled = null;\n    commit();\n  }\n\n  function announceEphemeralOnce(): void {\n    if (announcedEphemeral || config.persistence !== undefined) return;\n    announcedEphemeral = true;\n    notifier.notify({\n      level: \"warning\",\n      message: EPHEMERAL_REASON,\n      remedy: EPHEMERAL_REMEDY,\n    });\n  }\n\n  function replaceMessage(next: ChatMessage): void {\n    const index = messages.findIndex((m) => m.id === next.id);\n    if (index === -1) {\n      messages = [...messages, next];\n      return;\n    }\n    const copy = messages.slice();\n    copy[index] = next;\n    messages = copy;\n  }\n\n  function refuseSend(part: ChatErrorPart): ChatSendResult {\n    error = part;\n    status = \"error\";\n    errorSink.capture({ code: part.code ?? \"chat_send_refused\", message: part.message });\n    notifier.notify({\n      level: \"error\",\n      message: part.userMessage,\n      ...(part.remedy === null ? {} : { remedy: part.remedy }),\n    });\n    commitNow(null);\n    return { accepted: false, refusal: part };\n  }\n\n  async function send(input: ChatSendInput): Promise<ChatSendResult> {\n    if (disposed) {\n      return refuseSend({\n        type: \"error\",\n        errorType: \"disposed\",\n        code: \"thread_disposed\",\n        message: \"send() was called on a disposed thread\",\n        userMessage: \"This conversation is no longer active.\",\n        recoverable: false,\n        remedy: \"Open the conversation again.\",\n      });\n    }\n    if (status === \"submitted\" || status === \"streaming\") {\n      return refuseSend({\n        type: \"error\",\n        errorType: \"busy\",\n        code: \"turn_in_flight\",\n        message: \"a turn is already streaming on this thread\",\n        userMessage: \"The assistant is still answering.\",\n        recoverable: true,\n        remedy: \"Wait for the answer to finish, or press stop.\",\n      });\n    }\n\n    // THE CONFIDENTIAL-ROUTING RULE, before a single byte leaves the machine.\n    const routing = decideRouting(features.routing, config.transport.locality);\n    if (!routing.allowed) {\n      return refuseSend({\n        type: \"error\",\n        errorType: \"routing_refused\",\n        code: routing.code,\n        message: routing.userMessage,\n        userMessage: routing.userMessage,\n        recoverable: false,\n        remedy: routing.remedy,\n      });\n    }\n\n    announceEphemeralOnce();\n\n    const fileIds = input.fileIds ?? [];\n    const userMessage = createChatMessage({\n      role: \"user\",\n      parts: [{ type: \"text\", text: input.text }],\n      status: \"complete\",\n    });\n    const assistantId = newLocalId(\"msg\");\n    const assistantPlaceholder = createChatMessage({\n      id: assistantId,\n      role: \"assistant\",\n      parts: [],\n      status: \"pending\",\n    });\n    messages = [...messages, userMessage, assistantPlaceholder];\n    error = null;\n    status = \"submitted\";\n    commitNow(assistantId);\n\n    const turnEpoch = epoch;\n    /** A write from a turn whose conversation is no longer on screen. */\n    const stale = (): boolean => disposed || turnEpoch !== epoch;\n\n    const controller = new AbortController();\n    abort = controller;\n\n    const projector = createChatTurnProjector({\n      features,\n      messageId: assistantId,\n      onRefusal: (refusal: ChatTurnRefusal) =>\n        errorSink.capture({\n          code: refusal.code,\n          message: refusal.message,\n          detail: refusal.detail,\n        }),\n    });\n\n    try {\n      const handle = await config.transport.start({\n        conversationId,\n        isNewConversation: conversationId === null,\n        store: config.persistence !== undefined,\n        text: input.text,\n        fileIds,\n        signal: controller.signal,\n      });\n      if (stale()) return { accepted: true, refusal: null };\n      requestId = handle.requestId;\n      if (handle.conversationId !== null) conversationId = handle.conversationId;\n      status = \"streaming\";\n      commitNow(assistantId);\n\n      if (stale()) return { accepted: true, refusal: null };\n      for await (const frame of handle.frames) {\n        // The reader has moved on. Stop reading the socket rather than painting\n        // the previous conversation's answer into the one now on screen.\n        if (stale()) return { accepted: true, refusal: null };\n        projector.apply(frame);\n        if (projector.state.conversationId !== null) {\n          conversationId = projector.state.conversationId;\n        }\n        if (projector.state.phase !== null) phase = projector.state.phase;\n        const live = projector.snapshot();\n        replaceMessage({\n          ...live,\n          metadata: {\n            ...live.metadata,\n            requestId,\n            createdAt: assistantPlaceholder.metadata.createdAt,\n          },\n        });\n        status =\n          projector.state.outcome === \"awaiting-tools\"\n            ? \"awaiting-approval\"\n            : \"streaming\";\n        markDirty(assistantId);\n      }\n\n      if (stale()) return { accepted: true, refusal: null };\n      const serverUserId = projector.state.serverMessageIds.user;\n      if (serverUserId !== null) {\n        replaceMessage({\n          ...userMessage,\n          metadata: { ...userMessage.metadata, serverMessageId: serverUserId },\n        });\n      }\n      const final = projector.snapshot();\n      replaceMessage({\n        ...final,\n        metadata: {\n          ...final.metadata,\n          requestId,\n          createdAt: assistantPlaceholder.metadata.createdAt,\n        },\n      });\n      error = projector.state.error;\n      status = projector.state.outcome === \"error\" ? \"error\" : \"idle\";\n      commitNow(assistantId);\n      return { accepted: true, refusal: null };\n    } catch (cause) {\n      if (stale()) return { accepted: true, refusal: null };\n      const aborted =\n        controller.signal.aborted ||\n        (cause instanceof Error && cause.name === \"AbortError\");\n      const message = cause instanceof Error ? cause.message : String(cause);\n      const part: ChatErrorPart = aborted\n        ? {\n            type: \"error\",\n            errorType: \"cancelled\",\n            code: \"turn_cancelled\",\n            message: \"the turn was cancelled by the reader\",\n            userMessage: \"You stopped this answer.\",\n            recoverable: true,\n            remedy: null,\n          }\n        : {\n            type: \"error\",\n            errorType: \"transport\",\n            code: \"transport_failed\",\n            message,\n            userMessage: \"The connection to the assistant failed.\",\n            recoverable: true,\n            remedy: \"Try sending the message again.\",\n          };\n      const partial = projector.snapshot();\n      replaceMessage({\n        ...partial,\n        // Partial text NEVER vanishes: the reader keeps what they already saw.\n        parts: [...partial.parts, part],\n        status: aborted ? \"cancelled\" : \"error\",\n        metadata: {\n          ...partial.metadata,\n          requestId,\n          createdAt: assistantPlaceholder.metadata.createdAt,\n        },\n      });\n      if (!aborted) {\n        error = part;\n        status = \"error\";\n        errorSink.capture({ code: part.code ?? \"transport_failed\", message });\n      } else {\n        status = \"idle\";\n      }\n      commitNow(assistantId);\n      return { accepted: true, refusal: null };\n    } finally {\n      if (abort === controller) abort = null;\n    }\n  }\n\n  async function cancel(): Promise<void> {\n    const current = requestId;\n    abort?.abort();\n    if (current === null) return;\n    try {\n      await config.transport.cancel(current);\n    } catch (cause) {\n      errorSink.capture({\n        code: \"cancel_failed\",\n        message: cause instanceof Error ? cause.message : String(cause),\n      });\n      notifier.notify({\n        level: \"warning\",\n        message: \"The assistant did not confirm that it stopped.\",\n        remedy: \"It stops at its next step; anything already written is saved.\",\n      });\n    }\n  }\n\n  async function loadConversation(id: string): Promise<void> {\n    const persistence = config.persistence;\n    if (persistence === undefined) {\n      const part: ChatErrorPart = {\n        type: \"error\",\n        errorType: \"no_persistence\",\n        code: \"history_unavailable\",\n        message: \"loadConversation() was called on a thread with no persistence port\",\n        userMessage: \"Past conversations are not available here.\",\n        recoverable: false,\n        remedy: EPHEMERAL_REMEDY,\n      };\n      refuseSend(part);\n      return;\n    }\n    epoch += 1;\n    const loaded = await persistence.loadThread(id);\n    conversationId = id;\n    messages = loaded.slice();\n    status = \"idle\";\n    error = null;\n    commitNow(null);\n  }\n\n  /**\n   * A fresh conversation on THIS store. An answer still arriving is stopped\n   * first — leaving it running would append the old conversation's frames to\n   * the empty transcript the reader is now looking at — and the stop is\n   * cooperative, so what the server has already written is still saved where it\n   * belongs. Doctrine: a disconnect never cancels server work, and this method\n   * promises nothing more than it does.\n   */\n  async function startNewConversation(): Promise<void> {\n    if (disposed) return;\n    epoch += 1;\n    if (status === \"streaming\" || status === \"submitted\") await cancel();\n    abort = null;\n    conversationId = null;\n    requestId = null;\n    phase = null;\n    messages = [];\n    error = null;\n    status = \"idle\";\n    commitNow(null);\n  }\n\n  return {\n    getSnapshot: () => snapshot,\n    subscribe(listener) {\n      threadListeners.add(listener);\n      return () => {\n        threadListeners.delete(listener);\n      };\n    },\n    subscribeToMessage(messageId, listener) {\n      const existing = messageListeners.get(messageId) ?? new Set<() => void>();\n      existing.add(listener);\n      messageListeners.set(messageId, existing);\n      return () => {\n        existing.delete(listener);\n        if (existing.size === 0) messageListeners.delete(messageId);\n      };\n    },\n    // Reads the COMMITTED snapshot, never the in-flight draft: a per-message\n    // hook that could see an uncommitted value tears against the thread.\n    getMessageSnapshot: (messageId) =>\n      snapshot.messages.find((m) => m.id === messageId),\n    features,\n    send,\n    cancel,\n    setMessages(next) {\n      messages = next.slice();\n      commitNow(null);\n    },\n    settleToolCall(answer) {\n      const settlement = settleToolAnswer(messages, answer);\n      if (!settlement.applied) {\n        if (settlement.refusal !== null) {\n          errorSink.capture({\n            code: \"tool_state_transition_refused\",\n            message: settlement.refusal,\n            detail: answer,\n          });\n        }\n        return settlement;\n      }\n      messages = settlement.messages.slice();\n      commitNow(settlement.messageId);\n      return settlement;\n    },\n    loadConversation,\n    canStartNewConversation: true,\n    startNewConversation,\n    dispose() {\n      disposed = true;\n      cancelScheduled?.();\n      cancelScheduled = null;\n      abort?.abort();\n      threadListeners.clear();\n      messageListeners.clear();\n    },\n  };\n}\n","/**\n * `@ai-matrx/chat/matrx` — THE PLATFORM BINDING.\n *\n * Everything in this entry knows the exact AI Matrx contract: the `/ai/*`\n * routes through `@ai-matrx/agents`, the conversation-start triple, and the\n * `chat.*` schema. Everything host-shaped stays injected.\n *\n * A host reaches a working, persisting, streaming thread with one call:\n *\n * ```ts\n * const thread = createMatrxChatThread({\n *   transport: createMatrxTransport({ baseUrl, credentials, organizationId }),\n *   dataSource: supabase,\n *   organizationId,\n *   target: { kind: \"agent\", agentId },\n *   sourceApp: \"workflow-studio\",\n *   sourceFeature: \"conductor\",\n * });\n * ```\n */\n\nexport {\n  CHAT_SCHEMA,\n  CHAT_TABLES,\n  type ChatDataSource,\n  type ChatSelectQuery,\n  type ChatTableQuery,\n  type PgError,\n  type PgResult,\n} from \"./data-source\";\n\nexport {\n  createMatrxChatTargetRef,\n  createMatrxChatTransport,\n  matrxChatTargetRef,\n  parseMatrxChatTarget,\n  TARGET_IGNORED_ON_CONTINUE,\n  TARGET_IGNORED_ON_CONTINUE_REMEDY,\n  type MatrxChatTarget,\n  type MatrxChatTargetRef,\n  type MatrxChatTransportOptions,\n} from \"./transport\";\n\nexport {\n  createMatrxChatPersistence,\n  isArchivedRow,\n  mapPersistedContent,\n  mapPersistedMessages,\n  toConversationSummary,\n  type MatrxChatPersistenceOptions,\n} from \"./persistence\";\n\nimport type { MatrxTransport } from \"@ai-matrx/agents/matrx\";\n\nimport { createChatThread, type ChatThreadConfig, type ChatThreadStore } from \"../store\";\nimport type { ChatConfigLayers } from \"../config\";\nimport type { ChatDataSource } from \"./data-source\";\nimport { createMatrxChatPersistence } from \"./persistence\";\nimport { createMatrxChatTransport, type MatrxChatTarget } from \"./transport\";\n\nexport interface MatrxChatThreadOptions {\n  /** The production `MatrxTransport` from `@ai-matrx/agents/matrx`. */\n  transport: MatrxTransport;\n  /** Who answers — a function for a surface whose picker can change it\n   *  between turns (`createMatrxChatTargetRef().get`). */\n  target: MatrxChatTarget | (() => MatrxChatTarget);\n  /** The picked model, resolved per turn; `null` leaves the agent's own. */\n  model?: string | null | (() => string | null) | undefined;\n  organizationId: string;\n  sourceApp: string;\n  sourceFeature: string;\n  /**\n   * A supabase-js client. OMIT IT DELIBERATELY for an ephemeral thread — the\n   * thread then runs unpersisted AND SAYS SO on screen, with the remedy. It is\n   * never a silent downgrade.\n   */\n  dataSource?: ChatDataSource | undefined;\n  conversationId?: string | undefined;\n  features?: ChatConfigLayers | undefined;\n  initiation?: \"user\" | \"auto\" | undefined;\n  locality?: \"local\" | \"cloud\" | undefined;\n  errorSink?: ChatThreadConfig[\"errorSink\"] | undefined;\n  notifier?: ChatThreadConfig[\"notifier\"] | undefined;\n  coalesceMs?: number | null | undefined;\n}\n\n/** The batteries-included platform thread: transport + persistence + kernel. */\nexport function createMatrxChatThread(\n  options: MatrxChatThreadOptions,\n): ChatThreadStore {\n  const transport = createMatrxChatTransport({\n    transport: options.transport,\n    target: options.target,\n    organizationId: options.organizationId,\n    sourceApp: options.sourceApp,\n    sourceFeature: options.sourceFeature,\n    initiation: options.initiation,\n    locality: options.locality,\n    model: options.model,\n    // The transport's own sentence (a continue cannot change who answers) goes\n    // to the SAME notifier as the kernel's, so a host wires one sink, not two.\n    notifier: options.notifier,\n  });\n  const persistence =\n    options.dataSource === undefined\n      ? undefined\n      : createMatrxChatPersistence({\n          dataSource: options.dataSource,\n          organizationId: options.organizationId,\n        });\n  return createChatThread({\n    transport,\n    persistence,\n    conversationId: options.conversationId,\n    features: options.features,\n    errorSink: options.errorSink,\n    notifier: options.notifier,\n    coalesceMs: options.coalesceMs,\n  });\n}\n"],"mappings":"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","names":["handle","part","asRecord","asString"]}
+{"version":3,"sources":["../../src/compat/matrx/data-source.ts","../../src/compat/matrx/transport.ts","../../src/compat/model.ts","../../src/compat/matrx/persistence.ts","../../src/compat/tool-state.ts","../../src/compat/ingest.ts","../../src/compat/config.ts","../../src/compat/ports.ts","../../src/compat/store.ts","../../src/compat/matrx/index.ts"],"sourcesContent":["/**\n * The data seam — a structural subset of `SupabaseClient<Database>`, the\n * `@ai-matrx/associations` precedent. `PromiseLike` rather than `Promise`\n * because supabase-js returns a thenable builder, not a Promise, and typing it\n * as a Promise makes a real client fail to satisfy the interface.\n *\n * Clients read and write the database DIRECTLY (workspace rule: the Python\n * server is for work a client cannot do, never a data middle tier), so this\n * port is a supabase-js client and nothing else is expected to implement it.\n */\n\nexport interface PgError {\n  message: string;\n  code?: string | undefined;\n  details?: string | undefined;\n  hint?: string | undefined;\n}\n\nexport interface PgResult<T> {\n  data: T | null;\n  error: PgError | null;\n}\n\nexport interface ChatSelectQuery extends PromiseLike<PgResult<unknown[]>> {\n  eq(column: string, value: unknown): ChatSelectQuery;\n  is(column: string, value: unknown): ChatSelectQuery;\n  in(column: string, values: readonly unknown[]): ChatSelectQuery;\n  lt(column: string, value: unknown): ChatSelectQuery;\n  order(column: string, options: { ascending: boolean }): ChatSelectQuery;\n  limit(count: number): ChatSelectQuery;\n}\n\nexport interface ChatTableQuery {\n  select(columns: string, options?: { count?: \"exact\"; head?: boolean }): ChatSelectQuery;\n  update(patch: Record<string, unknown>): {\n    eq(column: string, value: unknown): PromiseLike<{ error: PgError | null }>;\n  };\n}\n\nexport interface ChatDataSource {\n  schema(name: string): { from(table: string): ChatTableQuery };\n}\n\n/** The schema this package reads and writes. Renaming it breaks every read. */\nexport const CHAT_SCHEMA = \"chat\";\n\n/** The `chat.*` tables the persistence binding touches. */\nexport const CHAT_TABLES = {\n  conversation: \"conversation\",\n  message: \"message\",\n} as const;\n","/**\n * `@ai-matrx/chat/matrx` — THE PLATFORM TRANSPORT.\n *\n * Wire semantics verified against the aidream SERVER source and against LIVE\n * bytes, never guessed from a client (C22):\n *\n * - `POST /ai/agents/{agent_id}`               — start an agent turn\n * - `POST /ai/mandates/{mandate_key}`          — start a declared mandate\n * - `POST /ai/conversations/{conversation_id}` — continue a stored conversation\n * - `POST /ai/cancel/{request_id}?mode=interrupt` — cooperative stop\n *\n * The conversation-start triple (`conversation_id` / `is_new` / `store`) is\n * sent in full on every start, no defaults — `store: false` is the ONLY\n * ephemeral signal, and the kernel derives it from whether a persistence port\n * exists, so an unpersisted thread never silently writes rows.\n */\n\nimport {\n  cancelAgentRun,\n  continueAgentConversation,\n  startAgentRun,\n  startMandateRun,\n  type MatrxTransport,\n} from \"@ai-matrx/agents/matrx\";\n\nimport type {\n  ChatNotifierPort,\n  ChatSendRequest,\n  ChatStreamFrame,\n  ChatTransportPort,\n  ChatTurnHandle,\n} from \"../ports\";\n\n/** Which brain this thread talks to. */\nexport type MatrxChatTarget =\n  | { kind: \"agent\"; agentId: string }\n  | { kind: \"mandate\"; mandateKey: string };\n\n/**\n * THE REFERENCE SHAPE EVERY CLIENT ALREADY SPEAKS. `AgentListDropdown` hands\n * back an agent id, or `mandate:<key>` for the platform-default row. This is\n * the ONE place that turns those words into a target, so a host wiring the\n * picker does not each invent the same two-line parse — and an empty reference\n * throws by name instead of starting a run against nothing.\n */\nexport function parseMatrxChatTarget(agentRef: string): MatrxChatTarget {\n  const trimmed = agentRef.trim();\n  if (trimmed === \"\") {\n    throw new Error(\n      \"@ai-matrx/chat/matrx: an empty agent reference cannot name who answers. Pass an agent id, or `mandate:<key>` for a mandate.\",\n    );\n  }\n  if (trimmed.startsWith(\"mandate:\")) {\n    const mandateKey = trimmed.slice(\"mandate:\".length).trim();\n    if (mandateKey === \"\") {\n      throw new Error(\n        \"@ai-matrx/chat/matrx: `mandate:` with no key cannot name who answers.\",\n      );\n    }\n    return { kind: \"mandate\", mandateKey };\n  }\n  return { kind: \"agent\", agentId: trimmed };\n}\n\n/** The same target, as the two strings a screen and a test can compare. */\nexport function matrxChatTargetRef(target: MatrxChatTarget): string {\n  return target.kind === \"agent\"\n    ? target.agentId\n    : `mandate:${target.mandateKey}`;\n}\n\n/**\n * THE LIVE CHOICE — what the composer's pickers write into, and what the next\n * send reads.\n *\n * It is a tiny subscribable rather than React state on purpose: the transport\n * is a PURE-layer object built once, outside React, and a transport that closed\n * over the target at construction would keep answering as the agent the reader\n * changed away from. The picker sets it, the transport reads it per turn, and\n * anything that wants to paint the current choice subscribes.\n */\nexport interface MatrxChatTargetRef {\n  get(): MatrxChatTarget;\n  getModel(): string | null;\n  set(target: MatrxChatTarget): void;\n  setModel(model: string | null): void;\n  subscribe(listener: () => void): () => void;\n}\n\nexport function createMatrxChatTargetRef(\n  initial: MatrxChatTarget,\n  initialModel: string | null = null,\n): MatrxChatTargetRef {\n  let target = initial;\n  let model = initialModel;\n  const listeners = new Set<() => void>();\n  const wake = (): void => {\n    for (const listener of listeners) listener();\n  };\n  return {\n    get: () => target,\n    getModel: () => model,\n    set(next) {\n      if (matrxChatTargetRef(next) === matrxChatTargetRef(target)) return;\n      target = next;\n      wake();\n    },\n    setModel(next) {\n      const normalized = next === null || next.trim() === \"\" ? null : next;\n      if (normalized === model) return;\n      model = normalized;\n      wake();\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\nexport const TARGET_IGNORED_ON_CONTINUE =\n  \"This conversation keeps answering as the agent it was started with, so your new choice was not used for that message.\";\nexport const TARGET_IGNORED_ON_CONTINUE_REMEDY =\n  \"Start a new conversation to talk to the one you just picked.\";\n\nexport interface MatrxChatTransportOptions {\n  /**\n   * The `MatrxTransport` port. Build it with\n   * `createMatrxTransport({ baseUrl, credentials, organizationId })` from\n   * `@ai-matrx/agents/matrx` — that is the production pipeline (retry,\n   * connect timeout, the v2→v1 protocol fallback, fresh credentials per call,\n   * the fail-closed org header). Hand-rolling a fetch here loses all of it.\n   */\n  transport: MatrxTransport;\n  /**\n   * Who answers. A FUNCTION is the live form: the pickers change the choice\n   * between turns, and the transport resolves it at the moment of the send\n   * rather than at construction (`createMatrxChatTargetRef().get`).\n   */\n  target: MatrxChatTarget | (() => MatrxChatTarget);\n  /**\n   * The model the reader picked, resolved per turn the same way. It rides\n   * `config_overrides.model` (the server's `LLMParams`), and `null` means the\n   * agent's own configured model is used — the transport never sends a null\n   * override, because a blank override is a silent reconfiguration.\n   */\n  model?: string | null | (() => string | null) | undefined;\n  /** REQUIRED by the server: it never manufactures an organization. */\n  organizationId: string;\n  /**\n   * Attribution. The server REFUSES an unregistered pair with a 422 naming\n   * the registry — that is deliberate, and a caller that invents a slug gets\n   * a loud rejection rather than an unattributable row.\n   */\n  sourceApp: string;\n  sourceFeature: string;\n  /** \"user\" = a person pressed send; \"auto\" = client automation. */\n  initiation?: \"user\" | \"auto\" | undefined;\n  /**\n   * Where this transport sends text. The kernel's confidential-routing rule\n   * reads it, so answering \"local\" for a cloud endpoint defeats the rule.\n   */\n  locality?: \"local\" | \"cloud\" | undefined;\n  /** Extra scope/context merged into every turn body. */\n  extra?: Record<string, unknown> | undefined;\n  /**\n   * Where the transport says what it could not do. It is used for exactly one\n   * sentence today: a CONTINUE cannot change who answers (the server resolves\n   * the conversation's own agent), so a reader who picks a different agent\n   * mid-conversation is TOLD their choice did not apply to that message, once\n   * per conversation, with the remedy. Without it the picker would silently\n   * lie about who just replied.\n   */\n  notifier?: ChatNotifierPort | undefined;\n}\n\nfunction mintConversationId(): string {\n  const cryptoRef: { randomUUID?: () => string } | undefined = (\n    globalThis as { crypto?: { randomUUID?: () => string } }\n  ).crypto;\n  if (typeof cryptoRef?.randomUUID === \"function\") return cryptoRef.randomUUID();\n  throw new Error(\n    \"@ai-matrx/chat/matrx needs crypto.randomUUID to mint a conversation id (the client mints it, by contract). \" +\n      \"Run on Node 19+, a browser, Deno or Bun, or pass an explicit conversationId to the thread.\",\n  );\n}\n\nexport function createMatrxChatTransport(\n  options: MatrxChatTransportOptions,\n): ChatTransportPort {\n  const initiation = options.initiation ?? \"user\";\n  const resolveTarget = (): MatrxChatTarget =>\n    typeof options.target === \"function\" ? options.target() : options.target;\n  const resolveModel = (): string | null => {\n    const model =\n      typeof options.model === \"function\" ? options.model() : (options.model ?? null);\n    return model === null || model.trim() === \"\" ? null : model;\n  };\n  // The target a conversation was STARTED with, so a later continue can tell\n  // the reader their new choice did not reach this transcript. Announced once\n  // per conversation: one sentence is information, one per message is noise.\n  const startedAs = new Map<string, string>();\n  const warned = new Set<string>();\n  const scope = {\n    organization_id: options.organizationId,\n    source_app: options.sourceApp,\n    source_feature: options.sourceFeature,\n    initiation,\n    ...options.extra,\n  };\n\n  return {\n    locality: options.locality ?? \"cloud\",\n\n    async start(request: ChatSendRequest): Promise<ChatTurnHandle> {\n      const signalOption = { signal: request.signal };\n\n      const model = resolveModel();\n      // A null override is NEVER sent: `config_overrides: { model: null }` is a\n      // blank reconfiguration of the agent, not \"leave it alone\".\n      const overrides = model === null ? {} : { config_overrides: { model } };\n\n      if (request.conversationId !== null && !request.isNewConversation) {\n        const openedAs = startedAs.get(request.conversationId);\n        const chosen = matrxChatTargetRef(resolveTarget());\n        if (\n          openedAs !== undefined &&\n          openedAs !== chosen &&\n          !warned.has(request.conversationId)\n        ) {\n          warned.add(request.conversationId);\n          options.notifier?.notify({\n            level: \"warning\",\n            message: TARGET_IGNORED_ON_CONTINUE,\n            remedy: TARGET_IGNORED_ON_CONTINUE_REMEDY,\n          });\n        }\n        const handle = await continueAgentConversation(\n          options.transport,\n          request.conversationId,\n          { ...scope, ...overrides, user_input: request.text },\n          signalOption,\n        );\n        return toChatTurnHandle(handle);\n      }\n\n      const target = resolveTarget();\n      const conversationId = request.conversationId ?? mintConversationId();\n      startedAs.set(conversationId, matrxChatTargetRef(target));\n      const body = {\n        ...scope,\n        ...overrides,\n        // THE CONVERSATION-START TRIPLE, in full, every time.\n        conversation_id: conversationId,\n        is_new: true as const,\n        store: request.store,\n        user_input: request.text,\n      };\n      const handle =\n        target.kind === \"agent\"\n          ? await startAgentRun(\n              options.transport,\n              target.agentId,\n              body as Parameters<typeof startAgentRun>[2],\n              signalOption,\n            )\n          : await startMandateRun(\n              options.transport,\n              target.mandateKey,\n              body as Parameters<typeof startMandateRun>[2],\n              signalOption,\n            );\n      return toChatTurnHandle(handle, conversationId);\n    },\n\n    async cancel(requestId: string): Promise<void> {\n      // `interrupt` is stop-and-fork: the tail after the last clean boundary\n      // persists hidden, so the reader's next message replies to what they\n      // actually saw. A plain cancel loses that.\n      await cancelAgentRun(options.transport, requestId, { mode: \"interrupt\" });\n    },\n  };\n}\n\nfunction toChatTurnHandle(\n  handle: {\n    requestId: string | null;\n    conversationId: string | null;\n    events: AsyncIterable<{\n      event: string;\n      data: unknown;\n      stream_id?: string | undefined;\n      stream_seq?: number | undefined;\n    }>;\n  },\n  mintedConversationId?: string,\n): ChatTurnHandle {\n  return {\n    requestId: handle.requestId,\n    conversationId: handle.conversationId ?? mintedConversationId ?? null,\n    frames: handle.events as AsyncIterable<ChatStreamFrame>,\n  };\n}\n","/**\n * The message / part model — layer 1 of `@ai-matrx/chat`.\n *\n * Deliberately the industry-canonical shape (Vercel AI SDK `UIMessage.parts[]`\n * plus its tool-part state machine), because our own\n * `@ai-matrx/agents/projection/request` already produces its equivalent and a\n * customer's agent already knows it. Nothing here imports React, Redux, a\n * framework, or `window`.\n *\n * Every part type below was chosen against BYTES, not against a guess: the\n * live corpus in `fixtures/corpus/` carries text, reasoning (both wire\n * shapes), tool lifecycle, warnings and a fatal error, and the persisted\n * `chat.message.content` rows carry `text` | `thinking` | `tool_call` |\n * `tool_result`.\n */\n\n/** JSON on the wire. Public JSON boundaries are `unknown`-typed by standard. */\nexport type ChatJsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | ChatJsonValue[]\n  | { [key: string]: ChatJsonValue };\n\nexport type ChatRole = \"user\" | \"assistant\" | \"system\" | \"tool\";\n\n/**\n * THE TOOL STATE MACHINE (the champion's, verbatim). A tool part only ever\n * moves forward along these states; `advanceToolState` in `./tool-state`\n * refuses anything else out loud rather than silently overwriting.\n */\nexport type ChatToolState =\n  | \"input-streaming\"\n  | \"input-available\"\n  | \"approval-requested\"\n  | \"output-available\"\n  | \"output-error\"\n  | \"output-denied\";\n\n/** One tool progress beat — the `tool_event`/`tool_progress` frames. */\nexport interface ChatToolProgress {\n  /** The tool name the SERVER used on this beat: it differs from the call's\n   *  tool name mid-run (`web` → `web_search` → `web_research` in the corpus),\n   *  and flattening them loses what actually ran. */\n  toolName: string;\n  message: string;\n  percent: number | null;\n  /** Server timestamp in seconds, verbatim; null when the frame carried none. */\n  at: number | null;\n}\n\nexport interface ChatTextPart {\n  readonly type: \"text\";\n  text: string;\n}\n\nexport interface ChatReasoningPart {\n  readonly type: \"reasoning\";\n  text: string;\n  state: \"streaming\" | \"done\";\n}\n\nexport interface ChatToolPart {\n  readonly type: \"tool\";\n  /** The provider/server call id — the ONLY identity a tool part has. */\n  toolCallId: string;\n  toolName: string;\n  state: ChatToolState;\n  input: unknown;\n  output: unknown;\n  /** Present only in `output-error`; null otherwise. */\n  errorText: string | null;\n  progress: ChatToolProgress[];\n  /** True once the server emitted `tool_delegated` — the CLIENT must run it. */\n  delegated: boolean;\n}\n\nexport interface ChatFilePart {\n  readonly type: \"file\";\n  /** A durable Matrx file id. A signed URL is a handoff, never an identity. */\n  fileId: string;\n  name: string | null;\n  mediaType: string | null;\n}\n\nexport interface ChatSourcePart {\n  readonly type: \"source\";\n  sourceId: string;\n  url: string | null;\n  title: string | null;\n}\n\nexport interface ChatRenderBlockPart {\n  readonly type: \"render-block\";\n  blockId: string;\n  blockIndex: number;\n  /** The content-IR kind name. */\n  kind: string;\n  content: string | null;\n  data: unknown;\n  status: \"streaming\" | \"complete\" | \"error\";\n}\n\nexport interface ChatAskUserPart {\n  readonly type: \"ask-user\";\n  askId: string;\n  prompt: string;\n  fields: unknown;\n  answered: boolean;\n}\n\n/**\n * A failure the READER must see. `userMessage` is what a screen shows;\n * `remedy` is what the reader can do about it. Law 4 — nothing fails\n * silently, and a stand-in announces itself WITH a remedy.\n */\nexport interface ChatErrorPart {\n  readonly type: \"error\";\n  errorType: string | null;\n  code: string | null;\n  message: string;\n  userMessage: string;\n  recoverable: boolean;\n  remedy: string | null;\n}\n\n/**\n * A non-fatal server notice (`warning` / `info` frames). It is a PART, not a\n * side channel, because the corpus proves a run can lose half its tools and\n * still answer — and a reader who is not told has been lied to.\n */\nexport interface ChatNoticePart {\n  readonly type: \"notice\";\n  level: \"info\" | \"low\" | \"medium\" | \"high\";\n  code: string | null;\n  userMessage: string;\n  remedy: string | null;\n}\n\nexport type ChatPart =\n  | ChatTextPart\n  | ChatReasoningPart\n  | ChatToolPart\n  | ChatFilePart\n  | ChatSourcePart\n  | ChatRenderBlockPart\n  | ChatAskUserPart\n  | ChatErrorPart\n  | ChatNoticePart;\n\nexport type ChatMessageStatus =\n  | \"pending\"\n  | \"streaming\"\n  | \"complete\"\n  | \"error\"\n  | \"cancelled\";\n\nexport interface ChatMessageMetadata {\n  /** The server's `X-Request-ID` for the turn this message belongs to. */\n  requestId: string | null;\n  /** The server `chat.message` row id once `record_update` announced it. */\n  serverMessageId: string | null;\n  /** Model id/name the server reported, when it reported one. Never a UUID on\n   *  screen — `renderModelRef` resolves it (phase 2). */\n  modelRef: string | null;\n  createdAt: string;\n  /** Free-form server metadata (finish_reason, usage, …), verbatim. */\n  raw: Record<string, unknown> | null;\n}\n\nexport interface ChatMessage {\n  id: string;\n  role: ChatRole;\n  parts: ChatPart[];\n  status: ChatMessageStatus;\n  metadata: ChatMessageMetadata;\n}\n\n/**\n * THE THREAD STATE MACHINE.\n * `idle → submitted → streaming → (awaiting-approval) → idle | error`.\n */\nexport type ChatThreadStatus =\n  | \"idle\"\n  | \"submitted\"\n  | \"streaming\"\n  | \"awaiting-approval\"\n  | \"error\";\n\nexport interface ChatThreadSnapshot {\n  conversationId: string | null;\n  /** Ordered oldest-first. */\n  messages: readonly ChatMessage[];\n  status: ChatThreadStatus;\n  /** The server request id of the CURRENT or last turn — the only id the\n   *  server accepts for cancel. */\n  requestId: string | null;\n  /** Last server `phase`, verbatim. */\n  phase: string | null;\n  /**\n   * TRUE when nothing is persisting this thread. The screen must SAY so with\n   * the remedy (`ephemeralReason`) — an unannounced ephemeral thread is the\n   * silent failure Law 4 forbids.\n   */\n  ephemeral: boolean;\n  ephemeralReason: string | null;\n  /** Monotonic; bumps on every applied change so hosts can cheap-compare. */\n  revision: number;\n  /** Last fatal error for the thread, if any. */\n  error: ChatErrorPart | null;\n}\n\nlet idCounter = 0;\n\n/**\n * A collision-resistant local id. `crypto.randomUUID` when the runtime has it\n * (browsers, node >= 19, Deno, Bun), and a counter+random fallback that\n * announces nothing because it is not a stand-in for a capability — it is the\n * same guarantee by other means.\n */\nexport function newLocalId(prefix: string): string {\n  const cryptoRef: { randomUUID?: () => string } | undefined = (\n    globalThis as { crypto?: { randomUUID?: () => string } }\n  ).crypto;\n  if (typeof cryptoRef?.randomUUID === \"function\") {\n    return `${prefix}_${cryptoRef.randomUUID()}`;\n  }\n  idCounter += 1;\n  return `${prefix}_${Date.now().toString(36)}_${idCounter.toString(36)}_${Math.random()\n    .toString(36)\n    .slice(2, 10)}`;\n}\n\nexport function createChatMessage(input: {\n  id?: string | undefined;\n  role: ChatRole;\n  parts?: ChatPart[] | undefined;\n  status?: ChatMessageStatus | undefined;\n  metadata?: Partial<ChatMessageMetadata> | undefined;\n}): ChatMessage {\n  return {\n    id: input.id ?? newLocalId(\"msg\"),\n    role: input.role,\n    parts: input.parts ?? [],\n    status: input.status ?? \"complete\",\n    metadata: {\n      requestId: input.metadata?.requestId ?? null,\n      serverMessageId: input.metadata?.serverMessageId ?? null,\n      modelRef: input.metadata?.modelRef ?? null,\n      createdAt: input.metadata?.createdAt ?? new Date().toISOString(),\n      raw: input.metadata?.raw ?? null,\n    },\n  };\n}\n\n/** Every `text` part concatenated — what a copy button copies. */\nexport function messageText(message: ChatMessage): string {\n  let out = \"\";\n  for (const part of message.parts) if (part.type === \"text\") out += part.text;\n  return out;\n}\n\n/** Every `reasoning` part concatenated. */\nexport function messageReasoning(message: ChatMessage): string {\n  let out = \"\";\n  for (const part of message.parts) if (part.type === \"reasoning\") out += part.text;\n  return out;\n}\n\n/** Tool parts in first-seen order. */\nexport function messageTools(message: ChatMessage): ChatToolPart[] {\n  return message.parts.filter((p): p is ChatToolPart => p.type === \"tool\");\n}\n","/**\n * THE `chat.*` PERSISTENCE BINDING — conversation history and transcript\n * loading, read DIRECTLY from Postgres under RLS (clients never route ordinary\n * reads through the Python server).\n *\n * Verified against the live schema on 2026-09-17:\n *   `chat.conversation(id, title, created_at, updated_at, deleted_at,\n *      message_count, source_app, source_feature, is_ephemeral,\n *      metadata, organization_id, …)`\n *   `chat.message(id, conversation_id, role, position, status, content jsonb,\n *      metadata, created_at, is_visible_to_user, deleted_at, …)`\n *\n * `chat.message.content` is an ARRAY OF PARTS, and the persisted part\n * vocabulary — read off real rows, not guessed — is `text` | `thinking` |\n * `tool_call` | `tool_result`. `mapPersistedContent` is the ONE place that\n * vocabulary is translated into this package's part model; a second translator\n * anywhere is the defect this binding exists to prevent.\n *\n * 🚨 ARCHIVE: `chat.conversation` has no boolean archive column. Archive state\n * lives in `metadata.archived`, which is what the platform already writes, and\n * THE ARCHIVED-ITEMS LAW is honoured in the reader: the default list hides\n * archived rows and REPORTS how many it hid, so the footer can name them.\n */\n\nimport type {\n  ChatConversationListPage,\n  ChatConversationListQuery,\n  ChatConversationSummary,\n  ChatPersistencePort,\n} from \"../ports\";\nimport {\n  createChatMessage,\n  type ChatMessage,\n  type ChatPart,\n  type ChatRole,\n  type ChatToolPart,\n} from \"../model\";\nimport {\n  CHAT_SCHEMA,\n  CHAT_TABLES,\n  type ChatDataSource,\n  type PgError,\n} from \"./data-source\";\n\nconst CONVERSATION_COLUMNS =\n  \"id,title,created_at,updated_at,message_count,source_app,source_feature,metadata\";\n/** Favorites are PER PERSON: the caller's `platform.user_entity_state` row (RLS: own rows only),\n *  never a column on the conversation (dropped by aidream migration 1377). */\nconst FAVORITES_SCHEMA = \"platform\";\nconst FAVORITES_TABLE = \"user_entity_state\";\nconst MESSAGE_COLUMNS =\n  \"id,role,position,status,content,metadata,created_at,is_visible_to_user\";\n\nconst DEFAULT_LIMIT = 50;\n\nexport interface MatrxChatPersistenceOptions {\n  dataSource: ChatDataSource;\n  /**\n   * The host's ACTIVE organization. It NO LONGER narrows any read: a person's\n   * history spans every organization they can access, and access is decided by\n   * RLS (active-org-is-never-a-list-filter.md). Kept optional so existing hosts\n   * compile; a page that wants to narrow passes `organizationFilter` on the\n   * list query instead.\n   */\n  organizationId?: string | undefined;\n  /** Diagnostics for a failed read; absent ⇒ the error is thrown to the caller. */\n  onError?: ((error: PgError, operation: string) => void) | undefined;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\nfunction asString(value: unknown): string | null {\n  return typeof value === \"string\" ? value : null;\n}\n\n/** Whether a persisted conversation row is archived. */\nexport function isArchivedRow(row: Record<string, unknown>): boolean {\n  const metadata = asRecord(row.metadata);\n  return metadata.archived === true;\n}\n\nexport function toConversationSummary(\n  row: Record<string, unknown>,\n  favorites: ReadonlySet<string> = new Set(),\n): ChatConversationSummary {\n  const createdAt = asString(row.created_at) ?? new Date(0).toISOString();\n  return {\n    id: asString(row.id) ?? \"\",\n    title: asString(row.title),\n    createdAt,\n    updatedAt: asString(row.updated_at) ?? createdAt,\n    messageCount: typeof row.message_count === \"number\" ? row.message_count : 0,\n    archived: isArchivedRow(row),\n    isFavorite: favorites.has(asString(row.id) ?? \"\"),\n    sourceApp: asString(row.source_app),\n    sourceFeature: asString(row.source_feature),\n  };\n}\n\n/**\n * Translate ONE persisted `chat.message.content` array into parts.\n *\n * Unknown persisted types are NOT dropped: they become a `notice` part naming\n * the type, because a transcript that silently loses a part is a screen that\n * lies about what was said.\n */\nexport function mapPersistedContent(content: unknown): ChatPart[] {\n  if (!Array.isArray(content)) return [];\n  const parts: ChatPart[] = [];\n  const toolsByCallId = new Map<string, ChatToolPart>();\n\n  for (const entry of content) {\n    const item = asRecord(entry);\n    const type = asString(item.type);\n    switch (type) {\n      case \"text\": {\n        const text = asString(item.text) ?? \"\";\n        if (text) parts.push({ type: \"text\", text });\n        break;\n      }\n      case \"thinking\":\n      case \"reasoning\": {\n        const text = asString(item.text) ?? \"\";\n        // A signature-only thinking block (no text) is a provider round-trip\n        // artefact, not something a reader ever sees.\n        if (text) parts.push({ type: \"reasoning\", text, state: \"done\" });\n        break;\n      }\n      case \"tool_call\": {\n        const callId = asString(item.call_id) ?? asString(item.id);\n        const toolName = asString(item.name) ?? \"tool\";\n        if (callId === null) break;\n        const part: ChatToolPart = {\n          type: \"tool\",\n          toolCallId: callId,\n          toolName,\n          state: \"input-available\",\n          input: item.arguments ?? item.input,\n          output: undefined,\n          errorText: null,\n          progress: [],\n          delegated: false,\n        };\n        toolsByCallId.set(callId, part);\n        parts.push(part);\n        break;\n      }\n      case \"tool_result\": {\n        const callId =\n          asString(item.call_id) ?? asString(item.tool_use_id) ?? asString(item.id);\n        if (callId === null) break;\n        const isError = item.is_error === true;\n        const existing = toolsByCallId.get(callId);\n        if (existing) {\n          existing.state = isError ? \"output-error\" : \"output-available\";\n          existing.output = item.output ?? item.content ?? item.result;\n          existing.errorText = isError\n            ? (asString(item.error) ?? `The ${existing.toolName} tool failed.`)\n            : null;\n          break;\n        }\n        // A result whose call landed in an EARLIER message row (the common\n        // shape: `assistant` holds the call, `tool` holds the result).\n        parts.push({\n          type: \"tool\",\n          toolCallId: callId,\n          toolName: asString(item.name) ?? \"tool\",\n          state: isError ? \"output-error\" : \"output-available\",\n          input: undefined,\n          output: item.output ?? item.content ?? item.result,\n          errorText: isError ? (asString(item.error) ?? \"The tool failed.\") : null,\n          progress: [],\n          delegated: false,\n        });\n        break;\n      }\n      default: {\n        parts.push({\n          type: \"notice\",\n          level: \"low\",\n          code: \"unrenderable_persisted_part\",\n          userMessage: `Part of this message could not be shown (stored as \"${type ?? \"unknown\"}\").`,\n          remedy: null,\n        });\n      }\n    }\n  }\n  return parts;\n}\n\n/**\n * Fold the persisted rows into the thread's messages.\n *\n * A `tool` row carries only results for a call made in the PREVIOUS assistant\n * row; merging it into that row is what makes one tool card instead of two\n * half-cards, and it is exactly the logic every host re-derived.\n */\nexport function mapPersistedMessages(\n  rows: readonly Record<string, unknown>[],\n): ChatMessage[] {\n  const messages: ChatMessage[] = [];\n  for (const row of rows) {\n    if (row.is_visible_to_user === false) continue;\n    const role = (asString(row.role) ?? \"assistant\") as ChatRole;\n    const parts = mapPersistedContent(row.content);\n\n    if (role === \"tool\") {\n      const previous = messages[messages.length - 1];\n      if (previous && previous.role === \"assistant\") {\n        for (const part of parts) {\n          if (part.type !== \"tool\") {\n            previous.parts.push(part);\n            continue;\n          }\n          const match = previous.parts.find(\n            (candidate): candidate is ChatToolPart =>\n              candidate.type === \"tool\" && candidate.toolCallId === part.toolCallId,\n          );\n          if (match) {\n            match.state = part.state;\n            match.output = part.output;\n            match.errorText = part.errorText;\n          } else {\n            previous.parts.push(part);\n          }\n        }\n        continue;\n      }\n    }\n\n    const status = asString(row.status);\n    messages.push(\n      createChatMessage({\n        id: asString(row.id) ?? undefined,\n        role,\n        parts,\n        status: status === \"error\" ? \"error\" : \"complete\",\n        metadata: {\n          serverMessageId: asString(row.id),\n          createdAt: asString(row.created_at) ?? new Date(0).toISOString(),\n          raw: asRecord(row.metadata),\n        },\n      }),\n    );\n  }\n  return messages;\n}\n\nexport function createMatrxChatPersistence(\n  options: MatrxChatPersistenceOptions,\n): ChatPersistencePort {\n  const table = (name: string) =>\n    options.dataSource.schema(CHAT_SCHEMA).from(name);\n\n  const fail = (error: PgError, operation: string): never => {\n    options.onError?.(error, operation);\n    throw new Error(`[ai-matrx/chat] ${operation} failed: ${error.message}`);\n  };\n\n  /** The caller's favorites among these conversations. A failed read is reported and the page is\n   *  still returned (with no stars) — a list never disappears because the star read failed. */\n  const readFavorites = async (ids: string[]): Promise<Set<string>> => {\n    if (ids.length === 0) return new Set();\n    const { data, error } = await options.dataSource\n      .schema(FAVORITES_SCHEMA)\n      .from(FAVORITES_TABLE)\n      .select(\"entity_id\")\n      .eq(\"entity_type\", \"conversation\")\n      .eq(\"is_favorite\", true)\n      .in(\"entity_id\", ids);\n    if (error) {\n      options.onError?.(error, \"listConversations.favorites\");\n      return new Set();\n    }\n    return new Set(((data ?? []) as Record<string, unknown>[]).map((r) => asString(r.entity_id) ?? \"\"));\n  };\n\n  return {\n    async loadThread(conversationId: string): Promise<ChatMessage[]> {\n      const { data, error } = await table(CHAT_TABLES.message)\n        .select(MESSAGE_COLUMNS)\n        .eq(\"conversation_id\", conversationId)\n        .is(\"deleted_at\", null)\n        .order(\"position\", { ascending: true });\n      if (error) fail(error, \"loadThread\");\n      return mapPersistedMessages((data ?? []) as Record<string, unknown>[]);\n    },\n\n    async listConversations(\n      query: ChatConversationListQuery,\n    ): Promise<ChatConversationListPage> {\n      const limit = query.limit ?? DEFAULT_LIMIT;\n      let builder = table(CHAT_TABLES.conversation)\n        .select(CONVERSATION_COLUMNS)\n        .is(\"deleted_at\", null)\n        .order(\"updated_at\", { ascending: false })\n        // Over-read by one so the caller gets an honest `nextBefore` instead\n        // of a \"there might be more\" guess, and by the archive headroom so\n        // hiding archived rows does not silently shorten the page.\n        .limit(limit * 2 + 1);\n      if (query.before !== undefined) builder = builder.lt(\"updated_at\", query.before);\n      // The page's OWN organization filter — absent/null = all organizations.\n      if (query.organizationFilter) {\n        builder = builder.eq(\"organization_id\", query.organizationFilter);\n      }\n      if (query.sourceApp !== undefined) {\n        builder = builder.eq(\"source_app\", query.sourceApp);\n      }\n      if (query.sourceFeature !== undefined) {\n        builder = builder.eq(\"source_feature\", query.sourceFeature);\n      }\n\n      const { data, error } = await builder;\n      if (error) fail(error, \"listConversations\");\n\n      const rows = (data ?? []) as Record<string, unknown>[];\n      const favorites = await readFavorites(rows.map((r) => asString(r.id)).filter((id): id is string => !!id));\n      const includeArchived = query.includeArchived === true;\n      let archivedHidden = 0;\n      const kept: ChatConversationSummary[] = [];\n      let nextBefore: string | null = null;\n\n      for (const row of rows) {\n        const summary = toConversationSummary(row, favorites);\n        if (!includeArchived && summary.archived) {\n          archivedHidden += 1;\n          continue;\n        }\n        if (kept.length === limit) {\n          nextBefore = summary.updatedAt;\n          break;\n        }\n        kept.push(summary);\n      }\n\n      return { conversations: kept, archivedHidden, nextBefore };\n    },\n\n    async setArchived(conversationId: string, archived: boolean): Promise<void> {\n      // `metadata` is jsonb and carries more than this flag, so the write is\n      // READ-MERGE-WRITE and never a blind overwrite — a `{archived:true}`\n      // update would delete every other key in the column.\n      const read = await table(CHAT_TABLES.conversation)\n        .select(\"id,metadata\")\n        .eq(\"id\", conversationId)\n        .limit(1);\n      if (read.error) fail(read.error, \"setArchived\");\n      const row = ((read.data ?? []) as Record<string, unknown>[])[0];\n      if (row === undefined) {\n        throw new Error(\n          `[ai-matrx/chat] Conversation ${conversationId} could not be read, so its archive state was not changed. ` +\n            \"It may have been deleted, or this account may not have access to it.\",\n        );\n      }\n      const merged = { ...asRecord(row.metadata), archived };\n      const { error } = await table(CHAT_TABLES.conversation)\n        .update({ metadata: merged })\n        .eq(\"id\", conversationId);\n      if (error) fail(error, \"setArchived\");\n    },\n\n    async rename(conversationId: string, title: string): Promise<void> {\n      const { error } = await table(CHAT_TABLES.conversation)\n        .update({ title })\n        .eq(\"id\", conversationId);\n      if (error) fail(error, \"rename\");\n    },\n  };\n}\n","/**\n * THE TOOL-CALL STATE MACHINE.\n *\n * `input-streaming → input-available → approval-requested →\n *  output-available | output-error | output-denied`\n *\n * It lives in the kernel, not in a renderer, for the reason C22 names: this is\n * exactly the logic four repositories re-derived four different ways. A tool\n * card that shows \"running\" after the run failed, or that re-opens a settled\n * call because a late duplicate frame arrived, is the class this file closes.\n *\n * The machine is MONOTONIC: the three output states are terminal, and a\n * transition that would move backwards is REFUSED and reported — never applied\n * silently (Law 4).\n */\n\nimport type { ChatMessage, ChatToolPart, ChatToolState } from \"./model\";\n\n/** Rank: a transition is legal only when it strictly increases, or is a\n *  same-state refresh of a non-terminal state (progress beats). */\nconst RANK: Record<ChatToolState, number> = {\n  \"input-streaming\": 0,\n  \"input-available\": 1,\n  \"approval-requested\": 2,\n  \"output-available\": 3,\n  \"output-error\": 3,\n  \"output-denied\": 3,\n};\n\nconst TERMINAL: ReadonlySet<ChatToolState> = new Set<ChatToolState>([\n  \"output-available\",\n  \"output-error\",\n  \"output-denied\",\n]);\n\nexport function isTerminalToolState(state: ChatToolState): boolean {\n  return TERMINAL.has(state);\n}\n\nexport interface ToolStateTransition {\n  /** The state to store. Equal to `from` when the transition was refused. */\n  readonly state: ChatToolState;\n  readonly applied: boolean;\n  /** Present only when `applied` is false — say WHY, out loud. */\n  readonly refusal: string | null;\n}\n\n/**\n * Advance a tool part. Returns the state to keep plus, when the move was\n * refused, a sentence a diagnostic sink can print verbatim.\n */\nexport function advanceToolState(\n  from: ChatToolState,\n  to: ChatToolState,\n): ToolStateTransition {\n  if (from === to) {\n    if (TERMINAL.has(from)) {\n      return {\n        state: from,\n        applied: false,\n        refusal: `tool state '${from}' is terminal and was re-announced; the duplicate frame was ignored`,\n      };\n    }\n    return { state: to, applied: true, refusal: null };\n  }\n  if (TERMINAL.has(from)) {\n    return {\n      state: from,\n      applied: false,\n      refusal: `tool state '${from}' is terminal; refusing to move it to '${to}'`,\n    };\n  }\n  const fromRank = RANK[from];\n  const toRank = RANK[to];\n  if (toRank < fromRank) {\n    return {\n      state: from,\n      applied: false,\n      refusal: `refusing to move a tool call backwards from '${from}' to '${to}'`,\n    };\n  }\n  return { state: to, applied: true, refusal: null };\n}\n\n/**\n * Map ONE aidream tool lifecycle name onto the machine.\n *\n * Server truth, read off the live corpus and\n * `@ai-matrx/agents/projection/request`: the wire emits `tool_started`,\n * `tool_progress`, `tool_step`, `tool_result_preview`, `tool_completed`,\n * `tool_error`, `tool_delegated` — either as a top-level `event` or nested in\n * a `tool_event` frame's `data.event`.\n *\n * `null` means \"this frame carries no state change\" (a progress beat), which\n * is different from an unknown name — an unknown name is returned as\n * `\"unknown\"` so the caller can report it instead of dropping it.\n */\nexport function toolLifecycleToState(\n  lifecycle: string,\n): ChatToolState | null | \"unknown\" {\n  switch (lifecycle) {\n    case \"tool_started\":\n      return \"input-available\";\n    case \"tool_progress\":\n    case \"tool_step\":\n    case \"tool_result_preview\":\n      return null;\n    case \"tool_delegated\":\n      // The server handed the call to the CLIENT: the input is final and\n      // nothing has run yet. It is NOT an approval request (the human is not\n      // being asked) and it is NOT an output.\n      return \"input-available\";\n    case \"tool_approval_requested\":\n      return \"approval-requested\";\n    case \"tool_completed\":\n      return \"output-available\";\n    case \"tool_error\":\n      return \"output-error\";\n    case \"tool_denied\":\n      return \"output-denied\";\n    default:\n      return \"unknown\";\n  }\n}\n\n/** Every lifecycle name this machine understands — the guard's census. */\nexport const KNOWN_TOOL_LIFECYCLES: readonly string[] = [\n  \"tool_started\",\n  \"tool_progress\",\n  \"tool_step\",\n  \"tool_result_preview\",\n  \"tool_delegated\",\n  \"tool_approval_requested\",\n  \"tool_completed\",\n  \"tool_error\",\n  \"tool_denied\",\n];\n\n\n/**\n * THE CLIENT'S OWN ANSWER.\n *\n * When the CLIENT answers a delegated tool (`tool_delegated` → the host runs it\n * → posts the result) the server learns the call is done from that post — but\n * for a delegated call it sends NO completion frame, because it hard-suspended\n * and closed the stream. A store that only moves on frames therefore leaves the\n * card on `input-available` (\"Working…\") for as long as the conversation stays\n * open. This is the defect all four hand-built chats had (found 2026-09-30 in\n * matrx-frontend, matrx-extend and matrx-local): the answerer is the first to\n * know, so it tells ITS OWN store, through this one door, in the same tick.\n */\nexport interface ChatToolAnswer {\n  toolCallId: string;\n  /** The result, on success. */\n  output?: unknown;\n  /** Set when the tool failed — the card goes to `output-error`. */\n  errorText?: string | null;\n  /** Set when the reader refused it — the card goes to `output-denied`. */\n  denied?: boolean;\n}\n\nexport interface ChatToolSettlement {\n  /** The transcript to keep — the SAME array when nothing changed. */\n  readonly messages: readonly ChatMessage[];\n  /** The message whose part changed, for the per-message wake. */\n  readonly messageId: string | null;\n  readonly applied: boolean;\n  /** Present when `applied` is false — say WHY, out loud. */\n  readonly refusal: string | null;\n}\n\n/** Pure: apply a client answer to the transcript, monotonically. */\nexport function settleToolAnswer(\n  messages: readonly ChatMessage[],\n  answer: ChatToolAnswer,\n): ChatToolSettlement {\n  for (let m = messages.length - 1; m >= 0; m -= 1) {\n    const message = messages[m];\n    if (!message) continue;\n    const index = message.parts.findIndex(\n      (part) => part.type === \"tool\" && part.toolCallId === answer.toolCallId,\n    );\n    if (index === -1) continue;\n    const part = message.parts[index] as ChatToolPart;\n    const next: ChatToolState = answer.denied\n      ? \"output-denied\"\n      : answer.errorText != null\n        ? \"output-error\"\n        : \"output-available\";\n    const transition = advanceToolState(part.state, next);\n    if (!transition.applied) {\n      return {\n        messages,\n        messageId: message.id,\n        applied: false,\n        refusal: transition.refusal,\n      };\n    }\n    const settled: ChatToolPart = {\n      ...part,\n      state: transition.state,\n      output: answer.output !== undefined ? answer.output : part.output,\n      errorText: next === \"output-error\" ? (answer.errorText ?? null) : null,\n    };\n    const parts = message.parts.slice();\n    parts[index] = settled;\n    const copy = messages.slice();\n    copy[m] = { ...message, parts };\n    return { messages: copy, messageId: message.id, applied: true, refusal: null };\n  }\n  return {\n    messages,\n    messageId: null,\n    applied: false,\n    refusal: `no tool call ${answer.toolCallId} is in this transcript, so there was nothing to settle`,\n  };\n}\n","/**\n * THE REDUCER — one live stream frame becomes message parts.\n *\n * Every branch below exists because the LIVE corpus in `fixtures/corpus/`\n * contains that frame. Nothing here was guessed from a client: the wire\n * vocabulary was read off bytes recorded from `server.app.matrxserver.com` on\n * 2026-09-17 and cross-checked against\n * `@ai-matrx/agents/projection/request`.\n *\n * The projector is deliberately MUTABLE. A streaming turn applies one frame\n * per token; rebuilding an immutable tree per token is the classic reason a\n * chat janks at 2,000 tokens. Immutability is provided where React needs it —\n * `snapshot()` hands back a fresh `ChatMessage` with a fresh `parts` array —\n * and the store coalesces those snapshots per animation frame.\n */\n\nimport {\n  advanceToolState,\n  toolLifecycleToState,\n} from \"./tool-state\";\nimport type { ChatFeatures } from \"./config\";\nimport {\n  createChatMessage,\n  type ChatErrorPart,\n  type ChatMessage,\n  type ChatNoticePart,\n  type ChatPart,\n  type ChatRenderBlockPart,\n  type ChatReasoningPart,\n  type ChatTextPart,\n  type ChatToolPart,\n} from \"./model\";\nimport type { ChatStreamFrame } from \"./ports\";\n\n/** The reasoning sentinel the Google path wraps thinking text in. */\nexport const REASONING_OPEN = \"<reasoning>\";\nexport const REASONING_CLOSE = \"</reasoning>\";\n\nexport type ChatTurnOutcome =\n  | \"streaming\"\n  | \"awaiting-tools\"\n  | \"complete\"\n  | \"error\"\n  | \"cancelled\";\n\nexport interface ChatTurnRefusal {\n  code: string;\n  message: string;\n  detail?: unknown;\n}\n\nexport interface ChatTurnProjectorOptions {\n  features: ChatFeatures;\n  /** The message id for the assistant turn (kept stable across the stream). */\n  messageId?: string | undefined;\n  /** Every refusal / unknown frame — reported, never dropped (Law 4). */\n  onRefusal?: ((refusal: ChatTurnRefusal) => void) | undefined;\n}\n\nexport interface ChatTurnProjector {\n  apply(frame: ChatStreamFrame): void;\n  /** A fresh, structurally-shared assistant message. */\n  snapshot(): ChatMessage;\n  readonly state: ChatTurnState;\n}\n\nexport interface ChatTurnState {\n  outcome: ChatTurnOutcome;\n  conversationId: string | null;\n  requestId: string | null;\n  phase: string | null;\n  /** The `chat.message` row ids the server reserved, by role. */\n  serverMessageIds: { user: string | null; assistant: string | null };\n  completion: Record<string, unknown> | null;\n  error: ChatErrorPart | null;\n  /** Bumps on every applied frame — the store's cheap dirty check. */\n  revision: number;\n  lastTransportSeq: number;\n  transportStreamId: string | null;\n  /** Frames the projector did not understand; never silently zero. */\n  unknownEvents: string[];\n}\n\nconst asRecord = (value: unknown): Record<string, unknown> =>\n  value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n\nconst asString = (value: unknown): string | null =>\n  typeof value === \"string\" ? value : null;\n\nconst asNumber = (value: unknown): number | null =>\n  typeof value === \"number\" && Number.isFinite(value) ? value : null;\n\n/** Events the projector deliberately ignores — real frames with no part. */\nconst IGNORED_EVENTS: ReadonlySet<string> = new Set([\n  \"heartbeat\",\n  \"context_state\",\n  \"context_trimmed\",\n  \"record_update\",\n  \"ping\",\n  \"debug\",\n  // `init`/`completion` pairs exist for five operations; only the\n  // `user_request` completion is terminal, and `init` carries no part.\n  \"init\",\n]);\n\nexport function createChatTurnProjector(\n  options: ChatTurnProjectorOptions,\n): ChatTurnProjector {\n  const features = options.features;\n  const messageId = options.messageId ?? createChatMessage({ role: \"assistant\" }).id;\n  const parts: ChatPart[] = [];\n  const toolsByCallId = new Map<string, ChatToolPart>();\n  const blocksById = new Map<string, ChatRenderBlockPart>();\n\n  /** True between `reasoning {started}` and `reasoning {stopped}`. */\n  let reasoningActive = false;\n  /** True while inside an unterminated `<reasoning>` span in chunk text. */\n  let insideSentinel = false;\n\n  const state: ChatTurnState = {\n    outcome: \"streaming\",\n    conversationId: null,\n    requestId: null,\n    phase: null,\n    serverMessageIds: { user: null, assistant: null },\n    completion: null,\n    error: null,\n    revision: 0,\n    lastTransportSeq: 0,\n    transportStreamId: null,\n    unknownEvents: [],\n  };\n\n  const refuse = (refusal: ChatTurnRefusal): void => {\n    options.onRefusal?.(refusal);\n  };\n\n  const lastPart = (): ChatPart | undefined => parts[parts.length - 1];\n\n  const appendText = (text: string): void => {\n    const tail = lastPart();\n    if (tail && tail.type === \"text\") {\n      tail.text += text;\n      return;\n    }\n    const part: ChatTextPart = { type: \"text\", text };\n    parts.push(part);\n  };\n\n  const appendReasoning = (text: string): void => {\n    const tail = lastPart();\n    if (tail && tail.type === \"reasoning\" && tail.state === \"streaming\") {\n      tail.text += text;\n      return;\n    }\n    const part: ChatReasoningPart = { type: \"reasoning\", text, state: \"streaming\" };\n    parts.push(part);\n  };\n\n  const closeReasoning = (): void => {\n    for (let i = parts.length - 1; i >= 0; i -= 1) {\n      const part = parts[i];\n      if (part && part.type === \"reasoning\" && part.state === \"streaming\") {\n        part.state = \"done\";\n        return;\n      }\n    }\n  };\n\n  /**\n   * Route ONE chunk of answer text.\n   *\n   * With `reasoningSentinel: \"inline\"` the text goes straight to the answer,\n   * byte-for-byte identical to the shipped projection's `answer`. With\n   * `\"split\"` (the platform default) the `<reasoning>…</reasoning>` span\n   * becomes a reasoning part, so a reader never sees the raw sentinel.\n   */\n  const routeChunk = (text: string): void => {\n    if (features.reasoningSentinel === \"inline\") {\n      appendText(text);\n      return;\n    }\n    let rest = text;\n    while (rest.length > 0) {\n      if (insideSentinel) {\n        const close = rest.indexOf(REASONING_CLOSE);\n        if (close === -1) {\n          appendReasoning(rest);\n          return;\n        }\n        appendReasoning(rest.slice(0, close));\n        closeReasoning();\n        insideSentinel = false;\n        rest = rest.slice(close + REASONING_CLOSE.length);\n        continue;\n      }\n      const open = rest.indexOf(REASONING_OPEN);\n      if (open === -1) {\n        appendText(rest);\n        return;\n      }\n      if (open > 0) appendText(rest.slice(0, open));\n      insideSentinel = true;\n      rest = rest.slice(open + REASONING_OPEN.length);\n    }\n  };\n\n  const toolFor = (callId: string, toolName: string): ChatToolPart => {\n    const existing = toolsByCallId.get(callId);\n    if (existing) return existing;\n    const part: ChatToolPart = {\n      type: \"tool\",\n      toolCallId: callId,\n      toolName,\n      state: \"input-streaming\",\n      input: undefined,\n      output: undefined,\n      errorText: null,\n      progress: [],\n      delegated: false,\n    };\n    toolsByCallId.set(callId, part);\n    parts.push(part);\n    return part;\n  };\n\n  const applyToolLifecycle = (\n    lifecycle: string,\n    data: Record<string, unknown>,\n  ): void => {\n    const callId = asString(data.call_id);\n    const toolName = asString(data.tool_name);\n    if (callId === null || toolName === null) {\n      refuse({\n        code: \"tool_frame_without_identity\",\n        message: `a '${lifecycle}' frame arrived without call_id/tool_name and was ignored`,\n        detail: data,\n      });\n      return;\n    }\n    const part = toolFor(callId, toolName);\n    const payload = asRecord(data.data);\n    const message = asString(data.message) ?? \"\";\n\n    const next = toolLifecycleToState(lifecycle);\n    if (next === \"unknown\") {\n      state.unknownEvents.push(lifecycle);\n      refuse({\n        code: \"unknown_tool_lifecycle\",\n        message: `tool lifecycle '${lifecycle}' is not in this package's state machine; the frame was recorded but not applied`,\n        detail: data,\n      });\n      return;\n    }\n\n    if (lifecycle === \"tool_started\" && \"arguments\" in payload) {\n      part.input = payload.arguments;\n    }\n    if (lifecycle === \"tool_delegated\") {\n      part.delegated = true;\n      if (\"arguments\" in payload) part.input = payload.arguments;\n    }\n    if (lifecycle === \"tool_completed\" && \"result\" in payload) {\n      part.output = payload.result;\n    }\n    if (lifecycle === \"tool_error\") {\n      part.errorText =\n        asString(payload.error) ?? (message || `The ${toolName} tool failed.`);\n    }\n\n    if (next === null) {\n      part.progress.push({\n        toolName,\n        message,\n        percent: asNumber(payload.percent),\n        at: asNumber(data.timestamp),\n      });\n      return;\n    }\n\n    const transition = advanceToolState(part.state, next);\n    if (!transition.applied) {\n      refuse({\n        code: \"tool_state_transition_refused\",\n        message: `${transition.refusal ?? \"refused\"} (call ${callId}, tool ${toolName})`,\n        detail: data,\n      });\n      return;\n    }\n    part.state = transition.state;\n    if (next === \"input-available\" && part.delegated) {\n      state.outcome = \"awaiting-tools\";\n    } else if (\n      state.outcome === \"awaiting-tools\" &&\n      (next === \"output-available\" || next === \"output-error\")\n    ) {\n      state.outcome = \"streaming\";\n    }\n  };\n\n  const pushNotice = (\n    level: ChatNoticePart[\"level\"],\n    data: Record<string, unknown>,\n  ): void => {\n    const userMessage = asString(data.user_message) ?? \"\";\n    if (!userMessage) return;\n    const part: ChatNoticePart = {\n      type: \"notice\",\n      level,\n      code: asString(data.code),\n      userMessage,\n      remedy: asString(asRecord(data.metadata).remedy),\n    };\n    parts.push(part);\n  };\n\n  const apply = (frame: ChatStreamFrame): void => {\n    const streamSeq = asNumber(frame.stream_seq);\n    const streamId = asString(frame.stream_id);\n    const sameSegment = streamId === null || streamId === state.transportStreamId;\n    if (sameSegment && streamSeq !== null && streamSeq <= state.lastTransportSeq) {\n      // A replayed frame after a reconnect. Dropping it is the whole point of\n      // the sequence: applying it doubles text.\n      return;\n    }\n    state.lastTransportSeq =\n      streamSeq === null\n        ? state.lastTransportSeq\n        : sameSegment\n          ? Math.max(state.lastTransportSeq, streamSeq)\n          : streamSeq;\n    if (streamId !== null) state.transportStreamId = streamId;\n    state.revision += 1;\n\n    const data = asRecord(frame.data);\n\n    switch (frame.event) {\n      case \"chunk\": {\n        const text = asString(data.text);\n        if (text !== null) routeChunk(text);\n        return;\n      }\n      case \"reasoning_chunk\": {\n        const text = asString(data.text);\n        if (text !== null) {\n          reasoningActive = true;\n          appendReasoning(text);\n        }\n        return;\n      }\n      case \"reasoning\": {\n        const started = data.state === \"started\";\n        reasoningActive = started;\n        if (!started) closeReasoning();\n        return;\n      }\n      case \"phase\": {\n        const phase = asString(data.phase);\n        if (phase !== null) state.phase = phase;\n        return;\n      }\n      case \"data\": {\n        if (data.type === \"conversation_id\") {\n          const conversationId = asString(data.conversation_id);\n          if (conversationId !== null) state.conversationId = conversationId;\n        }\n        return;\n      }\n      case \"record_reserved\": {\n        // The server names the `chat.message` rows it reserved and, in\n        // `metadata.role`, which side each one is. This is how an optimistic\n        // user bubble learns its durable row id without a re-read.\n        if (asString(data.table) !== \"message\") return;\n        const recordId = asString(data.record_id);\n        const role = asString(asRecord(data.metadata).role);\n        if (recordId === null) return;\n        if (role === \"user\") state.serverMessageIds.user = recordId;\n        else if (role === \"assistant\") state.serverMessageIds.assistant = recordId;\n        return;\n      }\n      case \"tool_event\": {\n        const lifecycle = asString(data.event);\n        if (lifecycle === null) {\n          refuse({\n            code: \"tool_event_without_lifecycle\",\n            message: \"a tool_event frame carried no data.event and was ignored\",\n            detail: data,\n          });\n          return;\n        }\n        applyToolLifecycle(lifecycle, data);\n        return;\n      }\n      case \"tool_started\":\n      case \"tool_progress\":\n      case \"tool_step\":\n      case \"tool_result_preview\":\n      case \"tool_completed\":\n      case \"tool_error\":\n      case \"tool_delegated\": {\n        applyToolLifecycle(frame.event, data);\n        return;\n      }\n      case \"render_block\": {\n        const blockId = asString(data.blockId);\n        const blockIndex = asNumber(data.blockIndex);\n        const kind = asString(data.type);\n        if (blockId === null || blockIndex === null || kind === null) {\n          refuse({\n            code: \"render_block_without_identity\",\n            message: \"a render_block frame lacked blockId/blockIndex/type and was ignored\",\n            detail: data,\n          });\n          return;\n        }\n        const status =\n          data.status === \"complete\" || data.status === \"error\"\n            ? (data.status as \"complete\" | \"error\")\n            : \"streaming\";\n        const existing = blocksById.get(blockId);\n        if (existing) {\n          existing.status = status;\n          existing.content = asString(data.content);\n          existing.data = data.data;\n          return;\n        }\n        const part: ChatRenderBlockPart = {\n          type: \"render-block\",\n          blockId,\n          blockIndex,\n          kind,\n          content: asString(data.content),\n          data: data.data,\n          status,\n        };\n        blocksById.set(blockId, part);\n        parts.push(part);\n        return;\n      }\n      case \"warning\": {\n        const level = asString(data.level);\n        pushNotice(\n          level === \"high\" || level === \"medium\" || level === \"low\" ? level : \"low\",\n          data,\n        );\n        return;\n      }\n      case \"info\": {\n        // `initial_message` is chrome (\"Initializing Matrx Chat…\"), not news.\n        if (asString(data.code) === \"initial_message\") return;\n        pushNotice(\"info\", data);\n        return;\n      }\n      case \"error\": {\n        const message =\n          asString(data.message) ?? asString(data.user_message) ?? \"The run failed.\";\n        const part: ChatErrorPart = {\n          type: \"error\",\n          errorType: asString(data.error_type),\n          code: asString(data.code),\n          message,\n          userMessage: asString(data.user_message) ?? message,\n          recoverable: data.recoverable === true,\n          remedy: asString(asRecord(data.details).remedy),\n        };\n        parts.push(part);\n        state.error = part;\n        state.outcome = \"error\";\n        return;\n      }\n      case \"completion\": {\n        if (asString(data.operation) !== \"user_request\") return;\n        state.completion = data;\n        const status = asString(data.status);\n        if (status === \"failed\") {\n          state.outcome = \"error\";\n          if (state.error === null) {\n            const result = asRecord(data.result);\n            const message =\n              asString(result.error) ??\n              asString(result.user_message) ??\n              \"The run failed.\";\n            const part: ChatErrorPart = {\n              type: \"error\",\n              errorType: \"run_failed\",\n              code: null,\n              message,\n              userMessage: message,\n              recoverable: true,\n              remedy: null,\n            };\n            parts.push(part);\n            state.error = part;\n          }\n        } else if (status === \"cancelled\") {\n          state.outcome = \"cancelled\";\n        } else if (state.outcome !== \"error\") {\n          state.outcome = \"complete\";\n        }\n        return;\n      }\n      case \"end\": {\n        if (state.outcome === \"streaming\" || state.outcome === \"awaiting-tools\") {\n          state.outcome = \"complete\";\n        }\n        if (insideSentinel || reasoningActive) {\n          closeReasoning();\n          insideSentinel = false;\n          reasoningActive = false;\n        }\n        return;\n      }\n      default: {\n        if (IGNORED_EVENTS.has(frame.event)) return;\n        state.unknownEvents.push(frame.event);\n        refuse({\n          code: \"unknown_stream_event\",\n          message: `stream event '${frame.event}' is not in this package's vocabulary; it was recorded, not dropped`,\n          detail: frame.data,\n        });\n      }\n    }\n  };\n\n  const snapshot = (): ChatMessage => {\n    const status =\n      state.outcome === \"error\"\n        ? \"error\"\n        : state.outcome === \"cancelled\"\n          ? \"cancelled\"\n          : state.outcome === \"complete\"\n            ? \"complete\"\n            : \"streaming\";\n    const completion = state.completion;\n    return {\n      id: messageId,\n      role: \"assistant\",\n      // Fresh array + fresh part objects: React compares by identity, and a\n      // mutated-in-place part never re-renders.\n      parts: parts.map((part) => ({ ...part }) as ChatPart),\n      status,\n      metadata: {\n        requestId: state.requestId,\n        serverMessageId: state.serverMessageIds.assistant,\n        modelRef: completion ? extractModelRef(completion) : null,\n        createdAt: new Date(0).toISOString(),\n        raw: completion,\n      },\n    };\n  };\n\n  return {\n    apply,\n    snapshot,\n    get state() {\n      return state;\n    },\n  };\n}\n\n/**\n * The model the server actually billed, from the completion's usage block\n * (`result.total_usage.by_model` — one key per model that ran). Returns null\n * rather than a UUID or a guess: a screen never prints an id, and \"unknown\" is\n * the honest answer when the completion carried no usage.\n */\nexport function extractModelRef(\n  completion: Record<string, unknown>,\n): string | null {\n  const result = asRecord(completion.result);\n  const usage = asRecord(result.total_usage);\n  const byModel = asRecord(usage.by_model);\n  const names = Object.keys(byModel);\n  return names.length > 0 ? (names[names.length - 1] ?? null) : null;\n}\n","/**\n * OPINIONS BECOME KNOBS (Law 6) — resolved in the kernel, never hardcoded and\n * never a question for a customer.\n *\n * Four layers, lowest to highest: **platform default → organization setting →\n * surface config → per-user preference**. Every knob has a platform default,\n * so a host that sets nothing still gets the platform's taste.\n *\n * One of these knobs is a SAFETY RULE and it lives here on purpose (C22):\n * `routing` carries matrx-local's \"a confidential thread never reaches a cloud\n * provider\". In the kernel it is a thread-level constraint the store ENFORCES\n * with a refusal — it never silently falls back to a cloud target.\n */\n\nexport type ChatSendKey = \"enter\" | \"mod-enter\";\nexport type ChatDensity = \"comfortable\" | \"compact\";\n\n/**\n * Where a thread's text is allowed to go.\n * - `\"any\"` — the platform default: any target the host offers.\n * - `\"local-only\"` — CONFIDENTIAL. The thread refuses a cloud target and says\n *   why. This is the highest-severity rule in the design (§12 risk 4).\n */\nexport type ChatRoutingPolicy = \"any\" | \"local-only\";\n\n/** What a transport declares about itself so the kernel can judge it. */\nexport type ChatTargetLocality = \"local\" | \"cloud\";\n\nexport interface ChatFeatures {\n  /** Enter sends, or Cmd/Ctrl+Enter sends. */\n  sendKey: ChatSendKey;\n  density: ChatDensity;\n  /** Reasoning parts visible without a click. */\n  showReasoningByDefault: boolean;\n  /** Tool cards start expanded. */\n  expandToolCardsByDefault: boolean;\n  /** Transcript sticks to the bottom while the reader is at the bottom. */\n  autoScroll: boolean;\n  /** Read new assistant turns aloud as they arrive. */\n  readAloudAutoPlay: boolean;\n  /** Keep an unsent composer draft per conversation across reloads. */\n  retainDrafts: boolean;\n  /**\n   * The composer may send while an answer is still arriving. OFF by the\n   * platform default (a kernel thread runs one turn at a time). A host whose\n   * send QUEUES the message behind the live turn — a coding session, where\n   * the engine holds a per-session queue — turns it on; the composer then\n   * shows Send (queue) beside Stop instead of Stop alone.\n   */\n  sendWhileBusy: boolean;\n  /** THE ARCHIVED-ITEMS LAW: the conversation list hides archived by default. */\n  hideArchivedConversations: boolean;\n  /**\n   * The per-turn action bar (copy, ask again, edit and send again, plus the\n   * host's own). ON by the platform default — every serious chat has one, and\n   * a reader who cannot copy an answer retypes it. An organization that does\n   * not want it turns it OFF here rather than a host forking the transcript.\n   */\n  messageActions: boolean;\n  /** Largest attachment the composer accepts, in BYTES. */\n  attachmentMaxBytes: number;\n  /**\n   * How the platform's inline reasoning sentinel is treated.\n   *\n   * Ground truth (captured live 2026-09-17): the Google path does NOT emit\n   * `reasoning_chunk`. It emits `reasoning {state:\"started\"}`, then ordinary\n   * `chunk` frames whose text opens with `<reasoning>` and closes with\n   * `</reasoning>`, then `reasoning {state:\"stopped\"}`.\n   *\n   * - `\"split\"` (platform default) — that span becomes a `reasoning` part, so\n   *   a reader never sees the raw sentinel in the answer.\n   * - `\"inline\"` — the span stays in the answer text, byte-for-byte identical\n   *   to `@ai-matrx/agents/projection/request`'s `answer`. This exists so the\n   *   parity harness can prove EXACT equality with the shipped projection, and\n   *   so a host mid-migration can keep its current screen.\n   */\n  reasoningSentinel: \"split\" | \"inline\";\n  /** Where this thread's text may go. */\n  routing: ChatRoutingPolicy;\n}\n\nexport const CHAT_PLATFORM_DEFAULTS: Readonly<ChatFeatures> = Object.freeze({\n  sendKey: \"enter\",\n  density: \"comfortable\",\n  showReasoningByDefault: false,\n  expandToolCardsByDefault: false,\n  autoScroll: true,\n  readAloudAutoPlay: false,\n  retainDrafts: true,\n  sendWhileBusy: false,\n  hideArchivedConversations: true,\n  messageActions: true,\n  attachmentMaxBytes: 25 * 1024 * 1024,\n  reasoningSentinel: \"split\",\n  routing: \"any\",\n});\n\nexport interface ChatConfigLayers {\n  /** Organization setting rows, resolved by the host. */\n  organization?: Partial<ChatFeatures>;\n  /** This surface's configuration (a dock is not the full page). */\n  surface?: Partial<ChatFeatures>;\n  /** This person's preference. */\n  user?: Partial<ChatFeatures>;\n}\n\n/** Resolve the four layers. Later layers win, key by key. */\nexport function resolveChatFeatures(layers: ChatConfigLayers = {}): ChatFeatures {\n  return {\n    ...CHAT_PLATFORM_DEFAULTS,\n    ...stripUndefined(layers.organization),\n    ...stripUndefined(layers.surface),\n    ...stripUndefined(layers.user),\n  };\n}\n\nfunction stripUndefined(\n  value: Partial<ChatFeatures> | undefined,\n): Partial<ChatFeatures> {\n  if (!value) return {};\n  const out: Record<string, unknown> = {};\n  for (const [key, entry] of Object.entries(value)) {\n    if (entry !== undefined) out[key] = entry;\n  }\n  return out as Partial<ChatFeatures>;\n}\n\n/** The refusal a confidential thread produces instead of a silent fallback. */\nexport interface ChatRoutingRefusal {\n  readonly allowed: false;\n  readonly code: \"confidential_thread_cloud_target_refused\";\n  readonly userMessage: string;\n  readonly remedy: string;\n}\n\nexport type ChatRoutingDecision = { readonly allowed: true } | ChatRoutingRefusal;\n\n/**\n * THE CONFIDENTIAL-ROUTING RULE, in the kernel where it belongs.\n *\n * A thread pinned `local-only` REFUSES a cloud target. It does not downgrade,\n * it does not warn-and-send, and it does not quietly pick a different target:\n * the send fails with a named reason and a remedy. Re-deriving this per host\n * is how private text reaches a provider.\n */\nexport function decideRouting(\n  policy: ChatRoutingPolicy,\n  target: ChatTargetLocality,\n): ChatRoutingDecision {\n  if (policy === \"local-only\" && target === \"cloud\") {\n    return {\n      allowed: false,\n      code: \"confidential_thread_cloud_target_refused\",\n      userMessage:\n        \"This conversation is marked confidential, so it cannot be sent to a cloud AI provider.\",\n      remedy:\n        \"Choose a local engine for this conversation, or start a new conversation that is not marked confidential.\",\n    };\n  }\n  return { allowed: true };\n}\n","/**\n * HOST INJECTION SEAMS — the ports a host may override.\n *\n * Per THE ALL-INCLUSIVE LAW every port here either ships a working default in\n * this package (`./matrx`, or the in-file defaults below) or is genuinely host\n * identity. A host injects identity and nothing else to be up and running.\n *\n * Phase 1 declares the ports the KERNEL uses. `files`, `nav`, `shell`,\n * `renderContent`, `renderModelRef` and `capabilities` are phase 2's — they\n * are deliberately ABSENT here rather than declared-and-unused, because a port\n * nothing calls is untested theory that rots (C25's reasoning).\n */\n\nimport type { ChatMessage, ChatRole } from \"./model\";\nimport type { ChatTargetLocality } from \"./config\";\n\n/** The ONE true injection. Read from the client's own session, never a cached copy. */\nexport interface ChatIdentityPort {\n  /** A fresh access token per call. Cached copies rot when the cookie rotates. */\n  getAccessToken(): Promise<string | null> | string | null;\n  userId: string;\n  organizationId?: string | undefined;\n}\n\n/** One frame off the wire, already normalized by `@ai-matrx/agents/stream/ndjson`. */\nexport interface ChatStreamFrame {\n  event: string;\n  data: unknown;\n  stream_id?: string | undefined;\n  stream_seq?: number | undefined;\n}\n\n/** What a started turn hands back before any frame arrives. */\nexport interface ChatTurnHandle {\n  /** The server's `X-Request-ID` — the ONLY id cancel accepts. */\n  requestId: string | null;\n  conversationId: string | null;\n  frames: AsyncIterable<ChatStreamFrame>;\n}\n\nexport interface ChatSendRequest {\n  conversationId: string | null;\n  /** True when this turn creates the conversation. */\n  isNewConversation: boolean;\n  /** False for an ephemeral run: nothing read, nothing written. */\n  store: boolean;\n  text: string;\n  /** Durable Matrx file ids attached to this turn. */\n  fileIds: readonly string[];\n  signal: AbortSignal;\n}\n\n/**\n * THE TRANSPORT PORT — subscribe-shaped, NOT a fetch.\n *\n * It is this shape because matrx-extend's MV3 stream lives in an offscreen\n * document and is relayed over `chrome.runtime`: an API that has only ever met\n * `fetch` ossifies wrong. A host that does use fetch implements this in a few\n * lines (`./matrx` is that implementation).\n */\nexport interface ChatTransportPort {\n  /** Where this transport sends text. The kernel refuses `\"cloud\"` for a\n   *  confidential thread — so a transport that lies here defeats the rule, and\n   *  it is the transport author's obligation to be honest. */\n  readonly locality: ChatTargetLocality;\n  start(request: ChatSendRequest): Promise<ChatTurnHandle>;\n  /** Cooperative stop at the next iteration boundary. */\n  cancel(requestId: string): Promise<void>;\n}\n\n/** A conversation as the history list shows it. */\nexport interface ChatConversationSummary {\n  id: string;\n  title: string | null;\n  updatedAt: string;\n  createdAt: string;\n  messageCount: number;\n  archived: boolean;\n  isFavorite: boolean;\n  /** Which surface produced it — the history list's source filter. */\n  sourceApp: string | null;\n  sourceFeature: string | null;\n}\n\nexport interface ChatConversationListQuery {\n  limit?: number | undefined;\n  /** Keyset cursor: return rows older than this ISO timestamp. */\n  before?: string | undefined;\n  /**\n   * THE ARCHIVED-ITEMS LAW. Default false — archived rows are hidden, and the\n   * caller that shows the list must name what it hides.\n   */\n  includeArchived?: boolean | undefined;\n  sourceApp?: string | undefined;\n  sourceFeature?: string | undefined;\n  /**\n   * The page's own organization filter (`?org_filter=`). Absent/null = ALL the\n   * person's organizations, the default on every visit — never the active\n   * organization (active-org-is-never-a-list-filter.md).\n   */\n  organizationFilter?: string | null | undefined;\n}\n\nexport interface ChatConversationListPage {\n  conversations: ChatConversationSummary[];\n  /** How many rows the archive filter hid, so the footer can say so. */\n  archivedHidden: number;\n  /** Cursor for the next page, or null at the end. */\n  nextBefore: string | null;\n}\n\n/**\n * THE PERSISTENCE BOUNDARY (C10). The `chat.*` schema belongs to aidream, so\n * this package does not OWN it — but `./matrx` ships the complete binding, so\n * a host gets working persistence for free and only a customer on their own\n * tables ever implements this.\n *\n * With no binding the thread runs ephemeral AND SAYS SO on screen\n * (`ChatThreadSnapshot.ephemeral` + `ephemeralReason`).\n */\nexport interface ChatPersistencePort {\n  /** Full transcript of one conversation, oldest first. */\n  loadThread(conversationId: string): Promise<ChatMessage[]>;\n  listConversations(\n    query: ChatConversationListQuery,\n  ): Promise<ChatConversationListPage>;\n  setArchived(conversationId: string, archived: boolean): Promise<void>;\n  rename(conversationId: string, title: string): Promise<void>;\n}\n\n/** Typed diagnostic sink. Default: `console`. */\nexport interface ChatErrorSinkPort {\n  capture(event: {\n    code: string;\n    message: string;\n    detail?: unknown;\n  }): void;\n}\n\n/** Toast / banner sink. Default: a no-op that still reaches the errorSink. */\nexport interface ChatNotifierPort {\n  notify(event: {\n    level: \"info\" | \"warning\" | \"error\";\n    message: string;\n    remedy?: string | undefined;\n  }): void;\n}\n\n/** Drafts, density, sidebar state. Default: in-memory, announced once. */\nexport interface ChatPrefsPort {\n  get(key: string): string | null;\n  set(key: string, value: string): void;\n  remove(key: string): void;\n}\n\nexport function createConsoleErrorSink(): ChatErrorSinkPort {\n  return {\n    capture(event) {\n      console.error(`[ai-matrx/chat] ${event.code}: ${event.message}`, event.detail);\n    },\n  };\n}\n\n/**\n * The default notifier. It never swallows: everything it is handed also\n * reaches the console, with the remedy, because a notice nobody renders is a\n * silent failure.\n */\nexport function createConsoleNotifier(): ChatNotifierPort {\n  return {\n    notify(event) {\n      const line = event.remedy\n        ? `[ai-matrx/chat] ${event.message} — ${event.remedy}`\n        : `[ai-matrx/chat] ${event.message}`;\n      if (event.level === \"error\") console.error(line);\n      else if (event.level === \"warning\") console.warn(line);\n      else console.info(line);\n    },\n  };\n}\n\n/**\n * The memory prefs fallback. It ANNOUNCES ITSELF ONCE with the remedy the\n * first time it is written to, because a draft that silently evaporates on\n * reload is exactly the class Law 4 forbids.\n */\nexport function createMemoryPrefs(\n  notifier: ChatNotifierPort = createConsoleNotifier(),\n): ChatPrefsPort {\n  const map = new Map<string, string>();\n  let announced = false;\n  const announce = (): void => {\n    if (announced) return;\n    announced = true;\n    notifier.notify({\n      level: \"warning\",\n      message:\n        \"Chat preferences and drafts are being kept in memory only, so they will be lost when this page reloads.\",\n      remedy:\n        \"Give the chat a `prefs` port backed by localStorage (or your own store) to keep drafts across reloads.\",\n    });\n  };\n  return {\n    get: (key) => map.get(key) ?? null,\n    set: (key, value) => {\n      announce();\n      map.set(key, value);\n    },\n    remove: (key) => {\n      map.delete(key);\n    },\n  };\n}\n\n/**\n * `localStorage` prefs with the memory fallback. Every read AND write is\n * wrapped: a private window, blocked site data, or a full quota makes the\n * accessor THROW, and an unguarded prefs port takes the whole chat down with\n * it.\n */\nexport function createWebPrefs(\n  notifier: ChatNotifierPort = createConsoleNotifier(),\n): ChatPrefsPort {\n  const fallback = createMemoryPrefs(notifier);\n  let store: Storage | null = null;\n  try {\n    store = (globalThis as { localStorage?: Storage }).localStorage ?? null;\n    if (store) {\n      const probe = \"__ai_matrx_chat_probe__\";\n      store.setItem(probe, \"1\");\n      store.removeItem(probe);\n    }\n  } catch {\n    store = null;\n  }\n  if (!store) return fallback;\n  const live = store;\n  return {\n    get: (key) => {\n      // A write that fell back to memory (quota, or a storage that accepts the\n      // probe and rejects real writes) is INVISIBLE to `getItem` — it returns\n      // null rather than throwing, so a read that trusted it alone would hand\n      // back an empty draft and the reader would watch their message vanish.\n      try {\n        const stored = live.getItem(key);\n        if (stored !== null) return stored;\n      } catch {\n        /* fall through to the memory fallback */\n      }\n      return fallback.get(key);\n    },\n    set: (key, value) => {\n      try {\n        live.setItem(key, value);\n      } catch {\n        fallback.set(key, value);\n      }\n    },\n    remove: (key) => {\n      try {\n        live.removeItem(key);\n      } catch {\n        /* the durable copy may not exist; the memory copy still must go */\n      }\n      fallback.remove(key);\n    },\n  };\n}\n\n/** Roles the kernel renders. Anything else is reported, never dropped. */\nexport const CHAT_ROLES: readonly ChatRole[] = [\n  \"user\",\n  \"assistant\",\n  \"system\",\n  \"tool\",\n];\n","/**\n * THE THREAD STORE — layer 1 of `@ai-matrx/chat`.\n *\n * `getSnapshot()` / `subscribe()` is the `useSyncExternalStore` source shape\n * (the AI SDK's proven one), plus `subscribeToMessage(id)` so ONE streaming\n * bubble re-renders without touching the list. There is no React here, no\n * Redux here, and no `window` touched at import time.\n *\n * Performance rules that are code, not prose:\n *  1. store writes are COALESCED per frame tick, never per token;\n *  2. only the streaming message's per-message subscribers are woken on a\n *     token; the thread subscribers are woken on the same coalesced tick but\n *     the message objects of every OTHER message keep their identity, so a\n *     memoized list re-renders one row.\n */\n\nimport {\n  createChatTurnProjector,\n  type ChatTurnRefusal,\n} from \"./ingest\";\nimport {\n  decideRouting,\n  resolveChatFeatures,\n  type ChatConfigLayers,\n  type ChatFeatures,\n} from \"./config\";\nimport {\n  createChatMessage,\n  newLocalId,\n  type ChatErrorPart,\n  type ChatMessage,\n  type ChatThreadSnapshot,\n  type ChatThreadStatus,\n} from \"./model\";\nimport {\n  createConsoleErrorSink,\n  createConsoleNotifier,\n  type ChatErrorSinkPort,\n  type ChatNotifierPort,\n  type ChatPersistencePort,\n  type ChatTransportPort,\n} from \"./ports\";\nimport {\n  settleToolAnswer,\n  type ChatToolAnswer,\n  type ChatToolSettlement,\n} from \"./tool-state\";\n\nexport interface ChatThreadConfig {\n  transport: ChatTransportPort;\n  /** Absent ⇒ the thread is EPHEMERAL and says so in its snapshot. */\n  persistence?: ChatPersistencePort | undefined;\n  /** Existing conversation to continue. Omit to start a new one on first send. */\n  conversationId?: string | undefined;\n  features?: ChatConfigLayers | undefined;\n  errorSink?: ChatErrorSinkPort | undefined;\n  notifier?: ChatNotifierPort | undefined;\n  /**\n   * Coalescing window. The default `null` means \"schedule on the runtime's\n   * frame clock\" (`requestAnimationFrame` when there is one, a microtask\n   * otherwise). A number is a millisecond timer, which is what tests use so\n   * they never depend on a browser clock.\n   */\n  coalesceMs?: number | null | undefined;\n}\n\nexport interface ChatSendInput {\n  text: string;\n  fileIds?: readonly string[] | undefined;\n}\n\nexport interface ChatSendResult {\n  /** False when the send was refused BEFORE anything left the machine. */\n  accepted: boolean;\n  /** Present when `accepted` is false — the reason, in the reader's words. */\n  refusal: ChatErrorPart | null;\n}\n\nexport interface ChatThreadStore {\n  getSnapshot(): ChatThreadSnapshot;\n  subscribe(listener: () => void): () => void;\n  /** Wake ONLY on this message. The whole point of the per-message seam. */\n  subscribeToMessage(messageId: string, listener: () => void): () => void;\n  getMessageSnapshot(messageId: string): ChatMessage | undefined;\n  readonly features: ChatFeatures;\n  send(input: ChatSendInput): Promise<ChatSendResult>;\n  /** Cooperative stop. Resolves once the server acknowledged (or failed to). */\n  cancel(): Promise<void>;\n  /** Replace the transcript — used by history load and by tests. */\n  setMessages(messages: readonly ChatMessage[]): void;\n  /** Load a stored conversation through the persistence port. */\n  loadConversation(conversationId: string): Promise<void>;\n  /**\n   * Whether `startNewConversation()` actually does anything here. The kernel\n   * answers true; `/external-store` answers true only when the host gave it a\n   * handler. A shell reads THIS to decide whether a \"New conversation\" control\n   * exists at all — a New button that cannot start one is the dead control Law\n   * 4 forbids.\n   */\n  readonly canStartNewConversation: boolean;\n  /**\n   * Empty this thread and forget its conversation id, so the NEXT send starts a\n   * fresh conversation the server names.\n   *\n   * 🚨 WHY THIS IS ON THE KERNEL AND NOT THE HOST'S JOB. Until the lane merge\n   * the conversation id was fixed for the life of the store, so \"New\n   * conversation\" on the shipped `chat.conversation` source could only work if\n   * the host threw the whole thread away and built another — which every\n   * consumer would then have had to reimplement, including the timer, the abort\n   * and the draft carry. The client still never invents an id: this clears the\n   * id and lets the FIRST TURN mint it, which is exactly what the platform\n   * does for a conversation that never existed.\n   */\n  startNewConversation(): Promise<void>;\n  /**\n   * The client answered a delegated tool — mark the call done HERE, now.\n   *\n   * The server sends no completion frame for a delegated call (it hard-suspended\n   * and closed the stream), so a transcript that only moves on frames shows\n   * \"Working…\" forever after the agent has visibly moved on. The host's answer\n   * funnel calls this in the same tick it posts the result. Monotonic and\n   * idempotent: a call already terminal is left alone and the refusal says why.\n   */\n  settleToolCall(answer: ChatToolAnswer): ChatToolSettlement;\n  /** Release timers and abort an in-flight turn. */\n  dispose(): void;\n}\n\ntype Scheduler = (run: () => void) => () => void;\n\nfunction createScheduler(coalesceMs: number | null | undefined): Scheduler {\n  if (typeof coalesceMs === \"number\") {\n    return (run) => {\n      const handle = setTimeout(run, coalesceMs);\n      return () => clearTimeout(handle);\n    };\n  }\n  const raf = (\n    globalThis as {\n      requestAnimationFrame?: (cb: () => void) => number;\n      cancelAnimationFrame?: (handle: number) => void;\n    }\n  ).requestAnimationFrame;\n  if (typeof raf === \"function\") {\n    const cancel = (globalThis as { cancelAnimationFrame?: (h: number) => void })\n      .cancelAnimationFrame;\n    return (run) => {\n      const handle = raf(run);\n      return () => cancel?.(handle);\n    };\n  }\n  return (run) => {\n    let cancelled = false;\n    queueMicrotask(() => {\n      if (!cancelled) run();\n    });\n    return () => {\n      cancelled = true;\n    };\n  };\n}\n\nconst EPHEMERAL_REASON =\n  \"This conversation is not being saved: no persistence is connected, so it disappears when you leave the page.\";\nconst EPHEMERAL_REMEDY =\n  \"Pass a `persistence` port (createMatrxChatPersistence from @ai-matrx/chat/matrx) to keep conversations.\";\n\nexport function createChatThread(config: ChatThreadConfig): ChatThreadStore {\n  const features = resolveChatFeatures(config.features);\n  const errorSink = config.errorSink ?? createConsoleErrorSink();\n  const notifier = config.notifier ?? createConsoleNotifier();\n  const schedule = createScheduler(config.coalesceMs);\n\n  let messages: ChatMessage[] = [];\n  let status: ChatThreadStatus = \"idle\";\n  let conversationId: string | null = config.conversationId ?? null;\n  let requestId: string | null = null;\n  let phase: string | null = null;\n  let error: ChatErrorPart | null = null;\n  let revision = 0;\n  let snapshot: ChatThreadSnapshot = buildSnapshot();\n  let abort: AbortController | null = null;\n  let disposed = false;\n  let announcedEphemeral = false;\n\n  /**\n   * WHICH CONVERSATION THE TRANSCRIPT IS SHOWING, as a number.\n   *\n   * 🚨 The defect this closes, found by the lane-merge test that switched away\n   * mid-answer: cancelling a turn aborts the CONTROLLER, but a transport whose\n   * frames are already queued (or one that ignores the signal, which a host may\n   * legitimately write) delivers one more. `replaceMessage` appends when it\n   * cannot find the id — so that late frame resurrected the previous\n   * conversation's half-answer INTO the empty transcript the reader was now\n   * looking at, under the new conversation's id. A stale write must be dropped,\n   * not raced. Every write in `send` is stamped with the epoch it started in,\n   * and `startNewConversation` / `loadConversation` bump it.\n   */\n  let epoch = 0;\n\n  const threadListeners = new Set<() => void>();\n  const messageListeners = new Map<string, Set<() => void>>();\n  const dirtyMessages = new Set<string>();\n  let cancelScheduled: (() => void) | null = null;\n\n  function buildSnapshot(): ChatThreadSnapshot {\n    return {\n      conversationId,\n      messages,\n      status,\n      requestId,\n      phase,\n      ephemeral: config.persistence === undefined,\n      ephemeralReason:\n        config.persistence === undefined\n          ? `${EPHEMERAL_REASON} ${EPHEMERAL_REMEDY}`\n          : null,\n      revision,\n      error,\n    };\n  }\n\n  function commit(): void {\n    revision += 1;\n    snapshot = buildSnapshot();\n    const woken = [...dirtyMessages];\n    dirtyMessages.clear();\n    for (const id of woken) {\n      const listeners = messageListeners.get(id);\n      if (!listeners) continue;\n      for (const listener of listeners) listener();\n    }\n    for (const listener of threadListeners) listener();\n  }\n\n  function markDirty(messageId: string | null): void {\n    if (messageId !== null) dirtyMessages.add(messageId);\n    if (cancelScheduled !== null) return;\n    cancelScheduled = schedule(() => {\n      cancelScheduled = null;\n      if (!disposed) commit();\n    });\n  }\n\n  /** Commit immediately — state changes a caller must observe synchronously. */\n  function commitNow(messageId: string | null): void {\n    if (messageId !== null) dirtyMessages.add(messageId);\n    cancelScheduled?.();\n    cancelScheduled = null;\n    commit();\n  }\n\n  function announceEphemeralOnce(): void {\n    if (announcedEphemeral || config.persistence !== undefined) return;\n    announcedEphemeral = true;\n    notifier.notify({\n      level: \"warning\",\n      message: EPHEMERAL_REASON,\n      remedy: EPHEMERAL_REMEDY,\n    });\n  }\n\n  function replaceMessage(next: ChatMessage): void {\n    const index = messages.findIndex((m) => m.id === next.id);\n    if (index === -1) {\n      messages = [...messages, next];\n      return;\n    }\n    const copy = messages.slice();\n    copy[index] = next;\n    messages = copy;\n  }\n\n  function refuseSend(part: ChatErrorPart): ChatSendResult {\n    error = part;\n    status = \"error\";\n    errorSink.capture({ code: part.code ?? \"chat_send_refused\", message: part.message });\n    notifier.notify({\n      level: \"error\",\n      message: part.userMessage,\n      ...(part.remedy === null ? {} : { remedy: part.remedy }),\n    });\n    commitNow(null);\n    return { accepted: false, refusal: part };\n  }\n\n  async function send(input: ChatSendInput): Promise<ChatSendResult> {\n    if (disposed) {\n      return refuseSend({\n        type: \"error\",\n        errorType: \"disposed\",\n        code: \"thread_disposed\",\n        message: \"send() was called on a disposed thread\",\n        userMessage: \"This conversation is no longer active.\",\n        recoverable: false,\n        remedy: \"Open the conversation again.\",\n      });\n    }\n    if (status === \"submitted\" || status === \"streaming\") {\n      return refuseSend({\n        type: \"error\",\n        errorType: \"busy\",\n        code: \"turn_in_flight\",\n        message: \"a turn is already streaming on this thread\",\n        userMessage: \"The assistant is still answering.\",\n        recoverable: true,\n        remedy: \"Wait for the answer to finish, or press stop.\",\n      });\n    }\n\n    // THE CONFIDENTIAL-ROUTING RULE, before a single byte leaves the machine.\n    const routing = decideRouting(features.routing, config.transport.locality);\n    if (!routing.allowed) {\n      return refuseSend({\n        type: \"error\",\n        errorType: \"routing_refused\",\n        code: routing.code,\n        message: routing.userMessage,\n        userMessage: routing.userMessage,\n        recoverable: false,\n        remedy: routing.remedy,\n      });\n    }\n\n    announceEphemeralOnce();\n\n    const fileIds = input.fileIds ?? [];\n    const userMessage = createChatMessage({\n      role: \"user\",\n      parts: [{ type: \"text\", text: input.text }],\n      status: \"complete\",\n    });\n    const assistantId = newLocalId(\"msg\");\n    const assistantPlaceholder = createChatMessage({\n      id: assistantId,\n      role: \"assistant\",\n      parts: [],\n      status: \"pending\",\n    });\n    messages = [...messages, userMessage, assistantPlaceholder];\n    error = null;\n    status = \"submitted\";\n    commitNow(assistantId);\n\n    const turnEpoch = epoch;\n    /** A write from a turn whose conversation is no longer on screen. */\n    const stale = (): boolean => disposed || turnEpoch !== epoch;\n\n    const controller = new AbortController();\n    abort = controller;\n\n    const projector = createChatTurnProjector({\n      features,\n      messageId: assistantId,\n      onRefusal: (refusal: ChatTurnRefusal) =>\n        errorSink.capture({\n          code: refusal.code,\n          message: refusal.message,\n          detail: refusal.detail,\n        }),\n    });\n\n    try {\n      const handle = await config.transport.start({\n        conversationId,\n        isNewConversation: conversationId === null,\n        store: config.persistence !== undefined,\n        text: input.text,\n        fileIds,\n        signal: controller.signal,\n      });\n      if (stale()) return { accepted: true, refusal: null };\n      requestId = handle.requestId;\n      if (handle.conversationId !== null) conversationId = handle.conversationId;\n      status = \"streaming\";\n      commitNow(assistantId);\n\n      if (stale()) return { accepted: true, refusal: null };\n      for await (const frame of handle.frames) {\n        // The reader has moved on. Stop reading the socket rather than painting\n        // the previous conversation's answer into the one now on screen.\n        if (stale()) return { accepted: true, refusal: null };\n        projector.apply(frame);\n        if (projector.state.conversationId !== null) {\n          conversationId = projector.state.conversationId;\n        }\n        if (projector.state.phase !== null) phase = projector.state.phase;\n        const live = projector.snapshot();\n        replaceMessage({\n          ...live,\n          metadata: {\n            ...live.metadata,\n            requestId,\n            createdAt: assistantPlaceholder.metadata.createdAt,\n          },\n        });\n        status =\n          projector.state.outcome === \"awaiting-tools\"\n            ? \"awaiting-approval\"\n            : \"streaming\";\n        markDirty(assistantId);\n      }\n\n      if (stale()) return { accepted: true, refusal: null };\n      const serverUserId = projector.state.serverMessageIds.user;\n      if (serverUserId !== null) {\n        replaceMessage({\n          ...userMessage,\n          metadata: { ...userMessage.metadata, serverMessageId: serverUserId },\n        });\n      }\n      const final = projector.snapshot();\n      replaceMessage({\n        ...final,\n        metadata: {\n          ...final.metadata,\n          requestId,\n          createdAt: assistantPlaceholder.metadata.createdAt,\n        },\n      });\n      error = projector.state.error;\n      status = projector.state.outcome === \"error\" ? \"error\" : \"idle\";\n      commitNow(assistantId);\n      return { accepted: true, refusal: null };\n    } catch (cause) {\n      if (stale()) return { accepted: true, refusal: null };\n      const aborted =\n        controller.signal.aborted ||\n        (cause instanceof Error && cause.name === \"AbortError\");\n      const message = cause instanceof Error ? cause.message : String(cause);\n      const part: ChatErrorPart = aborted\n        ? {\n            type: \"error\",\n            errorType: \"cancelled\",\n            code: \"turn_cancelled\",\n            message: \"the turn was cancelled by the reader\",\n            userMessage: \"You stopped this answer.\",\n            recoverable: true,\n            remedy: null,\n          }\n        : {\n            type: \"error\",\n            errorType: \"transport\",\n            code: \"transport_failed\",\n            message,\n            userMessage: \"The connection to the assistant failed.\",\n            recoverable: true,\n            remedy: \"Try sending the message again.\",\n          };\n      const partial = projector.snapshot();\n      replaceMessage({\n        ...partial,\n        // Partial text NEVER vanishes: the reader keeps what they already saw.\n        parts: [...partial.parts, part],\n        status: aborted ? \"cancelled\" : \"error\",\n        metadata: {\n          ...partial.metadata,\n          requestId,\n          createdAt: assistantPlaceholder.metadata.createdAt,\n        },\n      });\n      if (!aborted) {\n        error = part;\n        status = \"error\";\n        errorSink.capture({ code: part.code ?? \"transport_failed\", message });\n      } else {\n        status = \"idle\";\n      }\n      commitNow(assistantId);\n      return { accepted: true, refusal: null };\n    } finally {\n      if (abort === controller) abort = null;\n    }\n  }\n\n  async function cancel(): Promise<void> {\n    const current = requestId;\n    abort?.abort();\n    if (current === null) return;\n    try {\n      await config.transport.cancel(current);\n    } catch (cause) {\n      errorSink.capture({\n        code: \"cancel_failed\",\n        message: cause instanceof Error ? cause.message : String(cause),\n      });\n      notifier.notify({\n        level: \"warning\",\n        message: \"The assistant did not confirm that it stopped.\",\n        remedy: \"It stops at its next step; anything already written is saved.\",\n      });\n    }\n  }\n\n  async function loadConversation(id: string): Promise<void> {\n    const persistence = config.persistence;\n    if (persistence === undefined) {\n      const part: ChatErrorPart = {\n        type: \"error\",\n        errorType: \"no_persistence\",\n        code: \"history_unavailable\",\n        message: \"loadConversation() was called on a thread with no persistence port\",\n        userMessage: \"Past conversations are not available here.\",\n        recoverable: false,\n        remedy: EPHEMERAL_REMEDY,\n      };\n      refuseSend(part);\n      return;\n    }\n    epoch += 1;\n    const loaded = await persistence.loadThread(id);\n    conversationId = id;\n    messages = loaded.slice();\n    status = \"idle\";\n    error = null;\n    commitNow(null);\n  }\n\n  /**\n   * A fresh conversation on THIS store. An answer still arriving is stopped\n   * first — leaving it running would append the old conversation's frames to\n   * the empty transcript the reader is now looking at — and the stop is\n   * cooperative, so what the server has already written is still saved where it\n   * belongs. Doctrine: a disconnect never cancels server work, and this method\n   * promises nothing more than it does.\n   */\n  async function startNewConversation(): Promise<void> {\n    if (disposed) return;\n    epoch += 1;\n    if (status === \"streaming\" || status === \"submitted\") await cancel();\n    abort = null;\n    conversationId = null;\n    requestId = null;\n    phase = null;\n    messages = [];\n    error = null;\n    status = \"idle\";\n    commitNow(null);\n  }\n\n  return {\n    getSnapshot: () => snapshot,\n    subscribe(listener) {\n      threadListeners.add(listener);\n      return () => {\n        threadListeners.delete(listener);\n      };\n    },\n    subscribeToMessage(messageId, listener) {\n      const existing = messageListeners.get(messageId) ?? new Set<() => void>();\n      existing.add(listener);\n      messageListeners.set(messageId, existing);\n      return () => {\n        existing.delete(listener);\n        if (existing.size === 0) messageListeners.delete(messageId);\n      };\n    },\n    // Reads the COMMITTED snapshot, never the in-flight draft: a per-message\n    // hook that could see an uncommitted value tears against the thread.\n    getMessageSnapshot: (messageId) =>\n      snapshot.messages.find((m) => m.id === messageId),\n    features,\n    send,\n    cancel,\n    setMessages(next) {\n      messages = next.slice();\n      commitNow(null);\n    },\n    settleToolCall(answer) {\n      const settlement = settleToolAnswer(messages, answer);\n      if (!settlement.applied) {\n        if (settlement.refusal !== null) {\n          errorSink.capture({\n            code: \"tool_state_transition_refused\",\n            message: settlement.refusal,\n            detail: answer,\n          });\n        }\n        return settlement;\n      }\n      messages = settlement.messages.slice();\n      commitNow(settlement.messageId);\n      return settlement;\n    },\n    loadConversation,\n    canStartNewConversation: true,\n    startNewConversation,\n    dispose() {\n      disposed = true;\n      cancelScheduled?.();\n      cancelScheduled = null;\n      abort?.abort();\n      threadListeners.clear();\n      messageListeners.clear();\n    },\n  };\n}\n","/**\n * `@ai-matrx/chat/matrx` — THE PLATFORM BINDING.\n *\n * Everything in this entry knows the exact AI Matrx contract: the `/ai/*`\n * routes through `@ai-matrx/agents`, the conversation-start triple, and the\n * `chat.*` schema. Everything host-shaped stays injected.\n *\n * A host reaches a working, persisting, streaming thread with one call:\n *\n * ```ts\n * const thread = createMatrxChatThread({\n *   transport: createMatrxTransport({ baseUrl, credentials, organizationId }),\n *   dataSource: supabase,\n *   organizationId,\n *   target: { kind: \"agent\", agentId },\n *   sourceApp: \"workflow-studio\",\n *   sourceFeature: \"conductor\",\n * });\n * ```\n */\n\nexport {\n  CHAT_SCHEMA,\n  CHAT_TABLES,\n  type ChatDataSource,\n  type ChatSelectQuery,\n  type ChatTableQuery,\n  type PgError,\n  type PgResult,\n} from \"./data-source\";\n\nexport {\n  createMatrxChatTargetRef,\n  createMatrxChatTransport,\n  matrxChatTargetRef,\n  parseMatrxChatTarget,\n  TARGET_IGNORED_ON_CONTINUE,\n  TARGET_IGNORED_ON_CONTINUE_REMEDY,\n  type MatrxChatTarget,\n  type MatrxChatTargetRef,\n  type MatrxChatTransportOptions,\n} from \"./transport\";\n\nexport {\n  createMatrxChatPersistence,\n  isArchivedRow,\n  mapPersistedContent,\n  mapPersistedMessages,\n  toConversationSummary,\n  type MatrxChatPersistenceOptions,\n} from \"./persistence\";\n\nimport type { MatrxTransport } from \"@ai-matrx/agents/matrx\";\n\nimport { createChatThread, type ChatThreadConfig, type ChatThreadStore } from \"../store\";\nimport type { ChatConfigLayers } from \"../config\";\nimport type { ChatDataSource } from \"./data-source\";\nimport { createMatrxChatPersistence } from \"./persistence\";\nimport { createMatrxChatTransport, type MatrxChatTarget } from \"./transport\";\n\nexport interface MatrxChatThreadOptions {\n  /** The production `MatrxTransport` from `@ai-matrx/agents/matrx`. */\n  transport: MatrxTransport;\n  /** Who answers — a function for a surface whose picker can change it\n   *  between turns (`createMatrxChatTargetRef().get`). */\n  target: MatrxChatTarget | (() => MatrxChatTarget);\n  /** The picked model, resolved per turn; `null` leaves the agent's own. */\n  model?: string | null | (() => string | null) | undefined;\n  organizationId: string;\n  sourceApp: string;\n  sourceFeature: string;\n  /**\n   * A supabase-js client. OMIT IT DELIBERATELY for an ephemeral thread — the\n   * thread then runs unpersisted AND SAYS SO on screen, with the remedy. It is\n   * never a silent downgrade.\n   */\n  dataSource?: ChatDataSource | undefined;\n  conversationId?: string | undefined;\n  features?: ChatConfigLayers | undefined;\n  initiation?: \"user\" | \"auto\" | undefined;\n  locality?: \"local\" | \"cloud\" | undefined;\n  errorSink?: ChatThreadConfig[\"errorSink\"] | undefined;\n  notifier?: ChatThreadConfig[\"notifier\"] | undefined;\n  coalesceMs?: number | null | undefined;\n}\n\n/** The batteries-included platform thread: transport + persistence + kernel. */\nexport function createMatrxChatThread(\n  options: MatrxChatThreadOptions,\n): ChatThreadStore {\n  const transport = createMatrxChatTransport({\n    transport: options.transport,\n    target: options.target,\n    organizationId: options.organizationId,\n    sourceApp: options.sourceApp,\n    sourceFeature: options.sourceFeature,\n    initiation: options.initiation,\n    locality: options.locality,\n    model: options.model,\n    // The transport's own sentence (a continue cannot change who answers) goes\n    // to the SAME notifier as the kernel's, so a host wires one sink, not two.\n    notifier: options.notifier,\n  });\n  const persistence =\n    options.dataSource === undefined\n      ? undefined\n      : createMatrxChatPersistence({\n          dataSource: options.dataSource,\n          organizationId: options.organizationId,\n        });\n  return createChatThread({\n    transport,\n    persistence,\n    conversationId: options.conversationId,\n    features: options.features,\n    errorSink: options.errorSink,\n    notifier: options.notifier,\n    coalesceMs: options.coalesceMs,\n  });\n}\n"],"mappings":"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","names":["handle","part","asRecord","asString"]}