@opengeni/react 3.8.0-canary.0 → 3.8.0-canary.1

package/dist/chunk-YBM6CQRU.js

@@ -0,0 +1,292 @@
+import {
+  AnnotationAccentRow,
+  AnnotationNotePreview,
+  AnnotationQuoteSourceButton,
+  TimelineAnnotationSourceRootContext,
+  useTimelineAnnotationSourceRoot
+} from "./chunk-5M6VTFJ5.js";
+import {
+  ANNOTATION_CARD_STACK_SCROLL_AT
+} from "./chunk-ZYRGEKWS.js";
+import {
+  annotationDisplayOrdinal,
+  annotationHasNote,
+  resolveAnnotationRevealRoot
+} from "./chunk-NOSYBS2D.js";
+import {
+  cn
+} from "./chunk-22KP6LR5.js";
+
+// src/components/timeline-annotations.tsx
+import { QuoteIcon, XIcon } from "lucide-react";
+import {
+  Suspense,
+  lazy,
+  useEffect,
+  useLayoutEffect,
+  useRef,
+  useState
+} from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var TimelineAnnotationsDialog = lazy(() => import("./timeline-annotations-dialog-6Q53N5FG.js"));
+function AnnotationSourceRootBridge({
+  triggerRef,
+  children
+}) {
+  const inheritedRoot = useTimelineAnnotationSourceRoot();
+  const conversationRootRef = useRef(null);
+  if (!inheritedRoot) {
+    conversationRootRef.current = resolveAnnotationRevealRoot(triggerRef.current);
+  }
+  useLayoutEffect(() => {
+    if (inheritedRoot) return;
+    conversationRootRef.current = resolveAnnotationRevealRoot(triggerRef.current);
+  });
+  if (inheritedRoot) return children;
+  return /* @__PURE__ */ jsx(TimelineAnnotationSourceRootContext.Provider, { value: conversationRootRef, children });
+}
+function TimelineAnnotationCards({
+  annotations,
+  onRevealSource,
+  className
+}) {
+  const [unavailableId, setUnavailableId] = useState(null);
+  if (annotations.length === 0) return null;
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      "data-og-annotation-cards": "",
+      className: cn(
+        "grid gap-2",
+        annotations.length >= ANNOTATION_CARD_STACK_SCROLL_AT && "max-h-[min(28rem,55vh)] overflow-x-hidden overflow-y-auto overscroll-contain pr-1",
+        className
+      ),
+      children: annotations.map((annotation, index) => {
+        const ordinal = annotationDisplayOrdinal(annotation, index);
+        return /* @__PURE__ */ jsx("section", { "aria-label": `Annotation ${ordinal}`, children: /* @__PURE__ */ jsxs(AnnotationAccentRow, { children: [
+          /* @__PURE__ */ jsxs("p", { className: "mb-0.5 text-og-xs font-medium tabular-nums text-og-fg-subtle", children: [
+            "Annotation ",
+            ordinal
+          ] }),
+          /* @__PURE__ */ jsx(
+            AnnotationQuoteSourceButton,
+            {
+              annotation,
+              lines: 2,
+              onRevealSource,
+              onUnavailable: setUnavailableId
+            }
+          ),
+          unavailableId === annotation.id ? /* @__PURE__ */ jsx("p", { role: "status", className: "text-og-xs text-og-status-waiting", children: "Source is outside the loaded timeline window." }) : null,
+          /* @__PURE__ */ jsx(
+            AnnotationNotePreview,
+            {
+              note: annotation.note,
+              annotationId: annotation.id,
+              ordinal
+            }
+          )
+        ] }) }, annotation.id);
+      })
+    }
+  );
+}
+function TimelineAnnotationsChip({
+  annotations,
+  editable = false,
+  focusAnnotationId,
+  onFocusConsumed,
+  onUpdate,
+  onRemove,
+  onRevealSource,
+  className
+}) {
+  const focusRequested = Boolean(
+    focusAnnotationId && annotations.some((item) => item.id === focusAnnotationId)
+  );
+  const [open, setOpen] = useState(focusRequested);
+  const triggerRef = useRef(null);
+  const openedFocusId = useRef(focusRequested ? focusAnnotationId ?? null : null);
+  useEffect(() => {
+    if (!focusRequested || !focusAnnotationId) {
+      if (!focusRequested) openedFocusId.current = null;
+      return;
+    }
+    if (openedFocusId.current === focusAnnotationId) return;
+    openedFocusId.current = focusAnnotationId;
+    setOpen(true);
+  }, [focusAnnotationId, focusRequested]);
+  if (annotations.length === 0) return null;
+  const countLabel = `${annotations.length} ${annotations.length === 1 ? "annotation" : "annotations"}`;
+  const incomplete = annotations.some((annotation) => !annotationHasNote(annotation.note));
+  const canClear = Boolean(editable && onRemove);
+  const dismiss = (restoreFocus) => {
+    setOpen(false);
+    onFocusConsumed?.();
+    if (restoreFocus) triggerRef.current?.focus();
+  };
+  return /* @__PURE__ */ jsxs("span", { className: cn("inline-flex max-w-full items-center", className), children: [
+    /* @__PURE__ */ jsxs(
+      "span",
+      {
+        className: cn(
+          "inline-flex max-w-full items-center rounded-full border bg-og-surface-1 text-og-fg-muted",
+          incomplete ? "border-og-accent/45 bg-og-accent-soft/50" : "border-og-border"
+        ),
+        children: [
+          /* @__PURE__ */ jsxs(
+            "button",
+            {
+              ref: triggerRef,
+              type: "button",
+              className: cn(
+                "inline-flex min-h-8 min-w-0 max-w-full items-center gap-1.5 rounded-full border-0 bg-transparent py-1 text-og-sm font-medium outline-hidden transition hover:text-og-fg focus-visible:ring-2 focus-visible:ring-og-accent pointer-coarse:min-h-[44px]",
+                canClear ? "pr-1 pl-2.5" : "px-2.5"
+              ),
+              "aria-label": `Review ${countLabel}`,
+              "aria-haspopup": "dialog",
+              "aria-expanded": open,
+              onClick: () => setOpen((current) => !current),
+              children: [
+                /* @__PURE__ */ jsx(QuoteIcon, { className: "size-3.5 shrink-0 text-og-accent", "aria-hidden": "true" }),
+                /* @__PURE__ */ jsx("span", { className: "min-w-0 truncate", children: countLabel })
+              ]
+            }
+          ),
+          canClear ? /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "inline-flex size-7 shrink-0 items-center justify-center rounded-full border-0 bg-transparent text-og-fg-subtle outline-hidden hover:text-og-status-failed focus-visible:ring-2 focus-visible:ring-og-accent pointer-coarse:size-11",
+              "aria-label": "Remove all annotations",
+              onClick: () => {
+                for (const annotation of annotations) onRemove?.(annotation.id);
+              },
+              children: /* @__PURE__ */ jsx(XIcon, { className: "size-3.5", "aria-hidden": "true" })
+            }
+          ) : null
+        ]
+      }
+    ),
+    open ? /* @__PURE__ */ jsx(AnnotationSourceRootBridge, { triggerRef, children: /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(
+      TimelineAnnotationsDialog,
+      {
+        annotations,
+        editable,
+        focusAnnotationId,
+        onFocusConsumed,
+        onUpdate,
+        onRemove,
+        onRevealSource,
+        triggerRef,
+        countLabel,
+        onDismiss: dismiss
+      }
+    ) }) }) : null
+  ] });
+}
+
+// src/components/queue-draft-policy.ts
+function requestQueueDraftEdit(composer, confirmReplacement, editImmediately) {
+  if (composer.hasDraftContent()) {
+    confirmReplacement();
+  } else {
+    editImmediately();
+  }
+}
+
+// src/components/queue-surface-state.tsx
+import { Loader2Icon, RotateCwIcon } from "lucide-react";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function EmptyQueueStateSurface({ queue }) {
+  const hasError = Boolean(queue.error || queue.mutationError);
+  return /* @__PURE__ */ jsx2(
+    "div",
+    {
+      className: "og-root mx-auto mb-2 w-full max-w-3xl shrink-0 px-4 sm:px-6",
+      "data-testid": "queue-surface",
+      children: /* @__PURE__ */ jsxs2("div", { className: "overflow-hidden rounded-lg border border-border bg-surface/80 shadow-sm", children: [
+        queue.stoppingPreviousAttempt ? /* @__PURE__ */ jsx2(QueueStoppingStatus, { queue, dividerAfter: hasError }) : null,
+        hasError ? /* @__PURE__ */ jsx2(QueueErrorAlert, { queue }) : null
+      ] })
+    }
+  );
+}
+function QueueStoppingStatus({
+  queue,
+  dividerAfter = false
+}) {
+  return /* @__PURE__ */ jsxs2(
+    "div",
+    {
+      role: "status",
+      "aria-live": "polite",
+      className: `flex min-h-11 items-center gap-2.5 bg-status-waiting/[0.07] px-3 py-2 text-og-control text-fg ${dividerAfter ? "border-b border-status-waiting/20" : ""}`,
+      "data-testid": "stopping-previous-attempt",
+      children: [
+        /* @__PURE__ */ jsx2(
+          Loader2Icon,
+          {
+            "aria-hidden": "true",
+            className: "size-3.5 shrink-0 animate-spin text-status-waiting motion-reduce:animate-none"
+          }
+        ),
+        /* @__PURE__ */ jsxs2("span", { className: "min-w-0", children: [
+          /* @__PURE__ */ jsx2("span", { className: "font-medium", children: queue.effectiveControl?.state === "paused" ? "Stopping current attempt\u2026" : "Stopping previous attempt\u2026" }),
+          " ",
+          /* @__PURE__ */ jsx2("span", { className: "text-fg-muted", children: queue.effectiveControl?.state === "paused" ? "Queued work stays saved until you resume." : "Queued work is saved and starts automatically." })
+        ] })
+      ]
+    }
+  );
+}
+function QueueErrorAlert({
+  queue,
+  dividerBefore = false
+}) {
+  return /* @__PURE__ */ jsx2("div", { className: `${dividerBefore ? "border-t border-border" : ""} p-2`, children: /* @__PURE__ */ jsxs2(
+    "div",
+    {
+      role: "alert",
+      className: "flex min-w-0 max-w-full flex-wrap items-start gap-2 rounded-md bg-status-failed/10 px-2 py-1.5 text-og-control text-status-failed",
+      children: [
+        /* @__PURE__ */ jsx2(
+          "span",
+          {
+            role: "region",
+            "aria-label": "Queue error details",
+            tabIndex: 0,
+            className: "max-h-[min(5rem,20dvh)] min-w-0 max-w-full flex-[1_1_5rem] overflow-auto overscroll-contain whitespace-pre-wrap rounded-sm outline-hidden [overflow-wrap:anywhere] [unicode-bidi:plaintext] focus-visible:ring-2 focus-visible:ring-ring/40",
+            "data-testid": "queue-error-message",
+            dir: "auto",
+            children: (queue.mutationError ?? queue.error)?.message
+          }
+        ),
+        /* @__PURE__ */ jsx2(
+          "button",
+          {
+            type: "button",
+            onClick: () => {
+              queue.clearMutationError();
+              void queue.refresh();
+            },
+            "aria-label": "Dismiss queue error and retry",
+            title: "Retry loading the queue",
+            className: "ms-auto inline-flex size-7 shrink-0 items-center justify-center self-start rounded-md outline-hidden transition-colors hover:bg-surface-3 focus-visible:ring-2 focus-visible:ring-ring/40 motion-reduce:transition-none pointer-coarse:size-[44px]",
+            children: /* @__PURE__ */ jsx2(RotateCwIcon, { className: "size-3.5" })
+          }
+        )
+      ]
+    }
+  ) });
+}
+
+export {
+  TimelineAnnotationCards,
+  TimelineAnnotationsChip,
+  requestQueueDraftEdit,
+  EmptyQueueStateSurface,
+  QueueStoppingStatus,
+  QueueErrorAlert
+};
+//# sourceMappingURL=chunk-YBM6CQRU.js.map

package/dist/chunk-YBM6CQRU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/timeline-annotations.tsx","../src/components/queue-draft-policy.ts","../src/components/queue-surface-state.tsx"],"sourcesContent":["import type { TimelineAnnotationSource } from \"@opengeni/sdk\";\nimport { QuoteIcon, XIcon } from \"lucide-react\";\nimport {\n  Suspense,\n  lazy,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n  type ReactNode,\n  type RefObject,\n} from \"react\";\nimport { cn } from \"../lib/cn\";\nimport {\n  AnnotationAccentRow,\n  AnnotationNotePreview,\n  AnnotationQuoteSourceButton,\n  type TimelineAnnotationLike,\n} from \"./timeline-annotation-chrome\";\nimport { ANNOTATION_CARD_STACK_SCROLL_AT } from \"./timeline-annotation-layout\";\nimport {\n  TimelineAnnotationSourceRootContext,\n  useTimelineAnnotationSourceRoot,\n} from \"./timeline-annotation-reveal-context\";\nimport {\n  annotationDisplayOrdinal,\n  annotationHasNote,\n  resolveAnnotationRevealRoot,\n} from \"./timeline-annotation-shared\";\n\nexport type { TimelineAnnotationLike } from \"./timeline-annotation-chrome\";\n\nconst TimelineAnnotationsDialog = lazy(() => import(\"./timeline-annotations-dialog\"));\n\nfunction AnnotationSourceRootBridge({\n  triggerRef,\n  children,\n}: {\n  triggerRef: RefObject<HTMLElement | null>;\n  children: ReactNode;\n}) {\n  const inheritedRoot = useTimelineAnnotationSourceRoot();\n  const conversationRootRef = useRef<HTMLElement | null>(null);\n  if (!inheritedRoot) {\n    conversationRootRef.current = resolveAnnotationRevealRoot(triggerRef.current);\n  }\n  useLayoutEffect(() => {\n    if (inheritedRoot) return;\n    conversationRootRef.current = resolveAnnotationRevealRoot(triggerRef.current);\n  });\n  if (inheritedRoot) return children;\n  return (\n    <TimelineAnnotationSourceRootContext.Provider value={conversationRootRef}>\n      {children}\n    </TimelineAnnotationSourceRootContext.Provider>\n  );\n}\n\nexport function TimelineAnnotationCards({\n  annotations,\n  onRevealSource,\n  className,\n}: {\n  annotations: readonly TimelineAnnotationLike[];\n  onRevealSource?: ((source: TimelineAnnotationSource) => boolean) | undefined;\n  className?: string | undefined;\n}) {\n  const [unavailableId, setUnavailableId] = useState<string | null>(null);\n  if (annotations.length === 0) return null;\n  return (\n    <div\n      data-og-annotation-cards=\"\"\n      className={cn(\n        \"grid gap-2\",\n        annotations.length >= ANNOTATION_CARD_STACK_SCROLL_AT &&\n          \"max-h-[min(28rem,55vh)] overflow-x-hidden overflow-y-auto overscroll-contain pr-1\",\n        className,\n      )}\n    >\n      {annotations.map((annotation, index) => {\n        const ordinal = annotationDisplayOrdinal(annotation, index);\n        return (\n          <section key={annotation.id} aria-label={`Annotation ${ordinal}`}>\n            <AnnotationAccentRow>\n              <p className=\"mb-0.5 text-og-xs font-medium tabular-nums text-og-fg-subtle\">\n                Annotation {ordinal}\n              </p>\n              <AnnotationQuoteSourceButton\n                annotation={annotation}\n                lines={2}\n                onRevealSource={onRevealSource}\n                onUnavailable={setUnavailableId}\n              />\n              {unavailableId === annotation.id ? (\n                <p role=\"status\" className=\"text-og-xs text-og-status-waiting\">\n                  Source is outside the loaded timeline window.\n                </p>\n              ) : null}\n              <AnnotationNotePreview\n                note={annotation.note}\n                annotationId={annotation.id}\n                ordinal={ordinal}\n              />\n            </AnnotationAccentRow>\n          </section>\n        );\n      })}\n    </div>\n  );\n}\n\nexport function TimelineAnnotationsChip({\n  annotations,\n  editable = false,\n  focusAnnotationId,\n  onFocusConsumed,\n  onUpdate,\n  onRemove,\n  onRevealSource,\n  className,\n}: {\n  annotations: readonly TimelineAnnotationLike[];\n  editable?: boolean | undefined;\n  focusAnnotationId?: string | null | undefined;\n  onFocusConsumed?: (() => void) | undefined;\n  onUpdate?: ((id: string, note: string) => void) | undefined;\n  onRemove?: ((id: string) => void) | undefined;\n  onRevealSource?: ((source: TimelineAnnotationSource) => boolean) | undefined;\n  className?: string | undefined;\n}) {\n  const focusRequested = Boolean(\n    focusAnnotationId && annotations.some((item) => item.id === focusAnnotationId),\n  );\n  const [open, setOpen] = useState(focusRequested);\n  const triggerRef = useRef<HTMLButtonElement | null>(null);\n  const openedFocusId = useRef<string | null>(focusRequested ? (focusAnnotationId ?? null) : null);\n\n  useEffect(() => {\n    if (!focusRequested || !focusAnnotationId) {\n      if (!focusRequested) openedFocusId.current = null;\n      return;\n    }\n    if (openedFocusId.current === focusAnnotationId) return;\n    openedFocusId.current = focusAnnotationId;\n    setOpen(true);\n  }, [focusAnnotationId, focusRequested]);\n\n  if (annotations.length === 0) return null;\n  const countLabel = `${annotations.length} ${annotations.length === 1 ? \"annotation\" : \"annotations\"}`;\n  const incomplete = annotations.some((annotation) => !annotationHasNote(annotation.note));\n  const canClear = Boolean(editable && onRemove);\n\n  const dismiss = (restoreFocus: boolean) => {\n    setOpen(false);\n    onFocusConsumed?.();\n    if (restoreFocus) triggerRef.current?.focus();\n  };\n\n  return (\n    <span className={cn(\"inline-flex max-w-full items-center\", className)}>\n      <span\n        className={cn(\n          \"inline-flex max-w-full items-center rounded-full border bg-og-surface-1 text-og-fg-muted\",\n          incomplete ? \"border-og-accent/45 bg-og-accent-soft/50\" : \"border-og-border\",\n        )}\n      >\n        <button\n          ref={triggerRef}\n          type=\"button\"\n          className={cn(\n            \"inline-flex min-h-8 min-w-0 max-w-full items-center gap-1.5 rounded-full border-0 bg-transparent py-1 text-og-sm font-medium outline-hidden transition hover:text-og-fg focus-visible:ring-2 focus-visible:ring-og-accent pointer-coarse:min-h-[44px]\",\n            canClear ? \"pr-1 pl-2.5\" : \"px-2.5\",\n          )}\n          aria-label={`Review ${countLabel}`}\n          aria-haspopup=\"dialog\"\n          aria-expanded={open}\n          onClick={() => setOpen((current) => !current)}\n        >\n          <QuoteIcon className=\"size-3.5 shrink-0 text-og-accent\" aria-hidden=\"true\" />\n          <span className=\"min-w-0 truncate\">{countLabel}</span>\n        </button>\n        {canClear ? (\n          <button\n            type=\"button\"\n            className=\"inline-flex size-7 shrink-0 items-center justify-center rounded-full border-0 bg-transparent text-og-fg-subtle outline-hidden hover:text-og-status-failed focus-visible:ring-2 focus-visible:ring-og-accent pointer-coarse:size-11\"\n            aria-label=\"Remove all annotations\"\n            onClick={() => {\n              for (const annotation of annotations) onRemove?.(annotation.id);\n            }}\n          >\n            <XIcon className=\"size-3.5\" aria-hidden=\"true\" />\n          </button>\n        ) : null}\n      </span>\n      {open ? (\n        <AnnotationSourceRootBridge triggerRef={triggerRef}>\n          <Suspense fallback={null}>\n            <TimelineAnnotationsDialog\n              annotations={annotations}\n              editable={editable}\n              focusAnnotationId={focusAnnotationId}\n              onFocusConsumed={onFocusConsumed}\n              onUpdate={onUpdate}\n              onRemove={onRemove}\n              onRevealSource={onRevealSource}\n              triggerRef={triggerRef}\n              countLabel={countLabel}\n              onDismiss={dismiss}\n            />\n          </Suspense>\n        </AnnotationSourceRootBridge>\n      ) : null}\n    </span>\n  );\n}\n\nexport default TimelineAnnotationsChip;\n","import type { ComposerState } from \"../hooks/use-composer\";\n\n/**\n * Decide whether checking out a queued prompt would replace current composer\n * content. `hasDraftContent` reads the synchronous draft refs, so this stays\n * correct even when a controlled input update has not rendered yet.\n */\nexport function requestQueueDraftEdit(\n  composer: Pick<ComposerState, \"hasDraftContent\">,\n  confirmReplacement: () => void,\n  editImmediately: () => void,\n): void {\n  if (composer.hasDraftContent()) {\n    confirmReplacement();\n  } else {\n    editImmediately();\n  }\n}\n","import { Loader2Icon, RotateCwIcon } from \"lucide-react\";\n\nimport type { UseTurnQueueResult } from \"../hooks/use-turn-queue\";\n\ntype QueueStateProps = {\n  queue: UseTurnQueueResult;\n};\n\nexport function EmptyQueueStateSurface({ queue }: QueueStateProps) {\n  const hasError = Boolean(queue.error || queue.mutationError);\n  return (\n    <div\n      className=\"og-root mx-auto mb-2 w-full max-w-3xl shrink-0 px-4 sm:px-6\"\n      data-testid=\"queue-surface\"\n    >\n      <div className=\"overflow-hidden rounded-lg border border-border bg-surface/80 shadow-sm\">\n        {queue.stoppingPreviousAttempt ? (\n          <QueueStoppingStatus queue={queue} dividerAfter={hasError} />\n        ) : null}\n        {hasError ? <QueueErrorAlert queue={queue} /> : null}\n      </div>\n    </div>\n  );\n}\n\nexport function QueueStoppingStatus({\n  queue,\n  dividerAfter = false,\n}: QueueStateProps & { dividerAfter?: boolean }) {\n  return (\n    <div\n      role=\"status\"\n      aria-live=\"polite\"\n      className={`flex min-h-11 items-center gap-2.5 bg-status-waiting/[0.07] px-3 py-2 text-og-control text-fg ${\n        dividerAfter ? \"border-b border-status-waiting/20\" : \"\"\n      }`}\n      data-testid=\"stopping-previous-attempt\"\n    >\n      <Loader2Icon\n        aria-hidden=\"true\"\n        className=\"size-3.5 shrink-0 animate-spin text-status-waiting motion-reduce:animate-none\"\n      />\n      <span className=\"min-w-0\">\n        <span className=\"font-medium\">\n          {queue.effectiveControl?.state === \"paused\"\n            ? \"Stopping current attempt…\"\n            : \"Stopping previous attempt…\"}\n        </span>{\" \"}\n        <span className=\"text-fg-muted\">\n          {queue.effectiveControl?.state === \"paused\"\n            ? \"Queued work stays saved until you resume.\"\n            : \"Queued work is saved and starts automatically.\"}\n        </span>\n      </span>\n    </div>\n  );\n}\n\nexport function QueueErrorAlert({\n  queue,\n  dividerBefore = false,\n}: QueueStateProps & { dividerBefore?: boolean }) {\n  return (\n    <div className={`${dividerBefore ? \"border-t border-border\" : \"\"} p-2`}>\n      <div\n        role=\"alert\"\n        className=\"flex min-w-0 max-w-full flex-wrap items-start gap-2 rounded-md bg-status-failed/10 px-2 py-1.5 text-og-control text-status-failed\"\n      >\n        <span\n          role=\"region\"\n          aria-label=\"Queue error details\"\n          tabIndex={0}\n          className=\"max-h-[min(5rem,20dvh)] min-w-0 max-w-full flex-[1_1_5rem] overflow-auto overscroll-contain whitespace-pre-wrap rounded-sm outline-hidden [overflow-wrap:anywhere] [unicode-bidi:plaintext] focus-visible:ring-2 focus-visible:ring-ring/40\"\n          data-testid=\"queue-error-message\"\n          dir=\"auto\"\n        >\n          {(queue.mutationError ?? queue.error)?.message}\n        </span>\n        <button\n          type=\"button\"\n          onClick={() => {\n            queue.clearMutationError();\n            void queue.refresh();\n          }}\n          aria-label=\"Dismiss queue error and retry\"\n          title=\"Retry loading the queue\"\n          className=\"ms-auto inline-flex size-7 shrink-0 items-center justify-center self-start rounded-md outline-hidden transition-colors hover:bg-surface-3 focus-visible:ring-2 focus-visible:ring-ring/40 motion-reduce:transition-none pointer-coarse:size-[44px]\"\n        >\n          <RotateCwIcon className=\"size-3.5\" />\n        </button>\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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","names":["jsx","jsxs"]}

package/dist/chunk-ZYRGEKWS.js

@@ -0,0 +1,216 @@
+// src/components/timeline-annotation-layout.ts
+var ANNOTATION_BADGE_GAP_PX = 32;
+var ANNOTATION_BADGE_MIN_GAP_PX = 12;
+var ANNOTATION_REVIEW_DIALOG_WIDTH_PX = 400;
+var ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX = 32 * 16;
+var ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX = 160;
+var ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX = 80;
+var ANNOTATION_REVIEW_MARGIN_PX = 12;
+var ANNOTATION_NOTE_PREVIEW_CHARS = 280;
+var ANNOTATION_CARD_STACK_SCROLL_AT = 4;
+function clampAnnotationAxis(value, min, max) {
+  return Math.min(Math.max(value, min), Math.max(min, max));
+}
+function annotationBoxIntersects(a, b) {
+  return a.left <= b.right && a.right >= b.left && a.top <= b.bottom && a.bottom >= b.top;
+}
+function annotationViewportBox(viewportWidth, viewportHeight, scroller) {
+  const viewport = {
+    left: 0,
+    top: 0,
+    right: Math.max(1, viewportWidth),
+    bottom: Math.max(1, viewportHeight)
+  };
+  if (!scroller || scroller.right - scroller.left <= 0 || scroller.bottom - scroller.top <= 0) {
+    return viewport;
+  }
+  return {
+    left: Math.max(viewport.left, scroller.left),
+    top: Math.max(viewport.top, scroller.top),
+    right: Math.min(viewport.right, scroller.right),
+    bottom: Math.min(viewport.bottom, scroller.bottom)
+  };
+}
+function annotationNoteNeedsDisclosure(note) {
+  const trimmed = note.trim();
+  if (trimmed.length === 0) return false;
+  return trimmed.length > ANNOTATION_NOTE_PREVIEW_CHARS || trimmed.split("\n").length > 4;
+}
+function annotationAxisStops(min, max, gap) {
+  if (max <= min) return [min];
+  const stops = [];
+  for (let value = min; value <= max + 1e-6; value += gap) {
+    stops.push(value);
+  }
+  return stops;
+}
+function annotationPointKey(left, top) {
+  return `${Math.round(left * 100) / 100},${Math.round(top * 100) / 100}`;
+}
+function annotationPointFree(left, top, placed, gap) {
+  return placed.every((other) => Math.hypot(left - other.left, top - other.top) >= gap);
+}
+function annotationBadgePackGap(viewport, count, preferred = ANNOTATION_BADGE_GAP_PX) {
+  if (count <= 1) return preferred;
+  const width = Math.max(
+    1,
+    viewport.right - ANNOTATION_REVIEW_MARGIN_PX - (viewport.left + ANNOTATION_REVIEW_MARGIN_PX)
+  );
+  const height = Math.max(1, viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX - (viewport.top + 8));
+  let gap = preferred;
+  const capacity = (step) => (Math.floor(width / step) + 1) * (Math.floor(height / step) + 1);
+  while (gap > ANNOTATION_BADGE_MIN_GAP_PX && capacity(gap) < count) {
+    gap -= 1;
+  }
+  return gap;
+}
+var ANNOTATION_BADGE_SHIFT_DIRS = [
+  [1, 0],
+  [1, 1],
+  [0, 1],
+  [-1, 1],
+  [-1, 0],
+  [-1, -1],
+  [0, -1],
+  [1, -1]
+];
+function layoutAnnotationBadges(anchors, viewport, preferredGap = ANNOTATION_BADGE_GAP_PX) {
+  const minLeft = viewport.left + ANNOTATION_REVIEW_MARGIN_PX;
+  const maxLeft = viewport.right - ANNOTATION_REVIEW_MARGIN_PX;
+  const minTop = viewport.top + 8;
+  const maxTop = viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX;
+  const gap = annotationBadgePackGap(viewport, anchors.length, preferredGap);
+  const cells = annotationAxisStops(minLeft, maxLeft, gap).flatMap(
+    (left) => annotationAxisStops(minTop, maxTop, gap).map((top) => ({ left, top }))
+  );
+  const placed = [];
+  for (const anchor of [...anchors].sort((left, right) => left.ordinal - right.ordinal)) {
+    const originLeft = clampAnnotationAxis(anchor.left, minLeft, maxLeft);
+    const originTop = clampAnnotationAxis(anchor.top, minTop, maxTop);
+    const seen = /* @__PURE__ */ new Set();
+    const candidates = [];
+    const pushCandidate = (left, top) => {
+      if (left < minLeft || left > maxLeft || top < minTop || top > maxTop) return;
+      const key = annotationPointKey(left, top);
+      if (seen.has(key)) return;
+      seen.add(key);
+      candidates.push({ left, top });
+    };
+    pushCandidate(originLeft, originTop);
+    for (const [dx, dy] of ANNOTATION_BADGE_SHIFT_DIRS) {
+      const colliders = [...placed].sort(
+        (left, right) => right.left * dx + right.top * dy - (left.left * dx + left.top * dy)
+      );
+      for (const collider of colliders) {
+        pushCandidate(collider.left + dx * gap, collider.top + dy * gap);
+      }
+    }
+    const maxRadius = Math.ceil(Math.max(maxLeft - minLeft, maxTop - minTop) / Math.max(gap, 1)) + 1;
+    for (let radius = 1; radius <= maxRadius; radius++) {
+      const ring = [];
+      for (let dx = -radius; dx <= radius; dx++) {
+        for (let dy = -radius; dy <= radius; dy++) {
+          if (Math.max(Math.abs(dx), Math.abs(dy)) !== radius) continue;
+          ring.push([dx, dy]);
+        }
+      }
+      ring.sort((left, right) => {
+        const leftDir = (left[0] < 0 ? 2 : 0) + (left[1] < 0 ? 1 : 0);
+        const rightDir = (right[0] < 0 ? 2 : 0) + (right[1] < 0 ? 1 : 0);
+        if (leftDir !== rightDir) return leftDir - rightDir;
+        const hypot = Math.hypot(left[0], left[1]) - Math.hypot(right[0], right[1]);
+        if (hypot !== 0) return hypot;
+        if (left[0] !== right[0]) return right[0] - left[0];
+        return left[1] - right[1];
+      });
+      for (const [dx, dy] of ring) {
+        pushCandidate(originLeft + dx * gap, originTop + dy * gap);
+      }
+    }
+    for (const cell of cells) {
+      pushCandidate(cell.left, cell.top);
+    }
+    const free = candidates.find(
+      (point) => annotationPointFree(point.left, point.top, placed, gap)
+    );
+    let chosen = free ?? candidates[0];
+    if (!free && placed.length > 0) {
+      let bestMin = Number.NEGATIVE_INFINITY;
+      for (const point of candidates) {
+        const minDist = placed.reduce(
+          (current, other) => Math.min(current, Math.hypot(point.left - other.left, point.top - other.top)),
+          Number.POSITIVE_INFINITY
+        );
+        if (minDist > bestMin) {
+          bestMin = minDist;
+          chosen = point;
+        }
+      }
+    }
+    placed.push({ ...anchor, left: chosen.left, top: chosen.top });
+  }
+  return placed;
+}
+function scrollAnnotationRowIntoList(list, row) {
+  if (!list || !row || !list.contains(row)) return;
+  const listRect = list.getBoundingClientRect();
+  const rowRect = row.getBoundingClientRect();
+  if (rowRect.top < listRect.top) {
+    list.scrollTop -= listRect.top - rowRect.top;
+    return;
+  }
+  if (rowRect.bottom > listRect.bottom) {
+    list.scrollTop += rowRect.bottom - listRect.bottom;
+  }
+}
+function clampAnnotationDialogPlacement(input) {
+  const margin = ANNOTATION_REVIEW_MARGIN_PX;
+  const panelWidth = Math.min(
+    input.panelWidth ?? ANNOTATION_REVIEW_DIALOG_WIDTH_PX,
+    Math.max(1, input.viewportWidth - margin * 2)
+  );
+  const left = Math.min(
+    Math.max(margin, input.triggerLeft),
+    Math.max(margin, input.viewportWidth - panelWidth - margin)
+  );
+  const spaceBelow = input.viewportHeight - input.triggerBottom - margin;
+  const spaceAbove = input.triggerTop - margin;
+  const above = spaceBelow < Math.min(input.contentHeight, 200) && spaceAbove > spaceBelow;
+  const viewportBudget = Math.max(
+    ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX,
+    input.viewportHeight - margin * 2
+  );
+  const available = Math.max(
+    Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget),
+    above ? spaceAbove : spaceBelow
+  );
+  let maxHeight = Math.min(
+    Math.max(input.contentHeight, Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget)),
+    available,
+    Math.floor(input.viewportHeight * 0.7) || viewportBudget,
+    ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX,
+    viewportBudget
+  );
+  let top = above ? Math.max(margin, input.triggerTop - 8 - maxHeight) : Math.min(
+    input.triggerBottom + 8,
+    Math.max(margin, input.viewportHeight - margin - maxHeight)
+  );
+  top = Math.max(margin, top);
+  maxHeight = Math.min(
+    maxHeight,
+    Math.max(ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX, input.viewportHeight - margin - top)
+  );
+  return { left, top, maxHeight, above };
+}
+
+export {
+  ANNOTATION_REVIEW_DIALOG_WIDTH_PX,
+  ANNOTATION_CARD_STACK_SCROLL_AT,
+  annotationBoxIntersects,
+  annotationViewportBox,
+  annotationNoteNeedsDisclosure,
+  layoutAnnotationBadges,
+  scrollAnnotationRowIntoList,
+  clampAnnotationDialogPlacement
+};
+//# sourceMappingURL=chunk-ZYRGEKWS.js.map

package/dist/chunk-ZYRGEKWS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/timeline-annotation-layout.ts"],"sourcesContent":["export type AnnotationBox = {\n  left: number;\n  right: number;\n  top: number;\n  bottom: number;\n};\n\nexport type AnnotationBadgeAnchor = {\n  id: string;\n  ordinal: number;\n  left: number;\n  top: number;\n  incomplete: boolean;\n};\n\nexport const ANNOTATION_BADGE_GAP_PX = 32;\nexport const ANNOTATION_BADGE_MIN_GAP_PX = 12;\nexport const ANNOTATION_REVIEW_DIALOG_WIDTH_PX = 400;\nexport const ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX = 32 * 16;\nexport const ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX = 160;\nexport const ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX = 80;\nexport const ANNOTATION_REVIEW_MARGIN_PX = 12;\nexport const ANNOTATION_NOTE_PREVIEW_CHARS = 280;\nexport const ANNOTATION_CARD_STACK_SCROLL_AT = 4;\n\nfunction clampAnnotationAxis(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), Math.max(min, max));\n}\n\nexport function annotationBoxIntersects(a: AnnotationBox, b: AnnotationBox): boolean {\n  return a.left <= b.right && a.right >= b.left && a.top <= b.bottom && a.bottom >= b.top;\n}\n\nexport function annotationViewportBox(\n  viewportWidth: number,\n  viewportHeight: number,\n  scroller?: AnnotationBox | null,\n): AnnotationBox {\n  const viewport: AnnotationBox = {\n    left: 0,\n    top: 0,\n    right: Math.max(1, viewportWidth),\n    bottom: Math.max(1, viewportHeight),\n  };\n  if (!scroller || scroller.right - scroller.left <= 0 || scroller.bottom - scroller.top <= 0) {\n    return viewport;\n  }\n  return {\n    left: Math.max(viewport.left, scroller.left),\n    top: Math.max(viewport.top, scroller.top),\n    right: Math.min(viewport.right, scroller.right),\n    bottom: Math.min(viewport.bottom, scroller.bottom),\n  };\n}\n\nexport function annotationNoteNeedsDisclosure(note: string): boolean {\n  const trimmed = note.trim();\n  if (trimmed.length === 0) return false;\n  return trimmed.length > ANNOTATION_NOTE_PREVIEW_CHARS || trimmed.split(\"\\n\").length > 4;\n}\n\nfunction annotationAxisStops(min: number, max: number, gap: number): number[] {\n  if (max <= min) return [min];\n  const stops: number[] = [];\n  for (let value = min; value <= max + 1e-6; value += gap) {\n    stops.push(value);\n  }\n  return stops;\n}\n\nfunction annotationPointKey(left: number, top: number): string {\n  return `${Math.round(left * 100) / 100},${Math.round(top * 100) / 100}`;\n}\n\nfunction annotationPointFree(\n  left: number,\n  top: number,\n  placed: readonly AnnotationBadgeAnchor[],\n  gap: number,\n): boolean {\n  return placed.every((other) => Math.hypot(left - other.left, top - other.top) >= gap);\n}\n\nexport function annotationBadgePackGap(\n  viewport: AnnotationBox,\n  count: number,\n  preferred = ANNOTATION_BADGE_GAP_PX,\n): number {\n  if (count <= 1) return preferred;\n  const width = Math.max(\n    1,\n    viewport.right - ANNOTATION_REVIEW_MARGIN_PX - (viewport.left + ANNOTATION_REVIEW_MARGIN_PX),\n  );\n  const height = Math.max(1, viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX - (viewport.top + 8));\n  let gap = preferred;\n  const capacity = (step: number) =>\n    (Math.floor(width / step) + 1) * (Math.floor(height / step) + 1);\n  while (gap > ANNOTATION_BADGE_MIN_GAP_PX && capacity(gap) < count) {\n    gap -= 1;\n  }\n  return gap;\n}\n\nconst ANNOTATION_BADGE_SHIFT_DIRS: Array<[number, number]> = [\n  [1, 0],\n  [1, 1],\n  [0, 1],\n  [-1, 1],\n  [-1, 0],\n  [-1, -1],\n  [0, -1],\n  [1, -1],\n];\n\nexport function layoutAnnotationBadges(\n  anchors: readonly AnnotationBadgeAnchor[],\n  viewport: AnnotationBox,\n  preferredGap = ANNOTATION_BADGE_GAP_PX,\n): AnnotationBadgeAnchor[] {\n  const minLeft = viewport.left + ANNOTATION_REVIEW_MARGIN_PX;\n  const maxLeft = viewport.right - ANNOTATION_REVIEW_MARGIN_PX;\n  const minTop = viewport.top + 8;\n  const maxTop = viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX;\n  const gap = annotationBadgePackGap(viewport, anchors.length, preferredGap);\n  const cells = annotationAxisStops(minLeft, maxLeft, gap).flatMap((left) =>\n    annotationAxisStops(minTop, maxTop, gap).map((top) => ({ left, top })),\n  );\n  const placed: AnnotationBadgeAnchor[] = [];\n  for (const anchor of [...anchors].sort((left, right) => left.ordinal - right.ordinal)) {\n    const originLeft = clampAnnotationAxis(anchor.left, minLeft, maxLeft);\n    const originTop = clampAnnotationAxis(anchor.top, minTop, maxTop);\n    const seen = new Set<string>();\n    const candidates: Array<{ left: number; top: number }> = [];\n    const pushCandidate = (left: number, top: number) => {\n      if (left < minLeft || left > maxLeft || top < minTop || top > maxTop) return;\n      const key = annotationPointKey(left, top);\n      if (seen.has(key)) return;\n      seen.add(key);\n      candidates.push({ left, top });\n    };\n    pushCandidate(originLeft, originTop);\n    for (const [dx, dy] of ANNOTATION_BADGE_SHIFT_DIRS) {\n      const colliders = [...placed].sort(\n        (left, right) => right.left * dx + right.top * dy - (left.left * dx + left.top * dy),\n      );\n      for (const collider of colliders) {\n        pushCandidate(collider.left + dx * gap, collider.top + dy * gap);\n      }\n    }\n    const maxRadius =\n      Math.ceil(Math.max(maxLeft - minLeft, maxTop - minTop) / Math.max(gap, 1)) + 1;\n    for (let radius = 1; radius <= maxRadius; radius++) {\n      const ring: Array<[number, number]> = [];\n      for (let dx = -radius; dx <= radius; dx++) {\n        for (let dy = -radius; dy <= radius; dy++) {\n          if (Math.max(Math.abs(dx), Math.abs(dy)) !== radius) continue;\n          ring.push([dx, dy]);\n        }\n      }\n      ring.sort((left, right) => {\n        const leftDir = (left[0] < 0 ? 2 : 0) + (left[1] < 0 ? 1 : 0);\n        const rightDir = (right[0] < 0 ? 2 : 0) + (right[1] < 0 ? 1 : 0);\n        if (leftDir !== rightDir) return leftDir - rightDir;\n        const hypot = Math.hypot(left[0], left[1]) - Math.hypot(right[0], right[1]);\n        if (hypot !== 0) return hypot;\n        if (left[0] !== right[0]) return right[0] - left[0];\n        return left[1] - right[1];\n      });\n      for (const [dx, dy] of ring) {\n        pushCandidate(originLeft + dx * gap, originTop + dy * gap);\n      }\n    }\n    for (const cell of cells) {\n      pushCandidate(cell.left, cell.top);\n    }\n    const free = candidates.find((point) =>\n      annotationPointFree(point.left, point.top, placed, gap),\n    );\n    let chosen = free ?? candidates[0]!;\n    if (!free && placed.length > 0) {\n      let bestMin = Number.NEGATIVE_INFINITY;\n      for (const point of candidates) {\n        const minDist = placed.reduce(\n          (current, other) =>\n            Math.min(current, Math.hypot(point.left - other.left, point.top - other.top)),\n          Number.POSITIVE_INFINITY,\n        );\n        if (minDist > bestMin) {\n          bestMin = minDist;\n          chosen = point;\n        }\n      }\n    }\n    placed.push({ ...anchor, left: chosen.left, top: chosen.top });\n  }\n  return placed;\n}\n\nexport function scrollAnnotationRowIntoList(\n  list: HTMLElement | null | undefined,\n  row: HTMLElement | null | undefined,\n): void {\n  if (!list || !row || !list.contains(row)) return;\n  const listRect = list.getBoundingClientRect();\n  const rowRect = row.getBoundingClientRect();\n  if (rowRect.top < listRect.top) {\n    list.scrollTop -= listRect.top - rowRect.top;\n    return;\n  }\n  if (rowRect.bottom > listRect.bottom) {\n    list.scrollTop += rowRect.bottom - listRect.bottom;\n  }\n}\n\nexport function clampAnnotationDialogPlacement(input: {\n  triggerLeft: number;\n  triggerTop: number;\n  triggerBottom: number;\n  contentHeight: number;\n  viewportWidth: number;\n  viewportHeight: number;\n  panelWidth?: number;\n}): {\n  left: number;\n  top: number;\n  maxHeight: number;\n  above: boolean;\n} {\n  const margin = ANNOTATION_REVIEW_MARGIN_PX;\n  const panelWidth = Math.min(\n    input.panelWidth ?? ANNOTATION_REVIEW_DIALOG_WIDTH_PX,\n    Math.max(1, input.viewportWidth - margin * 2),\n  );\n  const left = Math.min(\n    Math.max(margin, input.triggerLeft),\n    Math.max(margin, input.viewportWidth - panelWidth - margin),\n  );\n  const spaceBelow = input.viewportHeight - input.triggerBottom - margin;\n  const spaceAbove = input.triggerTop - margin;\n  const above = spaceBelow < Math.min(input.contentHeight, 200) && spaceAbove > spaceBelow;\n  const viewportBudget = Math.max(\n    ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX,\n    input.viewportHeight - margin * 2,\n  );\n  const available = Math.max(\n    Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget),\n    above ? spaceAbove : spaceBelow,\n  );\n  let maxHeight = Math.min(\n    Math.max(input.contentHeight, Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget)),\n    available,\n    Math.floor(input.viewportHeight * 0.7) || viewportBudget,\n    ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX,\n    viewportBudget,\n  );\n  let top = above\n    ? Math.max(margin, input.triggerTop - 8 - maxHeight)\n    : Math.min(\n        input.triggerBottom + 8,\n        Math.max(margin, input.viewportHeight - margin - maxHeight),\n      );\n  top = Math.max(margin, top);\n  maxHeight = Math.min(\n    maxHeight,\n    Math.max(ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX, input.viewportHeight - margin - top),\n  );\n  return { left, top, maxHeight, above };\n}\n"],"mappings":"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","names":[]}

package/dist/components/composer.d.ts

@@ -9,7 +9,7 @@ import type { PickerModelRow } from "../model-policy.js";
 import { OPEN_WORKSTREAM_CONTROL_EVENT } from "../workstream-control-event.js";
 export { OPEN_WORKSTREAM_CONTROL_EVENT };
 export type { ResponsiveBasis } from "../lib/composer-responsive-context.js";
-export type ComposerDelivery = Pick<ComposerState, "value" | "setValue" | "send" | "steer" | "sending" | "canSend" | "error" | "clearError">;
+export type ComposerDelivery = Pick<ComposerState, "value" | "setValue" | "send" | "steer" | "sending" | "canSend" | "error" | "clearError" | "annotations" | "requestAnnotationReview">;
 export type ComposerDraftState = Pick<ComposerState, "draftConflict" | "draftSaving" | "resolveDraftConflict" | "restoredResources" | "removeRestoredResource">;
 export type ComposerControlState = Pick<ComposerState, "pause" | "pausing" | "resume" | "resumeScope" | "resuming">;
 export type ComposerControlLinks = {
@@ -32,6 +32,7 @@ export type ChatComposerMessages = {
     sendAndResumeAriaLabel: string;
     sendTitle: string;
     sendAndResumeTitle: string;
+    annotationNotesRequired: string;
     workspacePaused: string;
     pausedHere: string;
     parentBlocker: string;
@@ -82,7 +83,7 @@ export type ChatComposerMessages = {
 };
 export declare const defaultChatComposerMessages: ChatComposerMessages;
 export type ComposerSubmitMode = "queue" | "steer";
-export type ComposerSubmitBlocker = "disabled" | "attachment" | "sending" | "command" | "empty" | null;
+export type ComposerSubmitBlocker = "disabled" | "attachment" | "sending" | "command" | "annotations" | "empty" | null;
 export type UseChatComposerControllerOptions = {
     delivery: ComposerDelivery;
     draft?: ComposerDraftState | undefined;
@@ -141,6 +142,7 @@ export declare function useChatComposerController({ delivery, draft, control, ef
         sendAndResumeAriaLabel: string;
         sendTitle: string;
         sendAndResumeTitle: string;
+        annotationNotesRequired: string;
         workspacePaused: string;
         pausedHere: string;
         parentBlocker: string;

package/dist/components/message-timeline.d.ts

@@ -9,6 +9,8 @@ export type MessageTimelineProps = {
     items?: TimelineItem[] | undefined;
     /** Current session status (reserved; tip "Working…" chrome removed for now). */
     status?: SessionStatus | null | undefined;
+    /** Host-owned controls beside Copy and the timestamp on settled message rows. */
+    renderMessageActions?: ((item: AgentMessageItem | UserMessageItem) => ReactNode) | undefined;
     /** Plug a markdown renderer for message bodies (e.g. streamdown). */
     renderMessageText?: ((text: string, item: AgentMessageItem | UserMessageItem) => ReactNode) | undefined;
     /** Drill into a spawned worker session. */
@@ -67,6 +69,10 @@ export type MessageTimelineProps = {
     autoFollow?: boolean | undefined;
     /** Capture a same-row text selection into the host's canonical composer draft. */
     onAnnotate?: ((annotation: DraftTimelineAnnotation) => void) | undefined;
+    /** Composer draft quotes currently attached to the next send. */
+    draftAnnotations?: readonly DraftTimelineAnnotation[] | undefined;
+    /** Open the composer review list for one numbered draft badge. */
+    onDraftAnnotationSelect?: ((id: string) => void) | undefined;
     /** Older durable history exists above the current window (see useSessionEvents). */
     hasOlder?: boolean | undefined;
     /** An older window is being fetched; shows the quiet top shimmer. */
@@ -103,7 +109,7 @@ export type MessageTimelineProps = {
  * cards, goal markers, and status transitions. Owns stick-to-bottom scrolling
  * with a "jump to latest" affordance when the reader scrolls back.
  */
-export declare function MessageTimeline({ events, items, status: _status, renderMessageText, onOpenSession, onMemoryClick, onReconnect, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, loadRetainedArtifact, loadVideoArtifactPlayback, computeLabel, turnSummary, autoFollow, onAnnotate, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react").JSX.Element;
+export declare function MessageTimeline({ events, items, status: _status, renderMessageActions, renderMessageText, onOpenSession, onMemoryClick, onReconnect, shouldRenderAuthNeeded, resolveProviderLogo, toolRegistry, loadRetainedScreenshot, loadRetainedArtifact, loadVideoArtifactPlayback, computeLabel, turnSummary, autoFollow, onAnnotate, draftAnnotations, onDraftAnnotationSelect, hasOlder, loadingOlder, onLoadOlder, onJumpToStart, loadingOldest, hasNewer, loadingNewer, onLoadNewer, onJumpToLatest, trailingState, emptyState, className, }: MessageTimelineProps): import("react").JSX.Element;
 /**
  * Settled turns lift the final agent answer out as a sibling group. Include it
  * in "Copy turn" when present so the chip copies the full assistant reply.
@@ -115,8 +121,9 @@ export declare function trailingAgentTextAfterTurn(group: TimelineGroup, next: T
  * landmark, notice). Exported so the component demo draws the EXACT same rows as
  * the live app — no forked bubble/goal markup.
  */
-export declare function TimelineRow({ item, renderMessageText, onReconnect, resolveProviderLogo, onOpenSession, loadVideoArtifactPlayback, }: {
+export declare function TimelineRow({ item, renderMessageActions, renderMessageText, onReconnect, resolveProviderLogo, onOpenSession, loadVideoArtifactPlayback, }: {
     item: TimelineItem;
+    renderMessageActions?: ((item: AgentMessageItem | UserMessageItem) => ReactNode) | undefined;
     renderMessageText?: ((text: string, item: AgentMessageItem | UserMessageItem) => ReactNode) | undefined;
     onReconnect?: ((item: AuthNeededItem) => void | Promise<void>) | undefined;
     resolveProviderLogo?: ((providerDomain: string) => string | null | undefined) | undefined;