@ai-matrx/rich-content 0.2.4 → 0.2.7

package/dist/display/chat-markdown/block-registry/block-dispatch.d.ts

@@ -0,0 +1,410 @@
+/**
+ * block-dispatch — the declarative render-block dispatch registry.
+ *
+ * Replaces BlockRenderer's historical ~40-case switch with one data-driven
+ * table keyed by block type and organized BY CROSSWALK CLASSIFICATION
+ * (scripts/shape/content-vocab-crosswalk.json — the classification authority;
+ * regenerate-check via `pnpm check:shapes:crosswalk`):
+ *
+ *  - protocol        → control tags, lifecycle/ack events, editor plumbing
+ *  - scalar_generic  → text / code / tables / media primitives
+ *  - shape           → structured content (registered kinds + shape candidates)
+ *  - intentionally_opaque → the explicit unknown-data renderer
+ *
+ * EXHAUSTIVENESS is enforced twice:
+ *  1. Compile time — each classification table `satisfies
+ *     Record<XBlockType, BlockRenderFn>`, and the classification unions are
+ *     asserted (via `AssertNever`) to exactly cover the GENERATED vocabulary
+ *     (TypedRenderBlock ∪ ServerOnlyBlockType ∪ ClientOnlyBlockType) plus the
+ *     documented FE-synthesized extras. A new generated block type fails the
+ *     build here until it is classified and registered.
+ *  2. Runtime — `reportUnregisteredBlockType` SCREAMS (console.error +
+ *     structured captureError) for any block type with no registration. There
+ *     is no silent default hiding an unregistered renderable.
+ *
+ * ROUTING ORDER (owned by BlockRenderer, the component):
+ *  1. Kind route (shape classification, first-class): `applyIrKindRoute` —
+ *     a resolved `metadata.__ir` envelope routes through the kind registry
+ *     (`resolveComponent(kind, "web", "output")` / legacy bridge) BEFORE any
+ *     type-keyed dispatch. See features/content-ir/react/kind-route.ts.
+ *  2. Pending-structured skeleton (unresolved streaming JSON region).
+ *  3. Unified artifact renderer (resolveArtifactDef + hasArtifactRenderer) —
+ *     the single shared path for materializable standalone blocks.
+ *  4. This table.
+ *
+ * Every entry preserves its legacy switch-case body byte-for-byte (props,
+ * guards, comments). This file is ROUTING ONLY — no behavior changes.
+ *
+ * CODE-SPLITTING: all heavy components stay lazy exactly as before — the
+ * table references the same lazily-wrapped `BlockComponents` members the
+ * switch did (see BlockComponentRegistry.tsx); nothing new is imported
+ * statically that wasn't already static in BlockRenderer.
+ */
+import type { AnswerEditRemarkMeta } from "../../block-interaction.js";
+import React from "react";
+import type { TypedRenderBlock, ServerOnlyBlockType, ServerProtocolRenderBlock, ServerScalarGenericRenderBlock, ServerShapeRenderBlock, ServerOpaqueRenderBlock } from "@ai-matrx/agents/generated/stream-events";
+import type { ClientOnlyBlockType } from "../../markdown-classification/processors/utils/client-blocks.js";
+import { DB_KIND_COMPONENT_KEY, GENERIC_STRUCTURED_COMPONENT_KEY } from "../../../kinds/react/kind-route.js";
+/**
+ * Flat render block interface used by BlockRenderer + this dispatch table.
+ *
+ * This is intentionally NOT a discriminated union. Using a discriminated union
+ * (like TypedRenderBlock) causes TypeScript to narrow `block` to `never` for
+ * any registration whose type string isn't in the union — making shared entry
+ * functions unusable.
+ *
+ * All fields are the union of what any block registration can access. Specific
+ * typed data for server-processed blocks arrives via `serverData` (the Python
+ * `data` field).
+ *
+ * The `type` string covers ALL blocks: Python-typed (TypedRenderBlock["type"]),
+ * client-splitter types (ClientOnlyBlockType), FE-synthesized data-event
+ * wrappers (ServerOnlyBlockType), and the open `string` fallback for anything
+ * Python adds before TypeScript types catch up.
+ */
+export interface RenderBlock {
+    type: TypedRenderBlock["type"] | ClientOnlyBlockType | ServerOnlyBlockType | string;
+    content: string;
+    /** Python's `data` field — typed by the server, accessed via serverData in the renderer. */
+    serverData?: Record<string, unknown>;
+    /** For code blocks: the language identifier (e.g. "typescript", "json"). */
+    language?: string;
+    /** For image/video blocks parsed from markdown: the media URL. */
+    src?: string;
+    /** For image/video blocks parsed from markdown: the alt text. */
+    alt?: string;
+    /** Block-specific metadata from the splitter or server. */
+    metadata?: Record<string, unknown>;
+    /** True when this block was emitted mid-stream (status: "streaming") — content is incomplete. */
+    isStreamingBlock?: boolean;
+}
+/**
+ * Everything a registration may read. Assembled once per block by
+ * BlockRenderer (which owns the hooks — registrations are pure render
+ * functions and MUST NOT call hooks).
+ */
+export interface BlockDispatchContext {
+    block: RenderBlock;
+    index: number;
+    isStreamActive?: boolean;
+    conversationId?: string;
+    /** TRANSCRIPT KEY — always present; UI keys, anchors, canvas dedupe, local state. Never a DB key. */
+    messageId?: string;
+    /** DATABASE identity — undefined until the answer has a durable row. The only id for DB reads/writes. */
+    durableMessageId?: string;
+    taskId?: string;
+    requestId?: string;
+    isLastReasoningBlock?: boolean;
+    /** Per-conversation display flags (instanceUIState) — resolved by the component. */
+    hideReasoning: boolean;
+    hideToolResults: boolean;
+    /**
+     * May this reader see the machinery (`useMachineFramesVisible`)? A model's
+     * thinking narrates its own tool calls ("retry add_rules using the correct
+     * section keys", walk 24), so it is a machine frame like a tool card.
+     * Undefined = a builder surface, unchanged.
+     */
+    machineFramesVisible?: boolean;
+    /** Generic handler: replaces `original` substring with `replacement` in the full content string. */
+    replaceBlockContent: (original: string, replacement: string, remark?: AnswerEditRemarkMeta) => void;
+    /** The shared BasicMarkdownContent renderer, pre-wired with edit/diagnostic props. */
+    renderBasicMarkdown: (content: string) => React.ReactElement;
+    /** Bound agent's declared output schema; absent/loading deliberately fails closed. */
+    outputSchema?: unknown | null;
+}
+export type BlockRenderFn = (ctx: BlockDispatchContext) => React.ReactElement | null;
+/** Language for ``` fences with no info string (plain text / notes / prose). */
+export declare const DEFAULT_UNLABELED_FENCE_LANGUAGE = "markdown";
+/**
+ * Best-effort MIME type for an audio URL parsed from a markdown link, derived
+ * from its file extension (query string ignored). Lets the audio player emit a
+ * correct `<source type>`; returns undefined for unknown extensions, which the
+ * player handles gracefully.
+ */
+export declare function audioMimeFromUrl(url: string): string | undefined;
+/**
+ * Returns true when a block should show its loading skeleton instead of
+ * attempting to parse incomplete content.
+ *
+ * A block is considered "still loading" when either:
+ *  - It was emitted mid-stream (status === "streaming") — content is definitely
+ *    incomplete because the accumulator hasn't seen the closing fence/tag yet.
+ *  - The splitter/server explicitly marked it isComplete: false AND the
+ *    brace count shows the JSON is still open.
+ */
+export declare function isBlockLoading(block: {
+    isStreamingBlock?: boolean;
+    metadata?: Record<string, unknown>;
+    content: string;
+}): boolean;
+/**
+ * FE-synthesized block types with NO generated-union membership:
+ *  - `media_block` — synthesized by process-stream.ts from the `media_block`
+ *    data event (document/youtube kinds). The crosswalk declares it through
+ *    `frontend:synthesized_render_block` and classifies it scalar_generic,
+ *    matching its audio_output/image_output/video_output siblings.
+ *  - `generic_structured` — produced ONLY by `applyIrKindRoute`'s R6 generic
+ *    fallback (a KNOWN shape nothing render-trusted claims); never emitted
+ *    upstream, so it has no vocabulary row. Shape-classified by construction.
+ *  - `flow_step_result` / `collection_result` / `file_operation_result` /
+ *    `value_result` — the four RUNTIME RESULT family renderers (GAP 6,
+ *    2026-08-23). 61 workflow/tool kinds that reached the reader only through
+ *    the `generic_structured` floor now resolve to one of these by a
+ *    `kind_component` row per kind, on exactly the `web_analysis_item` model:
+ *    one shared reader question per family, the platform's value renderer
+ *    underneath. Reached ONLY via applyIrKindRoute's resolver-only path.
+ *  - `google_workspace_result` / `google_marketing_result` — the two GOOGLE
+ *    tool-result renderers. One union kind per tool (fifteen Workspace actions,
+ *    six marketing reads), so one component each, reached through that kind's
+ *    `kind_component` row on the resolver-only path. Never emitted upstream.
+ *  - `platform_record` — the ONE renderer for the `platform_record` kind, the
+ *    shape `data.read_record` ("Read a Record", matrx-graph) answers with: one
+ *    platform row of ANY registered entity type, read as the run's operator.
+ *    One Record shape for every type by ruling, so one component: the row's
+ *    identity and its door lead, `hidden_fields` are named, and the columns go
+ *    to the platform's value viewer. Reached ONLY via applyIrKindRoute's
+ *    resolver-only path, from that kind's `kind_component` row; never emitted
+ *    upstream, so it has no vocabulary row. Shape-classified by construction.
+ *  - `seo_ruling_*` — the fourteen keyword RULING SESSION kinds (seven
+ *    collections + their seven item kinds): what the SEO keyword Ruling Session
+ *    agents are told, built by `features/marketing/seo/value-system/workbench/
+ *    session/trial.ts`. One compact component per kind (blocks/seo-ruling-kinds/),
+ *    each collection delegating its rows to the item kind's component. Reached
+ *    ONLY via applyIrKindRoute's resolver-only path, from each kind's
+ *    `kind_component` row; never emitted upstream. Shape-classified by construction.
+ *  - `web_analysis_item` — the ONE renderer for the `web_analysis_item`
+ *    kind family (the 83 registered `web_*_v1` site-audit checks, which share
+ *    one verified shape). Produced ONLY by `applyIrKindRoute`'s resolver-only
+ *    path, from a `content_ir.kind_component` row per kind; never emitted
+ *    upstream, so it has no vocabulary row. Shape-classified by construction.
+ *  - `markdown_stream` — the registered renderer for the `markdown` kind
+ *    (`{ text }`), which hands the text to MarkdownStream: the two-path render
+ *    law ("declared kind component, or streaming markdown") collapsed into one
+ *    by making the second path a kind. Produced ONLY by `applyIrKindRoute`'s
+ *    resolver-only path, from that kind's `content_ir.kind_component` row;
+ *    never emitted upstream, so it has no vocabulary row. Shape-classified by
+ *    construction.
+ *  - `db_kind_component` — produced ONLY by `applyIrKindRoute`'s db-override
+ *    flip (an ACTIVE `content_ir.kind_component` row with `source='db'` won
+ *    the resolution); never emitted upstream. Shape-classified by
+ *    construction.
+ *  - `video_prompt_options` — produced ONLY by `applyIrKindRoute`'s
+ *    compiled-bridge flip for the registered `video_prompt_options` kind
+ *    (`__kind` JSON arrival only — no tag/fence surface); never emitted
+ *    upstream. Shape-classified by construction.
+ *  - `keyword_research` / `keyword_classification_batch` — produced ONLY by
+ *    `applyIrKindRoute`'s compiled-bridge flips for the registered
+ *    `keyword_relationship_research` / `keyword_classification_batch_v1`
+ *    kinds (`__kind` JSON arrival only — no tag/fence surface); never
+ *    emitted upstream. Shape-classified by construction. STREAMING bridges:
+ *    serverData exists (and grows) mid-stream, so the components render
+ *    item-by-item live.
+ *  - `page_brief` — produced ONLY by `applyIrKindRoute`'s compiled-bridge flip
+ *    for the registered `page_brief` kind (`__kind` JSON arrival only — no
+ *    tag/fence surface); never emitted upstream. Shape-classified by
+ *    construction. STREAMING bridge, same contract as the keyword pair.
+ *  - `media_chapters` — produced ONLY by `applyIrKindRoute`'s compiled-bridge
+ *    flip for the registered `media_chapters` kind (`__kind` JSON arrival
+ *    only — no tag/fence surface); never emitted upstream. STREAMING bridge:
+ *    `chapters` is an array of a child kind, so rows appear one at a time.
+ *  - `generated_image_set` / `generated_video_set` / `generated_audio` /
+ *    `podcast_episode` — the media workflow-I/O deliverables, produced ONLY by
+ *    `applyIrKindRoute`'s compiled-bridge flips for those registered kinds
+ *    (`__kind` JSON arrival only — no tag/fence surface); never emitted
+ *    upstream. STREAMING bridges: the set kinds carry a child-kind array, so
+ *    each image/clip appears as its object closes. Media renders through
+ *    `<InlineMediaRef>` inside the components (never a raw src) — see the
+ *    media-durability law.
+ *  - `memory_aid` / `memory_hint` — produced ONLY by `applyIrKindRoute`'s
+ *    compiled-bridge flips for those registered kinds (`__kind` JSON arrival
+ *    only — no tag/fence surface); never emitted upstream. STREAMING bridges:
+ *    `mnemonics` / `analogies` / `loci` are arrays of child kinds, so aids
+ *    appear one at a time; the hint shows a writing row until `aid` parses.
+ *  - `masterwork_checkup_finding` — produced ONLY by `applyIrKindRoute`'s
+ *    compiled-bridge flip for the registered `masterwork_checkup_finding`
+ *    kind (`__kind` JSON arrival only — no tag/fence surface); never emitted
+ *    upstream. Shape-classified by construction. COMPLETE bridge: aidream
+ *    gates a whole finding before it reaches the wire, so findings stream,
+ *    fields within one do not. Carries the Approve/Improve/Reject/Edit verbs
+ *    through the `checkup_decision` surface write target when the page it
+ *    landed on offers it.
+ *  - `refusal` — the honest "not yet": the desk declined to produce until its
+ *    frame holds, and named every missing fact with how to get it. Produced
+ *    ONLY by `applyIrKindRoute`'s compiled-bridge flip; a COMPLETE bridge (a
+ *    half-written refusal is not a position). It is a RESULT — never routed to
+ *    an error surface, a toast, or nothing.
+  *  - `case_disclosure` / `unfolding_ruling` — the UNFOLDING-CASE kinds,
+ *    produced ONLY by `applyIrKindRoute`'s compiled-bridge flips (`__kind`
+ *    JSON arrival only — no tag/fence surface); never emitted upstream.
+ *    COMPLETE bridges: the case oracle emits a whole disclosure (its ledger is
+ *    cumulative, so the latest one IS the whole path) and the desk emits a
+ *    whole ruling — there is no half-written one on the wire.
+ *  - `agent_result` — produced ONLY by `applyIrKindRoute`'s compiled-bridge
+ *    flip for the registered `agent_result` kind (`__kind` JSON arrival only —
+ *    no tag/fence surface); never emitted upstream. COMPLETE bridge: an
+ *    agent-run envelope is the settled record of a finished run, so there is
+ *    no half-written one. The bridge hands the component what the agent
+ *    PRODUCED plus the run's numbers — never `messages`, which is why the
+ *    envelope's verbatim prompt cannot reach a reader through this path.
+ *  - `node_outcome` / `run_result` — the RUNTIME WRAPPER kinds, produced ONLY
+ *    by `applyIrKindRoute`'s compiled-bridge flips (`__kind` JSON arrival only
+ *    — no tag/fence surface); never emitted upstream. COMPLETE bridges: a
+ *    wrapper describes SETTLED work (a node that finished, a run that
+ *    terminated), so there is no half-written one. Their components render
+ *    PROVENANCE ONLY and hand the nested `output` back to this same registry —
+ *    see common-docs RUNTIME_WRAPPER_WIRE.md §5.
+ *  - `episode_title_options` — produced ONLY by `applyIrKindRoute`'s
+ *    compiled-bridge flip for the registered `episode_title_options` kind
+ *    (`__kind` JSON arrival only — no tag/fence surface); never emitted
+ *    upstream. Shape-classified by construction. STREAMING bridge; the cards
+ *    apply the picked title through the `episode_title` surface write target
+ *    when the page they landed on offers it.
+ *  - `seo_package` — produced ONLY by `applyIrKindRoute`'s compiled-bridge flip
+ *    for the registered `seo_package` kind (`__kind` JSON arrival only — no
+ *    tag/fence surface); never emitted upstream. STREAMING bridge: the title
+ *    lands with its character budget already measured, and `faq` is an array
+ *    of a child kind, so questions appear one at a time.
+ *  - `plan_page_research` / `plan_page_outline` / `plan_page_draft` /
+ *    `plan_page_review` / `cms_page_build` — the Website Factory's per-page
+ *    pipeline steps, produced ONLY by `applyIrKindRoute`'s compiled-bridge
+ *    flips for those registered kinds (`__kind` JSON arrival only — no
+ *    tag/fence surface); never emitted upstream. STREAMING bridges: each
+ *    carries at least one child-kind array (sections / issues / sources /
+ *    planned links), so rows appear one at a time.
+ *  - `ingested_sources` / `study_notes` — the Study Pack run surface's two
+ *    opening readouts, produced ONLY by `applyIrKindRoute`'s compiled-bridge
+ *    flips for those registered kinds (`__kind` JSON arrival only — no
+ *    tag/fence surface); never emitted upstream. STREAMING bridges: chunks and
+ *    sections are child-kind arrays, so sources and sections appear one at a
+ *    time.
+ *  - `lesson_scripts` / `study_pack` — study_pack_v2: the spoken lessons and
+ *    the composed pack, produced ONLY by `applyIrKindRoute`'s compiled-bridge
+ *    flips for `lesson_script_set` / `study_pack_set` (`__kind` JSON arrival
+ *    only — no tag/fence surface); never emitted upstream. STREAMING bridges:
+ *    lesson sections appear one at a time, and the pack renders whichever
+ *    member artifacts have arrived (StudyPackBlock DELEGATES each member back
+ *    to its own kind's component — never a second flashcards/quiz/notes view).
+ *  - `web_search_results` + its item kinds (`web_result`, `news_result`,
+ *    `video_result`, `faq_item`, `discussion_result`, `local_place`,
+ *    `entity_card`, `ai_answer`) + the primitives (`rating`, `opening_hours`,
+ *    `postal_address`, `geo_coordinates`) — the merged provider-agnostic
+ *    search kind family (Search Kinds Pilot), produced ONLY by
+ *    `applyIrKindRoute`'s compiled-bridge flips (`__kind` JSON arrival only —
+ *    no tag/fence surface); never emitted upstream. STREAMING bridges: the
+ *    collection carries child-kind arrays, so results appear as their
+ *    objects close; the collection component delegates every nested instance
+ *    to its kind's canonical component (db overrides included).
+ *  - `seo_rank_serp_landscape` + `serp_placement` + `seo_rank_reading` +
+ *    `seo_rank_target` + `seo_rank_portfolio` + `seo_rank_target_removal` +
+ *    the primitive `provider_run_receipt` — the rank / SERP-landscape family
+ *    (Rank Kinds Run), produced ONLY by `applyIrKindRoute`'s compiled-bridge
+ *    flips (`__kind` JSON arrival only — no tag/fence surface). A CONVERGENCE
+ *    family: `serp_placement.result` is a union over the SHIPPED search item
+ *    kinds above, and its component delegates straight through the search
+ *    family's seam rather than re-drawing any of them.
+ *  - `source_ref` + `retrieved_chunk` + `rag_search_result` +
+ *    `rag_cross_doc_search_result` + `rag_synthesize_result` — the RAG
+ *    retrieval + citation family (RAG Kinds Run), produced ONLY by
+ *    `applyIrKindRoute`'s compiled-bridge flips (`__kind` JSON arrival only —
+ *    no tag/fence surface). `source_ref` is a SYSTEM-WIDE primitive, not a RAG
+ *    kind: it is the platform's cited-source shape and renders in two postures
+ *    from ONE component (a standalone card, and the shared `CitationChip`
+ *    inline). `retrieved_chunk` adapts to `RagHitView` and renders the
+ *    canonical `RagHitCard` rather than drawing a fourth hit card.
+ *  - `data_table` — the tabular PRIMITIVE (Table Kinds Run), produced ONLY by
+ *    `applyIrKindRoute`'s compiled-bridge flips (`__kind` JSON arrival only —
+ *    no tag/fence surface). A SQL result, a user data-table lookup, a parsed
+ *    CSV and a table lifted out of a PDF are ONE rows-and-columns shape that
+ *    was wearing five names; everything returning rows nests this rather than
+ *    minting its own. Its component makes the two facts those five producers
+ *    hid impossible to miss: an UNDECLARED column type (never a synonym for
+ *    "string") and a SILENT truncation.
+ */
+export type FeSynthesizedBlockType = "directive_receipt" | "decision_questions" | "speech_script" | "input_remarks" | "media_block" | "video_prompt_options" | "map_topic_proposal" | "pr_play_menu" | "news_monitor_kind" | "decision_answers" | "list_change_proposal" | "keyword_research" | "keyword_classification_batch" | "keyword_serp_intent_analysis" | "seo_keyword_research_result" | "page_brief" | "media_chapters" | "generated_image_set" | "generated_video_set" | "generated_audio" | "podcast_episode" | "media_asset" | "memory_aid" | "memory_hint" | "episode_title_options" | "masterwork_checkup_finding" | "masterwork_result" | "serial_observation_timeline" | "case_disclosure" | "unfolding_ruling" | "refusal" | "agent_result" | "node_outcome" | "run_result" | "seo_package" | "plan_page_research" | "plan_page_outline" | "plan_page_draft" | "plan_page_review" | "cms_page_build" | "cms_html_page_result" | "ingested_sources" | "study_notes" | "lesson_scripts" | "study_pack" | "scraped_page" | "scraper_batch_result" | "scraper_crawl_result" | "page_link" | "link_buckets" | "page_image" | "page_video" | "page_audio" | "page_heading" | "page_section" | "page_list" | "page_block" | "code_block" | "redirect_hop" | "content_fingerprint" | "page_metadata" | "page_removal" | "page_cleaning_report" | "web_search_results" | "web_result" | "news_result" | "video_result" | "faq_item" | "discussion_result" | "local_place" | "entity_card" | "ai_answer" | "rating" | "opening_hours" | "postal_address" | "geo_coordinates" | "seo_rank_serp_landscape" | "serp_placement" | "seo_rank_reading" | "seo_rank_target" | "seo_rank_portfolio" | "seo_rank_target_removal" | "provider_run_receipt" | "intake_photo_grouping" | "item_vision_extraction" | "lot_detection" | "product_research" | "value_assessment" | "asset_grading" | "media_list_ranking_result" | "media_candidate_verdict" | "enrichment_verification" | "pricing_proposal" | "listing_draft" | "review_verdict" | "publish_preflight" | "lulu_print_cost_calculation" | "lulu_shipping_options" | "lulu_cover_dimensions" | "lulu_print_job" | "lulu_print_product_matches" | "data_table" | "source_ref" | "retrieved_chunk" | "rag_search_result" | "rag_cross_doc_search_result" | "rag_synthesize_result" | "web_analysis_item" | "flow_step_result" | "collection_result" | "file_operation_result" | "value_result" | "google_workspace_result" | "google_marketing_result" | "platform_record" | "relation" | "pick_list" | "seo_ruling_keyword" | "seo_ruling_example" | "seo_ruling_dimension" | "seo_ruling_matcher_hit" | "seo_ruling_correction" | "seo_ruling_confirmation" | "seo_ruling_matcher" | "seo_ruling_keyword_set" | "seo_ruling_example_set" | "seo_ruling_dimension_catalog" | "seo_ruling_matcher_hit_set" | "seo_ruling_correction_set" | "seo_ruling_confirmation_set" | "seo_ruling_matcher_set" | "agent_factory_contract" | "agent_factory_tool_choice" | "agent_factory_instructions" | "agent_factory_proof_review" | "agent_factory_build" | "markdown_stream" | typeof GENERIC_STRUCTURED_COMPONENT_KEY | typeof DB_KIND_COMPONENT_KEY;
+/**
+ * Detector-owned protocol tokens (crosswalk rows sourced ONLY from the
+ * splitter/accumulator ATTR_XML_TAGS tables — no TS render-block union
+ * membership): the editor pill round-trip plumbing + audio citations.
+ */
+export type DetectorProtocolBlockType = "editor_error" | "editor_code_snippet" | "audiocite";
+/** Crosswalk classification: protocol — control plumbing, never Shapes. */
+export type ProtocolBlockType = ServerProtocolRenderBlock["type"] | "directive_receipt" | "thinking" | "reasoning" | "consolidated_reasoning" | "decision" | "artifact" | "info" | "task" | "database" | "private" | "plan" | "event" | "tool" | "matrx" | "matrx_file" | "schema_proposal" | DetectorProtocolBlockType;
+/** Crosswalk classification: scalar_generic — text/code/table/media primitives. */
+export type ScalarGenericBlockType = ServerScalarGenericRenderBlock["type"] | "text" | "code" | "table" | "image" | "video" | "tree" | "accent-divider" | "heavy-divider" | "audio" | "youtube" | "svg" | "media_block";
+/** Crosswalk classification: shape — structured content (kinds + candidates). */
+export type ShapeBlockType = ServerShapeRenderBlock["type"] | "decision_questions" | "speech_script" | "input_remarks" | "flashcards" | "quiz" | "presentation" | "cooking_recipe" | "timeline" | "progress_tracker" | "comparison_table" | "troubleshooting" | "resources" | "decision_tree" | "research" | "diagram" | "mermaid" | "math_problem" | "questionnaire" | "tasks" | "transcript" | "structured_info" | "item_presentation" | "video_prompt_options" | "map_topic_proposal" | "pr_play_menu" | "news_monitor_kind" | "decision_answers" | "list_change_proposal" | "keyword_research" | "keyword_classification_batch" | "keyword_serp_intent_analysis" | "seo_keyword_research_result" | "page_brief" | "media_chapters" | "generated_image_set" | "generated_video_set" | "generated_audio" | "podcast_episode" | "media_asset" | "memory_aid" | "memory_hint" | "episode_title_options" | "masterwork_checkup_finding" | "masterwork_result" | "serial_observation_timeline" | "case_disclosure" | "unfolding_ruling" | "refusal" | "agent_result" | "node_outcome" | "run_result" | "seo_package" | "plan_page_research" | "plan_page_outline" | "plan_page_draft" | "plan_page_review" | "cms_page_build" | "cms_html_page_result" | "ingested_sources" | "study_notes" | "lesson_scripts" | "study_pack" | "scraped_page" | "scraper_batch_result" | "scraper_crawl_result" | "page_link" | "link_buckets" | "page_image" | "page_video" | "page_audio" | "page_heading" | "page_section" | "page_list" | "page_block" | "code_block" | "redirect_hop" | "content_fingerprint" | "page_metadata" | "page_removal" | "page_cleaning_report" | "web_search_results" | "web_result" | "news_result" | "video_result" | "faq_item" | "discussion_result" | "local_place" | "entity_card" | "ai_answer" | "rating" | "opening_hours" | "postal_address" | "geo_coordinates" | "seo_rank_serp_landscape" | "serp_placement" | "seo_rank_reading" | "seo_rank_target" | "seo_rank_portfolio" | "seo_rank_target_removal" | "provider_run_receipt" | "intake_photo_grouping" | "item_vision_extraction" | "lot_detection" | "product_research" | "value_assessment" | "asset_grading" | "media_list_ranking_result" | "media_candidate_verdict" | "enrichment_verification" | "pricing_proposal" | "listing_draft" | "review_verdict" | "publish_preflight" | "lulu_print_cost_calculation" | "lulu_shipping_options" | "lulu_cover_dimensions" | "lulu_print_job" | "lulu_print_product_matches" | "data_table" | "source_ref" | "retrieved_chunk" | "rag_search_result" | "rag_cross_doc_search_result" | "rag_synthesize_result" | "chart" | "map" | "stats" | "diff" | "web_analysis_item" | "flow_step_result" | "collection_result" | "file_operation_result" | "value_result" | "google_workspace_result" | "google_marketing_result" | "platform_record" | "relation" | "pick_list" | "seo_ruling_keyword" | "seo_ruling_example" | "seo_ruling_dimension" | "seo_ruling_matcher_hit" | "seo_ruling_correction" | "seo_ruling_confirmation" | "seo_ruling_matcher" | "seo_ruling_keyword_set" | "seo_ruling_example_set" | "seo_ruling_dimension_catalog" | "seo_ruling_matcher_hit_set" | "seo_ruling_correction_set" | "seo_ruling_confirmation_set" | "seo_ruling_matcher_set" | "agent_factory_contract" | "agent_factory_tool_choice" | "agent_factory_instructions" | "agent_factory_proof_review" | "agent_factory_build" | "markdown_stream" | typeof GENERIC_STRUCTURED_COMPONENT_KEY | typeof DB_KIND_COMPONENT_KEY;
+/** Crosswalk classification: intentionally_opaque — deliberately untyped. */
+export type OpaqueBlockType = ServerOpaqueRenderBlock["type"];
+export type KnownBlockType = ProtocolBlockType | ScalarGenericBlockType | ShapeBlockType | OpaqueBlockType;
+/**
+ * SCREAM: a block type reached the renderer with no dispatch registration.
+ * This is a real defect (a new server/splitter type outran the generated
+ * unions, or a registration was deleted) — the block still renders as basic
+ * markdown so no content is hidden, but the miss is captured loudly
+ * (console.error once per type per session + structured captureError, which
+ * dedupes repeats). Mirrors the reportMediaDurabilityViolation posture:
+ * recover, but never silently.
+ */
+export declare function reportUnregisteredBlockType(type: string, meta: {
+    conversationId?: string;
+    messageId?: string;
+    requestId?: string;
+}): void;
+declare function renderReasoningEntry(ctx: BlockDispatchContext): React.JSX.Element | null;
+export declare const BLOCK_DISPATCH: {
+    thinking: typeof renderReasoningEntry;
+    reasoning: typeof renderReasoningEntry;
+    consolidated_reasoning: (ctx: BlockDispatchContext) => React.JSX.Element | null;
+    info: BlockRenderFn;
+    task: BlockRenderFn;
+    database: BlockRenderFn;
+    private: BlockRenderFn;
+    plan: BlockRenderFn;
+    event: BlockRenderFn;
+    tool: (ctx: BlockDispatchContext) => React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | null;
+    search_replace: ({ block, index, isStreamActive }: BlockDispatchContext) => React.JSX.Element;
+    text: BlockRenderFn;
+    code: (ctx: BlockDispatchContext) => React.JSX.Element | null;
+    table: (ctx: BlockDispatchContext) => React.JSX.Element;
+    image: (ctx: BlockDispatchContext) => React.JSX.Element | null;
+    tree: ({ block, index }: BlockDispatchContext) => React.JSX.Element;
+    "accent-divider": ({ index }: BlockDispatchContext) => React.JSX.Element;
+    "heavy-divider": ({ index }: BlockDispatchContext) => React.JSX.Element;
+    svg: BlockRenderFn;
+    flashcards: BlockRenderFn;
+    quiz: BlockRenderFn;
+    presentation: BlockRenderFn;
+    cooking_recipe: BlockRenderFn;
+    timeline: BlockRenderFn;
+    progress_tracker: BlockRenderFn;
+    comparison_table: BlockRenderFn;
+    troubleshooting: BlockRenderFn;
+    resources: BlockRenderFn;
+    decision_tree: BlockRenderFn;
+    research: BlockRenderFn;
+    diagram: BlockRenderFn;
+    mermaid: BlockRenderFn;
+    math_problem: BlockRenderFn;
+    questionnaire: BlockRenderFn;
+    tasks: BlockRenderFn;
+    chart: BlockRenderFn;
+    map: BlockRenderFn;
+    stats: BlockRenderFn;
+    diff: BlockRenderFn;
+    generic_structured: ({ block, index }: BlockDispatchContext) => React.JSX.Element;
+    markdown_stream: ({ block, index, isStreamActive }: BlockDispatchContext) => React.JSX.Element;
+};
+/** Per-classification membership — exported for the dispatch tests. */
+export declare const BLOCK_DISPATCH_CLASSIFICATION: {
+    readonly protocol: string[];
+    readonly scalar_generic: string[];
+    readonly shape: string[];
+    readonly intentionally_opaque: string[];
+};
+export declare function registerBlockDispatch(entries: Record<string, BlockRenderFn | undefined>): void;
+/**
+ * Resolve a block type's registration, or null when unregistered (the caller
+ * MUST then call `reportUnregisteredBlockType` — never a silent default).
+ */
+export declare function resolveBlockDispatch(type: string): BlockRenderFn | null;
+export {};