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

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

@@ -0,0 +1,37 @@
+/**
+ * The browser API of the chat (`CHAT_ROUTES` in `shared/conversations`), 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 ChatAgent, type ChatPreferences, type ChatPreferencesPatch, type ChatSettings, type ChatSettingsPatch, type ConversationDetail, type ConversationListQuery, type ConversationPage, type ConversationPatch, type CreateConversationRequest, type MessageAttachment, type MessageListQuery, type MessagePage, type SendMessageRequest, type SendMessageResult } from '../../shared/conversations.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[]>;
+    preferences(): Promise<ChatPreferences>;
+    updatePreferences(patch: ChatPreferencesPatch): Promise<ChatPreferences>;
+    settings(): Promise<ChatSettings>;
+    updateSettings(patch: ChatSettingsPatch): Promise<ChatSettings>;
+    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;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,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,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAiBvC,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,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;IAItE,OAAO,CAAC,IAAI;YAUE,GAAG;IAIjB,OAAO,CAAC,IAAI;YAQE,IAAI;CAYnB"}

package/dist/client/chat/api.js

@@ -0,0 +1,118 @@
+import { chatPath, } from '../../shared/conversations.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;
+    }
+    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);
+    }
+    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/consultation-identity.d.ts

@@ -0,0 +1,7 @@
+import type { ConsultationNotice } from '../../shared/conversations.js';
+export interface ConsultationIdentity {
+    readonly state: 'loading' | 'resolved' | 'snapshot' | 'unavailable';
+    readonly name: string | null;
+}
+export declare function useConsultationIdentity(notice: ConsultationNotice | undefined): ConsultationIdentity;
+//# sourceMappingURL=consultation-identity.d.ts.map

package/dist/client/chat/consultation-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consultation-identity.d.ts","sourceRoot":"","sources":["../../../client/chat/consultation-identity.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAMxE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,oBAAoB,CA4BtB"}

package/dist/client/chat/consultation-identity.js

@@ -0,0 +1,39 @@
+/** Current identity for a loaded consultation; message snapshots and sequence numbers stay untouched. */
+import { ApiClientError } from '@nocobase/app-client';
+import { useQuery } from '@tanstack/react-query';
+import { agentsKeys } from '../api/keys.js';
+import { useAgentsApi } from '../hooks/use-agents-api.js';
+import { agentsQueryClient } from '../query.js';
+import { useAgentIdentities } from '../runs/subject-runs.js';
+export function useConsultationIdentity(notice) {
+    const api = useAgentsApi();
+    const runId = !notice?.agentId ? notice?.runId : null;
+    const run = useQuery({
+        queryKey: agentsKeys.run(runId ?? ''),
+        queryFn: () => api.run(runId),
+        enabled: Boolean(runId),
+        retry: false,
+    }, agentsQueryClient());
+    const identities = useAgentIdentities(Boolean(notice));
+    if (!notice)
+        return { state: 'unavailable', name: null };
+    if (runId && run.isError) {
+        return run.error instanceof ApiClientError && run.error.status === 404
+            ? { state: 'snapshot', name: notice.agentName }
+            : { state: 'unavailable', name: null };
+    }
+    if (runId && run.isPending)
+        return { state: 'loading', name: null };
+    const agentId = notice.agentId ?? run.data?.agentId;
+    if (!agentId)
+        return { state: 'snapshot', name: notice.agentName };
+    if (identities.failed)
+        return { state: 'unavailable', name: null };
+    if (identities.loading)
+        return { state: 'loading', name: null };
+    const name = identities.nameOf(agentId);
+    return name === null
+        ? { state: 'snapshot', name: notice.agentName }
+        : { state: 'resolved', name };
+}
+//# sourceMappingURL=consultation-identity.js.map

package/dist/client/chat/consultation-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consultation-identity.js","sourceRoot":"","sources":["../../../client/chat/consultation-identity.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAO7D,MAAM,UAAU,uBAAuB,CACrC,MAAsC;IAEtC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,MAAM,GAAG,GAAG,QAAQ,CAClB;QACE,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAM,CAAC;QAC9B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC;QACvB,KAAK,EAAE,KAAK;KACb,EACD,iBAAiB,EAAE,CACpB,CAAC;IACF,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzD,IAAI,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,KAAK,YAAY,cAAc,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,GAAG;YACpE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE;YAC/C,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,IAAI,GAAG,CAAC,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC;IACpD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IACnE,IAAI,UAAU,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnE,IAAI,UAAU,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,IAAI,KAAK,IAAI;QAClB,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE;QAC/C,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC"}

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"}