@ai-matrx/chat 0.7.3 → 0.7.4

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @ai-matrx/chat
 
+## 0.7.4
+### Unreleased
+
+- THE ADMIN SEAT beyond reply: new `adminSeatOpen(state)` (`host/admin-seat.ts`). On an admin page a platform admin is the
+  creator of every agent (`useCreatorOwnershipSync`), every agent link opens in the System Agents tree
+  (`AgentAddressViewer.adminSeat`), and an agent-scoped history read shows every person's runs. User pages unchanged.
+- `ConversationHistorySidebar` (dense): new `titleFirst` prop for narrow hosts (a board tile's sidebar). Rows drop the agent
+  chip and origin badge and show the star only on a favorite (adding one stays in the row menu), so the title wins the row.
+  Default unchanged.
+
 ## 0.7.3
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/agents/addressing/agentAddress.d.ts

@@ -112,6 +112,14 @@ export declare function isSystemAgentType(agentType: string | null): boolean;
  */
 export interface AgentAddressViewer {
     isAdmin: boolean;
+    /**
+     * THE ADMIN SEAT (`adminSeatOpen`): an admin standing on an admin page. There
+     * EVERY agent — user agents included — opens in the admin System Agents
+     * tree, so editing someone's agent from the admin system stays inside it
+     * (the admin lane, and with it the admin's write access, is open only
+     * there). Off the admin pages the seat is closed and the kind rule applies.
+     */
+    adminSeat?: boolean;
 }
 /** The route prefix an agent of this kind lives under, for this viewer. */
 export declare function agentBasePathFor(agentType: string | null, viewer?: AgentAddressViewer): string;

package/dist/agents/addressing/agentAddress.js

@@ -8,6 +8,7 @@ function isSystemAgentType(agentType) {
   return agentType === "builtin";
 }
 function agentBasePathFor(agentType, viewer) {
+  if (viewer?.adminSeat && viewer.isAdmin) return SYSTEM_AGENT_BASE_PATH;
   return isSystemAgentType(agentType) && (viewer?.isAdmin ?? true) ? SYSTEM_AGENT_BASE_PATH : AGENT_BASE_PATH;
 }
 const ADMIN_ONLY_AGENT_SUBROUTES = /* @__PURE__ */ new Set(["samples"]);

package/dist/agents/addressing/useAgentHref.js

@@ -13,6 +13,7 @@ import {
   resolveAgentAddress
 } from "./agentAddressCache.js";
 import { selectIsAdmin } from "../../host/identity.js";
+import { adminSeatOpen } from "../../host/admin-seat.js";
 const noSubscribe = () => () => {
 };
 function useAgentAddressViewer() {
@@ -25,7 +26,13 @@ function useAgentAddressViewer() {
     read,
     read
   );
-  return isAdmin === void 0 ? void 0 : { isAdmin };
+  const readSeat = () => store ? adminSeatOpen(store.getState()) : false;
+  const adminSeat = useSyncExternalStore(
+    store ? store.subscribe : noSubscribe,
+    readSeat,
+    () => false
+  );
+  return isAdmin === void 0 ? void 0 : { isAdmin, adminSeat };
 }
 function useAgentHref({
   id,

package/dist/agents/components/conversation-history/ConversationHistorySidebar.d.ts

@@ -143,6 +143,13 @@ export interface ConversationHistorySidebarProps {
      * list refreshes each time it mounts.
      */
     keepLoaded?: boolean;
+    /**
+     * Rows in a narrow host (a board tile's sidebar): the title wins the row.
+     * The agent chip is dropped (every row would repeat the one agent) and the
+     * star shows only on a row that is already a favorite — adding one lives in
+     * the row menu. The time stays, compact. Default false.
+     */
+    titleFirst?: boolean;
     className?: string;
     /** Extra classes for the built-in search input (dense). */
     searchInputClassName?: string;

package/dist/agents/components/conversation-history/ConversationHistorySidebar.js

@@ -380,6 +380,7 @@ const DenseView = ({
   headerActions,
   showSearch = true,
   showGroupingToggle = true,
+  titleFirst = false,
   className,
   searchInputClassName,
   sectionHeaderClassName
@@ -510,7 +511,8 @@ const DenseView = ({
               onToggleFavorite: onToggleFavoriteResolved,
               resolveHref,
               surfaceKey,
-              getSourceMenuCtx
+              getSourceMenuCtx,
+              titleFirst
             },
             `search-${conv.conversationId}`
           ))
@@ -536,7 +538,8 @@ const DenseView = ({
               onToggleFavorite: onToggleFavoriteResolved,
               resolveHref,
               surfaceKey,
-              getSourceMenuCtx
+              getSourceMenuCtx,
+              titleFirst
             },
             `fav-${conv.conversationId}`
           ))
@@ -562,7 +565,8 @@ const DenseView = ({
               onToggleFavorite: onToggleFavoriteResolved,
               resolveHref,
               surfaceKey,
-              getSourceMenuCtx
+              getSourceMenuCtx,
+              titleFirst
             },
             conv.conversationId
           ))
@@ -598,6 +602,7 @@ const DenseView = ({
               resolveHref,
               surfaceKey,
               getSourceMenuCtx,
+              titleFirst,
               showAgentHint: false
             },
             conv.conversationId
@@ -886,19 +891,20 @@ const Row = ({
   resolveHref,
   surfaceKey,
   getSourceMenuCtx,
-  showAgentHint = true
+  showAgentHint = true,
+  titleFirst = false
 }) => {
   const title = conv.title?.trim() || untitled(conv);
   const agentName = useAppSelector(
     (s) => conv.agentId ? selectAgentById(s, conv.agentId)?.name ?? null : null
   );
-  const star = onToggleFavorite ? /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: isFavorite ? /* @__PURE__ */ jsx(Star, { fill: "currentColor" }) : /* @__PURE__ */ jsx(StarOff, {}), onClick: (e) => {
+  const star = onToggleFavorite && (!titleFirst || isFavorite) ? /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: isFavorite ? /* @__PURE__ */ jsx(Star, { fill: "currentColor" }) : /* @__PURE__ */ jsx(StarOff, {}), onClick: (e) => {
     e.stopPropagation();
     e.preventDefault();
     onToggleFavorite(conv);
   }, "aria-label": isFavorite ? "Remove from favorites" : "Add to favorites", title: isFavorite ? "Remove from favorites" : "Add to favorites" }) : null;
   const meta = formatRelative(conv.updatedAt);
-  const originBadge = conv.originClass && conv.originClass !== "human" ? /* @__PURE__ */ jsx(
+  const originBadge = !titleFirst && conv.originClass && conv.originClass !== "human" ? /* @__PURE__ */ jsx(
     "span",
     {
       className: "inline-flex h-4 shrink-0 items-center rounded-full border border-border px-1.5 text-[9px] font-medium text-muted-foreground",
@@ -906,7 +912,7 @@ const Row = ({
       children: originClassLabel(conv.originClass)
     }
   ) : null;
-  const trailing = showAgentHint && conv.agentId ? /* @__PURE__ */ jsxs(Fragment, { children: [
+  const trailing = showAgentHint && !titleFirst && conv.agentId ? /* @__PURE__ */ jsxs(Fragment, { children: [
     originBadge,
     /* @__PURE__ */ jsx(
       "span",

package/dist/agents/components/shared/assistant-message-layout.d.ts

@@ -27,3 +27,24 @@ export declare const ASSISTANT_MESSAGE_COLUMN_INSET_CLASS = "px-2";
 export declare const WIDE_FIGURE_MAX_WIDTH_PX = 1100;
 export declare const WIDE_FIGURE_SCOPE_ATTRIBUTE = "data-wide-figures";
 export declare const WIDE_FIGURE_CLASS = "[[data-wide-figures]_&]:w-[max(100%,min(1100px,100cqi_-_2rem))] [[data-wide-figures]_&]:ml-[calc((100%_-_max(100%,min(1100px,100cqi_-_2rem)))/2)]";
+/**
+ * The marker a wide figure carries (beside `WIDE_FIGURE_CLASS`) so the message
+ * wrappers around it can make room for it — see `WIDE_FIGURE_HOST_CLASS`.
+ */
+export declare const WIDE_FIGURE_ATTRIBUTE = "data-wide-figure";
+/**
+ * A message's own wrappers clip sideways (`overflow-x: clip`) so wide prose
+ * never blows out the column — which also cut a wide figure back down to the
+ * column, hiding its left edge and its header actions (2026-10-08). A wrapper
+ * carrying this class, in an opted-in transcript, when it holds a wide figure,
+ * moves its clip edge out to the figure's band: negative margins + equal
+ * padding, so its CONTENT box stays exactly the column while its clip box is
+ * the band. Inert everywhere else (no scope, no figure → no change).
+ */
+export declare const WIDE_FIGURE_HOST_CLASS = "[[data-wide-figures]_&:has([data-wide-figure])]:[--wf-bleed:max(0px,calc((min(1100px,100cqi_-_2rem)_-_100%)/2))] [[data-wide-figures]_&:has([data-wide-figure])]:w-auto [[data-wide-figures]_&:has([data-wide-figure])]:mx-[calc(-1*var(--wf-bleed))] [[data-wide-figures]_&:has([data-wide-figure])]:px-[var(--wf-bleed)]";
+/**
+ * On the wrapper that holds the blocks: while it has been widened for a figure,
+ * every OTHER block keeps the column's clip edge, so prose still never spills
+ * into the band.
+ */
+export declare const WIDE_FIGURE_PROSE_CLIP_CLASS = "[[data-wide-figures]_&:has([data-wide-figure])>*:not(:has([data-wide-figure]))]:overflow-x-clip";

package/dist/agents/components/shared/assistant-message-layout.js

@@ -3,10 +3,16 @@ const ASSISTANT_MESSAGE_COLUMN_INSET_CLASS = "px-2";
 const WIDE_FIGURE_MAX_WIDTH_PX = 1100;
 const WIDE_FIGURE_SCOPE_ATTRIBUTE = "data-wide-figures";
 const WIDE_FIGURE_CLASS = "[[data-wide-figures]_&]:w-[max(100%,min(1100px,100cqi_-_2rem))] [[data-wide-figures]_&]:ml-[calc((100%_-_max(100%,min(1100px,100cqi_-_2rem)))/2)]";
+const WIDE_FIGURE_ATTRIBUTE = "data-wide-figure";
+const WIDE_FIGURE_HOST_CLASS = "[[data-wide-figures]_&:has([data-wide-figure])]:[--wf-bleed:max(0px,calc((min(1100px,100cqi_-_2rem)_-_100%)/2))] [[data-wide-figures]_&:has([data-wide-figure])]:w-auto [[data-wide-figures]_&:has([data-wide-figure])]:mx-[calc(-1*var(--wf-bleed))] [[data-wide-figures]_&:has([data-wide-figure])]:px-[var(--wf-bleed)]";
+const WIDE_FIGURE_PROSE_CLIP_CLASS = "[[data-wide-figures]_&:has([data-wide-figure])>*:not(:has([data-wide-figure]))]:overflow-x-clip";
 export {
   ASSISTANT_MESSAGE_COLUMN_CLASS,
   ASSISTANT_MESSAGE_COLUMN_INSET_CLASS,
+  WIDE_FIGURE_ATTRIBUTE,
   WIDE_FIGURE_CLASS,
+  WIDE_FIGURE_HOST_CLASS,
   WIDE_FIGURE_MAX_WIDTH_PX,
+  WIDE_FIGURE_PROSE_CLIP_CLASS,
   WIDE_FIGURE_SCOPE_ATTRIBUTE
 };

package/dist/agents/hooks/useCreatorOwnershipSync.js

@@ -2,6 +2,7 @@
 import { useEffect } from "react";
 import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
 import { setIsCreator } from "../../host/prefs.js";
+import { adminSeatOpen } from "../../host/admin-seat.js";
 import { selectAgentIsOwner } from "../redux/agent-definition/selectors.js";
 import { fetchAgentAccessLevel } from "../redux/agent-definition/thunks.js";
 function useCreatorOwnershipSync(agentId) {
@@ -14,7 +15,8 @@ function useCreatorOwnershipSync(agentId) {
       void dispatch(fetchAgentAccessLevel(agentId));
     }
   }, [dispatch, agentId, isOwnerFlag]);
-  const isOwner = !!agentId && isOwnerFlag === true;
+  const adminSeat = useAppSelector((state) => adminSeatOpen(state));
+  const isOwner = !!agentId && (isOwnerFlag === true || adminSeat);
   useEffect(() => {
     dispatch(setIsCreator(isOwner));
     return () => {

package/dist/agents/redux/conversation-history/thunks.js

@@ -24,6 +24,7 @@ import {
 } from "./types.js";
 import { readListRpc } from "../../../host/ui-slots.js";
 import { getUserId, hasBrowserSession } from "../../../host/identity.js";
+import { adminSeatOpen } from "../../../host/admin-seat.js";
 const fetchConversationHistory = createAsyncThunk(
   "conversationHistory/fetchPage",
   async (args, { dispatch, getState, rejectWithValue }) => {
@@ -66,7 +67,7 @@ const fetchConversationHistory = createAsyncThunk(
       return { scopeId: args.scopeId, items: [], hasMore: false, nextOffset: 0, replace };
     }
     let query = supabase.schema("chat").from("conversation").select(CONVERSATION_ROW_COLUMNS).is("deleted_at", null).eq("is_ephemeral", false).order("updated_at", { ascending: false }).range(offset, offset + pageSize - 1);
-    if (viewerId) {
+    if (viewerId && !(agentIds.length > 0 && adminSeatOpen(getState()))) {
       query = query.eq("created_by", viewerId);
     }
     if (agentIds.length > 0) {

package/dist/agents/redux/execution-system/instance-resources/rendered-artifact-draft.d.ts

@@ -0,0 +1,23 @@
+/**
+ * THE COMPOSER'S ATTACHED CODE / TEXT CHIPS SURVIVE A RELOAD.
+ *
+ * A picked file outlives a reload because attaching it writes a durable edge on
+ * the conversation; an "Attach code" / "Attach text" chip (a `rendered_artifact`
+ * reference to a canvas item or html page) lived only in Redux, so a reload
+ * took it away while the files beside it came back (2026-10-08). This keeps
+ * those chips with the composer's text draft — same storage, same scope (this
+ * browser, this signed-in person, `composer-draft-store.ts`), written by the
+ * composer draft middleware whenever the conversation's resources change and
+ * offered back by `useComposerDraftRestore`. A chip that was sent is gone from
+ * the record the moment its turn is submitted.
+ */
+import type { Dispatch } from "@reduxjs/toolkit";
+import type { ChatRootState } from "../../../../store/root-state.js";
+/** The conversation a resource action is about, or null for any other action. */
+export declare function renderedArtifactDraftConversation(action: unknown): string | null;
+/** Write (or clear) the conversation's unsent code/text chips from the current state. */
+export declare function persistRenderedArtifactChips(state: ChatRootState, conversationId: string, owner: string | null): void;
+/** Put back this person's unsent code/text chips for a conversation; answers how many came back. */
+export declare function restoreRenderedArtifactChips(dispatch: Dispatch, getState: () => ChatRootState, conversationId: string, owner: string | null): number;
+/** Test seam ONLY. */
+export declare function __resetRenderedArtifactDraftForTest(): void;

package/dist/agents/redux/execution-system/instance-resources/rendered-artifact-draft.js

@@ -0,0 +1,100 @@
+import { RENDERED_ARTIFACT_BLOCK_TYPE } from "../../../utils/renderedArtifactContext.js";
+import {
+  addResource,
+  clearAllResources,
+  clearSubmittedResources,
+  markResourcesSubmitted,
+  removeInstanceResources,
+  removeResource,
+  setResourcePreview,
+  updateResourceOptions
+} from "./instance-resources.slice.js";
+const KEY_PREFIX = "matrx:composer-artifact-chips:";
+const TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+const RESOURCE_ACTIONS = /* @__PURE__ */ new Set([
+  addResource.type,
+  removeResource.type,
+  setResourcePreview.type,
+  updateResourceOptions.type,
+  markResourcesSubmitted.type,
+  clearSubmittedResources.type,
+  clearAllResources.type,
+  removeInstanceResources.type
+]);
+function storage() {
+  try {
+    return typeof window === "undefined" ? null : window.localStorage;
+  } catch {
+    return null;
+  }
+}
+function renderedArtifactDraftConversation(action) {
+  if (typeof action !== "object" || action === null) return null;
+  const { type, payload } = action;
+  if (typeof type !== "string" || !RESOURCE_ACTIONS.has(type)) return null;
+  if (typeof payload === "string") return payload;
+  if (payload && typeof payload === "object" && typeof payload.conversationId === "string") {
+    return payload.conversationId;
+  }
+  return null;
+}
+const restoreAttempted = /* @__PURE__ */ new Set();
+function persistRenderedArtifactChips(state, conversationId, owner) {
+  const store = storage();
+  if (!store || !restoreAttempted.has(conversationId)) return;
+  const submitted = new Set(state.instanceResources.submittedIds?.[conversationId] ?? []);
+  const chips = Object.values(state.instanceResources.byConversationId[conversationId] ?? {}).filter((r) => r.blockType === RENDERED_ARTIFACT_BLOCK_TYPE && !submitted.has(r.resourceId) && r.status !== "error").map((r) => ({
+    resourceId: r.resourceId,
+    source: r.source,
+    options: { ...r.options ?? {} },
+    preview: typeof r.preview === "string" ? r.preview : null
+  }));
+  try {
+    if (chips.length === 0) store.removeItem(KEY_PREFIX + conversationId);
+    else store.setItem(KEY_PREFIX + conversationId, JSON.stringify({ owner, at: Date.now(), chips }));
+  } catch {
+  }
+}
+function restoreRenderedArtifactChips(dispatch, getState, conversationId, owner) {
+  restoreAttempted.add(conversationId);
+  const store = storage();
+  if (!store) return 0;
+  let record = null;
+  try {
+    const raw = store.getItem(KEY_PREFIX + conversationId);
+    record = raw ? JSON.parse(raw) : null;
+  } catch {
+    record = null;
+  }
+  if (!record || !Array.isArray(record.chips)) return 0;
+  if (Date.now() - record.at > TTL_MS || (record.owner ?? null) !== (owner ?? null)) {
+    store.removeItem(KEY_PREFIX + conversationId);
+    return 0;
+  }
+  const present = getState().instanceResources.byConversationId[conversationId] ?? {};
+  let restored = 0;
+  for (const chip of record.chips) {
+    if (present[chip.resourceId]) continue;
+    dispatch(
+      addResource({
+        conversationId,
+        blockType: RENDERED_ARTIFACT_BLOCK_TYPE,
+        resourceId: chip.resourceId,
+        source: chip.source,
+        options: chip.options
+      })
+    );
+    if (chip.preview) dispatch(setResourcePreview({ conversationId, resourceId: chip.resourceId, preview: chip.preview }));
+    restored += 1;
+  }
+  return restored;
+}
+function __resetRenderedArtifactDraftForTest() {
+  restoreAttempted.clear();
+}
+export {
+  __resetRenderedArtifactDraftForTest,
+  persistRenderedArtifactChips,
+  renderedArtifactDraftConversation,
+  restoreRenderedArtifactChips
+};

package/dist/agents/redux/execution-system/instance-user-input/composer-draft.middleware.js

@@ -14,6 +14,10 @@ import {
 } from "./composer-draft-store.js";
 import { selectRestoreUnsentDrafts } from "../../../../host/prefs.js";
 import { selectUserId } from "../../../../host/identity.js";
+import {
+  persistRenderedArtifactChips,
+  renderedArtifactDraftConversation
+} from "../instance-resources/rendered-artifact-draft.js";
 const WRITE_DEBOUNCE_MS = 400;
 const timers = /* @__PURE__ */ new Map();
 const pending = /* @__PURE__ */ new Map();
@@ -91,6 +95,11 @@ const composerDraftMiddleware = (api) => (next) => (action) => {
     return next(action);
   }
   const result = next(action);
+  const chipConversation = renderedArtifactDraftConversation(action);
+  if (chipConversation) {
+    persistRenderedArtifactChips(api.getState(), chipConversation, selectUserId(api.getState()));
+    return result;
+  }
   if (type === setUserInputText.type) {
     const { conversationId, text } = action.payload;
     scheduleWrite(conversationId, text, selectUserId(api.getState()));

package/dist/agents/redux/execution-system/instance-user-input/useComposerDraftRestore.js

@@ -1,4 +1,5 @@
 "use client";
+import { restoreRenderedArtifactChips } from "../instance-resources/rendered-artifact-draft.js";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useAppDispatch, useAppSelector, useAppStore } from "../../../../store/hooks.js";
 import {
@@ -50,12 +51,13 @@ function useComposerDraftRestore(conversationId, alias) {
     setStorageAvailable(isComposerDraftStorageAvailable());
     if (!enabled) return;
     if (chatHostHasDatabase()) restoreComposerRemarks(conversationId);
+    restoreRenderedArtifactChips(dispatch, store.getState, conversationId, ownerId ?? null);
     const token = peekComposerDraft(conversationId, liveAlias, ownerId);
     if (!token) return;
     if (dispatch(applyComposerDraft(token)) === "restored") {
       setRestoredValue(token.value);
     }
-  }, [conversationId, liveAlias, dispatch, enabled, entryReady, ownerId]);
+  }, [conversationId, liveAlias, dispatch, store, enabled, entryReady, ownerId]);
   useEffect(() => {
     if (restoredValue !== null && text !== restoredValue) setRestoredValue(null);
   }, [text, restoredValue]);

package/dist/agents/redux/execution-system/thunks/execute-instance.thunk.js

@@ -617,7 +617,7 @@ const executeInstance = createAsyncThunk(
           }
         })
       );
-      const submitAt = performance.now();
+      const submitAt = submission?.capturedAt ?? performance.now();
       const RUN_IN_FLIGHT_RETRY_MS = 750;
       const RUN_IN_FLIGHT_DEADLINE = Date.now() + 12e4;
       for (; ; ) {

package/dist/agents/redux/execution-system/thunks/execute-manual-instance.thunk.js

@@ -560,7 +560,7 @@ const executeManualInstance = createAsyncThunk(
         requestId,
         sandboxAttached: payload.sandbox != null || payload.client?.state?.["sandbox-fs"] != null
       });
-      const submitAt = performance.now();
+      const submitAt = submission.capturedAt ?? performance.now();
       const abortController = new AbortController();
       registerAbortController(conversationId, abortController);
       try {

package/dist/agents/redux/execution-system/thunks/frozen-submission.d.ts

@@ -31,6 +31,11 @@ export interface FrozenSubmission {
     editorResourceXml: string;
     /** The variable values the person had when they pressed send. */
     userValues: Record<string, unknown>;
+    /**
+     * `performance.now()` at the keypress — t=0 for every client timing (prep, TTFT). Absent
+     * on a submission built after the fact (a resend); the send then stamps its own.
+     */
+    capturedAt?: number;
 }
 export declare function captureSubmission(state: ChatRootState, conversationId: string): FrozenSubmission;
 /** True when the submission carries nothing a person sent. */

package/dist/agents/redux/execution-system/thunks/frozen-submission.js

@@ -15,7 +15,8 @@ function captureSubmission(state, conversationId) {
     editorResourceXml: selectEditorResourceXml(conversationId)(state) ?? "",
     userValues: {
       ...state.instanceVariableValues?.byConversationId[conversationId]?.userValues ?? {}
-    }
+    },
+    capturedAt: performance.now()
   };
 }
 function isEmptySubmission(submission) {

package/dist/agents/redux/execution-system/utils/content-prefilter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Content Pre-Filter — Fast-reject layers for splitContentIntoBlocksV2
+ *
+ * Designed to run BEFORE any regex, JSON parsing, or XML extraction.
+ * Returns a set of candidate categories for a given line so the main
+ * parser can skip entire detection branches.
+ *
+ * Layer 0: Single-character scan (nanoseconds)
+ * Layer 1: Cheap secondary validation (tens of nanoseconds)
+ *
+ * If no candidates are found → the line is guaranteed to be plain text.
+ */
+/**
+ * Bit flags — a line can be a candidate for multiple categories simultaneously.
+ * Using bits so the main parser can do `if (candidates & Candidate.CODE)`.
+ */
+export declare const Candidate: {
+    readonly NONE: 0;
+    readonly TEXT: 0;
+    readonly CODE: number;
+    readonly XML_SIMPLE: number;
+    readonly XML_ATTR: number;
+    readonly TABLE: number;
+    readonly IMAGE: number;
+    readonly VIDEO: number;
+    readonly DIVIDER: number;
+    readonly TREE: number;
+    readonly BARE_JSON: number;
+    readonly AUDIO: number;
+    readonly MATRX_FILE: number;
+};
+export type CandidateFlags = number;
+/**
+ * Scans a line and returns a bitmask of candidate categories.
+ *
+ * This scans the FULL line (not just the start) to support inline blocks
+ * like "Hello <decision prompt="...">". The scan is still cheap because
+ * we only look at individual characters — no regex, no string splitting.
+ *
+ * @param line     The raw line (before trimming)
+ * @param trimmed  The normalized+trimmed line (caller already has this)
+ * @returns        Bitmask of Candidate flags
+ */
+export declare function classifyLine(line: string, trimmed: string): CandidateFlags;
+export declare function isPlainText(flags: CandidateFlags): boolean;
+/**
+ * Quick check for whether flags include a specific candidate.
+ * Usage: `if (hasCandidate(flags, Candidate.CODE)) { ... }`
+ */
+export declare function hasCandidate(flags: CandidateFlags, candidate: number): boolean;