@agent-native/toolkit 0.13.1 → 0.13.3

package/src/composer/PromptComposer.tsx

@@ -84,6 +84,10 @@ export interface PromptComposerProps {
   ) => void;
   placeholder?: string;
   disabled?: boolean;
+  /** Override the generic document attachment cap for a multipart host. */
+  maxDocumentAttachmentBytes?: number;
+  /** Label used in the visible document attachment limit error. */
+  documentAttachmentLimitLabel?: string;
   autoFocus?: boolean;
   className?: string;
   style?: CSSProperties;
@@ -458,6 +462,8 @@ function PromptComposerInner({
   onSubmit,
   placeholder,
   disabled,
+  maxDocumentAttachmentBytes,
+  documentAttachmentLimitLabel,
   autoFocus,
   className,
   style,
@@ -629,6 +635,8 @@ function PromptComposerInner({
         <TiptapComposer
           focusRef={handleRef}
           disabled={disabled || gateComposer}
+          maxDocumentAttachmentBytes={maxDocumentAttachmentBytes}
+          documentAttachmentLimitLabel={documentAttachmentLimitLabel}
           placeholder={
             gateComposer ? "Connect AI above to continue..." : placeholder
           }

package/src/composer/TiptapComposer.spec.ts

@@ -11,6 +11,7 @@ import {
   composerModelCostTier,
   createTiptapComposerExtensions,
   displayableComposerModeMessage,
+  getComposerSendTooltipKey,
   getComposerSubmitIntentForEnterKey,
   getComposerPopoverPosition,
   getComposerReasoningEffortOptions,
@@ -137,6 +138,11 @@ describe("createTiptapComposerExtensions", () => {
     ).toBe("send");
   });
 
+  it("uses the queue tooltip when the submit will wait", () => {
+    expect(getComposerSendTooltipKey(true)).toBe("composer.queueMessage");
+    expect(getComposerSendTooltipKey(false)).toBe("composer.sendMessage");
+  });
+
   it("selects and removes context chips one Backspace at a time", () => {
     let contextItemKeys = ["dashboard", "panel"];
     let selectedKey: string | null = null;
@@ -209,7 +215,7 @@ describe("createTiptapComposerExtensions", () => {
           file,
         },
       ]),
-    ).toContain('"large.pdf" is 4.0 MB — PDFs are capped at 4 MB');
+    ).toContain('"large.pdf" is 4.0 MB. PDFs are capped at 4 MB');
     expect(
       getOversizedDocumentAttachmentError([
         {
@@ -222,6 +228,31 @@ describe("createTiptapComposerExtensions", () => {
     ).toBeNull();
   });
 
+  it("allows hosts to use a larger multipart document cap", () => {
+    const file = new File(
+      [new Uint8Array(4 * 1024 * 1024 + 1)],
+      "reference.pdf",
+      { type: "application/pdf" },
+    );
+
+    expect(
+      getOversizedDocumentAttachmentError(
+        [
+          {
+            type: "document",
+            name: "reference.pdf",
+            contentType: "application/pdf",
+            file,
+          },
+        ],
+        {
+          maxBytes: 50 * 1024 * 1024,
+          label: "Slides reference files",
+        },
+      ),
+    ).toBeNull();
+  });
+
   it("maps Enter keybindings to immediate and queued submit intents", () => {
     const enter = {
       key: "Enter",

package/src/composer/TiptapComposer.tsx

@@ -123,6 +123,12 @@ export function resolveComposerPrimaryAction(options: {
   return !options.canSubmit && options.hasStopButton ? "stop" : "send";
 }
 
+export function getComposerSendTooltipKey(
+  willQueue: boolean,
+): "composer.queueMessage" | "composer.sendMessage" {
+  return willQueue ? "composer.queueMessage" : "composer.sendMessage";
+}
+
 export type ContextChipBackspaceAction =
   | { type: "select"; key: string }
   | { type: "remove"; key: string }
@@ -280,21 +286,27 @@ function isDocumentAttachment(value: Record<string, unknown>): boolean {
 
 export function getOversizedDocumentAttachmentError(
   attachments: ReadonlyArray<unknown>,
+  options: {
+    maxBytes?: number;
+    label?: string;
+  } = {},
 ): string | null {
+  const maxBytes = options.maxBytes ?? MAX_DOCUMENT_ATTACHMENT_BYTES;
+  const label = options.label ?? "PDFs";
   for (const attachment of attachments) {
     if (!attachment || typeof attachment !== "object") continue;
     const candidate = attachment as Record<string, unknown>;
     if (!isDocumentAttachment(candidate)) continue;
     const file = candidate.file;
     if (!(file instanceof File)) continue;
-    if (file.size <= MAX_DOCUMENT_ATTACHMENT_BYTES) continue;
+    if (file.size <= maxBytes) continue;
     const name =
       typeof candidate.name === "string" && candidate.name.trim()
         ? candidate.name
         : file.name;
     const mb = (file.size / 1024 / 1024).toFixed(1);
-    const maxMb = (MAX_DOCUMENT_ATTACHMENT_BYTES / 1024 / 1024).toFixed(0);
-    return `"${name}" is ${mb} MB — PDFs are capped at ${maxMb} MB to stay within message limits. Please reduce the file size or split it into smaller parts.`;
+    const maxMb = (maxBytes / 1024 / 1024).toFixed(0);
+    return `"${name}" is ${mb} MB. ${label} are capped at ${maxMb} MB to stay within message limits. Please reduce the file size or split it into smaller parts.`;
   }
   return null;
 }
@@ -549,6 +561,10 @@ type ExecMode = "build" | "plan";
 export interface TiptapComposerProps {
   placeholder?: string;
   disabled?: boolean;
+  /** Override the generic document attachment cap for a multipart host. */
+  maxDocumentAttachmentBytes?: number;
+  /** Label used in the visible document attachment limit error. */
+  documentAttachmentLimitLabel?: string;
   focusRef?: React.Ref<TiptapComposerHandle>;
   /** Programmatically seed the editor with plain text. */
   initialText?: string;
@@ -576,6 +592,8 @@ export interface TiptapComposerProps {
   onTextChange?: (text: string) => void;
   /** Custom action button (e.g. stop button) to render instead of the default send button. */
   actionButton?: React.ReactNode;
+  /** Whether the default send action will wait behind existing work. */
+  willQueue?: boolean;
   /** Extra button to render alongside the primary action. */
   extraActionButton?: React.ReactNode;
   /**
@@ -1494,6 +1512,8 @@ type PopoverState = {
 export function TiptapComposer({
   placeholder = "Message agent...",
   disabled = false,
+  maxDocumentAttachmentBytes = MAX_DOCUMENT_ATTACHMENT_BYTES,
+  documentAttachmentLimitLabel = "PDFs",
   focusRef,
   initialText,
   initialTextKey,
@@ -1502,6 +1522,7 @@ export function TiptapComposer({
   clearOnSubmit = true,
   onTextChange,
   actionButton,
+  willQueue = false,
   extraActionButton,
   stopButton,
   attachButton,
@@ -1538,6 +1559,9 @@ export function TiptapComposer({
 }: TiptapComposerProps) {
   const adapters = useComposerRuntimeAdapters();
   const t = adapters.translate!;
+  const sendButtonTooltip = t(getComposerSendTooltipKey(willQueue), {
+    defaultValue: willQueue ? "Queue message" : "Send message",
+  });
   const [popover, setPopover] = useState<PopoverState>(null);
   const popoverRef = useRef<MentionPopoverRef>(null);
   const composerRuntime = useComposerRuntime();
@@ -2498,8 +2522,13 @@ export function TiptapComposer({
       const attachments = composerRuntime.getState().attachments;
       if (!text.trim() && references.length === 0 && attachments.length === 0)
         return;
-      const oversizedDocumentError =
-        getOversizedDocumentAttachmentError(attachments);
+      const oversizedDocumentError = getOversizedDocumentAttachmentError(
+        attachments,
+        {
+          maxBytes: maxDocumentAttachmentBytes,
+          label: documentAttachmentLimitLabel,
+        },
+      );
       if (oversizedDocumentError) {
         onAttachmentErrorRef.current?.(oversizedDocumentError);
         return;
@@ -2995,7 +3024,7 @@ export function TiptapComposer({
                     <IconArrowUp className="h-3.5 w-3.5" />
                   </button>
                 </TooltipTrigger>
-                <TooltipContent>Send message</TooltipContent>
+                <TooltipContent>{sendButtonTooltip}</TooltipContent>
               </Tooltip>
             )}
           </>