@nocobase/app-plugin-agents 0.0.0-stage → 0.1.0-beta.1

package/dist/client/chat/api.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The browser API of the chat (`CHAT_ROUTES` in `shared/conversations`) and of the agent presets, typed with the
+ * shared contract. One method per endpoint; answers are unwrapped from `{ data }` (a page of conversations or messages
+ * is put back together from `{ data, meta }`); failures throw `ApiClientError`.
+ */
+import type { ApiClient } from '@nocobase/app-client';
+import type { Agent } from '../../shared/agents.js';
+import { type ChatAgent, type ChatPreferences, type ChatPreferencesPatch, type ChatSettings, type ChatSettingsPatch, type ConversationDetail, type ConversationListQuery, type ConversationPage, type ConversationPatch, type CopyAgentRequest, type CreateConversationRequest, type MessageAttachment, type MessageListQuery, type MessagePage, type SendMessageRequest, type SendMessageResult } from '../../shared/conversations.js';
+import { type AgentPreset } from '../../shared/presets.js';
+export declare class ChatApi {
+    private readonly api;
+    constructor(api: ApiClient);
+    conversations(query?: ConversationListQuery): Promise<ConversationPage>;
+    createConversation(request: CreateConversationRequest): Promise<ConversationDetail>;
+    conversation(id: string): Promise<ConversationDetail>;
+    updateConversation(id: string, patch: ConversationPatch): Promise<ConversationDetail>;
+    /** A page of messages; `nextCursor` asks for the older ones. */
+    messages(id: string, query?: MessageListQuery): Promise<MessagePage & {
+        readonly nextCursor: string | null;
+    }>;
+    sendMessage(id: string, request: SendMessageRequest): Promise<SendMessageResult>;
+    /** Uploads a file to send with a message; it is the caller's alone until sent (`attachmentIds`). */
+    uploadAttachment(file: File, signal?: AbortSignal): Promise<MessageAttachment>;
+    /** Discards an upload not sent yet. */
+    discardAttachment(id: string): Promise<void>;
+    markRead(id: string): Promise<ConversationDetail>;
+    stop(id: string): Promise<ConversationDetail>;
+    fallback(id: string): Promise<ConversationDetail>;
+    restore(id: string): Promise<ConversationDetail>;
+    agents(): Promise<ChatAgent[]>;
+    copyAgent(agentId: string, request: CopyAgentRequest): Promise<Agent>;
+    preferences(): Promise<ChatPreferences>;
+    updatePreferences(patch: ChatPreferencesPatch): Promise<ChatPreferences>;
+    settings(): Promise<ChatSettings>;
+    updateSettings(patch: ChatSettingsPatch): Promise<ChatSettings>;
+    presets(): Promise<AgentPreset[]>;
+    private page;
+    private get;
+    private read;
+    private send;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/client/chat/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../client/chat/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAE1B,KAAK,gBAAgB,EAErB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAiB1E,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;gBAEb,GAAG,EAAE,SAAS;IAIpB,aAAa,CACxB,KAAK,GAAE,qBAA0B,GAChC,OAAO,CAAC,gBAAgB,CAAC;IAmBrB,kBAAkB,CACvB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC;IAIvB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIrD,kBAAkB,CACvB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC;IAI9B,gEAAgE;IACnD,QAAQ,CACnB,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,gBAAqB,GAC3B,OAAO,CAAC,WAAW,GAAG;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAczD,WAAW,CAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAI7B,oGAAoG;IACvF,gBAAgB,CAC3B,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC;IAc7B,uCAAuC;IAC1B,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI7C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI1C,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIpC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAIrE,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAIvC,iBAAiB,CACtB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,eAAe,CAAC;IAIpB,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAIjC,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzD,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9C,OAAO,CAAC,IAAI;YAUE,GAAG;IAIjB,OAAO,CAAC,IAAI;YAQE,IAAI;CAYnB"}

package/dist/client/chat/api.js

@@ -0,0 +1,125 @@
+import { chatPath, } from '../../shared/conversations.js';
+import { PRESETS_ROUTE } from '../../shared/presets.js';
+function tokenOf(value) {
+    return typeof value === 'string' && value !== '' ? value : null;
+}
+function clean(query) {
+    return Object.fromEntries(Object.entries(query).filter((entry) => entry[1] !== undefined && entry[1] !== ''));
+}
+export class ChatApi {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async conversations(query = {}) {
+        const page = await this.page(chatPath('conversations'), {
+            q: query.q,
+            archived: query.archived === undefined ? undefined : String(query.archived),
+            agentId: query.agentId,
+            source: query.source,
+            pageToken: query.pageToken,
+            pageSize: query.pageSize,
+        });
+        return {
+            items: page.data,
+            nextCursor: tokenOf(page.meta.nextPageToken),
+        };
+    }
+    createConversation(request) {
+        return this.send(chatPath('conversations'), 'POST', request);
+    }
+    conversation(id) {
+        return this.get(chatPath('conversation', id));
+    }
+    updateConversation(id, patch) {
+        return this.send(chatPath('conversation', id), 'PATCH', patch);
+    }
+    /** A page of messages; `nextCursor` asks for the older ones. */
+    async messages(id, query = {}) {
+        const page = await this.page(chatPath('messages', id), { ...query });
+        const nextCursor = tokenOf(page.meta.nextPageToken);
+        return {
+            items: page.data,
+            hasMore: nextCursor !== null,
+            lastSeq: Number(page.meta.lastSeq ?? 0),
+            nextCursor,
+        };
+    }
+    sendMessage(id, request) {
+        return this.send(chatPath('messages', id), 'POST', request);
+    }
+    /** Uploads a file to send with a message; it is the caller's alone until sent (`attachmentIds`). */
+    async uploadAttachment(file, signal) {
+        const form = new FormData();
+        form.set('file', file);
+        const { data } = await this.api.request({
+            path: chatPath('attachments'),
+            method: 'POST',
+            body: form,
+            ...(signal ? { signal } : {}),
+        });
+        return data;
+    }
+    /** Discards an upload not sent yet. */
+    async discardAttachment(id) {
+        await this.api.request({
+            path: chatPath('attachment', id),
+            method: 'DELETE',
+        });
+    }
+    markRead(id) {
+        return this.send(chatPath('markRead', id), 'POST');
+    }
+    stop(id) {
+        return this.send(chatPath('stop', id), 'POST');
+    }
+    fallback(id) {
+        return this.send(chatPath('fallback', id), 'POST');
+    }
+    restore(id) {
+        return this.send(chatPath('restore', id), 'POST');
+    }
+    async agents() {
+        return (await this.page(chatPath('agents'))).data;
+    }
+    copyAgent(agentId, request) {
+        return this.send(chatPath('copyAgent', agentId), 'POST', request);
+    }
+    preferences() {
+        return this.get(chatPath('preferences'));
+    }
+    updatePreferences(patch) {
+        return this.send(chatPath('preferences'), 'PATCH', patch);
+    }
+    settings() {
+        return this.get(chatPath('settings'));
+    }
+    updateSettings(patch) {
+        return this.send(chatPath('settings'), 'PATCH', patch);
+    }
+    async presets() {
+        return (await this.page(PRESETS_ROUTE)).data;
+    }
+    page(path, query) {
+        return this.read(path, query);
+    }
+    async get(path, query) {
+        return (await this.read(path, query)).data;
+    }
+    read(path, query) {
+        const values = query ? clean(query) : {};
+        return this.api.request({
+            path,
+            ...(Object.keys(values).length > 0 ? { query: values } : {}),
+        });
+    }
+    async send(path, method, json) {
+        const { data } = await this.api.request({
+            path,
+            method,
+            ...(json === undefined ? {} : { json }),
+        });
+        return data;
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/client/chat/api.js.map

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

package/dist/client/chat/context-model.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The page context a chat message carries (`PageContext` in `shared/conversations`), as plain data. Pages register
+ * what they show (an object, a list filter); the panel keeps the last text selected on the page and the objects an
+ * "Ask agent" button pinned. The composer shows all of it as removable chips and sends ids only: a chip's label is for
+ * the person, the server resolves its own titles.
+ */
+import { type PageContext, type PageContextRef } from '../../shared/conversations.js';
+/** An object a page shows, with what its chip says (a record's key and title, an agent's name). */
+export interface ChatContextItem extends PageContextRef {
+    readonly label: string;
+}
+/** A list page's filter: which list (such as `inbox`) and the parameters it applies. */
+export interface ChatContextFilter {
+    readonly page: string;
+    readonly params: Readonly<Record<string, string>>;
+    /** What the chip says instead of the raw parameters (`status=open`), such as the names they stand for. Shown only. */
+    readonly label?: string;
+}
+export interface ChatSelection {
+    readonly text: string;
+    readonly source?: PageContextRef;
+}
+export type ChatContextChip = {
+    readonly key: string;
+    readonly kind: 'item';
+    readonly item: ChatContextItem;
+    readonly pinned: boolean;
+} | {
+    readonly key: string;
+    readonly kind: 'filter';
+    readonly filter: ChatContextFilter;
+} | {
+    readonly key: string;
+    readonly kind: 'selection';
+    readonly selection: ChatSelection;
+};
+export interface ChatContextInput {
+    /** pathname + search of the page the message is written on. */
+    readonly route: string;
+    /** Objects an "Ask agent" button brought in: kept across pages until the message is sent or they are removed. */
+    readonly pinned: readonly ChatContextItem[];
+    /** Objects the current page registered. */
+    readonly sources: readonly ChatContextItem[];
+    readonly filter: ChatContextFilter | null;
+    readonly selection: ChatSelection | null;
+    /** Chip keys the person removed on this page. */
+    readonly removed: ReadonlySet<string>;
+}
+export declare const SELECTION_KEY = "selection";
+export declare const FILTER_KEY = "filter";
+export declare function itemKey(item: PageContextRef): string;
+/** The chips above the composer: pinned objects first, each object once, capped like the payload. */
+export declare function contextChips(input: ChatContextInput): ChatContextChip[];
+/** The `context` of a message: what the chips show, ids only, within `PAGE_CONTEXT_LIMITS`. */
+export declare function buildPageContext(input: ChatContextInput): PageContext | undefined;
+/** Selected text as it is sent: trimmed and cut at the limit; empty is no selection. */
+export declare function clampSelection(text: string): string | null;
+/** `data-chat-source="<kind>:<id>"` on an ancestor of a selection names the object the text comes from. */
+export declare const SOURCE_ATTRIBUTE = "data-chat-source";
+export declare function parseSourceAttribute(value: string | null | undefined): PageContextRef | null;
+/** A short, single-line quote of a selection for its chip. */
+export declare function selectionPreview(text: string, max?: number): string;
+/** "status=open, owner=me" for a filter chip. */
+export declare function filterText(filter: {
+    readonly params: Readonly<Record<string, string>>;
+}): string;
+//# sourceMappingURL=context-model.d.ts.map

package/dist/client/chat/context-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-model.d.ts","sourceRoot":"","sources":["../../../client/chat/context-model.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,+BAA+B,CAAC;AAEvC,mGAAmG;AACnG,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,sHAAsH;IACtH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC,GACD;IACE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iHAAiH;IACjH,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IACzC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAEpD;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe,EAAE,CAwBvE;AAMD,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,GACtB,WAAW,GAAG,SAAS,CAwCzB;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI1D;AAED,2GAA2G;AAC3G,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,cAAc,GAAG,IAAI,CAOvB;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAG/D;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD,GAAG,MAAM,CAIT"}

package/dist/client/chat/context-model.js

@@ -0,0 +1,113 @@
+/**
+ * The page context a chat message carries (`PageContext` in `shared/conversations`), as plain data. Pages register
+ * what they show (an object, a list filter); the panel keeps the last text selected on the page and the objects an
+ * "Ask agent" button pinned. The composer shows all of it as removable chips and sends ids only: a chip's label is for
+ * the person, the server resolves its own titles.
+ */
+import { PAGE_CONTEXT_LIMITS, } from '../../shared/conversations.js';
+export const SELECTION_KEY = 'selection';
+export const FILTER_KEY = 'filter';
+export function itemKey(item) {
+    return `${item.kind}:${item.id}`;
+}
+/** The chips above the composer: pinned objects first, each object once, capped like the payload. */
+export function contextChips(input) {
+    const chips = [];
+    const seen = new Set();
+    const pinned = new Set(input.pinned.map(itemKey));
+    for (const item of [...input.pinned, ...input.sources]) {
+        const key = itemKey(item);
+        if (seen.has(key) || input.removed.has(key))
+            continue;
+        if (seen.size >= PAGE_CONTEXT_LIMITS.items)
+            break;
+        seen.add(key);
+        chips.push({ key, kind: 'item', item, pinned: pinned.has(key) });
+    }
+    if (input.filter &&
+        !input.removed.has(FILTER_KEY) &&
+        Object.keys(input.filter.params).length > 0)
+        chips.push({ key: FILTER_KEY, kind: 'filter', filter: input.filter });
+    if (input.selection && !input.removed.has(SELECTION_KEY))
+        chips.push({
+            key: SELECTION_KEY,
+            kind: 'selection',
+            selection: input.selection,
+        });
+    return chips;
+}
+function clip(value, max) {
+    return value.length > max ? value.slice(0, max) : value;
+}
+/** The `context` of a message: what the chips show, ids only, within `PAGE_CONTEXT_LIMITS`. */
+export function buildPageContext(input) {
+    const items = [];
+    let filter;
+    let selection;
+    for (const chip of contextChips(input)) {
+        if (chip.kind === 'item')
+            items.push({ kind: chip.item.kind, id: chip.item.id });
+        else if (chip.kind === 'filter') {
+            const params = Object.fromEntries(Object.entries(chip.filter.params)
+                .slice(0, PAGE_CONTEXT_LIMITS.filterKeys)
+                .map(([key, value]) => [
+                key,
+                clip(value, PAGE_CONTEXT_LIMITS.filterValue),
+            ]));
+            const label = chip.filter.label?.trim();
+            filter = {
+                page: chip.filter.page,
+                params,
+                ...(label
+                    ? { label: clip(label, PAGE_CONTEXT_LIMITS.filterLabel) }
+                    : {}),
+            };
+        }
+        else
+            selection = {
+                text: clip(chip.selection.text, PAGE_CONTEXT_LIMITS.selection),
+                ...(chip.selection.source ? { source: chip.selection.source } : {}),
+            };
+    }
+    const route = clip(input.route, PAGE_CONTEXT_LIMITS.route);
+    if (items.length === 0 && !filter && !selection) {
+        return route ? { route, items } : undefined;
+    }
+    return {
+        route,
+        items,
+        ...(filter ? { filter } : {}),
+        ...(selection ? { selection } : {}),
+    };
+}
+/** Selected text as it is sent: trimmed and cut at the limit; empty is no selection. */
+export function clampSelection(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return null;
+    return clip(trimmed, PAGE_CONTEXT_LIMITS.selection);
+}
+/** `data-chat-source="<kind>:<id>"` on an ancestor of a selection names the object the text comes from. */
+export const SOURCE_ATTRIBUTE = 'data-chat-source';
+export function parseSourceAttribute(value) {
+    if (!value)
+        return null;
+    const index = value.indexOf(':');
+    if (index <= 0)
+        return null;
+    const kind = value.slice(0, index);
+    const id = value.slice(index + 1);
+    return id ? { kind, id } : null;
+}
+/** A short, single-line quote of a selection for its chip. */
+export function selectionPreview(text, max = 40) {
+    const line = text.replace(/\s+/gu, ' ').trim();
+    return line.length > max ? `${line.slice(0, max - 1)}…` : line;
+}
+/** "status=open, owner=me" for a filter chip. */
+export function filterText(filter) {
+    return Object.entries(filter.params)
+        .map(([key, value]) => `${key}=${value}`)
+        .join(', ');
+}
+//# sourceMappingURL=context-model.js.map

package/dist/client/chat/context-model.js.map

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

package/dist/client/chat/extensions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * What an application adds to the chat panel from plugins the agents plugin does not depend on (such as an application's are in
+ * `client/agents/chat.tsx`): items placed among a conversation's messages (cards of what the agent proposed),
+ * something under a message, and the wording of the news it delivers, or a card in its place. Without a binding the
+ * panel shows messages only.
+ */
+import { type Context, type ReactNode } from 'react';
+import type { ConversationMessage } from '../../shared/conversations.js';
+import type { NewsNotice, Translate } from './message-model.js';
+/** Something that belongs in a conversation besides its messages, placed by time among them. */
+export interface ChatTimelineItem {
+    /** Unique within the conversation, stable across renders. */
+    readonly key: string;
+    /** ISO 8601: the item follows the messages created at or before it. */
+    readonly at: string;
+    readonly node: ReactNode;
+}
+export interface ChatExtensions {
+    /**
+     * A hook (called on every render of an open conversation, so it must be the same function for the panel's life):
+     * the conversation's other items, such as plan cards. `revision` changes whenever the conversation's messages or
+     * run change, so the hook can refetch.
+     */
+    readonly useTimelineItems?: (conversationId: string, revision: number) => readonly ChatTimelineItem[];
+    /** Renders under a message, by its metadata; null for nothing. */
+    readonly renderMessageExtra?: (message: ConversationMessage) => ReactNode;
+    /**
+     * A news notice the application delivered, in the viewer's language (`t` takes `ns` for the application's own
+     * namespace); null shows its English title.
+     */
+    readonly newsText?: (notice: NewsNotice, t: Translate) => string | null;
+    /**
+     * A news notice the application shows as a card of its own instead of the centred line (an event it follows, with
+     * links and actions); null for the line. Called while rendering, so it may return components that use hooks.
+     */
+    readonly renderNews?: (notice: NewsNotice, message: ConversationMessage) => ReactNode;
+}
+export declare const ChatExtensionsContext: Context<ChatExtensions>;
+/** The default `useTimelineItems`: nothing. */
+export declare function noTimelineItems(): readonly ChatTimelineItem[];
+//# sourceMappingURL=extensions.d.ts.map

package/dist/client/chat/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../client/chat/extensions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEhE,gGAAgG;AAChG,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,KACb,SAAS,gBAAgB,EAAE,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,SAAS,CAAC;IAC1E;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,CAAC;IACxE;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CACpB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,mBAAmB,KACzB,SAAS,CAAC;CAChB;AAED,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,cAAc,CACvB,CAAC;AAIpC,+CAA+C;AAC/C,wBAAgB,eAAe,IAAI,SAAS,gBAAgB,EAAE,CAE7D"}

package/dist/client/chat/extensions.js

@@ -0,0 +1,14 @@
+/**
+ * What an application adds to the chat panel from plugins the agents plugin does not depend on (such as an application's are in
+ * `client/agents/chat.tsx`): items placed among a conversation's messages (cards of what the agent proposed),
+ * something under a message, and the wording of the news it delivers, or a card in its place. Without a binding the
+ * panel shows messages only.
+ */
+import { createContext } from 'react';
+export const ChatExtensionsContext = createContext({});
+const NO_ITEMS = [];
+/** The default `useTimelineItems`: nothing. */
+export function noTimelineItems() {
+    return NO_ITEMS;
+}
+//# sourceMappingURL=extensions.js.map

package/dist/client/chat/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../../client/chat/extensions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAgC,MAAM,OAAO,CAAC;AAyCpE,MAAM,CAAC,MAAM,qBAAqB,GAChC,aAAa,CAAiB,EAAE,CAAC,CAAC;AAEpC,MAAM,QAAQ,GAAgC,EAAE,CAAC;AAEjD,+CAA+C;AAC/C,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/client/chat/keys.d.ts

@@ -0,0 +1,13 @@
+import type { ConversationListQuery } from '../../shared/conversations.js';
+/** Query keys of the chat, all under `['agents', 'chat']`, so invalidating the prefix refreshes every chat view. */
+export declare const chatKeys: {
+    readonly all: readonly ['agents', 'chat'];
+    readonly lists: readonly ['agents', 'chat', 'conversations'];
+    readonly list: (query: ConversationListQuery) => readonly ['agents', 'chat', 'conversations', ConversationListQuery];
+    readonly conversation: (id: string) => readonly ['agents', 'chat', 'conversation', string];
+    readonly agents: readonly ['agents', 'chat', 'agents'];
+    readonly preferences: readonly ['agents', 'chat', 'preferences'];
+    readonly settings: readonly ['agents', 'chat', 'settings'];
+    readonly presets: readonly ['agents', 'chat', 'presets'];
+};
+//# sourceMappingURL=keys.d.ts.map

package/dist/client/chat/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../client/chat/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,oHAAoH;AACpH,eAAO,MAAM,QAAQ,EAAE;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,CACb,KAAK,EAAE,qBAAqB,KACzB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,qBAAqB,CAAC,CAAC;IACzE,QAAQ,CAAC,YAAY,EAAE,CACrB,EAAE,EAAE,MAAM,KACP,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvD,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;CAU1D,CAAC"}

package/dist/client/chat/keys.js

@@ -0,0 +1,12 @@
+/** Query keys of the chat, all under `['agents', 'chat']`, so invalidating the prefix refreshes every chat view. */
+export const chatKeys = {
+    all: ['agents', 'chat'],
+    lists: ['agents', 'chat', 'conversations'],
+    list: (query) => ['agents', 'chat', 'conversations', query],
+    conversation: (id) => ['agents', 'chat', 'conversation', id],
+    agents: ['agents', 'chat', 'agents'],
+    preferences: ['agents', 'chat', 'preferences'],
+    settings: ['agents', 'chat', 'settings'],
+    presets: ['agents', 'chat', 'presets'],
+};
+//# sourceMappingURL=keys.js.map

package/dist/client/chat/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../client/chat/keys.ts"],"names":[],"mappings":"AAEA,oHAAoH;AACpH,MAAM,CAAC,MAAM,QAAQ,GAajB;IACF,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC;IAC1C,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC;IAC3D,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC;IAC5D,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;IACpC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC;IAC9C,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC;IACxC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;CACvC,CAAC"}

package/dist/client/chat/message-model.d.ts

@@ -0,0 +1,111 @@
+/**
+ * A conversation's messages in the browser, as plain data: the pages fetched so far merged by `seq`, the messages the
+ * person sent that the server has not confirmed yet (optimistic, replaced once a message with the same
+ * `metadata.clientId` arrives), and the step line of the run that is answering. An online agent's reply arrives as a
+ * draft that grows in place at the same `seq` (`metadata.streaming`): merging by `seq` replaces it with each fetch.
+ */
+import type { RunEvent } from '@nocobase/agent-protocol';
+import type { ChatAgent, ConversationMessage, ConversationNotice, MessageAttachment, MessagePage, PageContext } from '../../shared/conversations.js';
+/** A message the person sent, shown until the server's copy arrives. */
+export interface PendingMessage {
+    readonly clientId: string;
+    readonly content: string;
+    readonly context: PageContext | undefined;
+    /** The files sent with it, already uploaded. */
+    readonly attachments?: readonly MessageAttachment[];
+    readonly createdAt: string;
+    /** `failed`: not saved; the person may send it again. */
+    readonly status: 'sending' | 'failed';
+}
+export interface MessagesState {
+    /** Oldest first, each `seq` once. */
+    readonly items: readonly ConversationMessage[];
+    readonly pending: readonly PendingMessage[];
+    /** There are older messages than the first one loaded. */
+    readonly hasMore: boolean;
+    /** The page token of the older messages, while there are any. */
+    readonly olderToken: string | null;
+    /** The highest `seq` the server has reported. */
+    readonly lastSeq: number;
+    readonly loaded: boolean;
+}
+export declare const EMPTY_MESSAGES: MessagesState;
+export type MessagesAction = 
+/** A page arrived: the newest page, a page `after`, or an older page. */
+{
+    readonly type: 'page';
+    readonly page: MessagePage & {
+        readonly nextCursor?: string | null;
+    };
+    readonly older?: boolean;
+}
+/** The server confirmed a message (the answer of a send). */
+ | {
+    readonly type: 'confirmed';
+    readonly message: ConversationMessage;
+} | {
+    readonly type: 'sending';
+    readonly message: PendingMessage;
+} | {
+    readonly type: 'failed';
+    readonly clientId: string;
+} | {
+    readonly type: 'discard';
+    readonly clientId: string;
+} | {
+    readonly type: 'reset';
+};
+export declare function messagesReducer(state: MessagesState, action: MessagesAction): MessagesState;
+/** The highest `seq` loaded, to ask `after` with; 0 before anything was loaded. */
+export declare function lastLoadedSeq(state: MessagesState): number;
+/** The lowest `seq` of a reply still being written (`metadata.streaming`), or null when none is. */
+export declare function streamingSeq(state: MessagesState): number | null;
+/**
+ * Where to fetch newer messages from: after the last one loaded, or from just before a reply still being written,
+ * which grows in place (same `seq`) until it is final.
+ */
+export declare function fetchCursor(state: MessagesState): number;
+/** An id for a message the browser sends, echoed back in `metadata.clientId`. */
+export declare function newClientId(): string;
+export type StepLine = {
+    readonly kind: 'thinking';
+}
+/** Reading or looking something up: `subject` is what. */
+ | {
+    readonly kind: 'reading';
+    readonly subject: string;
+}
+/** Running a command or changing something: `subject` is what. */
+ | {
+    readonly kind: 'working';
+    readonly subject: string;
+};
+export interface LiveStepsView {
+    /** The steps since the agent last wrote to the conversation: what the folded line expands to. */
+    readonly steps: readonly RunEvent[];
+    readonly line: StepLine;
+}
+/**
+ * The run's steps since its last text (which became a message), and the line that sums them up: "thinking" until a
+ * tool call, then what the last tool call is about.
+ */
+export declare function liveStepsView(events: readonly RunEvent[]): LiveStepsView;
+export type Translate = (key: string, options?: Record<string, unknown>) => string;
+/** A notice of what happened outside the conversation (`ConversationNotice` `news`). */
+export type NewsNotice = Extract<ConversationNotice, {
+    code: 'news';
+}>;
+/** The agent a new conversation would go to: the one picked, else the viewer's default, else the system default. */
+export declare function newConversationAgent(agents: readonly ChatAgent[] | undefined, picked: string | null): ChatAgent | null;
+/** Messages and other items in time order; an item follows the messages created at or before it. */
+export declare function timelineOrder<T extends {
+    readonly at: string;
+    readonly rank: number;
+}>(entries: readonly T[]): T[];
+export declare function stepLineText(t: Translate, line: StepLine): string;
+/**
+ * A notice in the viewer's language; the English `content` when the code is unknown. News is worded by the
+ * application (`newsText`), else read as its English title.
+ */
+export declare function noticeText(t: Translate, notice: ConversationNotice | undefined, fallback: string, agentName: (agentId: string) => string, newsText?: (notice: NewsNotice, t: Translate) => string | null): string;
+//# sourceMappingURL=message-model.d.ts.map

package/dist/client/chat/message-model.d.ts.map

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