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

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

@@ -0,0 +1,113 @@
+/**
+ * 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 { ConsultationIdentity } from './consultation-identity.js';
+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. For a loaded consultation, pass `useConsultationIdentity`'s
+ * result to distinguish loading, refusal and a missing subject without exposing a hidden identity.
+ */
+export declare function noticeText(t: Translate, notice: ConversationNotice | undefined, fallback: string, agentName: (agentId: string) => string, newsText?: (notice: NewsNotice, t: Translate) => string | null, consultationIdentity?: ConsultationIdentity): 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":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACZ,MAAM,+BAA+B,CAAC;AAGvC,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,gDAAgD;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,cAAc,EAAE,aAO5B,CAAC;AAEF,MAAM,MAAM,cAAc;AACxB,yEAAyE;AACvE;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AACH,6DAA6D;GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AA2B/B,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,cAAc,GACrB,aAAa,CAgDf;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE1D;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAEhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAIxD;AAID,iFAAiF;AACjF,wBAAgB,WAAW,IAAI,MAAM,CAOpC;AAMD,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE;AAC/B,0DAA0D;GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACxD,kEAAkE;GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAkCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,aAAa,CAiBxE;AAMD,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC;AAEZ,wFAAwF;AACxF,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEvE,oHAAoH;AACpH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EACxC,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,SAAS,GAAG,IAAI,CAQlB;AAED,oGAAoG;AACpG,wBAAgB,aAAa,CAC3B,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACxD,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAU5B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,CAAC,EAAE,SAAS,EACZ,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EACtC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,KAAK,MAAM,GAAG,IAAI,EAC9D,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,MAAM,CAoDR"}

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

@@ -0,0 +1,228 @@
+import { toolSummary } from '../lib/tool-summary.js';
+export const EMPTY_MESSAGES = {
+    items: [],
+    pending: [],
+    hasMore: false,
+    olderToken: null,
+    lastSeq: 0,
+    loaded: false,
+};
+function merge(current, batch) {
+    if (batch.length === 0)
+        return current;
+    const bySeq = new Map(current.map((message) => [message.seq, message]));
+    for (const message of batch)
+        bySeq.set(message.seq, message);
+    return [...bySeq.values()].sort((a, b) => a.seq - b.seq);
+}
+/** Drops the optimistic copies of messages the server now has. */
+function settle(pending, items) {
+    if (pending.length === 0)
+        return pending;
+    const confirmed = new Set(items
+        .map((message) => message.metadata.clientId)
+        .filter((id) => typeof id === 'string'));
+    const next = pending.filter((message) => !confirmed.has(message.clientId));
+    return next.length === pending.length ? pending : next;
+}
+export function messagesReducer(state, action) {
+    switch (action.type) {
+        case 'page': {
+            const items = merge(state.items, action.page.items);
+            return {
+                items,
+                pending: settle(state.pending, items),
+                // An older page tells whether there is more before it; a newer one leaves what the first load said.
+                hasMore: action.older || !state.loaded ? action.page.hasMore : state.hasMore,
+                olderToken: action.older || !state.loaded
+                    ? (action.page.nextCursor ?? null)
+                    : state.olderToken,
+                lastSeq: Math.max(state.lastSeq, action.page.lastSeq),
+                loaded: true,
+            };
+        }
+        case 'confirmed': {
+            const items = merge(state.items, [action.message]);
+            return {
+                ...state,
+                items,
+                pending: settle(state.pending, items),
+                lastSeq: Math.max(state.lastSeq, action.message.seq),
+            };
+        }
+        case 'sending':
+            return { ...state, pending: [...state.pending, action.message] };
+        case 'failed':
+            return {
+                ...state,
+                pending: state.pending.map((message) => message.clientId === action.clientId
+                    ? { ...message, status: 'failed' }
+                    : message),
+            };
+        case 'discard':
+            return {
+                ...state,
+                pending: state.pending.filter((message) => message.clientId !== action.clientId),
+            };
+        case 'reset':
+            return EMPTY_MESSAGES;
+    }
+}
+/** The highest `seq` loaded, to ask `after` with; 0 before anything was loaded. */
+export function lastLoadedSeq(state) {
+    return state.items.at(-1)?.seq ?? 0;
+}
+/** The lowest `seq` of a reply still being written (`metadata.streaming`), or null when none is. */
+export function streamingSeq(state) {
+    return state.items.find((message) => message.metadata.streaming)?.seq ?? 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 function fetchCursor(state) {
+    const streaming = streamingSeq(state);
+    const last = lastLoadedSeq(state);
+    return streaming === null ? last : Math.min(last, streaming - 1);
+}
+let clientSeed = 0;
+/** An id for a message the browser sends, echoed back in `metadata.clientId`. */
+export function newClientId() {
+    clientSeed += 1;
+    const random = typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'
+        ? crypto.randomUUID()
+        : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+    return `c-${random}-${clientSeed}`;
+}
+const READ_TOOLS = new Set([
+    'read',
+    'grep',
+    'glob',
+    'ls',
+    'webfetch',
+    'websearch',
+    'search',
+    'view',
+]);
+const READ_COMMAND = /\b(get|list|ls|search|show|view|find|cat|grep|rg|read|status|log|diff|inbox|roster)\b/u;
+const STEP_TYPES = new Set(['thinking', 'toolUse', 'toolResult', 'permission']);
+/** What a tool call is about, for the step line: the summary without the shell prompt. */
+function subjectOf(event) {
+    const summary = toolSummary(event.input);
+    const text = summary?.startsWith('$ ') ? summary.slice(2) : summary;
+    return text || event.tool || '';
+}
+function lineOf(event) {
+    if (!event || event.type !== 'toolUse')
+        return { kind: 'thinking' };
+    const subject = subjectOf(event);
+    if (!subject)
+        return { kind: 'thinking' };
+    const tool = (event.tool ?? '').toLowerCase();
+    // A command reads when one of its first words is a read verb (`acme record get REC-12`, `git log`).
+    const head = subject.split(/\s+/u).slice(0, 4).join(' ');
+    const reads = READ_TOOLS.has(tool) || READ_COMMAND.test(head);
+    return reads ? { kind: 'reading', subject } : { kind: 'working', subject };
+}
+/**
+ * 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 function liveStepsView(events) {
+    let start = 0;
+    events.forEach((event, index) => {
+        if (event.type === 'text' && event.content?.trim())
+            start = index + 1;
+    });
+    const steps = events
+        .slice(start)
+        .filter((event) => STEP_TYPES.has(event.type));
+    const lastTool = [...steps]
+        .reverse()
+        .find((event) => event.type === 'toolUse');
+    const lastStep = steps.at(-1);
+    return {
+        steps,
+        line: lastStep?.type === 'thinking' ? { kind: 'thinking' } : lineOf(lastTool),
+    };
+}
+/** The agent a new conversation would go to: the one picked, else the viewer's default, else the system default. */
+export function newConversationAgent(agents, picked) {
+    if (!agents)
+        return null;
+    return ((picked ? agents.find((agent) => agent.id === picked) : undefined) ??
+        agents.find((agent) => agent.isMyDefault) ??
+        agents.find((agent) => agent.isSystemDefault) ??
+        null);
+}
+/** Messages and other items in time order; an item follows the messages created at or before it. */
+export function timelineOrder(entries) {
+    return entries
+        .map((entry, index) => ({ entry, index }))
+        .sort((a, b) => a.entry.at.localeCompare(b.entry.at) ||
+        a.entry.rank - b.entry.rank ||
+        a.index - b.index)
+        .map(({ entry }) => entry);
+}
+export function stepLineText(t, line) {
+    if (line.kind === 'thinking')
+        return t('chat.steps.thinking');
+    return t(`chat.steps.${line.kind}`, { subject: line.subject });
+}
+/**
+ * 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. For a loaded consultation, pass `useConsultationIdentity`'s
+ * result to distinguish loading, refusal and a missing subject without exposing a hidden identity.
+ */
+export function noticeText(t, notice, fallback, agentName, newsText, consultationIdentity) {
+    if (!notice)
+        return fallback;
+    switch (notice.code) {
+        case 'switchedToDefault':
+            return t('chat.notice.switchedToDefault', {
+                name: agentName(notice.agentId),
+                own: agentName(notice.fromAgentId),
+            });
+        case 'switchedToOnline':
+            return t('chat.notice.switchedToOnline', {
+                name: agentName(notice.agentId),
+                own: agentName(notice.fromAgentId),
+            });
+        case 'onlineFallbackUnavailable':
+            return t('chat.notice.onlineFallbackUnavailable', {
+                own: agentName(notice.fromAgentId),
+                reason: t(`chat.availability.${notice.reason}`),
+            });
+        case 'switchedBack':
+            return t('chat.notice.switchedBack', { name: agentName(notice.agentId) });
+        case 'runFailed':
+            return notice.reason
+                ? t('chat.notice.runFailedReason', {
+                    reason: t(`failures.${notice.reason}`),
+                })
+                : t('chat.notice.runFailed');
+        case 'runCancelled':
+            return t('chat.notice.runCancelled');
+        case 'news':
+            return newsText?.(notice, t) ?? notice.title;
+        case 'consultation':
+            if (consultationIdentity?.state === 'unavailable')
+                return t('chat.consultation.unavailableTitle');
+            return t(consultationIdentity?.state === 'snapshot' ||
+                (!consultationIdentity &&
+                    (notice.identitySnapshot || !notice.agentId))
+                ? 'chat.consultation.snapshotTitle'
+                : 'chat.consultation.title', {
+                name: consultationIdentity
+                    ? consultationIdentity.state === 'loading'
+                        ? '…'
+                        : consultationIdentity.name
+                    : notice.agentId && !notice.identitySnapshot
+                        ? agentName(notice.agentId)
+                        : notice.agentName,
+            });
+        default:
+            return fallback;
+    }
+}
+//# sourceMappingURL=message-model.js.map

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

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

package/dist/client/chat/panel-state.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The chat panel's state as plain data: whether it is open, at its usual width or covering the content, showing a
+ * conversation or the history, and which conversation. It is kept in `sessionStorage`, so a reload in the same tab
+ * reopens the panel where it was; every access is guarded (private windows, full storage). A link opens the panel
+ * with `?chat=<conversationId|new|history>` (and `chatMode=expanded`), which the panel applies and then removes.
+ */
+export type ChatPanelMode = 'docked' | 'expanded';
+export type ChatPanelView = 'chat' | 'history';
+export interface ChatPanelState {
+    readonly open: boolean;
+    readonly mode: ChatPanelMode;
+    readonly view: ChatPanelView;
+    /** Null: a new conversation, created on the server by its first message. */
+    readonly conversationId: string | null;
+    /** The agent a new conversation goes to; null: the person's default (or the system default). */
+    readonly newAgentId: string | null;
+}
+export declare const CHAT_PANEL_STORAGE_KEY = "nocobase:agents-chat-panel";
+/** The query parameters of a link that opens the panel. */
+export declare const CHAT_PARAM = "chat";
+export declare const CHAT_MODE_PARAM = "chatMode";
+export declare const INITIAL_PANEL_STATE: ChatPanelState;
+/**
+ * From this width the panel docks beside the content, which narrows to make room; below it, it floats over the
+ * content's right side. At 1280px with the navigation open the content keeps about 720px, which every page lays out
+ * in; floating there instead covered the pages' header actions and toolbars.
+ */
+export declare const CHAT_DOCK_QUERY = "(min-width: 1280px)";
+/** Below this width the panel is a full-screen dialog opened from a floating button. */
+export declare const CHAT_MOBILE_QUERY = "(max-width: 767px)";
+export declare function readPanelState(storage?: Storage | null): ChatPanelState;
+export declare function writePanelState(state: ChatPanelState, storage?: Storage | null): void;
+/** What a link asks for: `?chat=<id>`, `?chat=new`, `?chat=history`; null without `chat`. */
+export declare function panelStateFromSearch(search: URLSearchParams, current: ChatPanelState): ChatPanelState | null;
+/** The search string without the panel's own parameters, once they have been applied. */
+export declare function withoutPanelParams(search: URLSearchParams): string;
+/** The search of a link that opens the panel on `target` (a conversation id, `new` or `history`). */
+export declare function chatLinkSearch(target: string): string;
+/** `⌘` on Apple platforms, `Ctrl` elsewhere. */
+export declare function modifierKeyLabel(): string;
+/** ⌘J on macOS, Ctrl+J elsewhere; never with Shift or Alt, never while composing text. */
+export declare function isChatShortcut(event: KeyboardEvent): boolean;
+//# sourceMappingURL=panel-state.d.ts.map

package/dist/client/chat/panel-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-state.d.ts","sourceRoot":"","sources":["../../../client/chat/panel-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,eAAO,MAAM,sBAAsB,+BAA+B,CAAC;AACnE,2DAA2D;AAC3D,eAAO,MAAM,UAAU,SAAS,CAAC;AACjC,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,eAAO,MAAM,mBAAmB,EAAE,cAMjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAetD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,cAAc,CAkBvE;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,IAAI,CAMN;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,cAAc,GACtB,cAAc,GAAG,IAAI,CAgBvB;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAMlE;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAI5D"}

package/dist/client/chat/panel-state.js

@@ -0,0 +1,113 @@
+/**
+ * The chat panel's state as plain data: whether it is open, at its usual width or covering the content, showing a
+ * conversation or the history, and which conversation. It is kept in `sessionStorage`, so a reload in the same tab
+ * reopens the panel where it was; every access is guarded (private windows, full storage). A link opens the panel
+ * with `?chat=<conversationId|new|history>` (and `chatMode=expanded`), which the panel applies and then removes.
+ */
+export const CHAT_PANEL_STORAGE_KEY = 'nocobase:agents-chat-panel';
+/** The query parameters of a link that opens the panel. */
+export const CHAT_PARAM = 'chat';
+export const CHAT_MODE_PARAM = 'chatMode';
+export const INITIAL_PANEL_STATE = {
+    open: false,
+    mode: 'docked',
+    view: 'chat',
+    conversationId: null,
+    newAgentId: null,
+};
+/**
+ * From this width the panel docks beside the content, which narrows to make room; below it, it floats over the
+ * content's right side. At 1280px with the navigation open the content keeps about 720px, which every page lays out
+ * in; floating there instead covered the pages' header actions and toolbars.
+ */
+export const CHAT_DOCK_QUERY = '(min-width: 1280px)';
+/** Below this width the panel is a full-screen dialog opened from a floating button. */
+export const CHAT_MOBILE_QUERY = '(max-width: 767px)';
+function storageOf(storage) {
+    if (storage)
+        return storage;
+    try {
+        return typeof window === 'undefined' ? null : window.sessionStorage;
+    }
+    catch {
+        return null;
+    }
+}
+function text(value) {
+    return typeof value === 'string' && value ? value : null;
+}
+export function readPanelState(storage) {
+    try {
+        const raw = storageOf(storage)?.getItem(CHAT_PANEL_STORAGE_KEY);
+        if (!raw)
+            return INITIAL_PANEL_STATE;
+        const value = JSON.parse(raw);
+        if (!value || typeof value !== 'object')
+            return INITIAL_PANEL_STATE;
+        return {
+            open: value.open === true,
+            mode: value.mode === 'expanded' ? 'expanded' : 'docked',
+            view: value.view === 'history' ? 'history' : 'chat',
+            conversationId: text(value.conversationId),
+            newAgentId: text(value.newAgentId),
+        };
+    }
+    catch {
+        return INITIAL_PANEL_STATE;
+    }
+}
+export function writePanelState(state, storage) {
+    try {
+        storageOf(storage)?.setItem(CHAT_PANEL_STORAGE_KEY, JSON.stringify(state));
+    }
+    catch {
+        // Not remembered; the panel still works for this visit.
+    }
+}
+/** What a link asks for: `?chat=<id>`, `?chat=new`, `?chat=history`; null without `chat`. */
+export function panelStateFromSearch(search, current) {
+    const value = search.get(CHAT_PARAM)?.trim();
+    if (!value)
+        return null;
+    const mode = search.get(CHAT_MODE_PARAM) === 'expanded' ? 'expanded' : current.mode;
+    if (value === 'history')
+        return { ...current, open: true, mode, view: 'history' };
+    if (value === 'new')
+        return {
+            ...current,
+            open: true,
+            mode,
+            view: 'chat',
+            conversationId: null,
+        };
+    return { ...current, open: true, mode, view: 'chat', conversationId: value };
+}
+/** The search string without the panel's own parameters, once they have been applied. */
+export function withoutPanelParams(search) {
+    const next = new URLSearchParams(search);
+    next.delete(CHAT_PARAM);
+    next.delete(CHAT_MODE_PARAM);
+    const value = next.toString();
+    return value ? `?${value}` : '';
+}
+/** The search of a link that opens the panel on `target` (a conversation id, `new` or `history`). */
+export function chatLinkSearch(target) {
+    return `?${new URLSearchParams({ [CHAT_PARAM]: target }).toString()}`;
+}
+/** `⌘` on Apple platforms, `Ctrl` elsewhere. */
+export function modifierKeyLabel() {
+    if (typeof navigator === 'undefined')
+        return 'Ctrl';
+    const platform = navigator.userAgentData
+        ?.platform ?? navigator.platform;
+    return /mac|iphone|ipad/iu.test(platform) ? '⌘' : 'Ctrl';
+}
+/** ⌘J on macOS, Ctrl+J elsewhere; never with Shift or Alt, never while composing text. */
+export function isChatShortcut(event) {
+    if (event.isComposing || event.shiftKey || event.altKey)
+        return false;
+    if (event.key.toLowerCase() !== 'j' && event.code !== 'KeyJ')
+        return false;
+    return event.metaKey !== event.ctrlKey;
+}
+//# sourceMappingURL=panel-state.js.map

package/dist/client/chat/panel-state.js.map

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

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

@@ -0,0 +1,101 @@
+/**
+ * The chat panel across the whole application: its state, ⌘J / Ctrl+J, the `?chat=` links, what the current page
+ * contributes as context, and the text last selected on the page. The application renders `ChatProvider` around its
+ * routes (for example, in `AppLayout`), so none of it resets when the page changes; only the page's own sources, the
+ * selection and the removed chips follow the path.
+ */
+import { type Provider, type ReactElement, type ReactNode } from 'react';
+import type { ConversationSource } from '../../shared/conversations.js';
+import { type ChatContextFilter, type ChatContextItem, type ChatSelection } from './context-model.js';
+import { type ChatPanelMode, type ChatPanelState, type ChatPanelView } from './panel-state.js';
+export declare const CHAT_PANEL_ID = "agents-chat-panel";
+/** Marks the panel's DOM: a selection inside it is not page context, and focus inside it means "in the panel". */
+export declare const CHAT_PANEL_ATTRIBUTE = "data-agents-chat";
+export interface OpenChatOptions {
+    /** An object kept in the context until the next message is sent ("Ask agent"). */
+    readonly pin?: ChatContextItem;
+    /** Text put into the composer; never sent on its own. */
+    readonly draft?: string;
+    /** Open this conversation; null opens a new one; left out keeps the current one. */
+    readonly conversationId?: string | null;
+    /** The agent a new conversation goes to. */
+    readonly agentId?: string | null;
+    /** Where a conversation started from here comes from: `askAgent` for a button on a page. */
+    readonly source?: ConversationSource;
+    readonly view?: ChatPanelView;
+}
+export interface ChatDraft {
+    readonly text: string;
+    readonly nonce: number;
+}
+export interface ChatPanelValue extends ChatPanelState {
+    /** The viewer may chat (signed in, and the application offers the panel). */
+    readonly available: boolean;
+    readonly openChat: (options?: OpenChatOptions) => void;
+    readonly closeChat: () => void;
+    readonly toggleChat: () => void;
+    readonly setMode: (mode: ChatPanelMode) => void;
+    readonly setView: (view: ChatPanelView) => void;
+    /** Shows a conversation; null starts a new one, with `agentId` when given. */
+    readonly selectConversation: (conversationId: string | null, agentId?: string | null) => void;
+    readonly pinned: readonly ChatContextItem[];
+    readonly clearPinned: () => void;
+    readonly draft: ChatDraft | null;
+    /** Where the next new conversation comes from; back to `panel` once it is created. */
+    readonly source: ConversationSource;
+    readonly resetSource: () => void;
+    /** The composer registers how to focus it; the returned function unregisters. */
+    readonly registerComposer: (focus: () => void) => () => void;
+    readonly focusComposer: () => void;
+    /**
+     * Opens a conversation on the application's full-page view and closes the panel; null when the application gave
+     * `ChatProvider` no `conversationPath`.
+     */
+    readonly openPage: ((conversationId: string) => void) | null;
+    /** The full-page view's path of a conversation; null without one. */
+    readonly conversationPath: ((conversationId: string) => string) | null;
+}
+export interface ChatSourcesValue {
+    readonly items: readonly ChatContextItem[];
+    readonly filter: ChatContextFilter | null;
+    readonly selection: ChatSelection | null;
+    readonly removed: ReadonlySet<string>;
+    /** Registers an object the page shows; the returned function unregisters it. */
+    readonly registerItem: (item: ChatContextItem) => () => void;
+    readonly registerFilter: (filter: ChatContextFilter) => () => void;
+    readonly remove: (key: string) => void;
+}
+/** The full-page view puts its own value over the panel's for its subtree (`page.tsx`). */
+export declare const ChatPanelScope: Provider<ChatPanelValue | null>;
+/**
+ * Where the person was before they opened the full-page view, so that moving the conversation to the panel ("Open in
+ * side panel") takes them back there. The page tells the provider while it is mounted (`enter`); the provider remembers
+ * every other location (`returnTo`: path, search and hash; null when the application opened on the page).
+ */
+export interface ChatPageTracking {
+    readonly enter: () => () => void;
+    readonly returnTo: () => string | null;
+}
+export declare function useChatPageTracking(): ChatPageTracking | null;
+/** The panel's state and actions; outside `ChatProvider`, a closed panel nobody can open. */
+export declare function useChatPanel(): ChatPanelValue;
+/** What the current page contributes; outside `ChatProvider`, nothing (and registering does nothing). */
+export declare function useChatSources(): ChatSourcesValue;
+export declare function ChatProvider({ available, conversationPath, children, }: {
+    readonly available?: boolean;
+    /**
+     * Where the application shows one conversation as a page of its own (for example, `/chat/:conversationId`). With it, the
+     * panel offers "Open full page" for a conversation, and the agent-chat block's `ChatConversationPage` moves between
+     * conversations there.
+     */
+    readonly conversationPath?: (conversationId: string) => string;
+    readonly children?: ReactNode;
+}): ReactElement;
+/**
+ * Registers the object a page shows as context for the chat while the page is mounted; null while it loads. The
+ * label is what its chip says. Outside `ChatProvider` it does nothing.
+ */
+export declare function useChatContextSource(item: ChatContextItem | null): void;
+/** Registers a list page's filter while the page is mounted; null registers nothing. */
+export declare function useChatFilterSource(filter: ChatContextFilter | null): void;
+//# sourceMappingURL=provider.d.ts.map

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

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