@humaan/payload-plugin-ai-assistant 0.0.0-stage → 0.1.1

package/dist/endpoints/chatEndpoint.js

@@ -0,0 +1,295 @@
+import { createGateway } from '@ai-sdk/gateway';
+import { convertToModelMessages, createIdGenerator, stepCountIs, streamText } from 'ai';
+import { addAttachments, conversationFiles, modelFileParts } from '../attachments/conversation.js';
+import { findAttachments } from '../attachments/store.js';
+import { activeBilling, redactKey } from '../billing.js';
+import { pruneToolResults, threadTitle, withTurnContext } from '../chat/history.js';
+import { findThread, saveThread } from '../chat/threads.js';
+import { assistantTools, readDocument } from '../chat/tools.js';
+import { recordSpend, spendCheck, spentToday } from '../chat/usage.js';
+import { chatEndpointPath, defaultModelId, keepToolResultsForTurns, maxContextCharacters, maxModelSteps, maxSourceCharacters } from '../constants.js';
+import { planTargets } from '../plan/catalogue.js';
+import { systemPrompt } from '../plan/prompt.js';
+import { outline } from '../read/outline.js';
+import { readableTarget } from '../read/readTarget.js';
+import { allowAssistant } from './access.js';
+import { accountAllowance, budgetExceededMessage, dailyCapUsd } from './allowance.js';
+import { errorMessage, readChatForm } from './form.js';
+const generateMessageId = createIdGenerator({
+    prefix: 'msg',
+    size: 16
+});
+/**
+ * One turn of a conversation. The drawer sends the new message; the history comes from the stored thread,
+ * so a client cannot rewrite what the assistant said earlier. The reply streams back as UI message parts.
+ */ export function chatEndpoint(options, fallback, siteKey) {
+    return {
+        path: chatEndpointPath,
+        method: 'post',
+        handler: async (req)=>{
+            const settings = await allowAssistant(req, fallback);
+            if (settings instanceof Response) {
+                return settings;
+            }
+            const timeZone = options.timeZone ?? 'UTC';
+            const model = options.model ?? defaultModelId;
+            const billing = activeBilling(settings.billing, siteKey);
+            // Still read on the own key: a failed key falls back to Vercel's credit, which the budget caps.
+            const allowance = await accountAllowance(req);
+            const spend = spendCheck({
+                spentUsd: await spentToday(req, timeZone),
+                // The cap is a share of the Vercel budget, so it only applies when Vercel pays.
+                capUsd: billing.billing === 'vercel' ? dailyCapUsd(settings.dailySpendCapPercent, allowance) : undefined
+            });
+            if (spend.blocked) {
+                return Response.json({
+                    message: "You have used today's assistant allowance. It resets at midnight. An admin can raise the cap in the Humaan AI settings."
+                }, {
+                    status: 429
+                });
+            }
+            const form = await readChatForm(req);
+            if (form instanceof Response) {
+                return form;
+            }
+            const incoming = parseIncomingMessage(form.message);
+            if (!incoming) {
+                return Response.json({
+                    message: 'The message could not be read.'
+                }, {
+                    status: 400
+                });
+            }
+            const thread = await findThread(req, form.chatId);
+            const knownFiles = thread?.files ?? [];
+            const match = addAttachments(knownFiles, form.attachmentIds, await findAttachments(req, form.attachmentIds));
+            if (!match.ok) {
+                return Response.json({
+                    message: match.message
+                }, {
+                    status: 400
+                });
+            }
+            if (!incoming.text && match.added.length === 0) {
+                return Response.json({
+                    message: 'Add a message or a file.'
+                }, {
+                    status: 400
+                });
+            }
+            const context = parsePageContext(req, form.context);
+            const attachments = match.added.map((file, offset)=>({
+                    index: knownFiles.length + offset,
+                    name: file.name,
+                    type: file.type
+                }));
+            const userMessage = {
+                id: incoming.id,
+                role: 'user',
+                parts: incoming.text ? [
+                    {
+                        type: 'text',
+                        text: incoming.text
+                    }
+                ] : [],
+                metadata: {
+                    ...attachments.length > 0 ? {
+                        attachments
+                    } : {},
+                    ...context ? {
+                        context
+                    } : {}
+                }
+            };
+            const history = [
+                ...thread?.messages ?? [],
+                userMessage
+            ];
+            const { files } = match;
+            const title = thread?.title || threadTitle(incoming.text || attachments.map((file)=>file.name).join(', '));
+            // Saved before the model runs, so the editor's message survives a failed reply.
+            const threadId = await saveThread(req, {
+                id: thread?.id,
+                chatId: form.chatId,
+                title,
+                messages: history,
+                files
+            });
+            const available = conversationFiles(req.payload.config, files);
+            const open = context ? await readOpenDocument(req, context, form.contextData) : undefined;
+            let planned = false;
+            const tools = assistantTools({
+                req,
+                chatId: form.chatId,
+                collectionRules: options.collectionRules,
+                files: available,
+                onPlan: ()=>{
+                    planned = true;
+                },
+                openDocument: open
+            });
+            const modelMessages = await convertToModelMessages(withTurnContext(pruneToolResults(history, keepToolResultsForTurns), {
+                files: available,
+                fileParts: await modelFileParts(req, available),
+                openDocument: open ? outlineText(open.document) : undefined
+            }), {
+                tools,
+                ignoreIncompleteToolCalls: true
+            });
+            // The gateway authenticates with the deployment's OIDC token. On the own key, the credentials are sent with
+            // each request instead of being set in the Vercel dashboard, which would apply to every project on the team.
+            const gateway = createGateway();
+            const ownKey = billing.billing === 'own-key' ? billing.key : undefined;
+            // Counted when the run ends, including a run the editor stopped, so the cap sees every reply.
+            const record = async (steps)=>{
+                try {
+                    await recordSpend(req, timeZone, gateway, steps, billing.billing);
+                } catch (error) {
+                    req.payload.logger.error({
+                        err: error,
+                        chatId: form.chatId
+                    }, 'Humaan AI could not record spend');
+                }
+            };
+            const result = streamText({
+                model: gateway(model),
+                system: systemPrompt(options.siteRules),
+                messages: modelMessages,
+                tools,
+                stopWhen: [
+                    stepCountIs(maxModelSteps),
+                    ()=>planned
+                ],
+                maxOutputTokens: 16_000,
+                maxRetries: 1,
+                abortSignal: req.signal,
+                onFinish: ({ steps })=>record(steps),
+                onAbort: ({ steps })=>record(steps),
+                providerOptions: {
+                    // Each step resends the conversation so far. Caching makes the repeated part cheap.
+                    gateway: {
+                        caching: 'auto',
+                        // Providers with credentials are tried first, so the model runs where the site's own key can pay.
+                        ...ownKey ? {
+                            byok: ownKey.credentials,
+                            order: ownKey.providers
+                        } : {}
+                    },
+                    anthropic: {
+                        thinking: {
+                            type: 'adaptive'
+                        },
+                        effort: 'low'
+                    }
+                }
+            });
+            // Keeps the run going to its end if the browser goes away, so onFinish still saves the reply.
+            void result.consumeStream();
+            return result.toUIMessageStreamResponse({
+                originalMessages: history,
+                generateMessageId,
+                sendReasoning: false,
+                messageMetadata: ({ part })=>part.type === 'finish' ? {
+                        usage: {
+                            inputTokens: part.totalUsage.inputTokens,
+                            outputTokens: part.totalUsage.outputTokens,
+                            totalTokens: part.totalUsage.totalTokens,
+                            cachedInputTokens: part.totalUsage.inputTokenDetails.cacheReadTokens
+                        }
+                    } : undefined,
+                onFinish: async ({ messages, responseMessage })=>{
+                    if (responseMessage.parts.length === 0) {
+                        return;
+                    }
+                    try {
+                        await saveThread(req, {
+                            id: threadId,
+                            chatId: form.chatId,
+                            title,
+                            messages,
+                            files
+                        });
+                    } catch (error) {
+                        req.payload.logger.error({
+                            err: error,
+                            chatId: form.chatId
+                        }, 'Humaan AI could not save the conversation');
+                    }
+                },
+                onError: (error)=>{
+                    // A provider's error can echo the credentials it was given.
+                    const message = redactKey(errorMessage(error), ownKey);
+                    req.payload.logger.error({
+                        message,
+                        chatId: form.chatId
+                    }, 'Humaan AI reply failed');
+                    // The gateway's own budget message names dollar amounts, which editors do not see.
+                    return budgetExceededMessage(message, allowance, timeZone) ?? message;
+                }
+            });
+        }
+    };
+}
+function parseIncomingMessage(value) {
+    if (!isRecord(value) || typeof value.id !== 'string' || !/^[\w-]{1,64}$/.test(value.id)) {
+        return undefined;
+    }
+    if (value.role !== 'user' || !Array.isArray(value.parts)) {
+        return undefined;
+    }
+    const text = value.parts.flatMap((part)=>isRecord(part) && part.type === 'text' && typeof part.text === 'string' ? [
+            part.text
+        ] : []).join('\n').trim();
+    if (text.length > maxSourceCharacters) {
+        return undefined;
+    }
+    return {
+        id: value.id,
+        text
+    };
+}
+/** Only targets the assistant may read. A collection document with no id is one being created. The label is shown to the model, so it is cut short. */ function parsePageContext(req, value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const kind = value.kind === 'global' ? 'global' : value.kind === 'collection' ? 'collection' : undefined;
+    const slug = typeof value.slug === 'string' ? value.slug : '';
+    if (!kind || !planTargets(req.payload.config).some((target)=>target.kind === kind && target.slug === slug)) {
+        return undefined;
+    }
+    const id = typeof value.id === 'string' && /^[\w-]{1,64}$/.test(value.id) ? value.id : undefined;
+    const label = typeof value.label === 'string' && value.label.trim() ? value.label.trim().slice(0, 200) : slug;
+    return {
+        kind,
+        slug,
+        ...id ? {
+            id
+        } : {},
+        label
+    };
+}
+/**
+ * The open document as the model reads it. Form values from the drawer include unsaved changes;
+ * without them, the saved document is read with the editor's access.
+ */ async function readOpenDocument(req, context, formData) {
+    if (isRecord(formData)) {
+        return {
+            context,
+            document: await readableTarget(req.payload.config, context.kind, context.slug, formData)
+        };
+    }
+    const read = await readDocument(req, context.kind, context.slug, context.id);
+    return 'error' in read ? undefined : {
+        context,
+        document: read.document
+    };
+}
+/** Sent with every message, so it is an outline. readDocument with a path returns any part in full. */ function outlineText(document) {
+    const json = JSON.stringify(outline(document));
+    return json.length > maxContextCharacters ? `${json.slice(0, maxContextCharacters)} [cut: ${json.length - maxContextCharacters} more characters]` : json;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+//# sourceMappingURL=chatEndpoint.js.map

package/dist/endpoints/chatEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/chatEndpoint.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport { createGateway } from '@ai-sdk/gateway'\nimport { convertToModelMessages, createIdGenerator, stepCountIs, streamText } from 'ai'\n\nimport type { OwnKey } from '../billing.js'\nimport type { AssistantUIMessage } from '../chat/messages.js'\nimport type { OpenDocument } from '../chat/tools.js'\nimport type { StepSpend } from '../chat/usage.js'\nimport type { IncomingFile } from '../plan/parsePlan.js'\nimport type {\n  AiAssistantPluginOptions,\n  AssistantSettings,\n  AttachmentView,\n  PageContext,\n} from '../types.js'\n\nimport { addAttachments, conversationFiles, modelFileParts } from '../attachments/conversation.js'\nimport { findAttachments } from '../attachments/store.js'\nimport { activeBilling, redactKey } from '../billing.js'\nimport { pruneToolResults, threadTitle, withTurnContext } from '../chat/history.js'\nimport { findThread, saveThread } from '../chat/threads.js'\nimport { assistantTools, readDocument } from '../chat/tools.js'\nimport { recordSpend, spendCheck, spentToday } from '../chat/usage.js'\nimport {\n  chatEndpointPath,\n  defaultModelId,\n  keepToolResultsForTurns,\n  maxContextCharacters,\n  maxModelSteps,\n  maxSourceCharacters,\n} from '../constants.js'\nimport { planTargets } from '../plan/catalogue.js'\nimport { systemPrompt } from '../plan/prompt.js'\nimport { outline } from '../read/outline.js'\nimport { readableTarget } from '../read/readTarget.js'\nimport { allowAssistant } from './access.js'\nimport { accountAllowance, budgetExceededMessage, dailyCapUsd } from './allowance.js'\nimport { errorMessage, readChatForm } from './form.js'\n\nconst generateMessageId = createIdGenerator({ prefix: 'msg', size: 16 })\n\n/**\n * One turn of a conversation. The drawer sends the new message; the history comes from the stored thread,\n * so a client cannot rewrite what the assistant said earlier. The reply streams back as UI message parts.\n */\nexport function chatEndpoint(\n  options: AiAssistantPluginOptions,\n  fallback: AssistantSettings,\n  siteKey: OwnKey | undefined,\n) {\n  return {\n    path: chatEndpointPath,\n    method: 'post' as const,\n    handler: async (req: PayloadRequest) => {\n      const settings = await allowAssistant(req, fallback)\n      if (settings instanceof Response) {\n        return settings\n      }\n\n      const timeZone = options.timeZone ?? 'UTC'\n      const model = options.model ?? defaultModelId\n      const billing = activeBilling(settings.billing, siteKey)\n      // Still read on the own key: a failed key falls back to Vercel's credit, which the budget caps.\n      const allowance = await accountAllowance(req)\n      const spend = spendCheck({\n        spentUsd: await spentToday(req, timeZone),\n        // The cap is a share of the Vercel budget, so it only applies when Vercel pays.\n        capUsd:\n          billing.billing === 'vercel'\n            ? dailyCapUsd(settings.dailySpendCapPercent, allowance)\n            : undefined,\n      })\n      if (spend.blocked) {\n        return Response.json(\n          {\n            message:\n              \"You have used today's assistant allowance. It resets at midnight. An admin can raise the cap in the Humaan AI settings.\",\n          },\n          { status: 429 },\n        )\n      }\n\n      const form = await readChatForm(req)\n      if (form instanceof Response) {\n        return form\n      }\n      const incoming = parseIncomingMessage(form.message)\n      if (!incoming) {\n        return Response.json({ message: 'The message could not be read.' }, { status: 400 })\n      }\n\n      const thread = await findThread(req, form.chatId)\n      const knownFiles = thread?.files ?? []\n      const match = addAttachments(\n        knownFiles,\n        form.attachmentIds,\n        await findAttachments(req, form.attachmentIds),\n      )\n      if (!match.ok) {\n        return Response.json({ message: match.message }, { status: 400 })\n      }\n      if (!incoming.text && match.added.length === 0) {\n        return Response.json({ message: 'Add a message or a file.' }, { status: 400 })\n      }\n\n      const context = parsePageContext(req, form.context)\n      const attachments: AttachmentView[] = match.added.map((file, offset) => ({\n        index: knownFiles.length + offset,\n        name: file.name,\n        type: file.type,\n      }))\n      const userMessage: AssistantUIMessage = {\n        id: incoming.id,\n        role: 'user',\n        parts: incoming.text ? [{ type: 'text', text: incoming.text }] : [],\n        metadata: {\n          ...(attachments.length > 0 ? { attachments } : {}),\n          ...(context ? { context } : {}),\n        },\n      }\n      const history = [...(thread?.messages ?? []), userMessage]\n      const { files } = match\n      const title =\n        thread?.title ||\n        threadTitle(incoming.text || attachments.map((file) => file.name).join(', '))\n\n      // Saved before the model runs, so the editor's message survives a failed reply.\n      const threadId = await saveThread(req, {\n        id: thread?.id,\n        chatId: form.chatId,\n        title,\n        messages: history,\n        files,\n      })\n\n      const available: IncomingFile[] = conversationFiles(req.payload.config, files)\n      const open = context ? await readOpenDocument(req, context, form.contextData) : undefined\n      let planned = false\n      const tools = assistantTools({\n        req,\n        chatId: form.chatId,\n        collectionRules: options.collectionRules,\n        files: available,\n        onPlan: () => {\n          planned = true\n        },\n        openDocument: open,\n      })\n\n      const modelMessages = await convertToModelMessages(\n        withTurnContext(pruneToolResults(history, keepToolResultsForTurns), {\n          files: available,\n          fileParts: await modelFileParts(req, available),\n          openDocument: open ? outlineText(open.document) : undefined,\n        }),\n        { tools, ignoreIncompleteToolCalls: true },\n      )\n\n      // The gateway authenticates with the deployment's OIDC token. On the own key, the credentials are sent with\n      // each request instead of being set in the Vercel dashboard, which would apply to every project on the team.\n      const gateway = createGateway()\n      const ownKey = billing.billing === 'own-key' ? billing.key : undefined\n      // Counted when the run ends, including a run the editor stopped, so the cap sees every reply.\n      const record = async (steps: readonly StepSpend[]) => {\n        try {\n          await recordSpend(req, timeZone, gateway, steps, billing.billing)\n        } catch (error) {\n          req.payload.logger.error(\n            { err: error, chatId: form.chatId },\n            'Humaan AI could not record spend',\n          )\n        }\n      }\n      const result = streamText({\n        model: gateway(model),\n        system: systemPrompt(options.siteRules),\n        messages: modelMessages,\n        tools,\n        stopWhen: [stepCountIs(maxModelSteps), () => planned],\n        maxOutputTokens: 16_000,\n        maxRetries: 1,\n        abortSignal: req.signal,\n        onFinish: ({ steps }) => record(steps as readonly StepSpend[]),\n        onAbort: ({ steps }) => record(steps as readonly StepSpend[]),\n        providerOptions: {\n          // Each step resends the conversation so far. Caching makes the repeated part cheap.\n          gateway: {\n            caching: 'auto',\n            // Providers with credentials are tried first, so the model runs where the site's own key can pay.\n            ...(ownKey ? { byok: ownKey.credentials, order: ownKey.providers } : {}),\n          },\n          anthropic: {\n            thinking: { type: 'adaptive' },\n            effort: 'low',\n          },\n        },\n      })\n      // Keeps the run going to its end if the browser goes away, so onFinish still saves the reply.\n      void result.consumeStream()\n\n      return result.toUIMessageStreamResponse<AssistantUIMessage>({\n        originalMessages: history,\n        generateMessageId,\n        sendReasoning: false,\n        messageMetadata: ({ part }) =>\n          part.type === 'finish'\n            ? {\n                usage: {\n                  inputTokens: part.totalUsage.inputTokens,\n                  outputTokens: part.totalUsage.outputTokens,\n                  totalTokens: part.totalUsage.totalTokens,\n                  cachedInputTokens: part.totalUsage.inputTokenDetails.cacheReadTokens,\n                },\n              }\n            : undefined,\n        onFinish: async ({ messages, responseMessage }) => {\n          if (responseMessage.parts.length === 0) {\n            return\n          }\n          try {\n            await saveThread(req, { id: threadId, chatId: form.chatId, title, messages, files })\n          } catch (error) {\n            req.payload.logger.error(\n              { err: error, chatId: form.chatId },\n              'Humaan AI could not save the conversation',\n            )\n          }\n        },\n        onError: (error) => {\n          // A provider's error can echo the credentials it was given.\n          const message = redactKey(errorMessage(error), ownKey)\n          req.payload.logger.error({ message, chatId: form.chatId }, 'Humaan AI reply failed')\n          // The gateway's own budget message names dollar amounts, which editors do not see.\n          return budgetExceededMessage(message, allowance, timeZone) ?? message\n        },\n      })\n    },\n  }\n}\n\nfunction parseIncomingMessage(value: unknown): { id: string; text: string } | undefined {\n  if (!isRecord(value) || typeof value.id !== 'string' || !/^[\\w-]{1,64}$/.test(value.id)) {\n    return undefined\n  }\n  if (value.role !== 'user' || !Array.isArray(value.parts)) {\n    return undefined\n  }\n  const text = value.parts\n    .flatMap((part) =>\n      isRecord(part) && part.type === 'text' && typeof part.text === 'string' ? [part.text] : [],\n    )\n    .join('\\n')\n    .trim()\n  if (text.length > maxSourceCharacters) {\n    return undefined\n  }\n  return { id: value.id, text }\n}\n\n/** Only targets the assistant may read. A collection document with no id is one being created. The label is shown to the model, so it is cut short. */\nfunction parsePageContext(req: PayloadRequest, value: unknown): PageContext | undefined {\n  if (!isRecord(value)) {\n    return undefined\n  }\n  const kind =\n    value.kind === 'global' ? 'global' : value.kind === 'collection' ? 'collection' : undefined\n  const slug = typeof value.slug === 'string' ? value.slug : ''\n  if (\n    !kind ||\n    !planTargets(req.payload.config).some((target) => target.kind === kind && target.slug === slug)\n  ) {\n    return undefined\n  }\n  const id = typeof value.id === 'string' && /^[\\w-]{1,64}$/.test(value.id) ? value.id : undefined\n  const label =\n    typeof value.label === 'string' && value.label.trim() ? value.label.trim().slice(0, 200) : slug\n  return { kind, slug, ...(id ? { id } : {}), label }\n}\n\n/**\n * The open document as the model reads it. Form values from the drawer include unsaved changes;\n * without them, the saved document is read with the editor's access.\n */\nasync function readOpenDocument(\n  req: PayloadRequest,\n  context: PageContext,\n  formData: unknown,\n): Promise<OpenDocument | undefined> {\n  if (isRecord(formData)) {\n    return {\n      context,\n      document: await readableTarget(req.payload.config, context.kind, context.slug, formData),\n    }\n  }\n  const read = await readDocument(req, context.kind, context.slug, context.id)\n  return 'error' in read ? undefined : { context, document: read.document }\n}\n\n/** Sent with every message, so it is an outline. readDocument with a path returns any part in full. */\nfunction outlineText(document: unknown): string {\n  const json = JSON.stringify(outline(document))\n  return json.length > maxContextCharacters\n    ? `${json.slice(0, maxContextCharacters)} [cut: ${json.length - maxContextCharacters} more characters]`\n    : json\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n}\n"],"names":["createGateway","convertToModelMessages","createIdGenerator","stepCountIs","streamText","addAttachments","conversationFiles","modelFileParts","findAttachments","activeBilling","redactKey","pruneToolResults","threadTitle","withTurnContext","findThread","saveThread","assistantTools","readDocument","recordSpend","spendCheck","spentToday","chatEndpointPath","defaultModelId","keepToolResultsForTurns","maxContextCharacters","maxModelSteps","maxSourceCharacters","planTargets","systemPrompt","outline","readableTarget","allowAssistant","accountAllowance","budgetExceededMessage","dailyCapUsd","errorMessage","readChatForm","generateMessageId","prefix","size","chatEndpoint","options","fallback","siteKey","path","method","handler","req","settings","Response","timeZone","model","billing","allowance","spend","spentUsd","capUsd","dailySpendCapPercent","undefined","blocked","json","message","status","form","incoming","parseIncomingMessage","thread","chatId","knownFiles","files","match","attachmentIds","ok","text","added","length","context","parsePageContext","attachments","map","file","offset","index","name","type","userMessage","id","role","parts","metadata","history","messages","title","join","threadId","available","payload","config","open","readOpenDocument","contextData","planned","tools","collectionRules","onPlan","openDocument","modelMessages","fileParts","outlineText","document","ignoreIncompleteToolCalls","gateway","ownKey","key","record","steps","error","logger","err","result","system","siteRules","stopWhen","maxOutputTokens","maxRetries","abortSignal","signal","onFinish","onAbort","providerOptions","caching","byok","credentials","order","providers","anthropic","thinking","effort","consumeStream","toUIMessageStreamResponse","originalMessages","sendReasoning","messageMetadata","part","usage","inputTokens","totalUsage","outputTokens","totalTokens","cachedInputTokens","inputTokenDetails","cacheReadTokens","responseMessage","onError","value","isRecord","test","Array","isArray","flatMap","trim","kind","slug","some","target","label","slice","formData","read","JSON","stringify","Boolean"],"mappings":"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"}

package/dist/endpoints/form.d.ts

@@ -0,0 +1,23 @@
+import type { PayloadRequest } from 'payload';
+export interface ChatForm {
+    /**
+     * Attachments added since the last message, by id. The files are already in storage; the panel uploaded
+     * them directly, so no file passes through this request.
+     */
+    attachmentIds: string[];
+    chatId: string;
+    /** The document open in the admin, if any. */
+    context: unknown;
+    /** The open document's current form values, including unsaved changes. */
+    contextData: unknown;
+    /** The new user message, as the panel built it. Parsed and checked by the chat endpoint. */
+    message: unknown;
+}
+/** A chat request carries text and ids only, so it stays well under hosting request limits such as Vercel's. */
+export declare function readChatForm(req: PayloadRequest): Promise<ChatForm | Response>;
+/** Proceed sends only the plan's id. The files it saves are read from the conversation's attachments. */
+export declare function readPlanRequest(req: PayloadRequest): Promise<{
+    planId: string;
+} | Response>;
+/** The error's own message. Where a request carried the site's own provider key, redact it with `redactKey`. */
+export declare function errorMessage(error: unknown): string;

package/dist/endpoints/form.js

@@ -0,0 +1,95 @@
+import { maxContextUploadCharacters, maxFiles, maxSourceCharacters } from '../constants.js';
+/** A chat request carries text and ids only, so it stays well under hosting request limits such as Vercel's. */ export async function readChatForm(req) {
+    const form = await readFormData(req);
+    if (form instanceof Response) {
+        return form;
+    }
+    const chatId = textField(form, 'chatId');
+    if (!/^[\w-]{1,64}$/.test(chatId)) {
+        return Response.json({
+            message: 'Missing the conversation.'
+        }, {
+            status: 400
+        });
+    }
+    const rawMessage = textField(form, 'message');
+    const rawContextData = textField(form, 'contextData');
+    if (rawMessage.length > maxSourceCharacters * 2 || rawContextData.length > maxContextUploadCharacters) {
+        return Response.json({
+            message: 'The message is too long.'
+        }, {
+            status: 400
+        });
+    }
+    const attachmentIds = parseJson(textField(form, 'attachmentIds'));
+    if (attachmentIds !== undefined && (!Array.isArray(attachmentIds) || attachmentIds.length > maxFiles || !attachmentIds.every((id)=>typeof id === 'string' && /^[\w-]{1,64}$/.test(id)))) {
+        return Response.json({
+            message: 'The attachments could not be read.'
+        }, {
+            status: 400
+        });
+    }
+    return {
+        chatId,
+        message: parseJson(rawMessage),
+        context: parseJson(textField(form, 'context')),
+        contextData: parseJson(rawContextData),
+        attachmentIds: attachmentIds ?? []
+    };
+}
+/** Proceed sends only the plan's id. The files it saves are read from the conversation's attachments. */ export async function readPlanRequest(req) {
+    let body;
+    try {
+        body = await req.json?.();
+    } catch  {
+        body = undefined;
+    }
+    const planId = body && typeof body === 'object' && 'planId' in body && typeof body.planId === 'string' ? body.planId : '';
+    if (!planId) {
+        return Response.json({
+            message: 'Missing the plan.'
+        }, {
+            status: 400
+        });
+    }
+    return {
+        planId
+    };
+}
+/** The error's own message. Where a request carried the site's own provider key, redact it with `redactKey`. */ export function errorMessage(error) {
+    return error instanceof Error && error.message ? error.message : 'The assistant could not reply.';
+}
+function textField(form, name) {
+    const value = form.get(name);
+    return typeof value === 'string' ? value : '';
+}
+async function readFormData(req) {
+    if (typeof req.formData !== 'function') {
+        return Response.json({
+            message: 'Send the request as form data.'
+        }, {
+            status: 400
+        });
+    }
+    try {
+        return await req.formData();
+    } catch  {
+        return Response.json({
+            message: 'Send the request as form data.'
+        }, {
+            status: 400
+        });
+    }
+}
+function parseJson(value) {
+    if (!value) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(value);
+    } catch  {
+        return undefined;
+    }
+}
+
+//# sourceMappingURL=form.js.map

package/dist/endpoints/form.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/form.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport { maxContextUploadCharacters, maxFiles, maxSourceCharacters } from '../constants.js'\n\nexport interface ChatForm {\n  /**\n   * Attachments added since the last message, by id. The files are already in storage; the panel uploaded\n   * them directly, so no file passes through this request.\n   */\n  attachmentIds: string[]\n  chatId: string\n  /** The document open in the admin, if any. */\n  context: unknown\n  /** The open document's current form values, including unsaved changes. */\n  contextData: unknown\n  /** The new user message, as the panel built it. Parsed and checked by the chat endpoint. */\n  message: unknown\n}\n\n/** A chat request carries text and ids only, so it stays well under hosting request limits such as Vercel's. */\nexport async function readChatForm(req: PayloadRequest): Promise<ChatForm | Response> {\n  const form = await readFormData(req)\n  if (form instanceof Response) {\n    return form\n  }\n\n  const chatId = textField(form, 'chatId')\n  if (!/^[\\w-]{1,64}$/.test(chatId)) {\n    return Response.json({ message: 'Missing the conversation.' }, { status: 400 })\n  }\n\n  const rawMessage = textField(form, 'message')\n  const rawContextData = textField(form, 'contextData')\n  if (\n    rawMessage.length > maxSourceCharacters * 2 ||\n    rawContextData.length > maxContextUploadCharacters\n  ) {\n    return Response.json({ message: 'The message is too long.' }, { status: 400 })\n  }\n\n  const attachmentIds = parseJson(textField(form, 'attachmentIds'))\n  if (\n    attachmentIds !== undefined &&\n    (!Array.isArray(attachmentIds) ||\n      attachmentIds.length > maxFiles ||\n      !attachmentIds.every((id) => typeof id === 'string' && /^[\\w-]{1,64}$/.test(id)))\n  ) {\n    return Response.json({ message: 'The attachments could not be read.' }, { status: 400 })\n  }\n\n  return {\n    chatId,\n    message: parseJson(rawMessage),\n    context: parseJson(textField(form, 'context')),\n    contextData: parseJson(rawContextData),\n    attachmentIds: (attachmentIds as string[] | undefined) ?? [],\n  }\n}\n\n/** Proceed sends only the plan's id. The files it saves are read from the conversation's attachments. */\nexport async function readPlanRequest(req: PayloadRequest): Promise<{ planId: string } | Response> {\n  let body: unknown\n  try {\n    body = await req.json?.()\n  } catch {\n    body = undefined\n  }\n  const planId =\n    body && typeof body === 'object' && 'planId' in body && typeof body.planId === 'string'\n      ? body.planId\n      : ''\n  if (!planId) {\n    return Response.json({ message: 'Missing the plan.' }, { status: 400 })\n  }\n  return { planId }\n}\n\n/** The error's own message. Where a request carried the site's own provider key, redact it with `redactKey`. */\nexport function errorMessage(error: unknown): string {\n  return error instanceof Error && error.message ? error.message : 'The assistant could not reply.'\n}\n\nfunction textField(form: FormData, name: string): string {\n  const value = form.get(name)\n  return typeof value === 'string' ? value : ''\n}\n\nasync function readFormData(req: PayloadRequest): Promise<FormData | Response> {\n  if (typeof req.formData !== 'function') {\n    return Response.json({ message: 'Send the request as form data.' }, { status: 400 })\n  }\n  try {\n    return await req.formData()\n  } catch {\n    return Response.json({ message: 'Send the request as form data.' }, { status: 400 })\n  }\n}\n\nfunction parseJson(value: string): unknown {\n  if (!value) {\n    return undefined\n  }\n  try {\n    return JSON.parse(value)\n  } catch {\n    return undefined\n  }\n}\n"],"names":["maxContextUploadCharacters","maxFiles","maxSourceCharacters","readChatForm","req","form","readFormData","Response","chatId","textField","test","json","message","status","rawMessage","rawContextData","length","attachmentIds","parseJson","undefined","Array","isArray","every","id","context","contextData","readPlanRequest","body","planId","errorMessage","error","Error","name","value","get","formData","JSON","parse"],"mappings":"AAEA,SAASA,0BAA0B,EAAEC,QAAQ,EAAEC,mBAAmB,QAAQ,kBAAiB;AAiB3F,8GAA8G,GAC9G,OAAO,eAAeC,aAAaC,GAAmB;IACpD,MAAMC,OAAO,MAAMC,aAAaF;IAChC,IAAIC,gBAAgBE,UAAU;QAC5B,OAAOF;IACT;IAEA,MAAMG,SAASC,UAAUJ,MAAM;IAC/B,IAAI,CAAC,gBAAgBK,IAAI,CAACF,SAAS;QACjC,OAAOD,SAASI,IAAI,CAAC;YAAEC,SAAS;QAA4B,GAAG;YAAEC,QAAQ;QAAI;IAC/E;IAEA,MAAMC,aAAaL,UAAUJ,MAAM;IACnC,MAAMU,iBAAiBN,UAAUJ,MAAM;IACvC,IACES,WAAWE,MAAM,GAAGd,sBAAsB,KAC1Ca,eAAeC,MAAM,GAAGhB,4BACxB;QACA,OAAOO,SAASI,IAAI,CAAC;YAAEC,SAAS;QAA2B,GAAG;YAAEC,QAAQ;QAAI;IAC9E;IAEA,MAAMI,gBAAgBC,UAAUT,UAAUJ,MAAM;IAChD,IACEY,kBAAkBE,aACjB,CAAA,CAACC,MAAMC,OAAO,CAACJ,kBACdA,cAAcD,MAAM,GAAGf,YACvB,CAACgB,cAAcK,KAAK,CAAC,CAACC,KAAO,OAAOA,OAAO,YAAY,gBAAgBb,IAAI,CAACa,IAAG,GACjF;QACA,OAAOhB,SAASI,IAAI,CAAC;YAAEC,SAAS;QAAqC,GAAG;YAAEC,QAAQ;QAAI;IACxF;IAEA,OAAO;QACLL;QACAI,SAASM,UAAUJ;QACnBU,SAASN,UAAUT,UAAUJ,MAAM;QACnCoB,aAAaP,UAAUH;QACvBE,eAAe,AAACA,iBAA0C,EAAE;IAC9D;AACF;AAEA,uGAAuG,GACvG,OAAO,eAAeS,gBAAgBtB,GAAmB;IACvD,IAAIuB;IACJ,IAAI;QACFA,OAAO,MAAMvB,IAAIO,IAAI;IACvB,EAAE,OAAM;QACNgB,OAAOR;IACT;IACA,MAAMS,SACJD,QAAQ,OAAOA,SAAS,YAAY,YAAYA,QAAQ,OAAOA,KAAKC,MAAM,KAAK,WAC3ED,KAAKC,MAAM,GACX;IACN,IAAI,CAACA,QAAQ;QACX,OAAOrB,SAASI,IAAI,CAAC;YAAEC,SAAS;QAAoB,GAAG;YAAEC,QAAQ;QAAI;IACvE;IACA,OAAO;QAAEe;IAAO;AAClB;AAEA,8GAA8G,GAC9G,OAAO,SAASC,aAAaC,KAAc;IACzC,OAAOA,iBAAiBC,SAASD,MAAMlB,OAAO,GAAGkB,MAAMlB,OAAO,GAAG;AACnE;AAEA,SAASH,UAAUJ,IAAc,EAAE2B,IAAY;IAC7C,MAAMC,QAAQ5B,KAAK6B,GAAG,CAACF;IACvB,OAAO,OAAOC,UAAU,WAAWA,QAAQ;AAC7C;AAEA,eAAe3B,aAAaF,GAAmB;IAC7C,IAAI,OAAOA,IAAI+B,QAAQ,KAAK,YAAY;QACtC,OAAO5B,SAASI,IAAI,CAAC;YAAEC,SAAS;QAAiC,GAAG;YAAEC,QAAQ;QAAI;IACpF;IACA,IAAI;QACF,OAAO,MAAMT,IAAI+B,QAAQ;IAC3B,EAAE,OAAM;QACN,OAAO5B,SAASI,IAAI,CAAC;YAAEC,SAAS;QAAiC,GAAG;YAAEC,QAAQ;QAAI;IACpF;AACF;AAEA,SAASK,UAAUe,KAAa;IAC9B,IAAI,CAACA,OAAO;QACV,OAAOd;IACT;IACA,IAAI;QACF,OAAOiB,KAAKC,KAAK,CAACJ;IACpB,EAAE,OAAM;QACN,OAAOd;IACT;AACF"}

package/dist/endpoints/usageEndpoint.d.ts

@@ -0,0 +1,13 @@
+import type { PayloadRequest } from 'payload';
+import type { OwnKey } from '../billing.js';
+import type { AiAssistantPluginOptions, AssistantSettings } from '../types.js';
+/**
+ * On Vercel billing: the editor's own spend today against the daily cap and, for admins, the project's remaining
+ * budget, which is the whole project's, so editors do not see it. On the own key: which provider pays and, for
+ * admins, everyone's spend on the key today and any calls that fell back to Vercel's credit.
+ */
+export declare function usageEndpoint(fallback: AssistantSettings, options: AiAssistantPluginOptions, siteKey: OwnKey | undefined): {
+    path: string;
+    method: "get";
+    handler: (req: PayloadRequest) => Promise<Response>;
+};

package/dist/endpoints/usageEndpoint.js

@@ -0,0 +1,70 @@
+import { sweepExpiredAttachments } from '../attachments/store.js';
+import { activeBilling } from '../billing.js';
+import { dayIn, spendCheck, spentToday, usageTotals } from '../chat/usage.js';
+import { usageEndpointPath } from '../constants.js';
+import { isAdminRole } from '../settings.js';
+import { allowAssistant } from './access.js';
+import { accountAllowance, budgetView, dailyCapUsd } from './allowance.js';
+/**
+ * On Vercel billing: the editor's own spend today against the daily cap and, for admins, the project's remaining
+ * budget, which is the whole project's, so editors do not see it. On the own key: which provider pays and, for
+ * admins, everyone's spend on the key today and any calls that fell back to Vercel's credit.
+ */ export function usageEndpoint(fallback, options, siteKey) {
+    return {
+        path: usageEndpointPath,
+        method: 'get',
+        handler: async (req)=>{
+            const settings = await allowAssistant(req, fallback);
+            if (settings instanceof Response) {
+                return settings;
+            }
+            // Opening the panel is a convenient, regular moment to clear expired attachments, a few at a time,
+            // so no scheduled job is needed. A failure here must not stop the panel loading.
+            await sweepExpiredAttachments(req).catch((error)=>req.payload.logger.error({
+                    err: error
+                }, 'Humaan AI could not clear expired attachments'));
+            const timeZone = options.timeZone ?? 'UTC';
+            const billing = activeBilling(settings.billing, siteKey);
+            if (billing.billing === 'own-key') {
+                const ownKey = {
+                    provider: billing.key.label
+                };
+                if (isAdminRole(req.user)) {
+                    const day = dayIn(timeZone);
+                    const totals = await usageTotals(req, day, day);
+                    ownKey.todayUsd = totals.ownKeyUsd;
+                    ownKey.fallbackSteps = totals.fallbackSteps;
+                }
+                const view = {
+                    ownKey
+                };
+                return Response.json(view, {
+                    headers: {
+                        'Cache-Control': 'private, no-store'
+                    }
+                });
+            }
+            const allowance = await accountAllowance(req);
+            const today = spendCheck({
+                spentUsd: await spentToday(req, timeZone),
+                capUsd: dailyCapUsd(settings.dailySpendCapPercent, allowance)
+            });
+            // Only shares of the Vercel budget leave the server, never its dollar amounts.
+            const view = today.capUsd === undefined ? {} : {
+                today: {
+                    usedShare: today.spentUsd / today.capUsd
+                }
+            };
+            if (isAdminRole(req.user) && typeof allowance !== 'string') {
+                view.budget = budgetView(allowance);
+            }
+            return Response.json(view, {
+                headers: {
+                    'Cache-Control': 'private, no-store'
+                }
+            });
+        }
+    };
+}
+
+//# sourceMappingURL=usageEndpoint.js.map

package/dist/endpoints/usageEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/usageEndpoint.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport type { OwnKey } from '../billing.js'\nimport type {\n  AiAssistantPluginOptions,\n  AssistantSettings,\n  OwnKeyView,\n  UsageView,\n} from '../types.js'\n\nimport { sweepExpiredAttachments } from '../attachments/store.js'\nimport { activeBilling } from '../billing.js'\nimport { dayIn, spendCheck, spentToday, usageTotals } from '../chat/usage.js'\nimport { usageEndpointPath } from '../constants.js'\nimport { isAdminRole } from '../settings.js'\nimport { allowAssistant } from './access.js'\nimport { accountAllowance, budgetView, dailyCapUsd } from './allowance.js'\n\n/**\n * On Vercel billing: the editor's own spend today against the daily cap and, for admins, the project's remaining\n * budget, which is the whole project's, so editors do not see it. On the own key: which provider pays and, for\n * admins, everyone's spend on the key today and any calls that fell back to Vercel's credit.\n */\nexport function usageEndpoint(\n  fallback: AssistantSettings,\n  options: AiAssistantPluginOptions,\n  siteKey: OwnKey | undefined,\n) {\n  return {\n    path: usageEndpointPath,\n    method: 'get' as const,\n    handler: async (req: PayloadRequest) => {\n      const settings = await allowAssistant(req, fallback)\n      if (settings instanceof Response) {\n        return settings\n      }\n      // Opening the panel is a convenient, regular moment to clear expired attachments, a few at a time,\n      // so no scheduled job is needed. A failure here must not stop the panel loading.\n      await sweepExpiredAttachments(req).catch((error) =>\n        req.payload.logger.error({ err: error }, 'Humaan AI could not clear expired attachments'),\n      )\n\n      const timeZone = options.timeZone ?? 'UTC'\n      const billing = activeBilling(settings.billing, siteKey)\n      if (billing.billing === 'own-key') {\n        const ownKey: OwnKeyView = { provider: billing.key.label }\n        if (isAdminRole(req.user)) {\n          const day = dayIn(timeZone)\n          const totals = await usageTotals(req, day, day)\n          ownKey.todayUsd = totals.ownKeyUsd\n          ownKey.fallbackSteps = totals.fallbackSteps\n        }\n        const view: UsageView = { ownKey }\n        return Response.json(view, { headers: { 'Cache-Control': 'private, no-store' } })\n      }\n\n      const allowance = await accountAllowance(req)\n      const today = spendCheck({\n        spentUsd: await spentToday(req, timeZone),\n        capUsd: dailyCapUsd(settings.dailySpendCapPercent, allowance),\n      })\n      // Only shares of the Vercel budget leave the server, never its dollar amounts.\n      const view: UsageView =\n        today.capUsd === undefined ? {} : { today: { usedShare: today.spentUsd / today.capUsd } }\n      if (isAdminRole(req.user) && typeof allowance !== 'string') {\n        view.budget = budgetView(allowance)\n      }\n      return Response.json(view, { headers: { 'Cache-Control': 'private, no-store' } })\n    },\n  }\n}\n"],"names":["sweepExpiredAttachments","activeBilling","dayIn","spendCheck","spentToday","usageTotals","usageEndpointPath","isAdminRole","allowAssistant","accountAllowance","budgetView","dailyCapUsd","usageEndpoint","fallback","options","siteKey","path","method","handler","req","settings","Response","catch","error","payload","logger","err","timeZone","billing","ownKey","provider","key","label","user","day","totals","todayUsd","ownKeyUsd","fallbackSteps","view","json","headers","allowance","today","spentUsd","capUsd","dailySpendCapPercent","undefined","usedShare","budget"],"mappings":"AAUA,SAASA,uBAAuB,QAAQ,0BAAyB;AACjE,SAASC,aAAa,QAAQ,gBAAe;AAC7C,SAASC,KAAK,EAAEC,UAAU,EAAEC,UAAU,EAAEC,WAAW,QAAQ,mBAAkB;AAC7E,SAASC,iBAAiB,QAAQ,kBAAiB;AACnD,SAASC,WAAW,QAAQ,iBAAgB;AAC5C,SAASC,cAAc,QAAQ,cAAa;AAC5C,SAASC,gBAAgB,EAAEC,UAAU,EAAEC,WAAW,QAAQ,iBAAgB;AAE1E;;;;CAIC,GACD,OAAO,SAASC,cACdC,QAA2B,EAC3BC,OAAiC,EACjCC,OAA2B;IAE3B,OAAO;QACLC,MAAMV;QACNW,QAAQ;QACRC,SAAS,OAAOC;YACd,MAAMC,WAAW,MAAMZ,eAAeW,KAAKN;YAC3C,IAAIO,oBAAoBC,UAAU;gBAChC,OAAOD;YACT;YACA,mGAAmG;YACnG,iFAAiF;YACjF,MAAMpB,wBAAwBmB,KAAKG,KAAK,CAAC,CAACC,QACxCJ,IAAIK,OAAO,CAACC,MAAM,CAACF,KAAK,CAAC;oBAAEG,KAAKH;gBAAM,GAAG;YAG3C,MAAMI,WAAWb,QAAQa,QAAQ,IAAI;YACrC,MAAMC,UAAU3B,cAAcmB,SAASQ,OAAO,EAAEb;YAChD,IAAIa,QAAQA,OAAO,KAAK,WAAW;gBACjC,MAAMC,SAAqB;oBAAEC,UAAUF,QAAQG,GAAG,CAACC,KAAK;gBAAC;gBACzD,IAAIzB,YAAYY,IAAIc,IAAI,GAAG;oBACzB,MAAMC,MAAMhC,MAAMyB;oBAClB,MAAMQ,SAAS,MAAM9B,YAAYc,KAAKe,KAAKA;oBAC3CL,OAAOO,QAAQ,GAAGD,OAAOE,SAAS;oBAClCR,OAAOS,aAAa,GAAGH,OAAOG,aAAa;gBAC7C;gBACA,MAAMC,OAAkB;oBAAEV;gBAAO;gBACjC,OAAOR,SAASmB,IAAI,CAACD,MAAM;oBAAEE,SAAS;wBAAE,iBAAiB;oBAAoB;gBAAE;YACjF;YAEA,MAAMC,YAAY,MAAMjC,iBAAiBU;YACzC,MAAMwB,QAAQxC,WAAW;gBACvByC,UAAU,MAAMxC,WAAWe,KAAKQ;gBAChCkB,QAAQlC,YAAYS,SAAS0B,oBAAoB,EAAEJ;YACrD;YACA,+EAA+E;YAC/E,MAAMH,OACJI,MAAME,MAAM,KAAKE,YAAY,CAAC,IAAI;gBAAEJ,OAAO;oBAAEK,WAAWL,MAAMC,QAAQ,GAAGD,MAAME,MAAM;gBAAC;YAAE;YAC1F,IAAItC,YAAYY,IAAIc,IAAI,KAAK,OAAOS,cAAc,UAAU;gBAC1DH,KAAKU,MAAM,GAAGvC,WAAWgC;YAC3B;YACA,OAAOrB,SAASmB,IAAI,CAACD,MAAM;gBAAEE,SAAS;oBAAE,iBAAiB;gBAAoB;YAAE;QACjF;IACF;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { aiAssistantAttachmentsCollection } from './attachments/collection.js';
+export { aiAssistantAttachmentSlug } from './constants.js';
+export { aiAssistantPlugin } from './plugin.js';
+export type { AiAssistantPluginOptions, AssistantChange, AssistantPlanView, AssistantSettings, } from './types.js';

package/dist/index.js

@@ -0,0 +1,5 @@
+export { aiAssistantAttachmentsCollection } from './attachments/collection.js';
+export { aiAssistantAttachmentSlug } from './constants.js';
+export { aiAssistantPlugin } from './plugin.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { aiAssistantAttachmentsCollection } from './attachments/collection.js'\nexport { aiAssistantAttachmentSlug } from './constants.js'\nexport { aiAssistantPlugin } from './plugin.js'\nexport type {\n  AiAssistantPluginOptions,\n  AssistantChange,\n  AssistantPlanView,\n  AssistantSettings,\n} from './types.js'\n"],"names":["aiAssistantAttachmentsCollection","aiAssistantAttachmentSlug","aiAssistantPlugin"],"mappings":"AAAA,SAASA,gCAAgC,QAAQ,8BAA6B;AAC9E,SAASC,yBAAyB,QAAQ,iBAAgB;AAC1D,SAASC,iBAAiB,QAAQ,cAAa"}

package/dist/lexical/editorConfig.d.ts

@@ -0,0 +1,4 @@
+import type { SanitizedServerEditorConfig } from '@payloadcms/richtext-lexical';
+import type { RichTextField, SanitizedConfig } from 'payload';
+/** The sanitized lexical editor config for a rich text field. Cached per field. */
+export declare function editorConfigFor(config: SanitizedConfig, field: RichTextField): Promise<SanitizedServerEditorConfig>;

package/dist/lexical/editorConfig.js

@@ -0,0 +1,19 @@
+import { editorConfigFactory } from '@payloadcms/richtext-lexical';
+const cache = new WeakMap();
+/** The sanitized lexical editor config for a rich text field. Cached per field. */ export function editorConfigFor(config, field) {
+    const cached = cache.get(field);
+    if (cached) {
+        return cached;
+    }
+    const editor = field.editor;
+    const next = typeof editor === 'object' && editor !== null && 'editorConfig' in editor ? Promise.resolve(editorConfigFactory.fromField({
+        field: field
+    })) : editorConfigFactory.fromUnsanitizedField({
+        config,
+        field: field
+    });
+    cache.set(field, next);
+    return next;
+}
+
+//# sourceMappingURL=editorConfig.js.map

package/dist/lexical/editorConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lexical/editorConfig.ts"],"sourcesContent":["import type { SanitizedServerEditorConfig } from '@payloadcms/richtext-lexical'\nimport type { RichTextField, SanitizedConfig } from 'payload'\n\nimport { editorConfigFactory } from '@payloadcms/richtext-lexical'\n\nconst cache = new WeakMap<RichTextField, Promise<SanitizedServerEditorConfig>>()\n\n/** The sanitized lexical editor config for a rich text field. Cached per field. */\nexport function editorConfigFor(\n  config: SanitizedConfig,\n  field: RichTextField,\n): Promise<SanitizedServerEditorConfig> {\n  const cached = cache.get(field)\n  if (cached) {\n    return cached\n  }\n\n  const editor = field.editor\n  const next =\n    typeof editor === 'object' && editor !== null && 'editorConfig' in editor\n      ? Promise.resolve(\n          editorConfigFactory.fromField({\n            field: field as { editor: { editorConfig: never } } & RichTextField,\n          }),\n        )\n      : editorConfigFactory.fromUnsanitizedField({\n          config,\n          field: field as { editor: NonNullable<RichTextField['editor']> } & RichTextField,\n        })\n  cache.set(field, next)\n  return next\n}\n"],"names":["editorConfigFactory","cache","WeakMap","editorConfigFor","config","field","cached","get","editor","next","Promise","resolve","fromField","fromUnsanitizedField","set"],"mappings":"AAGA,SAASA,mBAAmB,QAAQ,+BAA8B;AAElE,MAAMC,QAAQ,IAAIC;AAElB,iFAAiF,GACjF,OAAO,SAASC,gBACdC,MAAuB,EACvBC,KAAoB;IAEpB,MAAMC,SAASL,MAAMM,GAAG,CAACF;IACzB,IAAIC,QAAQ;QACV,OAAOA;IACT;IAEA,MAAME,SAASH,MAAMG,MAAM;IAC3B,MAAMC,OACJ,OAAOD,WAAW,YAAYA,WAAW,QAAQ,kBAAkBA,SAC/DE,QAAQC,OAAO,CACbX,oBAAoBY,SAAS,CAAC;QAC5BP,OAAOA;IACT,MAEFL,oBAAoBa,oBAAoB,CAAC;QACvCT;QACAC,OAAOA;IACT;IACNJ,MAAMa,GAAG,CAACT,OAAOI;IACjB,OAAOA;AACT"}

package/dist/lexical/lexicalToMarkdown.d.ts

@@ -0,0 +1,10 @@
+import type { RichTextField, SanitizedConfig } from 'payload';
+import { convertLexicalToMarkdown } from '@payloadcms/richtext-lexical';
+type LexicalState = Parameters<typeof convertLexicalToMarkdown>[0]['data'];
+/** Turns stored lexical JSON back into markdown, so the assistant reads the words rather than the node tree. */
+export declare function lexicalToMarkdown({ config, field, data, }: {
+    config: SanitizedConfig;
+    data: LexicalState;
+    field: RichTextField;
+}): Promise<string>;
+export {};