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

package/dist/server/core/conversations/attachments.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Files people send with chat messages (`agChatAttachments`; the contract is "Attachments" in `shared/conversations`).
+ * The bytes go through the file plugin's repository onto a Drive disk, as the projects plugin stores issue files; Drive
+ * reads and deletes them. Both are asked on each use, so without the file plugin (or Drive) an upload answers 503
+ * `NOT_IMPLEMENTED`.
+ *
+ * An upload is its uploader's alone until it is sent with a message (`attach`, in the message's transaction), which
+ * gives it to the conversation: from then on its owner reads it, and a run of the conversation's agent on that
+ * conversation. Anyone else gets 404, as if it did not exist. Uploads never sent are purged after
+ * `CHAT_ATTACHMENT_ORPHAN_HOURS`.
+ */
+import { Readable } from 'node:stream';
+import type { DatabaseConnection } from '@nocobase/db';
+import { type MessageAttachment } from '../../../shared/conversations.js';
+import { ProtocolError } from '../../kernel/errors.js';
+import type { TxRunner } from '../../kernel/tx.js';
+export declare const CHAT_ATTACHMENTS = "agChatAttachments";
+/** Required by the file repository; nothing is served there (the content route checks who may read). */
+export declare const CHAT_ATTACHMENTS_ACCESS_PATH = "/uploads/ag-chat-attachments";
+export interface ChatAttachmentRecord {
+    readonly id: string;
+    readonly disk: string;
+    readonly key: string;
+    readonly filename: string;
+    readonly ext: string;
+    readonly mimeType: string;
+    readonly size: string | number;
+    readonly uploaderId: string;
+    readonly conversationId: string | null;
+    readonly messageId: string | null;
+    readonly createdAt: Date | string;
+    readonly updatedAt: Date | string;
+}
+/** What a message keeps of each file it was sent with (`agConversationMessages.attachments`). */
+export interface StoredAttachment {
+    readonly id: string;
+    readonly filename: string;
+    readonly ext: string;
+    readonly mimeType: string;
+    readonly size: number;
+}
+/** The file plugin's server repository, as far as uploading goes (`ServerFileRepositoryManager`). */
+export interface ChatFileUploader {
+    repository(collection: string, options: {
+        readonly disk: string;
+        readonly accessPath: string;
+        readonly policy: {
+            readonly read: true;
+            readonly create: {
+                readonly scope: true;
+                readonly defaults: Readonly<Record<string, string>>;
+            };
+            readonly update: false;
+            readonly delete: false;
+        };
+    }): {
+        uploadOne(input: {
+            readonly file: File;
+        }): Promise<{
+            readonly record: {
+                readonly id: string;
+            };
+        }>;
+    };
+}
+/** A Drive manager, as far as reading and deleting go. */
+export interface ChatFileDisks {
+    use(disk: string): {
+        getBytes(key: string): Promise<Uint8Array>;
+        getStream(key: string): Promise<Readable>;
+        delete(key: string): Promise<void>;
+    };
+}
+/** Where a stored file's bytes are. */
+export interface StoredObject {
+    readonly disk: string;
+    readonly key: string;
+}
+/** Where the bytes go; the file plugin and Drive in an application, memory in tests. */
+export interface ChatFileStorage {
+    /** Stores the bytes and inserts the row, attached to nothing; answers its id. */
+    store(file: File, uploaderId: string): Promise<string>;
+    bytes(object: StoredObject): Promise<Uint8Array>;
+    stream(object: StoredObject): Promise<ReadableStream<Uint8Array>>;
+    /** Deletes the bytes; a failure leaves an orphan object, never a broken row, and is only logged. */
+    remove(object: StoredObject): Promise<void>;
+}
+export interface ChatFileStorageDeps {
+    /** Null when the application registers no file plugin. */
+    readonly uploader: () => ChatFileUploader | null;
+    readonly disks: () => ChatFileDisks | null;
+    /** The Drive disk new files go to. */
+    readonly disk: () => string;
+    readonly onError?: (error: unknown) => void;
+}
+/** Storage over the file plugin's repository and Drive, both asked on each use. */
+export declare function createChatFileStorage(deps: ChatFileStorageDeps): ChatFileStorage;
+/** Who reads a file: a person, or a run of an agent acting for them (its subject). */
+export interface AttachmentReader {
+    readonly userId: string;
+    /** Set for a request authenticated by a run token: only files of the conversation the run works on. */
+    readonly run?: {
+        readonly subjectKind: string;
+        readonly subjectId: string;
+    } | null;
+}
+export interface ChatAttachmentContent {
+    readonly attachment: MessageAttachment;
+    readonly body: ReadableStream<Uint8Array>;
+}
+export interface ChatAttachmentService {
+    /** An upload of the person's, attached to nothing yet. */
+    upload(userId: string, file: File): Promise<MessageAttachment>;
+    /** Deletes the person's own upload not sent yet; 404 for anything else. */
+    remove(userId: string, id: string): Promise<void>;
+    /** A file's bytes; 404 unless the reader may read it. */
+    content(reader: AttachmentReader, id: string): Promise<ChatAttachmentContent>;
+    /** The images of `ids` sent in `conversationId`, at most `maxBytes` each, for an online agent's model. */
+    images(conversationId: string, ids: readonly string[], maxBytes: number): Promise<{
+        readonly mediaType: string;
+        readonly data: Uint8Array;
+    }[]>;
+    /** Deletes uploads attached to nothing for `CHAT_ATTACHMENT_ORPHAN_HOURS`; answers how many. */
+    purge(at?: Date): Promise<number>;
+}
+/** What the conversation service uses inside a message's transaction. */
+export interface ChatAttachmentLinks {
+    /**
+     * Gives `ids` (checked: at most `CHAT_ATTACHMENTS_PER_MESSAGE_MAX` distinct ids of `userId`'s uploads attached to
+     * nothing) to the conversation and message. Answers what the message keeps, in the order named; 400
+     * `INVALID_REQUEST` otherwise, and nothing is attached.
+     */
+    attach(conn: DatabaseConnection, userId: string, target: {
+        readonly conversationId: string;
+        readonly messageId: string;
+    }, ids: readonly string[]): Promise<StoredAttachment[]>;
+}
+export interface ChatAttachmentDeps {
+    readonly tx: TxRunner;
+    readonly storage: ChatFileStorage;
+    /** The application's public base path (`/app`, or empty), for the content URLs. */
+    readonly basePath: () => string;
+    readonly now?: () => Date;
+}
+/** The content route of a file, with the application's base path. */
+export declare function chatAttachmentUrl(basePath: string, id: string): string;
+/** A file as the API answers it. */
+export declare function attachmentView(basePath: string, file: StoredAttachment): MessageAttachment;
+/** What a message stored as its files; anything malformed is left out. */
+export declare function storedAttachments(value: unknown): StoredAttachment[];
+/** The `attachmentIds` of a request: absent is none; otherwise at most the maximum distinct non-empty strings. */
+export declare function readAttachmentIds(value: unknown): string[];
+/** 413 `UPLOAD_TOO_LARGE`: a file over `CHAT_ATTACHMENT_SIZE_MAX`. */
+export declare function fileTooLarge(): ProtocolError;
+export declare function createChatAttachments(deps: ChatAttachmentDeps): {
+    readonly service: ChatAttachmentService;
+    readonly links: ChatAttachmentLinks;
+};
+//# sourceMappingURL=attachments.d.ts.map

package/dist/server/core/conversations/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../../../server/core/conversations/attachments.ts"],"names":[],"mappings":"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"}

package/dist/server/core/conversations/attachments.js

@@ -0,0 +1,281 @@
+/**
+ * Files people send with chat messages (`agChatAttachments`; the contract is "Attachments" in `shared/conversations`).
+ * The bytes go through the file plugin's repository onto a Drive disk, as the projects plugin stores issue files; Drive
+ * reads and deletes them. Both are asked on each use, so without the file plugin (or Drive) an upload answers 503
+ * `NOT_IMPLEMENTED`.
+ *
+ * An upload is its uploader's alone until it is sent with a message (`attach`, in the message's transaction), which
+ * gives it to the conversation: from then on its owner reads it, and a run of the conversation's agent on that
+ * conversation. Anyone else gets 404, as if it did not exist. Uploads never sent are purged after
+ * `CHAT_ATTACHMENT_ORPHAN_HOURS`.
+ */
+import { Readable } from 'node:stream';
+import { CHAT_ATTACHMENT_ORPHAN_HOURS, CHAT_ATTACHMENT_SIZE_MAX, CHAT_ATTACHMENTS_PER_MESSAGE_MAX, CONVERSATION_SUBJECT, isInlineImage, } from '../../../shared/conversations.js';
+import { invalid, notFound, precondition, ProtocolError, } from '../../kernel/errors.js';
+export const CHAT_ATTACHMENTS = 'agChatAttachments';
+/** Required by the file repository; nothing is served there (the content route checks who may read). */
+export const CHAT_ATTACHMENTS_ACCESS_PATH = '/uploads/ag-chat-attachments';
+/** Rows the purge looks at per pass. */
+const PURGE_BATCH = 500;
+function filesUnavailable() {
+    return precondition('NOT_IMPLEMENTED', 'This application stores no files: register the file plugin to send files in chat.');
+}
+/** Storage over the file plugin's repository and Drive, both asked on each use. */
+export function createChatFileStorage(deps) {
+    const disks = () => {
+        const found = deps.disks();
+        if (!found)
+            throw filesUnavailable();
+        return found;
+    };
+    return {
+        async store(file, uploaderId) {
+            const repository = deps.uploader();
+            if (!repository)
+                throw filesUnavailable();
+            const { record } = await repository
+                .repository(CHAT_ATTACHMENTS, {
+                disk: deps.disk(),
+                accessPath: CHAT_ATTACHMENTS_ACCESS_PATH,
+                policy: {
+                    read: true,
+                    create: { scope: true, defaults: { uploaderId } },
+                    update: false,
+                    delete: false,
+                },
+            })
+                .uploadOne({ file });
+            return String(record.id);
+        },
+        bytes: (object) => disks().use(object.disk).getBytes(object.key),
+        async stream(object) {
+            const stream = await disks().use(object.disk).getStream(object.key);
+            return Readable.toWeb(stream);
+        },
+        async remove(object) {
+            try {
+                await deps.disks()?.use(object.disk).delete(object.key);
+            }
+            catch (error) {
+                deps.onError?.(error);
+            }
+        },
+    };
+}
+function files(conn) {
+    return conn.repository(CHAT_ATTACHMENTS);
+}
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
+/** File ids are the file plugin's uuids; anything else names no file (and must not reach a uuid column). */
+function isUuid(value) {
+    return UUID.test(value);
+}
+async function findFile(conn, id) {
+    if (!isUuid(id))
+        return undefined;
+    return (await files(conn).findOne({ filter: { id } })) ?? undefined;
+}
+async function findFiles(conn, ids) {
+    const wanted = ids.filter(isUuid);
+    if (wanted.length === 0)
+        return [];
+    return files(conn).findMany({
+        filter: (f) => f.or(wanted.map((id) => f.string('id').eq(id))),
+    });
+}
+/** The content route of a file, with the application's base path. */
+export function chatAttachmentUrl(basePath, id) {
+    return `${basePath.replace(/\/+$/u, '')}/api/agents/chatAttachments/${encodeURIComponent(id)}/content`;
+}
+/** A file as the API answers it. */
+export function attachmentView(basePath, file) {
+    const contentUrl = chatAttachmentUrl(basePath, file.id);
+    return {
+        id: file.id,
+        filename: file.filename,
+        ext: file.ext,
+        mimeType: file.mimeType,
+        size: Number(file.size),
+        contentUrl,
+        downloadUrl: `${contentUrl}?download=true`,
+        previewable: isInlineImage(file.mimeType, file.ext),
+    };
+}
+function stored(row) {
+    return {
+        id: row.id,
+        filename: row.filename,
+        ext: row.ext,
+        mimeType: row.mimeType,
+        size: Number(row.size),
+    };
+}
+/** What a message stored as its files; anything malformed is left out. */
+export function storedAttachments(value) {
+    if (typeof value === 'string') {
+        try {
+            return storedAttachments(JSON.parse(value));
+        }
+        catch {
+            return [];
+        }
+    }
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((item) => {
+        if (typeof item !== 'object' || item === null)
+            return [];
+        const record = item;
+        return typeof record.id === 'string' && typeof record.filename === 'string'
+            ? [
+                {
+                    id: record.id,
+                    filename: record.filename,
+                    ext: typeof record.ext === 'string' ? record.ext : '',
+                    mimeType: typeof record.mimeType === 'string'
+                        ? record.mimeType
+                        : 'application/octet-stream',
+                    size: Number(record.size ?? 0),
+                },
+            ]
+            : [];
+    });
+}
+/** The `attachmentIds` of a request: absent is none; otherwise at most the maximum distinct non-empty strings. */
+export function readAttachmentIds(value) {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value) ||
+        !value.every((item) => typeof item === 'string' && !!item))
+        throw invalid('attachmentIds must be a list of file ids.', {
+            field: 'attachmentIds',
+        });
+    const ids = [...new Set(value)];
+    if (ids.length > CHAT_ATTACHMENTS_PER_MESSAGE_MAX)
+        throw invalid(`At most ${CHAT_ATTACHMENTS_PER_MESSAGE_MAX} files per message.`, { field: 'attachmentIds' });
+    return ids;
+}
+/** 413 `UPLOAD_TOO_LARGE`: a file over `CHAT_ATTACHMENT_SIZE_MAX`. */
+export function fileTooLarge() {
+    return new ProtocolError('UPLOAD_TOO_LARGE', `A file may have at most ${CHAT_ATTACHMENT_SIZE_MAX} bytes.`, { maxBytes: CHAT_ATTACHMENT_SIZE_MAX });
+}
+export function createChatAttachments(deps) {
+    const now = deps.now ?? (() => new Date());
+    const view = (row) => attachmentView(deps.basePath(), stored(row));
+    /** The row, when the reader may read it; 404 otherwise. */
+    async function readable(conn, reader, id) {
+        const row = await findFile(conn, id);
+        if (!row)
+            throw notFound('Attachment');
+        if (row.conversationId === null) {
+            // An upload not sent yet: its uploader's alone, never a run's.
+            if (reader.run || row.uploaderId !== reader.userId)
+                throw notFound('Attachment');
+            return row;
+        }
+        if (reader.run &&
+            (reader.run.subjectKind !== CONVERSATION_SUBJECT ||
+                reader.run.subjectId !== row.conversationId))
+            throw notFound('Attachment');
+        const conversation = await conn
+            .repository('agConversations')
+            .findOne({ filter: { id: row.conversationId } });
+        if (!conversation || conversation.userId !== reader.userId)
+            throw notFound('Attachment');
+        return row;
+    }
+    /** Deletes the row only while it is still attached to nothing; answers whether it did. */
+    async function deleteIfUnattached(conn, id) {
+        await files(conn).deleteMany({
+            filter: (f) => f.and([f.string('id').eq(id), f.string('conversationId').eq(null)]),
+        });
+        return !(await files(conn).findOne({ filter: { id } }));
+    }
+    const links = {
+        async attach(conn, userId, target, ids) {
+            if (ids.length === 0)
+                return [];
+            const rows = await findFiles(conn, ids);
+            const ordered = ids.map((id) => {
+                const row = rows.find((candidate) => candidate.id === id);
+                if (!row || row.conversationId !== null || row.uploaderId !== userId)
+                    throw invalid(`File ${id} is not an upload of yours to send.`, {
+                        field: 'attachmentIds',
+                        fileId: id,
+                    });
+                return row;
+            });
+            await files(conn).updateMany({
+                filter: (f) => f.and([
+                    f.or(ids.map((id) => f.string('id').eq(id))),
+                    f.string('conversationId').eq(null),
+                ]),
+                values: { ...target, updatedAt: now() },
+            });
+            return ordered.map(stored);
+        },
+    };
+    const service = {
+        async upload(userId, file) {
+            if (file.size > CHAT_ATTACHMENT_SIZE_MAX)
+                throw fileTooLarge();
+            const id = await deps.storage.store(file, userId);
+            const row = await findFile(deps.tx.read(), id);
+            if (!row)
+                throw notFound('Attachment');
+            return view(row);
+        },
+        async remove(userId, id) {
+            const conn = deps.tx.read();
+            const row = await findFile(conn, id);
+            if (!row || row.uploaderId !== userId || row.conversationId !== null)
+                throw notFound('Attachment');
+            if (await deleteIfUnattached(conn, row.id))
+                await deps.storage.remove(row);
+        },
+        async content(reader, id) {
+            const row = await readable(deps.tx.read(), reader, id);
+            return { attachment: view(row), body: await deps.storage.stream(row) };
+        },
+        async images(conversationId, ids, maxBytes) {
+            const rows = await findFiles(deps.tx.read(), ids);
+            const images = [];
+            for (const id of ids) {
+                const row = rows.find((candidate) => candidate.id === id);
+                if (!row ||
+                    row.conversationId !== conversationId ||
+                    !isInlineImage(row.mimeType, row.ext) ||
+                    Number(row.size) > maxBytes)
+                    continue;
+                images.push({
+                    mediaType: row.mimeType.split(';')[0].trim().toLowerCase(),
+                    data: await deps.storage.bytes(row),
+                });
+            }
+            return images;
+        },
+        async purge(at = now()) {
+            const conn = deps.tx.read();
+            const cutoff = at.getTime() - CHAT_ATTACHMENT_ORPHAN_HOURS * 3_600_000;
+            const rows = await files(conn).findMany({
+                filter: (f) => f.string('conversationId').eq(null),
+                sort: (sort) => [sort.field('createdAt').asc(), sort.field('id').asc()],
+                limit: PURGE_BATCH,
+            });
+            let purged = 0;
+            // The age is compared here rather than in the query: dialects store the timestamp differently.
+            for (const row of rows) {
+                if (new Date(row.createdAt).getTime() >= cutoff)
+                    break;
+                // Sent meanwhile: the row survived, so its bytes stay.
+                if (!(await deleteIfUnattached(conn, row.id)))
+                    continue;
+                await deps.storage.remove(row);
+                purged += 1;
+            }
+            return purged;
+        },
+    };
+    return { service, links };
+}
+//# sourceMappingURL=attachments.js.map

package/dist/server/core/conversations/attachments.js.map

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

package/dist/server/core/conversations/availability.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Whether an agent can answer a person now: it exists, is not archived, the person may wake it, and it has where to
+ * run. A runner agent needs an online runner with one of its tools installed and signed in that may run that person's
+ * work (shared with the team, or the person's own), with the features and variable restrictions claim requires;
+ * an online agent needs the service of the entry the conversation
+ * uses to offer its model, the system default chat model when it lists none.
+ */
+import type { Agent, OnlineModelEntry } from '../../../shared/agents.js';
+import type { ChatAvailability } from '../../../shared/conversations.js';
+import { type ModelCatalog } from '../../../shared/models.js';
+export declare function availabilityOf(agent: Agent | null, userId: string, mayInvoke: (agent: Agent, userId: string) => boolean, 
+/** The count returned by claim eligibility, computed outside the write transaction. */
+onlineRunners: number, 
+/** With the system default chat model, which an online agent that lists no model answers with. */
+catalog: Pick<ModelCatalog, 'services' | 'defaultModel'>, 
+/** The entry the conversation asks for; the agent's first when absent or no longer listed. */
+wanted?: OnlineModelEntry): ChatAvailability;
+/** Whether the agent may be woken for the person at all (it may still wait for a runner). */
+export declare function wakeable(agent: Agent | null, userId: string, mayInvoke: (agent: Agent, userId: string) => boolean): agent is Agent;
+//# sourceMappingURL=availability.d.ts.map

package/dist/server/core/conversations/availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../../../../server/core/conversations/availability.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG3E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO;AACpD,uFAAuF;AACvF,aAAa,EAAE,MAAM;AACrB,kGAAkG;AAClG,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,cAAc,CAAC;AACxD,8FAA8F;AAC9F,MAAM,CAAC,EAAE,gBAAgB,GACxB,gBAAgB,CAiBlB;AAED,6FAA6F;AAC7F,wBAAgB,QAAQ,CACtB,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,GACnD,KAAK,IAAI,KAAK,CAEhB"}

package/dist/server/core/conversations/availability.js

@@ -0,0 +1,28 @@
+import { offersEntry } from '../../../shared/models.js';
+import { onlineEntryOf } from '../runs/index.js';
+export function availabilityOf(agent, userId, mayInvoke, 
+/** The count returned by claim eligibility, computed outside the write transaction. */
+onlineRunners, 
+/** With the system default chat model, which an online agent that lists no model answers with. */
+catalog, 
+/** The entry the conversation asks for; the agent's first when absent or no longer listed. */
+wanted) {
+    if (!agent)
+        return { online: false, reason: 'agentMissing', onlineRunners: 0 };
+    if (agent.archivedAt)
+        return { online: false, reason: 'agentArchived', onlineRunners: 0 };
+    if (!mayInvoke(agent, userId))
+        return { online: false, reason: 'forbidden', onlineRunners: 0 };
+    if (agent.type === 'online')
+        return offersEntry(catalog, onlineEntryOf(agent, wanted, catalog.defaultModel ?? null))
+            ? { online: true, reason: null, onlineRunners: 1 }
+            : { online: false, reason: 'modelUnavailable', onlineRunners: 0 };
+    return onlineRunners > 0
+        ? { online: true, reason: null, onlineRunners }
+        : { online: false, reason: 'noRunner', onlineRunners: 0 };
+}
+/** Whether the agent may be woken for the person at all (it may still wait for a runner). */
+export function wakeable(agent, userId, mayInvoke) {
+    return Boolean(agent && !agent.archivedAt && mayInvoke(agent, userId));
+}
+//# sourceMappingURL=availability.js.map

package/dist/server/core/conversations/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../../../server/core/conversations/availability.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAqB,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,UAAU,cAAc,CAC5B,KAAmB,EACnB,MAAc,EACd,SAAoD;AACpD,uFAAuF;AACvF,aAAqB;AACrB,kGAAkG;AAClG,OAAwD;AACxD,8FAA8F;AAC9F,MAAyB;IAEzB,IAAI,CAAC,KAAK;QACR,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IACrE,IAAI,KAAK,CAAC,UAAU;QAClB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IACtE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IAClE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QACzB,OAAO,WAAW,CAChB,OAAO,EACP,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,CAC3D;YACC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE;YAClD,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IACtE,OAAO,aAAa,GAAG,CAAC;QACtB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE;QAC/C,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,QAAQ,CACtB,KAAmB,EACnB,MAAc,EACd,SAAoD;IAEpD,OAAO,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/server/core/conversations/chat-settings.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Who new conversations go to: the team's system default chat agent and online fallback agent (`agSettings`, key
+ * `chat`) and each person's own default (`agChatPreferences`).
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import { z } from 'zod';
+import type { ChatPreferences, ChatPreferencesPatch, ChatSettings, ChatSettingsPatch } from '../../../shared/conversations.js';
+import type { Clock } from '../../kernel/clock.js';
+import type { TxRunner } from '../../kernel/tx.js';
+import type { AgentService } from '../agents/index.js';
+export declare const ChatPreferencesPatchSchema: z.ZodType<ChatPreferencesPatch>;
+export declare const ChatSettingsPatchSchema: z.ZodType<ChatSettingsPatch>;
+export interface ChatSettingsService {
+    settings(conn?: DatabaseConnection): Promise<ChatSettings>;
+    /** Who may change it is the route's concern (`agents.agents` manage). */
+    updateSettings(byUserId: string, patch: ChatSettingsPatch): Promise<ChatSettings>;
+    preferences(userId: string, conn?: DatabaseConnection): Promise<ChatPreferences>;
+    /** The default agent must be one the person may wake. */
+    updatePreferences(userId: string, patch: ChatPreferencesPatch): Promise<ChatPreferences>;
+}
+export declare function createChatSettingsService(deps: {
+    readonly tx: TxRunner;
+    readonly clock: Clock;
+    readonly agents: Pick<AgentService, 'mayInvoke'>;
+}): ChatSettingsService;
+//# sourceMappingURL=chat-settings.d.ts.map

package/dist/server/core/conversations/chat-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-settings.d.ts","sourceRoot":"","sources":["../../../../server/core/conversations/chat-settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAI3D,CAAC;AAEb,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAKrD,CAAC;AAEb,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3D,yEAAyE;IACzE,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,WAAW,CACT,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,yDAAyD;IACzD,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;CAClD,GAAG,mBAAmB,CAkHtB"}