npm - @ai-matrx/chat - Versions diffs - 0.1.77 → 0.2.1 - Mend

@ai-matrx/chat 0.1.77 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3088) hide show

package/dist/tools.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/react/tools/registry.tsx","../src/react/tools/generic-body.tsx","../src/react/transcript/tool-chip.tsx","../src/react/hooks.ts","../src/react/provider.tsx","../src/react/icons.tsx","../src/react/tools/card.tsx"],"sourcesContent":["/*\n THE TOOL-RENDERER REGISTRY — `@ai-matrx/chat/tools`, lane 2B.\n \n Ported from `matrx-extend/src/features/chat/tool-display/`, which is the best\n * tool-call UI on the platform (93 registered tools, ~3,900 lines) and the\n * reason the design names it the port source. What is taken is its SHAPE and\n * the two decisions it earned the hard way:\n \n 1. Exact-name lookup, one map, two tiers. A component for a tool that\n * needs one; a declarative description for the ninety that do not. A\n * `switch` on tool name scattered through a transcript is the defect the\n * canonical-chat guard exists to catch.\n * 2. *A registered renderer that throws DEGRADES, it does not take the\n transcript down.** Extend wraps every custom render in an error boundary\n * whose fallback is the generic row. A tool card is the least trustworthy\n * component in a chat — it renders arbitrary server JSON — so its failure\n * must cost the reader one card, never the answer they were reading.\n \n WHAT IS NOT TAKEN: its 93 Chrome-specific entries (they are content, not\n * code, and they belong to that surface), its `@/lib/utils`/Zustand coupling,\n * and its header. A renderer here replaces the chip's BODY. The chip, its\n * header and the kernel's state machine are lane 2A's and stay exactly as they\n * are — a registry entry is a richer body, not a second card.\n /\n\nimport { Component, type ComponentType, type ErrorInfo, type ReactNode } from \"react\";\n\nimport type { ChatToolPart, ChatToolState } from \"../../model\";\n\n/* What a tool renderer is handed. Everything it could need, nothing host-shaped. /\nexport interface ChatToolRenderProps {\n part: ChatToolPart;\n /* `part.input`, hoisted because it is what 90% of renderers read first. /\n input: unknown;\n output: unknown;\n state: ChatToolState;\n /* Present only in `output-error`. /\n errorText: string \| null;\n /* True while the call has not reached a terminal state. /\n running: boolean;\n}\n\nexport type ChatToolRenderer = ComponentType<ChatToolRenderProps>;\n\nexport interface ChatToolRendererRegistry {\n register(toolName: string, renderer: ChatToolRenderer): void;\n /* Register the same renderer under several server names (`web`, `web_search`). /\n registerAll(toolNames: readonly string[], renderer: ChatToolRenderer): void;\n lookup(toolName: string): ChatToolRenderer \| undefined;\n /* Every registered name, sorted. The census a guard can read. /\n names(): string[];\n}\n\nexport function createToolRendererRegistry(\n seed: Readonly<Record<string, ChatToolRenderer>> = {},\n): ChatToolRendererRegistry {\n const map = new Map<string, ChatToolRenderer>(Object.entries(seed));\n return {\n register(toolName, renderer) {\n map.set(toolName, renderer);\n },\n registerAll(toolNames, renderer) {\n for (const name of toolNames) map.set(name, renderer);\n },\n lookup(toolName) {\n return map.get(toolName);\n },\n names() {\n return [...map.keys()].sort();\n },\n };\n}\n\n/\n THE BOUNDARY. A renderer that throws costs the reader one BODY, and the\n * fallback is the generic body — which by construction cannot itself fail.\n * The failure is also REPORTED, with the tool's name, because a card that\n * quietly degrades for a week is a defect nobody ever sees.\n /\nexport class ChatToolBodyBoundary extends Component<\n {\n toolName: string;\n fallback: ReactNode;\n onError?: ((error: Error, info: ErrorInfo) => void) \| undefined;\n children: ReactNode;\n },\n { failed: boolean }\n> {\n override state = { failed: false };\n\n static getDerivedStateFromError(): { failed: boolean } {\n return { failed: true };\n }\n\n override componentDidCatch(error: Error, info: ErrorInfo): void {\n this.props.onError?.(error, info);\n }\n\n override render(): ReactNode {\n if (this.state.failed) {\n return (\n <div className=\"mx-chat-tool__body\" data-mx-chat-tool-body=\"degraded\">\n <span className=\"mx-chat-standin\">\n {`The custom view for ${this.props.toolName} could not be drawn, so this is the plain version of what it did.`}\n </span>\n {this.props.fallback}\n </div>\n );\n }\n return this.props.children;\n }\n}\n","/\n THE GENERIC TOOL BODY — the floor that can never fail.\n \n Every branch here is defensive on purpose. This renders arbitrary JSON that a\n * model asked a server to produce: it can be a 4 MB string, a cyclic object, a\n * BigInt, `undefined`, or an array of nulls. The extend registry's default row\n * is the reference, and its two survival rules are kept verbatim in spirit:\n \n - `JSON.stringify` is ALWAYS inside a try/catch, falling back to `String()`.\n * A cycle or a BigInt throws, and an uncaught throw here is a blank\n * transcript.\n * - a long payload is CLIPPED VISUALLY (a scrolling `<pre>`), not truncated\n * silently. A reader who is shown 80 of 4,000 characters with no sign that\n * there are more has been lied to; when this body does cut a string it says\n * how much it cut.\n \n It also produces the one-line summary the extend row leads with — the first\n * recognisable field (`url`, `query`, `text`, `question`, `reason`, `path`,\n * `selector`), or the first few keys — because a chip that says only\n * \"web_search: Running\" tells a reader watching their money being spent\n * nothing at all.\n /\n\nimport type { ReactNode } from \"react\";\n\nimport { formatCount } from \"@ai-matrx/kit/format\";\n\nimport type { ChatToolRenderProps } from \"./registry\";\n\n/* Above this many characters a payload is cut, and the cut is NAMED. /\nexport const PAYLOAD_CLIP_CHARS = 20_000;\n\nexport function safeStringify(value: unknown): string {\n if (value === undefined) return \"\";\n if (typeof value === \"string\") return value;\n try {\n const out = JSON.stringify(value, null, 2);\n return out === undefined ? String(value) : out;\n } catch {\n // A cycle, a BigInt, a getter that throws — the payload still has to say\n // something, and `String()` cannot throw for these.\n try {\n return String(value);\n } catch {\n return \"(this value cannot be displayed)\";\n }\n }\n}\n\nexport function summarizeToolInput(input: unknown): string \| null {\n if (input === null \|\| input === undefined) return null;\n if (typeof input === \"string\") return clipLine(input);\n if (typeof input !== \"object\") return String(input);\n if (Array.isArray(input)) return `${input.length} item${input.length === 1 ? \"\" : \"s\"}`;\n const record = input as Record<string, unknown>;\n for (const key of [\"url\", \"query\", \"q\", \"text\", \"question\", \"reason\", \"path\", \"selector\", \"name\"]) {\n const value = record[key];\n if (typeof value === \"string\" && value !== \"\") return clipLine(value);\n }\n const keys = Object.keys(record);\n if (keys.length === 0) return null;\n return keys.slice(0, 3).join(\", \");\n}\n\nfunction clipLine(text: string): string {\n return text.length > 96 ? `${text.slice(0, 96)}…` : text;\n}\n\n/ ------------------------------------------------- the shape-detected tier -- /\n\nexport interface ToolResultLink {\n title: string;\n url: string;\n snippet: string \| null;\n}\n\n/\n THE ONE UPGRADE OVER RAW JSON THAT NEEDS NO TOOL NAME.\n \n Most of extend's 93 entries exist to turn one shape — a list of results with\n * a title and a URL — into something a person can click. That shape is\n * recognisable from the VALUE, so the package gets the benefit for every tool\n * that has ever returned it, including tools nobody has registered and tools\n * that do not exist yet. A registry entry keyed on a tool name can only ever\n * help the tools someone remembered to name.\n \n It is deliberately strict: every element must carry a http(s) URL and a\n * non-empty title, or the whole thing falls back to JSON. A half-detected list\n * that drops the fields it did not understand is worse than the JSON.\n /\nexport function detectResultLinks(value: unknown): ToolResultLink[] \| null {\n const candidate = Array.isArray(value)\n ? value\n : value !== null && typeof value === \"object\"\n ? ([\"results\", \"items\", \"links\", \"sources\"] as const)\n .map((key) => (value as Record<string, unknown>)[key])\n .find((entry) => Array.isArray(entry))\n : undefined;\n if (!Array.isArray(candidate) \|\| candidate.length === 0) return null;\n\n const links: ToolResultLink[] = [];\n for (const entry of candidate) {\n if (entry === null \|\| typeof entry !== \"object\" \|\| Array.isArray(entry)) return null;\n const record = entry as Record<string, unknown>;\n const url = record[\"url\"] ?? record[\"link\"] ?? record[\"href\"];\n const title = record[\"title\"] ?? record[\"name\"] ?? record[\"heading\"];\n if (typeof url !== \"string\" \|\| !/^https?:\\/\\//i.test(url)) return null;\n if (typeof title !== \"string\" \|\| title.trim() === \"\") return null;\n const snippet = record[\"snippet\"] ?? record[\"description\"] ?? record[\"summary\"];\n links.push({\n title,\n url,\n snippet: typeof snippet === \"string\" && snippet !== \"\" ? snippet : null,\n });\n }\n return links;\n}\n\nfunction ResultLinks(props: { links: readonly ToolResultLink[] }): ReactNode {\n return (\n <ul className=\"mx-chat-tool__links\">\n {props.links.map((link, index) => (\n <li key={`${link.url}-${index}`}>\n <a href={link.url} target=\"_blank\" rel=\"noreferrer noopener\">\n {link.title}\n </a>\n {link.snippet === null ? null : (\n <span className=\"mx-chat-tool__snippet\">{link.snippet}</span>\n )}\n </li>\n ))}\n </ul>\n );\n}\n\nfunction Payload(props: { label: string; value: unknown }): ReactNode {\n const body = safeStringify(props.value);\n if (body === \"\") return null;\n const clipped = body.length > PAYLOAD_CLIP_CHARS;\n return (\n <>\n <span className=\"mx-chat-tool__label\">{props.label}</span>\n <pre className=\"mx-chat-tool__payload\">\n {clipped ? body.slice(0, PAYLOAD_CLIP_CHARS) : body}\n </pre>\n {clipped ? (\n <span className=\"mx-chat-standin\">\n {`Showing the first ${formatCount(PAYLOAD_CLIP_CHARS)} characters of ${formatCount(body.length)}.`}\n </span>\n ) : null}\n </>\n );\n}\n\n/\n The body a tool gets when nothing is registered for it, and the fallback\n * when a registered renderer throws.\n /\nexport function ChatToolGenericBody(props: ChatToolRenderProps): ReactNode {\n const summary = summarizeToolInput(props.input);\n const links = detectResultLinks(props.output);\n const hasAnything =\n summary !== null \|\|\n props.input !== undefined \|\|\n props.output !== undefined \|\|\n props.errorText !== null \|\|\n props.part.progress.length > 0;\n\n return (\n <div className=\"mx-chat-tool__body\" data-mx-chat-tool-body=\"generic\">\n {summary === null ? null : (\n <p className=\"mx-chat-tool__summary\">{summary}</p>\n )}\n\n <Payload label=\"What it was asked\" value={props.input} />\n\n {props.part.progress.length > 0 ? (\n <>\n <span className=\"mx-chat-tool__label\">Progress</span>\n <ul className=\"mx-chat-tool__progress\">\n {props.part.progress.map((beat, index) => (\n <li key={`${beat.toolName}-${index}`}>\n {/ The SERVER's name per beat: it differs from the call's name\n mid-run, and flattening them loses what actually ran. /}\n <span data-tool-beat={beat.toolName}>{beat.toolName}</span>\n {beat.message === \"\" ? null : ` — ${beat.message}`}\n {beat.percent === null ? null : ` (${Math.round(beat.percent)}%)`}\n </li>\n ))}\n </ul>\n </>\n ) : null}\n\n {props.errorText === null ? null : (\n <>\n <span className=\"mx-chat-tool__label\">What went wrong</span>\n <p className=\"mx-chat-failure__sentence\">{props.errorText}</p>\n </>\n )}\n\n {links === null ? (\n <Payload label=\"What it returned\" value={props.output} />\n ) : (\n <>\n <span className=\"mx-chat-tool__label\">What it found</span>\n <ResultLinks links={links} />\n </>\n )}\n\n {hasAnything ? null : (\n <span className=\"mx-chat-standin\">\n {props.running\n ? \"This tool has not said what it is doing yet.\"\n : \"This tool ran without reporting any details.\"}\n </span>\n )}\n </div>\n );\n}\n","/\n THE BASIC TOOL CHIP — the transcript's floor for a tool call.\n \n It is driven entirely by the kernel's tool state machine\n * (`input-streaming → input-available → approval-requested → output-available \|\n * output-error \| output-denied`), which is the champion's vocabulary and which\n * the live corpus already walks: `tool_started` with arguments, three\n * `tool_progress` beats under three DIFFERENT tool names, then `tool_completed`\n * with the result.\n \n Three things it refuses to do, each a real failure seen in the wild:\n * - it never shows a bare spinner with no name. A reader watching an agent\n * spend their money is owed the tool's name and what it is doing.\n * - it never drops the progress beats, and it keeps the SERVER's tool name per\n * beat (`web` → `web_search` → `web_research`); flattening them to the\n * call's name loses what actually ran.\n * - it never renders an error state as \"Done\".\n \n Lane 2B's `/tools` registry replaces this chip's BODY with a per-tool\n * renderer. The chip, its state machine and its header stay — a registry entry\n * is a richer body, not a second card. That is the `body` prop below: at the\n * lane merge `<ChatToolCard>` stopped carrying its own copy of this header and\n * became this chip with a body passed in, so the two can no longer drift in\n * markup, in state words, or in expand behaviour.\n /\n\nimport { useState, type ReactNode } from \"react\";\n\nimport type { ChatToolPart, ChatToolState } from \"../../model\";\nimport { useChatPorts } from \"../hooks\";\nimport { ChevronRightGlyph } from \"../icons\";\n\n/\n What the state means to a READER, not to a protocol. THE ONE TABLE: `/tools`\n * re-exports this rather than restating it, because a tool that reads \"Done\" in\n * one card and \"Completed\" in another is drift nobody notices for a month.\n /\nexport const CHAT_TOOL_STATE_LABEL: Record<ChatToolState, string> = {\n \"input-streaming\": \"Preparing\",\n \"input-available\": \"Running\",\n \"approval-requested\": \"Needs your approval\",\n \"output-available\": \"Done\",\n \"output-error\": \"Failed\",\n \"output-denied\": \"Declined\",\n};\n\nfunction formatPayload(value: unknown): string {\n if (value === undefined) return \"\";\n if (typeof value === \"string\") return value;\n try {\n return JSON.stringify(value, null, 2);\n } catch {\n // A payload with a cycle or a BigInt still has to say something.\n return String(value);\n }\n}\n\nexport interface ChatToolChipProps {\n part: ChatToolPart;\n /* From `features.expandToolCardsByDefault`. /\n defaultExpanded: boolean;\n /\n Replace what the chip shows when it is open. This is the ONE seam `/tools`\n * uses: a registered renderer is a richer BODY under the same header, the\n * same state words and the same expand behaviour — never a second card.\n * Absent ⇒ the chip's own body (arguments, progress beats, error, result).\n /\n body?: ReactNode \| undefined;\n /* Diagnostic marker for the surrounding element, e.g. which renderer drew\n * the body. Read by tests and by the census; never shown to a reader. /\n rendererTag?: string \| undefined;\n}\n\nexport function ChatToolChip(props: ChatToolChipProps): ReactNode {\n const { part, defaultExpanded, body } = props;\n const [expanded, setExpanded] = useState(defaultExpanded);\n\n const { toolLabel } = useChatPorts();\n const latest = part.progress[part.progress.length - 1];\n const input = formatPayload(part.input);\n const output = formatPayload(part.output);\n const stateLabel = CHAT_TOOL_STATE_LABEL[part.state];\n // THE HEADER SAYS EACH THING ONCE. Servers send a completion beat whose\n // whole content is the word the state column already carries (\"Done\"), and\n // the chip read \"Done Done\" in front of a Creator (live review 2026-09-18).\n // The beat is not thrown away — it stays in the body, under Progress.\n const beat =\n latest !== undefined &&\n latest.message !== \"\" &&\n latest.message.trim().toLowerCase() !== stateLabel.toLowerCase()\n ? latest.message\n : null;\n const hasBody =\n input !== \"\" \|\| output !== \"\" \|\| part.errorText !== null \|\| part.progress.length > 0;\n\n return (\n <div\n className=\"mx-chat-tool\"\n data-state={part.state}\n data-tool={part.toolName}\n {...(props.rendererTag === undefined\n ? {}\n : { \"data-mx-chat-tool-renderer\": props.rendererTag })}\n >\n <button\n type=\"button\"\n className=\"mx-chat-tool__header mx-chat-focusable\"\n aria-expanded={expanded}\n // A chip with nothing to show still toggles rather than sitting there\n // looking disabled (Law 4) — it says so in the body instead.\n onClick={() => setExpanded((open) => !open)}\n >\n <span data-open={expanded} className=\"mx-chat-chevron-wrap\">\n <ChevronRightGlyph />\n </span>\n {/ WHAT IS HAPPENING, never the identifier — `toolLabel` is the port\n and `data-tool` above keeps the machine name for the machines. /}\n <span className=\"mx-chat-tool__name\">{toolLabel(part.toolName)}</span>\n {beat === null ? null : <span className=\"mx-chat-tool__beat\">{beat}</span>}\n <span className=\"mx-chat-tool__state\">{stateLabel}</span>\n </button>\n\n {expanded ? (\n body !== undefined ? (\n body\n ) : (\n <div className=\"mx-chat-tool__body\">\n {input !== \"\" ? (\n <>\n <span className=\"mx-chat-tool__label\">What it was asked</span>\n <pre className=\"mx-chat-tool__payload\">{input}</pre>\n </>\n ) : null}\n\n {part.progress.length > 0 ? (\n <>\n <span className=\"mx-chat-tool__label\">Progress</span>\n <ul className=\"mx-chat-tool__progress\">\n {part.progress.map((beat, index) => (\n <li key={`${beat.toolName}-${index}`}>\n <span data-tool-beat={beat.toolName}>{beat.toolName}</span>\n {beat.message === \"\" ? null : ` — ${beat.message}`}\n {beat.percent === null ? null : ` (${Math.round(beat.percent)}%)`}\n </li>\n ))}\n </ul>\n </>\n ) : null}\n\n {part.errorText !== null ? (\n <>\n <span className=\"mx-chat-tool__label\">What went wrong</span>\n <p className=\"mx-chat-failure__sentence\">{part.errorText}</p>\n </>\n ) : null}\n\n {output !== \"\" ? (\n <>\n <span className=\"mx-chat-tool__label\">What it returned</span>\n <pre className=\"mx-chat-tool__payload\">{output}</pre>\n </>\n ) : null}\n\n {hasBody ? null : (\n <span className=\"mx-chat-standin\">\n {part.state === \"input-streaming\"\n ? \"This tool has not said what it is doing yet.\"\n : \"This tool ran without reporting any details.\"}\n </span>\n )}\n </div>\n )\n ) : null}\n </div>\n );\n}\n","/\n THE BASE HOOKS — shared scaffolding, layer 3 of the design.\n \n All four read the kernel through `useSyncExternalStore`, which is the shape\n * the champion (`@ai-sdk/react`) proved and the reason the store was written as\n * `getSnapshot`/`subscribe` in phase 1. Nothing here holds a second copy of\n * thread state: a hook that mirrors the store into `useState` tears under\n * concurrent rendering and drifts the moment the host mutates the store from\n * outside React.\n \n `useChatMessage(id)` is the performance seam that makes a 2,000-token answer\n * possible: it subscribes to ONE message, so a streaming bubble re-renders\n * while the other 200 rows do not.\n /\n\nimport {\n useCallback,\n useEffect,\n useMemo,\n useRef,\n useState,\n useSyncExternalStore,\n type KeyboardEvent as ReactKeyboardEvent,\n} from \"react\";\n\nimport type { ChatFeatures } from \"../config\";\nimport type { ChatMessage, ChatThreadSnapshot } from \"../model\";\nimport { messageText } from \"../model\";\nimport type { ChatSendResult } from \"../store\";\nimport { useChatContext } from \"./provider\";\nimport type { ChatReactPorts } from \"./ports\";\nimport type { ChatSlots } from \"./slots\";\n\nexport interface UseChatThreadResult {\n snapshot: ChatThreadSnapshot;\n messages: readonly ChatMessage[];\n status: ChatThreadSnapshot[\"status\"];\n /* True while a turn is in flight — the ONE test a stop button uses. /\n isBusy: boolean;\n conversationId: string \| null;\n ephemeral: boolean;\n ephemeralReason: string \| null;\n error: ChatThreadSnapshot[\"error\"];\n send(text: string, fileIds?: readonly string[]): Promise<ChatSendResult>;\n cancel(): Promise<void>;\n}\n\n/* The whole thread. Use `useChatMessage` for a row — not this. /\nexport function useChatThread(): UseChatThreadResult {\n const { thread } = useChatContext();\n const snapshot = useSyncExternalStore(\n thread.subscribe,\n thread.getSnapshot,\n thread.getSnapshot,\n );\n\n const send = useCallback(\n (text: string, fileIds?: readonly string[]) =>\n thread.send(fileIds === undefined ? { text } : { text, fileIds }),\n [thread],\n );\n const cancel = useCallback(() => thread.cancel(), [thread]);\n\n return useMemo(\n () => ({\n snapshot,\n messages: snapshot.messages,\n status: snapshot.status,\n isBusy: snapshot.status === \"submitted\" \|\| snapshot.status === \"streaming\",\n conversationId: snapshot.conversationId,\n ephemeral: snapshot.ephemeral,\n ephemeralReason: snapshot.ephemeralReason,\n error: snapshot.error,\n send,\n cancel,\n }),\n [snapshot, send, cancel],\n );\n}\n\n/\n ONE message, on its own subscription.\n \n Returns `undefined` for an id the thread does not hold — a row that was\n * removed while its component was unmounting is ordinary, not an error.\n /\nexport function useChatMessage(messageId: string): ChatMessage \| undefined {\n const { thread } = useChatContext();\n\n const subscribe = useCallback(\n (listener: () => void) => thread.subscribeToMessage(messageId, listener),\n [thread, messageId],\n );\n const getSnapshot = useCallback(\n () => thread.getMessageSnapshot(messageId),\n [thread, messageId],\n );\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n/* The resolved knobs (platform → org → surface → user), from the kernel. /\nexport function useChatConfig(): ChatFeatures {\n return useChatContext().thread.features;\n}\n\n/* The React ports, each already defaulted by the provider. /\nexport function useChatPorts(): ChatReactPorts {\n return useChatContext().ports;\n}\n\n/* The slot map. Empty object when the host passed none. /\nexport function useChatSlots(): ChatSlots {\n return useChatContext().slots;\n}\n\nexport interface UseChatComposerStateResult {\n text: string;\n setText(next: string): void;\n /* False when the box is blank, or while a turn is in flight unless\n * `features.sendWhileBusy` (the host queues). /\n canSend: boolean;\n isBusy: boolean;\n send(): Promise<ChatSendResult \| null>;\n stop(): Promise<void>;\n /\n The keyboard contract, decided by `features.sendKey`: Enter sends and\n * Shift+Enter newlines, or Cmd/Ctrl+Enter sends and Enter newlines. Esc\n * ALWAYS stops a running answer. Wire this to the input's `onKeyDown`.\n /\n onKeyDown(event: ReactKeyboardEvent): void;\n /* True when a failed turn just handed its words back. Clears on the next\n * edit, so a composer can flash the box once without it sticking. /\n restoredFromFailure: boolean;\n}\n\nconst DRAFT_PREFIX = \"ai-matrx.chat.draft.\";\n\n/\n COMPOSER STATE — the logic half, with no opinion about pixels.\n \n Lane 2B renders this. It lives in shared scaffolding rather than in 2B\n * because 2A needs one half of it TODAY: a failed turn's \"Try again\" hands the\n * reader's unsent words back through the retry bus, and there has to be exactly\n * one place that catches them. Two sources of composer state is how a draft\n * gets lost.\n \n Drafts survive reload when `features.retainDrafts` is on, keyed per\n * conversation, through the `prefs` port — which already announces itself when\n * it is memory-only.\n /\nexport function useChatComposerState(): UseChatComposerStateResult {\n const { thread, ports, retry } = useChatContext();\n const features = thread.features;\n const snapshot = useSyncExternalStore(\n thread.subscribe,\n thread.getSnapshot,\n thread.getSnapshot,\n );\n const conversationId = snapshot.conversationId;\n const isBusy = snapshot.status === \"submitted\" \|\| snapshot.status === \"streaming\";\n\n const draftKey = `${DRAFT_PREFIX}${conversationId ?? \"new\"}`;\n const [text, setTextState] = useState<string>(() =>\n features.retainDrafts ? (ports.prefs.get(draftKey) ?? \"\") : \"\",\n );\n const [restoredFromFailure, setRestored] = useState(false);\n\n // The draft key changes when the conversation does — including the moment a\n // NEW conversation learns its server id mid-send. Carrying the in-progress\n // text across that rename is the difference between a draft that survives and\n // one that vanishes the first time someone types during the first turn.\n const keyRef = useRef(draftKey);\n useEffect(() => {\n if (keyRef.current === draftKey) return;\n const previousKey = keyRef.current;\n keyRef.current = draftKey;\n if (!features.retainDrafts) return;\n const carried = ports.prefs.get(previousKey);\n if (carried !== null && carried !== \"\") {\n ports.prefs.set(draftKey, carried);\n ports.prefs.remove(previousKey);\n setTextState(carried);\n return;\n }\n setTextState(ports.prefs.get(draftKey) ?? \"\");\n }, [draftKey, features.retainDrafts, ports.prefs]);\n\n const setText = useCallback(\n (next: string) => {\n setTextState(next);\n setRestored(false);\n if (!features.retainDrafts) return;\n if (next === \"\") ports.prefs.remove(keyRef.current);\n else ports.prefs.set(keyRef.current, next);\n },\n [features.retainDrafts, ports.prefs],\n );\n\n // Catch the words a failed turn hands back. Registered here and NOWHERE else,\n // so \"Try again\" has exactly one destination.\n useEffect(\n () =>\n retry.subscribe((restored) => {\n setTextState(restored);\n setRestored(true);\n if (features.retainDrafts) ports.prefs.set(keyRef.current, restored);\n }),\n [retry, features.retainDrafts, ports.prefs],\n );\n\n const send = useCallback(async (): Promise<ChatSendResult \| null> => {\n const body = text.trim();\n if (body === \"\" \|\| (isBusy && !features.sendWhileBusy)) return null;\n // The box is cleared OPTIMISTICALLY and the draft with it; if the kernel\n // refuses the send, the words come straight back rather than being lost.\n setTextState(\"\");\n setRestored(false);\n if (features.retainDrafts) ports.prefs.remove(keyRef.current);\n const result = await thread.send({ text: body });\n if (!result.accepted) {\n setTextState(body);\n if (features.retainDrafts) ports.prefs.set(keyRef.current, body);\n }\n return result;\n }, [text, isBusy, thread, features.retainDrafts, features.sendWhileBusy, ports.prefs]);\n\n const stop = useCallback(() => thread.cancel(), [thread]);\n\n const onKeyDown = useCallback(\n (event: ReactKeyboardEvent) => {\n if (event.key === \"Escape\") {\n if (!isBusy) return;\n event.preventDefault();\n void thread.cancel();\n return;\n }\n if (event.key !== \"Enter\") return;\n const withModifier = event.metaKey \|\| event.ctrlKey;\n const sends =\n features.sendKey === \"enter\"\n ? !event.shiftKey && !withModifier\n : withModifier;\n if (!sends) return;\n event.preventDefault();\n void send();\n },\n [features.sendKey, isBusy, send, thread],\n );\n\n return {\n text,\n setText,\n canSend: text.trim() !== \"\" && (!isBusy \|\| features.sendWhileBusy),\n isBusy,\n send,\n stop,\n onKeyDown,\n restoredFromFailure,\n };\n}\n\n/\n The text of the user turn that produced a given assistant message — what\n * \"Try again\" hands back. Exported because 2B's composer and 2A's failure card\n * must agree on what \"the unsent text\" means.\n /\nexport function precedingUserText(\n messages: readonly ChatMessage[],\n messageId: string,\n): string {\n const index = messages.findIndex((message) => message.id === messageId);\n if (index <= 0) return \"\";\n for (let cursor = index - 1; cursor >= 0; cursor -= 1) {\n const candidate = messages[cursor];\n if (candidate && candidate.role === \"user\") return messageText(candidate);\n }\n return \"\";\n}\n","/\n `<ChatProvider>` — the ONE context every lane reads. Shared scaffolding.\n \n It carries three things and decides nothing else:\n * 1. THE THREAD STORE — the kernel's `ChatThreadStore`, or anything else with\n * that shape, which is exactly what `@ai-matrx/chat/external-store`\n * returns. That is why the prop is typed as the store interface and not as\n * a config object: a host whose state already lives in Redux or behind an\n * MV3 relay mounts the SAME provider, and the strangler in design §9 works\n * because of this one line.\n * 2. THE REACT PORTS — `renderContent`, `notifier`, `prefs`, `files` and\n * `voice`, each with a working default (THE ALL-INCLUSIVE LAW). The\n * `renderContent` default is the REAL one — `createChatContentRenderer`,\n * markdown plus content-IR kind routing — not the plain-text floor. A host\n * that mounts nothing gets formatted answers, which is what \"drop-in\"\n * means; `createPlainTextContentRenderer` stays exported as the\n * zero-dependency floor for a host that cannot take content-ir at all.\n * 3. THE SLOTS — the per-lane slot map.\n \n The knobs are NOT carried here: they are resolved in the kernel and read off\n * `thread.features`, so a knob has one resolution site and a host cannot end up\n * with a composer that thinks Enter sends and a transcript that does not.\n /\n\nimport {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n type ReactNode,\n} from \"react\";\n\nimport type { ChatThreadStore } from \"../store\";\nimport type { ChatNotifierPort } from \"../ports\";\nimport { createConsoleNotifier, createWebPrefs } from \"../ports\";\nimport { createChatContentRenderer } from \"./composer/content-default\";\nimport { createUnavailableFilesPort } from \"./composer/files\";\nimport type { ChatReactPortOverrides, ChatReactPorts } from \"./ports\";\nimport { humanizeToolName } from \"./ports\";\nimport type { ChatSlots } from \"./slots\";\n\n/\n THE RETRY BUS.\n \n A failed turn's \"Try again\" must hand the reader's unsent words BACK to the\n * composer — retyping a paragraph the product lost is the cheapest possible\n * insult. The transcript (2A) and the composer (2B) are different lanes and\n * different components, so the handoff is a tiny subscribable rather than a\n * prop drilled between them.\n \n It is also the reason this is not a plain callback: when NOTHING is listening\n * — a transcript mounted with no composer, which is a legitimate embedding —\n * the words would vanish silently. Instead the bus says so, with the remedy.\n /\nexport interface ChatRetryBus {\n /* Hand text back to the composer. Returns false when nobody took it. /\n request(text: string): boolean;\n subscribe(listener: (text: string) => void): () => void;\n}\n\nexport function createChatRetryBus(notifier: ChatNotifierPort): ChatRetryBus {\n const listeners = new Set<(text: string) => void>();\n return {\n request(text) {\n if (listeners.size === 0) {\n notifier.notify({\n level: \"warning\",\n message:\n \"There is nowhere to put your message back, so it has not been restored for you.\",\n remedy:\n \"Copy your message from the conversation above and send it again, or mount this transcript inside a chat that has a message box.\",\n });\n return false;\n }\n for (const listener of listeners) listener(text);\n return true;\n },\n subscribe(listener) {\n listeners.add(listener);\n return () => {\n listeners.delete(listener);\n };\n },\n };\n}\n\nexport interface ChatContextValue {\n thread: ChatThreadStore;\n ports: ChatReactPorts;\n slots: ChatSlots;\n retry: ChatRetryBus;\n}\n\nconst ChatContext = createContext<ChatContextValue \| null>(null);\n\nexport interface ChatProviderProps {\n /\n The kernel store (`createChatThread`) or a host-owned source\n * (`createExternalThreadSource`). Both satisfy this interface — that is the\n * whole point of the interface.\n /\n thread: ChatThreadStore;\n ports?: ChatReactPortOverrides \| undefined;\n slots?: ChatSlots \| undefined;\n children: ReactNode;\n}\n\nexport function ChatProvider(props: ChatProviderProps): ReactNode {\n const { thread, ports, slots, children } = props;\n\n // The defaults are built ONCE per provider, not per render: the plain-text\n // renderer holds an \"already announced\" flag and the prefs port probes\n // localStorage,\n // and rebuilding either per render would re-announce forever and re-probe on\n // every keystroke.\n const [defaults] = useState(() => {\n const notifier = createConsoleNotifier();\n return { notifier, prefs: createWebPrefs(notifier) };\n });\n\n const notifier = ports?.notifier ?? defaults.notifier;\n\n // The retry bus AND the default content renderer are both keyed to the\n // EFFECTIVE notifier, not to the fallback one. A host that injects a notifier\n // and then never hears \"your markdown is not being formatted\" or \"there is\n // nowhere to put your message back\" has a silent failure the injection was\n // supposed to prevent — that is the bug this keying exists to stop.\n const keyedRef = useRef<{\n notifier: ChatNotifierPort;\n bus: ChatRetryBus;\n renderContent: ChatReactPorts[\"renderContent\"];\n files: ChatReactPorts[\"files\"];\n } \| null>(null);\n if (keyedRef.current === null \|\| keyedRef.current.notifier !== notifier) {\n keyedRef.current = {\n notifier,\n bus: createChatRetryBus(notifier),\n renderContent: createChatContentRenderer({ notifier }),\n // The stand-in holds an \"already announced\" flag, so it is built ONCE:\n // rebuilding it per render would re-refuse out loud on every keystroke.\n files: createUnavailableFilesPort(notifier),\n };\n }\n const retry = keyedRef.current.bus;\n const defaultRenderContent = keyedRef.current.renderContent;\n const defaultFiles = keyedRef.current.files;\n\n const value = useMemo<ChatContextValue>(\n () => ({\n thread,\n ports: {\n renderContent: ports?.renderContent ?? defaultRenderContent,\n notifier,\n prefs: ports?.prefs ?? defaults.prefs,\n files: ports?.files ?? defaultFiles,\n // `null` is a REAL answer here (\"this surface has no voice\"), so it is\n // only defaulted when the key is absent entirely.\n voice: ports?.voice ?? null,\n toolLabel: ports?.toolLabel ?? humanizeToolName,\n // `null` is a REAL answer here too (\"this surface does not choose a\n // model\"), so it is only defaulted when the key is absent entirely —\n // and the default is nothing drawn, never a dead control.\n modelPicker: ports?.modelPicker ?? null,\n // Same rule: `null` is the real answer \"this surface offers no chips\",\n // and the control row is then ABSENT rather than an empty band.\n quickset: ports?.quickset ?? null,\n },\n slots: slots ?? {},\n retry,\n }),\n [\n thread,\n ports?.renderContent,\n ports?.prefs,\n ports?.files,\n ports?.voice,\n ports?.toolLabel,\n ports?.modelPicker,\n ports?.quickset,\n notifier,\n slots,\n retry,\n defaultRenderContent,\n defaultFiles,\n defaults.prefs,\n ],\n );\n\n // A thread the provider outlives must not keep its timers and its in-flight\n // turn running. The provider does NOT dispose a thread it did not create —\n // the host owns that lifecycle — but it does warn when a thread is swapped\n // mid-stream, because the abandoned turn keeps billing.\n const previous = useRef(thread);\n useEffect(() => {\n if (previous.current === thread) return;\n const status = previous.current.getSnapshot().status;\n if (status === \"streaming\" \|\| status === \"submitted\") {\n notifier.notify({\n level: \"warning\",\n message: \"The previous answer was still arriving when this chat switched conversations.\",\n remedy: \"Stop the answer before switching, or the run keeps going in the background.\",\n });\n }\n previous.current = thread;\n }, [thread, notifier]);\n\n return <ChatContext.Provider value={value}>{children}</ChatContext.Provider>;\n}\n\n/\n The context, or a THROWN error naming what is missing. A hook that returns a\n * silent `null` here produces a blank transcript with no explanation, which is\n * the failure mode Law 4 exists to close — and the stack trace is the remedy.\n /\nexport function useChatContext(): ChatContextValue {\n const value = useContext(ChatContext);\n if (value === null) {\n throw new Error(\n \"[@ai-matrx/chat] This component must be rendered inside <ChatProvider thread={…}>. Wrap your chat surface in one, passing a thread from createChatThread() or createExternalThreadSource().\",\n );\n }\n return value;\n}\n","/\n PACKAGE-OWNED GLYPHS. Two of them, inline, sized in `em`, `currentColor`.\n \n Deliberately NOT a dependency on `@ai-matrx/icons`: two 200-byte paths do not\n * justify an edge in the sibling graph, and an icon that inherits colour and\n * size from its button is exactly what the re-skin contract needs. Lanes that\n * need a real icon set (the composer's attach/mic/send) take the dependency\n * then, at their own call site.\n /\n\nimport type { ReactNode } from \"react\";\n\nexport function ChevronRightGlyph(): ReactNode {\n return (\n <svg\n className=\"mx-chat-chevron\"\n width=\"1em\"\n height=\"1em\"\n viewBox=\"0 0 16 16\"\n fill=\"none\"\n stroke=\"currentColor\"\n strokeWidth=\"1.75\"\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n aria-hidden=\"true\"\n focusable=\"false\"\n >\n <path d=\"M6 3.5 10.5 8 6 12.5\" />\n </svg>\n );\n}\n\nexport function ArrowDownGlyph(): ReactNode {\n return (\n <svg\n width=\"1em\"\n height=\"1em\"\n viewBox=\"0 0 16 16\"\n fill=\"none\"\n stroke=\"currentColor\"\n strokeWidth=\"1.75\"\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n aria-hidden=\"true\"\n focusable=\"false\"\n >\n <path d=\"M8 3v10M3.5 8.5 8 13l4.5-4.5\" />\n </svg>\n );\n}\n","/\n `<ChatToolCard>` and the slot that mounts it.\n \n 🚨 HOW THIS REACHES THE TRANSCRIPT WITHOUT TOUCHING IT. Lane 2A's\n * `<ChatToolChip>` is finished and pushed, and the lane contract forbids 2B\n * editing it. The transcript already ships the seam this needs:\n * `slots.renderPart` takes ONE part and may return `undefined` to fall through\n * to the package's own renderer. So:\n \n - a tool with NOTHING registered → the slot returns `undefined` and the\n * reader gets lane 2A's chip, byte for byte. Zero divergence on the path\n * every tool takes today.\n * - a tool WITH a renderer → this card, which keeps the chip's markup, its\n * state vocabulary and its expand behaviour, and swaps only the body.\n \n ✅ DEVIATION CLOSED AT THE LANE MERGE. This card used to carry its own copy\n * of the chip's header — ~20 duplicated lines, kept honest only by a test that\n * compared the two state tables. Lane 2A's chip now takes a `body` prop, so\n * this component IS that chip with a body passed in. There is one header, one\n * state table, one expand behaviour, and drift is no longer possible rather\n * than merely detectable.\n /\n\nimport { type ReactNode } from \"react\";\n\nimport type { ChatPart, ChatToolPart, ChatToolState } from \"../../model\";\nimport type { ChatPartContext } from \"../transcript/slots\";\nimport { CHAT_TOOL_STATE_LABEL, ChatToolChip } from \"../transcript/tool-chip\";\nimport { ChatToolGenericBody } from \"./generic-body\";\nimport {\n ChatToolBodyBoundary,\n type ChatToolRenderProps,\n type ChatToolRendererRegistry,\n} from \"./registry\";\n\n/\n The reader's words for each state — lane 2A's table, re-exported under the\n * name `/tools` publishes. Not a copy: the same object.\n /\nexport const TOOL_STATE_LABEL: Record<ChatToolState, string> = CHAT_TOOL_STATE_LABEL;\n\nconst TERMINAL: ReadonlySet<ChatToolState> = new Set<ChatToolState>([\n \"output-available\",\n \"output-error\",\n \"output-denied\",\n]);\n\nexport function toolRenderProps(part: ChatToolPart): ChatToolRenderProps {\n return {\n part,\n input: part.input,\n output: part.output,\n state: part.state,\n errorText: part.errorText,\n running: !TERMINAL.has(part.state),\n };\n}\n\nexport interface ChatToolCardProps {\n part: ChatToolPart;\n defaultExpanded: boolean;\n registry: ChatToolRendererRegistry;\n onRendererError?: ((error: Error) => void) \| undefined;\n}\n\nexport function ChatToolCard(props: ChatToolCardProps): ReactNode {\n const { part, registry } = props;\n const Renderer = registry.lookup(part.toolName);\n const renderProps = toolRenderProps(part);\n\n const body =\n Renderer === undefined ? (\n <ChatToolGenericBody {...renderProps} />\n ) : (\n <ChatToolBodyBoundary\n toolName={part.toolName}\n fallback={<ChatToolGenericBody {...renderProps} />}\n {...(props.onRendererError === undefined\n ? {}\n : { onError: props.onRendererError })}\n >\n <Renderer {...renderProps} />\n </ChatToolBodyBoundary>\n );\n\n return (\n <ChatToolChip\n part={part}\n defaultExpanded={props.defaultExpanded}\n body={body}\n rendererTag={Renderer === undefined ? \"generic\" : \"registered\"}\n />\n );\n}\n\n/\n Build the `renderPart` slot that mounts this registry.\n \n ```tsx\n * <ChatProvider thread={thread} slots={{ ...createToolRendererSlot(registry) }}>\n * ```\n \n Returning `undefined` for everything else is load-bearing: the transcript's\n * fall-through is what keeps a host's tool registry from silently blanking a\n * part type it never thought about.\n */\nexport function createToolRendererSlot(\n registry: ChatToolRendererRegistry,\n options: {\n defaultExpanded?: boolean \| undefined;\n onRendererError?: ((error: Error) => void) \| undefined;\n } = {},\n): {\n renderPart(part: ChatPart, context: ChatPartContext): ReactNode \| undefined;\n} {\n return {\n renderPart(part) {\n if (part.type !== \"tool\") return undefined;\n if (registry.lookup(part.toolName) === undefined) return undefined;\n return (\n <ChatToolCard\n part={part}\n registry={registry}\n defaultExpanded={options.defaultExpanded ?? false}\n {...(options.onRendererError === undefined\n ? {}\n : { onRendererError: options.onRendererError })}\n />\n );\n },\n };\n}\n"],"mappings":"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","names":["jsx","jsxs","useState","useEffect","useMemo","useRef","useState","jsx","jsx","Fragment","jsx","jsxs","useState","beat","jsx"]}
1	+ {"version":3,"sources":["../src/compat/react/tools/registry.tsx","../src/compat/react/tools/generic-body.tsx","../src/compat/react/transcript/tool-chip.tsx","../src/compat/react/hooks.ts","../src/compat/react/provider.tsx","../src/compat/react/composer/content-default.tsx","../src/compat/react/composer/markdown.tsx","../src/compat/react/composer/files.ts","../src/compat/react/ports.ts","../src/compat/react/icons.tsx","../src/compat/react/tools/card.tsx"],"sourcesContent":["/*\n THE TOOL-RENDERER REGISTRY — `@ai-matrx/chat/tools`, lane 2B.\n \n Ported from `matrx-extend/src/features/chat/tool-display/`, which is the best\n * tool-call UI on the platform (93 registered tools, ~3,900 lines) and the\n * reason the design names it the port source. What is taken is its SHAPE and\n * the two decisions it earned the hard way:\n \n 1. Exact-name lookup, one map, two tiers. A component for a tool that\n * needs one; a declarative description for the ninety that do not. A\n * `switch` on tool name scattered through a transcript is the defect the\n * canonical-chat guard exists to catch.\n * 2. *A registered renderer that throws DEGRADES, it does not take the\n transcript down.** Extend wraps every custom render in an error boundary\n * whose fallback is the generic row. A tool card is the least trustworthy\n * component in a chat — it renders arbitrary server JSON — so its failure\n * must cost the reader one card, never the answer they were reading.\n \n WHAT IS NOT TAKEN: its 93 Chrome-specific entries (they are content, not\n * code, and they belong to that surface), its `@/lib/utils`/Zustand coupling,\n * and its header. A renderer here replaces the chip's BODY. The chip, its\n * header and the kernel's state machine are lane 2A's and stay exactly as they\n * are — a registry entry is a richer body, not a second card.\n /\n\nimport { Component, type ComponentType, type ErrorInfo, type ReactNode } from \"react\";\n\nimport type { ChatToolPart, ChatToolState } from \"../../model\";\n\n/* What a tool renderer is handed. Everything it could need, nothing host-shaped. /\nexport interface ChatToolRenderProps {\n part: ChatToolPart;\n /* `part.input`, hoisted because it is what 90% of renderers read first. /\n input: unknown;\n output: unknown;\n state: ChatToolState;\n /* Present only in `output-error`. /\n errorText: string \| null;\n /* True while the call has not reached a terminal state. /\n running: boolean;\n}\n\nexport type ChatToolRenderer = ComponentType<ChatToolRenderProps>;\n\nexport interface ChatToolRendererRegistry {\n register(toolName: string, renderer: ChatToolRenderer): void;\n /* Register the same renderer under several server names (`web`, `web_search`). /\n registerAll(toolNames: readonly string[], renderer: ChatToolRenderer): void;\n lookup(toolName: string): ChatToolRenderer \| undefined;\n /* Every registered name, sorted. The census a guard can read. /\n names(): string[];\n}\n\nexport function createToolRendererRegistry(\n seed: Readonly<Record<string, ChatToolRenderer>> = {},\n): ChatToolRendererRegistry {\n const map = new Map<string, ChatToolRenderer>(Object.entries(seed));\n return {\n register(toolName, renderer) {\n map.set(toolName, renderer);\n },\n registerAll(toolNames, renderer) {\n for (const name of toolNames) map.set(name, renderer);\n },\n lookup(toolName) {\n return map.get(toolName);\n },\n names() {\n return [...map.keys()].sort();\n },\n };\n}\n\n/\n THE BOUNDARY. A renderer that throws costs the reader one BODY, and the\n * fallback is the generic body — which by construction cannot itself fail.\n * The failure is also REPORTED, with the tool's name, because a card that\n * quietly degrades for a week is a defect nobody ever sees.\n /\nexport class ChatToolBodyBoundary extends Component<\n {\n toolName: string;\n fallback: ReactNode;\n onError?: ((error: Error, info: ErrorInfo) => void) \| undefined;\n children: ReactNode;\n },\n { failed: boolean }\n> {\n override state = { failed: false };\n\n static getDerivedStateFromError(): { failed: boolean } {\n return { failed: true };\n }\n\n override componentDidCatch(error: Error, info: ErrorInfo): void {\n this.props.onError?.(error, info);\n }\n\n override render(): ReactNode {\n if (this.state.failed) {\n return (\n <div className=\"mx-chat-tool__body\" data-mx-chat-tool-body=\"degraded\">\n <span className=\"mx-chat-standin\">\n {`The custom view for ${this.props.toolName} could not be drawn, so this is the plain version of what it did.`}\n </span>\n {this.props.fallback}\n </div>\n );\n }\n return this.props.children;\n }\n}\n","/\n THE GENERIC TOOL BODY — the floor that can never fail.\n \n Every branch here is defensive on purpose. This renders arbitrary JSON that a\n * model asked a server to produce: it can be a 4 MB string, a cyclic object, a\n * BigInt, `undefined`, or an array of nulls. The extend registry's default row\n * is the reference, and its two survival rules are kept verbatim in spirit:\n \n - `JSON.stringify` is ALWAYS inside a try/catch, falling back to `String()`.\n * A cycle or a BigInt throws, and an uncaught throw here is a blank\n * transcript.\n * - a long payload is CLIPPED VISUALLY (a scrolling `<pre>`), not truncated\n * silently. A reader who is shown 80 of 4,000 characters with no sign that\n * there are more has been lied to; when this body does cut a string it says\n * how much it cut.\n \n It also produces the one-line summary the extend row leads with — the first\n * recognisable field (`url`, `query`, `text`, `question`, `reason`, `path`,\n * `selector`), or the first few keys — because a chip that says only\n * \"web_search: Running\" tells a reader watching their money being spent\n * nothing at all.\n /\n\nimport type { ReactNode } from \"react\";\n\nimport { formatCount } from \"@ai-matrx/kit/format\";\n\nimport type { ChatToolRenderProps } from \"./registry\";\n\n/* Above this many characters a payload is cut, and the cut is NAMED. /\nexport const PAYLOAD_CLIP_CHARS = 20_000;\n\nexport function safeStringify(value: unknown): string {\n if (value === undefined) return \"\";\n if (typeof value === \"string\") return value;\n try {\n const out = JSON.stringify(value, null, 2);\n return out === undefined ? String(value) : out;\n } catch {\n // A cycle, a BigInt, a getter that throws — the payload still has to say\n // something, and `String()` cannot throw for these.\n try {\n return String(value);\n } catch {\n return \"(this value cannot be displayed)\";\n }\n }\n}\n\nexport function summarizeToolInput(input: unknown): string \| null {\n if (input === null \|\| input === undefined) return null;\n if (typeof input === \"string\") return clipLine(input);\n if (typeof input !== \"object\") return String(input);\n if (Array.isArray(input)) return `${input.length} item${input.length === 1 ? \"\" : \"s\"}`;\n const record = input as Record<string, unknown>;\n for (const key of [\"url\", \"query\", \"q\", \"text\", \"question\", \"reason\", \"path\", \"selector\", \"name\"]) {\n const value = record[key];\n if (typeof value === \"string\" && value !== \"\") return clipLine(value);\n }\n const keys = Object.keys(record);\n if (keys.length === 0) return null;\n return keys.slice(0, 3).join(\", \");\n}\n\nfunction clipLine(text: string): string {\n return text.length > 96 ? `${text.slice(0, 96)}…` : text;\n}\n\n/ ------------------------------------------------- the shape-detected tier -- /\n\nexport interface ToolResultLink {\n title: string;\n url: string;\n snippet: string \| null;\n}\n\n/\n THE ONE UPGRADE OVER RAW JSON THAT NEEDS NO TOOL NAME.\n \n Most of extend's 93 entries exist to turn one shape — a list of results with\n * a title and a URL — into something a person can click. That shape is\n * recognisable from the VALUE, so the package gets the benefit for every tool\n * that has ever returned it, including tools nobody has registered and tools\n * that do not exist yet. A registry entry keyed on a tool name can only ever\n * help the tools someone remembered to name.\n \n It is deliberately strict: every element must carry a http(s) URL and a\n * non-empty title, or the whole thing falls back to JSON. A half-detected list\n * that drops the fields it did not understand is worse than the JSON.\n /\nexport function detectResultLinks(value: unknown): ToolResultLink[] \| null {\n const candidate = Array.isArray(value)\n ? value\n : value !== null && typeof value === \"object\"\n ? ([\"results\", \"items\", \"links\", \"sources\"] as const)\n .map((key) => (value as Record<string, unknown>)[key])\n .find((entry) => Array.isArray(entry))\n : undefined;\n if (!Array.isArray(candidate) \|\| candidate.length === 0) return null;\n\n const links: ToolResultLink[] = [];\n for (const entry of candidate) {\n if (entry === null \|\| typeof entry !== \"object\" \|\| Array.isArray(entry)) return null;\n const record = entry as Record<string, unknown>;\n const url = record[\"url\"] ?? record[\"link\"] ?? record[\"href\"];\n const title = record[\"title\"] ?? record[\"name\"] ?? record[\"heading\"];\n if (typeof url !== \"string\" \|\| !/^https?:\\/\\//i.test(url)) return null;\n if (typeof title !== \"string\" \|\| title.trim() === \"\") return null;\n const snippet = record[\"snippet\"] ?? record[\"description\"] ?? record[\"summary\"];\n links.push({\n title,\n url,\n snippet: typeof snippet === \"string\" && snippet !== \"\" ? snippet : null,\n });\n }\n return links;\n}\n\nfunction ResultLinks(props: { links: readonly ToolResultLink[] }): ReactNode {\n return (\n <ul className=\"mx-chat-tool__links\">\n {props.links.map((link, index) => (\n <li key={`${link.url}-${index}`}>\n <a href={link.url} target=\"_blank\" rel=\"noreferrer noopener\">\n {link.title}\n </a>\n {link.snippet === null ? null : (\n <span className=\"mx-chat-tool__snippet\">{link.snippet}</span>\n )}\n </li>\n ))}\n </ul>\n );\n}\n\nfunction Payload(props: { label: string; value: unknown }): ReactNode {\n const body = safeStringify(props.value);\n if (body === \"\") return null;\n const clipped = body.length > PAYLOAD_CLIP_CHARS;\n return (\n <>\n <span className=\"mx-chat-tool__label\">{props.label}</span>\n <pre className=\"mx-chat-tool__payload\">\n {clipped ? body.slice(0, PAYLOAD_CLIP_CHARS) : body}\n </pre>\n {clipped ? (\n <span className=\"mx-chat-standin\">\n {`Showing the first ${formatCount(PAYLOAD_CLIP_CHARS)} characters of ${formatCount(body.length)}.`}\n </span>\n ) : null}\n </>\n );\n}\n\n/\n The body a tool gets when nothing is registered for it, and the fallback\n * when a registered renderer throws.\n /\nexport function ChatToolGenericBody(props: ChatToolRenderProps): ReactNode {\n const summary = summarizeToolInput(props.input);\n const links = detectResultLinks(props.output);\n const hasAnything =\n summary !== null \|\|\n props.input !== undefined \|\|\n props.output !== undefined \|\|\n props.errorText !== null \|\|\n props.part.progress.length > 0;\n\n return (\n <div className=\"mx-chat-tool__body\" data-mx-chat-tool-body=\"generic\">\n {summary === null ? null : (\n <p className=\"mx-chat-tool__summary\">{summary}</p>\n )}\n\n <Payload label=\"What it was asked\" value={props.input} />\n\n {props.part.progress.length > 0 ? (\n <>\n <span className=\"mx-chat-tool__label\">Progress</span>\n <ul className=\"mx-chat-tool__progress\">\n {props.part.progress.map((beat, index) => (\n <li key={`${beat.toolName}-${index}`}>\n {/ The SERVER's name per beat: it differs from the call's name\n mid-run, and flattening them loses what actually ran. /}\n <span data-tool-beat={beat.toolName}>{beat.toolName}</span>\n {beat.message === \"\" ? null : ` — ${beat.message}`}\n {beat.percent === null ? null : ` (${Math.round(beat.percent)}%)`}\n </li>\n ))}\n </ul>\n </>\n ) : null}\n\n {props.errorText === null ? null : (\n <>\n <span className=\"mx-chat-tool__label\">What went wrong</span>\n <p className=\"mx-chat-failure__sentence\">{props.errorText}</p>\n </>\n )}\n\n {links === null ? (\n <Payload label=\"What it returned\" value={props.output} />\n ) : (\n <>\n <span className=\"mx-chat-tool__label\">What it found</span>\n <ResultLinks links={links} />\n </>\n )}\n\n {hasAnything ? null : (\n <span className=\"mx-chat-standin\">\n {props.running\n ? \"This tool has not said what it is doing yet.\"\n : \"This tool ran without reporting any details.\"}\n </span>\n )}\n </div>\n );\n}\n","/\n THE BASIC TOOL CHIP — the transcript's floor for a tool call.\n \n It is driven entirely by the kernel's tool state machine\n * (`input-streaming → input-available → approval-requested → output-available \|\n * output-error \| output-denied`), which is the champion's vocabulary and which\n * the live corpus already walks: `tool_started` with arguments, three\n * `tool_progress` beats under three DIFFERENT tool names, then `tool_completed`\n * with the result.\n \n Three things it refuses to do, each a real failure seen in the wild:\n * - it never shows a bare spinner with no name. A reader watching an agent\n * spend their money is owed the tool's name and what it is doing.\n * - it never drops the progress beats, and it keeps the SERVER's tool name per\n * beat (`web` → `web_search` → `web_research`); flattening them to the\n * call's name loses what actually ran.\n * - it never renders an error state as \"Done\".\n \n Lane 2B's `/tools` registry replaces this chip's BODY with a per-tool\n * renderer. The chip, its state machine and its header stay — a registry entry\n * is a richer body, not a second card. That is the `body` prop below: at the\n * lane merge `<ChatToolCard>` stopped carrying its own copy of this header and\n * became this chip with a body passed in, so the two can no longer drift in\n * markup, in state words, or in expand behaviour.\n /\n\nimport { useState, type ReactNode } from \"react\";\n\nimport type { ChatToolPart, ChatToolState } from \"../../model\";\nimport { useChatPorts } from \"../hooks\";\nimport { ChevronRightGlyph } from \"../icons\";\n\n/\n What the state means to a READER, not to a protocol. THE ONE TABLE: `/tools`\n * re-exports this rather than restating it, because a tool that reads \"Done\" in\n * one card and \"Completed\" in another is drift nobody notices for a month.\n /\nexport const CHAT_TOOL_STATE_LABEL: Record<ChatToolState, string> = {\n \"input-streaming\": \"Preparing\",\n \"input-available\": \"Running\",\n \"approval-requested\": \"Needs your approval\",\n \"output-available\": \"Done\",\n \"output-error\": \"Failed\",\n \"output-denied\": \"Declined\",\n};\n\nfunction formatPayload(value: unknown): string {\n if (value === undefined) return \"\";\n if (typeof value === \"string\") return value;\n try {\n return JSON.stringify(value, null, 2);\n } catch {\n // A payload with a cycle or a BigInt still has to say something.\n return String(value);\n }\n}\n\nexport interface ChatToolChipProps {\n part: ChatToolPart;\n /* From `features.expandToolCardsByDefault`. /\n defaultExpanded: boolean;\n /\n Replace what the chip shows when it is open. This is the ONE seam `/tools`\n * uses: a registered renderer is a richer BODY under the same header, the\n * same state words and the same expand behaviour — never a second card.\n * Absent ⇒ the chip's own body (arguments, progress beats, error, result).\n /\n body?: ReactNode \| undefined;\n /* Diagnostic marker for the surrounding element, e.g. which renderer drew\n * the body. Read by tests and by the census; never shown to a reader. /\n rendererTag?: string \| undefined;\n}\n\nexport function ChatToolChip(props: ChatToolChipProps): ReactNode {\n const { part, defaultExpanded, body } = props;\n const [expanded, setExpanded] = useState(defaultExpanded);\n\n const { toolLabel } = useChatPorts();\n const latest = part.progress[part.progress.length - 1];\n const input = formatPayload(part.input);\n const output = formatPayload(part.output);\n const stateLabel = CHAT_TOOL_STATE_LABEL[part.state];\n // THE HEADER SAYS EACH THING ONCE. Servers send a completion beat whose\n // whole content is the word the state column already carries (\"Done\"), and\n // the chip read \"Done Done\" in front of a Creator (live review 2026-09-18).\n // The beat is not thrown away — it stays in the body, under Progress.\n const beat =\n latest !== undefined &&\n latest.message !== \"\" &&\n latest.message.trim().toLowerCase() !== stateLabel.toLowerCase()\n ? latest.message\n : null;\n const hasBody =\n input !== \"\" \|\| output !== \"\" \|\| part.errorText !== null \|\| part.progress.length > 0;\n\n return (\n <div\n className=\"mx-chat-tool\"\n data-state={part.state}\n data-tool={part.toolName}\n {...(props.rendererTag === undefined\n ? {}\n : { \"data-mx-chat-tool-renderer\": props.rendererTag })}\n >\n <button\n type=\"button\"\n className=\"mx-chat-tool__header mx-chat-focusable\"\n aria-expanded={expanded}\n // A chip with nothing to show still toggles rather than sitting there\n // looking disabled (Law 4) — it says so in the body instead.\n onClick={() => setExpanded((open) => !open)}\n >\n <span data-open={expanded} className=\"mx-chat-chevron-wrap\">\n <ChevronRightGlyph />\n </span>\n {/ WHAT IS HAPPENING, never the identifier — `toolLabel` is the port\n and `data-tool` above keeps the machine name for the machines. /}\n <span className=\"mx-chat-tool__name\">{toolLabel(part.toolName)}</span>\n {beat === null ? null : <span className=\"mx-chat-tool__beat\">{beat}</span>}\n <span className=\"mx-chat-tool__state\">{stateLabel}</span>\n </button>\n\n {expanded ? (\n body !== undefined ? (\n body\n ) : (\n <div className=\"mx-chat-tool__body\">\n {input !== \"\" ? (\n <>\n <span className=\"mx-chat-tool__label\">What it was asked</span>\n <pre className=\"mx-chat-tool__payload\">{input}</pre>\n </>\n ) : null}\n\n {part.progress.length > 0 ? (\n <>\n <span className=\"mx-chat-tool__label\">Progress</span>\n <ul className=\"mx-chat-tool__progress\">\n {part.progress.map((beat, index) => (\n <li key={`${beat.toolName}-${index}`}>\n <span data-tool-beat={beat.toolName}>{beat.toolName}</span>\n {beat.message === \"\" ? null : ` — ${beat.message}`}\n {beat.percent === null ? null : ` (${Math.round(beat.percent)}%)`}\n </li>\n ))}\n </ul>\n </>\n ) : null}\n\n {part.errorText !== null ? (\n <>\n <span className=\"mx-chat-tool__label\">What went wrong</span>\n <p className=\"mx-chat-failure__sentence\">{part.errorText}</p>\n </>\n ) : null}\n\n {output !== \"\" ? (\n <>\n <span className=\"mx-chat-tool__label\">What it returned</span>\n <pre className=\"mx-chat-tool__payload\">{output}</pre>\n </>\n ) : null}\n\n {hasBody ? null : (\n <span className=\"mx-chat-standin\">\n {part.state === \"input-streaming\"\n ? \"This tool has not said what it is doing yet.\"\n : \"This tool ran without reporting any details.\"}\n </span>\n )}\n </div>\n )\n ) : null}\n </div>\n );\n}\n","/\n THE BASE HOOKS — shared scaffolding, layer 3 of the design.\n \n All four read the kernel through `useSyncExternalStore`, which is the shape\n * the champion (`@ai-sdk/react`) proved and the reason the store was written as\n * `getSnapshot`/`subscribe` in phase 1. Nothing here holds a second copy of\n * thread state: a hook that mirrors the store into `useState` tears under\n * concurrent rendering and drifts the moment the host mutates the store from\n * outside React.\n \n `useChatMessage(id)` is the performance seam that makes a 2,000-token answer\n * possible: it subscribes to ONE message, so a streaming bubble re-renders\n * while the other 200 rows do not.\n /\n\nimport {\n useCallback,\n useEffect,\n useMemo,\n useRef,\n useState,\n useSyncExternalStore,\n type KeyboardEvent as ReactKeyboardEvent,\n} from \"react\";\n\nimport type { ChatFeatures } from \"../config\";\nimport type { ChatMessage, ChatThreadSnapshot } from \"../model\";\nimport { messageText } from \"../model\";\nimport type { ChatSendResult } from \"../store\";\nimport { useChatContext } from \"./provider\";\nimport type { ChatReactPorts } from \"./ports\";\nimport type { ChatSlots } from \"./slots\";\n\nexport interface UseChatThreadResult {\n snapshot: ChatThreadSnapshot;\n messages: readonly ChatMessage[];\n status: ChatThreadSnapshot[\"status\"];\n /* True while a turn is in flight — the ONE test a stop button uses. /\n isBusy: boolean;\n conversationId: string \| null;\n ephemeral: boolean;\n ephemeralReason: string \| null;\n error: ChatThreadSnapshot[\"error\"];\n send(text: string, fileIds?: readonly string[]): Promise<ChatSendResult>;\n cancel(): Promise<void>;\n}\n\n/* The whole thread. Use `useChatMessage` for a row — not this. /\nexport function useChatThread(): UseChatThreadResult {\n const { thread } = useChatContext();\n const snapshot = useSyncExternalStore(\n thread.subscribe,\n thread.getSnapshot,\n thread.getSnapshot,\n );\n\n const send = useCallback(\n (text: string, fileIds?: readonly string[]) =>\n thread.send(fileIds === undefined ? { text } : { text, fileIds }),\n [thread],\n );\n const cancel = useCallback(() => thread.cancel(), [thread]);\n\n return useMemo(\n () => ({\n snapshot,\n messages: snapshot.messages,\n status: snapshot.status,\n isBusy: snapshot.status === \"submitted\" \|\| snapshot.status === \"streaming\",\n conversationId: snapshot.conversationId,\n ephemeral: snapshot.ephemeral,\n ephemeralReason: snapshot.ephemeralReason,\n error: snapshot.error,\n send,\n cancel,\n }),\n [snapshot, send, cancel],\n );\n}\n\n/\n ONE message, on its own subscription.\n \n Returns `undefined` for an id the thread does not hold — a row that was\n * removed while its component was unmounting is ordinary, not an error.\n /\nexport function useChatMessage(messageId: string): ChatMessage \| undefined {\n const { thread } = useChatContext();\n\n const subscribe = useCallback(\n (listener: () => void) => thread.subscribeToMessage(messageId, listener),\n [thread, messageId],\n );\n const getSnapshot = useCallback(\n () => thread.getMessageSnapshot(messageId),\n [thread, messageId],\n );\n\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\n/* The resolved knobs (platform → org → surface → user), from the kernel. /\nexport function useChatConfig(): ChatFeatures {\n return useChatContext().thread.features;\n}\n\n/* The React ports, each already defaulted by the provider. /\nexport function useChatPorts(): ChatReactPorts {\n return useChatContext().ports;\n}\n\n/* The slot map. Empty object when the host passed none. /\nexport function useChatSlots(): ChatSlots {\n return useChatContext().slots;\n}\n\nexport interface UseChatComposerStateResult {\n text: string;\n setText(next: string): void;\n /* False when the box is blank, or while a turn is in flight unless\n * `features.sendWhileBusy` (the host queues). /\n canSend: boolean;\n isBusy: boolean;\n send(): Promise<ChatSendResult \| null>;\n stop(): Promise<void>;\n /\n The keyboard contract, decided by `features.sendKey`: Enter sends and\n * Shift+Enter newlines, or Cmd/Ctrl+Enter sends and Enter newlines. Esc\n * ALWAYS stops a running answer. Wire this to the input's `onKeyDown`.\n /\n onKeyDown(event: ReactKeyboardEvent): void;\n /* True when a failed turn just handed its words back. Clears on the next\n * edit, so a composer can flash the box once without it sticking. /\n restoredFromFailure: boolean;\n}\n\nconst DRAFT_PREFIX = \"ai-matrx.chat.draft.\";\n\n/\n COMPOSER STATE — the logic half, with no opinion about pixels.\n \n Lane 2B renders this. It lives in shared scaffolding rather than in 2B\n * because 2A needs one half of it TODAY: a failed turn's \"Try again\" hands the\n * reader's unsent words back through the retry bus, and there has to be exactly\n * one place that catches them. Two sources of composer state is how a draft\n * gets lost.\n \n Drafts survive reload when `features.retainDrafts` is on, keyed per\n * conversation, through the `prefs` port — which already announces itself when\n * it is memory-only.\n /\nexport function useChatComposerState(): UseChatComposerStateResult {\n const { thread, ports, retry } = useChatContext();\n const features = thread.features;\n const snapshot = useSyncExternalStore(\n thread.subscribe,\n thread.getSnapshot,\n thread.getSnapshot,\n );\n const conversationId = snapshot.conversationId;\n const isBusy = snapshot.status === \"submitted\" \|\| snapshot.status === \"streaming\";\n\n const draftKey = `${DRAFT_PREFIX}${conversationId ?? \"new\"}`;\n const [text, setTextState] = useState<string>(() =>\n features.retainDrafts ? (ports.prefs.get(draftKey) ?? \"\") : \"\",\n );\n const [restoredFromFailure, setRestored] = useState(false);\n\n // The draft key changes when the conversation does — including the moment a\n // NEW conversation learns its server id mid-send. Carrying the in-progress\n // text across that rename is the difference between a draft that survives and\n // one that vanishes the first time someone types during the first turn.\n const keyRef = useRef(draftKey);\n useEffect(() => {\n if (keyRef.current === draftKey) return;\n const previousKey = keyRef.current;\n keyRef.current = draftKey;\n if (!features.retainDrafts) return;\n const carried = ports.prefs.get(previousKey);\n if (carried !== null && carried !== \"\") {\n ports.prefs.set(draftKey, carried);\n ports.prefs.remove(previousKey);\n setTextState(carried);\n return;\n }\n setTextState(ports.prefs.get(draftKey) ?? \"\");\n }, [draftKey, features.retainDrafts, ports.prefs]);\n\n const setText = useCallback(\n (next: string) => {\n setTextState(next);\n setRestored(false);\n if (!features.retainDrafts) return;\n if (next === \"\") ports.prefs.remove(keyRef.current);\n else ports.prefs.set(keyRef.current, next);\n },\n [features.retainDrafts, ports.prefs],\n );\n\n // Catch the words a failed turn hands back. Registered here and NOWHERE else,\n // so \"Try again\" has exactly one destination.\n useEffect(\n () =>\n retry.subscribe((restored) => {\n setTextState(restored);\n setRestored(true);\n if (features.retainDrafts) ports.prefs.set(keyRef.current, restored);\n }),\n [retry, features.retainDrafts, ports.prefs],\n );\n\n const send = useCallback(async (): Promise<ChatSendResult \| null> => {\n const body = text.trim();\n if (body === \"\" \|\| (isBusy && !features.sendWhileBusy)) return null;\n // The box is cleared OPTIMISTICALLY and the draft with it; if the kernel\n // refuses the send, the words come straight back rather than being lost.\n setTextState(\"\");\n setRestored(false);\n if (features.retainDrafts) ports.prefs.remove(keyRef.current);\n const result = await thread.send({ text: body });\n if (!result.accepted) {\n setTextState(body);\n if (features.retainDrafts) ports.prefs.set(keyRef.current, body);\n }\n return result;\n }, [text, isBusy, thread, features.retainDrafts, features.sendWhileBusy, ports.prefs]);\n\n const stop = useCallback(() => thread.cancel(), [thread]);\n\n const onKeyDown = useCallback(\n (event: ReactKeyboardEvent) => {\n if (event.key === \"Escape\") {\n if (!isBusy) return;\n event.preventDefault();\n void thread.cancel();\n return;\n }\n if (event.key !== \"Enter\") return;\n const withModifier = event.metaKey \|\| event.ctrlKey;\n const sends =\n features.sendKey === \"enter\"\n ? !event.shiftKey && !withModifier\n : withModifier;\n if (!sends) return;\n event.preventDefault();\n void send();\n },\n [features.sendKey, isBusy, send, thread],\n );\n\n return {\n text,\n setText,\n canSend: text.trim() !== \"\" && (!isBusy \|\| features.sendWhileBusy),\n isBusy,\n send,\n stop,\n onKeyDown,\n restoredFromFailure,\n };\n}\n\n/\n The text of the user turn that produced a given assistant message — what\n * \"Try again\" hands back. Exported because 2B's composer and 2A's failure card\n * must agree on what \"the unsent text\" means.\n /\nexport function precedingUserText(\n messages: readonly ChatMessage[],\n messageId: string,\n): string {\n const index = messages.findIndex((message) => message.id === messageId);\n if (index <= 0) return \"\";\n for (let cursor = index - 1; cursor >= 0; cursor -= 1) {\n const candidate = messages[cursor];\n if (candidate && candidate.role === \"user\") return messageText(candidate);\n }\n return \"\";\n}\n","/\n `<ChatProvider>` — the ONE context every lane reads. Shared scaffolding.\n \n It carries three things and decides nothing else:\n * 1. THE THREAD STORE — the kernel's `ChatThreadStore`, or anything else with\n * that shape, which is exactly what `@ai-matrx/chat/external-store`\n * returns. That is why the prop is typed as the store interface and not as\n * a config object: a host whose state already lives in Redux or behind an\n * MV3 relay mounts the SAME provider, and the strangler in design §9 works\n * because of this one line.\n * 2. THE REACT PORTS — `renderContent`, `notifier`, `prefs`, `files` and\n * `voice`, each with a working default (THE ALL-INCLUSIVE LAW). The\n * `renderContent` default is the REAL one — `createChatContentRenderer`,\n * markdown plus content-IR kind routing — not the plain-text floor. A host\n * that mounts nothing gets formatted answers, which is what \"drop-in\"\n * means; `createPlainTextContentRenderer` stays exported as the\n * zero-dependency floor for a host that cannot take content-ir at all.\n * 3. THE SLOTS — the per-lane slot map.\n \n The knobs are NOT carried here: they are resolved in the kernel and read off\n * `thread.features`, so a knob has one resolution site and a host cannot end up\n * with a composer that thinks Enter sends and a transcript that does not.\n /\n\nimport {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n type ReactNode,\n} from \"react\";\n\nimport type { ChatThreadStore } from \"../store\";\nimport type { ChatNotifierPort } from \"../ports\";\nimport { createConsoleNotifier, createWebPrefs } from \"../ports\";\nimport { createChatContentRenderer } from \"./composer/content-default\";\nimport { createUnavailableFilesPort } from \"./composer/files\";\nimport type { ChatReactPortOverrides, ChatReactPorts } from \"./ports\";\nimport { humanizeToolName } from \"./ports\";\nimport type { ChatSlots } from \"./slots\";\n\n/\n THE RETRY BUS.\n \n A failed turn's \"Try again\" must hand the reader's unsent words BACK to the\n * composer — retyping a paragraph the product lost is the cheapest possible\n * insult. The transcript (2A) and the composer (2B) are different lanes and\n * different components, so the handoff is a tiny subscribable rather than a\n * prop drilled between them.\n \n It is also the reason this is not a plain callback: when NOTHING is listening\n * — a transcript mounted with no composer, which is a legitimate embedding —\n * the words would vanish silently. Instead the bus says so, with the remedy.\n /\nexport interface ChatRetryBus {\n /* Hand text back to the composer. Returns false when nobody took it. /\n request(text: string): boolean;\n subscribe(listener: (text: string) => void): () => void;\n}\n\nexport function createChatRetryBus(notifier: ChatNotifierPort): ChatRetryBus {\n const listeners = new Set<(text: string) => void>();\n return {\n request(text) {\n if (listeners.size === 0) {\n notifier.notify({\n level: \"warning\",\n message:\n \"There is nowhere to put your message back, so it has not been restored for you.\",\n remedy:\n \"Copy your message from the conversation above and send it again, or mount this transcript inside a chat that has a message box.\",\n });\n return false;\n }\n for (const listener of listeners) listener(text);\n return true;\n },\n subscribe(listener) {\n listeners.add(listener);\n return () => {\n listeners.delete(listener);\n };\n },\n };\n}\n\nexport interface ChatContextValue {\n thread: ChatThreadStore;\n ports: ChatReactPorts;\n slots: ChatSlots;\n retry: ChatRetryBus;\n}\n\nconst ChatContext = createContext<ChatContextValue \| null>(null);\n\nexport interface ChatProviderProps {\n /\n The kernel store (`createChatThread`) or a host-owned source\n * (`createExternalThreadSource`). Both satisfy this interface — that is the\n * whole point of the interface.\n /\n thread: ChatThreadStore;\n ports?: ChatReactPortOverrides \| undefined;\n slots?: ChatSlots \| undefined;\n children: ReactNode;\n}\n\nexport function ChatProvider(props: ChatProviderProps): ReactNode {\n const { thread, ports, slots, children } = props;\n\n // The defaults are built ONCE per provider, not per render: the plain-text\n // renderer holds an \"already announced\" flag and the prefs port probes\n // localStorage,\n // and rebuilding either per render would re-announce forever and re-probe on\n // every keystroke.\n const [defaults] = useState(() => {\n const notifier = createConsoleNotifier();\n return { notifier, prefs: createWebPrefs(notifier) };\n });\n\n const notifier = ports?.notifier ?? defaults.notifier;\n\n // The retry bus AND the default content renderer are both keyed to the\n // EFFECTIVE notifier, not to the fallback one. A host that injects a notifier\n // and then never hears \"your markdown is not being formatted\" or \"there is\n // nowhere to put your message back\" has a silent failure the injection was\n // supposed to prevent — that is the bug this keying exists to stop.\n const keyedRef = useRef<{\n notifier: ChatNotifierPort;\n bus: ChatRetryBus;\n renderContent: ChatReactPorts[\"renderContent\"];\n files: ChatReactPorts[\"files\"];\n } \| null>(null);\n if (keyedRef.current === null \|\| keyedRef.current.notifier !== notifier) {\n keyedRef.current = {\n notifier,\n bus: createChatRetryBus(notifier),\n renderContent: createChatContentRenderer({ notifier }),\n // The stand-in holds an \"already announced\" flag, so it is built ONCE:\n // rebuilding it per render would re-refuse out loud on every keystroke.\n files: createUnavailableFilesPort(notifier),\n };\n }\n const retry = keyedRef.current.bus;\n const defaultRenderContent = keyedRef.current.renderContent;\n const defaultFiles = keyedRef.current.files;\n\n const value = useMemo<ChatContextValue>(\n () => ({\n thread,\n ports: {\n renderContent: ports?.renderContent ?? defaultRenderContent,\n notifier,\n prefs: ports?.prefs ?? defaults.prefs,\n files: ports?.files ?? defaultFiles,\n // `null` is a REAL answer here (\"this surface has no voice\"), so it is\n // only defaulted when the key is absent entirely.\n voice: ports?.voice ?? null,\n toolLabel: ports?.toolLabel ?? humanizeToolName,\n // `null` is a REAL answer here too (\"this surface does not choose a\n // model\"), so it is only defaulted when the key is absent entirely —\n // and the default is nothing drawn, never a dead control.\n modelPicker: ports?.modelPicker ?? null,\n // Same rule: `null` is the real answer \"this surface offers no chips\",\n // and the control row is then ABSENT rather than an empty band.\n quickset: ports?.quickset ?? null,\n },\n slots: slots ?? {},\n retry,\n }),\n [\n thread,\n ports?.renderContent,\n ports?.prefs,\n ports?.files,\n ports?.voice,\n ports?.toolLabel,\n ports?.modelPicker,\n ports?.quickset,\n notifier,\n slots,\n retry,\n defaultRenderContent,\n defaultFiles,\n defaults.prefs,\n ],\n );\n\n // A thread the provider outlives must not keep its timers and its in-flight\n // turn running. The provider does NOT dispose a thread it did not create —\n // the host owns that lifecycle — but it does warn when a thread is swapped\n // mid-stream, because the abandoned turn keeps billing.\n const previous = useRef(thread);\n useEffect(() => {\n if (previous.current === thread) return;\n const status = previous.current.getSnapshot().status;\n if (status === \"streaming\" \|\| status === \"submitted\") {\n notifier.notify({\n level: \"warning\",\n message: \"The previous answer was still arriving when this chat switched conversations.\",\n remedy: \"Stop the answer before switching, or the run keeps going in the background.\",\n });\n }\n previous.current = thread;\n }, [thread, notifier]);\n\n return <ChatContext.Provider value={value}>{children}</ChatContext.Provider>;\n}\n\n/\n The context, or a THROWN error naming what is missing. A hook that returns a\n * silent `null` here produces a blank transcript with no explanation, which is\n * the failure mode Law 4 exists to close — and the stack trace is the remedy.\n /\nexport function useChatContext(): ChatContextValue {\n const value = useContext(ChatContext);\n if (value === null) {\n throw new Error(\n \"[@ai-matrx/chat] This component must be rendered inside <ChatProvider thread={…}>. Wrap your chat surface in one, passing a thread from createChatThread() or createExternalThreadSource().\",\n );\n }\n return value;\n}\n","/\n THE REAL `renderContent` DEFAULT — lane 2B, design §6.\n \n Two routes, one port:\n * - prose (`markdown` / `text`) → the package's safe markdown renderer,\n * incremental per message so a 2,000-token answer does not re-parse itself\n * 2,000 times;\n * - a render block (a content-IR kind) → `@ai-matrx/content-ir-react`'s\n * `KindInstanceRender`, the ONE door between \"I hold a kind-shaped value\"\n * and \"the reader sees it drawn properly\". Re-deriving kind routing here\n * would be a second renderer for the platform's kinds, which is banned.\n \n 🚨 THE PROVIDER-LESS CASE IS HONEST, NOT FATAL. `content-ir-react` THROWS\n * outside a `<ContentIrRenderProvider>` — correctly, for an app that meant to\n * mount one. But a chat dropped into a fresh Vite app has not mounted one, and\n * a thrown error there would take the whole transcript down over a single\n * block. So this renderer asks `useContentIrHostOrNull()` and, with no host,\n * renders the block's own text under ONE sentence naming what is missing and\n * how to fix it. Absent or honest — never a blank region, never a crash.\n \n This replaces `createPlainTextContentRenderer` as the shipped default a host\n * gets from `<ChatProvider>`. That stand-in stays exported: it is the zero-\n * dependency floor for a host that cannot take content-ir at all.\n /\n\nimport { useEffect, type ReactNode } from \"react\";\nimport { KindInstanceRender, useContentIrHostOrNull } from \"@ai-matrx/content-ir-react\";\n\nimport type { ChatNotifierPort } from \"../../ports\";\nimport { createConsoleNotifier } from \"../../ports\";\nimport type { ChatContentRequest, ChatRenderContentPort } from \"../ports\";\nimport { ChatMarkdown, createBlockCache, type MarkdownBlockCache } from \"./markdown\";\n\n/* The sentence a reader sees for a kind block with no content-IR host. /\nexport const NO_CONTENT_IR_HOST =\n \"This answer contains a structured block, and it is shown as plain text here because this app has not connected the content renderer.\";\nexport const NO_CONTENT_IR_HOST_REMEDY =\n \"Mount <ContentIrRenderProvider host={…}> from @ai-matrx/content-ir-react above your chat to draw structured blocks properly.\";\n\nfunction RenderBlock(props: {\n request: ChatContentRequest;\n cache: MarkdownBlockCache;\n notifier: ChatNotifierPort;\n announce(): void;\n}): ReactNode {\n const host = useContentIrHostOrNull();\n const announce = props.announce;\n useEffect(() => {\n if (host === null) announce();\n }, [host, announce]);\n\n if (host === null) {\n return (\n <div className=\"mx-chat-content\" data-mx-chat-content=\"block-standin\">\n <span className=\"mx-chat-standin\">{NO_CONTENT_IR_HOST}</span>\n <ChatMarkdown\n text={props.request.text}\n cacheKey={`${props.request.messageId}:${props.request.kind}`}\n cache={props.cache}\n />\n </div>\n );\n }\n\n return (\n <div className=\"mx-chat-content\" data-mx-chat-content=\"block\" data-kind={props.request.kind}>\n <KindInstanceRender\n kind={props.request.kind}\n value={props.request.data ?? props.request.text}\n variant=\"bare\"\n />\n </div>\n );\n}\n\nexport interface ChatContentRendererOptions {\n notifier?: ChatNotifierPort \| undefined;\n /* Share one cache across surfaces, or pass your own for a test. /\n cache?: MarkdownBlockCache \| undefined;\n}\n\n/\n Build the default renderer. The block cache is per-renderer, so two chats on\n * one page never share parsed blocks and a test never inherits another test's\n * cache.\n /\nexport function createChatContentRenderer(\n options: ChatContentRendererOptions = {},\n): ChatRenderContentPort {\n const notifier = options.notifier ?? createConsoleNotifier();\n const cache = options.cache ?? createBlockCache();\n // ONCE per renderer, not per block: a notice repeated per streamed frame is\n // noise, and noise is ignored.\n let announced = false;\n const announce = (): void => {\n if (announced) return;\n announced = true;\n notifier.notify({\n level: \"warning\",\n message: NO_CONTENT_IR_HOST,\n remedy: NO_CONTENT_IR_HOST_REMEDY,\n });\n };\n\n return function renderContent(request: ChatContentRequest): ReactNode {\n if (request.kind !== \"markdown\" && request.kind !== \"text\") {\n return (\n <RenderBlock\n request={request}\n cache={cache}\n notifier={notifier}\n announce={announce}\n />\n );\n }\n if (request.text === \"\") return null;\n return (\n <div className=\"mx-chat-content\" data-mx-chat-content=\"markdown\">\n <ChatMarkdown text={request.text} cacheKey={request.messageId} cache={cache} />\n </div>\n );\n };\n}\n","/\n THE SMALLEST MARKDOWN RENDERER THAT IS SAFE — lane 2B.\n \n 🚨 Read design §6 before growing this file. `matrx-frontend`'s\n * `components/mardown-display` is 108,271 lines and renders in agent apps,\n * workflows, notes, print and the studio. Absorbing it would triple this\n * package and violate C8 on its face. This is the PORT DEFAULT — the floor that\n * makes a fresh app correct with zero work — not a competitor to that tree. A\n * host with a richer pipeline injects it through `renderContent`.\n \n Three properties are non-negotiable, and each has a test that goes red alone:\n \n 1. NO RAW HTML, EVER. Model output is untrusted by construction. There is\n * no `dangerouslySetInnerHTML` in this file and there must never be one: a\n * chat package that injects model text as HTML ships a cross-site-scripting\n * hole to every consumer at once. Angle brackets are rendered as literal\n * text by React, which is the whole defence.\n * 2. LINK SCHEMES ARE ALLOWLISTED. `javascript:`, `data:` and `vbscript:`\n * hrefs are refused and the link degrades to its own text. A renderer that\n * only escapes HTML and then hands an anchor an arbitrary scheme has closed\n * one door and left the next one open.\n * 3. PARSING IS INCREMENTAL. A 2,000-token answer arrives as hundreds of\n * frames. Re-parsing the whole transcript per token is the classic failure\n * and the reason chats jank (design §7 rule 3). `createBlockCache()` keeps\n * the completed blocks of a growing string and re-parses ONLY the trailing\n * incomplete block.\n \n Reasoning is NOT handled here. The kernel already splits the platform's\n * `<reasoning>` span into its own part and the transcript draws it as an aside —\n * a markdown renderer that printed it as prose would undo that.\n /\n\nimport { Fragment, type ReactNode } from \"react\";\nimport { findTableEnd, rowCells, tableStartsAt, unescapeCellPipes } from \"@ai-matrx/content-ir/source\";\n\n/ ------------------------------------------------------------------ links -- /\n\n/\n The only schemes an anchor may carry. Everything else degrades to plain text.\n * `data:` is absent on purpose: `data:text/html` is a same-origin script vector.\n /\nconst SAFE_SCHEME = /^(https?:\|mailto:\|tel:)/i;\n/* A relative or anchor-local target a host page legitimately owns. /\nconst RELATIVE_TARGET = /^([./#?]\|[A-Za-z0-9_-]+\\/)/;\n\nexport function safeHref(raw: string): string \| null {\n const href = raw.trim();\n if (href === \"\") return null;\n if (SAFE_SCHEME.test(href)) return href;\n // A bare `foo:bar` with an unknown scheme is refused; a path is allowed.\n if (/^[A-Za-z][A-Za-z0-9+.-]:/.test(href)) return null;\n if (RELATIVE_TARGET.test(href)) return href;\n return null;\n}\n\n/** Images load only over http(s), lazily, and never leak the referrer. /\nfunction safeImageSource(raw: string): string \| null {\n const source = raw.trim();\n return /^https?:\\/\\//i.test(source) ? source : null;\n}\n\n/ ----------------------------------------------------------------- inline -- /\n\n/\n ONE pass, ordered by precedence: code span wins over everything (its body is\n * literal), then image, link, bold, italic, strikethrough, then a bare URL.\n \n Each alternative is a separate capture group so the branch is decided by\n * WHICH group matched, never by re-testing the slice — re-testing is how an\n * inline parser ends up quadratic on a long answer.\n /\n/\n 🚨 EVERY BODY IS BOUNDED, AND NONE OF THEM CROSSES A NEWLINE.\n \n This is not tidiness. The first version used `[\\s\\S]?` bodies, and the\n FIRST run against the live 9,313-character corpus answer took the test\n * runner out of memory: an unbounded lazy body matches across thousands of\n * characters, `renderInline` recurses into that whole span, and the span\n * matches again two characters shorter — thousands of levels deep, each\n * allocating its own node array. Bounding the body to one line and\n * {@link INLINE_BODY_MAX} characters is what makes the pass linear, and it is\n * also what real markdown means: emphasis does not span a blank line.\n /\nconst INLINE_BODY_MAX = 400;\n\n/\n 🚨 THE SOURCE, not a shared RegExp object. `renderInline` RECURSES (bold\n * inside a link, code inside a list item), and a `g`-flagged regex carries\n * `lastIndex` on the OBJECT: an inner call resets it to 0, the outer loop\n * resumes from 0, and the scan never terminates. That is not theory — it is\n * what the first version did, and it took the runner out of memory on the very\n * first live-corpus answer. A fresh matcher per call is the fix, and this\n * comment is the reason nobody \"optimises\" it back.\n /\nconst INLINE_SOURCE = [\n \"(`+)([^\\\\n]{0,400}?)\\\\1\", // 1,2 code span\n \"!\\\\[([^\\\\]\\\\n])\\\\]\\\$((?:[^()\\\\s]\|\\\\([^()\\\\s]\\\$)+)\\\\)\", // 3,4 image\n \"\\\\[([^\\\\]\\\\n]+)\\\\]\\\$((?:[^()\\\\s]\|\\\\([^()\\\\s]\\\$)+)\\\\)\", // 5,6 link\n // 🚨 The closing backreference names THIS alternative's group (\\\\7, \\\\9,\n // \\\\11). A bare \\\\1 in a joined pattern points at the CODE SPAN's group,\n // which is unmatched here and so matches empty: \"Bold\" rendered as\n // <strong>B</strong>old<em></em> (found on a live coding-sessions answer).\n \"(\\\\\\\\\|__)(?=\\\\S)([^\\\\n]{0,400}?\\\\S)\\\\7\", // 7,8 bold\n \"(\\\\\|_)(?=\\\\S)([^_\\\\n]{0,400}?\\\\S)\\\\9\", // 9,10 italic\n \"(~~)(?=\\\\S)([^\\\\n]{0,400}?\\\\S)\\\\11\", // 11,12 strikethrough\n \"(https?://[^\\\\s<>()]+)\", // 13 bare url\n].join(\"\|\");\n\nexport function renderInline(\n text: string,\n keyPrefix: string,\n depth = 0,\n): ReactNode[] {\n // A hard floor under the recursion. Bounded bodies already make a runaway\n // impossible; this makes it impossible to REINTRODUCE one by loosening a\n // pattern, which is exactly how the first OOM happened.\n if (depth > 6 \|\| text.length > INLINE_BODY_MAX 64) return [text];\n const nodes: ReactNode[] = [];\n const matcher = new RegExp(INLINE_SOURCE, \"g\");\n let cursor = 0;\n let index = 0;\n let match = matcher.exec(text);\n while (match !== null) {\n if (match.index > cursor) nodes.push(text.slice(cursor, match.index));\n const key = `${keyPrefix}i${index}`;\n index += 1;\n\n if (match[1] !== undefined) {\n nodes.push(<code key={key}>{match[2] ?? \"\"}</code>);\n } else if (match[4] !== undefined) {\n const source = safeImageSource(match[4]);\n const alt = match[3] ?? \"\";\n nodes.push(\n source === null ? (\n <Fragment key={key}>{alt === \"\" ? match[4] : alt}</Fragment>\n ) : (\n <img\n key={key}\n className=\"mx-chat-md__image\"\n src={source}\n alt={alt}\n loading=\"lazy\"\n referrerPolicy=\"no-referrer\"\n />\n ),\n );\n } else if (match[6] !== undefined) {\n const href = safeHref(match[6]);\n const label = match[5] ?? \"\";\n nodes.push(\n href === null ? (\n // Law 4: the words survive; only the unsafe jump is refused.\n <Fragment key={key}>{label}</Fragment>\n ) : (\n <a key={key} href={href} target=\"_blank\" rel=\"noreferrer noopener\">\n {renderInline(label, `${key}-`, depth + 1)}\n </a>\n ),\n );\n } else if (match[8] !== undefined) {\n nodes.push(<strong key={key}>{renderInline(match[8], `${key}-`, depth + 1)}</strong>);\n } else if (match[10] !== undefined) {\n nodes.push(<em key={key}>{renderInline(match[10], `${key}-`, depth + 1)}</em>);\n } else if (match[12] !== undefined) {\n nodes.push(<del key={key}>{renderInline(match[12], `${key}-`, depth + 1)}</del>);\n } else if (match[13] !== undefined) {\n nodes.push(\n <a key={key} href={match[13]} target=\"_blank\" rel=\"noreferrer noopener\">\n {match[13]}\n </a>,\n );\n }\n cursor = match.index + match[0].length;\n match = matcher.exec(text);\n }\n if (cursor < text.length) nodes.push(text.slice(cursor));\n return nodes;\n}\n\n/* ------------------------------------------------------------------ blocks -- /\n\nexport type MarkdownBlock =\n \| { type: \"code\"; language: string; body: string; closed: boolean }\n \| { type: \"heading\"; level: number; body: string }\n \| { type: \"quote\"; body: string }\n \| { type: \"list\"; ordered: boolean; items: string[] }\n \| { type: \"table\"; header: string[]; rows: string[][] }\n \| { type: \"rule\" }\n \| { type: \"paragraph\"; body: string };\n\nconst FENCE_LINE = /^\\s{0,3}(`{3,}\|~{3,})\\s([^\\s`])/;\nconst HEADING_LINE = /^(#{1,6})\\s+(.)$/;\nconst BULLET_LINE = /^\\s{0,3}[-+]\\s+(.)$/;\nconst ORDERED_LINE = /^\\s{0,3}\\d{1,9}[.)]\\s+(.)$/;\nconst QUOTE_LINE = /^\\s{0,3}>\\s?(.)$/;\nconst RULE_LINE = /^\\s{0,3}([-_])(\\s\\1){2,}\\s$/;\n/* A row's cells by THE GFM rule (@ai-matrx/content-ir/source): `\\\|` stays in its cell and reads as `\|`. /\nfunction tableCells(line: string): string[] {\n return rowCells(line).map(unescapeCellPipes);\n}\n\n/\n Parse markdown blocks from `lines`, returning the blocks AND the index of the\n * first line of the trailing block that may still grow. The cache uses that\n * index to re-parse only what is still arriving.\n /\nexport function parseBlocks(source: string): {\n blocks: MarkdownBlock[];\n /* CHARACTER offset of the last block's first line — where a growing string\n * may still change what has already been parsed. /\n openFrom: number;\n} {\n const lines = source.split(\"\\n\");\n // Character offset of each line's first character, so the cache can slice the\n // source rather than re-joining lines (re-joining loses a trailing newline\n // and silently shifts every later offset by one).\n const lineStart: number[] = [];\n {\n let at = 0;\n for (const line of lines) {\n lineStart.push(at);\n at += line.length + 1;\n }\n }\n const blocks: MarkdownBlock[] = [];\n let index = 0;\n let lastStart = 0;\n\n while (index < lines.length) {\n const line = lines[index] ?? \"\";\n\n if (line.trim() === \"\") {\n index += 1;\n continue;\n }\n // Marked AFTER the blank-line skip: a trailing blank line is not a block\n // start, and treating it as one makes the incremental cache believe the\n // whole answer is already stable and silently stop appending.\n lastStart = index;\n\n const fence = FENCE_LINE.exec(line);\n if (fence !== null) {\n const marker = fence[1] ?? \"```\";\n const language = fence[2] ?? \"\";\n const body: string[] = [];\n index += 1;\n let closed = false;\n while (index < lines.length) {\n const current = lines[index] ?? \"\";\n if (current.trimStart().startsWith(marker[0] ?? \"`\") && current.trim().length >= 3) {\n const close = FENCE_LINE.exec(current);\n if (close !== null && (close[1] ?? \"\").length >= marker.length) {\n closed = true;\n index += 1;\n break;\n }\n }\n body.push(current);\n index += 1;\n }\n // An UNCLOSED fence still renders as code. A half-arrived fence rendered\n // as prose reflows the instant it closes, and a jumping transcript is\n // what \"incremental\" means to a reader.\n blocks.push({ type: \"code\", language, body: body.join(\"\\n\"), closed });\n continue;\n }\n\n const heading = HEADING_LINE.exec(line);\n if (heading !== null) {\n blocks.push({\n type: \"heading\",\n level: (heading[1] ?? \"#\").length,\n body: heading[2] ?? \"\",\n });\n index += 1;\n continue;\n }\n\n if (RULE_LINE.test(line)) {\n blocks.push({ type: \"rule\" });\n index += 1;\n continue;\n }\n\n if (QUOTE_LINE.test(line)) {\n const body: string[] = [];\n while (index < lines.length) {\n const quote = QUOTE_LINE.exec(lines[index] ?? \"\");\n if (quote === null) break;\n body.push(quote[1] ?? \"\");\n index += 1;\n }\n blocks.push({ type: \"quote\", body: body.join(\"\\n\") });\n continue;\n }\n\n const bullet = BULLET_LINE.exec(line);\n const ordered = ORDERED_LINE.exec(line);\n if (bullet !== null \|\| ordered !== null) {\n const isOrdered = ordered !== null;\n const items: string[] = [];\n while (index < lines.length) {\n const current = lines[index] ?? \"\";\n const match = isOrdered\n ? ORDERED_LINE.exec(current)\n : BULLET_LINE.exec(current);\n if (match === null) break;\n items.push(match[1] ?? \"\");\n index += 1;\n }\n blocks.push({ type: \"list\", ordered: isOrdered, items });\n continue;\n }\n\n // A table by THE GFM rule (verify-RC-B4): edge pipes optional, a line that\n // starts another block ends it, rows read at the header's width.\n if (tableStartsAt(lines, index)) {\n const header = tableCells(line);\n const end = findTableEnd(lines, index);\n index += 2;\n const rows: string[][] = [];\n while (index < end) {\n const cells = tableCells(lines[index] ?? \"\");\n rows.push(header.map((_h, k) => cells[k] ?? \"\"));\n index += 1;\n }\n blocks.push({ type: \"table\", header, rows });\n continue;\n }\n\n const paragraph: string[] = [];\n while (index < lines.length) {\n const current = lines[index] ?? \"\";\n if (\n current.trim() === \"\" \|\|\n FENCE_LINE.test(current) \|\|\n HEADING_LINE.test(current) \|\|\n BULLET_LINE.test(current) \|\|\n ORDERED_LINE.test(current) \|\|\n QUOTE_LINE.test(current) \|\|\n RULE_LINE.test(current)\n ) {\n break;\n }\n paragraph.push(current);\n index += 1;\n }\n blocks.push({ type: \"paragraph\", body: paragraph.join(\"\\n\") });\n }\n\n return { blocks, openFrom: lineStart[lastStart] ?? 0 };\n}\n\n/ ------------------------------------------------------- incremental cache -- /\n\nexport interface MarkdownBlockCache {\n parse(key: string, text: string): MarkdownBlock[];\n /* How many times the parser actually ran. The performance rule, measurable. /\n readonly parses: number;\n forget(key: string): void;\n}\n\n/\n THE INCREMENTAL RULE, as code.\n \n When the next text for a key is the previous text plus more (which is what a\n * stream is), everything before the last block start is reused verbatim and\n * only the tail is re-parsed. A renderer that re-parses a 40 KB answer on every\n * one of 2,000 frames is the reason chats jank at 2,000 tokens.\n /\nexport function createBlockCache(): MarkdownBlockCache {\n interface Entry {\n text: string;\n blocks: MarkdownBlock[];\n /* Blocks before `stableEnd`, which a longer string can never change. /\n stable: MarkdownBlock[];\n /* Character offset where the still-growing block begins. /\n stableEnd: number;\n }\n const entries = new Map<string, Entry>();\n let parses = 0;\n\n const cold = (key: string, text: string): MarkdownBlock[] => {\n parses += 1;\n const parsed = parseBlocks(text);\n entries.set(key, {\n text,\n blocks: parsed.blocks,\n stable: parsed.blocks.slice(0, Math.max(0, parsed.blocks.length - 1)),\n stableEnd: parsed.openFrom,\n });\n return parsed.blocks;\n };\n\n return {\n get parses() {\n return parses;\n },\n forget(key) {\n entries.delete(key);\n },\n parse(key, text) {\n const previous = entries.get(key);\n if (previous === undefined) return cold(key, text);\n if (previous.text === text) return previous.blocks;\n // Only a CONTINUATION can reuse anything. An edit, a regenerate or a\n // second message under the same key re-parses from scratch — reusing a\n // prefix that is no longer a prefix is how a renderer shows the previous\n // answer's first paragraph forever.\n if (!text.startsWith(previous.text)) return cold(key, text);\n\n parses += 1;\n const tail = parseBlocks(text.slice(previous.stableEnd));\n const blocks = [...previous.stable, ...tail.blocks];\n entries.set(key, {\n text,\n blocks,\n stable: blocks.slice(0, Math.max(0, blocks.length - 1)),\n stableEnd: previous.stableEnd + tail.openFrom,\n });\n return blocks;\n },\n };\n}\n\n/ ---------------------------------------------------------------- render -- /\n\nfunction renderBlock(block: MarkdownBlock, key: string): ReactNode {\n switch (block.type) {\n case \"code\":\n return (\n <pre key={key} className=\"mx-chat-md__pre\" data-language={block.language \|\| undefined}>\n <code>{block.body}</code>\n </pre>\n );\n case \"heading\": {\n const level = Math.min(6, Math.max(1, block.level));\n const Tag = `h${level}` as \"h1\";\n return (\n <Tag key={key} className=\"mx-chat-md__heading\" data-level={level}>\n {renderInline(block.body, `${key}-`)}\n </Tag>\n );\n }\n case \"quote\":\n return (\n <blockquote key={key} className=\"mx-chat-md__quote\">\n {renderInline(block.body, `${key}-`)}\n </blockquote>\n );\n case \"list\":\n return block.ordered ? (\n <ol key={key} className=\"mx-chat-md__list\">\n {block.items.map((item, i) => (\n <li key={`${key}-${i}`}>{renderInline(item, `${key}-${i}-`)}</li>\n ))}\n </ol>\n ) : (\n <ul key={key} className=\"mx-chat-md__list\">\n {block.items.map((item, i) => (\n <li key={`${key}-${i}`}>{renderInline(item, `${key}-${i}-`)}</li>\n ))}\n </ul>\n );\n case \"table\":\n return (\n <div key={key} className=\"mx-chat-md__table-scroll\">\n <table className=\"mx-chat-md__table\">\n <thead>\n <tr>\n {block.header.map((cell, i) => (\n <th key={`${key}-h${i}`}>{renderInline(cell, `${key}-h${i}-`)}</th>\n ))}\n </tr>\n </thead>\n <tbody>\n {block.rows.map((row, r) => (\n <tr key={`${key}-r${r}`}>\n {row.map((cell, c) => (\n <td key={`${key}-r${r}c${c}`}>{renderInline(cell, `${key}-r${r}c${c}-`)}</td>\n ))}\n </tr>\n ))}\n </tbody>\n </table>\n </div>\n );\n case \"rule\":\n return <hr key={key} className=\"mx-chat-md__rule\" />;\n case \"paragraph\":\n return (\n <p key={key} className=\"mx-chat-md__paragraph\">\n {renderInline(block.body, `${key}-`)}\n </p>\n );\n }\n}\n\nexport interface ChatMarkdownProps {\n text: string;\n /* Cache key — the message id. Two messages never share parsed blocks. /\n cacheKey: string;\n cache: MarkdownBlockCache;\n}\n\nexport function ChatMarkdown(props: ChatMarkdownProps): ReactNode {\n const blocks = props.cache.parse(props.cacheKey, props.text);\n return (\n <div className=\"mx-chat-md\">\n {blocks.map((block, index) => renderBlock(block, `b${index}`))}\n </div>\n );\n}\n","/\n THE `files` PORT — lane 2B, design §5.\n \n Upload / resolve / preview, injected by the host. The platform default is\n * `@ai-matrx/data/files` + `@ai-matrx/media` in a later lane; what ships TODAY\n * is the honest stand-in below.\n \n 🚨 LAW 4, applied precisely. When no host has wired attachments up, the\n * composer does not render an attach button that does nothing — the control is\n * ABSENT. But a reader can still paste a screenshot or drop a PDF onto the box\n * without ever seeing a button, and THAT path must not swallow the file: the\n * stand-in port refuses out loud, with the remedy, and the composer shows the\n * refusal where the chip would have been. Absent or honest; never dead.\n /\n\nimport { formatFileSize } from \"@ai-matrx/kit/format\";\n\nimport type { ChatNotifierPort } from \"../../ports\";\n\n/* What an upload produced. `fileId` is the durable identity a turn carries. /\nexport interface ChatUploadedFile {\n fileId: string;\n name: string;\n mediaType: string \| null;\n sizeBytes: number;\n /* A preview URL, when the host can produce one. A signed URL is a handoff,\n * never an identity — the kernel only ever sends `fileId`. /\n previewUrl?: string \| undefined;\n}\n\nexport interface ChatUploadOptions {\n /* Aborted when the reader removes the chip while it is still uploading. /\n signal: AbortSignal;\n /* 0..1. A port that cannot measure progress simply never calls this, and\n * the chip shows an indeterminate state rather than a fake percentage. /\n onProgress(fraction: number): void;\n}\n\nexport interface ChatFilesPort {\n /\n FALSE when this port cannot actually store anything. The composer reads it\n * to decide whether an attach button exists at all — a button wired to a port\n * that always refuses is the \"dead control\" Law 4 forbids.\n /\n readonly available: boolean;\n /* `accept` for the file input, when the host wants to narrow it. /\n readonly accept?: string \| undefined;\n upload(file: File, options: ChatUploadOptions): Promise<ChatUploadedFile>;\n}\n\n/* The sentence a reader sees when nothing is wired up. Exported so the test\n * asserts the SAME string the screen shows, never a paraphrase. /\nexport const ATTACHMENTS_UNAVAILABLE =\n \"Attachments aren't set up here, so this file has not been sent.\";\nexport const ATTACHMENTS_UNAVAILABLE_REMEDY =\n \"Give <ChatComposerProvider> a `files` port (your upload service) to attach files to a message.\";\n\n/\n The shipped default: it refuses, loudly, with the remedy — and it says so\n * ONCE per port so a reader who drops five files gets one sentence, not five.\n /\nexport function createUnavailableFilesPort(\n notifier: ChatNotifierPort,\n): ChatFilesPort {\n let announced = false;\n return {\n available: false,\n upload(): Promise<ChatUploadedFile> {\n if (!announced) {\n announced = true;\n notifier.notify({\n level: \"warning\",\n message: ATTACHMENTS_UNAVAILABLE,\n remedy: ATTACHMENTS_UNAVAILABLE_REMEDY,\n });\n }\n return Promise.reject(new Error(ATTACHMENTS_UNAVAILABLE));\n },\n };\n}\n\n\nexport function tooLargeSentence(name: string, limitBytes: number): string {\n return `${name} is larger than the ${formatFileSize(limitBytes)} limit for this chat, so it has not been attached.`;\n}\n","/\n THE REACT-LAYER PORTS — shared scaffolding, owned by no single lane.\n \n The kernel's ports (`src/ports.ts`) are framework-free by construction: a\n * transport, a persistence binding and a prefs store have no React in them.\n * These three DO, because their return value is pixels or their default reads\n * the DOM, so they live here rather than polluting layer 1.\n \n Per THE ALL-INCLUSIVE LAW every port here ships a working default. A host\n * that injects nothing still gets a correct, honest screen.\n \n 🚨 ADDING A PORT: a port that nothing in the package CALLS is untested theory\n * that rots. `nav`, `shell`, `renderModelRef` and `capabilities` are named in\n * the design and are deliberately ABSENT until the lane that calls them lands —\n * the same rule phase 1 followed.\n \n `files` and `voice` USED to live in lane 2B's own `<ChatComposerProvider>`\n * context, because the lane contract forbade 2B editing this shared file while\n * 2A and 2C were in flight. Design §5 shows ONE port map, and at the lane merge\n * that is what they became: both are fields here, defaulted once by\n * `<ChatProvider>`. `<ChatComposerProvider>` survives as a scoped OVERRIDE — a\n * host with two composers on one page (a docked chat and a floating one) can\n * still give them different upload services — and it now inherits these\n * defaults instead of building a second set.\n /\n\nimport { humanizeIdentifier } from \"@ai-matrx/kit/text-case\";\nimport type { ReactNode } from \"react\";\n\nimport type { ChatRole } from \"../model\";\nimport type { ChatNotifierPort, ChatPrefsPort } from \"../ports\";\nimport type { ChatFilesPort } from \"./composer/files\";\nimport type { ChatQuicksetPort } from \"./plugins/quickset\";\nimport type { ChatVoicePort } from \"./composer/voice-port\";\n\n/\n One piece of content to turn into pixels.\n \n `kind` is the discriminator: `\"markdown\"` for ordinary prose, or the\n * content-IR kind name for a `render-block` part. A renderer that does not know\n * a kind must render the text honestly rather than nothing — a blank region is\n * the silent failure Law 4 forbids.\n /\nexport interface ChatContentRequest {\n kind: string;\n /* The text to render. Always present; empty string for a data-only block. /\n text: string;\n /* A render block's structured payload, when it carried one. /\n data?: unknown;\n /* True while the producing turn is still streaming — renderers must be\n * incremental and must never reflow the whole transcript per token. /\n streaming: boolean;\n role: ChatRole;\n messageId: string;\n}\n\n/\n THE `renderContent` PORT (design §6 — the one deliberate scope cut).\n \n `components/mardown-display` is 108,271 lines rendering in agent apps,\n * workflows, notes, print and the studio. Absorbing it would triple this\n * package and violate C8 on its face, so it is a SEAM with a working default\n * and a named retirement path, not an absorption.\n \n The default this package ships is the minimal SAFE one (plain text with\n * fenced code preserved, never HTML injection). The rich default — content-IR\n * kind routing plus a real markdown renderer — is lane 2b's, and a host's own\n * pipeline is what it injects during its migration.\n /\nexport type ChatRenderContentPort = (request: ChatContentRequest) => ReactNode;\n\n/\n THE `toolLabel` PORT — what a tool call is CALLED in front of a reader.\n \n A tool's name is a machine identifier (`workflow_catalog`, `web_search`). A\n * Creator watching an agent spend their money is owed a sentence, not a symbol:\n * the live review of 2026-09-18 read \"workflow_catalog Done Done\" at eye level\n * in the Conductor. The host that OWNS the tools owns their words, so this is a\n * port — and because a port with no default is a hole, the package ships a\n * humanizer (`humanizeToolName`) rather than the raw identifier. A host whose\n * tools have real names injects them; one that does not at least never shows\n * `snake_case` to a person.\n \n The machine name is not lost: it stays on the chip as `data-tool`, which is\n * what tests, the census and Developer Mode read.\n /\nexport type ChatToolLabelPort = (toolName: string) => string;\n\n/* What the model picker is handed on every render. /\nexport interface ChatModelPickerContext {\n className: string;\n}\n\n/\n THE `modelPicker` PORT (design §5.1 capability 4) — phase 4.\n \n `ModelListDropdown` has NOT moved into `@ai-matrx/agents/catalog/react` yet,\n * and until it does this package cannot render a model list without inventing\n * a roster — which would be the fifth picker on the platform, the exact thing\n * the picker ruling forbids. So the host renders its own here, the package\n * positions it, and `null` means the surface does not choose a model and NO\n * control is drawn: absent, never dead (Law 4). When the follow-on lane moves\n * the roster into the agents package, the shipped default becomes that one\n * component and this port keeps its shape.\n /\nexport type ChatModelPickerPort = (context: ChatModelPickerContext) => ReactNode;\n\n/\n The shipped default: the identifier through THE humanizer\n * (`@ai-matrx/kit/text-case` `humanizeIdentifier`): `workflow_catalog` →\n * \"Workflow Catalog\". An empty name becomes \"Working…\", because a chip with no\n * name at all is the bare spinner the transcript refuses to draw.\n /\nexport function humanizeToolName(toolName: string): string {\n return humanizeIdentifier(toolName) \|\| \"Working…\";\n}\n\n/* The React ports a `<ChatProvider>` accepts. Every one has a default. /\nexport interface ChatReactPorts {\n renderContent: ChatRenderContentPort;\n notifier: ChatNotifierPort;\n prefs: ChatPrefsPort;\n /\n Upload / resolve / preview. The shipped default REFUSES out loud with the\n * remedy, and the composer renders no attach button at all — absent, never\n * dead (Law 4).\n /\n files: ChatFilesPort;\n /\n Dictation and read-aloud. `null` means the surface has no voice, and NO\n * microphone is rendered — a greyed-out one is the dead control Law 4\n * forbids. `createBrowserAudioVoicePort()` is the platform implementation.\n /\n voice: ChatVoicePort \| null;\n /* What a tool call is called in front of a reader. Defaults to\n * `humanizeToolName` — never the raw identifier. /\n toolLabel: ChatToolLabelPort;\n /\n The model picker, rendered by the host. `null` means this surface does not\n * choose a model and nothing is drawn — see `ChatModelPickerPort`.\n /\n modelPicker: ChatModelPickerPort \| null;\n /\n The prompt chips a host offers above the box. `null` means it offers\n * none, and NO row is drawn — an empty band above the composer is dead\n * pixels. A chip fills the box; it never sends (see `ChatQuicksetPort`).\n /\n quickset: ChatQuicksetPort \| null;\n}\n\nexport type ChatReactPortOverrides = Partial<ChatReactPorts>;\n","/\n PACKAGE-OWNED GLYPHS. Two of them, inline, sized in `em`, `currentColor`.\n \n Deliberately NOT a dependency on `@ai-matrx/icons`: two 200-byte paths do not\n * justify an edge in the sibling graph, and an icon that inherits colour and\n * size from its button is exactly what the re-skin contract needs. Lanes that\n * need a real icon set (the composer's attach/mic/send) take the dependency\n * then, at their own call site.\n /\n\nimport type { ReactNode } from \"react\";\n\nexport function ChevronRightGlyph(): ReactNode {\n return (\n <svg\n className=\"mx-chat-chevron\"\n width=\"1em\"\n height=\"1em\"\n viewBox=\"0 0 16 16\"\n fill=\"none\"\n stroke=\"currentColor\"\n strokeWidth=\"1.75\"\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n aria-hidden=\"true\"\n focusable=\"false\"\n >\n <path d=\"M6 3.5 10.5 8 6 12.5\" />\n </svg>\n );\n}\n\nexport function ArrowDownGlyph(): ReactNode {\n return (\n <svg\n width=\"1em\"\n height=\"1em\"\n viewBox=\"0 0 16 16\"\n fill=\"none\"\n stroke=\"currentColor\"\n strokeWidth=\"1.75\"\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n aria-hidden=\"true\"\n focusable=\"false\"\n >\n <path d=\"M8 3v10M3.5 8.5 8 13l4.5-4.5\" />\n </svg>\n );\n}\n","/\n `<ChatToolCard>` and the slot that mounts it.\n \n 🚨 HOW THIS REACHES THE TRANSCRIPT WITHOUT TOUCHING IT. Lane 2A's\n * `<ChatToolChip>` is finished and pushed, and the lane contract forbids 2B\n * editing it. The transcript already ships the seam this needs:\n * `slots.renderPart` takes ONE part and may return `undefined` to fall through\n * to the package's own renderer. So:\n \n - a tool with NOTHING registered → the slot returns `undefined` and the\n * reader gets lane 2A's chip, byte for byte. Zero divergence on the path\n * every tool takes today.\n * - a tool WITH a renderer → this card, which keeps the chip's markup, its\n * state vocabulary and its expand behaviour, and swaps only the body.\n \n ✅ DEVIATION CLOSED AT THE LANE MERGE. This card used to carry its own copy\n * of the chip's header — ~20 duplicated lines, kept honest only by a test that\n * compared the two state tables. Lane 2A's chip now takes a `body` prop, so\n * this component IS that chip with a body passed in. There is one header, one\n * state table, one expand behaviour, and drift is no longer possible rather\n * than merely detectable.\n /\n\nimport { type ReactNode } from \"react\";\n\nimport type { ChatPart, ChatToolPart, ChatToolState } from \"../../model\";\nimport type { ChatPartContext } from \"../transcript/slots\";\nimport { CHAT_TOOL_STATE_LABEL, ChatToolChip } from \"../transcript/tool-chip\";\nimport { ChatToolGenericBody } from \"./generic-body\";\nimport {\n ChatToolBodyBoundary,\n type ChatToolRenderProps,\n type ChatToolRendererRegistry,\n} from \"./registry\";\n\n/\n The reader's words for each state — lane 2A's table, re-exported under the\n * name `/tools` publishes. Not a copy: the same object.\n /\nexport const TOOL_STATE_LABEL: Record<ChatToolState, string> = CHAT_TOOL_STATE_LABEL;\n\nconst TERMINAL: ReadonlySet<ChatToolState> = new Set<ChatToolState>([\n \"output-available\",\n \"output-error\",\n \"output-denied\",\n]);\n\nexport function toolRenderProps(part: ChatToolPart): ChatToolRenderProps {\n return {\n part,\n input: part.input,\n output: part.output,\n state: part.state,\n errorText: part.errorText,\n running: !TERMINAL.has(part.state),\n };\n}\n\nexport interface ChatToolCardProps {\n part: ChatToolPart;\n defaultExpanded: boolean;\n registry: ChatToolRendererRegistry;\n onRendererError?: ((error: Error) => void) \| undefined;\n}\n\nexport function ChatToolCard(props: ChatToolCardProps): ReactNode {\n const { part, registry } = props;\n const Renderer = registry.lookup(part.toolName);\n const renderProps = toolRenderProps(part);\n\n const body =\n Renderer === undefined ? (\n <ChatToolGenericBody {...renderProps} />\n ) : (\n <ChatToolBodyBoundary\n toolName={part.toolName}\n fallback={<ChatToolGenericBody {...renderProps} />}\n {...(props.onRendererError === undefined\n ? {}\n : { onError: props.onRendererError })}\n >\n <Renderer {...renderProps} />\n </ChatToolBodyBoundary>\n );\n\n return (\n <ChatToolChip\n part={part}\n defaultExpanded={props.defaultExpanded}\n body={body}\n rendererTag={Renderer === undefined ? \"generic\" : \"registered\"}\n />\n );\n}\n\n/\n Build the `renderPart` slot that mounts this registry.\n \n ```tsx\n * <ChatProvider thread={thread} slots={{ ...createToolRendererSlot(registry) }}>\n * ```\n \n Returning `undefined` for everything else is load-bearing: the transcript's\n * fall-through is what keeps a host's tool registry from silently blanking a\n * part type it never thought about.\n */\nexport function createToolRendererSlot(\n registry: ChatToolRendererRegistry,\n options: {\n defaultExpanded?: boolean \| undefined;\n onRendererError?: ((error: Error) => void) \| undefined;\n } = {},\n): {\n renderPart(part: ChatPart, context: ChatPartContext): ReactNode \| undefined;\n} {\n return {\n renderPart(part) {\n if (part.type !== \"tool\") return undefined;\n if (registry.lookup(part.toolName) === undefined) return undefined;\n return (\n <ChatToolCard\n part={part}\n registry={registry}\n defaultExpanded={options.defaultExpanded ?? false}\n {...(options.onRendererError === undefined\n ? {}\n : { onRendererError: options.onRendererError })}\n />\n );\n },\n };\n}\n"],"mappings":"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","names":["jsx","jsxs","useState","useEffect","useMemo","useRef","useState","useEffect","Fragment","jsx","jsxs","jsx","jsxs","jsx","jsx","Fragment","jsx","jsxs","useState","beat","jsx"]}

package/dist/ui/ShimmerText.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export interface ShimmerTextProps {
+    text: string;
+    className?: string;
+}
+export declare function ShimmerText({ text, className }: ShimmerTextProps): import("react").JSX.Element;

package/dist/ui/ShimmerText.js ADDED Viewed

@@ -0,0 +1,21 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { cn } from "@ai-matrx/design-system";
+function ShimmerText({ text, className }) {
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      className: cn(
+        "inline-block bg-clip-text text-transparent bg-[length:200%_100%] animate-shimmer",
+        className
+      ),
+      style: {
+        backgroundImage: "linear-gradient(90deg, hsl(var(--muted-foreground) / 0.3) 0%, hsl(var(--foreground)) 50%, hsl(var(--muted-foreground) / 0.3) 100%)"
+      },
+      children: text
+    }
+  );
+}
+export {
+  ShimmerText
+};

package/dist/ui/access-core.d.ts ADDED Viewed

@@ -0,0 +1,50 @@
+/**
+ * Access-gate CORE — isomorphic, no React, no browser client.
+ *
+ * The pure half of the P7 access primitive: the `AccessLevel` type, the
+ * `ResourceAccess` shape, the ordering helpers, and `resolveResourceAccess`
+ * (which takes an explicit Supabase client). Safe to import from BOTH server
+ * (`requireAccess`) and client (`useAccess`) code — it pulls in neither `react`
+ * nor the browser Supabase client, so it never forces a "use client" boundary or
+ * leaks browser globals into a Server Component.
+ *
+ * Backed by the `public.get_resource_access` SECURITY DEFINER RPC — registry-
+ * driven, resolving the SAME model RLS enforces (owner, grants, org, membership,
+ * reachability, public). This is the UX layer; RLS is still the boundary.
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+type ResourceAccessClient = Pick<SupabaseClient, "rpc">;
+/** The four access tiers, ordered `none < view < edit < admin`. */
+export type AccessLevel = "none" | "view" | "edit" | "admin";
+export interface ResourceAccess {
+    /** Highest capability the current caller has on the resource. */
+    level: AccessLevel;
+    /** True when the caller owns the resource row (`created_by`/owner column). */
+    isOwner: boolean;
+    /** False when the resource id doesn't exist or the type isn't registered. */
+    exists: boolean;
+}
+export interface ResolveResourceAccessOptions {
+    /**
+     * Propagate an access-RPC failure to the caller. Use this for server readers
+     * that must distinguish an unavailable access service from denied access.
+     */
+    strict?: boolean;
+}
+/** True when `level` meets or exceeds `required` (none < view < edit < admin). */
+export declare function accessSatisfies(level: AccessLevel, required: AccessLevel): boolean;
+/** Convenience: can this level edit? (edit or admin). */
+export declare function canEditAccess(level: AccessLevel): boolean;
+/** Convenience: can this level at least view? (view, edit, or admin). */
+export declare function canViewAccess(level: AccessLevel): boolean;
+export declare const NO_ACCESS: ResourceAccess;
+/**
+ * Resolve the current caller's access to a resource using the given Supabase
+ * client (browser or SSR). By default, failures resolve to no-access. Set
+ * `options.strict` when a caller must surface access-service failures instead
+ * of rendering an access-denied state. Callers usually reach this via
+ * `useAccess` (client) or `requireAccess`/`resolveAccess` (server) rather than
+ * directly.
+ */
+export declare function resolveResourceAccess(client: ResourceAccessClient, resourceType: string, resourceId: string, options?: ResolveResourceAccessOptions): Promise<ResourceAccess>;
+export {};

package/dist/ui/access-core.js ADDED Viewed

@@ -0,0 +1,65 @@
+const ACCESS_RANK = {
+  none: 0,
+  view: 1,
+  edit: 2,
+  admin: 3
+};
+function accessSatisfies(level, required) {
+  return ACCESS_RANK[level] >= ACCESS_RANK[required];
+}
+function canEditAccess(level) {
+  return accessSatisfies(level, "edit");
+}
+function canViewAccess(level) {
+  return accessSatisfies(level, "view");
+}
+const NO_ACCESS = {
+  level: "none",
+  isOwner: false,
+  exists: false
+};
+function parseAccess(data) {
+  if (data && typeof data === "object" && !Array.isArray(data)) {
+    const o = data;
+    const level = o.level;
+    if ((level === "view" || level === "edit" || level === "admin" || level === "none") && typeof o.is_owner === "boolean" && typeof o.exists === "boolean") {
+      return {
+        level,
+        isOwner: o.is_owner,
+        exists: o.exists
+      };
+    }
+  }
+  return null;
+}
+async function resolveResourceAccess(client, resourceType, resourceId, options = {}) {
+  if (!resourceType || !resourceId) return NO_ACCESS;
+  try {
+    const { data, error } = await client.rpc("get_resource_access", {
+      p_resource_type: resourceType,
+      p_resource_id: resourceId
+    });
+    if (error) {
+      if (options.strict) throw error;
+      return NO_ACCESS;
+    }
+    const access = parseAccess(data);
+    if (!access) {
+      if (options.strict) {
+        throw new Error("get_resource_access returned a malformed response");
+      }
+      return NO_ACCESS;
+    }
+    return access;
+  } catch (error) {
+    if (options.strict) throw error;
+    return NO_ACCESS;
+  }
+}
+export {
+  NO_ACCESS,
+  accessSatisfies,
+  canEditAccess,
+  canViewAccess,
+  resolveResourceAccess
+};

package/dist/ui/addressWithoutNavigating.d.ts ADDED Viewed

@@ -0,0 +1,68 @@
+/**
+ * addressWithoutNavigating — THE one way to change the address bar without a
+ * navigation (lane URL-STATE, 2026-09-24; born in lane PANEL-REMOUNT).
+ *
+ * Query state (`?view=`, `?panels=`, `?tab=`, a selected row, a filter) is
+ * bookkeeping about the page you are on, never a new page. `router.replace` /
+ * `router.push` are App Router NAVIGATIONS: each one fetches a fresh RSC
+ * payload for the route (a `?_rsc=` request, a server round trip) and, on
+ * commit, can remount the page — measured on /data/[tableId]: one `?_rsc=`
+ * request per layout switch, and before PANEL-REMOUNT the whole grid re-read.
+ *
+ * `history.pushState` / `history.replaceState` are patched by Next's app
+ * router: called with a state object that does NOT carry `__NA`, the patch
+ * copies Next's own tree state onto the new entry and dispatches a `restore`,
+ * so `useSearchParams` / `usePathname` hold the new URL with no server round
+ * trip and no remount. Back/forward still work (Next owns the entry).
+ *
+ * 🚨 This module always passes `null`. Passing `window.history.state` (the
+ * old habit) forwards Next's `__NA` marker, which SKIPS the patch: the address
+ * bar changes while `useSearchParams` keeps the old value.
+ *
+ * Use the router for a REAL route change (another page), or when the server
+ * component of the current route reads the changed param from `searchParams`
+ * — only a navigation re-renders server output. Everything else comes here.
+ * Guard: eslint `matrx/no-navigation-for-query-state`.
+ */
+/**
+ * Replace the current history entry's address. No navigation, no RSC fetch.
+ *
+ * A HASH-ONLY change skips Next's patch on purpose: nothing Next exposes
+ * (`usePathname`, `useSearchParams`, `useParams`) reads the hash, yet the
+ * patch's `restore` hands every `useSearchParams` reader a new object, so each
+ * write re-rendered all of them. A canvas writing its camera to `#cam=` while
+ * panning paid that per write — over a second per pointer move on a board of
+ * fifteen heavy tiles, so the board froze while panning (2026-10-01). Forwarding
+ * the entry's own state keeps Next's `__NA` tree on it (Back still works).
+ */
+export declare function replaceAddressWithoutNavigating(href: string | URL): void;
+/** Push a new history entry (Back returns to the old address). No navigation, no RSC fetch. */
+export declare function pushAddressWithoutNavigating(href: string | URL): void;
+/**
+ * The current path (and hash) carrying `search` as its query — the usual
+ * argument for the two writers above. An empty query drops the `?`.
+ */
+export declare function currentPathWithSearch(search: URLSearchParams | string): string;
+/** Just enough of Next's router for the two helpers below (and their tests). */
+export interface AddressRouter {
+    push: (href: string, options?: {
+        scroll?: boolean;
+    }) => void;
+    replace: (href: string, options?: {
+        scroll?: boolean;
+    }) => void;
+}
+/**
+ * For a caller that names its page by a literal path (`/tasks?task=…`) but
+ * can also render somewhere else (a window panel over another page): on that
+ * page the change is query state, so no navigation; anywhere else it is a real
+ * route change, so the router carries it exactly as before (`options` are the
+ * router's, passed through unchanged).
+ */
+export declare function replaceAddressOrNavigate(router: AddressRouter, href: string, options?: {
+    scroll?: boolean;
+}): void;
+/** The push twin of {@link replaceAddressOrNavigate}. */
+export declare function pushAddressOrNavigate(router: AddressRouter, href: string, options?: {
+    scroll?: boolean;
+}): void;