sgiant-ai-widget 1.0.0

package/dist/labels.js

@@ -0,0 +1,232 @@
+/**
+ * Every string the widget's own chrome can show, and the host adapter that
+ * translates them.
+ *
+ * Its own module (#320) because it is read by three hosts and a parity test,
+ * and none of them wants the 5800-line widget closure to get at a string table.
+ * `WidgetLabels` being derived from this object is what makes a missing
+ * translation a TYPE error in each host rather than an English word appearing
+ * in a Turkish UI.
+ */
+/**
+ * SINGLE SOURCE for every user-facing string baked into the vanilla-DOM widget,
+ * with its English default. The widget can't call i18next, so the host passes a
+ * translated `labels` bag (built by `resolveWidgetLabels`); the widget falls back
+ * to these English defaults for any missing key. A `{token}` in a value is filled
+ * at runtime by the widget (single-brace so a host's i18next leaves it intact).
+ */
+export const WIDGET_LABELS = {
+    // Question cards — the assistant asking the human to decide.
+    questionConfirm: "Send",
+    questionPlaceholder: "Type your answer…",
+    questionSendFailed: "Couldn't send your answer — wait for the current reply to finish, then try again.",
+    // Header / bubble
+    openBubble: "Open {name}",
+    openBubbleUnread: "Open {name} — {count} unread",
+    panelAria: "{name} chat",
+    newChat: "New chat",
+    pastConversations: "Past conversations",
+    /** History-row spinner tooltip: this conversation has a reply in flight. */
+    threadAnswering: "Answering…",
+    /** Shown when the live stream drops mid-reply: the server finishes the turn
+     *  and the widget polls the thread until the reply lands. */
+    streamLostRecovering: "Connection lost — still working on the reply; it will appear here when ready.",
+    history: "History",
+    moreOptions: "More options",
+    more: "More",
+    expandChat: "Expand chat",
+    expand: "Expand",
+    restore: "Restore",
+    restoreChat: "Restore chat size",
+    closeChat: "Close chat",
+    conversation: "Conversation",
+    // "More" overflow menu
+    on: "On",
+    off: "Off",
+    downloadChat: "Download chat (.txt)",
+    flagConversation: "Flag this conversation",
+    flagConversationHint: "Flag this conversation for review",
+    flagSendFirst: "Send a message first — then you can flag this chat.",
+    flagPrompt: "Flag this conversation — why? (reason is logged for review)",
+    flagged: "🚩 Conversation flagged for review ✓",
+    flagFailed: "Couldn't flag: {msg}",
+    flagFailedGeneric: "please try again",
+    notificationSound: "Notification sound",
+    soundOnHint: "Chime when a reply arrives — click to mute",
+    soundOffHint: "Muted — click to enable the reply chime",
+    autoNavigate: "Auto-navigate",
+    autoNavOnHint: "Copilot opens pages for you — click to turn off",
+    autoNavOffHint: "Copilot asks before opening pages — click to turn on",
+    // Status bar (Copilot role + credits)
+    roleTalk: "Talk",
+    roleAnalytics: "Analytics",
+    creditsSuffix: " credits",
+    // Composer
+    askAnything: "Ask {name} anything…",
+    messageAria: "Message {name}",
+    send: "Send",
+    removeAttachment: "Remove {file}",
+    attachFile: "Attach a file",
+    attachFileHint: "Attach images, PDFs or documents",
+    // Live background-job card — a job the chat started and now watches. The
+    // titles are per known TYPE, with a neutral fallback for a type this build
+    // has never heard of (an AI-defined job type must still render).
+    jobTitleCoder: "Working on a code task",
+    jobTitleReport: "Generating the report",
+    jobTitleFallback: "Background job",
+    jobQueued: "Queued",
+    jobRunning: "Running",
+    jobDone: "Finished",
+    jobFailed: "Failed",
+    jobCancelled: "Cancelled",
+    jobCancel: "Cancel",
+    jobCancelling: "Cancelling…",
+    jobProgress: "{done} of {total}",
+    /** Used while the total is still unknown — a report learns it once planned. */
+    jobProgressOpen: "{done} so far",
+    jobOpenResult: "Open the result",
+    /** Toggle under the flow tail that reveals the job's full activity feed. */
+    jobFlowAll: "Show all {count} steps",
+    /** Shown INSTEAD of the step feed when the app pane is already showing this
+     *  run — see the collapse in renderJobCard. */
+    jobWatchingInPane: "Following along in the panel →",
+    /** Advanced view — the pane is showing a computed widget, not a route. */
+    paneBackToPage: "Back to the page",
+    paneShowingWidget: "Result",
+    jobUnreachable: "Still running in the background — check back shortly",
+    // Render STEPS. The runner writes its narration in English (it has no request
+    // locale), but each event also carries a machine `code`, so a Turkish chat can
+    // read the flow in Turkish instead of in the runner's English. An event whose
+    // code we have no label for falls back to the server's own sentence — which is
+    // why the set below can grow without the widget ever showing a blank line.
+    jobEvCancelled: "Cancelled",
+    jobEvCancelledBeforeStart: "Cancelled before it started",
+    jobEvInterrupted: "Interrupted by a restart — not retried automatically",
+    // Proposal confirm cards
+    // The SEVEN write tools that used to hit the generic English fallback
+    // ("Apply this change?") — including generate_report, the most expensive
+    // confirm in the product. The widget's contract is that visible copy lives
+    // here so a host can translate it; a `??` literal in the render path is
+    // outside that contract and untranslatable by construction.
+    /**
+     * The card title for a write proposal the host has not named.
+     *
+     * The fifteen sgiant-specific titles that sat beside this — and the six
+     * report-card labels — moved to @sgiant/ai-apply on 2026-09-02, along with
+     * the branches that used them. A package a stranger installs should not ship
+     * one company's tool vocabulary. Hosts pass their own via `proposalTitles`.
+     */
+    proposalGeneric: "Apply this change?",
+    // The generate_report confirm card. These were four hardcoded English lines
+    // in `proposalSummary` — on a card the user reads before spending minutes of
+    // model time, in a widget whose whole contract is that visible copy lives
+    // here so it can be translated.
+    artifactsTitle: "This chat's files:",
+    artifactSave: "Save",
+    artifactSaving: "Saving…",
+    apply: "Apply",
+    dismiss: "Dismiss",
+    applying: "Applying…",
+    applied: "Applied",
+    openReport: "Open the report",
+    tryAgain: "Try again",
+    // History panel
+    close: "Close",
+    loading: "Loading…",
+    noConversations: "No past conversations yet.",
+    untitledConversation: "Untitled conversation",
+    star: "Star this conversation",
+    unstar: "Unstar",
+    historyLoadFailed: "Couldn't load history — try again.",
+    bucketToday: "Today",
+    bucketYesterday: "Yesterday",
+    bucketWeek: "Earlier this week",
+    bucketMonth: "This month",
+    bucketOlder: "Older",
+    // Lead form / preview / action chips
+    submit: "Submit",
+    sending: "Sending…",
+    /** Why a form's Send, or a proposal card's Apply, refused to go through. */
+    requiredFields: "Please fill in the highlighted fields first.",
+    done: "Done ✓",
+    preview: "Preview",
+    otherOption: "+ Other…",
+    confirm: "Confirm",
+    cancel: "Cancel",
+    // Error state
+    errorSnag: "{name} hit a snag and couldn't answer. Please try again.",
+    reportIssue: "Report issue",
+    reporting: "Reporting…",
+    reported: "Reported ✓ — our team will look into it",
+    reportFailed: "Couldn't report — try later",
+    // Quality prompt (#299) — the widget ASKING, because the whole signal was
+    // passive on surfaces where the control was invisible or absent.
+    //
+    // The two triggers deliberately ask DIFFERENT questions. A slow answer that
+    // was excellent, prompted with "was this helpful?", teaches us "slow = bad",
+    // which we already knew. So a long wait asks about the WAIT, and a failed
+    // turn asks about the GOAL.
+    qualitySlowTitle: "That took a while — was the answer worth it?",
+    qualityFailedTitle: "That didn't work — what were you trying to do?",
+    qualityReasonPlaceholder: "Anything you'd add? (optional)",
+    qualityFailedPlaceholder: "What were you trying to do?",
+    qualitySend: "Send",
+    qualityDismiss: "No thanks",
+    qualityThanks: "Thanks — noted ✓",
+    // Free-token meter. Shown ONLY when `signupUrl` is set, i.e. exactly on the
+    // anonymous surfaces — the marketing visitor chat and the public demo — both
+    // of which serve Turkish. These three were hardcoded English, so a Turkish
+    // visitor read "60,000 free tokens left" under a Turkish conversation.
+    meterTokensLeft: "{count} free tokens left",
+    meterFreePreview: "Free preview",
+    meterUsedThisSession: "{count} used this session",
+    // Signup CTA (anonymous surfaces)
+    signupCta: "Sign up — 14 days free",
+    // Composed UI cards ([[ui:…]]) — the four states the widget colours. Any
+    // OTHER status the model writes is shown in its own words, untranslated,
+    // because only these four are ours to name.
+    uiStatusPending: "Waiting",
+    uiStatusRunning: "Working…",
+    uiStatusReady: "Ready",
+    uiStatusFailed: "Failed",
+    /** A tile whose media hasn't been produced yet — the space is deliberately
+     *  kept so the card doesn't reflow when the picture lands. */
+    uiMediaPending: "Not made yet",
+    /** A tile whose media id resolved to nothing (deleted, or not this account's).
+     *  Said plainly, because a blank tile reads as a broken product. */
+    uiMediaMissing: "Unavailable",
+    /** Carousel paging controls on a composed card. */
+    prev: "Previous",
+    next: "Next",
+    /** ACTION CHIPS — the in-chat "open this page / run this" affordances.
+     *  These were template literals built inline, so they had no key at all and
+     *  a host could not translate them however hard it tried: a fully Turkish
+     *  session still read "Opening Billing…", "Billing ✓", "Couldn't open
+     *  Billing". `{label}` is the action's own name, which the host localises. */
+    actionOpening: "Opening {label}…",
+    actionDone: "{label} ✓",
+    actionOpenFailed: "Couldn't open {label}",
+    actionRunFailed: "Couldn't run {label}",
+    actionRetry: "{label} — try again",
+    /** Outcomes of an action the HOST performed on the page behind the chat. */
+    actionShownOnPage: "Shown on the page",
+    actionDoneOnPage: "Done on the page",
+    actionPageFailed: "Couldn't do that on the page",
+    actionOpened: "Opened",
+    /** A thread the transcript endpoint would not return. */
+    threadOpenFailed: "Couldn't open that conversation.",
+};
+/**
+ * Build the widget's `labels` bag from a host translator (react-i18next's `t`).
+ * Each label resolves the `chatWidget.<key>` locale key, defaulting to the
+ * English string in WIDGET_LABELS. Call once per (re-)mount so the widget picks
+ * up the active language.
+ */
+export function resolveWidgetLabels(t) {
+    const out = {};
+    for (const k of Object.keys(WIDGET_LABELS)) {
+        out[k] = t(`chatWidget.${k}`, WIDGET_LABELS[k]);
+    }
+    return out;
+}
+//# sourceMappingURL=labels.js.map

package/dist/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"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"}

package/dist/limits.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The constants this widget used to import from `@sgiant/shared`, inlined.
+ *
+ * #306 requires the published core to have ZERO `@sgiant/*` runtime
+ * dependencies — a stranger installing the widget from npm cannot resolve a
+ * package that lives in our private registry, and three numbers are not a
+ * reason to make them try.
+ *
+ * BUT inlining is the exact move that created the bug `@sgiant/shared`'s
+ * `chat-attachment-limits.ts` was written to end: the client caps and the api's
+ * turn-time caps were four independent literals, so a 10 MB PNG passed every
+ * client check, uploaded fine, showed as a chip, and was silently dropped when
+ * the turn resolved it.
+ *
+ * So the copy is gated instead of trusted: a drift test in the host repo
+ * asserts every value here equals its `@sgiant/shared` original. The test is a
+ * monorepo devDependency, so it costs the published package nothing and still
+ * fails the build the moment the two drift.
+ *
+ * If you change a number here, change it in `@sgiant/shared` too — or rather,
+ * change it there and let the test tell you about this file.
+ */
+/** Attachments per message (composer slots AND turn-time resolution). */
+export declare const CHAT_ATTACHMENT_MAX_COUNT = 6;
+/** Client-side transport cap per file. */
+export declare const CHAT_ATTACHMENT_MAX_BYTES: number;
+/** Transport cap for an attached VIDEO or AUDIO file — much larger, because
+ *  25 MB is a document number and a 30-second 1080p phone clip is already past
+ *  it. A clip is stored as an asset and referenced BY ID, never sent as bytes. */
+export declare const CHAT_ATTACHMENT_MAX_AV_BYTES: number;
+/** The locale tags the host may pass. Was `import type { Locale }` from
+ *  `@sgiant/shared`; a type import erases at runtime but still puts the package
+ *  in the manifest, which is what publishing reads. */
+export type Locale = "en" | "tr";
+/**
+ * The six motion custom properties the stylesheet reads, previously
+ * `motionCssVars()` from `@sgiant/tokens`.
+ *
+ * Kept as a function with the same shape so the call site is unchanged, and
+ * gated by the same drift test.
+ */
+export declare function motionCssVars(): string;
+//# sourceMappingURL=limits.d.ts.map

package/dist/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAE1D;;kFAEkF;AAClF,eAAO,MAAM,4BAA4B,QAAoB,CAAC;AAE9D;;uDAEuD;AACvD,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjC;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAStC"}

package/dist/limits.js

@@ -0,0 +1,48 @@
+/**
+ * The constants this widget used to import from `@sgiant/shared`, inlined.
+ *
+ * #306 requires the published core to have ZERO `@sgiant/*` runtime
+ * dependencies — a stranger installing the widget from npm cannot resolve a
+ * package that lives in our private registry, and three numbers are not a
+ * reason to make them try.
+ *
+ * BUT inlining is the exact move that created the bug `@sgiant/shared`'s
+ * `chat-attachment-limits.ts` was written to end: the client caps and the api's
+ * turn-time caps were four independent literals, so a 10 MB PNG passed every
+ * client check, uploaded fine, showed as a chip, and was silently dropped when
+ * the turn resolved it.
+ *
+ * So the copy is gated instead of trusted: a drift test in the host repo
+ * asserts every value here equals its `@sgiant/shared` original. The test is a
+ * monorepo devDependency, so it costs the published package nothing and still
+ * fails the build the moment the two drift.
+ *
+ * If you change a number here, change it in `@sgiant/shared` too — or rather,
+ * change it there and let the test tell you about this file.
+ */
+/** Attachments per message (composer slots AND turn-time resolution). */
+export const CHAT_ATTACHMENT_MAX_COUNT = 6;
+/** Client-side transport cap per file. */
+export const CHAT_ATTACHMENT_MAX_BYTES = 25 * 1024 * 1024;
+/** Transport cap for an attached VIDEO or AUDIO file — much larger, because
+ *  25 MB is a document number and a 30-second 1080p phone clip is already past
+ *  it. A clip is stored as an asset and referenced BY ID, never sent as bytes. */
+export const CHAT_ATTACHMENT_MAX_AV_BYTES = 100 * 1024 * 1024;
+/**
+ * The six motion custom properties the stylesheet reads, previously
+ * `motionCssVars()` from `@sgiant/tokens`.
+ *
+ * Kept as a function with the same shape so the call site is unchanged, and
+ * gated by the same drift test.
+ */
+export function motionCssVars() {
+    return [
+        `--duration-fast: 150ms;`,
+        `--duration-base: 300ms;`,
+        `--duration-slow: 600ms;`,
+        `--ease-out: cubic-bezier(0.22, 1, 0.36, 1);`,
+        `--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);`,
+        `--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);`,
+    ].join("\n");
+}
+//# sourceMappingURL=limits.js.map

package/dist/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D;;kFAEkF;AAClF,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAO9D;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,yBAAyB;QACzB,yBAAyB;QACzB,yBAAyB;QACzB,6CAA6C;QAC7C,gDAAgD;QAChD,gDAAgD;KACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Minimal, dependency-free, XSS-safe Markdown → HTML for the embeddable chat
+ * widget's assistant bubbles — the FALLBACK renderer.
+ *
+ * In-app React hosts pass `renderMarkdown` (our real @sgiant/ui <Markdown>) and
+ * this is never used there. But the widget also ships as ZERO-dependency vanilla
+ * JS and embeds on third-party sites (the marketing onboarding bot), where React
+ * isn't available — so this covers the subset the assistant actually emits:
+ * headings, bold / italic / strikethrough, inline + fenced code, links, ordered
+ * / unordered lists, blockquotes, GFM tables, horizontal rules and paragraphs.
+ *
+ * SECURITY: every input is HTML-escaped BEFORE any markup is added, code spans
+ * are tokenised out (NUL-delimited sentinels, so they can't collide with text)
+ * before inline processing, and link URLs are sanitised (http/https/mailto or
+ * app-relative only). No raw HTML or `javascript:` URL can pass through — the
+ * model's output is untrusted text, never markup.
+ */
+/**
+ * Render a small, safe subset of Markdown to an HTML string, to be injected into
+ * a widget bubble whose descendant CSS styles the tags.
+ */
+export declare function renderMarkdown(src: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAmEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmJlD"}

package/dist/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"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"}

package/dist/message-chrome.d.ts

@@ -0,0 +1,45 @@
+import type { BranchNav } from "./replay";
+/**
+ * The two controls that hang off a single assistant message: the ‹n/m› branch
+ * navigator and the up/down vote pair.
+ *
+ * Both are pure DOM builders — they read no widget state and write none. They
+ * sat inside the 6,051-line closure only because that is where they were
+ * written (`#320`), and they are the shape that actually moves out of it: the
+ * measurement on that issue put them at two closure bindings each, against 56
+ * for `send()` and 28 for the job cluster.
+ *
+ * THE THREAD ID IS A GETTER, AND THAT IS THE WHOLE REASON THIS IS A FACTORY.
+ *
+ * `buildVoteButtons` reads the thread id inside the CLICK handler, not while
+ * building. In the closure that was automatic — `threadId` is a `let` the widget
+ * reassigns when the server names a thread, and a vote cast later reads whatever
+ * it holds then. Taking it as a plain parameter here would capture the value at
+ * BUILD time, so a message rendered before the thread was named would post its
+ * vote against the wrong id — or an empty one — and nothing would fail loudly:
+ * the request succeeds, the vote lands on nothing, and the quality signal
+ * `#299` exists to collect goes quietly missing.
+ *
+ * A getter keeps the read where it was. The rest of the dependencies are fixed
+ * for the widget's lifetime and are captured once, which is what lets both
+ * bodies move byte for byte.
+ */
+export declare function createMessageChrome(deps: {
+    /** Navigate to a sibling version. Called on click, so the reference is enough. */
+    switchBranch: (leaf: string) => void | Promise<void>;
+    /** Read the CURRENT thread id — see the note above; do not pass a value. */
+    getThreadId: () => string | undefined;
+    vote?: (input: {
+        threadId: string;
+        messageId: string;
+        value: 1 | -1 | 0;
+        model?: string;
+        reason?: string;
+    }) => Promise<void>;
+    voteUpLabel?: string;
+    voteDownLabel?: string;
+}): {
+    buildBranchNav: (branch: BranchNav) => HTMLElement;
+    buildVoteButtons: (messageId: string, model?: string) => HTMLElement;
+};
+//# sourceMappingURL=message-chrome.d.ts.map

package/dist/message-chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-chrome.d.ts","sourceRoot":"","sources":["../src/message-chrome.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,kFAAkF;IAClF,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,4EAA4E;IAC5E,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;6BAGiC,SAAS,KAAG,WAAW;kCA4BlB,MAAM,UAAU,MAAM,KAAG,WAAW;EAgD1E"}

package/dist/message-chrome.js

@@ -0,0 +1,101 @@
+import { el } from "./dom.js";
+import { ICON_CHEV_L, ICON_CHEV_R, ICON_THUMB_DOWN, ICON_THUMB_UP, } from "./icons.js";
+import { PREFIX } from "./prefix.js";
+/**
+ * The two controls that hang off a single assistant message: the ‹n/m› branch
+ * navigator and the up/down vote pair.
+ *
+ * Both are pure DOM builders — they read no widget state and write none. They
+ * sat inside the 6,051-line closure only because that is where they were
+ * written (`#320`), and they are the shape that actually moves out of it: the
+ * measurement on that issue put them at two closure bindings each, against 56
+ * for `send()` and 28 for the job cluster.
+ *
+ * THE THREAD ID IS A GETTER, AND THAT IS THE WHOLE REASON THIS IS A FACTORY.
+ *
+ * `buildVoteButtons` reads the thread id inside the CLICK handler, not while
+ * building. In the closure that was automatic — `threadId` is a `let` the widget
+ * reassigns when the server names a thread, and a vote cast later reads whatever
+ * it holds then. Taking it as a plain parameter here would capture the value at
+ * BUILD time, so a message rendered before the thread was named would post its
+ * vote against the wrong id — or an empty one — and nothing would fail loudly:
+ * the request succeeds, the vote lands on nothing, and the quality signal
+ * `#299` exists to collect goes quietly missing.
+ *
+ * A getter keeps the read where it was. The rest of the dependencies are fixed
+ * for the widget's lifetime and are captured once, which is what lets both
+ * bodies move byte for byte.
+ */
+export function createMessageChrome(deps) {
+    const { switchBranch, getThreadId, vote, voteUpLabel, voteDownLabel } = deps;
+    function buildBranchNav(branch) {
+        const nav = el("div", `${PREFIX}-branchnav`);
+        const prev = el("button", `${PREFIX}-branch-btn`);
+        prev.type = "button";
+        prev.setAttribute("aria-label", "Previous version");
+        prev.innerHTML = ICON_CHEV_L;
+        prev.disabled = !branch.prevLeaf;
+        if (branch.prevLeaf) {
+            const leaf = branch.prevLeaf;
+            prev.addEventListener("click", () => void switchBranch(leaf));
+        }
+        const count = el("span", `${PREFIX}-branch-count`);
+        count.textContent = `${branch.index}/${branch.count}`;
+        const next = el("button", `${PREFIX}-branch-btn`);
+        next.type = "button";
+        next.setAttribute("aria-label", "Next version");
+        next.innerHTML = ICON_CHEV_R;
+        next.disabled = !branch.nextLeaf;
+        if (branch.nextLeaf) {
+            const leaf = branch.nextLeaf;
+            next.addEventListener("click", () => void switchBranch(leaf));
+        }
+        nav.appendChild(prev);
+        nav.appendChild(count);
+        nav.appendChild(next);
+        return nav;
+    }
+    function buildVoteButtons(messageId, model) {
+        const wrap = el("div", `${PREFIX}-votes`);
+        let cur = 0;
+        const up = el("button", `${PREFIX}-msgact ${PREFIX}-vote`);
+        const down = el("button", `${PREFIX}-msgact ${PREFIX}-vote`);
+        up.type = "button";
+        down.type = "button";
+        up.setAttribute("aria-label", voteUpLabel ?? "Helpful");
+        down.setAttribute("aria-label", voteDownLabel ?? "Not helpful");
+        up.title = voteUpLabel ?? "Helpful";
+        down.title = voteDownLabel ?? "Not helpful";
+        up.innerHTML = ICON_THUMB_UP;
+        down.innerHTML = ICON_THUMB_DOWN;
+        const paint = () => {
+            up.classList.toggle(`${PREFIX}-vote-on`, cur === 1);
+            down.classList.toggle(`${PREFIX}-vote-on`, cur === -1);
+        };
+        const cast = (next) => {
+            if (!vote)
+                return;
+            const value = (cur === next ? 0 : next);
+            const prev = cur;
+            cur = value;
+            paint();
+            // messageId is globally unique; the current threadId scopes the vote.
+            void vote({
+                threadId: getThreadId() ?? "",
+                messageId,
+                value,
+                ...(model ? { model } : {}),
+            }).catch(() => {
+                cur = prev;
+                paint();
+            });
+        };
+        up.addEventListener("click", () => cast(1));
+        down.addEventListener("click", () => cast(-1));
+        wrap.appendChild(up);
+        wrap.appendChild(down);
+        return wrap;
+    }
+    return { buildBranchNav, buildVoteButtons };
+}
+//# sourceMappingURL=message-chrome.js.map

package/dist/message-chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-chrome.js","sourceRoot":"","sources":["../src/message-chrome.ts"],"names":[],"mappings":"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"}

package/dist/pane-follow.d.ts

@@ -0,0 +1,67 @@
+/**
+ * TWO DECISIONS THE APP PANE MAKES, extracted so they can be checked.
+ *
+ * Both live inside `createAiChatWidget`'s closure in the real widget, where
+ * they are unreachable from a test — and both are the kind of rule that fails
+ * politely: get them wrong and the pane either never follows a long operation
+ * (the feature silently does nothing) or follows it too eagerly (it yanks a
+ * reader off the page they chose, repeatedly, on every poll). Neither shows up
+ * as an error.
+ */
+/** Same-path test used for both decisions. A query string is a filter within a
+ *  page, not a different destination; a trailing slash is not a destination
+ *  either. */
+export declare function samePanePath(a: string | null | undefined, b: string | null | undefined): boolean;
+export interface AutoNavigateInput {
+    /** Advanced view is open. There is no pane to move otherwise, and moving the
+     *  whole PAGE because a background job started is a different feature. */
+    advanced: boolean;
+    /** The host wired `getAdvancedUrl` — without it there is no embed URL. */
+    canNavigate: boolean;
+    /**
+     * The user CONFIRMED this operation in this session — they pressed the button
+     * that started it, in this widget, just now.
+     *
+     * The other three conditions all ask whether following would be RUDE. This
+     * one asks whether the operation is the user's at all. A tracked job outlives
+     * the tab: it is written to localStorage so a running import survives a
+     * refresh, and it is also re-discovered from the server listing so work
+     * started on another device shows up here. Neither of those is a thing the
+     * person in front of the screen just asked for, and "advanced view was opened"
+     * is not consent to be sent to a page some other tab started building.
+     */
+    userConfirmedThisSession: boolean;
+    /** The user has driven the frame themselves since this session began. */
+    userDriven: boolean;
+    /** This operation has already been followed once. */
+    alreadyFollowed: boolean;
+    /** The path to follow to, as the model/host supplied it. */
+    path: string | null | undefined;
+    /** Where the pane is now — skip the reload if it is already there. */
+    currentPath?: string | null;
+}
+/**
+ * Should the pane follow a long operation to its live page?
+ *
+ * Every `false` here is a way this becomes obnoxious rather than helpful, and
+ * the third one is the one that bites hardest: a report card polls every couple
+ * of seconds, so a decision that does not remember it already followed would
+ * reload the page continuously — turning "watch it build" into a surface that
+ * cannot be read at all.
+ */
+export declare function shouldAutoNavigate(i: AutoNavigateInput): boolean;
+/**
+ * Should the chat column collapse its narration to one line?
+ *
+ * True exactly when the pane is showing the same run — the owner's decision for
+ * advanced mode. The report page owns the detail (it has the stage rail and it
+ * is the authority on stage), and two renderings of one job on one screen is
+ * the divergence advanced view makes visible. When the pane is elsewhere the
+ * chat is the ONLY account of what is happening, so it narrates in full.
+ */
+export declare function shouldCollapseNarration(i: {
+    advanced: boolean;
+    livePath: string | null | undefined;
+    currentPath: string | null | undefined;
+}): boolean;
+//# sourceMappingURL=pane-follow.d.ts.map

package/dist/pane-follow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane-follow.d.ts","sourceRoot":"","sources":["../src/pane-follow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;cAEc;AACd,wBAAgB,YAAY,CAC1B,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5B,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC3B,OAAO,CAOT;AAED,MAAM,WAAW,iBAAiB;IAChC;8EAC0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,wBAAwB,EAAE,OAAO,CAAC;IAClC,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;IACzB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChC,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAUhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACxC,GAAG,OAAO,CAGV"}