@teaflask/assistant 0.3.0 → 0.6.0

package/dist/index.js

@@ -1,55 +1,18 @@
-// The package's root public API. The exports map exposes only this
-// entry, ./activity, ./headless, ./markdown, ./scroll, ./transcript,
-// ./styles.css and ./package.json — deep imports are structurally
-// impossible.
 export { TeaflaskAssistantProvider, } from "./components/teaflask-assistant-provider.js";
-// The batteries-included root: provider + companion + palette
-// + the ⌘K trigger in one mount. The granular pieces below stay public
-// for hosts that want to own the composition.
 export { TeaflaskAssistant, } from "./components/teaflask-assistant.js";
 export { AssistantPage, } from "./components/assistant-page.js";
 export { AssistantPalette, } from "./components/assistant-palette.js";
-// The read-only activity feed: presence without a transcript.
-// Deliberately minimal — the store itself stays internal.
 export { useAssistantActivity } from "./components/use-assistant-activity.js";
 export { resetAssistant } from "./persistence/stored-thread.js";
 export { ServingApiError } from "./transport/serving-error.js";
+export { SUBSCRIPTION_CONNECT_MESSAGE_TYPE, subscriptionConnectMessageOf, } from "./contract/subscriptions.js";
 export { ASSISTANT_MESSAGE_MAX_CHARS, } from "./contract/threads.js";
 export { APPROVAL_REQUESTED_EVENT_NAME, MEMORY_UPDATED_EVENT_NAME, RUN_RESUMED_EVENT_NAME, TURN_USAGE_RECORDED_EVENT_NAME, } from "./contract/events.js";
-// The replay-stable metadata contract: per-event server
-// timestamps reduced into per-fold durations (the typed unknown-vs-
-// sub-second law the transcript's fold rows render from), honest turn usage,
-// and memory provenance. See docs/replay-metadata-contract.md
-// for the decision record.
 export { activeFoldElapsedOf, settledFoldDurationOf, } from "./core/segment-timing.js";
 export { usageIsFinal } from "./core/turn-usage-anchors.js";
 export { TOOL_CALL_ICONS, toolCallPresentationOf, } from "./core/tool-call-presentation.js";
-// The tool-view contract (tool-views.md): one view per tool call,
-// resolved by the presenter over four rungs — host registry by wire
-// {key, version}, host registry by exact tool name, package built-ins
-// under the reserved teaflask.* namespace, and the package default. The
-// imperative adapter is the canonical authoring form; reactToolView is
-// the React sugar over the same lifecycle. Registration is `toolViews`
-// — the provider prop in React, the same-named JS property on the
-// script-tag elements — trusted host code only, code never
-// rides the wire.
 export { actionToolName, actionToolViews, resolvedToolViewsOf, } from "./core/tool-view.js";
 export { reactToolView } from "./components/react-tool-view.js";
-// The tool-view parts (tool-views/parts.tsx): the React spelling of the
-// card, row, facts, caption, body, badge, note and skeleton vocabulary
-// the built-ins paint with — a host view composes these and reads as one
-// system with ours.
 export { ToolViewBadge, ToolViewBody, ToolViewBones, ToolViewScroll, ToolViewTitle, ToolViewCaption, ToolViewCard, ToolViewFacts, ToolViewNote, ToolViewRow, } from "./components/tool-views/parts.js";
-// The built-ins' own vocabulary (tool-views/view-dom.ts), exported so a
-// host view speaks it by re-use rather than by copy: the settled-outcome
-// sentence, the vanilla card parts, the labeled pane and quiet note, the
-// action envelope and failure readers (the HTTP status lives only in
-// resultText), and recordOf — the plain-object narrower a view's parser
-// leans on, which the dashboard's views once respelled.
 export { actionEnvelopeOf, actionFailureOf, boneRows, captionRow, card, factRows, humanFailureSentenceOf, listRow, note, pane, recordOf, scrollRegion, terminal, settledOutcomeNoteOf, settledOutcomeNotesOf, settledWithResult, } from "./components/tool-views/view-dom.js";
-// The companion: the presence surface — the bare mark in the
-// corner that expands into the chat drawer, follows a tool navigation
-// with the drawer open, and yields to any mounted full surface. The mark
-// is the provider's `companionMark` (default: the TeaFlask flask).
 export { AssistantCompanion, } from "./components/assistant-companion.js";
-//# sourceMappingURL=index.js.map

package/dist/markdown.d.ts

@@ -2,4 +2,3 @@ export { AssistantMarkdown } from "./components/markdown/assistant-markdown.js";
 export { PacedAssistantMarkdown } from "./components/markdown/paced-assistant-markdown.js";
 export { repairedStreamingMarkdown } from "./components/markdown/streaming-repair.js";
 export { usePacedReveal } from "./components/markdown/use-paced-reveal.js";
-//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.js

@@ -1,13 +1,4 @@
-// The transcript's markdown/reveal leaves (fork the composition, share
-// the leaves). Its dashboard importer today is the doc tool views'
-// document body (AssistantMarkdown), earned in the dashboard's
-// architecture law's allowlist. Public for tarball hosts too:
-// typography, code blocks, the streaming repair and the paced reveal are
-// wire-agnostic and exist once, here.
-// Public API like "." — additions are cheap until the package publishes,
-// breaking changes are a customer conversation after.
 export { AssistantMarkdown } from "./components/markdown/assistant-markdown.js";
 export { PacedAssistantMarkdown } from "./components/markdown/paced-assistant-markdown.js";
 export { repairedStreamingMarkdown } from "./components/markdown/streaming-repair.js";
 export { usePacedReveal } from "./components/markdown/use-paced-reveal.js";
-//# sourceMappingURL=markdown.js.map

package/dist/persistence/execution-ledger.d.ts

@@ -2,13 +2,6 @@ import type { ExecutionOutcome } from "../core/execution-handlers.js";
 export declare const UNKNOWN_OUTCOME: Extract<ExecutionOutcome, {
     ok: false;
 }>;
-/**
- * The outcome this tab already produced for an interrupt, the canned
- * unknown-outcome failure for a claim that never settled, or null when
- * the interrupt was never claimed here (executing is allowed).
- */
 export declare function readExecutedOutcome(threadId: string, interruptId: string): ExecutionOutcome | null;
-/** Written the instant an entry is claimed, before its handler runs. */
 export declare function recordExecutionClaimed(threadId: string, interruptId: string): void;
 export declare function recordExecutedOutcome(threadId: string, interruptId: string, outcome: ExecutionOutcome): void;
-//# sourceMappingURL=execution-ledger.d.ts.map

package/dist/persistence/execution-ledger.js

@@ -1,17 +1,3 @@
-// The browser's memory of what it already executed: one sessionStorage
-// entry per thread, holding the interrupt ids this tab claimed and the
-// outcomes their handlers produced. The at-most-once backstop of the
-// execution loop — the stream's own replayed evidence closes stale
-// entries first, but only this record survives the remount a navigation
-// causes, and "re-POST the stored outcome" is the contract's designed
-// recovery where re-execution never is.
-//
-// Session-scoped on purpose: the record guards THIS tab's re-execution;
-// cross-tab arbitration is the server's (first-wins recording); a
-// cross-tab residual is accepted.
-// A claim with no outcome is a tab that died mid-handler: the action may
-// or may not have happened, so the record reads as this honest failure —
-// never as a license to re-execute.
 export const UNKNOWN_OUTCOME = {
     ok: false,
     error: {
@@ -21,19 +7,8 @@ export const UNKNOWN_OUTCOME = {
             "them to check whether it happened before anything is retried.",
     },
 };
-// Executions are rare per thread (one per pause round); the cap only
-// bounds a pathological session.
 const MAX_RECORDED_EXECUTIONS = 40;
-// Module memory is the always-written layer (authoritative for this
-// page's lifetime, immune to quota trouble); sessionStorage is the
-// persistence layer a reload reads back. Where storage is unavailable
-// (SSR, sandboxed embeds), the ledger simply doesn't survive reloads.
 const memoryLedgers = new Map();
-/**
- * The outcome this tab already produced for an interrupt, the canned
- * unknown-outcome failure for a claim that never settled, or null when
- * the interrupt was never claimed here (executing is allowed).
- */
 export function readExecutedOutcome(threadId, interruptId) {
     const record = _recordsFor(threadId).find((known) => known.interruptId === interruptId);
     if (record === undefined) {
@@ -41,7 +16,6 @@ export function readExecutedOutcome(threadId, interruptId) {
     }
     return record.outcome ?? UNKNOWN_OUTCOME;
 }
-/** Written the instant an entry is claimed, before its handler runs. */
 export function recordExecutionClaimed(threadId, interruptId) {
     const records = _recordsFor(threadId);
     if (records.some((known) => known.interruptId === interruptId)) {
@@ -78,8 +52,6 @@ function _writeRecords(threadId, records) {
         _storage()?.setItem(_storageKeyFor(threadId), JSON.stringify(records));
     }
     catch {
-        // Quota trouble costs reload persistence, never the in-page record —
-        // module memory above already holds the at-most-once claim.
     }
 }
 function _storage() {
@@ -90,8 +62,6 @@ function _storage() {
         return window.sessionStorage;
     }
     catch {
-        // Some embeds (sandboxed iframes, blocked third-party storage) throw
-        // on access; the ledger then lives in module memory.
         return null;
     }
 }
@@ -103,7 +73,6 @@ function _decodeRecords(raw) {
         }
     }
     catch {
-        // A corrupt entry reads as no entries.
     }
     return [];
 }
@@ -114,4 +83,3 @@ function _isLedgerRecord(value) {
         typeof value.interruptId === "string" &&
         "outcome" in value);
 }
-//# sourceMappingURL=execution-ledger.js.map

package/dist/persistence/panel-mode.d.ts

@@ -2,11 +2,5 @@ export type PanelDock = "floating" | "sidebar";
 type PanelModeListener = () => void;
 export declare function readPanelMode(publishableKey: string): PanelDock;
 export declare function writePanelMode(publishableKey: string, mode: PanelDock): void;
-/**
- * Same-tab change signal, so every mounted reader agrees with the
- * switcher without a re-mount. Cross-tab sync is deliberately out of
- * scope: the mode is read fresh on every load.
- */
 export declare function subscribePanelMode(listener: PanelModeListener): () => void;
 export {};
-//# sourceMappingURL=panel-mode.d.ts.map

package/dist/persistence/panel-mode.js

@@ -1,11 +1,3 @@
-// The drawer's dock preference, one localStorage value per publishable
-// key: "sidebar" opts into the pushed-aside page, anything else is the
-// floating default — intrusiveness is opt-in, so the read trusts nothing
-// but the exact opt-in string. Deliberately NOT cleared by
-// resetAssistant(): where the panel lives is a device preference and
-// must survive a sign-out. A host-facing `panel-mode`
-// attribute (default/override) was considered and deliberately not
-// shipped — the mode is the end user's, not the host's.
 const _listeners = new Set();
 export function readPanelMode(publishableKey) {
     try {
@@ -23,20 +15,13 @@ export function writePanelMode(publishableKey, mode) {
             _storage()?.setItem(_storageKeyFor(publishableKey), "sidebar");
         }
         else {
-            // The default needs no record; an absent key reads as floating.
             _storage()?.removeItem(_storageKeyFor(publishableKey));
         }
     }
     catch {
-        // Quota or privacy-mode failures cost persistence, never the widget.
     }
     _notifyPanelModeChanged();
 }
-/**
- * Same-tab change signal, so every mounted reader agrees with the
- * switcher without a re-mount. Cross-tab sync is deliberately out of
- * scope: the mode is read fresh on every load.
- */
 export function subscribePanelMode(listener) {
     _listeners.add(listener);
     return () => {
@@ -44,8 +29,6 @@ export function subscribePanelMode(listener) {
     };
 }
 function _notifyPanelModeChanged() {
-    // Notify a copy: a listener that unsubscribes mid-notify must not
-    // starve the rest of this round's delivery.
     for (const listener of [..._listeners]) {
         listener();
     }
@@ -61,9 +44,6 @@ function _storage() {
         return window.localStorage;
     }
     catch {
-        // Some embeds (sandboxed iframes, blocked third-party storage) throw
-        // on access; the widget then simply doesn't persist.
         return null;
     }
 }
-//# sourceMappingURL=panel-mode.js.map

package/dist/persistence/plan-notice.d.ts

@@ -0,0 +1,3 @@
+import type { SubscriptionProvider } from "../contract/subscriptions.js";
+export declare function readPlanNoticeSeen(publishableKey: string, provider: SubscriptionProvider): boolean;
+export declare function writePlanNoticeSeen(publishableKey: string, provider: SubscriptionProvider): void;

package/dist/persistence/plan-notice.js

@@ -0,0 +1,30 @@
+const _SEEN = "seen";
+export function readPlanNoticeSeen(publishableKey, provider) {
+    try {
+        return (_storage()?.getItem(_storageKeyFor(publishableKey, provider)) === _SEEN);
+    }
+    catch {
+        return false;
+    }
+}
+export function writePlanNoticeSeen(publishableKey, provider) {
+    try {
+        _storage()?.setItem(_storageKeyFor(publishableKey, provider), _SEEN);
+    }
+    catch {
+    }
+}
+function _storageKeyFor(publishableKey, provider) {
+    return `tf-assistant:${publishableKey}:plan-notice-seen:${provider}`;
+}
+function _storage() {
+    if (typeof window === "undefined") {
+        return null;
+    }
+    try {
+        return window.localStorage;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/persistence/stored-thread.d.ts

@@ -1,16 +1,12 @@
 export interface StoredThread {
     threadId: string;
     identified: boolean;
+    userId?: string;
 }
 export declare function readStoredThread(publishableKey: string): StoredThread | null;
+export declare function readStoredThreadFor(publishableKey: string, userId: string | undefined): StoredThread | null;
 export declare function writeStoredThread(publishableKey: string, stored: StoredThread): void;
 export declare function clearStoredThread(publishableKey: string): void;
-/**
- * The host-logout contract: call this in the sign-out handler so the next
- * visitor on this browser starts clean. Pure storage — it works on pages
- * where the widget isn't mounted (the common case for logout flows).
- */
 export declare function resetAssistant(options: {
     publishableKey: string;
 }): void;
-//# sourceMappingURL=stored-thread.d.ts.map

package/dist/persistence/stored-thread.js

@@ -1,7 +1,3 @@
-// The browser's memory of its conversation: one localStorage entry per
-// publishable key (pk_test and pk_live on one origin stay apart; per-org
-// is impossible — the browser only knows the pk). `identified: false`
-// marks a thread still to be offered for adoption on the sign-in re-mint.
 export function readStoredThread(publishableKey) {
     const raw = _storage()?.getItem(_storageKeyFor(publishableKey)) ?? null;
     if (raw === null) {
@@ -9,12 +5,18 @@ export function readStoredThread(publishableKey) {
     }
     return _decodeStoredThread(raw);
 }
+export function readStoredThreadFor(publishableKey, userId) {
+    const stored = readStoredThread(publishableKey);
+    if (!stored?.identified) {
+        return stored;
+    }
+    return userId !== undefined && stored.userId === userId ? stored : null;
+}
 export function writeStoredThread(publishableKey, stored) {
     try {
         _storage()?.setItem(_storageKeyFor(publishableKey), JSON.stringify(stored));
     }
     catch {
-        // Quota or privacy-mode failures cost persistence, never the widget.
     }
 }
 export function clearStoredThread(publishableKey) {
@@ -22,14 +24,8 @@ export function clearStoredThread(publishableKey) {
         _storage()?.removeItem(_storageKeyFor(publishableKey));
     }
     catch {
-        // Same stance as writes: storage trouble never breaks the widget.
     }
 }
-/**
- * The host-logout contract: call this in the sign-out handler so the next
- * visitor on this browser starts clean. Pure storage — it works on pages
- * where the widget isn't mounted (the common case for logout flows).
- */
 export function resetAssistant(options) {
     clearStoredThread(options.publishableKey);
 }
@@ -44,8 +40,6 @@ function _storage() {
         return window.localStorage;
     }
     catch {
-        // Some embeds (sandboxed iframes, blocked third-party storage) throw
-        // on access; the widget then simply doesn't persist.
         return null;
     }
 }
@@ -57,7 +51,6 @@ function _decodeStoredThread(raw) {
         }
     }
     catch {
-        // A corrupt entry reads as no entry.
     }
     return null;
 }
@@ -67,6 +60,8 @@ function _isStoredThread(value) {
         "threadId" in value &&
         typeof value.threadId === "string" &&
         "identified" in value &&
-        typeof value.identified === "boolean");
+        typeof value.identified === "boolean" &&
+        (!("userId" in value) ||
+            value.userId === undefined ||
+            typeof value.userId === "string"));
 }
-//# sourceMappingURL=stored-thread.js.map

package/dist/reader/accessible-name.d.ts

@@ -1,4 +1,3 @@
 import type { LayoutProbe } from "./layout-probe.js";
 export type AccessibleNameCache = Map<Element, string>;
 export declare function accessibleNameOf(element: Element, probe: LayoutProbe, cache: AccessibleNameCache): string;
-//# sourceMappingURL=accessible-name.d.ts.map

package/dist/reader/accessible-name.js

@@ -1,13 +1,6 @@
-// Accessible-name computation, W3C-accname-shaped: the label a user
-// (or assistive tech) would know an element by. Precedence walks from
-// author overrides (aria-labelledby, aria-label) through native labeling
-// (label elements, alt, captions) down to content and tooltips. Results
-// are cached per snapshot pass — the walk asks for the same names many
-// times — and capped at 300 characters.
 import { roleOf } from "./roles.js";
 const MAX_NAME_DEPTH = 10;
 const MAX_NAME_LENGTH = 300;
-// Roles that take their name from their contents.
 const NAME_FROM_CONTENT_ROLES = new Set([
     "button",
     "link",
@@ -26,9 +19,6 @@ const NAME_FROM_CONTENT_ROLES = new Set([
     "row",
     "term",
 ]);
-// Roles for which naming is prohibited outright — a bare div (generic)
-// has no accessible name, which is what lets the reader tell a labeled
-// control from an anonymous wrapper.
 const PROHIBITS_NAMING = new Set([
     "caption",
     "code",
@@ -168,7 +158,6 @@ function _altNameOf(element) {
         return null;
     }
     const alt = element.getAttribute("alt");
-    // A present-but-empty alt is "purely decorative" and short-circuits.
     return alt === null ? null : alt.trim();
 }
 function _captionNameOf(element, probe, state) {
@@ -212,8 +201,6 @@ function _contentNameOf(element, probe, state) {
         }
     }
     parts.push(probe.pseudoContentOf(element, "::after"));
-    // No separator: inline fragments carry their own whitespace, and a
-    // forced space would split words that wrap in nested spans.
     return parts.join("").replace(/\s+/g, " ").trim();
 }
 function _isHiddenForNaming(element, probe) {
@@ -242,8 +229,6 @@ function _labelsOf(element) {
     }
     for (let parent = element.parentElement; parent !== null; parent = parent.parentElement) {
         if (parent.tagName.toLowerCase() === "label") {
-            // A label that both wraps its control and names it via for= is
-            // one label, not two — collecting it twice would double the name.
             if (!labels.includes(parent)) {
                 labels.push(parent);
             }
@@ -253,11 +238,6 @@ function _labelsOf(element) {
     return labels;
 }
 function _labelsWiredTo(documentOf, id) {
-    // Inside a double-quoted CSS string only the quote and the backslash
-    // are meta — both must be escaped, or an id ending in a backslash eats
-    // the closing quote and the selector throws. The fence upholds the
-    // reader's invariant: an unselectable id costs one label, never the
-    // whole read.
     const escaped = id.replace(/[\\"]/g, "\\$&");
     try {
         return Array.from(documentOf.querySelectorAll(`label[for="${escaped}"]`));
@@ -266,4 +246,3 @@ function _labelsWiredTo(documentOf, id) {
         return [];
     }
 }
-//# sourceMappingURL=accessible-name.js.map

package/dist/reader/interactivity.d.ts

@@ -4,10 +4,8 @@ export declare const CONTENT_REF_ROLES: Set<string>;
 export interface InteractivitySignals {
     interactive: boolean;
     isInteractiveTag: boolean;
-    /** The heuristic signals worth surfacing on non-native elements. */
     hints: string[];
 }
 export declare function interactivitySignalsOf(element: Element, probe: LayoutProbe): InteractivitySignals;
 export declare function isScrollable(element: Element, probe: LayoutProbe): boolean;
 export declare function isLandmark(element: Element): boolean;
-//# sourceMappingURL=interactivity.d.ts.map

package/dist/reader/interactivity.js

@@ -1,10 +1,3 @@
-// Which elements the user can act on. Native interactive tags and
-// button/link roles are certain; onclick handlers, focusable tabindex,
-// contenteditable, and cursor:pointer are the heuristics that catch the
-// div-with-a-click-handler pattern. The cursor signal is suppressed when
-// the parent shares it and the element has no signal of its own —
-// otherwise every span inside a clickable card would read as
-// interactive.
 import { explicitRoleOf, isContentEditableElement } from "./roles.js";
 const INTERACTIVE_TAGS = new Set([
     "a",
@@ -15,7 +8,6 @@ const INTERACTIVE_TAGS = new Set([
     "details",
     "summary",
 ]);
-// Roles that always earn a ref in the snapshot, interactive by nature.
 export const INTERACTIVE_REF_ROLES = new Set([
     "button",
     "link",
@@ -35,7 +27,6 @@ export const INTERACTIVE_REF_ROLES = new Set([
     "tab",
     "treeitem",
 ]);
-// Content roles that earn a ref only when they carry an accessible name.
 export const CONTENT_REF_ROLES = new Set([
     "cell",
     "gridcell",
@@ -72,8 +63,6 @@ export function interactivitySignalsOf(element, probe) {
     const hasCursorPointer = probe.styleOf(element).cursor === "pointer";
     const isInteractiveTag = INTERACTIVE_TAGS.has(tag);
     const isRoleInteractive = role === "button" || role === "link";
-    // The shared predicate, so the bare attribute and plaintext-only read
-    // as interactive exactly where roles.ts reads them as textboxes.
     const isContentEditable = isContentEditableElement(element);
     let hasPointerInteraction = hasCursorPointer;
     if (hasCursorPointer && !hasOnClick && !hasTabIndex) {
@@ -106,7 +95,7 @@ export function interactivitySignalsOf(element, probe) {
 export function isScrollable(element, probe) {
     const tag = element.tagName.toLowerCase();
     if (tag === "html" || tag === "body") {
-        return false; // page-level scroll is implicit
+        return false;
     }
     const style = probe.styleOf(element);
     if (!SCROLLABLE_OVERFLOW_VALUES.has(style.overflowX) &&
@@ -126,4 +115,3 @@ export function isLandmark(element) {
         explicitRole !== "presentation" &&
         explicitRole !== "none");
 }
-//# sourceMappingURL=interactivity.js.map

package/dist/reader/layout-probe.d.ts

@@ -20,20 +20,10 @@ export interface SizeSlice {
 }
 export interface LayoutProbe {
     styleOf(element: Element): StyleSlice;
-    /** The rendered text of a ::before/::after pseudo-element, or "". */
     pseudoContentOf(element: Element, pseudo: "::before" | "::after"): string;
     rectOf(element: Element): RectSlice;
-    /** Layout box size (offsetWidth/offsetHeight); -1 when unknowable. */
     offsetSizeOf(element: Element): SizeSlice;
     viewportSizeOf(): SizeSlice;
-    /**
-     * The engine's own visibility verdict (checkVisibility), or null when
-     * the engine does not offer one.
-     */
     nativeVisibilityOf(element: Element): boolean | null;
 }
-/** The real-browser probe. Every read is fenced — cross-origin style
- * access and detached nodes throw in some engines, and a probe failure
- * must never fail a snapshot. */
 export declare function browserLayoutProbe(): LayoutProbe;
-//# sourceMappingURL=layout-probe.d.ts.map

package/dist/reader/layout-probe.js

@@ -1,9 +1,3 @@
-// The reader's one window onto layout and computed style. Every
-// getComputedStyle / getBoundingClientRect / viewport read in the reader
-// goes through this interface — nothing else may touch those APIs — so
-// the walk's structural logic unit-tests under jsdom (which has no
-// layout engine) with a fake probe, while the browser probe stays a thin
-// adapter exercised by the live lanes.
 const DEFAULT_STYLE = {
     display: "block",
     visibility: "visible",
@@ -20,9 +14,6 @@ const ZERO_RECT = {
     width: 0,
     height: 0,
 };
-/** The real-browser probe. Every read is fenced — cross-origin style
- * access and detached nodes throw in some engines, and a probe failure
- * must never fail a snapshot. */
 export function browserLayoutProbe() {
     return {
         styleOf(element) {
@@ -94,11 +85,6 @@ export function browserLayoutProbe() {
         },
     };
 }
-/**
- * The text a CSS content value renders: its quoted string tokens,
- * unescaped and joined. "none"/"normal" and non-string values (counters,
- * url()) render nothing the reader can use.
- */
 function pseudoTextFromContentValue(content) {
     if (content === "" || content === "none" || content === "normal") {
         return "";
@@ -125,4 +111,3 @@ function _unescapedCssString(text) {
         return escaped;
     });
 }
-//# sourceMappingURL=layout-probe.js.map

package/dist/reader/line-diff.d.ts

@@ -1,3 +1 @@
-/** The unified diff from before to after; "" when the texts are equal. */
 export declare function unifiedDiffOf(before: string, after: string): string;
-//# sourceMappingURL=line-diff.d.ts.map

package/dist/reader/line-diff.js

@@ -1,10 +1,4 @@
-// A minimal unified line diff (Myers shortest-edit), so a repeat page
-// read can ride as "what changed since your last read" instead of the
-// whole tree. Output is the familiar hunk format — `@@ -a,b +c,d @@`
-// headers, three lines of context, no file header — because the model
-// already knows how to read it. Pure text in, pure text out.
 const CONTEXT_LINES = 3;
-/** The unified diff from before to after; "" when the texts are equal. */
 export function unifiedDiffOf(before, after) {
     if (before === after) {
         return "";
@@ -86,7 +80,6 @@ function _backtrackedOpsOf(trace, before, after) {
 function _hunksOf(ops) {
     const groups = _changeGroupsOf(ops);
     const lines = [];
-    // Running line numbers (1-indexed) per op index, computed as we walk.
     let aLine = 1;
     let bLine = 1;
     let opIndex = 0;
@@ -152,4 +145,3 @@ function _changeGroupsOf(ops) {
     }
     return groups;
 }
-//# sourceMappingURL=line-diff.js.map

package/dist/reader/read-page.d.ts

@@ -1,5 +1,4 @@
 import type { LayoutProbe } from "./layout-probe.js";
-/** The wire shape of ReadPageResult, synthesized package-side. */
 export interface ReadPageReport {
     url: string;
     title: string;
@@ -7,16 +6,7 @@ export interface ReadPageReport {
     is_diff: boolean;
     truncated: boolean;
 }
-/**
- * An expected, recoverable read refusal — a stale ref, a selector that
- * matches nothing, a page with no body yet. Its message is the reader's
- * own model-actionable sentence (usually "take a fresh full read"), and
- * the handler delivers it verbatim: wrapping it in give-up prose would
- * cancel the retry the sentence asks for. A reader crash is anything
- * else.
- */
 export declare class SnapshotUnavailableError extends Error {
 }
 export declare function readPageResultOf(threadId: string, action: Record<string, unknown> | null, probe: LayoutProbe): ReadPageReport;
 export declare function _resetBaselinesForTests(): void;
-//# sourceMappingURL=read-page.d.ts.map