@aparte/core 0.15.0 → 0.16.0

package/dist/{is-awaiting-reply-BZ_iJ3s3.js → dialog-triggers-CVCxqKg3.js}

@@ -1,5 +1,5 @@
-import { A as APARTE_ICON_GLYPHS } from "./glyphs-B3BZ2TIb.js";
-import { deriveArtifactKind, runStreamAgent } from "@aparte/engine";
+import { A as APARTE_ICON_GLYPHS } from "./glyphs-DQTeOj4w.js";
+import { runStreamAgent } from "@aparte/engine";
 function contentToText(content) {
   if (typeof content === "string") return content;
   return content.filter((p) => p.type === "text").map((p) => p.text).join("");
@@ -90,7 +90,7 @@ const APARTE_DEFAULT_LOCALE = {
   elicitationOtherLabel: "Custom answer",
   submitButton: "Submit",
   stopButton: "Stop",
-  elicitationNext: "Next",
+  elicitationRecommended: "Recommended",
   elicitationSkip: "Skip",
   elicitationYes: "Yes",
   elicitationNo: "No",
@@ -106,10 +106,15 @@ const APARTE_DEFAULT_LOCALE = {
   toolCompleted: "Done",
   toolRejected: "Rejected",
   toolStopped: "Stopped",
+  toolFailed: "Failed",
   toolInput: "Input",
   toolOutput: "Output",
   approvalOptionsLabel: "Your decision",
+  approvalArgsLabel: "Arguments",
   actionUpload: "Attach file",
+  removeAttachment: "Remove {name}",
+  selectSearchPlaceholder: "Search…",
+  selectSearchLabel: "Search options",
   download: "Download",
   previewPending: "Press Preview to run this artifact.",
   sandboxError: "The sandbox failed during generation.",
@@ -124,6 +129,7 @@ const APARTE_DEFAULT_LOCALE = {
   run: "Run",
   file: "File",
   modelSelectorPlaceholder: "Select a model...",
+  approvalModeLabel: "Approval mode",
   roleNameUser: "You",
   roleNameAssistant: "Assistant",
   yourMessage: "Your message",
@@ -138,12 +144,27 @@ const APARTE_DEFAULT_LOCALE = {
   nextResponse: "Next response",
   approveTool: "Approve",
   rejectTool: "Reject",
-  tokensPerSecondLabel: "tok/s",
   messageInfo: "Details",
   newChat: "New Chat",
-  deleteConversation: "Delete conversation",
-  archiveConversation: "Archive conversation",
-  unarchiveConversation: "Unarchive conversation",
+  deleteConversation: "Delete",
+  archiveConversation: "Archive",
+  unarchiveConversation: "Unarchive",
+  conversationActions: "Conversation actions",
+  renameConversation: "Rename",
+  conversationTitle: "Conversation title",
+  pinConversation: "Pin",
+  unpinConversation: "Unpin",
+  deleteConversationConfirm: "Delete “{title}”?",
+  cancel: "Cancel",
+  conversationGroupPinned: "Pinned",
+  conversationGroupToday: "Today",
+  conversationGroupYesterday: "Yesterday",
+  conversationGroupWeek: "Previous 7 days",
+  conversationGroupMonth: "Previous 30 days",
+  scrollRailLabel: "Conversation outline",
+  sidebarLabel: "Conversations",
+  splitHandleLabel: "Resize the panes",
+  transcript: "Transcript",
   direction: "ltr"
 };
 function isFormatAdapter(p) {
@@ -237,10 +258,21 @@ class AparteStreamParser {
   _options;
   /** Normalized to an array; the parser matches whichever pair opens first. */
   _thinkingDelimiters;
+  /** The registered block grammars, in registration order. */
+  _blocks;
   _state;
+  /**
+   * A block already BUILT and waiting for its turn to be emitted — a self-closing
+   * tag that followed prose, whose text run has to go out first. One segment per
+   * step, but `toSegment` is still called exactly once, as `AparteStreamBlock`
+   * documents: re-reading the tag on the next step called a consumer's grammar
+   * twice for one tag.
+   */
+  _pendingSegment = null;
   constructor(options = {}) {
     const delims = options.thinkingDelimiters;
     this._thinkingDelimiters = delims ? Array.isArray(delims) ? delims : [delims] : DEFAULT_THINKING_DELIMITERS;
+    this._blocks = options.blocks ?? [];
     this._options = {
       autoGenerateIds: options.autoGenerateIds ?? true,
       idPrefix: options.idPrefix ?? "seg"
@@ -257,7 +289,7 @@ class AparteStreamParser {
   parse(chunk) {
     this._state.buffer += chunk;
     const completedSegments = [];
-    while (this._state.buffer.length > 0) {
+    while (this._state.buffer.length > 0 || this._pendingSegment) {
       const parsed = this._parseNext();
       if (!parsed) {
         break;
@@ -288,11 +320,14 @@ class AparteStreamParser {
       }
       finalSegments.push(this._closed(this._state.activeSegment));
       this._state.activeSegment = null;
-      this._state.buffer = "";
     } else if (this._state.buffer.trim()) {
       finalSegments.push(this._closed(this._createTextSegment(stripTrailingFence(this._state.buffer))));
-      this._state.buffer = "";
     }
+    this._state.mode = "text";
+    this._state.buffer = "";
+    this._state.codeLanguage = void 0;
+    this._state.thinkingEnd = void 0;
+    this._state.blockEnd = void 0;
     return finalSegments;
   }
   /**
@@ -300,6 +335,7 @@ class AparteStreamParser {
    */
   reset() {
     this._state = this._createInitialState();
+    this._pendingSegment = null;
   }
   /**
    * Get current parser state (for debugging/inspection)
@@ -311,6 +347,11 @@ class AparteStreamParser {
   // Private Parsing Logic
   // ─────────────────────────────────────────────────────────────────────────
   _parseNext() {
+    if (this._pendingSegment) {
+      const segment = this._pendingSegment;
+      this._pendingSegment = null;
+      return { segment, remaining: this._state.buffer };
+    }
     const buffer = this._state.buffer;
     switch (this._state.mode) {
       case "text":
@@ -319,8 +360,8 @@ class AparteStreamParser {
         return this._parseCodeMode(buffer);
       case "thinking":
         return this._parseThinkingMode(buffer);
-      case "artifact":
-        return this._parseArtifactMode(buffer);
+      case "block":
+        return this._parseBlockMode(buffer);
       default:
         return null;
     }
@@ -332,14 +373,23 @@ class AparteStreamParser {
       const i = buffer.indexOf(p.start);
       if (i !== -1 && (thinkingStart === -1 || i < thinkingStart)) thinkingStart = i;
     }
-    const artifactStart = buffer.indexOf("<artifact");
+    let blockStart = -1;
+    let blockHit;
+    for (const b of this._blocks) {
+      const i = this._indexOfTag(buffer, b.tag);
+      if (i !== -1 && (blockStart === -1 || i < blockStart)) {
+        blockStart = i;
+        blockHit = b;
+      }
+    }
     const patterns = [];
     if (codeBlockStart !== -1) patterns.push({ type: "code", index: codeBlockStart });
     if (thinkingStart !== -1) patterns.push({ type: "thinking", index: thinkingStart });
-    if (artifactStart !== -1) patterns.push({ type: "artifact", index: artifactStart });
+    if (blockStart !== -1) patterns.push({ type: "block", index: blockStart });
     patterns.sort((a, b) => a.index - b.index);
     if (patterns.length === 0) {
-      if (buffer.endsWith("`") || buffer.endsWith("``") || this._thinkingDelimiters.some((p) => this._isPartialMatch(buffer, p.start)) || this._isPartialMatch(buffer, "<artifact")) {
+      if (buffer.endsWith("`") || buffer.endsWith("``") || this._thinkingDelimiters.some((p) => this._isPartialMatch(buffer, p.start)) || // `<ta`, and also the whole `<tag` with nothing after it yet.
+      this._blocks.some((b) => this._isPartialMatch(buffer, "<" + b.tag) || buffer.endsWith("<" + b.tag))) {
         return null;
       }
       if (!this._state.activeSegment || this._state.activeSegment.type !== "text") {
@@ -378,12 +428,16 @@ class AparteStreamParser {
       }
       return { segment: segmentToEmit, remaining: res.remaining };
     } else {
-      const res = this._startArtifactBlock(buffer);
+      const res = this._startBlock(buffer, blockHit);
       if (!res) {
         if (segmentToEmit) this._state.activeSegment = segmentToEmit;
         return null;
       }
-      return { segment: segmentToEmit, remaining: res.remaining };
+      if (res.segment && segmentToEmit) {
+        this._pendingSegment = res.segment;
+        return { segment: segmentToEmit, remaining: res.remaining };
+      }
+      return { segment: segmentToEmit ?? res.segment, remaining: res.remaining };
     }
   }
   _startCodeBlock(buffer) {
@@ -465,70 +519,123 @@ class AparteStreamParser {
     this._state.thinkingEnd = void 0;
     return { segment, remaining: buffer.slice(closeIndex + endDelim.length) };
   }
+  // ─── registered blocks ──────────────────────────────────────────────────
+  /**
+   * Where `<tag` opens a block in `buffer`, or -1. A hit needs the name to END
+   * there: `<artifacts>` is not `<artifact>`, so the character after the name must
+   * be whitespace, `/` or `>`. A `<tag` sitting at the very end of the buffer is
+   * undecidable and reported as -1 — the partial-match hold in `_parseTextMode`
+   * keeps it for the next chunk.
+   */
+  _indexOfTag(buffer, tag) {
+    const open = "<" + tag;
+    let from = 0;
+    for (; ; ) {
+      const i = buffer.indexOf(open, from);
+      if (i === -1) return -1;
+      const next = buffer[i + open.length];
+      if (next === void 0) return -1;
+      if (next === ">" || next === "/" || /\s/.test(next)) return i;
+      from = i + 1;
+    }
+  }
   /**
-   * Start an artifact block. Buffer must start with `<artifact`.
-   * The full opening tag must be present (`>`); otherwise we return null and wait
-   * for more chunks.
+   * Where the opening `<tag …>` ends, or -1 while it is still incomplete.
    *
-   * Supported attributes (Anthropic-style, single or double quotes):
-   *   - type   — required (MIME type, verbatim)
-   *   - title  — optional human label
+   * The first `>` is not the answer: `<note title="v1 -> v2">` carries one inside
+   * a quoted value, and cutting there loses every attribute AND leaks the rest of
+   * the tag into the body as raw markup. A quote only OPENS after an `=`, so a
+   * stray `"` written in an attribute-less tag cannot hold the buffer open.
    *
-   * Any other attributes are ignored gracefully.
+   * A quote the model never closes must not hold it open either. `-1` means
+   * "wait", and waiting on a value that runs to the end of the reply freezes the
+   * stream: nothing is emitted until `finalize()` flushes the whole tail as raw
+   * text. These tag conventions are single-line, so a newline reached inside an
+   * open value says the quote was a typo — and the tag is then read the way it
+   * has always been read, at its first `>`.
+   */
+  _tagEnd(buffer, tag) {
+    let quote = null;
+    let afterEquals = false;
+    let firstGt = -1;
+    for (let i = 1 + tag.length; i < buffer.length; i++) {
+      const c = buffer[i];
+      if (c === ">" && firstGt === -1) firstGt = i;
+      if (quote) {
+        if (c === quote) quote = null;
+        else if (c === "\n") return firstGt;
+        continue;
+      }
+      if (c === ">") return i;
+      if (c === "=") {
+        afterEquals = true;
+        continue;
+      }
+      if (afterEquals && (c === '"' || c === "'")) {
+        quote = c;
+        afterEquals = false;
+        continue;
+      }
+      if (!/\s/.test(c)) afterEquals = false;
+    }
+    return -1;
+  }
+  /**
+   * Open a registered block. The buffer starts with `<tag`; the whole opening tag
+   * must be present (its `>`) or we wait. Attributes are read as written —
+   * `a="x"`, `a='x'`, `a=x` — and a self-closing `<tag …/>` is a block with no
+   * body, returned closed at once.
    */
-  _startArtifactBlock(buffer) {
-    if (!buffer.startsWith("<artifact")) return null;
-    const tagEnd = buffer.indexOf(">");
+  _startBlock(buffer, block) {
+    const tagEnd = this._tagEnd(buffer, block.tag);
     if (tagEnd === -1) return null;
-    const tag = buffer.slice(0, tagEnd + 1);
-    const inner = tag.slice("<artifact".length, -1);
-    const mimeMatch = inner.match(/\bmimeType\s*=\s*(?:"([^"]*)"|'([^']*)')/i);
-    const typeMatch = inner.match(/\btype\s*=\s*(?:"([^"]*)"|'([^']*)')/i);
-    const titleMatch = inner.match(/\btitle\s*=\s*(?:"([^"]*)"|'([^']*)')/i);
-    const mimeType = (mimeMatch && (mimeMatch[1] ?? mimeMatch[2])) ?? (typeMatch && (typeMatch[1] ?? typeMatch[2])) ?? "text/plain";
-    const title = titleMatch ? titleMatch[1] ?? titleMatch[2] : void 0;
-    this._state.mode = "artifact";
-    this._state.activeSegment = this._createArtifactSegment(mimeType, title);
-    return { segment: null, remaining: buffer.slice(tagEnd + 1) };
-  }
-  /**
-   * Stream content into the active artifact segment until `</artifact>` is seen.
-   * Mirrors `_parseThinkingMode` so partial matches at chunk boundaries don't
-   * split the closing tag across two updates.
-   */
-  _parseArtifactMode(buffer) {
-    const endDelim = "</artifact>";
+    const inner = buffer.slice(1 + block.tag.length, tagEnd);
+    const selfClosing = inner.trimEnd().endsWith("/");
+    const attrSource = selfClosing ? inner.trimEnd().slice(0, -1) : inner;
+    const attrs = /* @__PURE__ */ Object.create(null);
+    for (const m of attrSource.matchAll(/([A-Za-z_][\w:-]*)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>]+))/g)) {
+      attrs[m[1]] = m[2] ?? m[3] ?? m[4] ?? "";
+    }
+    const segment = block.toSegment({ attrs, id: this._options.autoGenerateIds ? this._generateId() : "" });
+    segment.content = "";
+    const remaining = buffer.slice(tagEnd + 1);
+    if (selfClosing) return { segment: this._closed(segment), remaining };
+    segment.isStreaming = true;
+    this._state.mode = "block";
+    this._state.blockEnd = `</${block.tag}>`;
+    this._state.activeSegment = segment;
+    return { segment: null, remaining };
+  }
+  /**
+   * Stream the body of the open block until its closing tag — the same
+   * partial-delimiter handling the thinking mode uses, so a closing
+   * tag split across two chunks is never emitted as content.
+   */
+  _parseBlockMode(buffer) {
+    const endDelim = this._state.blockEnd;
     const closeIndex = buffer.indexOf(endDelim);
+    const active = this._state.activeSegment;
     if (closeIndex === -1) {
       if (this._isPartialMatch(buffer, endDelim)) {
         const partialLength = this._getPartialMatchLength(buffer, endDelim);
         const safeContent = buffer.slice(0, buffer.length - partialLength);
-        if (safeContent && this._state.activeSegment && "content" in this._state.activeSegment) {
-          this._state.activeSegment.content += safeContent;
-        }
+        if (safeContent && active) active.content += safeContent;
         return safeContent ? { segment: null, remaining: buffer.slice(-partialLength) } : null;
       }
       if (buffer.length > endDelim.length) {
         const safeContent = buffer.slice(0, -endDelim.length);
-        if (this._state.activeSegment && "content" in this._state.activeSegment) {
-          this._state.activeSegment.content += safeContent;
-        }
+        if (active) active.content += safeContent;
         return { segment: null, remaining: buffer.slice(-endDelim.length) };
       }
       return null;
     }
-    const tail = buffer.slice(0, closeIndex);
-    if (this._state.activeSegment && "content" in this._state.activeSegment) {
-      this._state.activeSegment.content += tail;
-    }
+    if (active) active.content += buffer.slice(0, closeIndex);
     const segment = this._closed(this._state.activeSegment);
     this._state.mode = "text";
     this._state.activeSegment = null;
+    this._state.blockEnd = void 0;
     return { segment, remaining: buffer.slice(closeIndex + endDelim.length) };
   }
-  // ─────────────────────────────────────────────────────────────────────────
-  // Helpers
-  // ─────────────────────────────────────────────────────────────────────────
   _createInitialState() {
     return {
       mode: "text",
@@ -593,16 +700,6 @@ class AparteStreamParser {
       label: "Thinking"
     };
   }
-  _createArtifactSegment(mimeType, title) {
-    return {
-      id: this._options.autoGenerateIds ? this._generateId() : "",
-      type: "artifact",
-      mimeType,
-      artifactType: deriveArtifactKind(mimeType),
-      title,
-      content: ""
-    };
-  }
   _isPartialMatch(buffer, pattern) {
     for (let i = 1; i < pattern.length; i++) {
       if (buffer.endsWith(pattern.slice(0, i))) {
@@ -709,7 +806,7 @@ function createAparteChatHandler(options) {
     } catch {
       return jsonError(400, "Invalid JSON body.");
     }
-    const adapter = options.providers[providerId];
+    const adapter = Object.hasOwn(options.providers, providerId) ? options.providers[providerId] : void 0;
     if (!adapter) {
       return jsonError(400, `Unknown providerId "${providerId}". Register it in the handler's providers map.`);
     }
@@ -738,7 +835,8 @@ function createAparteChatHandler(options) {
         // a client disconnect aborts the vendor call too
       });
     } catch (err) {
-      return jsonError(502, `Vendor request failed: ${err?.message ?? "network error"}`);
+      console.error("[aparte] vendor request failed", err);
+      return jsonError(502, "Vendor request failed.");
     }
     if (!vendor.ok) {
       const raw = await vendor.text().catch(() => "");
@@ -907,8 +1005,10 @@ const GLOBAL_ATTRS = /* @__PURE__ */ new Set([
   "aria-level"
 ]);
 const TAG_ATTRS = {
-  a: /* @__PURE__ */ new Set(["href", "target", "rel"]),
-  // legacy `name` dropped — obsolete + a DOM-clobbering vector
+  // `target` and `rel` are NOT copied from the model's markup — `copyAttributes`
+  // decides both below. Legacy `name` is dropped too (obsolete + a DOM-clobbering
+  // vector).
+  a: /* @__PURE__ */ new Set(["href"]),
   img: /* @__PURE__ */ new Set(["src", "alt", "width", "height", "loading", "srcset", "sizes", "decoding"]),
   source: /* @__PURE__ */ new Set(["src", "srcset", "type", "media", "sizes"]),
   input: /* @__PURE__ */ new Set(["type", "checked", "disabled"]),
@@ -925,6 +1025,8 @@ const SAFE_URL = /^(?:https?:|mailto:|tel:|ftp:|sms:)/i;
 const RELATIVE_URL = /^(?:[#/.?]|[a-z0-9._~%+-]+(?:[/?#]|$))/i;
 const SAFE_DATA_IMG = /^data:image\/(?:png|jpe?g|gif|webp|avif|bmp|x-icon|svg\+xml)[;,]/i;
 const CONTROL_WS = /[\u0000-\u0020]+/g;
+const EXTERNAL_URL = /^(?:https?:)?[/\\]{2}|^https?:[/\\]/i;
+const APARTE_CLASS = /^aparte-/i;
 function isSafeSrcset(value, tag) {
   const urlTag = tag === "source" ? "img" : tag;
   for (const m of value.matchAll(/[a-z][a-z0-9+.-]*:[^\s,]*/gi)) {
@@ -990,10 +1092,23 @@ function copyAttributes(src, dest, tag) {
       dest.setAttribute("style", scrubbed);
       continue;
     }
+    if (name === "class") {
+      const kept = value.split(/\s+/).filter((token) => token && !APARTE_CLASS.test(token));
+      if (!kept.length) continue;
+      dest.setAttribute("class", kept.join(" "));
+      continue;
+    }
     dest.setAttribute(name, value);
   }
-  if (tag === "a" && dest.getAttribute("target") === "_blank") {
-    dest.setAttribute("rel", "noopener noreferrer");
+  if (tag === "a") {
+    const href = (dest.getAttribute("href") ?? "").replace(CONTROL_WS, "");
+    const wish = (src.getAttribute("target") ?? "").trim().toLowerCase();
+    if (wish === "_self" && !EXTERNAL_URL.test(href)) {
+      dest.setAttribute("target", "_self");
+    } else if (wish || EXTERNAL_URL.test(href)) {
+      dest.setAttribute("target", "_blank");
+      dest.setAttribute("rel", "noopener noreferrer");
+    }
   }
 }
 function sanitizeChildren(src, dest, doc) {
@@ -1016,8 +1131,19 @@ function sanitizeChildren(src, dest, doc) {
     dest.appendChild(clean);
   }
 }
+const UNWRAPPED_TAGS = /* @__PURE__ */ new Set(["html", "head", "body"]);
+const DANGEROUS_ALT = Array.from(DANGEROUS_TAGS).join("|");
+const DANGEROUS_PAIRED_ALT = Array.from(DANGEROUS_TAGS).filter((t) => !UNWRAPPED_TAGS.has(t)).join("|");
+const PAIRED_DANGEROUS = new RegExp(`<\\s*(${DANGEROUS_PAIRED_ALT})\\b[\\s\\S]*?<\\s*\\/\\s*\\1\\s*>`, "gi");
+const LONE_DANGEROUS = new RegExp(`<\\s*\\/?\\s*(?:${DANGEROUS_ALT})\\b[^>]*>`, "gi");
+const INLINE_HANDLER = /["'/\s]on[a-z]+\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+)/gi;
+const UNSAFE_SCHEME_ATTR = /(?:href|src|xlink:href)\s*=\s*(?:"\s*(?:javascript|vbscript|data):[^"]*"|'\s*(?:javascript|vbscript|data):[^']*'|(?:javascript|vbscript|data):[^\s>]*)/gi;
 function fallbackScrub(html) {
-  return html.replace(/<\s*(script|style|iframe|object|embed|form|svg|math|applet|template)\b[\s\S]*?<\s*\/\s*\1\s*>/gi, "").replace(/<\s*(script|style|iframe|object|embed|applet|template|link|meta|base|frame|frameset)\b[^>]*>/gi, "").replace(/\son[a-z]+\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+)/gi, "").replace(/(?:href|src|xlink:href)\s*=\s*(?:"\s*(?:javascript|vbscript|data):[^"]*"|'\s*(?:javascript|vbscript|data):[^']*'|(?:javascript|vbscript|data):[^\s>]*)/gi, "");
+  let out = html.replace(PAIRED_DANGEROUS, "").replace(LONE_DANGEROUS, "");
+  for (let next = out.replace(INLINE_HANDLER, " "); next !== out; next = out.replace(INLINE_HANDLER, " ")) {
+    out = next;
+  }
+  return out.replace(UNSAFE_SCHEME_ATTR, " ");
 }
 const defaultSanitizer = (html) => {
   if (!html) return html;
@@ -1084,9 +1210,7 @@ const APARTE_DEFAULT_BUBBLE_ACTIONS = {
   info: false
 };
 const APARTE_DEFAULT_HOST_HANDLERS = {
-  attachmentPreview: false,
-  artifactRedownload: false,
-  artifactRehydrate: false
+  attachmentPreview: false
 };
 const NOOP = () => {
 };
@@ -1108,7 +1232,6 @@ class AparteConfig {
   _iconProvider;
   _avatarProvider;
   _keyProvider;
-  _artifactPreviewBuilder;
   _locale = APARTE_DEFAULT_LOCALE;
   _actions = [];
   _listeners = /* @__PURE__ */ new Set();
@@ -1134,10 +1257,14 @@ class AparteConfig {
   /** Host policy for the elicitation panel's free-text escape — see {@link setElicitationOptions}. */
   _elicitationAllowOther = true;
   _elicitationLayout = "stepped";
+  /** Whether a single choice answers on the click (buttons) or keeps its radios + the composer's button. */
+  _elicitationAnswerOnClick = true;
   _elicitationFieldRenderer;
   // Transport: where chat requests go + how auth is handled (AparteDirectTransport = browser-direct).
   _transport = new AparteDirectTransport();
   _modelPreferenceProvider;
+  // Per-call approval policy (a mode: plan / ask / auto). `null` = the tools' own flags.
+  _approvalPolicy = null;
   // Conversation persistence (optional, agnostic)
   _conversationManager;
   /*
@@ -1183,6 +1310,8 @@ class AparteConfig {
   // Tool Registry
   _tools = /* @__PURE__ */ new Map();
   _toolRenderers = /* @__PURE__ */ new Map();
+  /** Tagged blocks the stream parser recognises in the prose — see {@link registerStreamBlock}. */
+  _streamBlocks = /* @__PURE__ */ new Map();
   _segmentDefaults = /* @__PURE__ */ new Map();
   // Host handlers — what the app declares it can actually complete.
   _hostHandlers = { ...APARTE_DEFAULT_HOST_HANDLERS };
@@ -1236,7 +1365,7 @@ class AparteConfig {
    * @example
    * aparteGlobalConfig.setBubbleActions({ retry: true, edit: true }) // you run AparteClient
    * aparteGlobalConfig.setBubbleActions({ feedback: true })          // you listen for aparte-feedback
-   * aparteGlobalConfig.setBubbleActions({ copy: false })             // hide everything
+   * aparteGlobalConfig.setBubbleActions({ copy: false })             // hides copy; calls merge, so anything turned on above stays on
    * // Explicit per-role ordered sets (replace the flag defaults for that role):
    * aparteGlobalConfig.setBubbleActions({ user: ['edit', 'copy'], assistant: ['copy', 'thumbUp', 'thumbDown', 'retry'] })
    */
@@ -1249,7 +1378,7 @@ class AparteConfig {
    * trigger only for the ones you claim — see {@link AparteHostHandlersConfig}.
    *
    * @example
-   * aparteGlobalConfig.setHostHandlers({ attachmentPreview: true, artifactRedownload: true });
+   * aparteGlobalConfig.setHostHandlers({ attachmentPreview: true });
    */
   setHostHandlers(config) {
     this._hostHandlers = { ...this._hostHandlers, ...config };
@@ -1263,9 +1392,7 @@ class AparteConfig {
   // forgotten here.
   getHostHandlers() {
     return {
-      attachmentPreview: this._hostHandlers.attachmentPreview ?? APARTE_DEFAULT_HOST_HANDLERS.attachmentPreview,
-      artifactRedownload: this._hostHandlers.artifactRedownload ?? APARTE_DEFAULT_HOST_HANDLERS.artifactRedownload,
-      artifactRehydrate: this._hostHandlers.artifactRehydrate ?? APARTE_DEFAULT_HOST_HANDLERS.artifactRehydrate
+      attachmentPreview: this._hostHandlers.attachmentPreview ?? APARTE_DEFAULT_HOST_HANDLERS.attachmentPreview
     };
   }
   /** Returns the resolved bubble actions config (flag defaults applied; per-role sets passed through). */
@@ -1384,19 +1511,6 @@ class AparteConfig {
     this._iconProvider = provider;
     this._notify();
   }
-  /**
-   * Register an artifact preview builder (app-level). When set, the artifact
-   * renderer uses it to build the preview iframe `srcdoc`; when unset, core's
-   * CDN-free fallback is used. This is how the product opts into a
-   * React/Babel/Tailwind live preview without leaking those into core.
-   */
-  setArtifactPreviewBuilder(builder) {
-    this._artifactPreviewBuilder = builder;
-  }
-  /** The registered artifact preview builder, or undefined for the core fallback. */
-  getArtifactPreviewBuilder() {
-    return this._artifactPreviewBuilder;
-  }
   /**
    * The icon set as a **complete** provider: every name resolves, falling back
    * to `APARTE_DEFAULT_ICON_FALLBACKS` for anything the registered provider doesn't
@@ -1521,7 +1635,17 @@ class AparteConfig {
     this._notify();
   }
   /**
-   * Get the current locale
+   * Get the current locale.
+   *
+   * Typed as the closed list PLUS the open half, and the asymmetry is the point:
+   * `t()` keys on `AparteLocale` alone — a typo there is a compile error — while a
+   * plugin reading its OWN key off this object gets `string | undefined` and
+   * supplies its own default at the call site.
+   *
+   * `t()` is the one that has to be narrow, because it is the one that fails
+   * silently: it returns `''` for a key nobody declared, and an empty label is
+   * invisible on screen and in the console. A misspelt read here is `undefined`,
+   * which the `?? 'fallback'` every caller already writes turns into the default.
    */
   getLocale() {
     return this._locale;
@@ -1595,6 +1719,13 @@ class AparteConfig {
       }
       this._aiProviders.set(provider.id, provider);
     }
+    if (!this.hasSelectedModel() && this._aiProviders.size === 1) {
+      const only = [...this._aiProviders.values()][0];
+      const models = only.getModels();
+      if (models.length === 1) {
+        this._modelConfig = { ...this._modelConfig, defaultProvider: only.id, defaultModel: models[0].id };
+      }
+    }
     this._notify();
   }
   /**
@@ -1648,6 +1779,47 @@ class AparteConfig {
   setModelPreferenceProvider(provider) {
     this._modelPreferenceProvider = provider;
   }
+  /**
+   * Decide per CALL whether a tool runs, asks, or is refused — a mode, not a flag.
+   *
+   * With a policy registered, the client's default approval channel evaluates it for
+   * every tool call: `allow` runs without asking, `ask` puts the call to the person
+   * exactly as a `needsApproval` tool is, `deny` refuses it with the policy's own
+   * `reason` as what the model reads. `undefined` leaves the tool's `needsApproval`
+   * to decide, as before. `null` removes the policy.
+   *
+   * `@aparte/plugin-approval` builds one from a classification of your tool names and
+   * a switchable mode (plan / ask / auto-edit / auto); a host that owns its own
+   * `approvalResolver` on `AparteClientOptions` is not affected — that resolver
+   * already decides everything.
+   *
+   * @example
+   * ```ts
+   * aparteGlobalConfig.setApprovalPolicy((call) =>
+   *   call.name === 'run_command'
+   *     ? { verdict: 'ask' }
+   *     : { verdict: 'allow' });
+   * ```
+   */
+  setApprovalPolicy(policy) {
+    this._approvalPolicy = policy;
+    this._notify();
+  }
+  /** The registered approval policy, or `null`. */
+  getApprovalPolicy() {
+    return this._approvalPolicy;
+  }
+  /**
+   * What the policy says about one call, with the tool's own `needsApproval` as the
+   * answer when it has no opinion. The one place the two are combined, so the client's
+   * gate predicate and its approval channel cannot disagree.
+   */
+  ruleOnToolCall(call) {
+    const tool = this._tools.get(call.name)?.tool;
+    const ruling = this._approvalPolicy?.(call, tool);
+    if (ruling) return ruling;
+    return { verdict: tool?.needsApproval ? "ask" : "allow" };
+  }
   /**
    * Restore previously saved model preference via the registered provider.
    * Should be called once at app startup, before any component mounts.
@@ -1736,15 +1908,26 @@ class AparteConfig {
    * collecting structured data, not two different questions asked mid-conversation.
    * No product asks a person two questions by stacking them in one box; it is kept
    * as an option because the form case is real, not because it was the right default.
+   *
+   * `answerOnClick` decides how a question asked ON ITS OWN with a single choice — an
+   * `enum` without `multiple` or a `default`, a `boolean` without a `default` — is
+   * answered. `true` (default) renders the options as buttons and the click is the
+   * answer: one decision, one gesture, the shape every chat product uses for "which
+   * one?". `false` keeps the radios and the composer's button, so a person can
+   * change their mind before committing — the shape a form or a screen reader
+   * flow may prefer, and the one a host that wants a uniform "select, then send"
+   * across every question asks for. A form of several questions always collects and
+   * submits, whatever this says.
    */
   setElicitationOptions(options) {
     if (options.allowOther !== void 0) this._elicitationAllowOther = options.allowOther;
     if (options.layout !== void 0) this._elicitationLayout = options.layout;
+    if (options.answerOnClick !== void 0) this._elicitationAnswerOnClick = options.answerOnClick;
     this._notify();
   }
   /** The elicitation policy (see {@link setElicitationOptions}). */
   getElicitationOptions() {
-    return { allowOther: this._elicitationAllowOther, layout: this._elicitationLayout };
+    return { allowOther: this._elicitationAllowOther, layout: this._elicitationLayout, answerOnClick: this._elicitationAnswerOnClick };
   }
   /**
    * Render one field of the question panel yourself.
@@ -1937,6 +2120,38 @@ class AparteConfig {
   getToolRenderer(toolName) {
     return this._toolRenderers.get(toolName);
   }
+  /**
+   * Teach the stream parser a tagged block: `<tag attr="…">…</tag>` in the model's
+   * prose becomes the segment `toSegment` builds, streamed delta by delta.
+   *
+   * The parser does the work once for every grammar — the earliest opening tag wins
+   * against a code fence and a reasoning delimiter, a tag cut at a chunk boundary is
+   * held back, attributes are parsed quoted or bare, and the block is closed at
+   * `</tag>` or at the end of the stream. What the segment IS is yours: a `type` of
+   * your own with a renderer from `registerSegmentRenderer`, or a built-in one. One
+   * grammar per tag; registering the same tag again replaces it.
+   *
+   * Read by the stream adapter when a turn starts, so a block registered mid-turn
+   * applies from the next turn. See {@link AparteStreamBlock}.
+   *
+   * @example
+   * aparteGlobalConfig.registerStreamBlock({
+   *   tag: 'cite',
+   *   toSegment: ({ attrs, id }) => ({ id, type: 'citation', url: attrs['url'] ?? '', content: '' }),
+   * });
+   */
+  registerStreamBlock(block) {
+    this._streamBlocks.set(block.tag, block);
+    this._notify();
+  }
+  /** Forget a block grammar by its tag. */
+  unregisterStreamBlock(tag) {
+    if (this._streamBlocks.delete(tag)) this._notify();
+  }
+  /** The registered block grammars, in registration order. */
+  getStreamBlocks() {
+    return Array.from(this._streamBlocks.values());
+  }
   // ─────────────────────────────────────────────────────────────────────────
   // Conversation Manager (optional, agnostic persistence layer)
   // ─────────────────────────────────────────────────────────────────────────
@@ -2059,7 +2274,7 @@ class AparteConfig {
       if (!this._warnedNoPresenter) {
         this._warnedNoPresenter = true;
         console.warn(
-          "[aparte] requestUserInput() was called with no elicitation presenter, so it rejected with an AbortError — nothing was ever shown to anybody. Add <aparte-elicitation></aparte-elicitation> inside your <aparte-chat>, or register your own by calling setElicitationPresenter() on the config this chat resolves — the scoped one if you passed a `config`, aparteGlobalConfig otherwise."
+          "[aparte] requestUserInput() was called with no elicitation presenter, so it rejected with an AbortError — nothing was ever shown to anybody. Add <aparte-elicitation></aparte-elicitation> inside your <aparte-chat> (the Angular wrapper's tag too) — or, under the React/Vue/Svelte wrappers, inside their [data-aparte-chat] host (every wrapper renders it by default, unless you passed `elicitation={false}`) — or register your own by calling setElicitationPresenter() on the config this chat resolves — the scoped one if you passed a `config`, aparteGlobalConfig otherwise."
         );
       }
       return Promise.reject(new AparteElicitationAbortError("no-presenter"));
@@ -2087,7 +2302,6 @@ class AparteConfig {
     this._iconProvider = void 0;
     this._segmentDefaults.clear();
     this._avatarProvider = void 0;
-    this._artifactPreviewBuilder = void 0;
     this._keyProvider = void 0;
     this._conversationManager = void 0;
     this._elicitationPresenters = [];
@@ -2099,12 +2313,15 @@ class AparteConfig {
     this._fetchedModels.clear();
     this._tools.clear();
     this._toolRenderers.clear();
+    this._streamBlocks.clear();
     this._modelConfig = {};
     this._requireModelSelection = false;
     this._elicitationAllowOther = true;
     this._elicitationLayout = "stepped";
+    this._elicitationAnswerOnClick = true;
     this._elicitationFieldRenderer = void 0;
     this._modelPreferenceProvider = void 0;
+    this._approvalPolicy = null;
     this._bubbleActionsConfig = { ...APARTE_DEFAULT_BUBBLE_ACTIONS };
     this._hostHandlers = { ...APARTE_DEFAULT_HOST_HANDLERS };
     this._notify();
@@ -2287,6 +2504,40 @@ const thinkingRenderer = {
   },
   getStyles: () => ``
 };
+function copyText(text) {
+  if (typeof navigator !== "undefined" && navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
+    return navigator.clipboard.writeText(text);
+  }
+  return new Promise((resolve, reject) => {
+    if (typeof document === "undefined" || typeof document.execCommand !== "function") {
+      reject(new Error("[aparte] No clipboard available in this context"));
+      return;
+    }
+    const area = document.createElement("textarea");
+    area.value = text;
+    area.setAttribute("readonly", "");
+    area.setAttribute("aria-hidden", "true");
+    area.style.position = "fixed";
+    area.style.top = "0";
+    area.style.left = "-9999px";
+    area.style.opacity = "0";
+    const active = document.activeElement;
+    document.body.appendChild(area);
+    area.focus();
+    area.select();
+    area.setSelectionRange(0, text.length);
+    let copied = false;
+    try {
+      copied = document.execCommand("copy");
+    } catch {
+      copied = false;
+    }
+    area.remove();
+    if (active instanceof HTMLElement) active.focus();
+    if (copied) resolve();
+    else reject(new Error("[aparte] Clipboard write failed"));
+  });
+}
 const HIGHLIGHT_DEBOUNCE_MS = 400;
 const MAX_THROTTLE_ENTRIES = 256;
 const _lastHighlightAt = /* @__PURE__ */ new Map();
@@ -2369,7 +2620,7 @@ const codeRenderer = {
     if (copyBtn) {
       copyBtn.addEventListener("click", () => {
         const source = element.querySelector(".aparte-code-content-wrapper")?.textContent ?? "";
-        void navigator.clipboard.writeText(source).catch(() => {
+        void copyText(source).catch(() => {
         });
         copyBtn.innerHTML = contextConfig(copyBtn).getIcon("check");
         copyBtn.setAttribute("title", contextConfig(copyBtn).t("copied"));
@@ -2439,8 +2690,7 @@ const errorRenderer = {
   },
   getStyles: () => ``
 };
-function describeInput(segment) {
-  const input = segment.toolCall?.input;
+function describeToolInput(input) {
   if (!input || typeof input !== "object" || Object.keys(input).length === 0) return "";
   try {
     return JSON.stringify(input, null, 2);
@@ -2448,6 +2698,9 @@ function describeInput(segment) {
     return "";
   }
 }
+function describeInput(segment) {
+  return describeToolInput(segment.toolCall?.input);
+}
 function stateBadge(segment) {
   const cfg = contextConfig();
   const status = segment.status ?? "pending";
@@ -2457,6 +2710,7 @@ function stateBadge(segment) {
   if (status === "resolved") return `${cfg.getIcon("check")}${word("toolCompleted")}`;
   if (status === "rejected") return `${cfg.getIcon("close")}${word("toolRejected")}`;
   if (status === "aborted") return `${cfg.getIcon("stop")}${word("toolStopped")}`;
+  if (status === "failed") return `${cfg.getIcon("close")}${word("toolFailed")}`;
   return "";
 }
 function setPart(element, part, text) {
@@ -2565,6 +2819,11 @@ const toolCallRenderer = {
    */
   relabel: (element, segment) => {
     const cfg = contextConfig();
+    const custom = cfg.getToolRenderer(segment.toolCall?.name);
+    if (custom) {
+      custom.relabel?.(element, segment);
+      return;
+    }
     const icon = element.querySelector(".aparte-tool-icon");
     if (icon) icon.innerHTML = cfg.getIcon("tool");
     const statusEl = element.querySelector(".aparte-tool-state");
@@ -2588,6 +2847,10 @@ const toolCallRenderer = {
     const input = describeInput(segment);
     const wantsDetail = !!input || !!segment.result;
     const custom = contextConfig().getToolRenderer(segment.toolCall?.name);
+    if (custom?.update) {
+      custom.update(element, segment);
+      return;
+    }
     if (custom || wantsDetail !== (element.tagName === "DETAILS")) {
       const out = toolCallRenderer.render(segment);
       const tpl = document.createElement("template");
@@ -2617,709 +2880,6 @@ const toolCallRenderer = {
   // has no other way onto the page.
   getStyles: () => ""
 };
-function stripCodeFences(content) {
-  let s = content;
-  if (s.startsWith("```") || s.startsWith("~~~")) {
-    const fenceChar = s[0];
-    let i = 0;
-    while (i < s.length && s[i] === fenceChar) i++;
-    while (i < s.length && s[i] !== "\n") i++;
-    if (i < s.length && s[i] === "\n") i++;
-    s = s.slice(i);
-  }
-  const closeAt = findClosingFence(s);
-  if (closeAt !== -1) s = s.slice(0, closeAt);
-  return s.trim();
-}
-function findClosingFence(s) {
-  let i = 0;
-  while (i < s.length) {
-    const lineStart = i;
-    let k = lineStart;
-    while (k < s.length && (s[k] === " " || s[k] === "	")) k++;
-    if (k < s.length && (s[k] === "`" || s[k] === "~")) {
-      const fenceChar = s[k];
-      let runs = 0;
-      while (k < s.length && s[k] === fenceChar) {
-        runs++;
-        k++;
-      }
-      if (runs >= 3) {
-        let onlyWs = true;
-        while (k < s.length && s[k] !== "\n") {
-          if (s[k] !== " " && s[k] !== "	" && s[k] !== "\r") {
-            onlyWs = false;
-            break;
-          }
-          k++;
-        }
-        if (onlyWs) {
-          let cut = lineStart;
-          if (cut > 0 && s[cut - 1] === "\n") cut--;
-          return cut;
-        }
-      }
-    }
-    while (i < s.length && s[i] !== "\n") i++;
-    if (i < s.length) i++;
-  }
-  return -1;
-}
-function labelForKind(kind) {
-  switch (kind) {
-    case "react":
-      return "React component";
-    case "html":
-      return "HTML document";
-    case "svg":
-      return "SVG image";
-    case "js":
-      return "JavaScript snippet";
-    case "css":
-      return "CSS stylesheet";
-    case "json":
-      return "JSON document";
-    case "markdown":
-      return "Markdown document";
-    case "csv":
-      return "CSV table";
-    case "text":
-      return "Text file";
-    case "python":
-      return "Python script";
-    case "typescript":
-      return "TypeScript file";
-    case "bash":
-      return "Bash script";
-    case "sql":
-      return "SQL query";
-    case "pdf":
-      return "PDF generator";
-    case "xlsx":
-      return "Excel generator";
-    case "docx":
-      return "Word generator";
-    default:
-      return "Artifact";
-  }
-}
-const PREVIEW_CSP = "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; font-src data:";
-function withMetaCsp(doc) {
-  const meta = `<meta http-equiv="Content-Security-Policy" content="${escapeAttr(PREVIEW_CSP)}">`;
-  const doctype = doc.match(/^\s*<!doctype[^>]*>/i);
-  const at = doctype ? doctype[0].length : 0;
-  return `${doc.slice(0, at)}<head>${meta}</head>${doc.slice(at)}`;
-}
-function buildSafePreviewDocument(kind, body, title) {
-  return withMetaCsp(buildPreviewBody(kind, body, title));
-}
-function buildPreviewBody(kind, body, title) {
-  switch (kind) {
-    case "html": {
-      if (startsWithDoctype(body)) return body;
-      return `<!doctype html><html><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>${escapeAttr(title)}</title></head><body>${body}</body></html>`;
-    }
-    // An SVG with only a `viewBox` — the recommended, responsive form, and the one
-    // a model writes most often — has NO intrinsic size. As a flex item its cross
-    // size then collapses to zero and the frame is blank: the preview worked for an
-    // SVG that declared `width`/`height` and silently showed nothing for the
-    // idiomatic one. Reported from the landing the moment its demo payload became a
-    // real file instead of a hand-written chart with dimensions on it.
-    //
-    // The rule is narrowed by attribute selector rather than applied to every SVG,
-    // so an SVG that DOES state its size keeps the size it asked for.
-    case "svg":
-      return `<!doctype html><html><head><meta charset="utf-8"/><title>${escapeAttr(title)}</title>
-<style>html,body{margin:0;height:100%;display:flex;align-items:center;justify-content:center;background:#fff}svg{max-width:90%;max-height:90%}svg:not([width]):not([height]){width:90%;height:90%}</style>
-</head><body>${body}</body></html>`;
-    case "js": {
-      const safeBody = escapeClosingScriptTag(body);
-      return `<!doctype html><html><head><meta charset="utf-8"/><title>${escapeAttr(title)}</title>
-<style>body{margin:0;font-family:ui-sans-serif,system-ui,sans-serif;padding:1rem;background:#fff;color:#0f172a}</style>
-</head><body><div id="root"></div><script>
-try { ${safeBody}
-} catch (e) { document.getElementById('root').innerHTML = '<pre style="color:#b91c1c">' + (e && e.stack || e) + '</pre>'; }
-<\/script></body></html>`;
-    }
-    case "css":
-      return `<!doctype html><html><head><meta charset="utf-8"/><title>${escapeAttr(title)}</title>
-<style>${body}</style></head><body>
-<div class="demo">
-  <h1>Heading</h1>
-  <p>Paragraph with a <a href="#">link</a> and <strong>strong</strong> text.</p>
-  <button>Button</button>
-  <input placeholder="Input"/>
-  <ul><li>One</li><li>Two</li><li>Three</li></ul>
-</div></body></html>`;
-    default:
-      return `<!doctype html><html><head><meta charset="utf-8"/><title>${escapeAttr(title)}</title>
-<style>body{margin:0;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;padding:1rem;background:#fff;color:#0f172a}pre{white-space:pre-wrap;word-break:break-word;margin:0}</style>
-</head><body><pre>${escapeHtml(body)}</pre></body></html>`;
-  }
-}
-function startsWithDoctype(s) {
-  let i = 0;
-  while (i < s.length && (s[i] === " " || s[i] === "	" || s[i] === "\n" || s[i] === "\r")) i++;
-  const probe = s.slice(i, i + 9).toLowerCase();
-  return probe === "<!doctype";
-}
-function escapeClosingScriptTag(body) {
-  let out = "";
-  let i = 0;
-  while (i < body.length) {
-    if (body[i] === "<" && body.slice(i, i + 8).toLowerCase() === "<\/script") {
-      const next = body[i + 8];
-      if (next === void 0 || next === "/" || next === ">" || /\s/.test(next)) {
-        out += "<\\/script";
-        i += 8;
-        continue;
-      }
-    }
-    out += body[i];
-    i++;
-  }
-  return out;
-}
-const FILE_ICON_LABEL = {
-  xlsx: "XLS",
-  pdf: "PDF",
-  docx: "DOC"
-};
-const _binaryArtifactCache = /* @__PURE__ */ new Map();
-const MAX_BINARY_ARTIFACTS = 24;
-function cacheBinaryArtifact(id, entry) {
-  _binaryArtifactCache.delete(id);
-  if (_binaryArtifactCache.size >= MAX_BINARY_ARTIFACTS) {
-    const oldest = _binaryArtifactCache.keys().next().value;
-    if (oldest !== void 0) _binaryArtifactCache.delete(oldest);
-  }
-  _binaryArtifactCache.set(id, entry);
-}
-const _fileGenHandlers = /* @__PURE__ */ new Map();
-const MAX_FILE_GEN_HANDLERS = 32;
-const _lastDispatchAt = /* @__PURE__ */ new Map();
-const RE_DISPATCH_DEBOUNCE_MS = 3e4;
-let _artifactReadyHookInstalled = false;
-function installArtifactReadyHook() {
-  if (_artifactReadyHookInstalled || typeof window === "undefined") return;
-  _artifactReadyHookInstalled = true;
-  window.addEventListener("aparte-artifact-ready", (event) => {
-    const segId = event.detail?.segmentId;
-    if (segId) markThrottle(_lastDispatchAt, segId, Date.now());
-  });
-}
-function renderBinaryFileArtifact(segment, kind) {
-  const title = segment.title?.trim() || labelForKind(kind);
-  const iconLabel = FILE_ICON_LABEL[kind] ?? kind.toUpperCase();
-  const isStreaming = !!segment.isStreaming;
-  const canRedownload = contextConfig().getHostHandlers().artifactRedownload;
-  const downloadLabel = escapeHtml(contextConfig().t("download"));
-  const cached = _binaryArtifactCache.get(segment.id);
-  if (cached && !isStreaming) {
-    const previewBody = cached.previewHtml ? contextConfig().sanitizeHtml(cached.previewHtml) : `<div class="aparte-art-file__preview-empty">Preview not available for ${escapeHtml(kind)} yet</div>`;
-    return `
-            <div class="aparte-segment aparte-card aparte-segment-artifact-file"
-                 data-segment-id="${escapeHtml(segment.id)}"
-                 data-artifact-type="${escapeHtml(kind)}"
-                 data-state="ready">
-                <div class="aparte-art-file__card">
-                    <div class="aparte-art-file__icon" data-kind="${escapeHtml(kind)}">${escapeHtml(iconLabel)}</div>
-                    <div class="aparte-art-file__meta">
-                        <div class="aparte-art-file__meta-name" data-role="file-name">${escapeHtml(cached.name)}</div>
-                        <div class="aparte-art-file__meta-sub" data-role="file-sub">${escapeHtml(formatBytes(cached.bytes))} · ${escapeHtml(kind.toUpperCase())}</div>
-                    </div>
-                    <div class="aparte-art-file__actions">
-                        ${canRedownload ? `<button type="button" class="aparte-btn aparte-btn--primary aparte-btn--solid aparte-art-file__btn aparte-art-file__btn--primary" data-action="download">${downloadLabel}</button>` : ""}
-                    </div>
-                </div>
-                <div class="aparte-art-file__body">
-                    <div class="aparte-art-file__code-pane" data-role="code-pane" hidden>
-                        <pre><code class="language-js"></code></pre>
-                    </div>
-                    <div class="aparte-art-file__preview-pane" data-role="preview-pane">${previewBody}</div>
-                </div>
-            </div>
-        `;
-  }
-  const cleanContent = stripCodeFences(segment.content || "");
-  const subText = isStreaming ? contextConfig().t("generating") : contextConfig().t("rebuildingPreview");
-  return `
-        <div class="aparte-segment aparte-card aparte-segment-artifact-file"
-             data-segment-id="${escapeHtml(segment.id)}"
-             data-artifact-type="${escapeHtml(kind)}"
-             data-state="${isStreaming ? "streaming" : "compiling"}">
-            <div class="aparte-art-file__card">
-                <div class="aparte-art-file__icon" data-kind="${escapeHtml(kind)}">${escapeHtml(iconLabel)}</div>
-                <div class="aparte-art-file__meta">
-                    <div class="aparte-art-file__meta-name" data-role="file-name">${escapeHtml(title)}</div>
-                    <div class="aparte-art-file__meta-sub" data-role="file-sub">${escapeHtml(subText)}</div>
-                </div>
-                <div class="aparte-art-file__actions">
-                    ${canRedownload ? `<button type="button" class="aparte-btn aparte-btn--primary aparte-btn--solid aparte-art-file__btn aparte-art-file__btn--primary" data-action="download" disabled>${downloadLabel}</button>` : ""}
-                </div>
-            </div>
-            <div class="aparte-art-file__body">
-                <div class="aparte-art-file__code-pane" data-role="code-pane">
-                    <pre><code class="language-js">${escapeHtml(cleanContent)}</code></pre>
-                </div>
-                <div class="aparte-art-file__preview-pane" data-role="preview-pane" hidden></div>
-            </div>
-        </div>
-    `;
-}
-function setupBinaryFileArtifact(element, segment, kind) {
-  if (element.dataset["aparteInit"] !== "true") {
-    element.dataset["aparteInit"] = "true";
-    _fileGenHandlers.get(segment.id)?.();
-    const cleanup = () => {
-      window.removeEventListener("aparte-file-gen-ready", onReady);
-      window.removeEventListener("aparte-file-gen-error", onError);
-      _fileGenHandlers.delete(segment.id);
-    };
-    const onReady = (event) => {
-      const detail = event.detail;
-      if (!detail || detail.segmentId !== segment.id) return;
-      cacheBinaryArtifact(segment.id, {
-        buffer: detail.buffer,
-        mime: detail.mime,
-        name: detail.filename,
-        bytes: detail.bytes,
-        previewHtml: detail.previewHtml
-      });
-      swapToPreview(element, detail, kind);
-      cleanup();
-    };
-    window.addEventListener("aparte-file-gen-ready", onReady);
-    const onError = (event) => {
-      const detail = event.detail;
-      if (!detail || detail.segmentId !== segment.id) return;
-      showSandboxError(element, detail.phase ?? "exec", detail.error ?? "Unknown error");
-      cleanup();
-    };
-    window.addEventListener("aparte-file-gen-error", onError);
-    if (_fileGenHandlers.size >= MAX_FILE_GEN_HANDLERS) {
-      const oldest = _fileGenHandlers.keys().next().value;
-      if (oldest !== void 0) _fileGenHandlers.get(oldest)?.();
-    }
-    _fileGenHandlers.set(segment.id, cleanup);
-    element.addEventListener("click", (ev) => {
-      const target = ev.target;
-      const action = target.closest("[data-action]")?.getAttribute("data-action");
-      if (action !== "download") return;
-      const cached2 = _binaryArtifactCache.get(segment.id);
-      if (!cached2) return;
-      const blob = new Blob([cached2.buffer], { type: cached2.mime });
-      const url = URL.createObjectURL(blob);
-      const a = document.createElement("a");
-      a.href = url;
-      a.download = cached2.name;
-      a.style.display = "none";
-      document.body.appendChild(a);
-      a.click();
-      document.body.removeChild(a);
-      setTimeout(() => URL.revokeObjectURL(url), 1e3);
-    });
-  }
-  const currentState = element.getAttribute("data-state");
-  if (segment.isStreaming || currentState === "ready") return;
-  const cached = _binaryArtifactCache.get(segment.id);
-  if (cached) {
-    swapToPreview(
-      element,
-      { filename: cached.name, bytes: cached.bytes, previewHtml: cached.previewHtml },
-      kind
-    );
-    return;
-  }
-  if (!contextConfig().getHostHandlers().artifactRehydrate) return;
-  const lastAt = _lastDispatchAt.get(segment.id) ?? 0;
-  if (Date.now() - lastAt < RE_DISPATCH_DEBOUNCE_MS) return;
-  markThrottle(_lastDispatchAt, segment.id, Date.now());
-  const reloadMessageId = `__reload__${Date.now()}`;
-  queueMicrotask(() => {
-    window.dispatchEvent(new CustomEvent("aparte-artifact-ready", {
-      detail: {
-        messageId: reloadMessageId,
-        segmentId: segment.id,
-        mimeType: segment.mimeType,
-        artifactType: segment.artifactType,
-        title: segment.title,
-        content: stripCodeFences(segment.content || "")
-      }
-    }));
-  });
-  const wrapper = element.querySelector('[data-role="code-pane"]');
-  if (wrapper) {
-    const cleanContent = stripCodeFences(segment.content || "");
-    void contextConfig(element).highlightCode(cleanContent, "js").then((html) => {
-      wrapper.innerHTML = html;
-    }).catch(() => {
-    });
-  }
-}
-function updateBinaryFileArtifact(element, segment, isStreaming) {
-  const state = element.getAttribute("data-state");
-  if (state === "ready") return;
-  const cleanContent = stripCodeFences(segment.content || "");
-  if (isStreaming) {
-    streamHighlight(element, '[data-role="code-pane"]', cleanContent, "js", segment.id);
-  } else {
-    const codeEl = element.querySelector('[data-role="code-pane"] code');
-    if (codeEl) codeEl.textContent = cleanContent;
-  }
-  if (!isStreaming && state === "streaming") {
-    element.setAttribute("data-state", "compiling");
-    const wrapper = element.querySelector('[data-role="code-pane"]');
-    if (wrapper) {
-      void contextConfig(element).highlightCode(cleanContent, "js").then((html) => {
-        wrapper.innerHTML = html;
-      }).catch(() => {
-      });
-    }
-    const sub = element.querySelector('[data-role="file-sub"]');
-    if (sub) sub.textContent = "Running sandbox…";
-  }
-}
-function swapToPreview(element, detail, kind) {
-  element.setAttribute("data-state", "ready");
-  const codePane = element.querySelector('[data-role="code-pane"]');
-  if (codePane) codePane.hidden = true;
-  const preview = element.querySelector('[data-role="preview-pane"]');
-  if (preview) {
-    preview.innerHTML = detail.previewHtml ? contextConfig().sanitizeHtml(detail.previewHtml) : `<div class="aparte-art-file__preview-empty">Preview not available for ${escapeHtml(kind)} yet</div>`;
-    preview.hidden = false;
-  }
-  const nameEl = element.querySelector('[data-role="file-name"]');
-  if (nameEl) nameEl.textContent = detail.filename;
-  const sub = element.querySelector('[data-role="file-sub"]');
-  if (sub) sub.textContent = `${formatBytes(detail.bytes)} · ${kind.toUpperCase()}`;
-  const dlBtn = element.querySelector('[data-action="download"]');
-  if (dlBtn) dlBtn.disabled = false;
-}
-function formatBytes(n) {
-  if (n < 1024) return `${n} B`;
-  if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
-  return `${(n / (1024 * 1024)).toFixed(2)} MB`;
-}
-function showSandboxError(element, phase, errorMsg) {
-  const state = element.getAttribute("data-state");
-  if (state === "ready") return;
-  element.setAttribute("data-state", "error");
-  const sub = element.querySelector('[data-role="file-sub"]');
-  if (sub) sub.textContent = `Error (${phase})`;
-  const body = element.querySelector(".aparte-art-file__body");
-  if (body) {
-    const short = (errorMsg.split("\n")[0] ?? "").slice(0, 240);
-    body.innerHTML = `
-            <div class="aparte-art-file__error">
-                <div class="aparte-art-file__error-title">${escapeHtml(contextConfig().t("sandboxError"))}</div>
-                <div class="aparte-output aparte-art-file__error-msg">${escapeHtml(short)}</div>
-                <div class="aparte-art-file__error-hint">${escapeHtml(contextConfig().t("sandboxErrorHint"))}</div>
-            </div>
-        `;
-  }
-}
-const PREVIEWABLE_KINDS = /* @__PURE__ */ new Set(["react", "html", "svg", "js", "css"]);
-const BINARY_FILE_KINDS = /* @__PURE__ */ new Set(["pdf", "xlsx", "docx"]);
-const artifactRenderer = {
-  type: "artifact",
-  render: (segment) => {
-    const kind = (segment.artifactType || "unknown").toLowerCase();
-    if (BINARY_FILE_KINDS.has(kind)) {
-      return renderBinaryFileArtifact(segment, kind);
-    }
-    const title = segment.title?.trim() || labelForKind(kind);
-    const displayLang = languageForKind(kind);
-    const isStreaming = !!segment.isStreaming;
-    const previewable = PREVIEWABLE_KINDS.has(kind);
-    const cfg = contextConfig();
-    const downloadLabel = cfg.t("download");
-    const previewLabel = cfg.t("preview");
-    const codeLabel = cfg.t("code");
-    const isBinary = BINARY_FILE_KINDS.has(kind);
-    const cleanContent = stripCodeFences(segment.content || "");
-    const cardId = escapeAttr(segment.id);
-    return `
-            <div class="aparte-segment aparte-card aparte-segment-artifact-card"
-                 data-segment-id="${escapeHtml(segment.id)}"
-                 data-artifact-type="${escapeHtml(kind)}"
-                 data-streaming="${isStreaming ? "true" : "false"}"
-                 data-tab="code"
-                 data-previewable="${previewable ? "true" : "false"}"
-                 data-binary="${isBinary ? "true" : "false"}">
-                <header class="aparte-art-card__header">
-                    <div class="aparte-art-card__title-block">
-                        <span class="aparte-badge aparte-badge--outline aparte-art-card__kind" data-kind="${escapeHtml(kind)}">${escapeHtml(displayLang)}</span>
-                        <span class="aparte-art-card__title">${escapeHtml(title)}</span>
-                        ${isStreaming ? `<span class="aparte-dot aparte-art-card__pulse" role="img" aria-label="${escapeAttr(cfg.t("generating"))}"></span>` : ""}
-                    </div>
-                    <div class="aparte-art-card__actions">
-                        <button type="button" class="aparte-btn aparte-btn--icon aparte-art-card__btn" data-action="copy" title="${escapeAttr(contextConfig().t("copy"))}" aria-label="${escapeAttr(contextConfig().t("copy"))}">
-                            ${contextConfig().getIcon("copy")}
-                        </button>
-                        <button type="button" class="aparte-btn aparte-btn--icon aparte-art-card__btn" data-action="download" title="${escapeAttr(downloadLabel)}" aria-label="${escapeAttr(downloadLabel)}" ${isStreaming ? "disabled" : ""}>
-                            ${contextConfig().getIcon("download")}
-                        </button>
-                    </div>
-                </header>
-                <nav class="aparte-tabs aparte-tabs--underline aparte-art-card__tabs" role="tablist">
-                    <button type="button" class="aparte-tabs__tab" role="tab" id="aparte-art-${cardId}-tab-code" aria-controls="aparte-art-${cardId}-pane-code" aria-selected="true" tabindex="0" data-tab-target="code">${escapeHtml(codeLabel)}</button>
-                    ${previewable ? `<button type="button" class="aparte-tabs__tab" role="tab" id="aparte-art-${cardId}-tab-preview" aria-controls="aparte-art-${cardId}-pane-preview" aria-selected="false" tabindex="-1" data-tab-target="preview" ${isStreaming ? "disabled" : ""}>${escapeHtml(previewLabel)}</button>` : ""}
-                </nav>
-                <div class="aparte-art-card__body">
-                    <div class="aparte-art-card__pane" role="tabpanel" id="aparte-art-${cardId}-pane-code" aria-labelledby="aparte-art-${cardId}-tab-code" tabindex="0" data-pane="code">
-                        <div class="aparte-code-content-wrapper">
-                            <pre><code class="language-${escapeHtml(displayLang)}">${escapeHtml(cleanContent)}</code></pre>
-                        </div>
-                    </div>
-                    ${previewable ? `
-                        <div class="aparte-art-card__pane" role="tabpanel" id="aparte-art-${cardId}-pane-preview" aria-labelledby="aparte-art-${cardId}-tab-preview" tabindex="0" data-pane="preview">
-                            <div class="aparte-art-card__pending">${escapeHtml(cfg.t("previewPending"))}</div>
-                        </div>
-                    ` : ""}
-                </div>
-            </div>
-        `;
-  },
-  /**
-   * Every string this card shows: the copy button's tooltip, glyph and accessible
-   * name, the download button's title and label, and the two tab names. They were
-   * all hardcoded literals until they got locale keys — including the copy button's
-   * `aria-label`, which said "Copy" while its own `title` one attribute away already
-   * went through `t('copy')`, so a French reader got a French tooltip and an English
-   * announcement.
-   *
-   * Nothing here touches the tab state or the preview pane: a mounted iframe is
-   * running model-authored code, and re-rendering this card is exactly what the
-   * hook exists to avoid.
-   */
-  relabel: (element) => {
-    const cfg = contextConfig();
-    const copyBtn = element.querySelector('.aparte-art-card__btn[data-action="copy"]');
-    if (copyBtn) {
-      copyBtn.setAttribute("title", cfg.t("copy"));
-      copyBtn.setAttribute("aria-label", cfg.t("copy"));
-      copyBtn.innerHTML = cfg.getIcon("copy");
-    }
-    const dl = element.querySelector('.aparte-art-card__btn[data-action="download"]');
-    if (dl) {
-      const label = cfg.t("download");
-      dl.setAttribute("title", label);
-      dl.setAttribute("aria-label", label);
-    }
-    const previewTab = element.querySelector('[data-tab-target="preview"]');
-    if (previewTab) previewTab.textContent = cfg.t("preview");
-    const codeTab = element.querySelector('[data-tab-target="code"]');
-    if (codeTab) codeTab.textContent = cfg.t("code");
-  },
-  setup: (element, segment) => {
-    latestSegment.set(element, segment);
-    const kind = (segment.artifactType || "").toLowerCase();
-    if (BINARY_FILE_KINDS.has(kind)) {
-      setupBinaryFileArtifact(element, segment, kind);
-      return;
-    }
-    const wrapper = element.querySelector(".aparte-code-content-wrapper");
-    if (wrapper) {
-      const displayLang = languageForKind(kind);
-      const cleanContent = stripCodeFences(segment.content || "");
-      void contextConfig().highlightCode(cleanContent, displayLang).then((html) => {
-        wrapper.innerHTML = html;
-      }).catch(() => {
-      });
-    }
-    const tabs = [...element.querySelectorAll("[data-tab-target]")];
-    const select = (btn, focus) => {
-      const target = btn.getAttribute("data-tab-target");
-      if (!target || btn.disabled) return;
-      if (target === "preview") mountPreviewFrame(element, segment);
-      element.setAttribute("data-tab", target);
-      for (const b of tabs) {
-        const on = b === btn;
-        b.setAttribute("aria-selected", on ? "true" : "false");
-        b.tabIndex = on ? 0 : -1;
-      }
-      if (focus) btn.focus();
-    };
-    for (const [i, btn] of tabs.entries()) {
-      btn.addEventListener("click", () => select(btn, false));
-      btn.addEventListener("keydown", (e) => {
-        const step = e.key === "ArrowRight" ? 1 : e.key === "ArrowLeft" ? -1 : 0;
-        let next = -1;
-        if (step) next = (i + step + tabs.length) % tabs.length;
-        else if (e.key === "Home") next = 0;
-        else if (e.key === "End") next = tabs.length - 1;
-        if (next < 0) return;
-        e.preventDefault();
-        for (let n = 0; n < tabs.length; n++) {
-          const candidate = tabs[(next + n * (step || 1) + tabs.length) % tabs.length];
-          if (candidate && !candidate.disabled) {
-            select(candidate, true);
-            return;
-          }
-        }
-      });
-    }
-    const copyBtn = element.querySelector('[data-action="copy"]');
-    if (copyBtn) {
-      copyBtn.addEventListener("click", () => {
-        const code = stripCodeFences(segment.content || "");
-        void navigator.clipboard.writeText(code).catch(() => {
-        });
-        const original = copyBtn.innerHTML;
-        copyBtn.innerHTML = contextConfig(copyBtn).getIcon("check");
-        copyBtn.setAttribute("title", contextConfig(copyBtn).t("copied"));
-        setTimeout(() => {
-          copyBtn.innerHTML = original;
-          copyBtn.setAttribute("title", contextConfig(copyBtn).t("copy"));
-        }, 1500);
-      });
-    }
-    const dlBtn = element.querySelector('[data-action="download"]');
-    if (dlBtn) {
-      dlBtn.addEventListener("click", () => {
-        if (dlBtn.disabled) return;
-        const kind2 = (segment.artifactType || "").toLowerCase();
-        const isBinary = BINARY_FILE_KINDS.has(kind2);
-        if (isBinary) {
-          element.dispatchEvent(new CustomEvent("aparte-artifact-redownload", {
-            bubbles: true,
-            composed: true,
-            detail: {
-              segmentId: segment.id,
-              mimeType: segment.mimeType,
-              artifactType: segment.artifactType,
-              title: segment.title,
-              content: stripCodeFences(segment.content || "")
-            }
-          }));
-          return;
-        }
-        downloadTextArtifact(segment);
-      });
-    }
-  },
-  update: (element, segment) => {
-    const previous = latestSegment.get(element);
-    latestSegment.set(element, segment);
-    if (previous && previous.content !== segment.content) {
-      element.querySelector('.aparte-art-card__pane[data-pane="preview"] iframe')?.remove();
-    }
-    const isStreaming = !!segment.isStreaming;
-    const kind = (segment.artifactType || "").toLowerCase();
-    if (BINARY_FILE_KINDS.has(kind)) {
-      updateBinaryFileArtifact(element, segment, isStreaming);
-      return;
-    }
-    const wasStreaming = element.getAttribute("data-streaming") === "true";
-    const cleanContent = stripCodeFences(segment.content || "");
-    if (isStreaming) {
-      const segId = element.getAttribute("data-segment-id") ?? segment.id;
-      streamHighlight(element, ".aparte-code-content-wrapper", cleanContent, languageForKind(kind), segId);
-    } else {
-      const codeEl = element.querySelector(".aparte-code-content-wrapper code");
-      if (codeEl) {
-        codeEl.textContent = cleanContent;
-      } else {
-        const wrapper = element.querySelector(".aparte-code-content-wrapper");
-        if (wrapper) {
-          const displayLang = languageForKind(kind);
-          wrapper.innerHTML = `<pre><code class="language-${escapeHtml(displayLang)}">${escapeHtml(cleanContent)}</code></pre>`;
-        }
-      }
-    }
-    if (wasStreaming && !isStreaming) {
-      element.setAttribute("data-streaming", "false");
-      element.querySelector(".aparte-art-card__pulse")?.remove();
-      const wrapper = element.querySelector(".aparte-code-content-wrapper");
-      if (wrapper) {
-        const displayLang = languageForKind(kind);
-        void contextConfig().highlightCode(cleanContent, displayLang).then((html) => {
-          wrapper.innerHTML = html;
-        }).catch(() => {
-        });
-      }
-      element.querySelectorAll("button[disabled]").forEach((b) => {
-        b.disabled = false;
-      });
-    }
-  },
-  // CSS lives in styles/segment/ — see that folder for why a
-  // built-in's rules belong there. `getStyles` stays for a CONSUMER's renderer, which
-  // has no other way onto the page.
-  getStyles: () => ""
-};
-function languageForKind(kind) {
-  if (kind === "react") return "jsx";
-  if (kind === "markdown") return "md";
-  if (kind === "pdf" || kind === "xlsx" || kind === "docx") return "js";
-  return kind || "text";
-}
-function downloadTextArtifact(segment) {
-  const content = stripCodeFences(segment.content || "");
-  const kind = (segment.artifactType || "").toLowerCase();
-  const ext = {
-    react: "jsx",
-    html: "html",
-    svg: "svg",
-    js: "js",
-    css: "css",
-    json: "json",
-    markdown: "md",
-    csv: "csv",
-    text: "txt",
-    python: "py",
-    typescript: "ts",
-    bash: "sh",
-    sql: "sql"
-  }[kind] ?? "txt";
-  const baseTitle = (segment.title ?? labelForKind(kind)).trim();
-  const safeBase = slugifyForFilename(baseTitle) || "artifact";
-  const filename = `${safeBase}.${ext}`;
-  const mime = segment.mimeType || "text/plain";
-  const blob = new Blob([content], { type: mime });
-  const url = URL.createObjectURL(blob);
-  const a = document.createElement("a");
-  a.href = url;
-  a.download = filename;
-  a.style.display = "none";
-  document.body.appendChild(a);
-  a.click();
-  document.body.removeChild(a);
-  setTimeout(() => URL.revokeObjectURL(url), 1e3);
-}
-function slugifyForFilename(text) {
-  const lower = text.trim().toLowerCase();
-  let out = "";
-  let prevDash = false;
-  for (let i = 0; i < lower.length && out.length < 40; i++) {
-    const ch = lower[i];
-    const isAlnum = ch >= "a" && ch <= "z" || ch >= "0" && ch <= "9";
-    if (isAlnum) {
-      out += ch;
-      prevDash = false;
-      continue;
-    }
-    if (!prevDash && out.length > 0) {
-      out += "-";
-      prevDash = true;
-    }
-  }
-  if (out.endsWith("-")) out = out.slice(0, -1);
-  return out;
-}
-const latestSegment = /* @__PURE__ */ new WeakMap();
-function mountPreviewFrame(element, fallback) {
-  const pane = element.querySelector('.aparte-art-card__pane[data-pane="preview"]');
-  if (!pane || pane.querySelector("iframe")) return;
-  const segment = latestSegment.get(element) ?? fallback;
-  const kind = segment.artifactType || deriveArtifactKind(segment.mimeType ?? "", "text");
-  if (!PREVIEWABLE_KINDS.has(kind)) return;
-  const title = segment.title?.trim() || labelForKind(kind);
-  const build = contextConfig().getArtifactPreviewBuilder() ?? buildSafePreviewDocument;
-  const srcdoc = build(kind, stripCodeFences(segment.content || ""), title);
-  pane.innerHTML = `<iframe class="aparte-art-card__frame" sandbox="allow-scripts" csp="${escapeAttr(PREVIEW_CSP)}" referrerpolicy="no-referrer" loading="lazy" title="${escapeAttr(title)}" srcdoc="${escapeAttr(srcdoc)}"></iframe>`;
-}
 const registries = /* @__PURE__ */ new WeakMap();
 function registryFor(config) {
   let reg = registries.get(config);
@@ -3352,7 +2912,6 @@ function installDefaultRenderersOnce(config = contextConfig()) {
     if (!reg.renderers.has(renderer.type)) reg.renderers.set(renderer.type, renderer);
   }
   injectRendererStyles(config);
-  installArtifactReadyHook();
 }
 function unregisterSegmentRenderer(type, config = contextConfig()) {
   registryFor(config).renderers.delete(type);
@@ -3402,15 +2961,13 @@ function registerDefaultRenderers(config = contextConfig()) {
     if (!reg.renderers.has(renderer.type)) registerSegmentRenderer(renderer, config);
   }
   injectRendererStyles(config);
-  installArtifactReadyHook();
 }
 const DEFAULT_RENDERERS = [
   textRenderer,
   thinkingRenderer,
   codeRenderer,
   errorRenderer,
-  toolCallRenderer,
-  artifactRenderer
+  toolCallRenderer
 ];
 const OPEN_TOOL_STATUSES = /* @__PURE__ */ new Set(["pending", "awaiting-approval"]);
 const ACTIVITY_KEYS = ["content", "output", "result"];
@@ -3733,6 +3290,37 @@ class AparteConversationManager {
     }
     this._notify();
   }
+  /**
+   * Pin a conversation, which the list shows in its "Pinned" group first. Metadata
+   * only, like archive: `updatedAt` keeps the conversation's real chronological slot
+   * for the day it is unpinned. An adapter that has `pin()` gets the call; one that
+   * does not gets the whole record through `save()`.
+   */
+  async pin(id) {
+    const conv = this._find(id);
+    if (!conv) return;
+    const updated = { ...conv, pinnedAt: Date.now() };
+    this._replace(updated);
+    if (this._adapter.pin) {
+      await this._adapter.pin(id);
+    } else {
+      await this._adapter.save(updated);
+    }
+    this._notify();
+  }
+  /** Unpin a conversation. Metadata only — see `pin()`. */
+  async unpin(id) {
+    const conv = this._find(id);
+    if (!conv) return;
+    const updated = { ...conv, pinnedAt: void 0 };
+    this._replace(updated);
+    if (this._adapter.unpin) {
+      await this._adapter.unpin(id);
+    } else {
+      await this._adapter.save(updated);
+    }
+    this._notify();
+  }
   /** Update the title manually. The full input is preserved — UI surfaces
    *  (sidebar list, topbar) are responsible for visual truncation via CSS
    *  (`min-w-0` + `truncate`). Auto-titles produced internally by
@@ -3807,6 +3395,32 @@ class AparteConversationController {
   _onMessageAborted = null;
   _onSelectConversation = null;
   _unsubscribeManager = null;
+  /** The manager the subscription above is on, so a replaced manager is re-subscribed. */
+  _subscribedTo = null;
+  /** Between bind() and unbind(): the only time a manager subscription may be installed. */
+  _bound = false;
+  /**
+   * React to an external mutation of the manager (another component deleting or
+   * archiving the active conversation). Without this the binding would keep
+   * showing a phantom history for an id the manager no longer knows about.
+   */
+  _onManagerChanged = (convs) => {
+    if (!this._activeId) return;
+    const stillExists = convs.some((c) => c.id === this._activeId && !c.archivedAt);
+    if (!stillExists) {
+      if (this._isStreaming) {
+        try {
+          window.dispatchEvent(new CustomEvent("aparte-abort", {
+            detail: { targetId: this._binding.hostId }
+          }));
+        } catch {
+        }
+        this._isStreaming = false;
+      }
+      this._activeId = null;
+      this._binding.clearMessages();
+    }
+  };
   constructor(binding, options = {}) {
     this._binding = binding;
     this._options = options;
@@ -3823,10 +3437,17 @@ class AparteConversationController {
    * conversation lifecycle yet.
    */
   _manager() {
-    if (this._options.manager) return this._options.manager;
-    const scoped = resolveConfig(this._binding.host);
-    const manager = scoped.getConversationManager();
-    if (!manager) this._warnManagerOnTheWrongConfig(scoped);
+    const manager = this._options.manager ?? (() => {
+      const scoped = resolveConfig(this._binding.host);
+      const m = scoped.getConversationManager();
+      if (!m) this._warnManagerOnTheWrongConfig(scoped);
+      return m;
+    })();
+    if (manager && this._bound && manager !== this._subscribedTo) {
+      this._unsubscribeManager?.();
+      this._subscribedTo = manager;
+      this._unsubscribeManager = manager.subscribe(this._onManagerChanged);
+    }
     return manager;
   }
   /**
@@ -3905,32 +3526,16 @@ class AparteConversationController {
     if (typeof window !== "undefined") {
       window.addEventListener("aparte-select-conversation", this._onSelectConversation);
     }
-    const manager = this._manager();
-    if (manager) {
-      this._unsubscribeManager = manager.subscribe((convs) => {
-        if (!this._activeId) return;
-        const stillExists = convs.some((c) => c.id === this._activeId && !c.archivedAt);
-        if (!stillExists) {
-          if (this._isStreaming) {
-            try {
-              window.dispatchEvent(new CustomEvent("aparte-abort", {
-                detail: { targetId: this._binding.hostId }
-              }));
-            } catch {
-            }
-            this._isStreaming = false;
-          }
-          this._activeId = null;
-          this._binding.clearMessages();
-        }
-      });
-    }
+    this._bound = true;
+    this._manager();
     return () => this.unbind();
   }
   /** Detach event listeners. */
   /** Release handle for the hydration-retry subscription (see setConversationId). */
   _stopHydrationRetry = null;
   unbind() {
+    this._bound = false;
+    this._subscribedTo = null;
     this._persistActive();
     this._stopHydrationRetry?.();
     this._stopHydrationRetry = null;
@@ -4083,6 +3688,11 @@ class AparteConversationController {
     }
     const wasActiveId = this._activeId;
     let convId = wasActiveId ?? manager.activeId;
+    if (convId && this._activeId === null && this._ensureInFlight) {
+      await this._ensureInFlight.catch(() => {
+      });
+      convId = this._activeId ?? convId;
+    }
     if (!convId) {
       if (!this._ensureInFlight) {
         const text = (userMsg.content ?? "").toString().trim() || "New Chat";
@@ -4106,7 +3716,7 @@ class AparteConversationController {
   }
 }
 function cssEscape(value) {
-  return value.replace(/["\\]/g, "\\$&");
+  return value.replace(/["\\]/g, "\\$&").replace(/[\n\r\f]/g, (c) => `\\${c.charCodeAt(0).toString(16)} `);
 }
 const MAX_SIBLING_RETRIES = 6;
 class AparteChatHost {
@@ -4205,6 +3815,7 @@ class AparteChatHost {
     if (this._streamingId === id) return;
     this._streamingId = id;
     this.binding.onStreamingChange?.(id);
+    this._vp()?.setTranscriptBusy?.(id !== null);
   }
   // ── conversation ───────────────────────────────────────────────────────
   /** Load / switch the active conversation via the controller. */
@@ -4231,10 +3842,10 @@ class AparteChatHost {
       },
       appendMessage: (msg) => this.appendMessage(msg),
       getMessages: () => this.binding.getMessages(),
-      clearMessages: () => {
+      clearMessages: (options) => {
         this._beginConversationSwap();
         this.binding.setMessages([]);
-        this._vp()?.clearAll?.();
+        this._vp()?.clearAll?.(options);
       },
       exportTree: () => {
         this.syncRepoFromMessages();
@@ -4293,6 +3904,7 @@ class AparteChatHost {
         return acc;
       }, [])
     } : message;
+    this._vp()?.addMessage?.(stored);
     this.binding.setMessages([...this.binding.getMessages(), stored]);
     this.binding.onMessageAppended?.(stored);
   }
@@ -4480,11 +4092,17 @@ class AparteChatHost {
   getMessages() {
     return this.binding.getMessages();
   }
-  /** Clear all messages + reset viewport state. */
-  clearMessages() {
+  /**
+   * Clear all messages + reset viewport state. The option travels to the viewport
+   * untouched: a compaction passes `{ revokeAttachments: false }` because it re-appends
+   * the turns it keeps and revokes the dropped ones' object URLs itself — under a
+   * framework wrapper this bridge used to drop the argument, and every surviving
+   * attachment came back broken.
+   */
+  clearMessages(options) {
     this._beginConversationSwap();
     this.binding.setMessages([]);
-    this._vp()?.clearAll?.();
+    this._vp()?.clearAll?.(options);
   }
   /** Create a new branch from a message (returns the new sibling index). */
   addBranch(messageId) {
@@ -4698,6 +4316,7 @@ class AparteChatHost {
     host["addSiblingOf"] = (id, m) => this.addSiblingOf(id, m);
     host["truncateFrom"] = (id) => this.truncateFrom(id);
     host["truncateResponsesAfter"] = (id) => this.truncateResponsesAfter(id);
+    host["clearAll"] = (options) => this.clearMessages(options);
   }
   _installLifecycleListeners(host) {
     const onStart = (e) => {
@@ -4765,69 +4384,24 @@ function dispatchLifecycleEvent(target, name, detail) {
   const stamped = detail && typeof detail === "object" ? { targetId: id, ...detail } : detail;
   target.dispatchEvent(new CustomEvent(name, { bubbles: true, composed: true, detail: stamped }));
 }
-function dispatchArtifactLifecycle(target, messageId, segment, progress, isFinal) {
-  const id = segment.id;
-  const content = segment.content ?? "";
-  if (progress.get(id) === void 0) {
-    target.dispatchEvent(new CustomEvent("aparte-artifact-start", {
-      bubbles: true,
-      composed: true,
-      detail: {
-        messageId,
-        segmentId: id,
-        mimeType: segment.mimeType,
-        artifactType: segment.artifactType,
-        title: segment.title
-      }
-    }));
-    progress.set(id, 0);
-  }
-  const lastLen = progress.get(id) ?? 0;
-  if (content.length > lastLen) {
-    target.dispatchEvent(new CustomEvent("aparte-artifact-delta", {
-      bubbles: true,
-      composed: true,
-      detail: { segmentId: id, chunk: content.slice(lastLen) }
-    }));
-    progress.set(id, content.length);
-  }
-  if (isFinal) {
-    target.dispatchEvent(new CustomEvent("aparte-artifact-ready", {
-      bubbles: true,
-      composed: true,
-      detail: {
-        messageId,
-        segmentId: id,
-        mimeType: segment.mimeType,
-        artifactType: segment.artifactType,
-        title: segment.title,
-        content
-      }
-    }));
-  }
-}
 function createStreamAdapter(opts) {
-  const { target, config, messageId, artifactHint } = opts;
-  let parser = new AparteStreamParser();
+  const { target, config, messageId } = opts;
+  let parser = new AparteStreamParser({ blocks: config.getStreamBlocks() });
   let streaming = /* @__PURE__ */ new Set();
   let thinkingId = null;
   let thinkingContent = "";
   let thinkingCollapsed = false;
-  let artifactProgress = /* @__PURE__ */ new Map();
-  let artifactPromoted = false;
   return (e) => {
     switch (e.type) {
       case "run-start":
         target.updateMessage?.(messageId, { status: "streaming" });
         break;
       case "turn-start":
-        parser = new AparteStreamParser();
+        parser = new AparteStreamParser({ blocks: config.getStreamBlocks() });
         streaming = /* @__PURE__ */ new Set();
         thinkingId = null;
         thinkingContent = "";
         thinkingCollapsed = false;
-        artifactProgress = /* @__PURE__ */ new Map();
-        artifactPromoted = false;
         break;
       case "thinking-delta": {
         thinkingContent += e.delta;
@@ -4853,90 +4427,33 @@ function createStreamAdapter(opts) {
           thinkingCollapsed = true;
         }
         const result = parser.parse(e.delta);
-        for (let segment of result.segments) {
-          if (artifactHint && !artifactPromoted && segment.type === "code") {
-            const codeSeg = segment;
-            const promoted = {
-              id: codeSeg.id,
-              type: "artifact",
-              mimeType: artifactHint.mimeType,
-              artifactType: artifactHint.kind,
-              title: codeSeg.filename ?? artifactHint.kind,
-              content: codeSeg.content
-            };
-            segment = promoted;
-            artifactPromoted = true;
-          }
+        for (const segment of result.segments) {
           if (!streaming.has(segment.id)) {
             target.addSegment?.(segment);
             streaming.add(segment.id);
           } else if ("content" in segment) {
             target.updateSegment?.(segment.id, segmentContentUpdate(segment));
           }
-          if (segment.type === "artifact") {
-            dispatchArtifactLifecycle(target, messageId, segment, artifactProgress, true);
-          }
         }
         const active = parser.getState().activeSegment;
         if (active) {
           if (!streaming.has(active.id)) {
             target.addSegment?.(active);
             streaming.add(active.id);
-            if (active.type === "artifact") {
-              dispatchArtifactLifecycle(target, messageId, active, artifactProgress, false);
-            }
           } else {
             target.updateSegment?.(active.id, segmentContentUpdate(active));
-            if (active.type === "artifact") {
-              dispatchArtifactLifecycle(target, messageId, active, artifactProgress, false);
-            }
           }
         } else if (result.segments.length === 0) ;
         break;
       }
       case "text-flush": {
         const finals = parser.finalize();
-        if (artifactHint && !artifactPromoted) {
-          const codeIdx = finals.findIndex((s) => s.type === "code");
-          if (codeIdx !== -1) {
-            const codeSeg = finals[codeIdx];
-            const promoted = {
-              id: codeSeg.id,
-              type: "artifact",
-              mimeType: artifactHint.mimeType,
-              artifactType: artifactHint.kind,
-              title: codeSeg.filename ?? artifactHint.kind,
-              content: codeSeg.content
-            };
-            finals[codeIdx] = promoted;
-            artifactPromoted = true;
-            if (streaming.has(promoted.id)) {
-              target.updateSegment?.(promoted.id, promoted);
-            }
-          }
-        }
         for (const s of finals) {
           if (!streaming.has(s.id)) target.addSegment?.(s);
           else if ("content" in s) target.updateSegment?.(s.id, segmentContentUpdate(s));
-          if (s.type === "artifact") {
-            dispatchArtifactLifecycle(target, messageId, s, artifactProgress, true);
-          }
         }
         break;
       }
-      case "artifact-ready": {
-        const seg = {
-          id: e.id,
-          type: "artifact",
-          mimeType: e.mimeType,
-          artifactType: e.kind,
-          title: e.title,
-          content: e.content
-        };
-        target.addSegment?.(seg);
-        dispatchArtifactLifecycle(target, messageId, seg, artifactProgress, true);
-        break;
-      }
       case "tool-start": {
         const toolSeg = {
           id: `tool-${e.toolCallId}`,
@@ -4965,11 +4482,18 @@ function createStreamAdapter(opts) {
         target.updateSegment?.(`tool-${e.toolCallId}`, { status: "rejected", result: e.reason });
         break;
       case "tool-resolved":
-        target.updateSegment?.(`tool-${e.toolCallId}`, { status: "resolved", result: e.result });
+        target.updateSegment?.(`tool-${e.toolCallId}`, {
+          status: "resolved",
+          result: e.result,
+          ...e.structuredResult !== void 0 ? { structuredResult: e.structuredResult } : {}
+        });
         break;
       case "tool-aborted":
         target.updateSegment?.(`tool-${e.toolCallId}`, { status: "aborted" });
         break;
+      case "tool-failed":
+        target.updateSegment?.(`tool-${e.toolCallId}`, { status: "failed", result: e.error });
+        break;
       case "turn-limit-exceeded":
         if (e.scope === "global") {
           target.addSegment?.({
@@ -5042,16 +4566,25 @@ function el$1(tag, className, text) {
   if (text != null) node.textContent = text;
   return node;
 }
-function optionBody(label, description) {
+function optionBody(label, description, recommended) {
   const body = el$1("span", "aparte-elic-option-body");
-  body.appendChild(el$1("span", "aparte-elic-option-title", label));
+  const title = el$1("span", "aparte-elic-option-title", label);
+  if (recommended) {
+    const badge = el$1(
+      "span",
+      "aparte-tag aparte-tag--sm aparte-elic-option-badge",
+      contextConfig().t("elicitationRecommended") || "Recommended"
+    );
+    title.append(" ", badge);
+  }
+  body.appendChild(title);
   if (description) body.appendChild(el$1("span", "aparte-elic-option-desc", description));
   return body;
 }
 function commandOption(label, description, recommended) {
   const button = el$1("button", "aparte-btn aparte-btn--block aparte-btn--surface aparte-elic-option aparte-elic-option--command" + (recommended ? " aparte-elic-option--recommended" : ""));
   button.type = "button";
-  button.appendChild(optionBody(label, description));
+  button.appendChild(optionBody(label, description, recommended));
   return button;
 }
 function fieldHeader(parent, field, skipTitle) {
@@ -5093,7 +4626,7 @@ function buildEnumField(field, onChange, fallbackLabel, settle) {
     control.name = name;
     control.value = value;
     if (defaults.has(value)) control.checked = true;
-    row.append(control, optionBody(label, description));
+    row.append(control, optionBody(label, description, recommended));
     return row;
   };
   for (const opt of field.options) {
@@ -5416,27 +4949,27 @@ function buildPanel(message, schema, onChange) {
       chips.forEach((chip, i) => {
         chip.setAttribute("aria-selected", String(i === current));
         chip.tabIndex = i === current ? 0 : -1;
-        chip.toggleAttribute("data-answered", fields[i].field.isComplete());
+        const answered = fields[i].field.isComplete();
+        chip.toggleAttribute("data-answered", answered);
+        const mark = chip.querySelector(".aparte-elic-step__mark");
+        if (answered && !mark) {
+          const glyph = el$1("span", "aparte-elic-step__mark");
+          glyph.setAttribute("aria-hidden", "true");
+          glyph.innerHTML = cfg.getIcon("check");
+          chip.prepend(glyph);
+        } else if (!answered && mark) {
+          mark.remove();
+        }
       });
     };
     show(0);
-    const last = () => current === fields.length - 1;
     return {
       ...api,
-      focus: () => fields[current]?.field.focus(),
-      mode: () => last() ? "submit" : "advance",
-      // Advancing needs only THIS question answered; submitting needs them all,
-      // which is what stops the last question from accepting a form with a hole
-      // in it.
-      canProceed: () => last() ? isComplete() : !!fields[current]?.field.isComplete(),
-      proceed: () => {
-        if (last()) return;
-        show(current + 1);
-        fields[current]?.field.focus();
-      }
+      focus: () => fields[current]?.field.focus()
     };
   }
-  const field = buildField(schema, onChange, asked, void 0, settle);
+  const answerOnClick = contextConfig().getElicitationOptions().answerOnClick;
+  const field = buildField(schema, onChange, asked, void 0, answerOnClick ? settle : void 0);
   body.appendChild(field.el);
   return {
     el: panel,
@@ -5451,18 +4984,30 @@ function buildPanel(message, schema, onChange) {
     onSettle
   };
 }
+let labelSeq = 0;
 function el(tag, className, text) {
   const node = document.createElement(tag);
   if (className) node.className = className;
   if (text != null) node.textContent = text;
   return node;
 }
-function buildApprovalPanel(message, options, onChange) {
+function buildApprovalPanel(message, options, onChange, details) {
   const cfg = contextConfig();
   const panel = el("div", "aparte-elic-panel aparte-approval-panel");
   const askText = () => typeof message === "function" ? message() : message;
   const ask = askText() ? el("p", "aparte-elic-message", askText()) : null;
   if (ask) panel.appendChild(ask);
+  let argsLabel = null;
+  if (details) {
+    argsLabel = el("div", "aparte-approval-args-label", cfg.t("approvalArgsLabel"));
+    argsLabel.id = "aparte-approval-args-" + ++labelSeq;
+    const pre = el("pre", "aparte-approval-args");
+    pre.textContent = details;
+    pre.setAttribute("role", "group");
+    pre.setAttribute("aria-labelledby", argsLabel.id);
+    pre.tabIndex = 0;
+    panel.append(argsLabel, pre);
+  }
   const dismiss = el("div", "aparte-elic-dismiss");
   panel.appendChild(dismiss);
   let settle = null;
@@ -5477,11 +5022,13 @@ function buildApprovalPanel(message, options, onChange) {
   row.setAttribute("aria-label", cfg.t("approvalOptionsLabel"));
   const labelled = [];
   const textOf = (option) => typeof option.label === "function" ? option.label() : option.label;
+  const descriptionOf = (option) => typeof option.description === "function" ? option.description() : option.description;
+  const bodyOf = (option) => optionBody(textOf(option), descriptionOf(option));
   for (const option of options) {
     const tone = option.tone ?? "affirm";
     const button = el("button", `aparte-btn aparte-btn--block aparte-btn--surface aparte-approval-option aparte-approval-option--${tone}`);
     button.type = "button";
-    button.textContent = textOf(option);
+    button.appendChild(bodyOf(option));
     button.addEventListener("click", () => fire({ option: option.value }));
     row.appendChild(button);
     labelled.push({ button, option });
@@ -5512,26 +5059,26 @@ function buildApprovalPanel(message, options, onChange) {
       instruction.setAttribute("aria-label", label);
       row.setAttribute("aria-label", now.t("approvalOptionsLabel"));
       if (ask) ask.textContent = askText();
-      for (const { button, option } of labelled) button.textContent = textOf(option);
+      if (argsLabel) argsLabel.textContent = now.t("approvalArgsLabel");
+      for (const { button, option } of labelled) button.replaceChildren(bodyOf(option));
     }
   };
 }
 function requestUserInput(request) {
   return resolveConfig(request.target ?? null).requestUserInput(request);
 }
+const COMPACTION_PREAMBLE = "The earlier part of this conversation was compacted. This is a summary of what came before; continue from it.";
 class AparteClient {
   _boundHandler = null;
   _boundAbortHandler = null;
-  _boundCompactHandler = null;
   _boundRetryHandler = null;
   _boundEditHandler = null;
-  _activeToolControllers = /* @__PURE__ */ new Set();
   _isAborted = false;
   /**
    * Does this window event belong to this client?
    *
-   * One rule for all five handlers, because it used to be four near-copies and
-   * one omission: `aparte-compact` had no guard at all, so in the two-client
+   * One rule for all four handlers, because it used to be near-copies and
+   * one omission: `aparte-compact` (answered here until 0.16.0) had no guard at all, so in the two-client
    * layout the JSDoc documents, a single compact event made BOTH clients run —
    * two paid summarisation calls against whichever chat the DOM scan found
    * first, and a global reset that wiped the other conversation.
@@ -5553,8 +5100,6 @@ class AparteClient {
   }
   /** Aborts the in-flight vendor/transport fetch when the user stops a stream. */
   _streamController = null;
-  /** Aborts an in-flight `compact()` summarisation — its own slot, see `compact`. */
-  _compactController = null;
   options;
   /** Config read by this client — an instance config, or the global default. */
   _config;
@@ -5579,18 +5124,15 @@ class AparteClient {
    * erased an abort that arrived while the user was still waiting for a large attachment
    * to be read.
    *
-   * Cancelling the previous turn's tool controllers used to happen only on `aparte-send`.
-   * Retry and edit reset the flag and left them running, so a tool handler from the turn
-   * being superseded stayed alive — with its timeout still counting — while its reply was
-   * already off the active path. A cold audit found the asymmetry; three callers, one
-   * rule, no third copy to fall out of step.
+   * The superseded turn's TOOL handlers are not cancelled here, and do not need a
+   * registry of their own: `_streamTurn` aborts the previous `_streamController`, and
+   * the engine links every tool handler's controller to that run signal
+   * (`invokeToolHandler`), so cutting the stream cuts its tools. A `Set<AbortController>`
+   * used to sit here for that job and was never added to — three lines of loop over an
+   * empty set, plus a paragraph describing a cancellation the method did not perform.
    */
   _beginUserTurn() {
     this._isAborted = false;
-    for (const controller of this._activeToolControllers) {
-      controller.abort();
-    }
-    this._activeToolControllers.clear();
   }
   /**
    * Sets up the event listeners.
@@ -5623,14 +5165,6 @@ class AparteClient {
       };
     }
     window.addEventListener("aparte-abort", this._boundAbortHandler);
-    if (!this._boundCompactHandler) {
-      this._boundCompactHandler = (e) => {
-        if (!this._isForThisInstance(e)) return;
-        const detail = e.detail;
-        void this.compact(detail?.targetId);
-      };
-    }
-    window.addEventListener("aparte-compact", this._boundCompactHandler);
     if (!this._boundRetryHandler) {
       this._boundRetryHandler = (e) => {
         const evt = e;
@@ -5660,10 +5194,6 @@ class AparteClient {
       window.removeEventListener("aparte-abort", this._boundAbortHandler);
       this._boundAbortHandler = null;
     }
-    if (this._boundCompactHandler) {
-      window.removeEventListener("aparte-compact", this._boundCompactHandler);
-      this._boundCompactHandler = null;
-    }
     if (this._boundRetryHandler) {
       window.removeEventListener("aparte-retry", this._boundRetryHandler);
       this._boundRetryHandler = null;
@@ -5680,11 +5210,6 @@ class AparteClient {
   abort() {
     this._isAborted = true;
     this._streamController?.abort();
-    this._compactController?.abort();
-    for (const controller of this._activeToolControllers) {
-      controller.abort();
-    }
-    this._activeToolControllers.clear();
   }
   /*
    * Two docblocks stood here, both describing `_awaitToolDecision` — the method
@@ -5707,9 +5232,14 @@ class AparteClient {
    * one queue, one panel slot, one teardown, and the same behaviour whether the
    * request came from a tool handler or from this gate.
    *
-   * The tool NAME is the question; the arguments stay in the transcript, on the pill
-   * this request is anchored to. A panel capped at 50vh cannot hold a diff or a plan,
-   * and the transcript is already scrollable, copyable and persisted.
+   * The tool NAME is the question and its ARGUMENTS are the body, because the
+   * arguments are what is being approved — a decision surface that names the act and
+   * hides its subject asks for a signature on a blank page. This paragraph used to
+   * say the opposite ("the arguments stay in the transcript"), and the guide beside
+   * it had always promised what the panel did not do. The transcript row stays the
+   * anchor; it is no longer the only place the call can be read. The panel is capped
+   * at 50vh and the block inside it scrolls, so a long input cannot push the options
+   * off the surface they are asked on.
    *
    * `aparte-tool-decision` is GONE with the buttons that dispatched it, and so is the
    * `document` listener that answered it. It existed only because a segment renderer
@@ -5732,6 +5262,11 @@ class AparteClient {
         const loc = this._config.getLocale();
         return (loc.approvalAsk ?? "Run {tool}?").replace("{tool}", event.name);
       },
+      // A plain string, not a function: the arguments are wire format — the JSON
+      // the model sent — and re-reading them on a language switch would produce
+      // exactly the same bytes. Same text the transcript row shows, from the same
+      // function, so the two surfaces cannot disagree about what is being run.
+      details: describeToolInput(event.input),
       // Functions, not strings, same as the question: these follow a language
       // switch while the request is open, which a resolved string cannot.
       options: [
@@ -5792,15 +5327,16 @@ class AparteClient {
       return;
     }
     dispatchLifecycleEvent(targetElement, "aparte-message-start", { messageId, role: "assistant" });
+    const streamController = new AbortController();
     try {
-      const usage = await this._streamLoop(targetElement, messageId, provider, baseRequest, authConfig);
-      if (this._isAborted) {
+      const usage = await this._streamLoop(targetElement, messageId, provider, baseRequest, authConfig, streamController);
+      if (this._isAborted || streamController.signal.aborted) {
         this._updateMessage(targetElement, messageId, { status: "completed" });
       } else {
         dispatchLifecycleEvent(targetElement, "aparte-message-done", { messageId, role: "assistant", usage });
       }
     } catch (error) {
-      if (this._isAborted) {
+      if (this._isAborted || streamController.signal.aborted) {
         dispatchLifecycleEvent(targetElement, "aparte-message-aborted", { messageId });
         this._updateMessage(targetElement, messageId, { status: "completed" });
         return;
@@ -5809,116 +5345,6 @@ class AparteClient {
       this._handleLifecycleError(targetElement, messageId, aparteError);
     }
   }
-  /**
-   * Compact the current conversation: summarize all messages via the AI,
-   * clear the viewport, then inject the summary as a single context message.
-   *
-   * Triggered programmatically or by dispatching `window.dispatchEvent(new CustomEvent('aparte-compact'))`.
-   * Dispatches `aparte-compact-done` on window when complete, or `aparte-compact-error` on failure.
-   */
-  async compact(targetId) {
-    let target = this._resolveTarget(targetId);
-    if (target && typeof target.getMessages !== "function") target = null;
-    if (!target) {
-      window.dispatchEvent(new CustomEvent("aparte-compact-error", { detail: { error: "No aparte-chat target found" } }));
-      return;
-    }
-    const messages = target.getMessages?.() ?? [];
-    if (messages.length === 0) {
-      window.dispatchEvent(new CustomEvent("aparte-compact-done", { detail: { skipped: true } }));
-      return;
-    }
-    const selector = this.options.compactionSelector ?? ((m) => ({ keep: [], drop: m }));
-    const { keep, drop } = selector(messages);
-    if (drop.length === 0) {
-      window.dispatchEvent(new CustomEvent("aparte-compact-done", { detail: { skipped: true } }));
-      return;
-    }
-    const config = this._config.getModelConfig();
-    const providerId = config.defaultProvider;
-    if (!providerId) {
-      window.dispatchEvent(new CustomEvent("aparte-compact-error", { detail: { error: "No provider configured" } }));
-      return;
-    }
-    const provider = this._config.getAIProvider(providerId);
-    if (!provider) {
-      window.dispatchEvent(new CustomEvent("aparte-compact-error", { detail: { error: `Provider '${providerId}' not found` } }));
-      return;
-    }
-    window.dispatchEvent(new CustomEvent("aparte-compact-start"));
-    try {
-      const authConfig = await this._resolveAuth(providerId);
-      const historyMessages = drop.filter((m) => m.role === "user" || m.role === "assistant" && m.status === "completed").map((m) => ({
-        role: m.role,
-        content: this._extractText(m)
-      })).filter((m) => contentToText(m.content).length > 0);
-      const summarizeRequest = {
-        messages: [
-          {
-            role: "system",
-            content: "You are a conversation summarizer. Create a concise but complete summary of the conversation below. Capture: key topics, conclusions, decisions, ongoing tasks, and any context needed to continue the conversation. Write in third person. Be factual and brief. No preamble, just the summary."
-          },
-          ...historyMessages,
-          {
-            role: "user",
-            content: "Please summarize this conversation."
-          }
-        ],
-        modelId: config.defaultModel || "",
-        stream: false
-      };
-      const compactController = new AbortController();
-      this._compactController = compactController;
-      const response = await this._config.getTransport().chat(
-        provider,
-        summarizeRequest,
-        authConfig,
-        { providerId: provider.id, signal: compactController.signal }
-      );
-      let summary;
-      if (typeof response === "string") {
-        summary = response;
-      } else {
-        const reader = response.getReader();
-        const chunks = [];
-        while (true) {
-          const { done, value } = await reader.read();
-          if (done) break;
-          if (value.type === "text") chunks.push(value.delta);
-        }
-        reader.releaseLock();
-        summary = chunks.join("");
-      }
-      if (!summary.trim()) {
-        throw new Error("Empty summary returned by model");
-      }
-      const clearAll = target.clearAll;
-      if (typeof clearAll === "function") clearAll.call(target);
-      else window.dispatchEvent(new CustomEvent("aparte-reset"));
-      await new Promise((resolve) => setTimeout(resolve, 50));
-      target.appendMessage?.({
-        id: uuid(),
-        role: "assistant",
-        // Through the locale, like every string the user reads — this was a
-        // hardcoded English title (with an emoji) in an otherwise localised
-        // transcript. The engine compactor's `summaryLabel` is a separate,
-        // per-call knob; this is the UI's own title.
-        content: `**${this._config.t("compactionSummaryTitle")}**
-
-${summary}`,
-        timestamp: Date.now(),
-        status: "completed"
-      });
-      for (const kept of keep) {
-        target.appendMessage?.(kept);
-      }
-      window.dispatchEvent(new CustomEvent("aparte-compact-done", { detail: { summary, kept: keep.length } }));
-    } catch (err) {
-      console.error("[AparteClient] compact() failed:", err);
-      const message = err instanceof Error ? err.message : String(err);
-      window.dispatchEvent(new CustomEvent("aparte-compact-error", { detail: { error: message } }));
-    }
-  }
   /**
    * Handle aparte-retry — add a sibling branch to the assistant message and re-stream
    * using the same conversation history minus the retried reply.
@@ -6104,9 +5530,11 @@ ${summary}`,
   _messagesToChatMessages(messages) {
     return messages.filter((m) => m.role === "user" || m.role === "assistant").map((m) => ({
       role: m.role,
-      content: this._extractText(m)
+      content: this._wireText(m)
     }));
   }
+  /** The "no model selected" warning is said once per client, not once per dropped send. */
+  _warnedNoModel = false;
   async _handleSend(event) {
     const { content, modelId, providerId: explicitProviderId } = event.detail;
     if (this._config.getRequireModelSelection() && !this._config.hasSelectedModel() && !modelId) {
@@ -6161,6 +5589,12 @@ ${summary}`,
     const config = this._config.getModelConfig();
     const providerId = explicitProviderId || config.defaultProvider;
     if (!providerId) {
+      if (!this._warnedNoModel) {
+        this._warnedNoModel = true;
+        console.warn(
+          "[AparteClient] Send dropped: no model is selected. Call aparteGlobalConfig.setModelConfig({ defaultProvider, defaultModel }), mount <aparte-model-selector auto-select>, or register one provider with a single model — that one is selected on its own."
+        );
+      }
       this._handleLifecycleError(targetElement, messageId, new AparteError(
         "No provider selected. Please configure a provider.",
         AparteErrorCode.CONFIG_NO_PROVIDER
@@ -6234,9 +5668,21 @@ ${summary}`,
       return false;
     }).map((m) => ({
       role: m.role,
-      content: this._extractText(m)
+      content: this._wireText(m)
     })).filter((m) => m.content.length > 0);
   }
+  /**
+   * A message's text as the MODEL should read it — the one mapper both history
+   * paths use, so the compaction preamble cannot be applied on retry and edit and
+   * forgotten on the ordinary send, which is what the first review of this feature
+   * caught: the summary went out on every normal turn as something the user said.
+   */
+  _wireText(message) {
+    const text = this._extractText(message);
+    return message.compaction ? `${COMPACTION_PREAMBLE}
+
+${text}` : text;
+  }
   /**
    * What the model is told it said last turn — reconstructed from what was
    * RENDERED, not from the raw-text field.
@@ -6270,33 +5716,40 @@ ${summary}`,
    *
    * Fences and the language tag are kept. Without them the model re-reads its own
    * code as prose — which is how it starts explaining a snippet it believes it
-   * wrote in English. Artifacts are included for the same reason: dropping them
-   * made an artifact the model had just produced invisible on the very next turn,
-   * so it could not be asked to change the thing it had built.
+   * wrote in English.
+   *
+   * A type core does not know — a registered block grammar's (an artifact, a
+   * citation, a file), a consumer's custom segment — follows one rule: its
+   * `content` if it has one, else its `fallback`, else nothing. Dropping such a
+   * segment made a document the model had just produced invisible on the very next
+   * turn, so it could not be asked to change the thing it had built; there used to
+   * be an `artifact` branch here for exactly that, and the rule is what replaces it
+   * now that the artifact is a plugin's type like any other.
    *
-   * `thinking` stays out on purpose — it is the model's own scratchpad, and most
-   * APIs neither want it back nor bill for it kindly.
+   * `thinking` and `tool_call` stay out on purpose — the first is the model's own
+   * scratchpad, and most APIs neither want it back nor bill for it kindly; the
+   * second is already in the history as a call and a result.
    */
   _segmentsToText(segments) {
     if (!segments?.length) return "";
     const fence = "```";
     const parts = [];
     for (const segment of segments) {
-      const content = segment.content ?? "";
+      const content = segment.content;
       if (segment.type === "text") {
         if (content) parts.push(content);
       } else if (segment.type === "code") {
         const lang = segment.language ?? "";
         parts.push(`${fence}${lang}
-${content}
-${fence}`);
-      } else if (segment.type === "artifact") {
-        const title = segment.title ?? "artifact";
-        const kind = segment.artifactType ?? "";
-        parts.push(`${fence}${kind}
-<!-- artifact: ${title} -->
-${content}
+${content ?? ""}
 ${fence}`);
+      } else if (segment.type === "thinking" || segment.type === "tool_call" || segment.type === "error") {
+        continue;
+      } else if (typeof content === "string" && content) {
+        parts.push(content);
+      } else {
+        const fallback = segment.fallback;
+        if (fallback) parts.push(fallback);
       }
     }
     return parts.join("\n").trim();
@@ -6372,9 +5825,8 @@ ${content}
    * The turn's agent loop — the engine's `runStreamAgent` rendered through the core
    * adapter, or the runner a host injected — after the fetch-level abort bookkeeping.
    */
-  async _streamLoop(targetElement, messageId, provider, baseRequest, authConfig) {
+  async _streamLoop(targetElement, messageId, provider, baseRequest, authConfig, streamController = new AbortController()) {
     this._streamController?.abort();
-    const streamController = new AbortController();
     this._streamController = streamController;
     const runner = this.options.streamRunner ?? runStreamAgent;
     return this._runViaStreamRunner(runner, targetElement, messageId, provider, baseRequest, authConfig, streamController);
@@ -6390,12 +5842,10 @@ ${content}
    */
   async _runViaStreamRunner(streamRunner, targetElement, messageId, provider, baseRequest, authConfig, streamController) {
     const signal = streamController.signal;
-    const artifactHint = baseRequest._meta?.artifactHint;
     const adapter = createStreamAdapter({
       target: targetElement,
       config: this._config,
-      messageId,
-      artifactHint
+      messageId
     });
     const prefixSegments = baseRequest._meta?.["prefixSegments"];
     const emitter = (event) => {
@@ -6414,11 +5864,26 @@ ${content}
       const context = { target: targetElement, config: this._config };
       return (call, sig) => handler(call, sig, context);
     };
+    const hostOwnsDecision = Boolean(this.options.approvalResolver);
     const toolConfigLookup = (name) => {
       const tool = this._config.getTools().find((t) => t.name === name);
-      return tool ? { maxTurns: tool.maxTurns, needsApproval: tool.needsApproval } : void 0;
+      if (!tool) return void 0;
+      return {
+        maxTurns: tool.maxTurns,
+        needsApproval: hostOwnsDecision ? tool.needsApproval : (call) => {
+          const verdict = this._config.ruleOnToolCall(call).verdict;
+          return verdict === "allow" ? false : verdict;
+        }
+      };
     };
-    const approvalResolver = this.options.approvalResolver ?? ((call, sig) => this._askForApproval(call, sig, targetElement));
+    const approvalResolver = this.options.approvalResolver ?? (async (call, sig) => {
+      const ruling = this._config.ruleOnToolCall(call);
+      if (ruling.verdict === "allow") return { approved: true };
+      if (ruling.verdict === "deny") {
+        return { approved: false, reason: ruling.reason?.trim() || "Tool execution was refused by the approval policy." };
+      }
+      return this._askForApproval(call, sig, targetElement);
+    });
     const usage = await streamRunner({
       messageId,
       baseRequest,
@@ -6652,6 +6117,12 @@ class AparteMessageRepository {
         );
         continue;
       }
+      if (this._nodes.has(message.id)) {
+        console.warn(
+          `[AparteMessageRepository] import: message "${message.id}" repeats an id already in the snapshot — skipped.`
+        );
+        continue;
+      }
       this.addOrUpdateMessage(parentId, message);
     }
     if (exported.headId) {
@@ -6744,6 +6215,7 @@ const APARTE_DEFAULT_UI_EVENTS = [
   "aparte-feedback",
   "aparte-message-info",
   "aparte-branch-navigate",
+  "aparte-link-click",
   // <aparte-chat-viewport>
   "aparte-segment-update",
   "aparte-reset-done",
@@ -6753,11 +6225,26 @@ const APARTE_DEFAULT_UI_EVENTS = [
   "aparte-delete-conversation",
   "aparte-archive-conversation",
   "aparte-unarchive-conversation",
+  "aparte-rename-conversation",
+  "aparte-pin-conversation",
+  "aparte-unpin-conversation",
   // the select primitives
   "aparte-select-change",
   "aparte-select-open",
   "aparte-select-close",
-  "aparte-optgroup-toggle"
+  "aparte-optgroup-toggle",
+  // the shell and the transcript's own elements — the five the sweep found missing
+  "aparte-suggestion",
+  "aparte-context-threshold",
+  "aparte-scroll-rail-jump",
+  "aparte-sidebar-toggle",
+  "aparte-split-resize",
+  // the turn's lifecycle, dispatched on the HOST element by `dispatchLifecycleEvent`
+  "aparte-message-start",
+  "aparte-message-done",
+  "aparte-message-error",
+  "aparte-message-aborted",
+  "aparte-tool-approval-request"
 ];
 function applyElementProps(el2, props, transformValue = (value) => value) {
   for (const [key, value] of Object.entries(props)) {
@@ -6784,50 +6271,99 @@ function isAwaitingReply(message) {
   if (message.status === "streaming" || message.status === "pending") return true;
   return message.status === void 0 && message.role === "assistant" && !message.content?.trim() && !message.segments?.length;
 }
+const INSTALLED = Symbol.for("aparte.dialogTriggers");
+let pressTarget = null;
+let releaseTarget = null;
+function onPointerDown(event) {
+  pressTarget = event.target;
+  releaseTarget = null;
+}
+function onPointerUp(event) {
+  releaseTarget = event.target;
+}
+function onClick(event) {
+  const target = event.target;
+  if (!target?.closest) return;
+  const opener = target.closest("[data-aparte-dialog-open]");
+  if (opener) {
+    const id = opener.getAttribute("data-aparte-dialog-open");
+    const dialog = id ? document.getElementById(id) : null;
+    if (dialog instanceof HTMLDialogElement && !dialog.open) {
+      event.preventDefault();
+      dialog.showModal();
+    }
+    return;
+  }
+  const closer = target.closest("[data-aparte-dialog-close]");
+  if (closer) {
+    const dialog = closer.closest("dialog");
+    if (dialog instanceof HTMLDialogElement && dialog.open) {
+      event.preventDefault();
+      dialog.close(closer.getAttribute("data-aparte-dialog-close") ?? "");
+    }
+    return;
+  }
+  if (target instanceof HTMLDialogElement && target.open && target.classList.contains("aparte-dialog") && !target.hasAttribute("data-aparte-dialog-static")) {
+    const deliberate = pressTarget === target && releaseTarget === target;
+    pressTarget = null;
+    releaseTarget = null;
+    if (deliberate) target.close();
+  }
+}
+function installDialogTriggersOnce(doc = document) {
+  const marked = doc;
+  if (marked[INSTALLED]) return;
+  marked[INSTALLED] = true;
+  doc.addEventListener("pointerdown", onPointerDown, true);
+  doc.addEventListener("pointerup", onPointerUp, true);
+  doc.addEventListener("click", onClick);
+}
 export {
-  runWithConfig as $,
+  resolveConfig as $,
   APARTE_CONFIG_CHANGE as A,
   contextConfig as B,
-  createAparteChatHandler as C,
-  createStreamAdapter as D,
-  cssEscape as E,
-  declineDefaultRenderers as F,
-  defaultSanitizer as G,
-  detachConfig as H,
-  escapeAttr as I,
-  escapeHtml as J,
-  filesToAttachments as K,
-  getAllRenderers as L,
-  getSegmentRenderer as M,
-  installDefaultRenderersOnce as N,
-  isAwaitingReply as O,
-  isFormatAdapter as P,
-  isSafeUrl as Q,
-  isSegmentSettled as R,
-  parseAparteEventStream as S,
-  parseMarkdownToSegments as T,
-  populateBubbleFromMessage as U,
-  readableToAsyncIterable as V,
-  registerDefaultRenderers as W,
-  registerSegmentRenderer as X,
-  requestUserInput as Y,
-  resolveConfig as Z,
-  revokeAttachmentUrls as _,
+  copyText as C,
+  createAparteChatHandler as D,
+  createStreamAdapter as E,
+  cssEscape as F,
+  declineDefaultRenderers as G,
+  defaultSanitizer as H,
+  detachConfig as I,
+  escapeAttr as J,
+  escapeHtml as K,
+  filesToAttachments as L,
+  getAllRenderers as M,
+  getSegmentRenderer as N,
+  installDefaultRenderersOnce as O,
+  installDialogTriggersOnce as P,
+  isAwaitingReply as Q,
+  isFormatAdapter as R,
+  isSafeUrl as S,
+  isSegmentSettled as T,
+  parseAparteEventStream as U,
+  parseMarkdownToSegments as V,
+  populateBubbleFromMessage as W,
+  readableToAsyncIterable as X,
+  registerDefaultRenderers as Y,
+  registerSegmentRenderer as Z,
+  requestUserInput as _,
   APARTE_CONVERSATION_SCHEMA_VERSION as a,
-  segmentDuration as a0,
-  segmentTiming as a1,
-  subscribeConfigChange as a2,
-  unregisterSegmentRenderer as a3,
-  uuid as a4,
-  mergeSegmentUpdate as a5,
-  writeStreamedMarkdown as a6,
-  stampSegmentActivity as a7,
-  stampSegmentOnInsert as a8,
-  stampSegmentOnUpdate as a9,
-  renumberSegments as aa,
-  openSegmentIds as ab,
-  isTerminalStatus as ac,
-  adoptMessageSegments as ad,
+  revokeAttachmentUrls as a0,
+  runWithConfig as a1,
+  segmentDuration as a2,
+  segmentTiming as a3,
+  subscribeConfigChange as a4,
+  unregisterSegmentRenderer as a5,
+  uuid as a6,
+  mergeSegmentUpdate as a7,
+  writeStreamedMarkdown as a8,
+  stampSegmentActivity as a9,
+  stampSegmentOnInsert as aa,
+  stampSegmentOnUpdate as ab,
+  renumberSegments as ac,
+  openSegmentIds as ad,
+  isTerminalStatus as ae,
+  adoptMessageSegments as af,
   APARTE_DEFAULT_BUBBLE_ACTIONS as b,
   APARTE_DEFAULT_HOST_HANDLERS as c,
   APARTE_DEFAULT_ICON_FALLBACKS as d,
@@ -6854,4 +6390,4 @@ export {
   collectRendererStyles as y,
   contentToText as z
 };
-//# sourceMappingURL=is-awaiting-reply-BZ_iJ3s3.js.map
+//# sourceMappingURL=dialog-triggers-CVCxqKg3.js.map