@ai-matrx/content-ir-react 0.19.1 → 0.20.1

package/dist/host.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../host.ts","../host/error-report.ts","../host/host-types.ts","../host/ContentIrProvider.tsx","../directives/directive-host.tsx"],"sourcesContent":["/**\n * `@ai-matrx/content-ir-react/host` — the contract every consumer wires once:\n * the scream seam, the host/seam types, and the React provider.\n *\n * NOTE: this entry is stamped \"use client\" (it carries the provider). The\n * TYPES here are importable from anywhere; a server-side module that needs\n * only pure route logic imports `/route` instead.\n */\nexport * from \"./host/error-report\";\nexport * from \"./host/host-types\";\nexport * from \"./host/ContentIrProvider\";\n","/**\n * THE SCREAM SEAM.\n *\n * Every recovery path in this package is loud: a defective component row, a\n * failed resolver load, a kind whose component throws on a provisional value.\n * The package refuses to own where those screams land — matrx-frontend routes\n * them to the Error Inspector, the dashboard to its own log, the extension to\n * its background page. Each host binds one function.\n *\n * A host that binds a no-op has chosen silence, which is a defect in itself;\n * {@link consoleErrorReporter} is the honest default.\n */\n\nexport interface ContentIrErrorReport {\n  /** Always `\"content-ir\"` — hosts key their capture stores on it. */\n  source: \"content-ir\";\n  message: string;\n  name?: string;\n  stack?: string;\n  /** Free-form grouping key (the host's `relation`), e.g. `\"partial-kind\"`. */\n  relation?: string;\n  raw?: unknown;\n}\n\nexport type ContentIrErrorReporter = (report: ContentIrErrorReport) => void;\n\n/** The default when a host binds nothing: never silent. */\nexport const consoleErrorReporter: ContentIrErrorReporter = (report) => {\n  console.error(`[content-ir] ${report.message}`, report.raw ?? \"\");\n};\n","/**\n * THE HOST CONTRACT — everything this package refuses to decide.\n *\n * The kernel (`@ai-matrx/content-ir`) proved the shape: extract the portable\n * part, let host capability enter through explicit named seams. The render\n * layer needs four things it must never own:\n *\n *  1. WHERE KIND DEFINITIONS COME FROM (a bundled table, `content_ir`, a REST\n *     call). The route only asks \"is this kind registered, and does it carry a\n *     legacy bridge / a partial-ready opt-in\".\n *  2. WHERE COMPONENT ROWS COME FROM — {@link ComponentResolutionSource}. The\n *     package ships `ComponentResolver`, which any host can construct with its\n *     own loaders; a host with its own resolver only has to satisfy the type.\n *  3. HOW A ROUTED BLOCK ACTUALLY DRAWS. `applyIrKindRoute` decides a block's\n *     TYPE; turning that type into pixels is the host's dispatch table\n *     (matrx-frontend's `BlockRenderer`, the dashboard's small map). The\n *     package never imports a component library.\n *  4. WHERE SCREAMS LAND — {@link ContentIrErrorReporter}.\n *\n * No Next.js, no Redux, no Supabase, no router, no host error capture. If a\n * seam is missing, ADD A SEAM — never an import.\n */\n\nimport type { ReactNode } from \"react\";\nimport type { KindDefinition } from \"@ai-matrx/content-ir\";\nimport type { ContentIrErrorReporter } from \"./error-report\";\nimport type { ComponentResolutionSource } from \"../resolver/component-resolution.types\";\nimport type { DirectiveHost } from \"../directives/directive-host\";\n\n/**\n * The minimum a render block must expose for the kind route to work. Hosts\n * pass their own richer block type through; the route is generic over `T` and\n * preserves every extra field.\n */\nexport interface IrRoutableBlock {\n  type: string;\n  serverData?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n}\n\n/** A routable block that also carries its source text (the raw region). */\nexport interface IrRenderBlock extends IrRoutableBlock {\n  content: string;\n  language?: string;\n}\n\n/**\n * Where registered kinds come from. `getDefinition` is the only method the\n * pure route needs; the rest drive the granular repaint and the warm-up tick\n * that keeps a cold registry from being mistaken for \"this kind has no\n * component\".\n */\nexport interface KindDefinitionSource {\n  getDefinition(kind: string): KindDefinition | undefined;\n  /** Monotonic per-kind version — the repaint snapshot key. */\n  getKindVersion(kind: string): number;\n  subscribeKind(kind: string, listener: () => void): () => void;\n  /** One definition load per app session. */\n  ensureWarm(): Promise<void>;\n}\n\n/**\n * The rendering seams. Everything here returns host UI; the package supplies\n * the DECISIONS and the chrome-free structure around them.\n */\nexport interface ContentIrRenderSeams {\n  /**\n   * Draw a block the kind route has already typed. This is the host's dispatch\n   * table — the single place a component key becomes a component.\n   */\n  renderBlock(block: IrRenderBlock): ReactNode;\n  /**\n   * THE FLOOR: render ANY JSON value as a human document. Reached when a kind\n   * has no render-trusted component, when the value is not an object at all,\n   * and by the generic structured view.\n   *\n   * This is deliberately a seam and not a bundled component. Rendering a value\n   * WELL means prose through the host's markdown renderer, media through the\n   * host's file handler, and uniform arrays through the host's data table —\n   * all of which are host property. A host that has none of those can pass a\n   * `<pre>`; it will be honest, just plain.\n   */\n  renderValue(props: StructuredValueRenderProps): ReactNode;\n  /**\n   * The \"still arriving\" indicator used by the provisional frame. Optional —\n   * hosts without a shimmer get plain text.\n   */\n  renderShimmer?(text: string): ReactNode;\n  /**\n   * The honest \"this shape has no custom component yet\" notice. Optional: the\n   * package draws a plain amber line when a host supplies nothing, and a host\n   * with an icon set or its own callout component supplies that instead. It is\n   * a seam and not a bundled component because this package depends on no icon\n   * library.\n   */\n  renderNotice?(text: string): ReactNode;\n}\n\nexport interface StructuredValueRenderProps {\n  value: unknown;\n  /** The kind slug this value claims, when known. Honesty line only — never a renderer choice. */\n  kind?: string;\n  /** Why this shape has no custom view, in human words. */\n  note?: string;\n  /** Show the \"what this is / raw data\" footer. Default true. */\n  footer?: boolean;\n}\n\n/**\n * One host, wired once, read by every component in this package through\n * {@link ContentIrRenderProvider}.\n */\nexport interface ContentIrHost extends ContentIrRenderSeams {\n  kinds: KindDefinitionSource;\n  components: ComponentResolutionSource;\n  reportError: ContentIrErrorReporter;\n  /**\n   * The `kind_component.platform` this host resolves as. \"web\" for every\n   * browser UI; the column already models \"react-native\" and friends, and a\n   * host that lies here renders the wrong component everywhere.\n   */\n  platform: string;\n  /**\n   * The Kind Directives seams (apply / open item / copy / noun catalog / item\n   * kind). Optional: a host without them still renders every directive card,\n   * apply-less and copy-less — honest chrome, never hidden content. Provided\n   * to the directive tier by `ContentIrRenderProvider`; a host that has not\n   * adopted the render provider mounts `DirectiveHostProvider` directly.\n   */\n  directives?: DirectiveHost;\n}\n\n/**\n * The pure route's dependencies — a strict subset of {@link ContentIrHost},\n * because `applyIrKindRoute` is called OUTSIDE React (reducers, stream\n * accumulators, tests) where there is no provider to read.\n */\nexport interface KindRouteEnv {\n  kinds: Pick<KindDefinitionSource, \"getDefinition\">;\n  /**\n   * `hasSettled` is optional and read ONLY to suppress a negative verdict from\n   * a registry that has not loaded yet — see THE COLD-VERDICT RULE on\n   * `ComponentResolutionSource`.\n   */\n  components: Pick<ComponentResolutionSource, \"resolve\"> &\n    Partial<Pick<ComponentResolutionSource, \"hasSettled\">>;\n  reportError: ContentIrErrorReporter;\n  platform: string;\n}\n\n/** Narrow a host (or anything host-shaped) to what the pure route needs. */\nexport function routeEnvOf(host: ContentIrHost): KindRouteEnv {\n  return {\n    kinds: host.kinds,\n    components: host.components,\n    reportError: host.reportError,\n    platform: host.platform,\n  };\n}\n","\"use client\";\n\n/**\n * The one place a host is wired in. Everything React in this package reads its\n * capability from here — no module singleton, no import into an app.\n *\n * A host mounts this ONCE, high enough that every kind-rendering surface is\n * inside it:\n *\n * ```tsx\n * <ContentIrRenderProvider host={matrxContentIrHost}>\n *   <App />\n * </ContentIrRenderProvider>\n * ```\n *\n * Reading it outside a provider THROWS rather than falling back to a default.\n * A silent default would render the wrong component for every kind in the app\n * and look like a data problem for weeks.\n */\n\nimport { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type { ContentIrHost, KindRouteEnv } from \"./host-types\";\nimport { routeEnvOf } from \"./host-types\";\nimport { DirectiveHostProvider } from \"../directives/directive-host\";\n\nconst ContentIrHostContext = createContext<ContentIrHost | null>(null);\n\nexport interface ContentIrRenderProviderProps {\n  host: ContentIrHost;\n  children: ReactNode;\n}\n\nexport function ContentIrRenderProvider({\n  host,\n  children,\n}: ContentIrRenderProviderProps) {\n  return (\n    <ContentIrHostContext.Provider value={host}>\n      <DirectiveHostProvider host={host.directives ?? {}}>{children}</DirectiveHostProvider>\n    </ContentIrHostContext.Provider>\n  );\n}\n\n/**\n * The wired host, or null. For the rare consumer that can legitimately run\n * without a provider because it was handed its sources explicitly (see\n * `useContentIrKindVersion`). Everything else uses {@link useContentIrHost}.\n */\nexport function useContentIrHostOrNull(): ContentIrHost | null {\n  return useContext(ContentIrHostContext);\n}\n\n/** The wired host. Throws outside a provider — see the module doc. */\nexport function useContentIrHost(): ContentIrHost {\n  const host = useContentIrHostOrNull();\n  if (!host) {\n    throw new Error(\n      \"[content-ir-react] No ContentIrRenderProvider above this component. \" +\n        \"Mount one at the app root with your host adapter (kind definitions, \" +\n        \"component resolver, renderBlock, renderValue, reportError).\",\n    );\n  }\n  return host;\n}\n\n/** The wired host narrowed to what the pure route functions take. */\nexport function useKindRouteEnv(): KindRouteEnv {\n  const host = useContentIrHost();\n  return useMemo(() => routeEnvOf(host), [host]);\n}\n","\"use client\";\n\n/**\n * THE DIRECTIVE HOST CONTRACT — what the directive tier refuses to decide.\n *\n * The package owns the DECISIONS (decode → renderer → card → floor, the\n * position law, never-null rendering) and the card itself. Four things stay\n * host property and enter through named seams:\n *\n *  1. APPLYING a side-effect directive — `POST /directives/confirm` as the\n *     user, with the host's auth and base URL. Absent → the Apply control is\n *     ABSENT (honest), never a dead button.\n *  2. OPENING an item to read it before approving — a window panel, a dialog,\n *     a route. Absent → items are not clickable.\n *  3. COPY controls — host chrome (matrx-frontend's CopyButtons). Absent → none.\n *  4. The NOUN catalog + item-kind lookup — server-derived tables the host\n *     mirrors (or reads from its kind catalog's `items` edges).\n *  5. ASKING (`ask`), NAMING a record (`renderRecord`), and READING the ledger\n *     (`applyState`) — the consequence before the click, the doors, and the\n *     state that survives a reload.\n *\n * A host that has adopted `ContentIrRenderProvider` passes `directives` on its\n * ContentIrHost; a host that has NOT (Workflow Studio, 2026-09-08) mounts\n * `DirectiveHostProvider` alone — the directive tier never requires the full\n * render host, because a chat bubble must be able to draw a directive card\n * identically everywhere, today.\n */\n\nimport { createContext, useContext, type ReactNode } from \"react\";\nimport type {\n  DecodedDirective,\n  DirectiveItemKindLookup,\n  DirectiveNounCatalog,\n} from \"@ai-matrx/content-ir\";\n\nexport interface DirectiveApplyResult {\n  applied: number;\n  failed: number;\n  /**\n   * The server's own receipt sentence (\"Deleted task “Ship it”.\"), shown in\n   * place of a bare count. Never composed client-side.\n   */\n  message?: string | null;\n  /**\n   * The records the apply created or changed, so the tally is a way IN to them\n   * (no dead ends). Rendered through `renderRecord`; absent → the sentence alone.\n   */\n  records?: DirectiveRecordRef[];\n  /**\n   * For an UPDATE: what each item's fields held just BEFORE the write, by item\n   * index (`null` for an item the server did not record). The card draws the\n   * applied change from this record — never from a live re-read, which after the\n   * apply answers the NEW value (G6A review, 2026-10-02: \"(no change)\" for a\n   * change that happened).\n   */\n  before?: ReadonlyArray<Record<string, unknown> | null>;\n}\n\n/**\n * What the server's action ledger says about ONE block, read on mount so a\n * reloaded page never offers \"Apply\" for work that already ran (reviewer\n * defect 5, 2026-10-02).\n *\n *  - `not_applied` — still to do (or partly done: the batch re-applies, and the\n *    server replays the members it already holds). The card offers Apply.\n *  - `in_flight` — another request is applying it right now. The card says it\n *    is finishing and asks again shortly; it offers neither Apply nor a tally.\n *  - `applied` — the ledger holds every item. The card shows the tally exactly\n *    as a fresh apply would: the ledger's own sentence and the records, as doors.\n */\nexport interface DirectiveApplyState {\n  state: \"not_applied\" | \"in_flight\" | \"applied\";\n  /** The ledger row's sentence (\"Created task.\"), never composed client-side. */\n  message?: string | null;\n  /**\n   * The records the LATEST apply wrote — the tally's doors. After \"Run again\"\n   * that is the newest copy, never the first.\n   */\n  records?: DirectiveRecordRef[];\n  /**\n   * How many times the ledger holds this block as applied: 1 for the original,\n   * one more for every \"Run again\". Absent → 1. A create that ran twice made\n   * two records, and the card says so (reviewer, 2026-10-02).\n   */\n  copies?: number;\n  /**\n   * For an applied UPDATE: each item's replaced values, by item index, from the\n   * ledger row (`null` where the ledger has none — a row from before 2026-10-02).\n   * Absent → the card says only what each field was set to.\n   */\n  before?: ReadonlyArray<Record<string, unknown> | null>;\n}\n\n/** One record a directive names: the noun it is, and its id. */\nexport interface DirectiveRecordRef {\n  noun: string;\n  id: string;\n}\n\nexport interface DirectiveRecordProps extends DirectiveRecordRef {\n  /**\n   * What to show until (or unless) the host resolves the live name —\n   * \"Task 1a2b3c4d\". Never blank, never \"Item\".\n   */\n  fallback: string;\n  /** Where it is drawn: an item row, the confirm dialog, or the applied tally. */\n  context: \"row\" | \"dialog\" | \"applied\";\n  /**\n   * True when the record is (about to be) in the trash — the host may still\n   * name it but should not promise it opens as a live record.\n   */\n  trashed?: boolean;\n}\n\n/** What the person is being asked to approve — everything the card knows. */\nexport interface DirectiveAskRequest {\n  directive: DecodedDirective;\n  /** The items, exactly as they will be sent. */\n  items: Record<string, unknown>[];\n  /** The noun's human label (\"Task\"), from the host's catalog when it has one. */\n  nounLabel: string;\n  /**\n   * True for \"Run again\": the ledger already holds this block, and a yes runs\n   * it a SECOND time (`force`) — another copy for a create, the same fields\n   * written again for an update, another delete for a restored record. The\n   * question must say so.\n   */\n  again?: boolean;\n}\n\n/**\n * The shell a card hands its host — the two keys, plus WHERE it sits.\n *\n * `conversationId` is the conversation the card renders in (a chat message),\n * absent in a person's own content (a note). It is the idempotency NAMESPACE:\n * a card in an agent's message must apply under the SAME key as that\n * proposal's Approve button, or the one action could run twice.\n */\nexport interface DirectiveShell {\n  __kind: string;\n  items: Record<string, unknown>[];\n  conversationId?: string;\n  /** \"Run again\": skip the ledger's dedup and apply a second time. */\n  force?: boolean;\n}\n\nexport interface DirectiveOpenItemOptions {\n  /** The item, `__kind`-stamped when the shape has an item kind. */\n  item: Record<string, unknown>;\n  /** The content-IR kind this item IS, or null when the shape has none. */\n  itemKind: string | null;\n  /** What the item is called — the same title the card shows. */\n  title: string;\n  /** \"Run Create agent definition · item 1 of 1\". */\n  subtitle: string | null;\n  directive: DecodedDirective;\n  index: number;\n  total: number;\n}\n\nexport interface DirectiveCopyProps {\n  label: string;\n  /** The value to copy — the whole shell or one item. */\n  value: unknown;\n  /** The item's kind, when copying an item. */\n  kind?: string | null;\n  size: \"icon\" | \"xs\";\n}\n\nexport interface DirectiveHost {\n  /**\n   * Apply a side-effect directive as the user (the server re-validates every\n   * item against the registered model and runs the ONE handler; idempotent).\n   * Reject with an Error whose message is safe to show.\n   */\n  confirm?: (shell: DirectiveShell) => Promise<DirectiveApplyResult>;\n  /**\n   * Ask the person BEFORE anything runs, naming the consequence (the records,\n   * what changes). Resolve `true` to go ahead, `false` to leave the card as it\n   * was. The Apply control stays idle while this is open — nothing reads as\n   * \"applying\" until the person has said yes. Absent → `confirm` is called\n   * directly (a host that asks inside `confirm` keeps working, but its card\n   * will read \"Applying…\" while its dialog is up).\n   */\n  ask?: (request: DirectiveAskRequest) => Promise<boolean>;\n  /**\n   * Has this exact block already been applied? Read ONCE when the card mounts\n   * (and again while the answer is `in_flight`), so the card survives a reload:\n   * the server ledger, not component state, is what knows. The identity is the\n   * server's (it hashes the validated items in the same namespace `confirm`\n   * applies in), so a host asks — it never computes. Batch on the host side if\n   * a page carries many cards. Reject with an Error when the ledger cannot be\n   * read: the card reports it and offers Apply, which is safe because `confirm`\n   * is idempotent. Absent → the card starts at Apply, as before.\n   */\n  applyState?: (shell: DirectiveShell) => Promise<DirectiveApplyState>;\n  /**\n   * Read the CURRENT values of ONE existing record, so an update says what it\n   * replaces — \"Status open → done\", never just \"→ done\" (reviewer,\n   * 2026-10-02). Resolve `null` when the record cannot be read (no access, no\n   * such record, a noun the host cannot read); reject only for a real failure.\n   * Absent → an update row shows the new values alone, as before.\n   */\n  readRecord?: (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;\n  /**\n   * Draw ONE existing record by its live name, as a way to open it. Used on\n   * update/delete rows (the record that will change), in the host's own ask\n   * dialog if it likes, and on the applied tally (what was written). Absent →\n   * the fallback text, unlinked.\n   */\n  renderRecord?: (props: DirectiveRecordProps) => ReactNode;\n  /** Open ONE item to read it properly before approving the write. */\n  openItem?: (options: DirectiveOpenItemOptions) => void;\n  /** Host copy controls. */\n  renderCopy?: (props: DirectiveCopyProps) => ReactNode;\n  /** The mirrored noun catalog (label / family / title column). */\n  nouns?: DirectiveNounCatalog;\n  /** slug → the kind ONE item is (THE DIRECTIVE⇄KIND SEAM), or null. */\n  itemKind?: DirectiveItemKindLookup;\n  /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */\n  reportError?: (message: string) => void;\n  /**\n   * Plain words for a failed apply the host recognises (\"This button can't\n   * create a task yet.\" + \"Create it from Tasks instead.\"). The card never shows\n   * the server's raw text as its sentence: it shows these words — or its own\n   * verb-aware default — and keeps the raw text behind \"Details\". Return null\n   * to use the default.\n   */\n  explainFailure?: (failure: DirectiveFailure) => DirectiveFailureWords | null;\n}\n\n/** One failed apply, as the card knows it. */\nexport interface DirectiveFailure {\n  /** The server's / host's own text — technical; shown only behind Details. */\n  raw: string;\n  directiveClass: string;\n  noun: string;\n  /** The noun's display label (\"Task\"). */\n  nounLabel: string;\n  /** Items that failed, when some applied and some did not. */\n  failed?: number;\n  /** Items in the block. */\n  total?: number;\n}\n\n/** What failed and what to do — each one short sentence. */\nexport interface DirectiveFailureWords {\n  what: string;\n  next: string;\n}\n\nconst DirectiveHostContext = createContext<DirectiveHost | null>(null);\n\n/** Where a directive renders — today, the conversation it sits in (if any). */\nexport interface DirectiveScope {\n  conversationId?: string | null;\n}\n\nconst DirectiveScopeContext = createContext<DirectiveScope>({});\n\n/**\n * Tell every card below WHERE it renders. A host draws a chat message's\n * directives inside one of these (or passes `conversationId` to\n * `DirectiveRender`), so the card applies in that conversation's namespace —\n * the same key the agent's proposal approves under. A note mounts none.\n */\nexport function DirectiveScopeProvider({\n  conversationId,\n  children,\n}: DirectiveScope & { children: ReactNode }) {\n  return (\n    <DirectiveScopeContext.Provider value={{ conversationId: conversationId ?? null }}>\n      {children}\n    </DirectiveScopeContext.Provider>\n  );\n}\n\nexport function useDirectiveScope(): DirectiveScope {\n  return useContext(DirectiveScopeContext);\n}\n\nexport interface DirectiveHostProviderProps {\n  host: DirectiveHost;\n  children: ReactNode;\n}\n\nexport function DirectiveHostProvider({ host, children }: DirectiveHostProviderProps) {\n  return <DirectiveHostContext.Provider value={host}>{children}</DirectiveHostContext.Provider>;\n}\n\nconst EMPTY_HOST: DirectiveHost = {};\n\n/**\n * The wired directive host. Unlike the render host this does NOT throw when\n * unwired: a directive still renders (named, itemised, copy-less, apply-less)\n * — degrading the chrome is honest, hiding the content is not.\n */\nexport function useDirectiveHost(): DirectiveHost {\n  return useContext(DirectiveHostContext) ?? EMPTY_HOST;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC2BO,IAAM,uBAA+C,CAAC,WAAW;AACtE,UAAQ,MAAM,gBAAgB,OAAO,OAAO,IAAI,OAAO,OAAO,EAAE;AAClE;;;AC0HO,SAAS,WAAW,MAAmC;AAC5D,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,YAAY,KAAK;AAAA,IACjB,aAAa,KAAK;AAAA,IAClB,UAAU,KAAK;AAAA,EACjB;AACF;;;AC1IA,IAAAA,gBAAmE;;;ACQnE,mBAA0D;AAmPtD;AApBJ,IAAM,2BAAuB,4BAAoC,IAAI;AAOrE,IAAM,4BAAwB,4BAA8B,CAAC,CAAC;AA4BvD,SAAS,sBAAsB,EAAE,MAAM,SAAS,GAA+B;AACpF,SAAO,4CAAC,qBAAqB,UAArB,EAA8B,OAAO,MAAO,UAAS;AAC/D;;;AD1PM,IAAAC,sBAAA;AAbN,IAAM,2BAAuB,6BAAoC,IAAI;AAO9D,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAAiC;AAC/B,SACE,6CAAC,qBAAqB,UAArB,EAA8B,OAAO,MACpC,uDAAC,yBAAsB,MAAM,KAAK,cAAc,CAAC,GAAI,UAAS,GAChE;AAEJ;AAOO,SAAS,yBAA+C;AAC7D,aAAO,0BAAW,oBAAoB;AACxC;AAGO,SAAS,mBAAkC;AAChD,QAAM,OAAO,uBAAuB;AACpC,MAAI,CAAC,MAAM;AACT,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,kBAAgC;AAC9C,QAAM,OAAO,iBAAiB;AAC9B,aAAO,uBAAQ,MAAM,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;AAC/C;","names":["import_react","import_jsx_runtime"]}
+{"version":3,"sources":["../host.ts","../host/error-report.ts","../host/host-types.ts","../host/ContentIrProvider.tsx","../directives/directive-host.tsx"],"sourcesContent":["/**\n * `@ai-matrx/content-ir-react/host` — the contract every consumer wires once:\n * the scream seam, the host/seam types, and the React provider.\n *\n * NOTE: this entry is stamped \"use client\" (it carries the provider). The\n * TYPES here are importable from anywhere; a server-side module that needs\n * only pure route logic imports `/route` instead.\n */\nexport * from \"./host/error-report\";\nexport * from \"./host/host-types\";\nexport * from \"./host/ContentIrProvider\";\n","/**\n * THE SCREAM SEAM.\n *\n * Every recovery path in this package is loud: a defective component row, a\n * failed resolver load, a kind whose component throws on a provisional value.\n * The package refuses to own where those screams land — matrx-frontend routes\n * them to the Error Inspector, the dashboard to its own log, the extension to\n * its background page. Each host binds one function.\n *\n * A host that binds a no-op has chosen silence, which is a defect in itself;\n * {@link consoleErrorReporter} is the honest default.\n */\n\nexport interface ContentIrErrorReport {\n  /** Always `\"content-ir\"` — hosts key their capture stores on it. */\n  source: \"content-ir\";\n  message: string;\n  name?: string;\n  stack?: string;\n  /** Free-form grouping key (the host's `relation`), e.g. `\"partial-kind\"`. */\n  relation?: string;\n  raw?: unknown;\n}\n\nexport type ContentIrErrorReporter = (report: ContentIrErrorReport) => void;\n\n/** The default when a host binds nothing: never silent. */\nexport const consoleErrorReporter: ContentIrErrorReporter = (report) => {\n  console.error(`[content-ir] ${report.message}`, report.raw ?? \"\");\n};\n","/**\n * THE HOST CONTRACT — everything this package refuses to decide.\n *\n * The kernel (`@ai-matrx/content-ir`) proved the shape: extract the portable\n * part, let host capability enter through explicit named seams. The render\n * layer needs four things it must never own:\n *\n *  1. WHERE KIND DEFINITIONS COME FROM (a bundled table, `content_ir`, a REST\n *     call). The route only asks \"is this kind registered, and does it carry a\n *     legacy bridge / a partial-ready opt-in\".\n *  2. WHERE COMPONENT ROWS COME FROM — {@link ComponentResolutionSource}. The\n *     package ships `ComponentResolver`, which any host can construct with its\n *     own loaders; a host with its own resolver only has to satisfy the type.\n *  3. HOW A ROUTED BLOCK ACTUALLY DRAWS. `applyIrKindRoute` decides a block's\n *     TYPE; turning that type into pixels is the host's dispatch table\n *     (matrx-frontend's `BlockRenderer`, the dashboard's small map). The\n *     package never imports a component library.\n *  4. WHERE SCREAMS LAND — {@link ContentIrErrorReporter}.\n *\n * No Next.js, no Redux, no Supabase, no router, no host error capture. If a\n * seam is missing, ADD A SEAM — never an import.\n */\n\nimport type { ReactNode } from \"react\";\nimport type { KindDefinition } from \"@ai-matrx/content-ir\";\nimport type { ContentIrErrorReporter } from \"./error-report\";\nimport type { ComponentResolutionSource } from \"../resolver/component-resolution.types\";\nimport type { DirectiveHost } from \"../directives/directive-host\";\n\n/**\n * The minimum a render block must expose for the kind route to work. Hosts\n * pass their own richer block type through; the route is generic over `T` and\n * preserves every extra field.\n */\nexport interface IrRoutableBlock {\n  type: string;\n  serverData?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n}\n\n/** A routable block that also carries its source text (the raw region). */\nexport interface IrRenderBlock extends IrRoutableBlock {\n  content: string;\n  language?: string;\n}\n\n/**\n * Where registered kinds come from. `getDefinition` is the only method the\n * pure route needs; the rest drive the granular repaint and the warm-up tick\n * that keeps a cold registry from being mistaken for \"this kind has no\n * component\".\n */\nexport interface KindDefinitionSource {\n  getDefinition(kind: string): KindDefinition | undefined;\n  /** Monotonic per-kind version — the repaint snapshot key. */\n  getKindVersion(kind: string): number;\n  subscribeKind(kind: string, listener: () => void): () => void;\n  /** One definition load per app session. */\n  ensureWarm(): Promise<void>;\n}\n\n/**\n * The rendering seams. Everything here returns host UI; the package supplies\n * the DECISIONS and the chrome-free structure around them.\n */\nexport interface ContentIrRenderSeams {\n  /**\n   * Draw a block the kind route has already typed. This is the host's dispatch\n   * table — the single place a component key becomes a component.\n   */\n  renderBlock(block: IrRenderBlock): ReactNode;\n  /**\n   * THE FLOOR: render ANY JSON value as a human document. Reached when a kind\n   * has no render-trusted component, when the value is not an object at all,\n   * and by the generic structured view.\n   *\n   * This is deliberately a seam and not a bundled component. Rendering a value\n   * WELL means prose through the host's markdown renderer, media through the\n   * host's file handler, and uniform arrays through the host's data table —\n   * all of which are host property. A host that has none of those can pass a\n   * `<pre>`; it will be honest, just plain.\n   */\n  renderValue(props: StructuredValueRenderProps): ReactNode;\n  /**\n   * The \"still arriving\" indicator used by the provisional frame. Optional —\n   * hosts without a shimmer get plain text.\n   */\n  renderShimmer?(text: string): ReactNode;\n  /**\n   * The honest \"this shape has no custom component yet\" notice. Optional: the\n   * package draws a plain amber line when a host supplies nothing, and a host\n   * with an icon set or its own callout component supplies that instead. It is\n   * a seam and not a bundled component because this package depends on no icon\n   * library.\n   */\n  renderNotice?(text: string): ReactNode;\n}\n\nexport interface StructuredValueRenderProps {\n  value: unknown;\n  /** The kind slug this value claims, when known. Honesty line only — never a renderer choice. */\n  kind?: string;\n  /** Why this shape has no custom view, in human words. */\n  note?: string;\n  /** Show the \"what this is / raw data\" footer. Default true. */\n  footer?: boolean;\n}\n\n/**\n * One host, wired once, read by every component in this package through\n * {@link ContentIrRenderProvider}.\n */\nexport interface ContentIrHost extends ContentIrRenderSeams {\n  kinds: KindDefinitionSource;\n  components: ComponentResolutionSource;\n  reportError: ContentIrErrorReporter;\n  /**\n   * The `kind_component.platform` this host resolves as. \"web\" for every\n   * browser UI; the column already models \"react-native\" and friends, and a\n   * host that lies here renders the wrong component everywhere.\n   */\n  platform: string;\n  /**\n   * The Kind Directives seams (apply / open item / copy / noun catalog / item\n   * kind). Optional: a host without them still renders every directive card,\n   * apply-less and copy-less — honest chrome, never hidden content. Provided\n   * to the directive tier by `ContentIrRenderProvider`; a host that has not\n   * adopted the render provider mounts `DirectiveHostProvider` directly.\n   */\n  directives?: DirectiveHost;\n}\n\n/**\n * The pure route's dependencies — a strict subset of {@link ContentIrHost},\n * because `applyIrKindRoute` is called OUTSIDE React (reducers, stream\n * accumulators, tests) where there is no provider to read.\n */\nexport interface KindRouteEnv {\n  kinds: Pick<KindDefinitionSource, \"getDefinition\">;\n  /**\n   * `hasSettled` is optional and read ONLY to suppress a negative verdict from\n   * a registry that has not loaded yet — see THE COLD-VERDICT RULE on\n   * `ComponentResolutionSource`.\n   */\n  components: Pick<ComponentResolutionSource, \"resolve\"> &\n    Partial<Pick<ComponentResolutionSource, \"hasSettled\">>;\n  reportError: ContentIrErrorReporter;\n  platform: string;\n}\n\n/** Narrow a host (or anything host-shaped) to what the pure route needs. */\nexport function routeEnvOf(host: ContentIrHost): KindRouteEnv {\n  return {\n    kinds: host.kinds,\n    components: host.components,\n    reportError: host.reportError,\n    platform: host.platform,\n  };\n}\n","\"use client\";\n\n/**\n * The one place a host is wired in. Everything React in this package reads its\n * capability from here — no module singleton, no import into an app.\n *\n * A host mounts this ONCE, high enough that every kind-rendering surface is\n * inside it:\n *\n * ```tsx\n * <ContentIrRenderProvider host={matrxContentIrHost}>\n *   <App />\n * </ContentIrRenderProvider>\n * ```\n *\n * Reading it outside a provider THROWS rather than falling back to a default.\n * A silent default would render the wrong component for every kind in the app\n * and look like a data problem for weeks.\n */\n\nimport { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type { ContentIrHost, KindRouteEnv } from \"./host-types\";\nimport { routeEnvOf } from \"./host-types\";\nimport { DirectiveHostProvider } from \"../directives/directive-host\";\n\nconst ContentIrHostContext = createContext<ContentIrHost | null>(null);\n\nexport interface ContentIrRenderProviderProps {\n  host: ContentIrHost;\n  children: ReactNode;\n}\n\nexport function ContentIrRenderProvider({\n  host,\n  children,\n}: ContentIrRenderProviderProps) {\n  return (\n    <ContentIrHostContext.Provider value={host}>\n      <DirectiveHostProvider host={host.directives ?? {}}>{children}</DirectiveHostProvider>\n    </ContentIrHostContext.Provider>\n  );\n}\n\n/**\n * The wired host, or null. For the rare consumer that can legitimately run\n * without a provider because it was handed its sources explicitly (see\n * `useContentIrKindVersion`). Everything else uses {@link useContentIrHost}.\n */\nexport function useContentIrHostOrNull(): ContentIrHost | null {\n  return useContext(ContentIrHostContext);\n}\n\n/** The wired host. Throws outside a provider — see the module doc. */\nexport function useContentIrHost(): ContentIrHost {\n  const host = useContentIrHostOrNull();\n  if (!host) {\n    throw new Error(\n      \"[content-ir-react] No ContentIrRenderProvider above this component. \" +\n        \"Mount one at the app root with your host adapter (kind definitions, \" +\n        \"component resolver, renderBlock, renderValue, reportError).\",\n    );\n  }\n  return host;\n}\n\n/** The wired host narrowed to what the pure route functions take. */\nexport function useKindRouteEnv(): KindRouteEnv {\n  const host = useContentIrHost();\n  return useMemo(() => routeEnvOf(host), [host]);\n}\n","\"use client\";\n\n/**\n * THE DIRECTIVE HOST CONTRACT — what the directive tier refuses to decide.\n *\n * The package owns the DECISIONS (decode → renderer → card → floor, the\n * position law, never-null rendering) and the card itself. Four things stay\n * host property and enter through named seams:\n *\n *  1. APPLYING a side-effect directive — `POST /directives/confirm` as the\n *     user, with the host's auth and base URL. Absent → the Apply control is\n *     ABSENT (honest), never a dead button.\n *  2. OPENING an item to read it before approving — a window panel, a dialog,\n *     a route. Absent → items are not clickable.\n *  3. COPY controls — host chrome (matrx-frontend's CopyButtons). Absent → none.\n *  4. The NOUN catalog + item-kind lookup — server-derived tables the host\n *     mirrors (or reads from its kind catalog's `items` edges).\n *  5. ASKING (`ask`), NAMING a record (`renderRecord`), and READING the ledger\n *     (`applyState`) — the consequence before the click, the doors, and the\n *     state that survives a reload.\n *\n * A host that has adopted `ContentIrRenderProvider` passes `directives` on its\n * ContentIrHost; a host that has NOT (Workflow Studio, 2026-09-08) mounts\n * `DirectiveHostProvider` alone — the directive tier never requires the full\n * render host, because a chat bubble must be able to draw a directive card\n * identically everywhere, today.\n */\n\nimport { createContext, useContext, type ReactNode } from \"react\";\nimport type {\n  DecodedDirective,\n  DirectiveItemKindLookup,\n  DirectiveNounCatalog,\n} from \"@ai-matrx/content-ir\";\n\nexport interface DirectiveApplyResult {\n  applied: number;\n  failed: number;\n  /**\n   * The server's own receipt sentence (\"Deleted task “Ship it”.\"), shown in\n   * place of a bare count. Never composed client-side.\n   */\n  message?: string | null;\n  /**\n   * The records the apply created or changed, so the tally is a way IN to them\n   * (no dead ends). Rendered through `renderRecord`; absent → the sentence alone.\n   */\n  records?: DirectiveRecordRef[];\n  /**\n   * For an UPDATE: what each item's fields held just BEFORE the write, by item\n   * index (`null` for an item the server did not record). The card draws the\n   * applied change from this record — never from a live re-read, which after the\n   * apply answers the NEW value (G6A review, 2026-10-02: \"(no change)\" for a\n   * change that happened).\n   */\n  before?: ReadonlyArray<Record<string, unknown> | null>;\n}\n\n/**\n * What the server's action ledger says about ONE block, read on mount so a\n * reloaded page never offers \"Apply\" for work that already ran (reviewer\n * defect 5, 2026-10-02).\n *\n *  - `not_applied` — still to do (or partly done: the batch re-applies, and the\n *    server replays the members it already holds). The card offers Apply.\n *  - `in_flight` — another request is applying it right now. The card says it\n *    is finishing and asks again shortly; it offers neither Apply nor a tally.\n *  - `applied` — the ledger holds every item. The card shows the tally exactly\n *    as a fresh apply would: the ledger's own sentence and the records, as doors.\n */\nexport interface DirectiveApplyState {\n  state: \"not_applied\" | \"in_flight\" | \"applied\";\n  /** The ledger row's sentence (\"Created task.\"), never composed client-side. */\n  message?: string | null;\n  /**\n   * The records the LATEST apply wrote — the tally's doors. After \"Run again\"\n   * that is the newest copy, never the first.\n   */\n  records?: DirectiveRecordRef[];\n  /**\n   * How many times the ledger holds this block as applied: 1 for the original,\n   * one more for every \"Run again\". Absent → 1. A create that ran twice made\n   * two records, and the card says so (reviewer, 2026-10-02).\n   */\n  copies?: number;\n  /**\n   * For an applied UPDATE: each item's replaced values, by item index, from the\n   * ledger row (`null` where the ledger has none — a row from before 2026-10-02).\n   * Absent → the card says only what each field was set to.\n   */\n  before?: ReadonlyArray<Record<string, unknown> | null>;\n}\n\n/** One record a directive names: the noun it is, and its id. */\nexport interface DirectiveRecordRef {\n  noun: string;\n  id: string;\n}\n\nexport interface DirectiveRecordProps extends DirectiveRecordRef {\n  /**\n   * What to show until (or unless) the host resolves the live name —\n   * \"Task 1a2b3c4d\". Never blank, never \"Item\".\n   */\n  fallback: string;\n  /** Where it is drawn: an item row, the confirm dialog, or the applied tally. */\n  context: \"row\" | \"dialog\" | \"applied\";\n  /**\n   * True when the record is (about to be) in the trash — the host may still\n   * name it but should not promise it opens as a live record.\n   */\n  trashed?: boolean;\n}\n\n/** What the person is being asked to approve — everything the card knows. */\nexport interface DirectiveAskRequest {\n  directive: DecodedDirective;\n  /** The items, exactly as they will be sent. */\n  items: Record<string, unknown>[];\n  /** The noun's human label (\"Task\"), from the host's catalog when it has one. */\n  nounLabel: string;\n  /**\n   * True for \"Run again\": the ledger already holds this block, and a yes runs\n   * it a SECOND time (`force`) — another copy for a create, the same fields\n   * written again for an update, another delete for a restored record. The\n   * question must say so.\n   */\n  again?: boolean;\n}\n\n/**\n * The shell a card hands its host — the two keys, plus WHERE it sits.\n *\n * `conversationId` is the conversation the card renders in (a chat message),\n * absent in a person's own content (a note). It is the idempotency NAMESPACE:\n * a card in an agent's message must apply under the SAME key as that\n * proposal's Approve button, or the one action could run twice.\n */\nexport interface DirectiveShell {\n  __kind: string;\n  items: Record<string, unknown>[];\n  conversationId?: string;\n  /** \"Run again\": skip the ledger's dedup and apply a second time. */\n  force?: boolean;\n}\n\nexport interface DirectiveOpenItemOptions {\n  /** The item, `__kind`-stamped when the shape has an item kind. */\n  item: Record<string, unknown>;\n  /** The content-IR kind this item IS, or null when the shape has none. */\n  itemKind: string | null;\n  /** What the item is called — the same title the card shows. */\n  title: string;\n  /** \"Run Create agent definition · item 1 of 1\". */\n  subtitle: string | null;\n  directive: DecodedDirective;\n  index: number;\n  total: number;\n}\n\nexport interface DirectiveCopyProps {\n  /**\n   * What the control is called to a screen reader. Never an id: for a record it\n   * is type-generic (\"this task\"); a host with the record's live name replaces\n   * it through `record`.\n   */\n  label: string;\n  /** The existing record this control copies, when it copies one — to name it. */\n  record?: DirectiveRecordRef;\n  /** The value to copy — the whole shell or one item. */\n  value: unknown;\n  /** The item's kind, when copying an item. */\n  kind?: string | null;\n  size: \"icon\" | \"xs\";\n}\n\nexport interface DirectiveHost {\n  /**\n   * Apply a side-effect directive as the user (the server re-validates every\n   * item against the registered model and runs the ONE handler; idempotent).\n   * Reject with an Error whose message is safe to show.\n   */\n  confirm?: (shell: DirectiveShell) => Promise<DirectiveApplyResult>;\n  /**\n   * Ask the person BEFORE anything runs, naming the consequence (the records,\n   * what changes). Resolve `true` to go ahead, `false` to leave the card as it\n   * was. The Apply control stays idle while this is open — nothing reads as\n   * \"applying\" until the person has said yes. Absent → `confirm` is called\n   * directly (a host that asks inside `confirm` keeps working, but its card\n   * will read \"Applying…\" while its dialog is up).\n   */\n  ask?: (request: DirectiveAskRequest) => Promise<boolean>;\n  /**\n   * Has this exact block already been applied? Read ONCE when the card mounts\n   * (and again while the answer is `in_flight`), so the card survives a reload:\n   * the server ledger, not component state, is what knows. The identity is the\n   * server's (it hashes the validated items in the same namespace `confirm`\n   * applies in), so a host asks — it never computes. Batch on the host side if\n   * a page carries many cards. Reject with an Error when the ledger cannot be\n   * read: the card reports it and offers Apply, which is safe because `confirm`\n   * is idempotent. Absent → the card starts at Apply, as before.\n   */\n  applyState?: (shell: DirectiveShell) => Promise<DirectiveApplyState>;\n  /**\n   * Read the CURRENT values of ONE existing record, so an update says what it\n   * replaces — \"Status open → done\", never just \"→ done\" (reviewer,\n   * 2026-10-02). Resolve `null` when the record cannot be read (no access, no\n   * such record, a noun the host cannot read); reject only for a real failure.\n   * Absent → an update row shows the new values alone, as before.\n   */\n  readRecord?: (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;\n  /**\n   * Draw ONE existing record by its live name, as a way to open it. Used on\n   * update/delete rows (the record that will change), in the host's own ask\n   * dialog if it likes, and on the applied tally (what was written). Absent →\n   * the fallback text, unlinked.\n   */\n  renderRecord?: (props: DirectiveRecordProps) => ReactNode;\n  /** Open ONE item to read it properly before approving the write. */\n  openItem?: (options: DirectiveOpenItemOptions) => void;\n  /** Host copy controls. */\n  renderCopy?: (props: DirectiveCopyProps) => ReactNode;\n  /**\n   * The app's word for one stored value of one pick-list field — the SAME word\n   * the record's own screens and the write forms show (\"incomplete\" on a task\n   * reads \"Inbox\"). One value, one display word everywhere (G8A review,\n   * 2026-10-02: the card said \"Status incomplete → completed\"). Return null for\n   * a field that is not a pick-list: its value is shown as written. Absent →\n   * every value is shown as stored.\n   */\n  valueLabel?: (ref: DirectiveValueRef) => string | null;\n  /** The mirrored noun catalog (label / family / title column). */\n  nouns?: DirectiveNounCatalog;\n  /** slug → the kind ONE item is (THE DIRECTIVE⇄KIND SEAM), or null. */\n  itemKind?: DirectiveItemKindLookup;\n  /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */\n  reportError?: (message: string) => void;\n  /**\n   * Plain words for a failed apply the host recognises (\"This button can't\n   * create a task yet.\" + \"Create it from Tasks instead.\"). The card never shows\n   * the server's raw text as its sentence: it shows these words — or its own\n   * verb-aware default — and keeps the raw text behind \"Details\". Return null\n   * to use the default.\n   */\n  explainFailure?: (failure: DirectiveFailure) => DirectiveFailureWords | null;\n}\n\n/** One stored value of one field of one record type. */\nexport interface DirectiveValueRef {\n  noun: string;\n  field: string;\n  value: string;\n}\n\n/** One failed apply, as the card knows it. */\nexport interface DirectiveFailure {\n  /** The server's / host's own text — technical; shown only behind Details. */\n  raw: string;\n  directiveClass: string;\n  noun: string;\n  /** The noun's display label (\"Task\"). */\n  nounLabel: string;\n  /** Items that failed, when some applied and some did not. */\n  failed?: number;\n  /** Items in the block. */\n  total?: number;\n}\n\n/** What failed and what to do — each one short sentence. */\nexport interface DirectiveFailureWords {\n  what: string;\n  next: string;\n}\n\nconst DirectiveHostContext = createContext<DirectiveHost | null>(null);\n\n/** Where a directive renders — today, the conversation it sits in (if any). */\nexport interface DirectiveScope {\n  conversationId?: string | null;\n}\n\nconst DirectiveScopeContext = createContext<DirectiveScope>({});\n\n/**\n * Tell every card below WHERE it renders. A host draws a chat message's\n * directives inside one of these (or passes `conversationId` to\n * `DirectiveRender`), so the card applies in that conversation's namespace —\n * the same key the agent's proposal approves under. A note mounts none.\n */\nexport function DirectiveScopeProvider({\n  conversationId,\n  children,\n}: DirectiveScope & { children: ReactNode }) {\n  return (\n    <DirectiveScopeContext.Provider value={{ conversationId: conversationId ?? null }}>\n      {children}\n    </DirectiveScopeContext.Provider>\n  );\n}\n\nexport function useDirectiveScope(): DirectiveScope {\n  return useContext(DirectiveScopeContext);\n}\n\nexport interface DirectiveHostProviderProps {\n  host: DirectiveHost;\n  children: ReactNode;\n}\n\nexport function DirectiveHostProvider({ host, children }: DirectiveHostProviderProps) {\n  return <DirectiveHostContext.Provider value={host}>{children}</DirectiveHostContext.Provider>;\n}\n\nconst EMPTY_HOST: DirectiveHost = {};\n\n/**\n * The wired directive host. Unlike the render host this does NOT throw when\n * unwired: a directive still renders (named, itemised, copy-less, apply-less)\n * — degrading the chrome is honest, hiding the content is not.\n */\nexport function useDirectiveHost(): DirectiveHost {\n  return useContext(DirectiveHostContext) ?? EMPTY_HOST;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC2BO,IAAM,uBAA+C,CAAC,WAAW;AACtE,UAAQ,MAAM,gBAAgB,OAAO,OAAO,IAAI,OAAO,OAAO,EAAE;AAClE;;;AC0HO,SAAS,WAAW,MAAmC;AAC5D,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,YAAY,KAAK;AAAA,IACjB,aAAa,KAAK;AAAA,IAClB,UAAU,KAAK;AAAA,EACjB;AACF;;;AC1IA,IAAAA,gBAAmE;;;ACQnE,mBAA0D;AA0QtD;AApBJ,IAAM,2BAAuB,4BAAoC,IAAI;AAOrE,IAAM,4BAAwB,4BAA8B,CAAC,CAAC;AA4BvD,SAAS,sBAAsB,EAAE,MAAM,SAAS,GAA+B;AACpF,SAAO,4CAAC,qBAAqB,UAArB,EAA8B,OAAO,MAAO,UAAS;AAC/D;;;ADjRM,IAAAC,sBAAA;AAbN,IAAM,2BAAuB,6BAAoC,IAAI;AAO9D,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAAiC;AAC/B,SACE,6CAAC,qBAAqB,UAArB,EAA8B,OAAO,MACpC,uDAAC,yBAAsB,MAAM,KAAK,cAAc,CAAC,GAAI,UAAS,GAChE;AAEJ;AAOO,SAAS,yBAA+C;AAC7D,aAAO,0BAAW,oBAAoB;AACxC;AAGO,SAAS,mBAAkC;AAChD,QAAM,OAAO,uBAAuB;AACpC,MAAI,CAAC,MAAM;AACT,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,kBAAgC;AAC9C,QAAM,OAAO,iBAAiB;AAC9B,aAAO,uBAAQ,MAAM,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;AAC/C;","names":["import_react","import_jsx_runtime"]}

package/dist/host.d.cts

@@ -1,10 +1,10 @@
 export { b as ContentIrErrorReport, a as ContentIrErrorReporter, c as consoleErrorReporter } from './component-resolution.types-DwKSF64x.cjs';
-import { C as ContentIrHost, K as KindRouteEnv } from './host-types-YP_l_Q_t.cjs';
-export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-YP_l_Q_t.cjs';
+import { C as ContentIrHost, K as KindRouteEnv } from './host-types-BRLk_J_3.cjs';
+export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-BRLk_J_3.cjs';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import '@ai-matrx/content-ir';
-import './directive-host-Bw2_PrgL.cjs';
+import './directive-host-CtFMuSZc.cjs';
 
 interface ContentIrRenderProviderProps {
     host: ContentIrHost;

package/dist/host.d.ts

@@ -1,10 +1,10 @@
 export { b as ContentIrErrorReport, a as ContentIrErrorReporter, c as consoleErrorReporter } from './component-resolution.types-DwKSF64x.js';
-import { C as ContentIrHost, K as KindRouteEnv } from './host-types-eSjFmXyF.js';
-export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-eSjFmXyF.js';
+import { C as ContentIrHost, K as KindRouteEnv } from './host-types-BpcRcZ48.js';
+export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-BpcRcZ48.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import '@ai-matrx/content-ir';
-import './directive-host-Bw2_PrgL.js';
+import './directive-host-CtFMuSZc.js';
 
 interface ContentIrRenderProviderProps {
     host: ContentIrHost;

package/dist/host.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../host/error-report.ts","../host/host-types.ts","../host/ContentIrProvider.tsx","../directives/directive-host.tsx"],"sourcesContent":["/**\n * THE SCREAM SEAM.\n *\n * Every recovery path in this package is loud: a defective component row, a\n * failed resolver load, a kind whose component throws on a provisional value.\n * The package refuses to own where those screams land — matrx-frontend routes\n * them to the Error Inspector, the dashboard to its own log, the extension to\n * its background page. Each host binds one function.\n *\n * A host that binds a no-op has chosen silence, which is a defect in itself;\n * {@link consoleErrorReporter} is the honest default.\n */\n\nexport interface ContentIrErrorReport {\n  /** Always `\"content-ir\"` — hosts key their capture stores on it. */\n  source: \"content-ir\";\n  message: string;\n  name?: string;\n  stack?: string;\n  /** Free-form grouping key (the host's `relation`), e.g. `\"partial-kind\"`. */\n  relation?: string;\n  raw?: unknown;\n}\n\nexport type ContentIrErrorReporter = (report: ContentIrErrorReport) => void;\n\n/** The default when a host binds nothing: never silent. */\nexport const consoleErrorReporter: ContentIrErrorReporter = (report) => {\n  console.error(`[content-ir] ${report.message}`, report.raw ?? \"\");\n};\n","/**\n * THE HOST CONTRACT — everything this package refuses to decide.\n *\n * The kernel (`@ai-matrx/content-ir`) proved the shape: extract the portable\n * part, let host capability enter through explicit named seams. The render\n * layer needs four things it must never own:\n *\n *  1. WHERE KIND DEFINITIONS COME FROM (a bundled table, `content_ir`, a REST\n *     call). The route only asks \"is this kind registered, and does it carry a\n *     legacy bridge / a partial-ready opt-in\".\n *  2. WHERE COMPONENT ROWS COME FROM — {@link ComponentResolutionSource}. The\n *     package ships `ComponentResolver`, which any host can construct with its\n *     own loaders; a host with its own resolver only has to satisfy the type.\n *  3. HOW A ROUTED BLOCK ACTUALLY DRAWS. `applyIrKindRoute` decides a block's\n *     TYPE; turning that type into pixels is the host's dispatch table\n *     (matrx-frontend's `BlockRenderer`, the dashboard's small map). The\n *     package never imports a component library.\n *  4. WHERE SCREAMS LAND — {@link ContentIrErrorReporter}.\n *\n * No Next.js, no Redux, no Supabase, no router, no host error capture. If a\n * seam is missing, ADD A SEAM — never an import.\n */\n\nimport type { ReactNode } from \"react\";\nimport type { KindDefinition } from \"@ai-matrx/content-ir\";\nimport type { ContentIrErrorReporter } from \"./error-report\";\nimport type { ComponentResolutionSource } from \"../resolver/component-resolution.types\";\nimport type { DirectiveHost } from \"../directives/directive-host\";\n\n/**\n * The minimum a render block must expose for the kind route to work. Hosts\n * pass their own richer block type through; the route is generic over `T` and\n * preserves every extra field.\n */\nexport interface IrRoutableBlock {\n  type: string;\n  serverData?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n}\n\n/** A routable block that also carries its source text (the raw region). */\nexport interface IrRenderBlock extends IrRoutableBlock {\n  content: string;\n  language?: string;\n}\n\n/**\n * Where registered kinds come from. `getDefinition` is the only method the\n * pure route needs; the rest drive the granular repaint and the warm-up tick\n * that keeps a cold registry from being mistaken for \"this kind has no\n * component\".\n */\nexport interface KindDefinitionSource {\n  getDefinition(kind: string): KindDefinition | undefined;\n  /** Monotonic per-kind version — the repaint snapshot key. */\n  getKindVersion(kind: string): number;\n  subscribeKind(kind: string, listener: () => void): () => void;\n  /** One definition load per app session. */\n  ensureWarm(): Promise<void>;\n}\n\n/**\n * The rendering seams. Everything here returns host UI; the package supplies\n * the DECISIONS and the chrome-free structure around them.\n */\nexport interface ContentIrRenderSeams {\n  /**\n   * Draw a block the kind route has already typed. This is the host's dispatch\n   * table — the single place a component key becomes a component.\n   */\n  renderBlock(block: IrRenderBlock): ReactNode;\n  /**\n   * THE FLOOR: render ANY JSON value as a human document. Reached when a kind\n   * has no render-trusted component, when the value is not an object at all,\n   * and by the generic structured view.\n   *\n   * This is deliberately a seam and not a bundled component. Rendering a value\n   * WELL means prose through the host's markdown renderer, media through the\n   * host's file handler, and uniform arrays through the host's data table —\n   * all of which are host property. A host that has none of those can pass a\n   * `<pre>`; it will be honest, just plain.\n   */\n  renderValue(props: StructuredValueRenderProps): ReactNode;\n  /**\n   * The \"still arriving\" indicator used by the provisional frame. Optional —\n   * hosts without a shimmer get plain text.\n   */\n  renderShimmer?(text: string): ReactNode;\n  /**\n   * The honest \"this shape has no custom component yet\" notice. Optional: the\n   * package draws a plain amber line when a host supplies nothing, and a host\n   * with an icon set or its own callout component supplies that instead. It is\n   * a seam and not a bundled component because this package depends on no icon\n   * library.\n   */\n  renderNotice?(text: string): ReactNode;\n}\n\nexport interface StructuredValueRenderProps {\n  value: unknown;\n  /** The kind slug this value claims, when known. Honesty line only — never a renderer choice. */\n  kind?: string;\n  /** Why this shape has no custom view, in human words. */\n  note?: string;\n  /** Show the \"what this is / raw data\" footer. Default true. */\n  footer?: boolean;\n}\n\n/**\n * One host, wired once, read by every component in this package through\n * {@link ContentIrRenderProvider}.\n */\nexport interface ContentIrHost extends ContentIrRenderSeams {\n  kinds: KindDefinitionSource;\n  components: ComponentResolutionSource;\n  reportError: ContentIrErrorReporter;\n  /**\n   * The `kind_component.platform` this host resolves as. \"web\" for every\n   * browser UI; the column already models \"react-native\" and friends, and a\n   * host that lies here renders the wrong component everywhere.\n   */\n  platform: string;\n  /**\n   * The Kind Directives seams (apply / open item / copy / noun catalog / item\n   * kind). Optional: a host without them still renders every directive card,\n   * apply-less and copy-less — honest chrome, never hidden content. Provided\n   * to the directive tier by `ContentIrRenderProvider`; a host that has not\n   * adopted the render provider mounts `DirectiveHostProvider` directly.\n   */\n  directives?: DirectiveHost;\n}\n\n/**\n * The pure route's dependencies — a strict subset of {@link ContentIrHost},\n * because `applyIrKindRoute` is called OUTSIDE React (reducers, stream\n * accumulators, tests) where there is no provider to read.\n */\nexport interface KindRouteEnv {\n  kinds: Pick<KindDefinitionSource, \"getDefinition\">;\n  /**\n   * `hasSettled` is optional and read ONLY to suppress a negative verdict from\n   * a registry that has not loaded yet — see THE COLD-VERDICT RULE on\n   * `ComponentResolutionSource`.\n   */\n  components: Pick<ComponentResolutionSource, \"resolve\"> &\n    Partial<Pick<ComponentResolutionSource, \"hasSettled\">>;\n  reportError: ContentIrErrorReporter;\n  platform: string;\n}\n\n/** Narrow a host (or anything host-shaped) to what the pure route needs. */\nexport function routeEnvOf(host: ContentIrHost): KindRouteEnv {\n  return {\n    kinds: host.kinds,\n    components: host.components,\n    reportError: host.reportError,\n    platform: host.platform,\n  };\n}\n","\"use client\";\n\n/**\n * The one place a host is wired in. Everything React in this package reads its\n * capability from here — no module singleton, no import into an app.\n *\n * A host mounts this ONCE, high enough that every kind-rendering surface is\n * inside it:\n *\n * ```tsx\n * <ContentIrRenderProvider host={matrxContentIrHost}>\n *   <App />\n * </ContentIrRenderProvider>\n * ```\n *\n * Reading it outside a provider THROWS rather than falling back to a default.\n * A silent default would render the wrong component for every kind in the app\n * and look like a data problem for weeks.\n */\n\nimport { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type { ContentIrHost, KindRouteEnv } from \"./host-types\";\nimport { routeEnvOf } from \"./host-types\";\nimport { DirectiveHostProvider } from \"../directives/directive-host\";\n\nconst ContentIrHostContext = createContext<ContentIrHost | null>(null);\n\nexport interface ContentIrRenderProviderProps {\n  host: ContentIrHost;\n  children: ReactNode;\n}\n\nexport function ContentIrRenderProvider({\n  host,\n  children,\n}: ContentIrRenderProviderProps) {\n  return (\n    <ContentIrHostContext.Provider value={host}>\n      <DirectiveHostProvider host={host.directives ?? {}}>{children}</DirectiveHostProvider>\n    </ContentIrHostContext.Provider>\n  );\n}\n\n/**\n * The wired host, or null. For the rare consumer that can legitimately run\n * without a provider because it was handed its sources explicitly (see\n * `useContentIrKindVersion`). Everything else uses {@link useContentIrHost}.\n */\nexport function useContentIrHostOrNull(): ContentIrHost | null {\n  return useContext(ContentIrHostContext);\n}\n\n/** The wired host. Throws outside a provider — see the module doc. */\nexport function useContentIrHost(): ContentIrHost {\n  const host = useContentIrHostOrNull();\n  if (!host) {\n    throw new Error(\n      \"[content-ir-react] No ContentIrRenderProvider above this component. \" +\n        \"Mount one at the app root with your host adapter (kind definitions, \" +\n        \"component resolver, renderBlock, renderValue, reportError).\",\n    );\n  }\n  return host;\n}\n\n/** The wired host narrowed to what the pure route functions take. */\nexport function useKindRouteEnv(): KindRouteEnv {\n  const host = useContentIrHost();\n  return useMemo(() => routeEnvOf(host), [host]);\n}\n","\"use client\";\n\n/**\n * THE DIRECTIVE HOST CONTRACT — what the directive tier refuses to decide.\n *\n * The package owns the DECISIONS (decode → renderer → card → floor, the\n * position law, never-null rendering) and the card itself. Four things stay\n * host property and enter through named seams:\n *\n *  1. APPLYING a side-effect directive — `POST /directives/confirm` as the\n *     user, with the host's auth and base URL. Absent → the Apply control is\n *     ABSENT (honest), never a dead button.\n *  2. OPENING an item to read it before approving — a window panel, a dialog,\n *     a route. Absent → items are not clickable.\n *  3. COPY controls — host chrome (matrx-frontend's CopyButtons). Absent → none.\n *  4. The NOUN catalog + item-kind lookup — server-derived tables the host\n *     mirrors (or reads from its kind catalog's `items` edges).\n *  5. ASKING (`ask`), NAMING a record (`renderRecord`), and READING the ledger\n *     (`applyState`) — the consequence before the click, the doors, and the\n *     state that survives a reload.\n *\n * A host that has adopted `ContentIrRenderProvider` passes `directives` on its\n * ContentIrHost; a host that has NOT (Workflow Studio, 2026-09-08) mounts\n * `DirectiveHostProvider` alone — the directive tier never requires the full\n * render host, because a chat bubble must be able to draw a directive card\n * identically everywhere, today.\n */\n\nimport { createContext, useContext, type ReactNode } from \"react\";\nimport type {\n  DecodedDirective,\n  DirectiveItemKindLookup,\n  DirectiveNounCatalog,\n} from \"@ai-matrx/content-ir\";\n\nexport interface DirectiveApplyResult {\n  applied: number;\n  failed: number;\n  /**\n   * The server's own receipt sentence (\"Deleted task “Ship it”.\"), shown in\n   * place of a bare count. Never composed client-side.\n   */\n  message?: string | null;\n  /**\n   * The records the apply created or changed, so the tally is a way IN to them\n   * (no dead ends). Rendered through `renderRecord`; absent → the sentence alone.\n   */\n  records?: DirectiveRecordRef[];\n  /**\n   * For an UPDATE: what each item's fields held just BEFORE the write, by item\n   * index (`null` for an item the server did not record). The card draws the\n   * applied change from this record — never from a live re-read, which after the\n   * apply answers the NEW value (G6A review, 2026-10-02: \"(no change)\" for a\n   * change that happened).\n   */\n  before?: ReadonlyArray<Record<string, unknown> | null>;\n}\n\n/**\n * What the server's action ledger says about ONE block, read on mount so a\n * reloaded page never offers \"Apply\" for work that already ran (reviewer\n * defect 5, 2026-10-02).\n *\n *  - `not_applied` — still to do (or partly done: the batch re-applies, and the\n *    server replays the members it already holds). The card offers Apply.\n *  - `in_flight` — another request is applying it right now. The card says it\n *    is finishing and asks again shortly; it offers neither Apply nor a tally.\n *  - `applied` — the ledger holds every item. The card shows the tally exactly\n *    as a fresh apply would: the ledger's own sentence and the records, as doors.\n */\nexport interface DirectiveApplyState {\n  state: \"not_applied\" | \"in_flight\" | \"applied\";\n  /** The ledger row's sentence (\"Created task.\"), never composed client-side. */\n  message?: string | null;\n  /**\n   * The records the LATEST apply wrote — the tally's doors. After \"Run again\"\n   * that is the newest copy, never the first.\n   */\n  records?: DirectiveRecordRef[];\n  /**\n   * How many times the ledger holds this block as applied: 1 for the original,\n   * one more for every \"Run again\". Absent → 1. A create that ran twice made\n   * two records, and the card says so (reviewer, 2026-10-02).\n   */\n  copies?: number;\n  /**\n   * For an applied UPDATE: each item's replaced values, by item index, from the\n   * ledger row (`null` where the ledger has none — a row from before 2026-10-02).\n   * Absent → the card says only what each field was set to.\n   */\n  before?: ReadonlyArray<Record<string, unknown> | null>;\n}\n\n/** One record a directive names: the noun it is, and its id. */\nexport interface DirectiveRecordRef {\n  noun: string;\n  id: string;\n}\n\nexport interface DirectiveRecordProps extends DirectiveRecordRef {\n  /**\n   * What to show until (or unless) the host resolves the live name —\n   * \"Task 1a2b3c4d\". Never blank, never \"Item\".\n   */\n  fallback: string;\n  /** Where it is drawn: an item row, the confirm dialog, or the applied tally. */\n  context: \"row\" | \"dialog\" | \"applied\";\n  /**\n   * True when the record is (about to be) in the trash — the host may still\n   * name it but should not promise it opens as a live record.\n   */\n  trashed?: boolean;\n}\n\n/** What the person is being asked to approve — everything the card knows. */\nexport interface DirectiveAskRequest {\n  directive: DecodedDirective;\n  /** The items, exactly as they will be sent. */\n  items: Record<string, unknown>[];\n  /** The noun's human label (\"Task\"), from the host's catalog when it has one. */\n  nounLabel: string;\n  /**\n   * True for \"Run again\": the ledger already holds this block, and a yes runs\n   * it a SECOND time (`force`) — another copy for a create, the same fields\n   * written again for an update, another delete for a restored record. The\n   * question must say so.\n   */\n  again?: boolean;\n}\n\n/**\n * The shell a card hands its host — the two keys, plus WHERE it sits.\n *\n * `conversationId` is the conversation the card renders in (a chat message),\n * absent in a person's own content (a note). It is the idempotency NAMESPACE:\n * a card in an agent's message must apply under the SAME key as that\n * proposal's Approve button, or the one action could run twice.\n */\nexport interface DirectiveShell {\n  __kind: string;\n  items: Record<string, unknown>[];\n  conversationId?: string;\n  /** \"Run again\": skip the ledger's dedup and apply a second time. */\n  force?: boolean;\n}\n\nexport interface DirectiveOpenItemOptions {\n  /** The item, `__kind`-stamped when the shape has an item kind. */\n  item: Record<string, unknown>;\n  /** The content-IR kind this item IS, or null when the shape has none. */\n  itemKind: string | null;\n  /** What the item is called — the same title the card shows. */\n  title: string;\n  /** \"Run Create agent definition · item 1 of 1\". */\n  subtitle: string | null;\n  directive: DecodedDirective;\n  index: number;\n  total: number;\n}\n\nexport interface DirectiveCopyProps {\n  label: string;\n  /** The value to copy — the whole shell or one item. */\n  value: unknown;\n  /** The item's kind, when copying an item. */\n  kind?: string | null;\n  size: \"icon\" | \"xs\";\n}\n\nexport interface DirectiveHost {\n  /**\n   * Apply a side-effect directive as the user (the server re-validates every\n   * item against the registered model and runs the ONE handler; idempotent).\n   * Reject with an Error whose message is safe to show.\n   */\n  confirm?: (shell: DirectiveShell) => Promise<DirectiveApplyResult>;\n  /**\n   * Ask the person BEFORE anything runs, naming the consequence (the records,\n   * what changes). Resolve `true` to go ahead, `false` to leave the card as it\n   * was. The Apply control stays idle while this is open — nothing reads as\n   * \"applying\" until the person has said yes. Absent → `confirm` is called\n   * directly (a host that asks inside `confirm` keeps working, but its card\n   * will read \"Applying…\" while its dialog is up).\n   */\n  ask?: (request: DirectiveAskRequest) => Promise<boolean>;\n  /**\n   * Has this exact block already been applied? Read ONCE when the card mounts\n   * (and again while the answer is `in_flight`), so the card survives a reload:\n   * the server ledger, not component state, is what knows. The identity is the\n   * server's (it hashes the validated items in the same namespace `confirm`\n   * applies in), so a host asks — it never computes. Batch on the host side if\n   * a page carries many cards. Reject with an Error when the ledger cannot be\n   * read: the card reports it and offers Apply, which is safe because `confirm`\n   * is idempotent. Absent → the card starts at Apply, as before.\n   */\n  applyState?: (shell: DirectiveShell) => Promise<DirectiveApplyState>;\n  /**\n   * Read the CURRENT values of ONE existing record, so an update says what it\n   * replaces — \"Status open → done\", never just \"→ done\" (reviewer,\n   * 2026-10-02). Resolve `null` when the record cannot be read (no access, no\n   * such record, a noun the host cannot read); reject only for a real failure.\n   * Absent → an update row shows the new values alone, as before.\n   */\n  readRecord?: (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;\n  /**\n   * Draw ONE existing record by its live name, as a way to open it. Used on\n   * update/delete rows (the record that will change), in the host's own ask\n   * dialog if it likes, and on the applied tally (what was written). Absent →\n   * the fallback text, unlinked.\n   */\n  renderRecord?: (props: DirectiveRecordProps) => ReactNode;\n  /** Open ONE item to read it properly before approving the write. */\n  openItem?: (options: DirectiveOpenItemOptions) => void;\n  /** Host copy controls. */\n  renderCopy?: (props: DirectiveCopyProps) => ReactNode;\n  /** The mirrored noun catalog (label / family / title column). */\n  nouns?: DirectiveNounCatalog;\n  /** slug → the kind ONE item is (THE DIRECTIVE⇄KIND SEAM), or null. */\n  itemKind?: DirectiveItemKindLookup;\n  /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */\n  reportError?: (message: string) => void;\n  /**\n   * Plain words for a failed apply the host recognises (\"This button can't\n   * create a task yet.\" + \"Create it from Tasks instead.\"). The card never shows\n   * the server's raw text as its sentence: it shows these words — or its own\n   * verb-aware default — and keeps the raw text behind \"Details\". Return null\n   * to use the default.\n   */\n  explainFailure?: (failure: DirectiveFailure) => DirectiveFailureWords | null;\n}\n\n/** One failed apply, as the card knows it. */\nexport interface DirectiveFailure {\n  /** The server's / host's own text — technical; shown only behind Details. */\n  raw: string;\n  directiveClass: string;\n  noun: string;\n  /** The noun's display label (\"Task\"). */\n  nounLabel: string;\n  /** Items that failed, when some applied and some did not. */\n  failed?: number;\n  /** Items in the block. */\n  total?: number;\n}\n\n/** What failed and what to do — each one short sentence. */\nexport interface DirectiveFailureWords {\n  what: string;\n  next: string;\n}\n\nconst DirectiveHostContext = createContext<DirectiveHost | null>(null);\n\n/** Where a directive renders — today, the conversation it sits in (if any). */\nexport interface DirectiveScope {\n  conversationId?: string | null;\n}\n\nconst DirectiveScopeContext = createContext<DirectiveScope>({});\n\n/**\n * Tell every card below WHERE it renders. A host draws a chat message's\n * directives inside one of these (or passes `conversationId` to\n * `DirectiveRender`), so the card applies in that conversation's namespace —\n * the same key the agent's proposal approves under. A note mounts none.\n */\nexport function DirectiveScopeProvider({\n  conversationId,\n  children,\n}: DirectiveScope & { children: ReactNode }) {\n  return (\n    <DirectiveScopeContext.Provider value={{ conversationId: conversationId ?? null }}>\n      {children}\n    </DirectiveScopeContext.Provider>\n  );\n}\n\nexport function useDirectiveScope(): DirectiveScope {\n  return useContext(DirectiveScopeContext);\n}\n\nexport interface DirectiveHostProviderProps {\n  host: DirectiveHost;\n  children: ReactNode;\n}\n\nexport function DirectiveHostProvider({ host, children }: DirectiveHostProviderProps) {\n  return <DirectiveHostContext.Provider value={host}>{children}</DirectiveHostContext.Provider>;\n}\n\nconst EMPTY_HOST: DirectiveHost = {};\n\n/**\n * The wired directive host. Unlike the render host this does NOT throw when\n * unwired: a directive still renders (named, itemised, copy-less, apply-less)\n * — degrading the chrome is honest, hiding the content is not.\n */\nexport function useDirectiveHost(): DirectiveHost {\n  return useContext(DirectiveHostContext) ?? EMPTY_HOST;\n}\n"],"mappings":";;;AA2BO,IAAM,uBAA+C,CAAC,WAAW;AACtE,UAAQ,MAAM,gBAAgB,OAAO,OAAO,IAAI,OAAO,OAAO,EAAE;AAClE;;;AC0HO,SAAS,WAAW,MAAmC;AAC5D,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,YAAY,KAAK;AAAA,IACjB,aAAa,KAAK;AAAA,IAClB,UAAU,KAAK;AAAA,EACjB;AACF;;;AC1IA,SAAS,iBAAAA,gBAAe,cAAAC,aAAY,eAA+B;;;ACQnE,SAAS,eAAe,kBAAkC;AAmPtD;AApBJ,IAAM,uBAAuB,cAAoC,IAAI;AAOrE,IAAM,wBAAwB,cAA8B,CAAC,CAAC;AA4BvD,SAAS,sBAAsB,EAAE,MAAM,SAAS,GAA+B;AACpF,SAAO,oBAAC,qBAAqB,UAArB,EAA8B,OAAO,MAAO,UAAS;AAC/D;;;AD1PM,gBAAAC,YAAA;AAbN,IAAM,uBAAuBC,eAAoC,IAAI;AAO9D,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAAiC;AAC/B,SACE,gBAAAD,KAAC,qBAAqB,UAArB,EAA8B,OAAO,MACpC,0BAAAA,KAAC,yBAAsB,MAAM,KAAK,cAAc,CAAC,GAAI,UAAS,GAChE;AAEJ;AAOO,SAAS,yBAA+C;AAC7D,SAAOE,YAAW,oBAAoB;AACxC;AAGO,SAAS,mBAAkC;AAChD,QAAM,OAAO,uBAAuB;AACpC,MAAI,CAAC,MAAM;AACT,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,kBAAgC;AAC9C,QAAM,OAAO,iBAAiB;AAC9B,SAAO,QAAQ,MAAM,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;AAC/C;","names":["createContext","useContext","jsx","createContext","useContext"]}
+{"version":3,"sources":["../host/error-report.ts","../host/host-types.ts","../host/ContentIrProvider.tsx","../directives/directive-host.tsx"],"sourcesContent":["/**\n * THE SCREAM SEAM.\n *\n * Every recovery path in this package is loud: a defective component row, a\n * failed resolver load, a kind whose component throws on a provisional value.\n * The package refuses to own where those screams land — matrx-frontend routes\n * them to the Error Inspector, the dashboard to its own log, the extension to\n * its background page. Each host binds one function.\n *\n * A host that binds a no-op has chosen silence, which is a defect in itself;\n * {@link consoleErrorReporter} is the honest default.\n */\n\nexport interface ContentIrErrorReport {\n  /** Always `\"content-ir\"` — hosts key their capture stores on it. */\n  source: \"content-ir\";\n  message: string;\n  name?: string;\n  stack?: string;\n  /** Free-form grouping key (the host's `relation`), e.g. `\"partial-kind\"`. */\n  relation?: string;\n  raw?: unknown;\n}\n\nexport type ContentIrErrorReporter = (report: ContentIrErrorReport) => void;\n\n/** The default when a host binds nothing: never silent. */\nexport const consoleErrorReporter: ContentIrErrorReporter = (report) => {\n  console.error(`[content-ir] ${report.message}`, report.raw ?? \"\");\n};\n","/**\n * THE HOST CONTRACT — everything this package refuses to decide.\n *\n * The kernel (`@ai-matrx/content-ir`) proved the shape: extract the portable\n * part, let host capability enter through explicit named seams. The render\n * layer needs four things it must never own:\n *\n *  1. WHERE KIND DEFINITIONS COME FROM (a bundled table, `content_ir`, a REST\n *     call). The route only asks \"is this kind registered, and does it carry a\n *     legacy bridge / a partial-ready opt-in\".\n *  2. WHERE COMPONENT ROWS COME FROM — {@link ComponentResolutionSource}. The\n *     package ships `ComponentResolver`, which any host can construct with its\n *     own loaders; a host with its own resolver only has to satisfy the type.\n *  3. HOW A ROUTED BLOCK ACTUALLY DRAWS. `applyIrKindRoute` decides a block's\n *     TYPE; turning that type into pixels is the host's dispatch table\n *     (matrx-frontend's `BlockRenderer`, the dashboard's small map). The\n *     package never imports a component library.\n *  4. WHERE SCREAMS LAND — {@link ContentIrErrorReporter}.\n *\n * No Next.js, no Redux, no Supabase, no router, no host error capture. If a\n * seam is missing, ADD A SEAM — never an import.\n */\n\nimport type { ReactNode } from \"react\";\nimport type { KindDefinition } from \"@ai-matrx/content-ir\";\nimport type { ContentIrErrorReporter } from \"./error-report\";\nimport type { ComponentResolutionSource } from \"../resolver/component-resolution.types\";\nimport type { DirectiveHost } from \"../directives/directive-host\";\n\n/**\n * The minimum a render block must expose for the kind route to work. Hosts\n * pass their own richer block type through; the route is generic over `T` and\n * preserves every extra field.\n */\nexport interface IrRoutableBlock {\n  type: string;\n  serverData?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n}\n\n/** A routable block that also carries its source text (the raw region). */\nexport interface IrRenderBlock extends IrRoutableBlock {\n  content: string;\n  language?: string;\n}\n\n/**\n * Where registered kinds come from. `getDefinition` is the only method the\n * pure route needs; the rest drive the granular repaint and the warm-up tick\n * that keeps a cold registry from being mistaken for \"this kind has no\n * component\".\n */\nexport interface KindDefinitionSource {\n  getDefinition(kind: string): KindDefinition | undefined;\n  /** Monotonic per-kind version — the repaint snapshot key. */\n  getKindVersion(kind: string): number;\n  subscribeKind(kind: string, listener: () => void): () => void;\n  /** One definition load per app session. */\n  ensureWarm(): Promise<void>;\n}\n\n/**\n * The rendering seams. Everything here returns host UI; the package supplies\n * the DECISIONS and the chrome-free structure around them.\n */\nexport interface ContentIrRenderSeams {\n  /**\n   * Draw a block the kind route has already typed. This is the host's dispatch\n   * table — the single place a component key becomes a component.\n   */\n  renderBlock(block: IrRenderBlock): ReactNode;\n  /**\n   * THE FLOOR: render ANY JSON value as a human document. Reached when a kind\n   * has no render-trusted component, when the value is not an object at all,\n   * and by the generic structured view.\n   *\n   * This is deliberately a seam and not a bundled component. Rendering a value\n   * WELL means prose through the host's markdown renderer, media through the\n   * host's file handler, and uniform arrays through the host's data table —\n   * all of which are host property. A host that has none of those can pass a\n   * `<pre>`; it will be honest, just plain.\n   */\n  renderValue(props: StructuredValueRenderProps): ReactNode;\n  /**\n   * The \"still arriving\" indicator used by the provisional frame. Optional —\n   * hosts without a shimmer get plain text.\n   */\n  renderShimmer?(text: string): ReactNode;\n  /**\n   * The honest \"this shape has no custom component yet\" notice. Optional: the\n   * package draws a plain amber line when a host supplies nothing, and a host\n   * with an icon set or its own callout component supplies that instead. It is\n   * a seam and not a bundled component because this package depends on no icon\n   * library.\n   */\n  renderNotice?(text: string): ReactNode;\n}\n\nexport interface StructuredValueRenderProps {\n  value: unknown;\n  /** The kind slug this value claims, when known. Honesty line only — never a renderer choice. */\n  kind?: string;\n  /** Why this shape has no custom view, in human words. */\n  note?: string;\n  /** Show the \"what this is / raw data\" footer. Default true. */\n  footer?: boolean;\n}\n\n/**\n * One host, wired once, read by every component in this package through\n * {@link ContentIrRenderProvider}.\n */\nexport interface ContentIrHost extends ContentIrRenderSeams {\n  kinds: KindDefinitionSource;\n  components: ComponentResolutionSource;\n  reportError: ContentIrErrorReporter;\n  /**\n   * The `kind_component.platform` this host resolves as. \"web\" for every\n   * browser UI; the column already models \"react-native\" and friends, and a\n   * host that lies here renders the wrong component everywhere.\n   */\n  platform: string;\n  /**\n   * The Kind Directives seams (apply / open item / copy / noun catalog / item\n   * kind). Optional: a host without them still renders every directive card,\n   * apply-less and copy-less — honest chrome, never hidden content. Provided\n   * to the directive tier by `ContentIrRenderProvider`; a host that has not\n   * adopted the render provider mounts `DirectiveHostProvider` directly.\n   */\n  directives?: DirectiveHost;\n}\n\n/**\n * The pure route's dependencies — a strict subset of {@link ContentIrHost},\n * because `applyIrKindRoute` is called OUTSIDE React (reducers, stream\n * accumulators, tests) where there is no provider to read.\n */\nexport interface KindRouteEnv {\n  kinds: Pick<KindDefinitionSource, \"getDefinition\">;\n  /**\n   * `hasSettled` is optional and read ONLY to suppress a negative verdict from\n   * a registry that has not loaded yet — see THE COLD-VERDICT RULE on\n   * `ComponentResolutionSource`.\n   */\n  components: Pick<ComponentResolutionSource, \"resolve\"> &\n    Partial<Pick<ComponentResolutionSource, \"hasSettled\">>;\n  reportError: ContentIrErrorReporter;\n  platform: string;\n}\n\n/** Narrow a host (or anything host-shaped) to what the pure route needs. */\nexport function routeEnvOf(host: ContentIrHost): KindRouteEnv {\n  return {\n    kinds: host.kinds,\n    components: host.components,\n    reportError: host.reportError,\n    platform: host.platform,\n  };\n}\n","\"use client\";\n\n/**\n * The one place a host is wired in. Everything React in this package reads its\n * capability from here — no module singleton, no import into an app.\n *\n * A host mounts this ONCE, high enough that every kind-rendering surface is\n * inside it:\n *\n * ```tsx\n * <ContentIrRenderProvider host={matrxContentIrHost}>\n *   <App />\n * </ContentIrRenderProvider>\n * ```\n *\n * Reading it outside a provider THROWS rather than falling back to a default.\n * A silent default would render the wrong component for every kind in the app\n * and look like a data problem for weeks.\n */\n\nimport { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type { ContentIrHost, KindRouteEnv } from \"./host-types\";\nimport { routeEnvOf } from \"./host-types\";\nimport { DirectiveHostProvider } from \"../directives/directive-host\";\n\nconst ContentIrHostContext = createContext<ContentIrHost | null>(null);\n\nexport interface ContentIrRenderProviderProps {\n  host: ContentIrHost;\n  children: ReactNode;\n}\n\nexport function ContentIrRenderProvider({\n  host,\n  children,\n}: ContentIrRenderProviderProps) {\n  return (\n    <ContentIrHostContext.Provider value={host}>\n      <DirectiveHostProvider host={host.directives ?? {}}>{children}</DirectiveHostProvider>\n    </ContentIrHostContext.Provider>\n  );\n}\n\n/**\n * The wired host, or null. For the rare consumer that can legitimately run\n * without a provider because it was handed its sources explicitly (see\n * `useContentIrKindVersion`). Everything else uses {@link useContentIrHost}.\n */\nexport function useContentIrHostOrNull(): ContentIrHost | null {\n  return useContext(ContentIrHostContext);\n}\n\n/** The wired host. Throws outside a provider — see the module doc. */\nexport function useContentIrHost(): ContentIrHost {\n  const host = useContentIrHostOrNull();\n  if (!host) {\n    throw new Error(\n      \"[content-ir-react] No ContentIrRenderProvider above this component. \" +\n        \"Mount one at the app root with your host adapter (kind definitions, \" +\n        \"component resolver, renderBlock, renderValue, reportError).\",\n    );\n  }\n  return host;\n}\n\n/** The wired host narrowed to what the pure route functions take. */\nexport function useKindRouteEnv(): KindRouteEnv {\n  const host = useContentIrHost();\n  return useMemo(() => routeEnvOf(host), [host]);\n}\n","\"use client\";\n\n/**\n * THE DIRECTIVE HOST CONTRACT — what the directive tier refuses to decide.\n *\n * The package owns the DECISIONS (decode → renderer → card → floor, the\n * position law, never-null rendering) and the card itself. Four things stay\n * host property and enter through named seams:\n *\n *  1. APPLYING a side-effect directive — `POST /directives/confirm` as the\n *     user, with the host's auth and base URL. Absent → the Apply control is\n *     ABSENT (honest), never a dead button.\n *  2. OPENING an item to read it before approving — a window panel, a dialog,\n *     a route. Absent → items are not clickable.\n *  3. COPY controls — host chrome (matrx-frontend's CopyButtons). Absent → none.\n *  4. The NOUN catalog + item-kind lookup — server-derived tables the host\n *     mirrors (or reads from its kind catalog's `items` edges).\n *  5. ASKING (`ask`), NAMING a record (`renderRecord`), and READING the ledger\n *     (`applyState`) — the consequence before the click, the doors, and the\n *     state that survives a reload.\n *\n * A host that has adopted `ContentIrRenderProvider` passes `directives` on its\n * ContentIrHost; a host that has NOT (Workflow Studio, 2026-09-08) mounts\n * `DirectiveHostProvider` alone — the directive tier never requires the full\n * render host, because a chat bubble must be able to draw a directive card\n * identically everywhere, today.\n */\n\nimport { createContext, useContext, type ReactNode } from \"react\";\nimport type {\n  DecodedDirective,\n  DirectiveItemKindLookup,\n  DirectiveNounCatalog,\n} from \"@ai-matrx/content-ir\";\n\nexport interface DirectiveApplyResult {\n  applied: number;\n  failed: number;\n  /**\n   * The server's own receipt sentence (\"Deleted task “Ship it”.\"), shown in\n   * place of a bare count. Never composed client-side.\n   */\n  message?: string | null;\n  /**\n   * The records the apply created or changed, so the tally is a way IN to them\n   * (no dead ends). Rendered through `renderRecord`; absent → the sentence alone.\n   */\n  records?: DirectiveRecordRef[];\n  /**\n   * For an UPDATE: what each item's fields held just BEFORE the write, by item\n   * index (`null` for an item the server did not record). The card draws the\n   * applied change from this record — never from a live re-read, which after the\n   * apply answers the NEW value (G6A review, 2026-10-02: \"(no change)\" for a\n   * change that happened).\n   */\n  before?: ReadonlyArray<Record<string, unknown> | null>;\n}\n\n/**\n * What the server's action ledger says about ONE block, read on mount so a\n * reloaded page never offers \"Apply\" for work that already ran (reviewer\n * defect 5, 2026-10-02).\n *\n *  - `not_applied` — still to do (or partly done: the batch re-applies, and the\n *    server replays the members it already holds). The card offers Apply.\n *  - `in_flight` — another request is applying it right now. The card says it\n *    is finishing and asks again shortly; it offers neither Apply nor a tally.\n *  - `applied` — the ledger holds every item. The card shows the tally exactly\n *    as a fresh apply would: the ledger's own sentence and the records, as doors.\n */\nexport interface DirectiveApplyState {\n  state: \"not_applied\" | \"in_flight\" | \"applied\";\n  /** The ledger row's sentence (\"Created task.\"), never composed client-side. */\n  message?: string | null;\n  /**\n   * The records the LATEST apply wrote — the tally's doors. After \"Run again\"\n   * that is the newest copy, never the first.\n   */\n  records?: DirectiveRecordRef[];\n  /**\n   * How many times the ledger holds this block as applied: 1 for the original,\n   * one more for every \"Run again\". Absent → 1. A create that ran twice made\n   * two records, and the card says so (reviewer, 2026-10-02).\n   */\n  copies?: number;\n  /**\n   * For an applied UPDATE: each item's replaced values, by item index, from the\n   * ledger row (`null` where the ledger has none — a row from before 2026-10-02).\n   * Absent → the card says only what each field was set to.\n   */\n  before?: ReadonlyArray<Record<string, unknown> | null>;\n}\n\n/** One record a directive names: the noun it is, and its id. */\nexport interface DirectiveRecordRef {\n  noun: string;\n  id: string;\n}\n\nexport interface DirectiveRecordProps extends DirectiveRecordRef {\n  /**\n   * What to show until (or unless) the host resolves the live name —\n   * \"Task 1a2b3c4d\". Never blank, never \"Item\".\n   */\n  fallback: string;\n  /** Where it is drawn: an item row, the confirm dialog, or the applied tally. */\n  context: \"row\" | \"dialog\" | \"applied\";\n  /**\n   * True when the record is (about to be) in the trash — the host may still\n   * name it but should not promise it opens as a live record.\n   */\n  trashed?: boolean;\n}\n\n/** What the person is being asked to approve — everything the card knows. */\nexport interface DirectiveAskRequest {\n  directive: DecodedDirective;\n  /** The items, exactly as they will be sent. */\n  items: Record<string, unknown>[];\n  /** The noun's human label (\"Task\"), from the host's catalog when it has one. */\n  nounLabel: string;\n  /**\n   * True for \"Run again\": the ledger already holds this block, and a yes runs\n   * it a SECOND time (`force`) — another copy for a create, the same fields\n   * written again for an update, another delete for a restored record. The\n   * question must say so.\n   */\n  again?: boolean;\n}\n\n/**\n * The shell a card hands its host — the two keys, plus WHERE it sits.\n *\n * `conversationId` is the conversation the card renders in (a chat message),\n * absent in a person's own content (a note). It is the idempotency NAMESPACE:\n * a card in an agent's message must apply under the SAME key as that\n * proposal's Approve button, or the one action could run twice.\n */\nexport interface DirectiveShell {\n  __kind: string;\n  items: Record<string, unknown>[];\n  conversationId?: string;\n  /** \"Run again\": skip the ledger's dedup and apply a second time. */\n  force?: boolean;\n}\n\nexport interface DirectiveOpenItemOptions {\n  /** The item, `__kind`-stamped when the shape has an item kind. */\n  item: Record<string, unknown>;\n  /** The content-IR kind this item IS, or null when the shape has none. */\n  itemKind: string | null;\n  /** What the item is called — the same title the card shows. */\n  title: string;\n  /** \"Run Create agent definition · item 1 of 1\". */\n  subtitle: string | null;\n  directive: DecodedDirective;\n  index: number;\n  total: number;\n}\n\nexport interface DirectiveCopyProps {\n  /**\n   * What the control is called to a screen reader. Never an id: for a record it\n   * is type-generic (\"this task\"); a host with the record's live name replaces\n   * it through `record`.\n   */\n  label: string;\n  /** The existing record this control copies, when it copies one — to name it. */\n  record?: DirectiveRecordRef;\n  /** The value to copy — the whole shell or one item. */\n  value: unknown;\n  /** The item's kind, when copying an item. */\n  kind?: string | null;\n  size: \"icon\" | \"xs\";\n}\n\nexport interface DirectiveHost {\n  /**\n   * Apply a side-effect directive as the user (the server re-validates every\n   * item against the registered model and runs the ONE handler; idempotent).\n   * Reject with an Error whose message is safe to show.\n   */\n  confirm?: (shell: DirectiveShell) => Promise<DirectiveApplyResult>;\n  /**\n   * Ask the person BEFORE anything runs, naming the consequence (the records,\n   * what changes). Resolve `true` to go ahead, `false` to leave the card as it\n   * was. The Apply control stays idle while this is open — nothing reads as\n   * \"applying\" until the person has said yes. Absent → `confirm` is called\n   * directly (a host that asks inside `confirm` keeps working, but its card\n   * will read \"Applying…\" while its dialog is up).\n   */\n  ask?: (request: DirectiveAskRequest) => Promise<boolean>;\n  /**\n   * Has this exact block already been applied? Read ONCE when the card mounts\n   * (and again while the answer is `in_flight`), so the card survives a reload:\n   * the server ledger, not component state, is what knows. The identity is the\n   * server's (it hashes the validated items in the same namespace `confirm`\n   * applies in), so a host asks — it never computes. Batch on the host side if\n   * a page carries many cards. Reject with an Error when the ledger cannot be\n   * read: the card reports it and offers Apply, which is safe because `confirm`\n   * is idempotent. Absent → the card starts at Apply, as before.\n   */\n  applyState?: (shell: DirectiveShell) => Promise<DirectiveApplyState>;\n  /**\n   * Read the CURRENT values of ONE existing record, so an update says what it\n   * replaces — \"Status open → done\", never just \"→ done\" (reviewer,\n   * 2026-10-02). Resolve `null` when the record cannot be read (no access, no\n   * such record, a noun the host cannot read); reject only for a real failure.\n   * Absent → an update row shows the new values alone, as before.\n   */\n  readRecord?: (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;\n  /**\n   * Draw ONE existing record by its live name, as a way to open it. Used on\n   * update/delete rows (the record that will change), in the host's own ask\n   * dialog if it likes, and on the applied tally (what was written). Absent →\n   * the fallback text, unlinked.\n   */\n  renderRecord?: (props: DirectiveRecordProps) => ReactNode;\n  /** Open ONE item to read it properly before approving the write. */\n  openItem?: (options: DirectiveOpenItemOptions) => void;\n  /** Host copy controls. */\n  renderCopy?: (props: DirectiveCopyProps) => ReactNode;\n  /**\n   * The app's word for one stored value of one pick-list field — the SAME word\n   * the record's own screens and the write forms show (\"incomplete\" on a task\n   * reads \"Inbox\"). One value, one display word everywhere (G8A review,\n   * 2026-10-02: the card said \"Status incomplete → completed\"). Return null for\n   * a field that is not a pick-list: its value is shown as written. Absent →\n   * every value is shown as stored.\n   */\n  valueLabel?: (ref: DirectiveValueRef) => string | null;\n  /** The mirrored noun catalog (label / family / title column). */\n  nouns?: DirectiveNounCatalog;\n  /** slug → the kind ONE item is (THE DIRECTIVE⇄KIND SEAM), or null. */\n  itemKind?: DirectiveItemKindLookup;\n  /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */\n  reportError?: (message: string) => void;\n  /**\n   * Plain words for a failed apply the host recognises (\"This button can't\n   * create a task yet.\" + \"Create it from Tasks instead.\"). The card never shows\n   * the server's raw text as its sentence: it shows these words — or its own\n   * verb-aware default — and keeps the raw text behind \"Details\". Return null\n   * to use the default.\n   */\n  explainFailure?: (failure: DirectiveFailure) => DirectiveFailureWords | null;\n}\n\n/** One stored value of one field of one record type. */\nexport interface DirectiveValueRef {\n  noun: string;\n  field: string;\n  value: string;\n}\n\n/** One failed apply, as the card knows it. */\nexport interface DirectiveFailure {\n  /** The server's / host's own text — technical; shown only behind Details. */\n  raw: string;\n  directiveClass: string;\n  noun: string;\n  /** The noun's display label (\"Task\"). */\n  nounLabel: string;\n  /** Items that failed, when some applied and some did not. */\n  failed?: number;\n  /** Items in the block. */\n  total?: number;\n}\n\n/** What failed and what to do — each one short sentence. */\nexport interface DirectiveFailureWords {\n  what: string;\n  next: string;\n}\n\nconst DirectiveHostContext = createContext<DirectiveHost | null>(null);\n\n/** Where a directive renders — today, the conversation it sits in (if any). */\nexport interface DirectiveScope {\n  conversationId?: string | null;\n}\n\nconst DirectiveScopeContext = createContext<DirectiveScope>({});\n\n/**\n * Tell every card below WHERE it renders. A host draws a chat message's\n * directives inside one of these (or passes `conversationId` to\n * `DirectiveRender`), so the card applies in that conversation's namespace —\n * the same key the agent's proposal approves under. A note mounts none.\n */\nexport function DirectiveScopeProvider({\n  conversationId,\n  children,\n}: DirectiveScope & { children: ReactNode }) {\n  return (\n    <DirectiveScopeContext.Provider value={{ conversationId: conversationId ?? null }}>\n      {children}\n    </DirectiveScopeContext.Provider>\n  );\n}\n\nexport function useDirectiveScope(): DirectiveScope {\n  return useContext(DirectiveScopeContext);\n}\n\nexport interface DirectiveHostProviderProps {\n  host: DirectiveHost;\n  children: ReactNode;\n}\n\nexport function DirectiveHostProvider({ host, children }: DirectiveHostProviderProps) {\n  return <DirectiveHostContext.Provider value={host}>{children}</DirectiveHostContext.Provider>;\n}\n\nconst EMPTY_HOST: DirectiveHost = {};\n\n/**\n * The wired directive host. Unlike the render host this does NOT throw when\n * unwired: a directive still renders (named, itemised, copy-less, apply-less)\n * — degrading the chrome is honest, hiding the content is not.\n */\nexport function useDirectiveHost(): DirectiveHost {\n  return useContext(DirectiveHostContext) ?? EMPTY_HOST;\n}\n"],"mappings":";;;AA2BO,IAAM,uBAA+C,CAAC,WAAW;AACtE,UAAQ,MAAM,gBAAgB,OAAO,OAAO,IAAI,OAAO,OAAO,EAAE;AAClE;;;AC0HO,SAAS,WAAW,MAAmC;AAC5D,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,YAAY,KAAK;AAAA,IACjB,aAAa,KAAK;AAAA,IAClB,UAAU,KAAK;AAAA,EACjB;AACF;;;AC1IA,SAAS,iBAAAA,gBAAe,cAAAC,aAAY,eAA+B;;;ACQnE,SAAS,eAAe,kBAAkC;AA0QtD;AApBJ,IAAM,uBAAuB,cAAoC,IAAI;AAOrE,IAAM,wBAAwB,cAA8B,CAAC,CAAC;AA4BvD,SAAS,sBAAsB,EAAE,MAAM,SAAS,GAA+B;AACpF,SAAO,oBAAC,qBAAqB,UAArB,EAA8B,OAAO,MAAO,UAAS;AAC/D;;;ADjRM,gBAAAC,YAAA;AAbN,IAAM,uBAAuBC,eAAoC,IAAI;AAO9D,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAAiC;AAC/B,SACE,gBAAAD,KAAC,qBAAqB,UAArB,EAA8B,OAAO,MACpC,0BAAAA,KAAC,yBAAsB,MAAM,KAAK,cAAc,CAAC,GAAI,UAAS,GAChE;AAEJ;AAOO,SAAS,yBAA+C;AAC7D,SAAOE,YAAW,oBAAoB;AACxC;AAGO,SAAS,mBAAkC;AAChD,QAAM,OAAO,uBAAuB;AACpC,MAAI,CAAC,MAAM;AACT,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,kBAAgC;AAC9C,QAAM,OAAO,iBAAiB;AAC9B,SAAO,QAAQ,MAAM,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;AAC/C;","names":["createContext","useContext","jsx","createContext","useContext"]}

package/dist/index.cjs

@@ -44,6 +44,7 @@ __export(index_exports, {
   DirectiveProvisionalCard: () => DirectiveProvisionalCard,
   DirectiveRender: () => DirectiveRender,
   DirectiveScopeProvider: () => DirectiveScopeProvider,
+  EMPTY_VALUE_WORD: () => EMPTY_VALUE_WORD,
   GENERIC_STRUCTURED_COMPONENT_KEY: () => GENERIC_STRUCTURED_COMPONENT_KEY,
   GenericStructuredView: () => GenericStructuredView,
   IR_PROVISIONAL_KEY: () => IR_PROVISIONAL_KEY,
@@ -61,6 +62,8 @@ __export(index_exports, {
   createKindRouteBinding: () => createKindRouteBinding,
   defaultFailureWords: () => defaultFailureWords,
   describeChangeValue: () => describeChangeValue,
+  directiveFieldLabel: () => directiveFieldLabel,
+  directiveValueWord: () => directiveValueWord,
   envelopeFromPartialKind: () => envelopeFromPartialKind,
   failureWords: () => failureWords,
   fieldLabel: () => fieldLabel,
@@ -841,9 +844,10 @@ var import_content_ir3 = require("@ai-matrx/content-ir");
 
 // directives/item-changes.ts
 var import_uuid = require("@ai-matrx/kit/uuid");
+var import_text_case = require("@ai-matrx/kit/text-case");
 var TARGETING_CLASSES = /* @__PURE__ */ new Set(["update", "delete"]);
 var NOT_A_CHANGE = /* @__PURE__ */ new Set(["__kind", "id"]);
-var CHANGE_VALUE_MAX = 60;
+var CHANGE_VALUE_MAX = 280;
 function itemRecordId(item) {
   const id = item.id;
   if (typeof id === "string" && id.trim()) return id.trim();
@@ -851,21 +855,27 @@ function itemRecordId(item) {
   return null;
 }
 function fieldLabel(key) {
-  const spaced = key.replace(/_/g, " ").trim();
-  return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+  return (0, import_text_case.humanizeIdentifier)(key) || key;
 }
+function directiveFieldLabel(key, titleColumn) {
+  return titleColumn && key === titleColumn ? "Title" : fieldLabel(key);
+}
+var EMPTY_VALUE_WORD = "None";
 function recordFallbackName(nounLabel3, id) {
   const short = (0, import_uuid.isUuidShape)(id) ? id.slice(0, 8) : id.length > 12 ? `${id.slice(0, 12)}\u2026` : id;
   return `${nounLabel3} ${short}`;
 }
-function describeChangeValue(value) {
-  return describeValue(value);
+function describeChangeValue(value, word) {
+  return describeValue(value, word);
 }
-function describeValue(value) {
-  if (value === null || value === void 0) return { value: "cleared", full: "cleared", clears: true };
+var EMPTY = { value: EMPTY_VALUE_WORD, full: EMPTY_VALUE_WORD, clears: true };
+function describeValue(value, word) {
+  if (value === null || value === void 0) return EMPTY;
   if (typeof value === "string") {
     const trimmed = value.trim();
-    if (!trimmed) return { value: "cleared", full: "cleared", clears: true };
+    if (!trimmed) return EMPTY;
+    const named = word?.(trimmed) ?? null;
+    if (named) return { value: named, full: named, clears: false };
     const oneLine = trimmed.replace(/\s+/g, " ");
     const shown = oneLine.length > CHANGE_VALUE_MAX ? `${oneLine.slice(0, CHANGE_VALUE_MAX - 1)}\u2026` : oneLine;
     return { value: shown, full: trimmed, clears: false };
@@ -875,11 +885,11 @@ function describeValue(value) {
   }
   if (Array.isArray(value)) {
     const n2 = value.length;
-    const text2 = n2 === 0 ? "cleared" : `${n2} ${n2 === 1 ? "entry" : "entries"}`;
+    const text2 = n2 === 0 ? EMPTY_VALUE_WORD : `${n2} ${n2 === 1 ? "entry" : "entries"}`;
     return { value: text2, full: safeJson(value), clears: n2 === 0 };
   }
   const n = Object.keys(value).length;
-  const text = n === 0 ? "cleared" : `${n} ${n === 1 ? "field" : "fields"}`;
+  const text = n === 0 ? EMPTY_VALUE_WORD : `${n} ${n === 1 ? "field" : "fields"}`;
   return { value: text, full: safeJson(value), clears: n === 0 };
 }
 function safeJson(value) {
@@ -904,10 +914,12 @@ function itemChanges(item, current, options = {}) {
   const titleColumn = options.titleColumn ?? null;
   for (const [key, raw] of Object.entries(item)) {
     if (NOT_A_CHANGE.has(key)) continue;
-    const label = key === titleColumn ? "Title" : fieldLabel(key);
-    const change = { key, label, ...describeValue(raw) };
+    const label = directiveFieldLabel(key, titleColumn);
+    const valueWord = options.valueWord;
+    const word = key === titleColumn || !valueWord ? void 0 : (v) => valueWord(key, v);
+    const change = { key, label, ...describeValue(raw, word) };
     if (current && Object.prototype.hasOwnProperty.call(current, key)) {
-      change.before = describeValue(current[key]);
+      change.before = describeValue(current[key], word);
       change.same = sameValue(current[key], raw);
     }
     out.push(change);
@@ -1363,7 +1375,7 @@ function ApplyDirectiveButton({
               type: "button",
               disabled: askingAgain,
               onClick: () => void handleApply(!bad),
-              className: "inline-flex items-center gap-1 rounded px-1 py-0.5 text-muted-foreground hover:bg-accent hover:text-accent-foreground disabled:opacity-50",
+              className: "inline-flex shrink-0 items-center gap-1 whitespace-nowrap rounded px-1 py-0.5 text-muted-foreground hover:bg-accent hover:text-accent-foreground disabled:opacity-50",
               "data-apply-action": bad ? "retry" : "run-again",
               children: [
                 /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(RotateCcwIcon, { className: "h-3 w-3" }),
@@ -1403,8 +1415,8 @@ function ApplyDirectiveButton({
   }
   const destructive = directive.directiveClass === "delete";
   const muted = nothingToChange && view.status === "idle";
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("span", { className: "inline-flex items-center gap-2", children: [
-    muted ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "text-xs text-muted-foreground", "data-apply-nothing": "", children: "Nothing to change" }) : null,
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("span", { className: "flex min-w-0 flex-wrap items-center justify-end gap-x-2 gap-y-1", children: [
+    muted ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "min-w-0 text-xs text-muted-foreground", "data-apply-nothing": "", children: "Nothing to change" }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
       "button",
       {
@@ -1413,7 +1425,7 @@ function ApplyDirectiveButton({
         disabled: view.status === "applying" || view.status === "asking" || items.length === 0,
         "data-apply-tone": muted ? "muted" : destructive ? "destructive" : "default",
         title: muted ? "It sets no fields, so applying it changes nothing." : void 0,
-        className: `inline-flex items-center gap-1 rounded-md border px-2 py-1 text-xs font-medium disabled:opacity-50 ${muted ? "border-border/60 bg-background text-muted-foreground hover:bg-accent" : destructive ? "border-destructive/50 bg-background text-destructive hover:bg-destructive/10" : "border-border bg-background hover:bg-accent"}`,
+        className: `inline-flex shrink-0 items-center gap-1 whitespace-nowrap rounded-md border px-2 py-1 text-xs font-medium disabled:opacity-50 ${muted ? "border-border/60 bg-background text-muted-foreground hover:bg-accent" : destructive ? "border-destructive/50 bg-background text-destructive hover:bg-destructive/10" : "border-border bg-background hover:bg-accent"}`,
         children: [
           view.status === "applying" ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(LoaderIcon, { className: "h-3.5 w-3.5 animate-spin" }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PlayIcon, { className: "h-3.5 w-3.5" }),
           view.status === "applying" ? `Applying${itemCount ? ` ${itemCount} ${itemCount === 1 ? "item" : "items"}` : ""}\u2026${elapsed ? ` ${elapsed}s` : ""}` : label
@@ -1464,7 +1476,7 @@ function FailureNotice({
           type: "button",
           onClick: () => setOpen((v) => !v),
           "aria-expanded": open,
-          className: "ml-1 underline underline-offset-2 hover:no-underline",
+          className: "ml-1 whitespace-nowrap underline underline-offset-2 hover:no-underline",
           "data-apply-failure-details-toggle": true,
           children: open ? "Hide details" : "Details"
         }
@@ -1571,6 +1583,14 @@ function resetDirectiveRenderers() {
 var import_react6 = require("react");
 var import_content_ir7 = require("@ai-matrx/content-ir");
 var import_jsx_runtime7 = require("react/jsx-runtime");
+function directiveValueWord(host, noun) {
+  const valueLabel = host.valueLabel;
+  return valueLabel ? (field, value) => valueLabel({ noun, field, value }) : null;
+}
+function omitKey(item, key) {
+  const { [key]: _omitted, ...rest } = item;
+  return rest;
+}
 var ROWS_BEFORE_FOLD = 3;
 function ItemRow({
   directive,
@@ -1587,16 +1607,21 @@ function ItemRow({
   const titleColumn = (0, import_content_ir7.nounTitleColumn)(directive.noun, host.nouns);
   const title = (0, import_content_ir7.itemTitle)(item, titleColumn, index, total);
   const subtitle = (0, import_content_ir7.itemSubtitle)(item);
-  const facts = (0, import_content_ir7.itemFacts)(item);
+  const valueWord = directiveValueWord(host, directive.noun);
+  const facts = (0, import_content_ir7.itemFacts)(titleColumn ? omitKey(item, titleColumn) : item).map((fact) => ({
+    ...fact,
+    label: directiveFieldLabel(fact.key, titleColumn),
+    value: valueWord?.(fact.key, fact.value) ?? fact.value
+  }));
   const kind = host.itemKind?.(directive.slug) ?? null;
   const display = (0, import_content_ir7.directiveDisplay)(directive.directiveClass, directive.noun, host.nouns);
   const openItem = host.openItem;
   const body = /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_jsx_runtime7.Fragment, { children: [
     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "min-w-0 shrink-0 truncate font-medium text-foreground", children: title }),
-    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "hidden min-w-0 flex-1 items-baseline gap-2 overflow-hidden sm:flex", children: facts.map((fact) => /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: "truncate text-[11px] text-muted-foreground", children: [
-      fact.value,
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "hidden min-w-0 flex-1 items-baseline gap-2 overflow-hidden sm:flex", children: facts.map((fact) => /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: "truncate text-[11px] text-muted-foreground", "data-item-fact": fact.key, children: [
+      fact.label,
       " ",
-      fact.label
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "text-foreground/80", children: fact.value })
     ] }, fact.key)) }),
     subtitle && facts.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "hidden truncate text-[11px] text-muted-foreground sm:inline", children: subtitle }) : null,
     openItem ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(MaximizeIcon, { className: "ml-auto h-3 w-3 shrink-0 text-muted-foreground" }) : null
@@ -1631,35 +1656,36 @@ function DirectiveChangeList({
   if (changes.length === 0) {
     return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { className: `text-[11px] text-muted-foreground${className ? ` ${className}` : ""}`, children: "Sets no fields \u2014 nothing would change." });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("ul", { className: `space-y-0.5${className ? ` ${className}` : ""}`, "data-directive-changes": "", children: changes.map((change) => {
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("ul", { className: `@container space-y-1${className ? ` ${className}` : ""}`, "data-directive-changes": "", children: changes.map((change) => {
     const before = change.before && !change.same ? change.before : null;
-    const was = before ? before.clears ? "empty" : before.value : null;
     return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
       "li",
       {
-        className: "flex min-w-0 items-baseline gap-1.5 text-[11px]",
-        title: before ? `${change.label}: ${before.clears ? "empty" : before.full} \u2192 ${change.full}` : `${change.label} \u2192 ${change.full}`,
+        className: "flex min-w-0 flex-col text-[11px] @xs:flex-row @xs:flex-wrap @xs:items-baseline @xs:gap-x-1.5",
+        title: before ? `${change.label}: ${before.full} \u2192 ${change.full}` : `${change.label} \u2192 ${change.full}`,
         "data-change-key": change.key,
         children: [
           /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "shrink-0 text-muted-foreground", children: change.label }),
-          was !== null ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+          before ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
             "span",
             {
-              className: "min-w-0 max-w-[40%] shrink truncate text-muted-foreground line-through",
+              className: "min-w-0 text-muted-foreground line-through [overflow-wrap:anywhere]",
               "data-change-before": "",
-              children: was
+              children: before.value
             }
           ) : null,
-          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { "aria-hidden": true, className: "shrink-0 text-muted-foreground", children: "\u2192" }),
-          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
-            "span",
-            {
-              className: `min-w-0 truncate ${change.clears ? "italic text-muted-foreground" : "text-foreground"}`,
-              "data-change-after": "",
-              children: change.value
-            }
-          ),
-          change.same ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "shrink-0 text-muted-foreground", children: "(no change)" }) : null
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: "flex min-w-0 items-baseline gap-1.5", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { "aria-hidden": true, className: "shrink-0 text-muted-foreground", children: "\u2192" }),
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+              "span",
+              {
+                className: `min-w-0 [overflow-wrap:anywhere] ${change.clears ? "italic text-muted-foreground" : "text-foreground"}`,
+                "data-change-after": "",
+                children: change.value
+              }
+            ),
+            change.same ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "shrink-0 text-muted-foreground", children: "(no change)" }) : null
+          ] })
         ]
       },
       change.key
@@ -1682,12 +1708,20 @@ function TargetRow({
     readsLive ? { noun: directive.noun, id: recordId } : null
   );
   const compareTo = phase.phase === "applied" ? phase.before?.[index] ?? null : readsLive ? live.values : null;
-  const changes = isUpdate ? itemChanges(item, compareTo, { titleColumn: (0, import_content_ir7.nounTitleColumn)(directive.noun, host.nouns) }) : [];
+  const changes = isUpdate ? itemChanges(item, compareTo, {
+    titleColumn: (0, import_content_ir7.nounTitleColumn)(directive.noun, host.nouns),
+    valueWord: directiveValueWord(host, directive.noun)
+  }) : [];
   const name = host.renderRecord ? host.renderRecord({ noun: directive.noun, id: recordId, fallback, context: "row" }) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "truncate font-medium text-foreground", children: fallback });
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "py-1 text-xs", "data-directive-target": recordId, children: [
     /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "flex min-w-0 items-center gap-2", children: [
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "flex min-w-0 flex-1 items-center gap-1 px-1", children: name }),
-      host.renderCopy?.({ label: fallback, value: item, size: "xs" })
+      host.renderCopy?.({
+        label: `this ${(0, import_content_ir7.nounLabel)(directive.noun, host.nouns).toLowerCase()}`,
+        value: item,
+        size: "xs",
+        record: { noun: directive.noun, id: recordId }
+      })
     ] }),
     isUpdate ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DirectiveChangeList, { changes, className: "mt-0.5 px-1" }) : null
   ] });
@@ -1715,7 +1749,7 @@ function SideEffectDirectiveCard({ directive }) {
         " ",
         total === 1 ? "item" : "items"
       ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "ml-auto flex items-center gap-1", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "ml-auto flex min-w-0 flex-wrap items-center justify-end gap-1", children: [
         host.renderCopy?.({ label: display.title, value: directive.shell, size: "icon" }),
         /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
           ApplyDirectiveButton,
@@ -1737,7 +1771,7 @@ function SideEffectDirectiveCard({ directive }) {
       {
         type: "button",
         onClick: () => setExpanded((v) => !v),
-        className: "mt-0.5 inline-flex items-center gap-1 rounded px-1 py-0.5 text-[11px] text-muted-foreground hover:text-foreground",
+        className: "mt-0.5 inline-flex items-center gap-1 whitespace-nowrap rounded px-1 py-0.5 text-[11px] text-muted-foreground hover:text-foreground",
         children: [
           expanded ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ChevronDownIcon, { className: "h-3 w-3" }) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ChevronRightIcon, { className: "h-3 w-3" }),
           expanded ? "Show less" : `Show ${hidden} more`