@parhelia/core 0.3.12832 → 0.3.12833

package/dist/editor/reviews/CommentThreadAgentLink.d.ts

@@ -0,0 +1,28 @@
+import { Comment as CommentType } from "../../types";
+export declare const COMMENT_THREAD_AGENT_LINK_LABEL = "Resolve with agent";
+/**
+ * Put this class on the element whose hover reveals the link (the thread card
+ * or the popover body). Touch devices get the link permanently.
+ */
+export declare const COMMENT_THREAD_HOVER_GROUP_CLASS = "group/comment-thread";
+type CommentThreadAgentLinkProps = {
+    rootComment: CommentType;
+    /** Every comment of the thread; order does not matter. */
+    threadComments: readonly CommentType[];
+    resolvedAuthorNames?: Record<string, string>;
+    className?: string;
+    /**
+     * Shares a single line with other actions (margin balloon): never wraps;
+     * the label truncates before it would push the line apart.
+     */
+    compact?: boolean;
+    onStarted?: () => void;
+};
+/**
+ * Link rendered at the end of a comment conversation that starts an agent
+ * seeded with the complete thread. Renders nothing when agents are not
+ * available or the thread cannot be worked on (resolved, read-only, unsaved).
+ * Hidden until the surrounding thread is hovered or the link has focus.
+ */
+export declare function CommentThreadAgentLink({ rootComment, threadComments, resolvedAuthorNames, className, compact, onStarted, }: CommentThreadAgentLinkProps): import("react").JSX.Element | null;
+export {};

package/dist/editor/reviews/CommentThreadAgentLink.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Sparkles } from "lucide-react";
+import { useEditContext } from "../client/editContext";
+import { LicenseFeatures, useFeature } from "../../licensing";
+import { hasAgentsPanel } from "../validation/validationFixAgent";
+import { openAiAgentForCommentThread } from "./commentAi";
+import { cn } from "../../lib/utils";
+export const COMMENT_THREAD_AGENT_LINK_LABEL = "Resolve with agent";
+/**
+ * Put this class on the element whose hover reveals the link (the thread card
+ * or the popover body). Touch devices get the link permanently.
+ */
+export const COMMENT_THREAD_HOVER_GROUP_CLASS = "group/comment-thread";
+/**
+ * Link rendered at the end of a comment conversation that starts an agent
+ * seeded with the complete thread. Renders nothing when agents are not
+ * available or the thread cannot be worked on (resolved, read-only, unsaved).
+ * Hidden until the surrounding thread is hovered or the link has focus.
+ */
+export function CommentThreadAgentLink({ rootComment, threadComments, resolvedAuthorNames, className, compact = false, onStarted, }) {
+    const editContext = useEditContext();
+    const canUseAi = useFeature(LicenseFeatures.AI);
+    if (!canUseAi ||
+        !hasAgentsPanel(editContext) ||
+        rootComment.isNew ||
+        rootComment.isResolved ||
+        editContext?.readonly) {
+        return null;
+    }
+    return (_jsx("div", { className: cn("flex", compact && "min-w-0", className), children: _jsxs("button", { type: "button", className: cn("text-neutral-grey-50 hover:text-neutral-grey-100 inline-flex items-start text-left text-xs leading-4 underline-offset-2 transition-opacity hover:underline focus-visible:opacity-100", compact ? "max-w-full min-w-0 gap-1" : "gap-1.5", !editContext?.isMobile &&
+                "opacity-0 group-hover/comment-thread:opacity-100"), title: compact ? COMMENT_THREAD_AGENT_LINK_LABEL : undefined, "data-testid": "comment-thread-start-agent", onClick: (event) => {
+                event.stopPropagation();
+                openAiAgentForCommentThread(rootComment, threadComments, editContext, resolvedAuthorNames);
+                onStarted?.();
+            }, children: [_jsx(Sparkles, { className: "mt-px h-3.5 w-3.5 shrink-0", strokeWidth: 1 }), compact ? (_jsx("span", { className: "truncate", children: COMMENT_THREAD_AGENT_LINK_LABEL })) : (COMMENT_THREAD_AGENT_LINK_LABEL)] }) }));
+}
+//# sourceMappingURL=CommentThreadAgentLink.js.map

package/dist/editor/reviews/CommentThreadAgentLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentThreadAgentLink.js","sourceRoot":"","sources":["../../../src/editor/reviews/CommentThreadAgentLink.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAErC,MAAM,CAAC,MAAM,+BAA+B,GAAG,oBAAoB,CAAC;AAEpE;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,sBAAsB,CAAC;AAgBvE;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,OAAO,GAAG,KAAK,EACf,SAAS,GACmB;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAEhD,IACE,CAAC,QAAQ;QACT,CAAC,cAAc,CAAC,WAAW,CAAC;QAC5B,WAAW,CAAC,KAAK;QACjB,WAAW,CAAC,UAAU;QACtB,WAAW,EAAE,QAAQ,EACrB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,cAAK,SAAS,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,IAAI,SAAS,EAAE,SAAS,CAAC,YACzD,kBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,EAAE,CACX,sLAAsL,EACtL,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,SAAS,EAChD,CAAC,WAAW,EAAE,QAAQ;gBACpB,kDAAkD,CACrD,EACD,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,SAAS,iBAChD,4BAA4B,EACxC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjB,KAAK,CAAC,eAAe,EAAE,CAAC;gBACxB,2BAA2B,CACzB,WAAW,EACX,cAAc,EACd,WAAW,EACX,mBAAmB,CACpB,CAAC;gBACF,SAAS,EAAE,EAAE,CAAC;YAChB,CAAC,aAED,KAAC,QAAQ,IAAC,SAAS,EAAC,4BAA4B,EAAC,WAAW,EAAE,CAAC,GAAI,EAClE,OAAO,CAAC,CAAC,CAAC,CACT,eAAM,SAAS,EAAC,UAAU,YAAE,+BAA+B,GAAQ,CACpE,CAAC,CAAC,CAAC,CACF,+BAA+B,CAChC,IACM,GACL,CACP,CAAC;AACJ,CAAC"}

package/dist/editor/reviews/CommentThreadCard.d.ts

@@ -0,0 +1,34 @@
+import { type Ref } from "react";
+import type { FeedbackNavigation } from "./CommentQuote";
+import type { CommentThread } from "./feedbackThreads";
+import type { FeedbackItem } from "./feedbackOrdering";
+export type CommentThreadCardProps = {
+    thread: CommentThread;
+    availableTags: {
+        label: string;
+        color: string;
+    }[];
+    getAuthorName: (item: FeedbackItem) => string;
+    resolvedAuthorNames: Record<string, string>;
+    selected: boolean;
+    navigation?: FeedbackNavigation;
+    className?: string;
+    /** Bounds the thread body (which then scrolls) so one long thread never
+     * exceeds the page beside it. */
+    bodyMaxHeight?: number;
+    /**
+     * Word-style margin balloon: flat frame without the context header, small
+     * type, replies collapsed and the reply composer opened on demand.
+     */
+    balloon?: boolean;
+    /** Name what the thread is about (a balloon that is not beside it). */
+    showContext?: boolean;
+    onHoverChange?: (hovered: boolean) => void;
+    cardRef?: Ref<HTMLDivElement>;
+};
+/**
+ * One comment thread: the root comment, its replies (collapsible), the agent
+ * link and the reply composer. Reply target, reply text and collapse state
+ * live in the thread's draft so the card can be re-homed without losing them.
+ */
+export declare function CommentThreadCard({ thread, availableTags, getAuthorName, resolvedAuthorNames, selected, navigation, className, bodyMaxHeight, balloon, showContext, onHoverChange, cardRef, }: CommentThreadCardProps): import("react").JSX.Element;

package/dist/editor/reviews/CommentThreadCard.js

@@ -0,0 +1,156 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { ChevronDown, ChevronRight, Reply } from "lucide-react";
+import uuid from "react-uuid";
+import { toast } from "sonner";
+import { useEditContext, useFieldsEditContext } from "../client/editContext";
+import { CloseButton } from "../../components/ui/close-button";
+import { cn } from "../../lib/utils";
+import { createOrUpdateComment } from "../services/reviewsService";
+import { Comment as CommentComponent } from "./Comment";
+import { CommentEditor, COMMENT_INPUT_PLACEHOLDER } from "./CommentEditor";
+import { COMMENT_THREAD_HOVER_GROUP_CLASS, CommentThreadAgentLink, } from "./CommentThreadAgentLink";
+import { FeedbackCardFrame, getCommentContextSegments } from "./FeedbackCard";
+import { canReplyToComment } from "./feedbackCommentRules";
+import { useFeedbackDraft } from "./feedbackDrafts";
+import { isTextSelectionClick, selectFeedbackComment, } from "./feedbackSelection";
+import { activateCommentsMode } from "./openCommentsFeedback";
+function buildReplyFrom(base, text, quoteParent, context) {
+    return {
+        id: uuid(),
+        isNew: false,
+        parentCommentId: base.id,
+        quoteParentComment: quoteParent,
+        itemId: base.itemId,
+        itemName: base.itemName,
+        fieldId: base.fieldId,
+        fieldName: base.fieldName,
+        mainItemId: base.mainItemId,
+        language: base.language || context.language,
+        version: base.version || context.version,
+        position: 0,
+        rangeStart: base.rangeStart,
+        rangeEnd: base.rangeEnd,
+        author: context.author,
+        authorDisplayName: context.authorDisplayName,
+        created: new Date().toISOString(),
+        text,
+        tags: "",
+        fieldValue: base.fieldValue,
+    };
+}
+/**
+ * One comment thread: the root comment, its replies (collapsible), the agent
+ * link and the reply composer. Reply target, reply text and collapse state
+ * live in the thread's draft so the card can be re-homed without losing them.
+ */
+export function CommentThreadCard({ thread, availableTags, getAuthorName, resolvedAuthorNames, selected, navigation = "dom", className, bodyMaxHeight, balloon = false, showContext = false, onHoverChange, cardRef, }) {
+    const editContext = useEditContext();
+    const fieldsContext = useFieldsEditContext();
+    const { root, replies } = thread;
+    const [draft, updateDraft, clearDraft] = useFeedbackDraft(thread.id);
+    const [isSavingReply, setIsSavingReply] = useState(false);
+    // Balloons keep replies folded until asked; the list shows them.
+    const isCollapsed = draft.collapsed ?? balloon;
+    const replyTarget = draft.replyTargetCommentId
+        ? [root, ...replies].find((comment) => comment.id === draft.replyTargetCommentId)
+        : undefined;
+    // Closing the composer discards its draft: the editor has already revoked
+    // its pasted images, which must not come back in the next composer.
+    const setReplyTarget = (target) => updateDraft(target
+        ? { replyTargetCommentId: target.id, collapsed: false }
+        : {
+            replyTargetCommentId: undefined,
+            replyText: undefined,
+            replyAttachments: undefined,
+        });
+    // A card can unmount under the pointer (deleted, resolved, re-homed by the
+    // margin) without a mouseleave; do not leave its hover behind.
+    const onHoverChangeRef = useRef(onHoverChange);
+    onHoverChangeRef.current = onHoverChange;
+    useEffect(() => () => onHoverChangeRef.current?.(false), []);
+    const contextSegments = getCommentContextSegments(root, editContext?.currentItemDescriptor?.name);
+    const cancelNewComment = (event) => {
+        event.stopPropagation();
+        if (!root.isNew)
+            return;
+        editContext?.setComments?.((comments) => comments.filter((comment) => comment.id !== root.id));
+        if (editContext?.selectedComment?.id === root.id) {
+            editContext.setSelectedComment(undefined);
+        }
+        // Every draft comment has a fresh id; nothing would ever reuse this entry.
+        clearDraft();
+    };
+    const handleReplySave = async (target, text) => {
+        if (!editContext?.currentItemDescriptor)
+            return;
+        activateCommentsMode(editContext, { reason: "comment-reply" });
+        const descriptor = editContext.currentItemDescriptor;
+        // A balloon opens its composer by targeting the root; that is a plain
+        // reply to the thread, not a quote of it.
+        const quotesTarget = replyTarget?.id === target.id && !(balloon && target.id === root.id);
+        const newReply = buildReplyFrom(target, text, quotesTarget, {
+            language: descriptor.language,
+            version: descriptor.version,
+            author: editContext.user?.name,
+            authorDisplayName: editContext.user?.fullName,
+        });
+        setIsSavingReply(true);
+        try {
+            const result = await createOrUpdateComment(newReply);
+            if (result.type === "error" || result.type === "unauthorized") {
+                console.error("Failed to save reply comment:", result);
+                toast.error(result.details || result.summary || "Failed to save reply comment");
+                return;
+            }
+            updateDraft({
+                replyTargetCommentId: undefined,
+                replyText: undefined,
+                replyAttachments: undefined,
+            });
+            await editContext.loadComments?.();
+        }
+        catch (error) {
+            console.error("Failed to save reply comment:", error);
+            toast.error(error instanceof Error ? error.message : "Failed to save reply comment");
+        }
+        finally {
+            setIsSavingReply(false);
+        }
+    };
+    const canReplyToRoot = !!editContext && canReplyToComment(root, root, editContext.readonly);
+    const renderReplyEditor = () => {
+        if (!editContext)
+            return null;
+        // The list always offers the composer; a balloon only after "Reply".
+        if (balloon && !replyTarget)
+            return null;
+        const target = replyTarget ?? root;
+        if (!canReplyToComment(target, root, editContext.readonly)) {
+            return null;
+        }
+        return (_jsxs("div", { className: balloon ? "mt-2 pl-7" : "mt-3 pt-3", onClick: (event) => event.stopPropagation(), children: [replyTarget && (!balloon || replyTarget.id !== root.id) && (_jsxs("div", { className: "text-neutral-grey-50 mb-2 flex items-center justify-between gap-2 text-xs", children: [_jsxs("span", { className: "truncate", children: ["Replying to ", getAuthorName(replyTarget)] }), _jsx("button", { type: "button", className: "badge-pad-sm text-neutral-grey-50 hover:bg-neutral-grey-5 shrink-0 rounded", onClick: () => setReplyTarget(undefined), children: "Cancel" })] })), _jsx(CommentEditor, { onSave: (text) => handleReplySave(target, text), onCancel: () => setReplyTarget(undefined), isSaving: isSavingReply, placeholder: balloon ? "Reply or @mention" : COMMENT_INPUT_PLACEHOLDER, submitLabel: "Reply", showTagSelector: false, showCancelButton: balloon, balloon: balloon, clearOnSave: true, compact: true, autoFocus: !!replyTarget, value: draft.replyText, onValueChange: (replyText) => updateDraft({ replyText }), attachments: draft.replyAttachments, onAttachmentsChange: (replyAttachments) => updateDraft({ replyAttachments }) }, target.id)] }));
+    };
+    const repliesLabel = `${replies.length} ${replies.length === 1 ? "reply" : "replies"}`;
+    const agentLink = (_jsx(CommentThreadAgentLink, { rootComment: root, threadComments: [root, ...replies], resolvedAuthorNames: resolvedAuthorNames, className: balloon ? "ml-auto" : "mt-1", compact: balloon }));
+    return (_jsx("div", { ref: cardRef, "data-feedback-thread-id": thread.id, onMouseEnter: onHoverChange ? () => onHoverChange(true) : undefined, onMouseLeave: onHoverChange ? () => onHoverChange(false) : undefined, children: _jsxs(FeedbackCardFrame, { variant: balloon ? "balloon" : "card", contextSegments: contextSegments, showBalloonContext: showContext, selected: selected, className: cn("cursor-pointer", COMMENT_THREAD_HOVER_GROUP_CLASS, className), bodyClassName: bodyMaxHeight ? "overflow-auto" : undefined, bodyStyle: bodyMaxHeight ? { maxHeight: bodyMaxHeight } : undefined, bodyScrollable: !!bodyMaxHeight, testId: "comment-thread", headerAction: 
+            // The list's frame header holds the draft's close button; a balloon
+            // has no header, its input carries the cancel button instead.
+            root.isNew && !balloon ? (_jsx(CloseButton, { onClick: cancelNewComment, "data-testid": "add-comment-cancel", label: "Cancel" })) : undefined, onClick: (event) => {
+                // A mouse release that ends a text drag-selection also clicks; keep
+                // the selection instead of jumping.
+                if (isTextSelectionClick(event.currentTarget, event))
+                    return;
+                void selectFeedbackComment(root, editContext, fieldsContext);
+            }, children: [_jsx(CommentComponent, { comment: root, availableTags: availableTags, rootCommentId: root.id, resolvedAuthorName: getAuthorName(root), variant: "inline", showContextHeader: false, showEditorCancelButton: !root.isNew, navigation: navigation, balloon: balloon, onReply: (target) => setReplyTarget(target) }), (replies.length > 0 || (balloon && canReplyToRoot && !root.isNew)) && (_jsxs("div", { className: cn("text-neutral-grey-50 flex items-center", 
+                    // One line, always: a wrapped (hover-only) agent link would
+                    // reserve an empty line in every balloon.
+                    balloon ? "mt-1 gap-2 pl-7 whitespace-nowrap" : "mb-3 gap-3"), children: [replies.length > 0 && (_jsxs("button", { type: "button", "data-testid": "comment-thread-replies-toggle", "aria-expanded": !isCollapsed, className: cn("hover:text-neutral-grey-100 flex items-center gap-1 text-left", !balloon && "text-neutral-grey-100 text-sm"), onClick: (event) => {
+                                event.stopPropagation();
+                                updateDraft({ collapsed: !isCollapsed });
+                            }, children: [isCollapsed ? (_jsx(ChevronRight, { size: 12, strokeWidth: 1.5 })) : (_jsx(ChevronDown, { size: 12, strokeWidth: 1.5 })), repliesLabel] })), balloon && canReplyToRoot && !root.isNew && !replyTarget && (_jsxs("button", { type: "button", "data-testid": "comment-reply-button", className: "hover:text-neutral-grey-100 flex items-center gap-1", onClick: (event) => {
+                                event.stopPropagation();
+                                setReplyTarget(root);
+                            }, children: [_jsx(Reply, { size: 12, strokeWidth: 1.5 }), "Reply"] })), balloon && agentLink] })), replies.length > 0 && !isCollapsed && (_jsx("div", { className: cn(balloon && "border-border-default mt-1.5 ml-2.5 border-l pl-3"), children: replies.map((reply) => (_jsx(CommentComponent, { comment: reply, availableTags: availableTags, rootCommentId: root.id, resolvedAuthorName: getAuthorName(reply), variant: "inline", showContextHeader: false, navigation: navigation, balloon: balloon, onReply: (target) => setReplyTarget(target) }, reply.id))) })), !balloon && agentLink, renderReplyEditor()] }) }));
+}
+//# sourceMappingURL=CommentThreadCard.js.map

package/dist/editor/reviews/CommentThreadCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentThreadCard.js","sourceRoot":"","sources":["../../../src/editor/reviews/CommentThreadCard.tsx"],"names":[],"mappings":"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"}

package/dist/editor/reviews/SuggestionThreadCard.d.ts

@@ -0,0 +1,19 @@
+import { type Ref } from "react";
+import type { FeedbackNavigation } from "./CommentQuote";
+import type { FeedbackItem } from "./feedbackOrdering";
+import type { SuggestionThread } from "./feedbackThreads";
+export type SuggestionThreadCardProps = {
+    thread: SuggestionThread;
+    getAuthorName: (item: FeedbackItem) => string;
+    resolvedAuthorNames: Record<string, string>;
+    navigation?: FeedbackNavigation;
+    bodyMaxHeight?: number;
+    /** Word-style margin balloon; the comment thread is folded until asked. */
+    balloon?: boolean;
+    /** Name what the suggestion is about (a balloon that is not beside it). */
+    showContext?: boolean;
+    onHoverChange?: (hovered: boolean) => void;
+    cardRef?: Ref<HTMLDivElement>;
+};
+/** One suggested edit with its comment thread. */
+export declare function SuggestionThreadCard({ thread, getAuthorName, resolvedAuthorNames, navigation, bodyMaxHeight, balloon, showContext, onHoverChange, cardRef, }: SuggestionThreadCardProps): import("react").JSX.Element;

package/dist/editor/reviews/SuggestionThreadCard.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { ChevronDown, ChevronRight, Reply } from "lucide-react";
+import { useEditContext } from "../client/editContext";
+import { cn } from "../../lib/utils";
+import { useFeedbackDraft } from "./feedbackDrafts";
+import { SuggestedEditComponent } from "./SuggestedEdit";
+import { SuggestionCommentThread } from "./SuggestionCommentThread";
+/** One suggested edit with its comment thread. */
+export function SuggestionThreadCard({ thread, getAuthorName, resolvedAuthorNames, navigation = "dom", bodyMaxHeight, balloon = false, showContext = false, onHoverChange, cardRef, }) {
+    const editContext = useEditContext();
+    const { suggestion, comments } = thread;
+    const [draft, updateDraft] = useFeedbackDraft(thread.id);
+    const canComment = !editContext?.readonly;
+    const showThread = !editContext?.readonly || comments.length > 0;
+    // Balloons fold the comment thread (and its composer) until asked.
+    const expanded = balloon ? draft.collapsed === false : true;
+    const commentsLabel = `${comments.length} ${comments.length === 1 ? "comment" : "comments"}`;
+    // See CommentThreadCard: an unmount under the pointer sends no mouseleave.
+    const onHoverChangeRef = useRef(onHoverChange);
+    onHoverChangeRef.current = onHoverChange;
+    useEffect(() => () => onHoverChangeRef.current?.(false), []);
+    return (_jsx("div", { ref: cardRef, "data-testid": "suggestion-thread", "data-feedback-thread-id": thread.id, "data-suggestion-id": suggestion.id, onMouseEnter: onHoverChange ? () => onHoverChange(true) : undefined, onMouseLeave: onHoverChange ? () => onHoverChange(false) : undefined, children: _jsxs(SuggestedEditComponent, { edit: suggestion, resolvedAuthorName: getAuthorName(suggestion), navigation: navigation, bodyMaxHeight: bodyMaxHeight, balloon: balloon, showContext: showContext, children: [balloon && showThread && (_jsxs("div", { className: "text-neutral-grey-50 mt-1.5 flex items-center gap-3 pl-7", onClick: (event) => event.stopPropagation(), children: [comments.length > 0 && (_jsxs("button", { type: "button", "data-testid": "suggestion-thread-comments-toggle", "aria-expanded": expanded, className: "hover:text-neutral-grey-100 flex items-center gap-1 text-left", onClick: () => updateDraft({ collapsed: expanded }), children: [expanded ? (_jsx(ChevronDown, { size: 12, strokeWidth: 1.5 })) : (_jsx(ChevronRight, { size: 12, strokeWidth: 1.5 })), commentsLabel] })), canComment && !expanded && (_jsxs("button", { type: "button", "data-testid": "suggestion-reply-button", className: "hover:text-neutral-grey-100 flex items-center gap-1", onClick: () => updateDraft({ collapsed: false }), children: [_jsx(Reply, { size: 12, strokeWidth: 1.5 }), "Reply"] }))] })), showThread && expanded && (_jsx("div", { className: cn(balloon && "mt-1.5 pl-7"), children: _jsx(SuggestionCommentThread, { suggestion: suggestion, comments: comments, resolvedAuthorNames: resolvedAuthorNames, compact: true, navigation: navigation, balloon: balloon }) }))] }) }));
+}
+//# sourceMappingURL=SuggestionThreadCard.js.map

package/dist/editor/reviews/SuggestionThreadCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuggestionThreadCard.js","sourceRoot":"","sources":["../../../src/editor/reviews/SuggestionThreadCard.tsx"],"names":[],"mappings":"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"}

package/dist/editor/reviews/addCommentOnTarget.d.ts

@@ -0,0 +1,22 @@
+import type { AddCommentOptions, EditContextType, SelectionRange } from "../client/editContext";
+/**
+ * "Add comment" on a known target (a field's comment button, the formatting
+ * toolbar, the context menu): the composer opens as a draft card in the
+ * comment margin, beside the target, exactly as after picking it with the
+ * comment target picker. A text selection inside the target field becomes
+ * the comment's range.
+ *
+ * On mobile the comments panel below the canvas is that margin. Only where
+ * neither can show (fullscreen presentation) the composer still opens as a
+ * popover at `fallbackAnchor`.
+ */
+export declare function addCommentOnTarget(editContext: EditContextType, target: AddCommentOptions, fallbackAnchor: {
+    element: Element | null | undefined;
+    range?: SelectionRange;
+} | {
+    position: {
+        x: number;
+        y: number;
+    };
+    range?: SelectionRange;
+}): void;

package/dist/editor/reviews/addCommentOnTarget.js

@@ -0,0 +1,32 @@
+import { showCommentPopoverAt } from "./CommentPopover";
+/**
+ * "Add comment" on a known target (a field's comment button, the formatting
+ * toolbar, the context menu): the composer opens as a draft card in the
+ * comment margin, beside the target, exactly as after picking it with the
+ * comment target picker. A text selection inside the target field becomes
+ * the comment's range.
+ *
+ * On mobile the comments panel below the canvas is that margin. Only where
+ * neither can show (fullscreen presentation) the composer still opens as a
+ * popover at `fallbackAnchor`.
+ */
+export function addCommentOnTarget(editContext, target, fallbackAnchor) {
+    const marginAvailable = !editContext.fullscreen;
+    if (marginAvailable) {
+        editContext.addComment(target);
+        return;
+    }
+    const rect = "element" in fallbackAnchor
+        ? fallbackAnchor.element?.getBoundingClientRect()
+        : undefined;
+    const position = "position" in fallbackAnchor
+        ? fallbackAnchor.position
+        : rect
+            ? { x: rect.left, y: rect.bottom }
+            : { x: window.innerWidth / 2, y: window.innerHeight / 2 };
+    showCommentPopoverAt(position, editContext, {
+        field: target.field,
+        range: fallbackAnchor.range,
+    });
+}
+//# sourceMappingURL=addCommentOnTarget.js.map

package/dist/editor/reviews/addCommentOnTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addCommentOnTarget.js","sourceRoot":"","sources":["../../../src/editor/reviews/addCommentOnTarget.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAA4B,EAC5B,MAAyB,EACzB,cAEkE;IAElE,MAAM,eAAe,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC;IAChD,IAAI,eAAe,EAAE,CAAC;QACpB,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GACR,SAAS,IAAI,cAAc;QACzB,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,qBAAqB,EAAE;QACjD,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,QAAQ,GACZ,UAAU,IAAI,cAAc;QAC1B,CAAC,CAAC,cAAc,CAAC,QAAQ;QACzB,CAAC,CAAC,IAAI;YACJ,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE;YAClC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;IAChE,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE;QAC1C,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,cAAc,CAAC,KAAK;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/dist/editor/reviews/balloonLayout.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Word-style balloon layout for the comment margin.
+ *
+ * Every card wants to sit at the top of the text it is anchored to. Cards are
+ * placed top to bottom without overlapping; the selected ("pinned") card stays
+ * at its anchor and pushes its neighbours away in both directions; and the
+ * whole stack is kept inside `[minY, maxY]` (the column below the header and
+ * above the footer, in document coordinates), shifting cards above their
+ * anchor when the page end is near.
+ *
+ * Precedence: bounds > pinned card at its anchor > other cards at their
+ * anchors > no overlap. When the cards cannot fit at all the layout reports
+ * `overflow` and the caller switches to a scrolling presentation.
+ */
+export type BalloonInput = {
+    id: string;
+    /** Document-space y of the anchored text; items must be sorted by it. */
+    anchorY: number;
+    /** Measured card height; 0 while unknown. */
+    height: number;
+};
+export type BalloonLayoutOptions = {
+    /** Vertical gap between cards. */
+    gap: number;
+    /** Top of the usable column. */
+    minY: number;
+    /** Bottom of the usable column. */
+    maxY: number;
+    /** Card kept at its anchor (the selected thread). */
+    pinnedId?: string | null;
+};
+export type BalloonPosition = {
+    id: string;
+    top: number;
+};
+export type BalloonLayout = {
+    positions: BalloonPosition[];
+    /** The cards do not fit between minY and maxY; positions are clamped. */
+    overflow: boolean;
+};
+export declare function layoutBalloons(items: readonly BalloonInput[], { gap, minY, maxY, pinnedId }: BalloonLayoutOptions): BalloonLayout;
+/** Sort helper: by anchor, then creation time, then id for a stable order. */
+export declare function compareBalloonAnchors(a: {
+    anchorY: number;
+    created: number;
+    id: string;
+}, b: {
+    anchorY: number;
+    created: number;
+    id: string;
+}): number;

package/dist/editor/reviews/balloonLayout.js

@@ -0,0 +1,101 @@
+/**
+ * Word-style balloon layout for the comment margin.
+ *
+ * Every card wants to sit at the top of the text it is anchored to. Cards are
+ * placed top to bottom without overlapping; the selected ("pinned") card stays
+ * at its anchor and pushes its neighbours away in both directions; and the
+ * whole stack is kept inside `[minY, maxY]` (the column below the header and
+ * above the footer, in document coordinates), shifting cards above their
+ * anchor when the page end is near.
+ *
+ * Precedence: bounds > pinned card at its anchor > other cards at their
+ * anchors > no overlap. When the cards cannot fit at all the layout reports
+ * `overflow` and the caller switches to a scrolling presentation.
+ */
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+export function layoutBalloons(items, { gap, minY, maxY, pinnedId }) {
+    const n = items.length;
+    if (n === 0)
+        return { positions: [], overflow: false };
+    const heights = items.map((item) => Math.max(0, item.height));
+    const total = heights.reduce((sum, height) => sum + height, 0) + gap * (n - 1);
+    const available = maxY - minY;
+    const top = new Array(n);
+    if (total > available) {
+        // Nothing can make this fit; report it. A caller that renders anyway
+        // (while a switch to the scrolling presentation is deferred) gets the
+        // plain downward stack: no overlap, the tail simply runs past maxY.
+        for (let i = 0; i < n; i++) {
+            const previousBottom = i === 0 ? -Infinity : top[i - 1] + heights[i - 1] + gap;
+            top[i] = Math.max(minY, items[i].anchorY, previousBottom);
+        }
+        return {
+            overflow: true,
+            positions: items.map((item, index) => ({ id: item.id, top: top[index] })),
+        };
+    }
+    const pinnedIndex = pinnedId
+        ? items.findIndex((item) => item.id === pinnedId)
+        : -1;
+    // Room the cards above index i need at minimum (each height plus a gap).
+    const stackAbove = new Array(n + 1);
+    stackAbove[0] = 0;
+    for (let i = 0; i < n; i++) {
+        stackAbove[i + 1] = stackAbove[i] + heights[i] + gap;
+    }
+    // Room the cards below index i need at minimum.
+    const stackBelow = new Array(n + 1);
+    stackBelow[n] = 0;
+    for (let i = n - 1; i >= 0; i--) {
+        stackBelow[i] = stackBelow[i + 1] + heights[i] + gap;
+    }
+    // Plain downward stacking of cards [from, to): each at its anchor, or below
+    // the card before it.
+    const placeForward = (from, to) => {
+        for (let i = from; i < to; i++) {
+            const previousBottom = i === 0 ? -Infinity : top[i - 1] + heights[i - 1] + gap;
+            top[i] = Math.max(minY, items[i].anchorY, previousBottom);
+        }
+    };
+    if (pinnedIndex < 0) {
+        placeForward(0, n);
+    }
+    else {
+        const p = pinnedIndex;
+        // The pinned card can only sit where the cards above still fit over it
+        // and the cards below still fit under it.
+        const lo = minY + stackAbove[p];
+        const hi = maxY - heights[p] - stackBelow[p + 1];
+        top[p] = clamp(items[p].anchorY, lo, hi);
+        // Cards above the pin lay out exactly as without a pin, so selecting a
+        // card far away moves nothing; only the ones that would run into the
+        // pinned card are pushed up (never above what the cards over them need).
+        placeForward(0, p);
+        for (let i = p - 1; i >= 0; i--) {
+            const ceiling = top[i + 1] - gap - heights[i];
+            if (top[i] > ceiling) {
+                top[i] = Math.max(minY + stackAbove[i], ceiling);
+            }
+        }
+        // Cards below the pin: pushed down.
+        placeForward(p + 1, n);
+    }
+    // Back pass: keep everything above maxY by shifting cards up. The pinned
+    // card never needs to move because `hi` already reserved the room below it.
+    for (let i = n - 1; i >= 0; i--) {
+        const limit = (i === n - 1 ? maxY : top[i + 1] - gap) - heights[i];
+        if (top[i] > limit)
+            top[i] = Math.max(minY, limit);
+    }
+    return {
+        overflow: false,
+        positions: items.map((item, index) => ({ id: item.id, top: top[index] })),
+    };
+}
+/** Sort helper: by anchor, then creation time, then id for a stable order. */
+export function compareBalloonAnchors(a, b) {
+    return a.anchorY - b.anchorY || a.created - b.created || a.id.localeCompare(b.id);
+}
+//# sourceMappingURL=balloonLayout.js.map

package/dist/editor/reviews/balloonLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balloonLayout.js","sourceRoot":"","sources":["../../../src/editor/reviews/balloonLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6BH,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAA8B,EAC9B,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAwB;IAEnD,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAEvD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GACT,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;IAE9B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC;IAEjC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QACtB,qEAAqE;QACrE,sEAAsE;QACtE,oEAAoE;QACpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,cAAc,GAClB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,GAAG,CAAC;YAC5D,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAE,EAAE,CAAC,CAAC;SAC3E,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ;QAC1B,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC;QACjD,CAAC,CAAC,CAAC,CAAC,CAAC;IAEP,yEAAyE;IACzE,MAAM,UAAU,GAAG,IAAI,KAAK,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAE,GAAG,OAAO,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC;IACzD,CAAC;IACD,gDAAgD;IAChD,MAAM,UAAU,GAAG,IAAI,KAAK,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,OAAO,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC;IACzD,CAAC;IAED,4EAA4E;IAC5E,sBAAsB;IACtB,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE;QAChD,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,cAAc,GAClB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,GAAG,CAAC;YAC5D,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,WAAW,CAAC;QACtB,uEAAuE;QACvE,0CAA0C;QAC1C,MAAM,EAAE,GAAG,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QACjC,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAE,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACnD,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAE1C,uEAAuE;QACvE,qEAAqE;QACrE,yEAAyE;QACzE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YAChD,IAAI,GAAG,CAAC,CAAC,CAAE,GAAG,OAAO,EAAE,CAAC;gBACtB,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,YAAY,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,yEAAyE;IACzE,4EAA4E;IAC5E,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,KAAK,GACT,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACzD,IAAI,GAAG,CAAC,CAAC,CAAE,GAAG,KAAK;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAE,EAAE,CAAC,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,qBAAqB,CACnC,CAAmD,EACnD,CAAmD;IAEnD,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/dist/editor/reviews/commentAgentAttachments.d.ts

@@ -0,0 +1,5 @@
+import { type AgentMessageAttachment, type AgentMetadata } from "../services/agentService";
+/** Copy authorized comment images into the agent document store, whose images
+ * are included as visual inputs by the backend message builder. Keep successful
+ * uploads in the caller's cache so a failed submission can be retried. */
+export declare function prepareCommentAgentAttachments(agentId: string, comment: AgentMetadata["comment"], profileId: string | undefined, cache: Map<string, AgentMessageAttachment>): Promise<AgentMessageAttachment[]>;

package/dist/editor/reviews/commentAgentAttachments.js

@@ -0,0 +1,51 @@
+import { uploadDocument, } from "../services/agentService";
+import { COMMENT_IMAGE_MAX_BYTES, splitCommentImages } from "./commentImages";
+/** Copy authorized comment images into the agent document store, whose images
+ * are included as visual inputs by the backend message builder. Keep successful
+ * uploads in the caller's cache so a failed submission can be retried. */
+export async function prepareCommentAgentAttachments(agentId, comment, profileId, cache) {
+    const images = new Map();
+    for (const entry of comment?.thread ?? (comment ? [comment] : [])) {
+        for (const segment of splitCommentImages(entry.text || "")) {
+            if (segment.type === "image")
+                images.set(segment.imageId, segment.src);
+        }
+    }
+    const attachments = [];
+    for (const [imageId, src] of images) {
+        const key = `${agentId}:${imageId}`;
+        const cached = cache.get(key);
+        if (cached) {
+            attachments.push(cached);
+            continue;
+        }
+        // Only the recognized local comment-image endpoint is fetched. It enforces
+        // the current user's access to the comment before returning image bytes.
+        const response = await fetch(src, { credentials: "include" });
+        if (!response.ok) {
+            throw new Error("Could not load a comment screenshot. Please try again.");
+        }
+        const blob = await response.blob();
+        const extension = {
+            "image/png": "png",
+            "image/jpeg": "jpg",
+            "image/gif": "gif",
+            "image/webp": "webp",
+        }[blob.type];
+        if (!extension || !blob.size || blob.size > COMMENT_IMAGE_MAX_BYTES) {
+            throw new Error("A comment screenshot is invalid or too large to attach.");
+        }
+        const file = new File([blob], `comment-image-${imageId}.${extension}`, {
+            type: blob.type,
+        });
+        const result = await uploadDocument(agentId, file, profileId);
+        if (!result.success || !result.document) {
+            throw new Error(result.error || "Could not attach a comment screenshot.");
+        }
+        const { extractedText: _extractedText, ...attachment } = result.document;
+        cache.set(key, attachment);
+        attachments.push(attachment);
+    }
+    return attachments;
+}
+//# sourceMappingURL=commentAgentAttachments.js.map