@ai-matrx/chat 0.4.2 → 0.4.7

package/dist/host/content-ir-slots.d.ts

@@ -1,235 +0,0 @@
-/**
- * host/content-ir-slots — the app's kind / component registries, region-envelope memo, kind
- * correctors, splitter primitives and shape browser, registered into the package
- * (chat-package-move P14).
- *
- * The stream accumulator and the message selectors need these at call time; the registries are
- * the app's (database-backed kinds, org overrides, `crm` correctors), so the package reaches
- * them through typed function slots and never imports them. The app registers them in
- * `providers/chatContentIrRegistration.ts`. A bare host gets an honest default: no envelope is
- * attached (the block renders as the text it is), no kind schemas are known, nothing is
- * validated — each reported once (Law 4). The splitter primitives have no honest stand-in (they
- * ARE the block classifier), so a host without them fails loudly by name.
- *
- * The slot names extend `ChatUiSlots` by augmentation, so `registerChatUi` accepts them.
- */
-import type { CanonicalBlockIR, KindSchema } from "@ai-matrx/content-ir";
-import type { KindValidator } from "@ai-matrx/content-ir/registry";
-import type { RenderBlockPayload } from "@ai-matrx/agents/generated/stream-events";
-import type { EntityListPage, EntityListQuery, EntityListSort } from "@ai-matrx/records/list";
-import { type ComponentType } from "react";
-/** The registry a streaming parse resolves kind schemas through (the host's `kindRegistry`). */
-export interface ContentIrKindRegistryPort {
-    /** The parser-facing resolver: a sync fast path plus a cold request. */
-    resolver(): {
-        get(kind: string): KindSchema | undefined;
-        request?(kind: string): void;
-    };
-    onSchemaArrived(listener: (kind: string, schema: KindSchema | null) => void): () => void;
-    ensureWarm(): Promise<void>;
-    requestSchema(kind: string): void;
-}
-/** The registry of rendering components per kind (the host's `componentRegistry`). */
-export interface ContentIrComponentRegistryPort {
-    ensureWarm(): Promise<void>;
-    requestComponent(kind: string, platform: string, role: string): void;
-}
-/** The block classifier's text primitives (the host's content splitter). */
-export interface ContentSplitterPrimitives {
-    /** The code languages that open a registered special block rather than plain code. */
-    SPECIAL_CODE_LANGUAGES: readonly string[];
-    detectJsonBlockType(content: string): string | null;
-    parseXmlAttributes(openingTag: string): Record<string, string>;
-    extractAudioLink(line: string): {
-        src: string;
-        alt: string;
-    } | null;
-    detectImageMarkdown(line: string): {
-        isImage: boolean;
-        src?: string;
-        alt?: string;
-    };
-    countInlineImages(line: string): number;
-    detectVideoMarkdown(line: string): {
-        isVideo: boolean;
-        src?: string;
-        alt?: string;
-    };
-    detectMatrxFileMarkdown(line: string): {
-        isMatrxFile: boolean;
-        url?: string;
-        label?: string;
-        pre?: string;
-        post?: string;
-    };
-    isCompleteUnrecognizedXmlContainer(source: string): boolean;
-    isUnclosedGenericXmlOpening(source: string): boolean;
-    startUnrecognizedXmlContainer(line: string): {
-        tracker: UnrecognizedXmlContainerTracker;
-        rootStart: number;
-    } | null;
-    normalizeCodeLanguage(language: string | undefined): string | undefined;
-}
-export interface UnrecognizedXmlContainerTracker {
-    readonly rootTag: string;
-    consumeLine(line: string, startOffset?: number): number | null;
-}
-declare module "./ui-slots" {
-    interface ChatUiSlots {
-        /** Seeds the region-envelope memo with one already-validated envelope. */
-        seedEnvelope: (envelope: CanonicalBlockIR) => void;
-        /** Seeds the memo from a message part's persisted `metadata.__ir` cache; returns the count seeded. */
-        seedPersistedEnvelopeCache: (metadata: Record<string, unknown> | null | undefined) => number;
-        /** Merges the canonical envelope for a region's source into a block's metadata. */
-        withIrEnvelope: (source: string, metadata: Record<string, unknown> | undefined, options?: {
-            allowTerminalError?: boolean;
-        }) => Record<string, unknown> | undefined;
-        /** A finished parse session's envelope, with the host's kind correctors applied. */
-        sessionEnvelope: (session: {
-            buildEnvelope(): CanonicalBlockIR;
-        } | null | undefined) => CanonicalBlockIR | null;
-        /** The envelope for a completed xml region whose tag a surface claims, else null. */
-        envelopeForCompletedXmlRegion: (tag: string, regionText: string) => CanonicalBlockIR | null;
-        /** The envelope for a completed fence region whose language a surface claims, else null. */
-        envelopeForCompletedFenceRegion: (language: string, regionText: string) => CanonicalBlockIR | null;
-        /** The host's kind registry. */
-        contentIrKindRegistry: () => ContentIrKindRegistryPort;
-        /** The host's kind component registry. */
-        contentIrComponentRegistry: () => ContentIrComponentRegistryPort;
-        /** The host's kind validator (the live kind catalog's contracts). */
-        contentIrKindValidator: () => KindValidator;
-        /** A server progress event's `content_ir` as a render block, or null. */
-        progressDataRenderBlock: (data: unknown, eventIndex: number, blockIndex: number) => RenderBlockPayload | null;
-        /** The block classifier's text primitives. */
-        contentSplitterPrimitives: () => ContentSplitterPrimitives;
-        /** Draws a kind instance through the host's one value door (`KindInstanceRender`), same props. */
-        KindInstanceRender: ComponentType<any>;
-        /** The list of records anchored to one thing (the host's `AnchorRecordsList`), same props. */
-        AnchorRecordsList: ComponentType<any>;
-        /** Reads the records anchored to one thing; `enabled` false reads nothing (zero-prefetch). */
-        useAnchorRecords: (anchor: {
-            type: string;
-            id: string;
-        } | null, enabled?: boolean) => AnchorRecordsState;
-        /** One page of the host's shape (kind) catalog. */
-        fetchShapePage: (query: EntityListQuery, sort: EntityListSort) => Promise<EntityListPage<ShapeBrowseRow>>;
-        /** One shape row by kind slug, or null. */
-        fetchShapeByKind: (kind: string) => Promise<ShapeBrowseRow | null>;
-    }
-}
-/** What an anchor's record read reports (the host's `AnchorRecordsState`). */
-export interface AnchorRecordsState {
-    status: "loading" | "ready" | "error";
-    records: readonly unknown[];
-    active: readonly unknown[];
-    archived: readonly unknown[];
-    message: string | null;
-    reload: () => void;
-}
-/** The anchor type of a conversation's own records. */
-export declare const CONVERSATION_ANCHOR_TYPE = "conversation";
-/** A host with no record store shows nothing for the records of a chat (reported once). */
-export declare const KindInstanceRender: ComponentType<any>;
-export declare const AnchorRecordsList: ComponentType<any>;
-/** A host with no record store reads no records: the list stays empty and says nothing is stored here. */
-export declare const useAnchorRecords: (anchor: {
-    type: string;
-    id: string;
-} | null, enabled?: boolean) => AnchorRecordsState;
-/** One row, exactly as the host's shape list returns it. */
-export interface ShapeBrowseRow {
-    access_level: string;
-    authoring_owner: string;
-    created_at: string;
-    created_by: string;
-    description: string;
-    family: string;
-    has_component: boolean;
-    id: string;
-    is_active: boolean;
-    is_owner: boolean;
-    kind: string;
-    label: string;
-    organization_id: string;
-    organization_name: string;
-    origin: string;
-    owner_email: string;
-    total_count: number;
-    updated_at: string;
-    version: number;
-    visibility: string;
-}
-/** A host with no memo seeds nothing: its blocks are parsed fresh each time. */
-export declare const seedEnvelope: (envelope: CanonicalBlockIR) => void;
-export declare const seedPersistedEnvelopeCache: (metadata: Record<string, unknown> | null | undefined) => number;
-/** A host with no region memo attaches no envelope: the block renders as the text it is. */
-export declare const withIrEnvelope: (source: string, metadata: Record<string, unknown> | undefined, options?: {
-    allowTerminalError?: boolean;
-}) => Record<string, unknown> | undefined;
-/** A host with no correctors takes the parse session's own envelope, uncorrected. */
-export declare const sessionEnvelope: (session: {
-    buildEnvelope(): CanonicalBlockIR;
-} | null | undefined) => CanonicalBlockIR | null;
-/** A host with no surface table claims no xml/fence region: the legacy rendering stands. */
-export declare const envelopeForCompletedXmlRegion: (tag: string, regionText: string) => CanonicalBlockIR | null;
-export declare const envelopeForCompletedFenceRegion: (language: string, regionText: string) => CanonicalBlockIR | null;
-/** A host with no kind catalog knows no kind: every kind stays as the text it arrived as. */
-export declare const contentIrKindRegistry: () => ContentIrKindRegistryPort;
-export declare const contentIrComponentRegistry: () => ContentIrComponentRegistryPort;
-/** The accumulator's `kindRegistry` / `componentRegistry`: each call resolves the host's registry at that moment. */
-export declare const kindRegistry: ContentIrKindRegistryPort;
-export declare const componentRegistry: ContentIrComponentRegistryPort;
-/** A host with no kind catalog checks nothing and says so: a skip is never a pass. */
-export declare const contentIrKindValidator: () => KindValidator;
-/** A host with no progress adapter promotes nothing: the event keeps only its ordinary typed data. */
-export declare const progressDataRenderBlock: (data: unknown, eventIndex: number, blockIndex: number) => RenderBlockPayload | null;
-/**
- * The classifier primitives ARE the block classifier, so a bare host gets the real ones from
- * `@ai-matrx/rich-content` (the same module matrx-frontend registers); the stream accumulator
- * threw on the first streamed token without them (P29a canary).
- */
-export declare const contentSplitterPrimitives: () => ContentSplitterPrimitives;
-/** A host with no shape catalog has no shapes to browse: the read says so, the picker shows it. */
-export declare const fetchShapePage: (query: EntityListQuery, sort: EntityListSort) => Promise<EntityListPage<ShapeBrowseRow>>;
-export declare const fetchShapeByKind: (kind: string) => Promise<ShapeBrowseRow | null>;
-/**
- * Ingest guard for SERVER-BUILT envelopes riding `metadata.__ir` on a `render_block` event:
- * valid -> same reference back + seeded into the host's region-envelope memo; malformed ->
- * stripped copy + a loud diagnostic. Semantics live on the pure function in `@ai-matrx/content-ir`.
- */
-export declare function sanitizeInboundEnvelopeMetadata(metadata: Record<string, unknown> | null | undefined, context: {
-    blockId: string;
-}): Record<string, unknown> | undefined;
-export declare const detectJsonBlockType: (content: string) => string | null;
-export declare const parseXmlAttributes: (openingTag: string) => Record<string, string>;
-export declare const extractAudioLink: (line: string) => {
-    src: string;
-    alt: string;
-} | null;
-export declare const detectImageMarkdown: (line: string) => {
-    isImage: boolean;
-    src?: string;
-    alt?: string;
-};
-export declare const countInlineImages: (line: string) => number;
-export declare const detectVideoMarkdown: (line: string) => {
-    isVideo: boolean;
-    src?: string;
-    alt?: string;
-};
-export declare const detectMatrxFileMarkdown: (line: string) => {
-    isMatrxFile: boolean;
-    url?: string;
-    label?: string;
-    pre?: string;
-    post?: string;
-};
-export declare const isCompleteUnrecognizedXmlContainer: (source: string) => boolean;
-export declare const isUnclosedGenericXmlOpening: (source: string) => boolean;
-export declare const startUnrecognizedXmlContainer: (line: string) => {
-    tracker: UnrecognizedXmlContainerTracker;
-    rootStart: number;
-} | null;
-export declare const normalizeCodeLanguage: (language: string | undefined) => string | undefined;
-/** True when `language` opens a registered special block rather than plain code. */
-export declare const isSpecialCodeLanguage: (language: string) => boolean;

package/dist/host/content-ir-slots.js

@@ -1,135 +0,0 @@
-import { sanitizeInboundEnvelopeMetadata as sanitizeInboundEnvelopeMetadataPure } from "@ai-matrx/content-ir";
-import { captureError } from "./diagnostics.js";
-import { createElement } from "react";
-import { hostFn, hostSlot } from "./ui-slots.js";
-import * as splitterCore from "@ai-matrx/rich-content/display/markdown-classification/processors/utils/content-splitter-core";
-const CONVERSATION_ANCHOR_TYPE = "conversation";
-const KindInstanceRender = hostSlot(
-  "KindInstanceRender",
-  ({ value }) => createElement(
-    "pre",
-    { className: "whitespace-pre-wrap break-words text-xs", "data-chat-slot-fallback": "KindInstanceRender" },
-    typeof value === "string" ? value : JSON.stringify(value ?? null, null, 2)
-  )
-);
-const AnchorRecordsList = hostSlot("AnchorRecordsList");
-const useAnchorRecords = hostFn("useAnchorRecords", () => ({
-  status: "ready",
-  records: [],
-  active: [],
-  archived: [],
-  message: null,
-  reload: () => void 0
-}));
-const seedEnvelope = hostFn("seedEnvelope", () => void 0);
-const seedPersistedEnvelopeCache = hostFn("seedPersistedEnvelopeCache", () => 0);
-const withIrEnvelope = hostFn("withIrEnvelope", (_source, metadata) => metadata);
-const sessionEnvelope = hostFn(
-  "sessionEnvelope",
-  (session) => session ? session.buildEnvelope() : null
-);
-const envelopeForCompletedXmlRegion = hostFn("envelopeForCompletedXmlRegion", () => null);
-const envelopeForCompletedFenceRegion = hostFn("envelopeForCompletedFenceRegion", () => null);
-const BARE_KIND_REGISTRY = {
-  resolver: () => ({ get: () => void 0, request: () => void 0 }),
-  onSchemaArrived: () => () => void 0,
-  ensureWarm: async () => void 0,
-  requestSchema: () => void 0
-};
-const BARE_COMPONENT_REGISTRY = {
-  ensureWarm: async () => void 0,
-  requestComponent: () => void 0
-};
-const contentIrKindRegistry = hostFn("contentIrKindRegistry", () => BARE_KIND_REGISTRY);
-const contentIrComponentRegistry = hostFn("contentIrComponentRegistry", () => BARE_COMPONENT_REGISTRY);
-const kindRegistry = {
-  resolver: () => contentIrKindRegistry().resolver(),
-  onSchemaArrived: (listener) => contentIrKindRegistry().onSchemaArrived(listener),
-  ensureWarm: () => contentIrKindRegistry().ensureWarm(),
-  requestSchema: (kind) => contentIrKindRegistry().requestSchema(kind)
-};
-const componentRegistry = {
-  ensureWarm: () => contentIrComponentRegistry().ensureWarm(),
-  requestComponent: (kind, platform, role) => contentIrComponentRegistry().requestComponent(kind, platform, role)
-};
-const contentIrKindValidator = hostFn("contentIrKindValidator", () => ({
-  validate: async (_value, kind) => ({
-    kind,
-    checked: false,
-    ok: false,
-    errors: ["This host has no kind catalog to check against (registerChatUi contentIrKindValidator)."],
-    degradedReason: "catalog_unreachable"
-  }),
-  cachedSchema: async () => null,
-  invalidate: () => void 0
-}));
-const progressDataRenderBlock = hostFn("progressDataRenderBlock", () => null);
-const contentSplitterPrimitives = hostFn(
-  "contentSplitterPrimitives",
-  () => splitterCore
-);
-const fetchShapePage = hostFn("fetchShapePage", async () => {
-  throw new Error("This host has no shape catalog (registerChatUi fetchShapePage)");
-});
-const fetchShapeByKind = hostFn("fetchShapeByKind", async () => {
-  throw new Error("This host has no shape catalog (registerChatUi fetchShapeByKind)");
-});
-function sanitizeInboundEnvelopeMetadata(metadata, context) {
-  return sanitizeInboundEnvelopeMetadataPure(metadata, context, {
-    seedEnvelope: (envelope) => seedEnvelope(envelope),
-    reportMalformed: ({ blockId, engine, raw }) => {
-      captureError({
-        source: "content-ir",
-        message: `render_block "${blockId}" carried a malformed metadata.__ir envelope (engine "${engine}") \u2014 dropped before Redux so it can't poison the pipeline`,
-        relation: engine,
-        raw
-      });
-    }
-  });
-}
-const detectJsonBlockType = (content) => contentSplitterPrimitives().detectJsonBlockType(content);
-const parseXmlAttributes = (openingTag) => contentSplitterPrimitives().parseXmlAttributes(openingTag);
-const extractAudioLink = (line) => contentSplitterPrimitives().extractAudioLink(line);
-const detectImageMarkdown = (line) => contentSplitterPrimitives().detectImageMarkdown(line);
-const countInlineImages = (line) => contentSplitterPrimitives().countInlineImages(line);
-const detectVideoMarkdown = (line) => contentSplitterPrimitives().detectVideoMarkdown(line);
-const detectMatrxFileMarkdown = (line) => contentSplitterPrimitives().detectMatrxFileMarkdown(line);
-const isCompleteUnrecognizedXmlContainer = (source) => contentSplitterPrimitives().isCompleteUnrecognizedXmlContainer(source);
-const isUnclosedGenericXmlOpening = (source) => contentSplitterPrimitives().isUnclosedGenericXmlOpening(source);
-const startUnrecognizedXmlContainer = (line) => contentSplitterPrimitives().startUnrecognizedXmlContainer(line);
-const normalizeCodeLanguage = (language) => contentSplitterPrimitives().normalizeCodeLanguage(language);
-const isSpecialCodeLanguage = (language) => contentSplitterPrimitives().SPECIAL_CODE_LANGUAGES.includes(language);
-export {
-  AnchorRecordsList,
-  CONVERSATION_ANCHOR_TYPE,
-  KindInstanceRender,
-  componentRegistry,
-  contentIrComponentRegistry,
-  contentIrKindRegistry,
-  contentIrKindValidator,
-  contentSplitterPrimitives,
-  countInlineImages,
-  detectImageMarkdown,
-  detectJsonBlockType,
-  detectMatrxFileMarkdown,
-  detectVideoMarkdown,
-  envelopeForCompletedFenceRegion,
-  envelopeForCompletedXmlRegion,
-  extractAudioLink,
-  fetchShapeByKind,
-  fetchShapePage,
-  isCompleteUnrecognizedXmlContainer,
-  isSpecialCodeLanguage,
-  isUnclosedGenericXmlOpening,
-  kindRegistry,
-  normalizeCodeLanguage,
-  parseXmlAttributes,
-  progressDataRenderBlock,
-  sanitizeInboundEnvelopeMetadata,
-  seedEnvelope,
-  seedPersistedEnvelopeCache,
-  sessionEnvelope,
-  startUnrecognizedXmlContainer,
-  useAnchorRecords,
-  withIrEnvelope
-};

package/dist/host/markdown-slots.d.ts

@@ -1,53 +0,0 @@
-/**
- * host/markdown-slots — the app's rich-document rendering engine, registered into the package
- * (chat-package-move P14).
- *
- * `MarkdownStream` and `BasicMarkdownContent` are the host's ONE rendering pipeline (block
- * registry, kind routing, code highlighting, app-owned blocks that read app data). The package
- * draws through these slots and never imports that engine. The app registers them in
- * `providers/chatMarkdownRegistration.ts`; a bare host shows the text exactly as written,
- * marked `data-chat-slot-fallback`, and the missing renderer is reported once (Law 4).
- *
- * The slot names extend `ChatUiSlots` by augmentation, so `registerChatUi` accepts them.
- */
-import { type ComponentType } from "react";
-import type { MessageCitationSource } from "../agents/redux/execution-system/messages/message-citations.js";
-/** The engine's props the package's call sites rely on being typed; the rest pass through as written. */
-export interface MarkdownStreamSlotProps {
-    content?: string;
-    className?: string;
-    /** `previousContent` is the text the edit applied to; `remark` names an answer edit. */
-    onContentChange?: (newContent: string, previousContent: string, remark?: any) => void;
-    [prop: string]: any;
-}
-declare module "./ui-slots" {
-    interface ChatUiSlots {
-        /** The streaming rich-document engine (the host's `MarkdownStream`), same props. */
-        MarkdownStream: ComponentType<MarkdownStreamSlotProps>;
-        /** The host's plain markdown leaf (`BasicMarkdownContent`), same props. */
-        BasicMarkdownContent: ComponentType<any>;
-        /** The placeholder while a spoken answer's audio is being made. */
-        AudioOutputBlockSkeleton: ComponentType<any>;
-        /** Opens one numbered message source (the host's Source Inspector): returns `(source) => void`. */
-        useOpenCitationSource: () => (source: MessageCitationSource) => void;
-        /** Draws every mermaid diagram under a root (print / DOM capture); resolves when done. */
-        renderAllDiagrams: (...args: any[]) => Promise<{
-            release: () => void;
-        }>;
-        /** One mermaid source drawn for print (SVG markup), the host's lazy diagram engine. */
-        drawMermaidForPrint: (...args: any[]) => Promise<any>;
-    }
-}
-export declare const MarkdownStream: ComponentType<MarkdownStreamSlotProps>;
-export declare const BasicMarkdownContent: ComponentType<any>;
-/** A host with no audio placeholder shows nothing while the audio is made (reported once). */
-export declare const AudioOutputBlockSkeleton: ComponentType<any>;
-/** A host with no Source Inspector opens a web source in a new tab; a file source has no target here. */
-export declare const useOpenCitationSource: () => (source: MessageCitationSource) => void;
-/** A host with no diagram engine draws nothing extra: diagrams stay as drawn (or as source). */
-export declare const renderAllDiagrams: (...args: any[]) => Promise<{
-    release: () => void;
-}>;
-/** A host with no diagram engine cannot draw for print; the print path prints the source and says so. */
-export declare const drawMermaidForPrint: (...args: any[]) => Promise<any>;
-export default MarkdownStream;

package/dist/host/markdown-slots.js

@@ -1,32 +0,0 @@
-"use client";
-import { createElement } from "react";
-import { hostFn, hostSlot } from "./ui-slots.js";
-function plainText(name) {
-  const PlainText = ({ content, className }) => createElement(
-    "div",
-    { className: `whitespace-pre-wrap break-words text-sm ${className ?? ""}`, "data-chat-slot-fallback": name },
-    typeof content === "string" ? content : ""
-  );
-  PlainText.displayName = `PlainText(${name})`;
-  return PlainText;
-}
-const MarkdownStream = hostSlot("MarkdownStream", plainText("MarkdownStream"));
-const BasicMarkdownContent = hostSlot("BasicMarkdownContent", plainText("BasicMarkdownContent"));
-const AudioOutputBlockSkeleton = hostSlot("AudioOutputBlockSkeleton");
-const useOpenCitationSource = hostFn("useOpenCitationSource", () => (source) => {
-  if (source.url && typeof window !== "undefined") window.open(source.url, "_blank", "noopener,noreferrer");
-});
-const renderAllDiagrams = hostFn("renderAllDiagrams", async () => ({ release: () => void 0 }));
-const drawMermaidForPrint = hostFn("drawMermaidForPrint", async () => {
-  throw new Error("This host has no diagram engine (registerChatUi drawMermaidForPrint)");
-});
-var markdown_slots_default = MarkdownStream;
-export {
-  AudioOutputBlockSkeleton,
-  BasicMarkdownContent,
-  MarkdownStream,
-  markdown_slots_default as default,
-  drawMermaidForPrint,
-  renderAllDiagrams,
-  useOpenCitationSource
-};

package/dist/host/rich-document-slots.d.ts

@@ -1,123 +0,0 @@
-/**
- * host/rich-document-slots — the app's rich-document action registry, dialogs host and record
- * annotations, registered into the package (chat-package-move P14).
- *
- * Every action under a chat message (thumbs, read aloud, edit, regenerate, print, convert, the
- * Alchemy copy menu, the right-click menu) comes from the host's ONE rich-document registry
- * (`features/rich-document`), and so do its dialogs and the highlight/comment sidecar. The package
- * draws them through these slots and never imports them; the app registers them in
- * `providers/chatRichDocumentRegistration.ts`. A bare host draws no action bar, menu or
- * annotation layer — the message and its text stay exactly as they are — and the missing
- * capability is reported once (Law 4).
- *
- * The slot names extend `ChatUiSlots` by augmentation, so `registerChatUi` accepts them.
- */
-import { type ComponentType, type ReactNode } from "react";
-/** What a rich document is the text of (the host's `ContentSource`); `type` names the kind of thing. */
-export interface RichDocumentSource {
-    type: string;
-    readOnly?: boolean;
-    [prop: string]: unknown;
-}
-/** The facts the host's registry needs to offer one chat message's actions. */
-export interface ChatMessageActionFacts {
-    conversationId: string;
-    messageId: string;
-    role: "assistant" | "user";
-    messageContent: string;
-    contentIsStructuredRaw?: boolean;
-    turnContent?: string | null;
-    editTarget?: {
-        messageId: string;
-        content: string;
-        isStructuredRaw: boolean;
-    } | null;
-    metadata?: Record<string, unknown> | null;
-    streamRequestId?: string | null;
-    contentHistoryCount?: number;
-    groupMessageIds?: string[];
-    isCreator?: boolean;
-    surfaceKey?: string | null;
-    showFullPrint?: boolean;
-    isCapturing?: boolean;
-    callbacks?: Record<string, unknown>;
-}
-/** What the host's registry hands back for one message: the text, its source and the action set. */
-export interface ChatMessageActionConfig {
-    content: string;
-    source: RichDocumentSource;
-    actions: any;
-}
-/** The host's dialogs for the actions it offers: merge `callbacks` into the actions, render `dialogs` once. */
-export interface DocumentDialogsHost {
-    callbacks: Record<string, any>;
-    dialogs: ReactNode;
-}
-/** What a saved answer / note / document is, to the annotation layer (the host's `AnnotationSource`). */
-export interface AnnotationRecord {
-    token: string;
-    id: string;
-    title?: string;
-    href?: string;
-    conversationId?: string;
-}
-declare module "./ui-slots" {
-    interface ChatUiSlots {
-        /** The action bar for a document (the host's `RichDocumentActions`), same props. */
-        RichDocumentActions: ComponentType<any>;
-        /** Right-click menu around a document's content (the host's `RegistryContextMenu`), same props. */
-        RegistryContextMenu: ComponentType<any>;
-        /** The ⋯ menu for a document (the host's `RegistryActionMenu`), same props. */
-        RegistryActionMenu: ComponentType<any>;
-        /** Headless: registers a document's actions for a surface id (the host's `RichDocumentActionProvider`). */
-        RichDocumentActionProvider: ComponentType<any>;
-        /** Draws a registered surface's actions as a bar or a menu (the host's `RichDocumentActionSurface`). */
-        RichDocumentActionSurface: ComponentType<any>;
-        /** The highlight / comment / suggest layer around a saved record (the host's `RecordAnnotations`). */
-        RecordAnnotations: ComponentType<any>;
-        /** The ONE builder from a chat message to its rich-document action configuration. */
-        buildChatMessageActions: (facts: any) => ChatMessageActionConfig;
-        /** The lineage origin a converted message points back at, or null when it has none. */
-        convertOriginForSource: (source: any, title: string) => unknown;
-        /** The host's dialogs for a document's actions (hook). */
-        useDocumentDialogsHost: (args: {
-            convertOrigin: any;
-            text: string;
-            writable?: boolean;
-            chatMessage?: {
-                conversationId: string;
-                messageId: string;
-                surfaceKey: string | null;
-            } | null;
-        }) => DocumentDialogsHost;
-        /** The annotation identity of a source (a saved chat answer, a note), or null when it has none. */
-        annotationRecordOf: (source: any) => AnnotationRecord | null;
-        /** Binds a conversation to the apply target a review-and-apply session will write back into. */
-        bindConversationToApplyTarget: (conversationId: string, applyTargetId: string) => void;
-    }
-}
-/** A host with no action registry offers no actions under a message: nothing is drawn (reported once). */
-export declare const RichDocumentActions: ComponentType<any>;
-export declare const RegistryActionMenu: ComponentType<any>;
-export declare const RichDocumentActionProvider: ComponentType<any>;
-/** A host with no registry draws a surface's own `fallback`, as the surface already allows. */
-export declare const RichDocumentActionSurface: ComponentType<any>;
-/** A host with no menu registry leaves the content as it is: no right-click actions, the children draw. */
-export declare const RegistryContextMenu: ComponentType<any>;
-/** A host with no annotation layer leaves the record's content as it is. */
-export declare const RecordAnnotations: ComponentType<any>;
-/** A host with no registry derives no actions: the message text and its source, an empty action set. */
-export declare const buildChatMessageActions: (facts: any) => ChatMessageActionConfig;
-export declare const convertOriginForSource: (source: any, title: string) => unknown;
-export declare const useDocumentDialogsHost: (args: {
-    convertOrigin: any;
-    text: string;
-    writable?: boolean;
-    chatMessage?: {
-        conversationId: string;
-        messageId: string;
-        surfaceKey: string | null;
-    } | null;
-}) => DocumentDialogsHost;
-export declare const annotationRecordOf: (source: any) => AnnotationRecord | null;
-export declare const bindConversationToApplyTarget: (conversationId: string, applyTargetId: string) => void;

package/dist/host/rich-document-slots.js

@@ -1,36 +0,0 @@
-import { createElement } from "react";
-import { hostFn, hostSlot } from "./ui-slots.js";
-const RichDocumentActions = hostSlot("RichDocumentActions");
-const RegistryActionMenu = hostSlot("RegistryActionMenu");
-const RichDocumentActionProvider = hostSlot("RichDocumentActionProvider");
-const RichDocumentActionSurface = hostSlot("RichDocumentActionSurface", ({ fallback }) => fallback ?? null);
-const RegistryContextMenu = hostSlot(
-  "RegistryContextMenu",
-  ({ children }) => createElement("div", { className: "contents", "data-chat-slot-fallback": "RegistryContextMenu" }, children)
-);
-const RecordAnnotations = hostSlot(
-  "RecordAnnotations",
-  ({ children }) => createElement("div", { className: "contents", "data-chat-slot-fallback": "RecordAnnotations" }, children)
-);
-const buildChatMessageActions = hostFn("buildChatMessageActions", (facts) => ({
-  content: facts.turnContent ?? facts.messageContent,
-  source: { type: "chat-message", conversationId: facts.conversationId, messageId: facts.messageId },
-  actions: { callbacks: facts.callbacks ?? {} }
-}));
-const convertOriginForSource = hostFn("convertOriginForSource", () => null);
-const useDocumentDialogsHost = hostFn("useDocumentDialogsHost", () => ({ callbacks: {}, dialogs: null }));
-const annotationRecordOf = hostFn("annotationRecordOf", () => null);
-const bindConversationToApplyTarget = hostFn("bindConversationToApplyTarget", () => void 0);
-export {
-  RecordAnnotations,
-  RegistryActionMenu,
-  RegistryContextMenu,
-  RichDocumentActionProvider,
-  RichDocumentActionSurface,
-  RichDocumentActions,
-  annotationRecordOf,
-  bindConversationToApplyTarget,
-  buildChatMessageActions,
-  convertOriginForSource,
-  useDocumentDialogsHost
-};

package/dist/utils/content-ir/report-kind-at-raw-renderer.d.ts

@@ -1,19 +0,0 @@
-/**
- * THE BOTTOM-LAYER REPORT — a low-level raw renderer (a markdown leaf, the
- * value grid, a JSON viewer, the JSON code card) was handed kind data. It has
- * already rendered the data as its kind; this files the CALLER in the Error
- * Inspector so the screen that skipped the value door is found and fixed
- * (Arman, 2026-09-30: a `__kind` is never drawn as raw JSON). Checklist C4:
- * `features/content-ir/docs/KIND_NEVER_RAW_CHECKLIST.md`.
- *
- * Once per component + slug per session: a render loop must not flood the
- * inspector. The owner stack (development builds) names the caller.
- */
-export declare function reportKindAtRawRenderer(component: string, slug: string | null, ownerStack?: string | null): void;
-/** Test seam: forget what was reported. */
-export declare function resetKindAtRawRendererReports(): void;
-/**
- * Report from a component's render. The owner stack is read during render
- * (the only time React has it) and filed after commit.
- */
-export declare function useReportKindAtRawRenderer(component: string, slug: string | null, active: boolean): void;