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

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,15 @@
+/**
+ * Whether an agent can answer a person now: it exists, is enabled, the person may wake it, and it has where to run: an
+ * online runner that has its tool and model and may run that person's work (shared with the team, or the person's
+ * own), with the features and variable restrictions claim requires.
+ */
+import type { Agent } from '../../../shared/agents.js';
+import type { ChatAvailability } from '../../../shared/conversations.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, 
+/** Whether some online runner has the agent's tool and model, whoever's work it takes. */
+anyRunner?: boolean): 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;;;;GAIG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,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,0FAA0F;AAC1F,SAAS,UAAQ,GAChB,gBAAgB,CAalB;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,CAIhB"}

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

@@ -0,0 +1,24 @@
+export function availabilityOf(agent, userId, mayInvoke, 
+/** The count returned by claim eligibility, computed outside the write transaction. */
+onlineRunners, 
+/** Whether some online runner has the agent's tool and model, whoever's work it takes. */
+anyRunner = false) {
+    if (!agent)
+        return { online: false, reason: 'agentMissing', onlineRunners: 0 };
+    if (agent.status !== 'enabled')
+        return { online: false, reason: 'agentArchived', onlineRunners: 0 };
+    if (!mayInvoke(agent, userId))
+        return { online: false, reason: 'forbidden', onlineRunners: 0 };
+    if (onlineRunners > 0)
+        return { online: true, reason: null, onlineRunners };
+    return {
+        online: false,
+        reason: anyRunner ? 'othersPersonal' : '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.status === 'enabled' && 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":"AAQA,MAAM,UAAU,cAAc,CAC5B,KAAmB,EACnB,MAAc,EACd,SAAoD;AACpD,uFAAuF;AACvF,aAAqB;AACrB,0FAA0F;AAC1F,SAAS,GAAG,KAAK;IAEjB,IAAI,CAAC,KAAK;QACR,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IACrE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAC5B,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,aAAa,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC5E,OAAO;QACL,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU;QACjD,aAAa,EAAE,CAAC;KACjB,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,QAAQ,CACtB,KAAmB,EACnB,MAAc,EACd,SAAoD;IAEpD,OAAO,OAAO,CACZ,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAChE,CAAC;AACJ,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 (`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,CAIrD,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,CAgGtB"}

package/dist/server/core/conversations/chat-settings.js

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+import { forbidden, invalid } from '../../kernel/errors.js';
+import { asJson, jsonObject } from '../../kernel/values.js';
+import { findAgent } from '../agents/index.js';
+import { preferencesRepo, settingsRepo } from './conversation.store.js';
+const CHAT_SETTINGS_KEY = 'chat';
+export const ChatPreferencesPatchSchema = z
+    .strictObject({
+    defaultAgentId: z.string().min(1).max(64).nullable(),
+})
+    .partial();
+export const ChatSettingsPatchSchema = z
+    .strictObject({
+    defaultAgentId: z.string().min(1).max(64).nullable(),
+})
+    .partial();
+export function createChatSettingsService(deps) {
+    const { tx, clock } = deps;
+    async function readSettings(conn) {
+        const row = await settingsRepo(conn).findOne({
+            filter: { key: CHAT_SETTINGS_KEY },
+        });
+        const value = jsonObject(row?.value);
+        return {
+            defaultAgentId: typeof value.defaultAgentId === 'string' ? value.defaultAgentId : null,
+        };
+    }
+    async function readPreferences(conn, userId) {
+        const row = await preferencesRepo(conn).findOne({ filter: { userId } });
+        return {
+            defaultAgentId: row?.defaultAgentId ?? null,
+        };
+    }
+    return {
+        settings: (conn) => readSettings(conn ?? tx.read()),
+        updateSettings: (byUserId, patch) => tx.run(async ({ conn }) => {
+            const current = await readSettings(conn);
+            const next = { ...current, ...patch };
+            if (next.defaultAgentId !== null) {
+                const agent = await findAgent(conn, next.defaultAgentId);
+                if (!agent || agent.status !== 'enabled')
+                    throw invalid('defaultAgentId names no enabled agent.', {
+                        field: 'defaultAgentId',
+                    });
+            }
+            const now = clock.now().toISOString();
+            const values = {
+                value: asJson(next),
+                updatedById: byUserId,
+                updatedAt: now,
+            };
+            const existing = await settingsRepo(conn).findOne({
+                filter: { key: CHAT_SETTINGS_KEY },
+            });
+            if (existing)
+                await settingsRepo(conn).updateMany({
+                    filter: { key: CHAT_SETTINGS_KEY },
+                    values,
+                });
+            else
+                await settingsRepo(conn).createOne({
+                    values: { key: CHAT_SETTINGS_KEY, ...values },
+                });
+            return next;
+        }),
+        preferences: (userId, conn) => readPreferences(conn ?? tx.read(), userId),
+        updatePreferences: (userId, patch) => tx.run(async ({ conn }) => {
+            const current = await readPreferences(conn, userId);
+            const next = { ...current, ...patch };
+            if (patch.defaultAgentId !== undefined &&
+                next.defaultAgentId !== null) {
+                const agent = await findAgent(conn, next.defaultAgentId);
+                if (!agent)
+                    throw invalid('defaultAgentId names no agent.', {
+                        field: 'defaultAgentId',
+                    });
+                if (!deps.agents.mayInvoke(agent, userId))
+                    throw forbidden('You may not chat with this agent.');
+            }
+            const values = {
+                defaultAgentId: next.defaultAgentId,
+                updatedAt: clock.now().toISOString(),
+            };
+            const existing = await preferencesRepo(conn).findOne({
+                filter: { userId },
+            });
+            if (existing)
+                await preferencesRepo(conn).updateMany({
+                    filter: { userId },
+                    values,
+                });
+            else
+                await preferencesRepo(conn).createOne({
+                    values: { userId, ...values },
+                });
+            return next;
+        }),
+    };
+}
+//# sourceMappingURL=chat-settings.js.map

package/dist/server/core/conversations/chat-settings.js.map

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

package/dist/server/core/conversations/conversation.service.d.ts

@@ -0,0 +1,29 @@
+import type { Clock } from '../../kernel/clock.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { People } from '../../kernel/people.js';
+import type { TxRunner } from '../../kernel/tx.js';
+import type { AgentService } from '../agents/index.js';
+import type { RunnerService } from '../../runners/index.js';
+import { type ClaimEligibility, type RunService } from '../runs/index.js';
+import { type ChatAttachmentLinks } from './attachments.js';
+import type { ChatSettingsService } from './chat-settings.js';
+import { type PageContextKinds } from './page-context.js';
+import type { ConversationService } from './ports.js';
+export interface ConversationServiceDeps {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly clock: Clock;
+    readonly agents: Pick<AgentService, 'mayInvoke' | 'get' | 'list'>;
+    readonly runners: Pick<RunnerService, 'list'>;
+    readonly eligibility: Pick<ClaimEligibility, 'canClaim' | 'runnersFor'>;
+    readonly runs: Pick<RunService, 'enqueue' | 'cancel' | 'withdrawQueued' | 'get' | 'detail'>;
+    readonly people: People;
+    readonly settings: ChatSettingsService;
+    readonly contextKinds: PageContextKinds;
+    /** The files people send with messages; without them a message that names files is refused. */
+    readonly attachments?: ChatAttachmentLinks;
+    /** The application's public base path (`/app`, or empty), for the files' URLs. */
+    readonly basePath?: () => string;
+}
+export declare function createConversationService(deps: ConversationServiceDeps): ConversationService;
+//# sourceMappingURL=conversation.service.d.ts.map

package/dist/server/core/conversations/conversation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.service.d.ts","sourceRoot":"","sources":["../../../../server/core/conversations/conversation.service.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAOnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAM,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAOL,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAGhB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAgB9D,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAGV,mBAAmB,EAGpB,MAAM,YAAY,CAAC;AAgBpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IAClE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC;IACxE,QAAQ,CAAC,IAAI,EAAE,IAAI,CACjB,UAAU,EACV,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,KAAK,GAAG,QAAQ,CAC3D,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;CAClC;AA4GD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,uBAAuB,GAC5B,mBAAmB,CAytCrB"}