@oddkin/ai 0.0.0-stage → 1.0.0-beta.0

package/dist/conversation/conversation.d.ts

@@ -0,0 +1,128 @@
+import { OddkinElement, type ElementEvents } from '@oddkin/core/element';
+import type { Scope } from '@oddkin/core/scope';
+import type { ArtifactRenderer } from '../artifact/artifact.js';
+import type { ConversationState, ExternalSource, ToolCallRecord } from '../contracts/types.js';
+import { type AnnouncementStrings } from '../controllers/announcer.js';
+import type { MarkdownOptions } from '../markdown/render.js';
+import type { DataRenderer } from '../message/message.js';
+import type { ToolOutputRenderer } from '../tool-call/tool-call.js';
+export declare const CONVERSATION_STRINGS: {
+    label: string;
+    empty: string;
+    loadEarlier: string;
+    loading: string;
+    historyError: string;
+    retry: string;
+    jump: string;
+    jumpNew: string;
+    messageLabel: string;
+    user: string;
+    assistant: string;
+    system: string;
+    tool: string;
+};
+/** A saved reading position: the message at the top of the viewport and its offset. */
+export interface ScrollPosition {
+    readonly messageId: string;
+    readonly offset: number;
+    readonly following: boolean;
+}
+declare const OddkinConversation_base: import("@oddkin/core/element").WithProps<typeof OddkinElement, {
+    readonly store: import("@oddkin/core/element").PropDefinition<ExternalSource<ConversationState> | undefined>;
+    readonly state: import("@oddkin/core/element").PropDefinition<ConversationState | undefined>;
+    readonly label: import("@oddkin/core/element").PropDefinition<string>;
+    readonly announce: import("@oddkin/core/element").PropDefinition<"all" | "important" | "none">;
+    readonly markdown: import("@oddkin/core/element").PropDefinition<MarkdownOptions | undefined>;
+    readonly renderers: import("@oddkin/core/element").PropDefinition<Readonly<Record<string, DataRenderer>> | undefined>;
+    readonly artifactRenderers: import("@oddkin/core/element").PropDefinition<Readonly<Record<string, ArtifactRenderer>> | undefined>;
+    readonly renderTool: import("@oddkin/core/element").PropDefinition<{
+        render: ToolOutputRenderer;
+    } | undefined>;
+    readonly feedbackReasons: import("@oddkin/core/element").PropDefinition<string[]>;
+    readonly strings: import("@oddkin/core/element").PropDefinition<Partial<{
+        label: string;
+        empty: string;
+        loadEarlier: string;
+        loading: string;
+        historyError: string;
+        retry: string;
+        jump: string;
+        jumpNew: string;
+        messageLabel: string;
+        user: string;
+        assistant: string;
+        system: string;
+        tool: string;
+    } & AnnouncementStrings> | undefined>;
+}>;
+/**
+ * A conversation surface: messages as an ARIA feed, history loading, a follow-latest scrolling
+ * policy that respects reading earlier content, a visible-anchor guarantee when history is
+ * prepended or content above changes size, an explicit "Jump to latest", the run status bar,
+ * one announcer for the whole surface, and a slot for the composer. Reads state from one
+ * authoritative source (`store` or `state`); keeps only presentation state.
+ *
+ * @slot composer - The prompt input.
+ * @slot empty - Content shown when there are no messages.
+ * @slot status - Extra status content (usage, model) above the composer.
+ * @csspart base - The column of the scroll container, the run status, and the composer.
+ * @csspart scroller - The scroll container.
+ * @csspart feed - The feed of messages.
+ * @csspart jump - The "Jump to latest" button.
+ * @csspart activity - The run status bar.
+ * @cssprop --odd-conversation-max-width - Maximum line length of the feed.
+ * @a11y Messages are `article`s in a `feed` with position and size; `aria-busy` is set while history loads or a response streams. One polite and one assertive live region announce meaningful changes only (sent, responding, complete, stopped, failed, approval needed), never streamed text. Arriving content never moves focus.
+ * @keyboard Page Down / Page Up move between messages; Ctrl+Home / Ctrl+End leave the feed toward its start or the composer; "Jump to latest" moves focus to the newest message.
+ * @useFor Chat and assistant conversations, including tool use, approvals, artifacts, and branches.
+ * @notFor Activity logs without messages; use `odd-task-plan` or `odd-activity`.
+ * @limitation All messages stay in the DOM (no virtualization) so find-in-page, selection, and assistive technology reading keep working; with 200 messages a streamed snapshot took about 15 ms in Chromium and 30 ms in Firefox (research/experiments/containment, 2026-10-28).
+ * @customization 1 2
+ * @category AI
+ */
+export declare class OddkinConversation extends OddkinConversation_base {
+    #private;
+    static events: {
+        'odd-history-request': import("@oddkin/core/element").EventDefinition<{
+            readonly conversationId: string;
+            readonly beforeMessageId: string | undefined;
+        }>;
+    };
+    readonly _events?: ElementEvents<typeof OddkinConversation>;
+    /** @internal Snapshot read from `store` (mirrors it; never edited). */
+    readonly _snapshot: import("@oddkin/core/reactive").Signal<ConversationState | undefined>;
+    /** @internal Follow-latest policy (presentation state). */
+    readonly _following: import("@oddkin/core/reactive").Signal<boolean>;
+    /** @internal Messages added while reading earlier content. */
+    readonly _unseen: import("@oddkin/core/reactive").Signal<number>;
+    /** @internal Roving tab stop among articles. */
+    readonly _current: import("@oddkin/core/reactive").Signal<string | undefined>;
+    /** @internal */
+    get _strings(): typeof CONVERSATION_STRINGS;
+    /** The snapshot being rendered. */
+    get snapshot(): ConversationState | undefined;
+    /** @internal Tools of the active attempt (for the status bar). */
+    _activeTools(state: ConversationState): ToolCallRecord[];
+    /** @internal */
+    _busy(state: ConversationState | undefined): boolean;
+    /** @internal */
+    _messageLabel(role: string, index: number, count: number): string;
+    /** @internal */
+    readonly _requestHistory: () => void;
+    /** Resume following the latest content and move focus to the newest message. */
+    jumpToLatest(focus?: boolean): void;
+    /** @internal */
+    readonly _jump: () => void;
+    /** The current reading position (to restore later, e.g. per conversation or branch). */
+    getScrollPosition(): ScrollPosition | undefined;
+    /** Restore a position from `getScrollPosition()`. Unknown messages fall back to the latest. */
+    restoreScrollPosition(position: ScrollPosition | undefined): void;
+    protected connected(scope: Scope): void;
+    protected mounted(scope: Scope): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'odd-conversation': OddkinConversation;
+    }
+}
+export {};
+//# sourceMappingURL=conversation.d.ts.map

package/dist/conversation/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAQ,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,eAAO,MAAM,oBAAoB;IAC/B,KAAK;IACL,KAAK;IACL,WAAW;IACX,OAAO;IACP,YAAY;IACZ,KAAK;IACL,IAAI;IACJ,OAAO;IACP,YAAY;IACZ,IAAI;IACJ,SAAS;IACT,MAAM;IACN,IAAI;CACL,CAAC;AAEF,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;;;;;;;;;;gBAgDmC,kBAAkB;;;;;;;;;;;;;;;;;;;AA5CtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAmB,SAAQ,uBA2BtC;;IACA,OAAgB,MAAM;QAAK,qBAAqB;;;;MAAwB;IACxE,SAAiB,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAEpE,uEAAuE;IACvE,QAAQ,CAAC,SAAS,wEAAoD;IACtE,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,kDAAgB;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,iDAAa;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,6DAAyC;IAM1D,gBAAgB;IAChB,IAAI,QAAQ,IAAI,OAAO,oBAAoB,CAE1C;IAED,mCAAmC;IACnC,IAAI,QAAQ,IAAI,iBAAiB,GAAG,SAAS,CAE5C;IAED,kEAAkE;IAClE,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAGvD;IAED,gBAAgB;IAChB,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAInD;IAED,gBAAgB;IAChB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhE;IAED,gBAAgB;IAChB,QAAQ,CAAC,eAAe,QAAO,IAAI,CAOjC;IAEF,gFAAgF;IAChF,YAAY,CAAC,KAAK,UAAO,GAAG,IAAI,CAW/B;IACD,gBAAgB;IAChB,QAAQ,CAAC,KAAK,QAAO,IAAI,CAA4B;IAErD,wFAAwF;IACxF,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAO9C;IAED,+FAA+F;IAC/F,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAShE;IAID,UAAmB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAgB/C;IAED,UAAmB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAyF7C;CA2EF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,kBAAkB,CAAC;KACxC;CACF"}

package/dist/conversation/conversation.define.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="conversation.d.ts" preserve="true" />
+export {};
+//# sourceMappingURL=conversation.define.d.ts.map

package/dist/conversation/conversation.define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.define.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation.define.ts"],"names":[],"mappings":""}

package/dist/conversation/conversation.define.js

@@ -0,0 +1,5 @@
+/// <reference path="./conversation.ts" preserve="true" />
+import { define } from '@oddkin/core/element';
+import { conversationDefinition } from './conversation.definition.js';
+define(conversationDefinition);
+//# sourceMappingURL=conversation.define.js.map

package/dist/conversation/conversation.define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.define.js","sourceRoot":"","sources":["../../src/conversation/conversation.define.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/conversation/conversation.definition.d.ts

@@ -0,0 +1,3 @@
+import { OddkinConversation } from './conversation.js';
+export declare const conversationDefinition: import("@oddkin/core/element").ElementDefinition<OddkinConversation>;
+//# sourceMappingURL=conversation.definition.d.ts.map

package/dist/conversation/conversation.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.definition.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation.definition.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIvD,eAAO,MAAM,sBAAsB,sEAMjC,CAAC"}

package/dist/conversation/conversation.definition.js

@@ -0,0 +1,15 @@
+import { compose } from '@oddkin/core/element';
+import { activityDefinition } from '../activity/activity.definition.js';
+import { aiBaseStyles } from '../internal/base.styles.js';
+import { messageDefinition } from '../message/message.definition.js';
+import { OddkinConversation } from './conversation.js';
+import { conversationStyles } from './conversation.styles.js';
+import { conversationTemplate } from './conversation.template.js';
+export const conversationDefinition = compose({
+    name: 'odd-conversation',
+    element: OddkinConversation,
+    template: conversationTemplate,
+    styles: [aiBaseStyles, conversationStyles],
+    dependencies: { message: messageDefinition, activity: activityDefinition },
+});
+//# sourceMappingURL=conversation.definition.js.map

package/dist/conversation/conversation.definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.definition.js","sourceRoot":"","sources":["../../src/conversation/conversation.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;IAC5C,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EAAE,oBAAoB;IAC9B,MAAM,EAAE,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,YAAY,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,kBAAkB,EAAE;CAC3E,CAAC,CAAC"}

package/dist/conversation/conversation.js

@@ -0,0 +1,327 @@
+import { LiveAnnouncer } from '@oddkin/core/controllers/announce';
+import { ResizeController } from '@oddkin/core/controllers/observe';
+import { OddkinElement, prop } from '@oddkin/core/element';
+import { signal } from '@oddkin/core/reactive';
+import { can } from '../contracts/normalize.js';
+import { DEFAULT_ANNOUNCEMENTS, describeConversationChange, } from '../controllers/announcer.js';
+import { isActive } from '../controllers/transitions.js';
+import { historyRequestEvent } from '../events.js';
+import { format, strings } from '../internal/strings.js';
+export const CONVERSATION_STRINGS = {
+    label: 'Conversation',
+    empty: 'No messages yet.',
+    loadEarlier: 'Load earlier messages',
+    loading: 'Loading earlier messages…',
+    historyError: 'Earlier messages could not be loaded.',
+    retry: 'Try again',
+    jump: 'Jump to latest',
+    jumpNew: 'Jump to latest ({count} new)',
+    messageLabel: '{role}, message {index} of {count}',
+    user: 'You',
+    assistant: 'Assistant',
+    system: 'System',
+    tool: 'Tool',
+};
+const FOLLOW_THRESHOLD = 48;
+/**
+ * A conversation surface: messages as an ARIA feed, history loading, a follow-latest scrolling
+ * policy that respects reading earlier content, a visible-anchor guarantee when history is
+ * prepended or content above changes size, an explicit "Jump to latest", the run status bar,
+ * one announcer for the whole surface, and a slot for the composer. Reads state from one
+ * authoritative source (`store` or `state`); keeps only presentation state.
+ *
+ * @slot composer - The prompt input.
+ * @slot empty - Content shown when there are no messages.
+ * @slot status - Extra status content (usage, model) above the composer.
+ * @csspart base - The column of the scroll container, the run status, and the composer.
+ * @csspart scroller - The scroll container.
+ * @csspart feed - The feed of messages.
+ * @csspart jump - The "Jump to latest" button.
+ * @csspart activity - The run status bar.
+ * @cssprop --odd-conversation-max-width - Maximum line length of the feed.
+ * @a11y Messages are `article`s in a `feed` with position and size; `aria-busy` is set while history loads or a response streams. One polite and one assertive live region announce meaningful changes only (sent, responding, complete, stopped, failed, approval needed), never streamed text. Arriving content never moves focus.
+ * @keyboard Page Down / Page Up move between messages; Ctrl+Home / Ctrl+End leave the feed toward its start or the composer; "Jump to latest" moves focus to the newest message.
+ * @useFor Chat and assistant conversations, including tool use, approvals, artifacts, and branches.
+ * @notFor Activity logs without messages; use `odd-task-plan` or `odd-activity`.
+ * @limitation All messages stay in the DOM (no virtualization) so find-in-page, selection, and assistive technology reading keep working; with 200 messages a streamed snapshot took about 15 ms in Chromium and 30 ms in Firefox (research/experiments/containment, 2026-10-28).
+ * @customization 1 2
+ * @category AI
+ */
+export class OddkinConversation extends OddkinElement.with({
+    store: prop.object({
+        description: 'Authoritative state (a controller or an external store).',
+    }),
+    state: prop.object({
+        description: 'Controlled snapshot, used when no `store` is set.',
+    }),
+    label: prop.string({ default: '', description: 'Accessible name of the feed.' }),
+    announce: prop.enum(['none', 'important', 'all'], {
+        default: 'important',
+        empty: 'important',
+        description: 'How much the surface announces.',
+    }),
+    markdown: prop.object({ description: 'Markdown options for every message.' }),
+    renderers: prop.object({
+        description: 'Validated renderers for `data` parts.',
+    }),
+    artifactRenderers: prop.object({
+        description: 'Artifact renderers by kind.',
+    }),
+    renderTool: prop.object({
+        description: 'Renderer for tool results.',
+    }),
+    feedbackReasons: prop.array({ description: 'Reasons offered for negative feedback.' }),
+    strings: prop.object({
+        description: 'Localized string overrides (including announcements).',
+    }),
+}) {
+    static events = { 'odd-history-request': historyRequestEvent };
+    /** @internal Snapshot read from `store` (mirrors it; never edited). */
+    _snapshot = signal(undefined);
+    /** @internal Follow-latest policy (presentation state). */
+    _following = signal(true);
+    /** @internal Messages added while reading earlier content. */
+    _unseen = signal(0);
+    /** @internal Roving tab stop among articles. */
+    _current = signal(undefined);
+    #anchor;
+    #programmatic = false;
+    #positions = new Map();
+    /** @internal */
+    get _strings() {
+        return strings(CONVERSATION_STRINGS, this.strings);
+    }
+    /** The snapshot being rendered. */
+    get snapshot() {
+        return this.store ? this._snapshot.value : this.state;
+    }
+    /** @internal Tools of the active attempt (for the status bar). */
+    _activeTools(state) {
+        const id = state.activeAttemptId;
+        return id ? Object.values(state.tools).filter((t) => t.attemptId === id) : [];
+    }
+    /** @internal */
+    _busy(state) {
+        if (!state)
+            return false;
+        const attempt = state.activeAttemptId ? state.attempts[state.activeAttemptId] : undefined;
+        return state.history === 'loading' || (!!attempt && isActive(attempt.status));
+    }
+    /** @internal */
+    _messageLabel(role, index, count) {
+        const t = this._strings;
+        return format(t.messageLabel, { role: t[role] ?? role, index, count });
+    }
+    /** @internal */
+    _requestHistory = () => {
+        const state = this.snapshot;
+        if (!state || state.history === 'loading' || !can(state.capabilities, 'history'))
+            return;
+        this.emit(historyRequestEvent, {
+            conversationId: state.conversationId,
+            beforeMessageId: state.messages[0]?.id,
+        });
+    };
+    /** Resume following the latest content and move focus to the newest message. */
+    jumpToLatest(focus = true) {
+        this._following.value = true;
+        this._unseen.value = 0;
+        this.#scrollToEnd();
+        if (focus) {
+            const last = [...this.#articles()].pop();
+            if (last) {
+                this._current.value = last.dataset['id'];
+                last.focus({ preventScroll: true });
+            }
+        }
+    }
+    /** @internal */
+    _jump = () => this.jumpToLatest(true);
+    /** The current reading position (to restore later, e.g. per conversation or branch). */
+    getScrollPosition() {
+        const scroller = this.#scroller();
+        if (!scroller)
+            return undefined;
+        const anchor = this.#findAnchor(scroller);
+        return anchor
+            ? { messageId: anchor.id, offset: anchor.offset, following: this._following.peek() }
+            : undefined;
+    }
+    /** Restore a position from `getScrollPosition()`. Unknown messages fall back to the latest. */
+    restoreScrollPosition(position) {
+        const scroller = this.#scroller();
+        if (!scroller)
+            return;
+        if (!position || position.following)
+            return this.jumpToLatest(false);
+        const article = this.#article(position.messageId);
+        if (!article)
+            return this.jumpToLatest(false);
+        this._following.value = false;
+        this.#anchor = { id: position.messageId, offset: position.offset };
+        this.#restoreAnchor(scroller);
+    }
+    // ---- Lifecycle ----
+    connected(scope) {
+        scope.effect((run) => {
+            const source = this.store;
+            if (!source) {
+                this._snapshot.value = undefined;
+                return;
+            }
+            this._snapshot.value = source.getSnapshot();
+            const unsubscribe = source.subscribe(() => {
+                this._snapshot.value = source.getSnapshot();
+            });
+            run.add(unsubscribe, 'conversation store');
+        }, { name: '<odd-conversation> store' });
+    }
+    mounted(scope) {
+        const root = this.shadowRoot;
+        const scroller = this.#scroller();
+        const feed = root?.querySelector('[part="feed"]');
+        const polite = root?.querySelector('#polite');
+        const assertive = root?.querySelector('#assertive');
+        if (!root || !scroller || !feed || !polite || !assertive)
+            return;
+        // One announcer per surface; descendants' `odd-announce` events are routed to it.
+        const announcer = scope.use(new LiveAnnouncer({
+            regions: () => ({ polite, assertive }),
+            event: 'odd-announce',
+            target: () => this,
+        }));
+        let previous;
+        let previousIds = [];
+        scope.effect(() => {
+            const state = this.snapshot;
+            const level = this.announce;
+            const t = {
+                ...DEFAULT_ANNOUNCEMENTS,
+                ...this.strings,
+            };
+            if (state && previous && previous.conversationId !== state.conversationId) {
+                // Presentation state per conversation: save the old position, restore the new one.
+                const position = this.getScrollPosition();
+                if (position)
+                    this.#positions.set(previous.conversationId, position);
+                announcer.reset();
+                previousIds = [];
+                queueMicrotask(() => this.restoreScrollPosition(this.#positions.get(state.conversationId)));
+            }
+            if (state)
+                for (const detail of describeConversationChange(previous, state, level, t))
+                    announcer.announce(detail);
+            const ids = state?.messages.map((m) => m.id) ?? [];
+            const grew = ids.length - previousIds.length;
+            // Only appended messages count as unseen (a prepended history page does not).
+            if (!this._following.peek() && grew > 0 && previousIds.length && ids[0] === previousIds[0])
+                this._unseen.value = this._unseen.peek() + grew;
+            previous = state;
+            previousIds = ids;
+        }, { phase: 'post', name: '<odd-conversation> announce' });
+        // Follow policy: the user scrolling away stops following; returning near the end resumes.
+        scope.listen(scroller, 'scroll', () => {
+            if (this.#programmatic)
+                return;
+            const distance = scroller.scrollHeight - scroller.scrollTop - scroller.clientHeight;
+            const following = distance <= FOLLOW_THRESHOLD;
+            if (following !== this._following.peek())
+                this._following.value = following;
+            if (following)
+                this._unseen.value = 0;
+            this.#anchor = following ? undefined : this.#findAnchor(scroller);
+        }, { passive: true });
+        // Late layout (streaming text, images, fonts, prepended history): keep the latest content in
+        // view when following, otherwise keep the reading anchor where it was. The correction is
+        // measured from current geometry, so it is a no-op wherever native scroll anchoring already
+        // kept the anchor in place (never a second adjustment), and it covers engines without it.
+        // Runs in the observer callback, before paint.
+        scope.use(new ResizeController(() => {
+            if (this._following.peek())
+                this.#scrollToEnd();
+            else
+                this.#restoreAnchor(scroller);
+        }, { targets: () => [feed] }));
+        scope.listen(feed, 'keydown', (event) => this.#onFeedKey(event));
+        scope.listen(feed, 'focusin', (event) => {
+            const article = event.composedPath().find((el) => el instanceof HTMLElement && el.dataset?.['id'] && el.parentElement === feed);
+            if (article)
+                this._current.value = article.dataset['id'];
+        });
+        queueMicrotask(() => this.#scrollToEnd());
+    }
+    // ---- Scrolling ----
+    #scroller() {
+        return this.shadowRoot?.querySelector('[part="scroller"]');
+    }
+    #articles() {
+        return [
+            ...(this.shadowRoot?.querySelectorAll('[part="feed"] > odd-message') ?? []),
+        ];
+    }
+    #article(id) {
+        return this.#articles().find((a) => a.dataset['id'] === id);
+    }
+    #findAnchor(scroller) {
+        const top = scroller.getBoundingClientRect().top;
+        for (const article of this.#articles()) {
+            const rect = article.getBoundingClientRect();
+            if (rect.bottom > top + 1)
+                return { id: article.dataset['id'], offset: rect.top - top };
+        }
+        return undefined;
+    }
+    #restoreAnchor(scroller) {
+        const anchor = this.#anchor;
+        const article = anchor ? this.#article(anchor.id) : undefined;
+        if (!anchor || !article)
+            return;
+        const delta = article.getBoundingClientRect().top - scroller.getBoundingClientRect().top - anchor.offset;
+        if (Math.abs(delta) < 0.5)
+            return;
+        this.#setScrollTop(scroller, scroller.scrollTop + delta);
+    }
+    #scrollToEnd() {
+        const scroller = this.#scroller();
+        if (scroller)
+            this.#setScrollTop(scroller, scroller.scrollHeight);
+    }
+    #setScrollTop(scroller, top) {
+        this.#programmatic = true;
+        scroller.scrollTop = top;
+        // Scroll events from this write are dispatched before the next frame.
+        requestAnimationFrame(() => (this.#programmatic = false));
+    }
+    // ---- Feed keyboard (WAI-ARIA feed pattern) ----
+    #onFeedKey(event) {
+        const articles = this.#articles();
+        if (!articles.length)
+            return;
+        const index = articles.findIndex((a) => a.dataset['id'] === this._current.peek());
+        let target;
+        if (event.key === 'PageDown')
+            target = articles[Math.min(articles.length - 1, index + 1)];
+        else if (event.key === 'PageUp')
+            target = articles[Math.max(0, index - 1)];
+        else if (event.key === 'End' && event.ctrlKey) {
+            event.preventDefault();
+            const composer = this.querySelector('[slot="composer"]');
+            composer?.focus();
+            return;
+        }
+        else if (event.key === 'Home' && event.ctrlKey) {
+            event.preventDefault();
+            this.shadowRoot?.querySelector('.history button:not([hidden])')?.focus() ??
+                this.#scroller()?.focus();
+            return;
+        }
+        else
+            return;
+        event.preventDefault();
+        if (!target)
+            return;
+        this._current.value = target.dataset['id'];
+        target.focus();
+    }
+}
+//# sourceMappingURL=conversation.js.map

package/dist/conversation/conversation.js.map

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

package/dist/conversation/conversation.recipe.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Arrangement of the conversation (layout-recipes.md §14): the scroller above the composer, the
+ * messages of the feed, and the history and empty rows, centred and wrapping.
+ */
+export declare const conversationRecipe: import("@oddkin/components/layout").LayoutRecipe;
+//# sourceMappingURL=conversation.recipe.d.ts.map

package/dist/conversation/conversation.recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.recipe.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation.recipe.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,kDAQ7B,CAAC"}

package/dist/conversation/conversation.recipe.js

@@ -0,0 +1,16 @@
+import { defineLayoutRecipe, row, stack } from '@oddkin/components/layout';
+import { token } from '@oddkin/tokens/refs';
+/**
+ * Arrangement of the conversation (layout-recipes.md §14): the scroller above the composer, the
+ * messages of the feed, and the history and empty rows, centred and wrapping.
+ */
+export const conversationRecipe = defineLayoutRecipe({
+    name: 'conversation',
+    regions: {
+        base: stack({ gap: token('space.xs') }),
+        feed: stack({ gap: token('space.lg') }),
+        history: row({ gap: token('space.xs'), align: 'stretch', wrap: true, justify: 'center' }),
+        empty: row({ gap: token('space.xs'), align: 'stretch', wrap: true, justify: 'center' }),
+    },
+});
+//# sourceMappingURL=conversation.recipe.js.map

package/dist/conversation/conversation.recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.recipe.js","sourceRoot":"","sources":["../../src/conversation/conversation.recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;IACnD,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE;QACP,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QACzF,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;KACxF;CACF,CAAC,CAAC"}

package/dist/conversation/conversation.recipe.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const conversationRecipeStyles: import("@oddkin/core/styles").CSSResult;
+//# sourceMappingURL=conversation.recipe.styles.d.ts.map

package/dist/conversation/conversation.recipe.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.recipe.styles.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation.recipe.styles.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,wBAAwB,yCAEpC,CAAC"}

package/dist/conversation/conversation.recipe.styles.js

@@ -0,0 +1,5 @@
+// Generated from ./conversation.recipe.ts by packages/ai/test/recipes.test.ts (UPDATE_FIXTURES=1).
+// Do not edit: change the recipe and regenerate.
+import { unsafeCSS } from '@oddkin/core/styles';
+export const conversationRecipeStyles = unsafeCSS('@layer odd.layout.base {\n  .base {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-xs);\n    min-inline-size: 0;\n  }\n  .feed {\n    display: flex;\n    flex-direction: column;\n    gap: var(--odd-space-lg);\n    min-inline-size: 0;\n  }\n  .history {\n    display: flex;\n    flex-direction: row;\n    align-items: stretch;\n    gap: var(--odd-space-xs);\n    flex-wrap: wrap;\n    min-inline-size: 0;\n    justify-content: center;\n  }\n  .empty {\n    display: flex;\n    flex-direction: row;\n    align-items: stretch;\n    gap: var(--odd-space-xs);\n    flex-wrap: wrap;\n    min-inline-size: 0;\n    justify-content: center;\n  }\n}\n');
+//# sourceMappingURL=conversation.recipe.styles.js.map

package/dist/conversation/conversation.recipe.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.recipe.styles.js","sourceRoot":"","sources":["../../src/conversation/conversation.recipe.styles.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,iDAAiD;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAC/C,+pBAA+pB,CAChqB,CAAC"}

package/dist/conversation/conversation.styles.d.ts

@@ -0,0 +1,3 @@
+/** The arrangement is the layout recipe in `conversation.recipe.ts`. */
+export declare const conversationStyles: import("@oddkin/core/styles").CSSResult;
+//# sourceMappingURL=conversation.styles.d.ts.map

package/dist/conversation/conversation.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.styles.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation.styles.ts"],"names":[],"mappings":"AAIA,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,yCA4D9B,CAAC"}