@ai-matrx/chat 0.4.9 → 0.4.12

package/dist/utils/content-ir/surfaces/kind-image-alt.d.ts

@@ -1,27 +0,0 @@
-/**
- * A KIND AS AN IMAGE'S ALT TEXT (P9, round 4): `![{"__kind":…}](url)`. The
- * prose split lifted the object out and left `!` and `(url)` behind as two
- * stray prose blocks after reload (and live). The model meant the kind: the
- * image wrapper is chrome — `![` before the object and `](url)` after it are
- * dropped, the object stays where it was and renders as its kind. A kindless
- * object in alt text (first key decided not `__kind`) is left as written.
- *
- * ONE transform, both hosts (like `quoted-kind-lift.ts`): the live accumulator
- * pushes every delta through a `KindImageAltUnwrap`; the static splitter runs
- * `unwrapKindImageAlt` on the whole text. Character-driven and chunk-invariant.
- */
-export declare class KindImageAltUnwrap {
-    private mode;
-    /** Held: `!` / `![` (scan), the object so far (head), `](…` (tail). */
-    private held;
-    private depth;
-    private inString;
-    private escape;
-    push(text: string): string;
-    flush(): string;
-    /** Track JSON structure; returns true when the object just closed. */
-    private track;
-    private pushChar;
-}
-/** The whole-text form, for the static splitter (identical bytes to any streaming of `source`). */
-export declare function unwrapKindImageAlt(source: string): string;

package/dist/utils/content-ir/surfaces/kind-image-alt.js

@@ -1,117 +0,0 @@
-import { jsonKindSignal } from "./json-kind-signal.js";
-const HEAD_LIMIT = 2e3;
-class KindImageAltUnwrap {
-  mode = "scan";
-  /** Held: `!` / `![` (scan), the object so far (head), `](…` (tail). */
-  held = "";
-  depth = 0;
-  inString = false;
-  escape = false;
-  push(text) {
-    let out = "";
-    for (const ch of text) out += this.pushChar(ch);
-    return out;
-  }
-  flush() {
-    const out = this.mode === "head" ? `![${this.held}` : this.held;
-    this.mode = "scan";
-    this.held = "";
-    this.depth = 0;
-    this.inString = false;
-    this.escape = false;
-    return out;
-  }
-  /** Track JSON structure; returns true when the object just closed. */
-  track(ch) {
-    if (this.escape) {
-      this.escape = false;
-      return false;
-    }
-    if (this.inString) {
-      if (ch === "\\") this.escape = true;
-      else if (ch === '"') this.inString = false;
-      return false;
-    }
-    if (ch === '"') this.inString = true;
-    else if (ch === "{" || ch === "[") this.depth += 1;
-    else if (ch === "}" || ch === "]") {
-      this.depth -= 1;
-      return this.depth === 0;
-    }
-    return false;
-  }
-  pushChar(ch) {
-    switch (this.mode) {
-      case "scan": {
-        if (this.held === "" && ch === "!") {
-          this.held = "!";
-          return "";
-        }
-        if (this.held === "!" && ch === "[") {
-          this.held = "![";
-          return "";
-        }
-        if (this.held === "![" && ch === "{") {
-          this.mode = "head";
-          this.held = "{";
-          this.depth = 1;
-          this.inString = false;
-          this.escape = false;
-          return "";
-        }
-        if (this.held === "") return ch;
-        const out = this.held;
-        this.held = "";
-        return out + this.pushChar(ch);
-      }
-      case "head": {
-        this.held += ch;
-        const closed = this.track(ch);
-        const signal = jsonKindSignal(this.held);
-        if (signal === "kind") {
-          const out = this.held;
-          this.held = "";
-          if (closed) {
-            this.mode = "tail";
-            return out;
-          }
-          this.mode = "body";
-          return out;
-        }
-        if (signal === "not_kind" || closed || this.held.length > HEAD_LIMIT) {
-          const out = `![${this.held}`;
-          this.held = "";
-          this.mode = "scan";
-          return out;
-        }
-        return "";
-      }
-      case "body": {
-        if (this.track(ch)) this.mode = "tail";
-        return ch;
-      }
-      case "tail": {
-        this.held += ch;
-        if (/^\]\([^)\n]*\)$/.test(this.held)) {
-          this.held = "";
-          this.mode = "scan";
-          return "";
-        }
-        if (/^\](?:\([^)\n]*)?$/.test(this.held)) return "";
-        const out = this.held;
-        this.held = "";
-        this.mode = "scan";
-        return out;
-      }
-    }
-  }
-}
-function unwrapKindImageAlt(source) {
-  if (!source.includes("![{")) return source;
-  const transform = new KindImageAltUnwrap();
-  return transform.push(source) + transform.flush();
-}
-export {
-  KindImageAltUnwrap,
-  unwrapKindImageAlt
-};

package/dist/utils/content-ir/surfaces/kind-one-line.d.ts

@@ -1,67 +0,0 @@
-/**
- * THE ONE-LINE FORM of a kind — what an INLINE surface shows where a kind
- * region sits in its text (P6, round 4): a collapsed card preview, a
- * notification body, an extraction cell, a table cell. An inline/preview level
- * cannot mount a kind component, so a kind reads as its instance title and
- * kind name (`**Cells** · Flashcard Set`), an unfinished one as its kind name
- * alone, and an unreadable one as "Structured output". Never the JSON.
- *
- * LIGHT on purpose — the inline level must not pull the kind registry or the
- * block pipeline: the region finder (`embedded-kind-json.ts`), the detector
- * and the title derivation (`studio/instance-title.ts`) only.
- */
-/**
- * One line for a kind VALUE: `**Title** · Kind Name`, or the kind name alone.
- * `plain` drops the markdown emphasis (`Title · Kind Name`) for slots that
- * draw text as written — a tooltip, a `title` attribute, a clamped caption.
- */
-export declare function kindOneLine(value: unknown, options?: {
-    plain?: boolean;
-}): string;
-/**
- * The text with every kind region (complete, unfinished or unreadable) in
- * prose replaced by its one-line form. Quoted source (inline code, non-JSON
- * fences) stays as written. Text with no kind key comes back unchanged.
- */
-export declare function inlineKindText(raw: string, options?: {
-    plain?: boolean;
-}): string;
-/**
- * A complete JSON kind region whose `__kind` cannot name a kind (`{"__kind":
- * ["x"], …}`, `{"__kind": 5}`) → the one-line unreadable note, the words the
- * export writes (`UNREADABLE_KIND_NOTE`), instead of raw JSON (round 11, L2).
- */
-export declare function unreadableKindsAsNote(text: string): string;
-/**
- * CATALOG PROSE as a person reads it (ruling (a), round 6): a skill / agent /
- * tool description that shows an example kind JSON (`emit a
- * {"__kind": "math_problem"} block`) is documentation — the example reads as
- * its kind's one-line label, never the JSON. Plain text out, for text AND
- * attribute slots (`title`, tooltips). Display transform only: the stored
- * description is never rewritten.
- */
-export declare function catalogProseText(text: string | null | undefined): string;
-/**
- * THE PROSE LEAF's kind reading (round 10 boundary): a REAL JSON kind region
- * the pipeline cannot lift — a settled object whose grammar BROKE in prose
- * (`{"__kind":"note","title":"Hi" and then…`), or a markdown-escaped key
- * (`"\_\_kind"`) — reads as its one-line label, then every character after
- * its cut as written. A complete literal kind is the pipeline's (lifted).
- * Every NON-JSON spelling (`{\"__kind\":…}` in prose, repr, a JS literal,
- * typographic quotes, entities) is left EXACTLY as written — detection only.
- * Called by the one prose leaf live and reloaded text both pass through, so
- * live ≡ reload. One linear pass, memoized per text; text with no such region
- * comes back as the same string.
- */
-export declare function spelledKindsAsOneLine(text: string): string;
-/**
- * Round 10, detection-only spellings drawn EXACTLY as written: a non-JSON
- * kind spelling in prose (`{\"__kind\":…}`, repr, a JS literal, typographic
- * quotes, entities) becomes an inline code span, so markdown neither eats its
- * backslashes nor decodes its entities — the screen shows the source byte for
- * byte, as quoted source. Nothing outside a region changes; text with no such
- * region comes back as the same string. One linear pass, memoized per text.
- * (A markdown-escaping pass did the same job and hung the renderer on nested
- * escapes — never reintroduce it.)
- */
-export declare function nonJsonKindsAsCode(text: string): string;

package/dist/utils/content-ir/surfaces/kind-one-line.js

@@ -1,209 +0,0 @@
-import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
-import { deriveInstanceTitle } from "../instance-title.js";
-import { UNREADABLE_KIND_NOTE } from "./kind-text-to-markdown.js";
-import {
-  findBrokenKindJsonRegions,
-  findEmbeddedKindJsonRegions
-} from "./embedded-kind-json.js";
-import {
-  closedJson,
-  firstKindSlug,
-  hasKindKey,
-  kindGrammar,
-  mayHoldKindKey,
-  hasJsonKindKey,
-  normalizeKindSpellings,
-  quotedSourceRanges,
-  regionJson,
-  scanKindSpellingRegions
-} from "./json-kind-signal.js";
-const UNNAMED = "Structured output";
-function kindName(slug) {
-  return slug && humanizeIdentifier(slug) || UNNAMED;
-}
-function kindOneLine(value, options = {}) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return UNNAMED;
-  const record = value;
-  const slug = typeof record.__kind === "string" ? record.__kind : null;
-  const title = deriveInstanceTitle(record);
-  const name = kindName(slug);
-  if (!(title && title !== name)) return name;
-  const clean = title.replace(/[*_`[\]]/g, "");
-  return options.plain ? `${clean} \xB7 ${name}` : `**${clean}** \xB7 ${name}`;
-}
-function inside(ranges, at) {
-  return ranges.some(([start, end]) => at >= start && at < end);
-}
-function inlineKindText(raw, options = {}) {
-  const source = raw ? normalizeKindSpellings(raw) : raw;
-  if (!source || !hasKindKey(source)) return source;
-  const spans = [];
-  for (const region of findEmbeddedKindJsonRegions(source, { excludeQuotedSource: true })) {
-    let value = null;
-    try {
-      value = JSON.parse(region.content);
-    } catch {
-      value = { __kind: region.kind };
-    }
-    spans.push({ start: region.start, end: region.end, line: kindOneLine(value, options) });
-  }
-  const quoted = quotedSourceRanges(source);
-  for (const region of findBrokenKindJsonRegions(source)) {
-    if (inside(quoted, region.start)) continue;
-    spans.push({ start: region.start, end: region.end, line: kindName(firstKindSlug(region.content)) });
-  }
-  spans.sort((a, b) => a.start - b.start);
-  let out = "";
-  let cursor = 0;
-  for (const span of spans) {
-    if (span.start < cursor) continue;
-    out += source.slice(cursor, span.start) + span.line;
-    cursor = span.end;
-  }
-  out += source.slice(cursor);
-  if (hasKindKey(out)) {
-    const key = out.search(/(?<!\\)"(?:__kind|\\u005[fF]_kind)"\s*:/);
-    const brace = key >= 0 ? out.lastIndexOf("{", key) : -1;
-    if (brace >= 0 && !inside(quotedSourceRanges(out), brace)) {
-      const verdict = kindGrammar(out, "json", brace);
-      const end = verdict.status === "prefix" ? out.length : verdict.status === "broken" && verdict.at > key ? verdict.cut : -1;
-      if (end > key) out = out.slice(0, brace) + kindName(firstKindSlug(out.slice(key, end))) + out.slice(end);
-    }
-  }
-  return unreadableKindsAsNote(out);
-}
-function holdsUnreadableKind(json) {
-  let value;
-  try {
-    value = JSON.parse(json);
-  } catch {
-    return false;
-  }
-  if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
-  if (!Object.prototype.hasOwnProperty.call(value, "__kind")) return false;
-  const kind = value.__kind;
-  if (typeof kind === "string") return false;
-  return !(typeof kind === "object" && kind !== null && !Array.isArray(kind));
-}
-function unreadableKindsAsNote(text) {
-  if (!text || !mayHoldKindKey(text) || !hasJsonKindKey(text)) return text;
-  let out = "";
-  let cursor = 0;
-  for (const region of scanKindSpellingRegions(text)) {
-    if (region.status !== "complete") continue;
-    const json = regionJson(region);
-    if (json === null || !holdsUnreadableKind(json)) continue;
-    out += text.slice(cursor, region.start) + UNREADABLE_KIND_NOTE;
-    cursor = region.end;
-  }
-  return cursor === 0 ? text : out + text.slice(cursor);
-}
-function catalogProseText(text) {
-  if (!text) return "";
-  return inlineKindText(text, { plain: true });
-}
-function regionOneLine(region) {
-  const json = region.status === "complete" ? regionJson(region) : region.status === "broken" ? closedJson(region) : null;
-  if (json !== null) {
-    try {
-      const value = JSON.parse(json);
-      if (value !== null && typeof value === "object" && !Array.isArray(value)) return kindOneLine(value);
-    } catch {
-    }
-  }
-  return kindName(firstKindSlug(json ?? region.decoded));
-}
-const ONE_LINE_CACHE = /* @__PURE__ */ new Map();
-const ONE_LINE_CACHE_SIZE = 16;
-function spelledKindsAsOneLine(text) {
-  if (!text || !mayHoldKindKey(text)) return text;
-  const cached = ONE_LINE_CACHE.get(text);
-  if (cached !== void 0) return cached;
-  const out = computeSpelledKindsAsOneLine(text);
-  if (ONE_LINE_CACHE.size >= ONE_LINE_CACHE_SIZE) ONE_LINE_CACHE.delete(ONE_LINE_CACHE.keys().next().value);
-  ONE_LINE_CACHE.set(text, out);
-  return out;
-}
-function computeSpelledKindsAsOneLine(text) {
-  let out = "";
-  let cursor = 0;
-  for (const region of scanKindSpellingRegions(text)) {
-    if (region.family === "lifted" && !region.markdown && region.status !== "broken") {
-      const json = region.status === "complete" ? regionJson(region) : null;
-      if (json === null || !holdsUnreadableKind(json)) continue;
-      out += text.slice(cursor, region.start) + UNREADABLE_KIND_NOTE;
-      cursor = region.end;
-      continue;
-    }
-    out += text.slice(cursor, region.start) + regionOneLine(region);
-    cursor = region.end;
-  }
-  return cursor === 0 ? text : out + text.slice(cursor);
-}
-const AS_CODE_CACHE = /* @__PURE__ */ new Map();
-function nonJsonKindsAsCode(text) {
-  if (!text || !mayHoldKindKey(text)) return text;
-  const cached = AS_CODE_CACHE.get(text);
-  if (cached !== void 0) return cached;
-  let out = "";
-  let cursor = 0;
-  let paragraphs = null;
-  let p = 0;
-  for (const region of scanKindSpellingRegions(text, { families: "all" })) {
-    if (region.family === "lifted" || region.family === "markdown") continue;
-    paragraphs ??= codeSpanParagraphs(text);
-    while (p < paragraphs.length - 1 && paragraphs[p].end <= region.start) p++;
-    const fence = safeCodeSpanFence(text, region.start, region.end, paragraphs[p]);
-    if (fence === null) continue;
-    out += text.slice(cursor, region.start) + fence + text.slice(region.start, region.end) + fence;
-    cursor = region.end;
-  }
-  const result = cursor === 0 ? text : out + text.slice(cursor);
-  if (AS_CODE_CACHE.size >= ONE_LINE_CACHE_SIZE) AS_CODE_CACHE.delete(AS_CODE_CACHE.keys().next().value);
-  AS_CODE_CACHE.set(text, result);
-  return result;
-}
-const HTML_TAG = /^ {0,3}<\/?[A-Za-z][A-Za-z0-9-]*(?:[\s/>]|$)/m;
-const TABLE_ROW = /^[ \t]*\|/m;
-function codeSpanParagraphs(text) {
-  const out = [];
-  const blank = /\n[ \t]*\n/g;
-  let start = 0;
-  for (; ; ) {
-    const m = blank.exec(text);
-    const end = m ? m.index + 1 : text.length;
-    const body = text.slice(start, end);
-    const runs = /* @__PURE__ */ new Set();
-    for (let i = 0; i < body.length; ) {
-      if (body[i] !== "`") {
-        i++;
-        continue;
-      }
-      let n = 0;
-      while (body[i + n] === "`") n++;
-      runs.add(n);
-      i += n;
-    }
-    out.push({ start, end, html: HTML_TAG.test(body), table: TABLE_ROW.test(body), runs });
-    if (!m) break;
-    start = m.index + m[0].length - 1;
-  }
-  return out;
-}
-function safeCodeSpanFence(text, start, end, paragraph) {
-  const source = text.slice(start, end);
-  if (/\n[ \t]*\n/.test(source) || source.includes("`")) return null;
-  if (paragraph.html || paragraph.table && source.includes("|")) return null;
-  if (text[start - 1] === "`" || text[end] === "`") return null;
-  let ticks = 1;
-  while (paragraph.runs.has(ticks)) ticks++;
-  return "`".repeat(ticks);
-}
-export {
-  catalogProseText,
-  inlineKindText,
-  kindOneLine,
-  nonJsonKindsAsCode,
-  spelledKindsAsOneLine,
-  unreadableKindsAsNote
-};

package/dist/utils/content-ir/surfaces/kind-text-label.d.ts

@@ -1,20 +0,0 @@
-/**
- * Answer TEXT → ONE readable line, for a person's compact label (a card
- * subtitle, a rule name, a link-preview description, a list row). A kind is
- * never shown as raw JSON (Arman, 2026-09-30): a kind answer reads as
- * "<Kind> · <instance title>" (`deriveInstanceTitle`, the derivation saved
- * instances use); prose with a kind in it reads as the prose's first line;
- * a kind that never completed reads as its one-line broken note.
- * Kindless text is whitespace-collapsed and clipped, nothing else.
- *
- * Destination transform only — never call it on stored or machine-bound text.
- */
-/** One line, at most `max` characters, never containing a `__kind` key. */
-export declare function kindTextLabel(raw: string | null | undefined, max?: number): string;
-/**
- * A conversation TITLE as a person reads it (R4, round 6): a title that holds
- * kind JSON reads as its one-line kind label; any other title — and null —
- * comes back as it is. Read boundaries and title renderers call this; the
- * stored title is never rewritten.
- */
-export declare function conversationTitleText(title: string | null | undefined): string | null;

package/dist/utils/content-ir/surfaces/kind-text-label.js

@@ -1,50 +0,0 @@
-import { humanizeKind } from "../kinds/kind-markdown-utils.js";
-import { deriveInstanceTitle } from "../instance-title.js";
-import { firstKindSlug, hasJsonKindKey, hasKindKey, normalizeKindSpellings } from "./json-kind-signal.js";
-import { kindTextToMarkdown } from "./kind-text-to-markdown.js";
-function clip(text, max) {
-  return text.length > max ? `${text.slice(0, Math.max(0, max - 1)).trimEnd()}\u2026` : text;
-}
-function wholeKindLabel(text) {
-  let body = text.trim();
-  const fence = body.match(/^(?:`{3,}|~{3,})[a-zA-Z0-9]*\s*\n([\s\S]*?)\n?(?:`{3,}|~{3,})$/);
-  if (fence) body = fence[1].trim();
-  if (!body.startsWith("{")) return null;
-  try {
-    const parsed = JSON.parse(body);
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
-    const record = parsed;
-    if (typeof record.__kind !== "string" || !record.__kind.trim()) return null;
-    const name = humanizeKind(record.__kind.trim());
-    const title = deriveInstanceTitle(record);
-    return title ? `${name} \xB7 ${title}` : name;
-  } catch {
-    return null;
-  }
-}
-function firstReadableLine(markdown) {
-  for (const raw of markdown.split("\n")) {
-    const line = raw.replace(/^\s*(?:#{1,6}\s+|>\s*|[-*+]\s+|\d+[.)]\s+)/, "").replace(/<\/?[A-Za-z][\w:-]*(\s[^<>]*)?\/?>/g, "").replace(/[*_`]+/g, "").replace(/\s+/g, " ").trim();
-    if (line) return line;
-  }
-  return "";
-}
-function kindTextLabel(raw, max = 90) {
-  if (!raw) return "";
-  const text = normalizeKindSpellings(raw);
-  if (!hasKindKey(text)) return clip(text.replace(/\s+/g, " ").trim(), max);
-  const whole = wholeKindLabel(text);
-  if (whole) return clip(whole, max);
-  const line = firstReadableLine(kindTextToMarkdown(text));
-  if (line) return clip(line, max);
-  const slug = firstKindSlug(text);
-  return clip(slug ? humanizeKind(slug) : "Structured output", max);
-}
-function conversationTitleText(title) {
-  if (title == null) return null;
-  return hasJsonKindKey(title) ? kindTextLabel(title, 200) : title;
-}
-export {
-  conversationTitleText,
-  kindTextLabel
-};

package/dist/utils/content-ir/surfaces/kind-text-to-markdown.d.ts

@@ -1,47 +0,0 @@
-/**
- * Answer TEXT → the readable markdown a person meant, for DISPLAY and EXPORT
- * destinations only (a note, a task, a file, a print, a clipboard copy, the
- * speaker, a plain-text slot). Rule (Arman, 2026-09-30): a kind is never shown
- * as raw JSON — every `{"__kind":…}` region in the text (bare, or the whole
- * body of a ```json / unlabelled fence) becomes that kind's markdown through
- * the ONE kind → markdown converter (`kindValueToMarkdown`: the registry's
- * `toMarkdown` facet, else `genericKindMarkdown`).
- *
- * 🚨 Never call this on data that is STORED or PASSED to a machine: `__kind`
- * is part of the data. This is a destination transform, the same as
- * `unwrapKindEnvelopes`. Kindless text returns byte for byte.
- *
- * Regions come from the one embedded-kind region finder
- * (`findEmbeddedKindJsonRegions`); the signal is the one detector
- * (`hasKindKey`). Nobody writes a second one.
- */
-/**
- * The one-line broken state of a kind that never completed (≤60 chars) — the
- * SAME words the compact preview shows (`AnswerTextPreview`), so an export of
- * a cut-off answer says what the screen said.
- */
-export declare function unfinishedKindLabel(kind: string | null): string;
-/** The one-line note for structured output whose `__kind` cannot name a kind. */
-export declare const UNREADABLE_KIND_NOTE = "Structured output could not be read";
-/**
- * The export transform. Kindless text returns byte for byte; every kind
- * region becomes readable markdown, and a kind that can never complete (cut
- * off, malformed) becomes its one-line "<Kind> did not finish" note — never
- * the fragment.
- */
-export declare function kindTextToMarkdown(raw: string | null | undefined): string;
-export interface KindTextPreview {
-    /** The readable text: complete kinds as markdown, an arriving kind cut off. */
-    text: string;
-    /** The slug of a kind still arriving at the end of the text (its loader), else null. */
-    pendingKind: string | null;
-    /** True when a kind is arriving but its slug has not been read yet. */
-    pendingUnnamed: boolean;
-}
-/**
- * A COMPACT, possibly still-streaming preview of answer text (a toast, a
- * hover card, a list row): complete kinds read as their markdown; a kind
- * still arriving is cut from the text and named in `pendingKind` so the
- * caller shows that kind's loader — the raw JSON never shows mid-stream.
- */
-export declare function kindTextPreview(raw: string | null | undefined): KindTextPreview;