@athenaintel/react 0.57.2 → 0.60.0

package/dist/composer/ComposerAttachedReferences.cjs

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("@assistant-ui/react");
+const format = require("../references/src/anchors/format.cjs");
+const attachable = require("../references/src/attachable.cjs");
+const lucideReact = require("lucide-react");
+const require$$0 = require("react");
+const threadIdContext = require("../threads/thread-id-context.cjs");
+const attachedReferences = require("./attached-references.cjs");
+const cnfast = require("cnfast");
+const KIND_NAME = {
+  asset: "Asset",
+  ontology_object: "Object",
+  external_url: "Web page"
+};
+function KindIcon({ reference }) {
+  const Icon = reference.referenced === "asset" ? lucideReact.FileTextIcon : reference.referenced === "ontology_object" ? lucideReact.BoxIcon : lucideReact.GlobeIcon;
+  return /* @__PURE__ */ jsxRuntime.jsx(Icon, { "aria-hidden": "true", className: "size-3 shrink-0 text-muted-foreground" });
+}
+function attachedReferenceChipText(reference) {
+  const label = attachable.attachableReferenceLabel(reference);
+  if (reference.referenced !== "asset" || !reference.anchor) return label;
+  const place = format.formatReferenceAnchor(reference.anchor, "short", reference.meta);
+  return place ? `${label} · ${place}` : label;
+}
+function ReferenceChip({
+  reference,
+  onRemove
+}) {
+  const text = attachedReferenceChipText(reference);
+  return /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "inline-flex max-w-full items-center gap-1 rounded-md border border-border bg-muted/60 py-0 pr-0.5 pl-1.5 font-medium text-foreground text-xs", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(KindIcon, { reference }),
+    /* @__PURE__ */ jsxRuntime.jsxs("span", { className: cnfast.cn("max-w-48 truncate", !onRemove && "pr-1"), children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "sr-only", children: [
+        KIND_NAME[reference.referenced],
+        ": "
+      ] }),
+      text
+    ] }),
+    onRemove ? /* @__PURE__ */ jsxRuntime.jsx(
+      "button",
+      {
+        type: "button",
+        className: "inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        "aria-label": `Remove ${text}`,
+        "data-attached-reference-remove": "",
+        onClick: onRemove,
+        children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.XIcon, { "aria-hidden": "true", className: "size-3" })
+      }
+    ) : null
+  ] });
+}
+const ComposerAttachedReferences = ({
+  threadId: threadIdProp,
+  onEmptied,
+  className
+}) => {
+  const providerThreadId = require$$0.useContext(threadIdContext.AthenaStatewireThreadIdContext);
+  const threadId = threadIdProp ?? providerThreadId;
+  const references = attachedReferences.usePendingAttachedReferences(threadId);
+  const listRef = require$$0.useRef(null);
+  if (references.length === 0) return null;
+  const remove = (reference, index) => {
+    attachedReferences.detachReferenceFromThread({ threadId, reference });
+    requestAnimationFrame(() => {
+      var _a;
+      const buttons = (_a = listRef.current) == null ? void 0 : _a.querySelectorAll(
+        "button[data-attached-reference-remove]"
+      );
+      const next = (buttons == null ? void 0 : buttons.length) ? buttons[Math.min(index, buttons.length - 1)] : void 0;
+      if (next) next.focus();
+      else onEmptied == null ? void 0 : onEmptied();
+    });
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      className: cnfast.cn("aui-composer-attached-references mx-3 mt-2 flex items-start", className),
+      "data-testid": "athena-attached-references",
+      children: /* @__PURE__ */ jsxRuntime.jsx(
+        "ul",
+        {
+          ref: listRef,
+          "aria-label": "Attached to this message",
+          className: "flex min-w-0 flex-1 flex-wrap gap-1.5",
+          children: references.map((reference, index) => {
+            const key = attachable.attachableReferenceKey(reference);
+            return /* @__PURE__ */ jsxRuntime.jsx("li", { className: "min-w-0", "data-attached-reference": key, children: /* @__PURE__ */ jsxRuntime.jsx(ReferenceChip, { reference, onRemove: () => remove(reference, index) }) }, key);
+          })
+        }
+      )
+    }
+  );
+};
+const MessageAttachedReferences = ({ className }) => {
+  const custom = react.useAuiState((s) => {
+    var _a;
+    return (_a = s.message.metadata) == null ? void 0 : _a.custom;
+  });
+  const references = require$$0.useMemo(() => attachable.readAttachedReferences(custom), [custom]);
+  if (references.length === 0) return null;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "ul",
+    {
+      "aria-label": "Attached to this message",
+      className: cnfast.cn("aui-message-attached-references flex flex-wrap justify-end gap-1.5", className),
+      "data-testid": "athena-message-attached-references",
+      children: references.map((reference) => {
+        const key = attachable.attachableReferenceKey(reference);
+        return /* @__PURE__ */ jsxRuntime.jsx("li", { className: "min-w-0", "data-attached-reference": key, children: /* @__PURE__ */ jsxRuntime.jsx(ReferenceChip, { reference }) }, key);
+      })
+    }
+  );
+};
+exports.ComposerAttachedReferences = ComposerAttachedReferences;
+exports.MessageAttachedReferences = MessageAttachedReferences;
+exports.attachedReferenceChipText = attachedReferenceChipText;
+//# sourceMappingURL=ComposerAttachedReferences.cjs.map

package/dist/composer/ComposerAttachedReferences.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerAttachedReferences.cjs","sources":["../../src/composer/ComposerAttachedReferences.tsx"],"sourcesContent":["import { useAuiState } from '@assistant-ui/react';\nimport { formatReferenceAnchor } from '@athenaintel/references/asset-links';\nimport {\n  type AttachableReference,\n  attachableReferenceKey,\n  attachableReferenceLabel,\n  readAttachedReferences as readMessageAttachedReferences,\n} from '@athenaintel/references/attachable';\nimport { BoxIcon, FileTextIcon, GlobeIcon, XIcon } from 'lucide-react';\nimport { type FC, useContext, useMemo, useRef } from 'react';\nimport { cn } from '../lib/utils';\nimport { AthenaStatewireThreadIdContext } from '../threads/thread-id-context';\nimport { detachReferenceFromThread, usePendingAttachedReferences } from './attached-references';\n\nconst KIND_NAME: Record<AttachableReference['referenced'], string> = {\n  asset: 'Asset',\n  ontology_object: 'Object',\n  external_url: 'Web page',\n};\n\nfunction KindIcon({ reference }: { reference: AttachableReference }) {\n  const Icon =\n    reference.referenced === 'asset'\n      ? FileTextIcon\n      : reference.referenced === 'ontology_object'\n        ? BoxIcon\n        : GlobeIcon;\n  return <Icon aria-hidden=\"true\" className=\"size-3 shrink-0 text-muted-foreground\" />;\n}\n\n/** What a chip reads: the label, and for an anchored asset the place (`p.5`, `B3:C7`, …). */\nexport function attachedReferenceChipText(reference: AttachableReference): string {\n  const label = attachableReferenceLabel(reference);\n  if (reference.referenced !== 'asset' || !reference.anchor) return label;\n  const place = formatReferenceAnchor(reference.anchor, 'short', reference.meta);\n  return place ? `${label} · ${place}` : label;\n}\n\nfunction ReferenceChip({\n  reference,\n  onRemove,\n}: {\n  reference: AttachableReference;\n  onRemove?: () => void;\n}) {\n  const text = attachedReferenceChipText(reference);\n  return (\n    <span className=\"inline-flex max-w-full items-center gap-1 rounded-md border border-border bg-muted/60 py-0 pr-0.5 pl-1.5 font-medium text-foreground text-xs\">\n      <KindIcon reference={reference} />\n      <span className={cn('max-w-48 truncate', !onRemove && 'pr-1')}>\n        <span className=\"sr-only\">{KIND_NAME[reference.referenced]}: </span>\n        {text}\n      </span>\n      {onRemove ? (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n          aria-label={`Remove ${text}`}\n          data-attached-reference-remove=\"\"\n          onClick={onRemove}\n        >\n          <XIcon aria-hidden=\"true\" className=\"size-3\" />\n        </button>\n      ) : null}\n    </span>\n  );\n}\n\nexport interface ComposerAttachedReferencesProps {\n  /** The conversation whose next message carries the references; defaults to the provider's. */\n  threadId?: string;\n  /** The last reference was removed: where focus goes next (the editor). */\n  onEmptied?: () => void;\n  className?: string;\n}\n\n/**\n * The references the next message carries (`useAttachToChat`), as removable chips above the\n * editor: each with its kind's icon, its label (and an anchored asset's place) and a labelled\n * remove button. Renders nothing while none are attached. Removing one hands focus to the chip\n * that took its place, else the one before it, else back to the editor (`onEmptied`).\n */\nexport const ComposerAttachedReferences: FC<ComposerAttachedReferencesProps> = ({\n  threadId: threadIdProp,\n  onEmptied,\n  className,\n}) => {\n  const providerThreadId = useContext(AthenaStatewireThreadIdContext);\n  const threadId = threadIdProp ?? providerThreadId;\n  const references = usePendingAttachedReferences(threadId);\n  const listRef = useRef<HTMLUListElement>(null);\n  if (references.length === 0) return null;\n\n  const remove = (reference: AttachableReference, index: number): void => {\n    detachReferenceFromThread({ threadId, reference });\n    // After React has painted the row without the chip (or unmounted it).\n    requestAnimationFrame(() => {\n      const buttons = listRef.current?.querySelectorAll<HTMLButtonElement>(\n        'button[data-attached-reference-remove]',\n      );\n      const next = buttons?.length ? buttons[Math.min(index, buttons.length - 1)] : undefined;\n      if (next) next.focus();\n      else onEmptied?.();\n    });\n  };\n\n  return (\n    <div\n      className={cn('aui-composer-attached-references mx-3 mt-2 flex items-start', className)}\n      data-testid=\"athena-attached-references\"\n    >\n      <ul\n        ref={listRef}\n        aria-label=\"Attached to this message\"\n        className=\"flex min-w-0 flex-1 flex-wrap gap-1.5\"\n      >\n        {references.map((reference, index) => {\n          const key = attachableReferenceKey(reference);\n          return (\n            <li key={key} className=\"min-w-0\" data-attached-reference={key}>\n              <ReferenceChip reference={reference} onRemove={() => remove(reference, index)} />\n            </li>\n          );\n        })}\n      </ul>\n    </div>\n  );\n};\n\n/**\n * The references a sent user message carried (`message.metadata.custom.attachedReferences`, as\n * agora kept them), as read-only chips above its bubble. Renders nothing for a message that\n * attached nothing. Use it inside a message (`MessagePrimitive.Root`).\n */\nexport const MessageAttachedReferences: FC<{ className?: string }> = ({ className }) => {\n  const custom = useAuiState((s) => s.message.metadata?.custom);\n  const references = useMemo(() => readMessageAttachedReferences(custom), [custom]);\n  if (references.length === 0) return null;\n  return (\n    <ul\n      aria-label=\"Attached to this message\"\n      className={cn('aui-message-attached-references flex flex-wrap justify-end gap-1.5', className)}\n      data-testid=\"athena-message-attached-references\"\n    >\n      {references.map((reference) => {\n        const key = attachableReferenceKey(reference);\n        return (\n          <li key={key} className=\"min-w-0\" data-attached-reference={key}>\n            <ReferenceChip reference={reference} />\n          </li>\n        );\n      })}\n    </ul>\n  );\n};\n"],"names":["FileTextIcon","BoxIcon","GlobeIcon","jsx","attachableReferenceLabel","formatReferenceAnchor","jsxs","cn","XIcon","useContext","AthenaStatewireThreadIdContext","usePendingAttachedReferences","useRef","detachReferenceFromThread","attachableReferenceKey","useAuiState","useMemo","readMessageAttachedReferences"],"mappings":"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"}

package/dist/composer/ComposerAttachedReferences.d.ts

@@ -0,0 +1,26 @@
+import { type AttachableReference } from '../references/src/attachable';
+import { type FC } from 'react';
+/** What a chip reads: the label, and for an anchored asset the place (`p.5`, `B3:C7`, …). */
+export declare function attachedReferenceChipText(reference: AttachableReference): string;
+export interface ComposerAttachedReferencesProps {
+    /** The conversation whose next message carries the references; defaults to the provider's. */
+    threadId?: string;
+    /** The last reference was removed: where focus goes next (the editor). */
+    onEmptied?: () => void;
+    className?: string;
+}
+/**
+ * The references the next message carries (`useAttachToChat`), as removable chips above the
+ * editor: each with its kind's icon, its label (and an anchored asset's place) and a labelled
+ * remove button. Renders nothing while none are attached. Removing one hands focus to the chip
+ * that took its place, else the one before it, else back to the editor (`onEmptied`).
+ */
+export declare const ComposerAttachedReferences: FC<ComposerAttachedReferencesProps>;
+/**
+ * The references a sent user message carried (`message.metadata.custom.attachedReferences`, as
+ * agora kept them), as read-only chips above its bubble. Renders nothing for a message that
+ * attached nothing. Use it inside a message (`MessagePrimitive.Root`).
+ */
+export declare const MessageAttachedReferences: FC<{
+    className?: string;
+}>;

package/dist/composer/ComposerAttachedReferences.js

@@ -0,0 +1,119 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useAuiState } from "@assistant-ui/react";
+import { formatReferenceAnchor } from "../references/src/anchors/format.js";
+import { attachableReferenceKey, readAttachedReferences, attachableReferenceLabel } from "../references/src/attachable.js";
+import { XIcon, FileTextIcon, BoxIcon, GlobeIcon } from "lucide-react";
+import { useContext, useRef, useMemo } from "react";
+import { AthenaStatewireThreadIdContext } from "../threads/thread-id-context.js";
+import { usePendingAttachedReferences, detachReferenceFromThread } from "./attached-references.js";
+import { cn } from "cnfast";
+const KIND_NAME = {
+  asset: "Asset",
+  ontology_object: "Object",
+  external_url: "Web page"
+};
+function KindIcon({ reference }) {
+  const Icon = reference.referenced === "asset" ? FileTextIcon : reference.referenced === "ontology_object" ? BoxIcon : GlobeIcon;
+  return /* @__PURE__ */ jsx(Icon, { "aria-hidden": "true", className: "size-3 shrink-0 text-muted-foreground" });
+}
+function attachedReferenceChipText(reference) {
+  const label = attachableReferenceLabel(reference);
+  if (reference.referenced !== "asset" || !reference.anchor) return label;
+  const place = formatReferenceAnchor(reference.anchor, "short", reference.meta);
+  return place ? `${label} · ${place}` : label;
+}
+function ReferenceChip({
+  reference,
+  onRemove
+}) {
+  const text = attachedReferenceChipText(reference);
+  return /* @__PURE__ */ jsxs("span", { className: "inline-flex max-w-full items-center gap-1 rounded-md border border-border bg-muted/60 py-0 pr-0.5 pl-1.5 font-medium text-foreground text-xs", children: [
+    /* @__PURE__ */ jsx(KindIcon, { reference }),
+    /* @__PURE__ */ jsxs("span", { className: cn("max-w-48 truncate", !onRemove && "pr-1"), children: [
+      /* @__PURE__ */ jsxs("span", { className: "sr-only", children: [
+        KIND_NAME[reference.referenced],
+        ": "
+      ] }),
+      text
+    ] }),
+    onRemove ? /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        className: "inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        "aria-label": `Remove ${text}`,
+        "data-attached-reference-remove": "",
+        onClick: onRemove,
+        children: /* @__PURE__ */ jsx(XIcon, { "aria-hidden": "true", className: "size-3" })
+      }
+    ) : null
+  ] });
+}
+const ComposerAttachedReferences = ({
+  threadId: threadIdProp,
+  onEmptied,
+  className
+}) => {
+  const providerThreadId = useContext(AthenaStatewireThreadIdContext);
+  const threadId = threadIdProp ?? providerThreadId;
+  const references = usePendingAttachedReferences(threadId);
+  const listRef = useRef(null);
+  if (references.length === 0) return null;
+  const remove = (reference, index) => {
+    detachReferenceFromThread({ threadId, reference });
+    requestAnimationFrame(() => {
+      var _a;
+      const buttons = (_a = listRef.current) == null ? void 0 : _a.querySelectorAll(
+        "button[data-attached-reference-remove]"
+      );
+      const next = (buttons == null ? void 0 : buttons.length) ? buttons[Math.min(index, buttons.length - 1)] : void 0;
+      if (next) next.focus();
+      else onEmptied == null ? void 0 : onEmptied();
+    });
+  };
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: cn("aui-composer-attached-references mx-3 mt-2 flex items-start", className),
+      "data-testid": "athena-attached-references",
+      children: /* @__PURE__ */ jsx(
+        "ul",
+        {
+          ref: listRef,
+          "aria-label": "Attached to this message",
+          className: "flex min-w-0 flex-1 flex-wrap gap-1.5",
+          children: references.map((reference, index) => {
+            const key = attachableReferenceKey(reference);
+            return /* @__PURE__ */ jsx("li", { className: "min-w-0", "data-attached-reference": key, children: /* @__PURE__ */ jsx(ReferenceChip, { reference, onRemove: () => remove(reference, index) }) }, key);
+          })
+        }
+      )
+    }
+  );
+};
+const MessageAttachedReferences = ({ className }) => {
+  const custom = useAuiState((s) => {
+    var _a;
+    return (_a = s.message.metadata) == null ? void 0 : _a.custom;
+  });
+  const references = useMemo(() => readAttachedReferences(custom), [custom]);
+  if (references.length === 0) return null;
+  return /* @__PURE__ */ jsx(
+    "ul",
+    {
+      "aria-label": "Attached to this message",
+      className: cn("aui-message-attached-references flex flex-wrap justify-end gap-1.5", className),
+      "data-testid": "athena-message-attached-references",
+      children: references.map((reference) => {
+        const key = attachableReferenceKey(reference);
+        return /* @__PURE__ */ jsx("li", { className: "min-w-0", "data-attached-reference": key, children: /* @__PURE__ */ jsx(ReferenceChip, { reference }) }, key);
+      })
+    }
+  );
+};
+export {
+  ComposerAttachedReferences,
+  MessageAttachedReferences,
+  attachedReferenceChipText
+};
+//# sourceMappingURL=ComposerAttachedReferences.js.map

package/dist/composer/ComposerAttachedReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerAttachedReferences.js","sources":["../../src/composer/ComposerAttachedReferences.tsx"],"sourcesContent":["import { useAuiState } from '@assistant-ui/react';\nimport { formatReferenceAnchor } from '@athenaintel/references/asset-links';\nimport {\n  type AttachableReference,\n  attachableReferenceKey,\n  attachableReferenceLabel,\n  readAttachedReferences as readMessageAttachedReferences,\n} from '@athenaintel/references/attachable';\nimport { BoxIcon, FileTextIcon, GlobeIcon, XIcon } from 'lucide-react';\nimport { type FC, useContext, useMemo, useRef } from 'react';\nimport { cn } from '../lib/utils';\nimport { AthenaStatewireThreadIdContext } from '../threads/thread-id-context';\nimport { detachReferenceFromThread, usePendingAttachedReferences } from './attached-references';\n\nconst KIND_NAME: Record<AttachableReference['referenced'], string> = {\n  asset: 'Asset',\n  ontology_object: 'Object',\n  external_url: 'Web page',\n};\n\nfunction KindIcon({ reference }: { reference: AttachableReference }) {\n  const Icon =\n    reference.referenced === 'asset'\n      ? FileTextIcon\n      : reference.referenced === 'ontology_object'\n        ? BoxIcon\n        : GlobeIcon;\n  return <Icon aria-hidden=\"true\" className=\"size-3 shrink-0 text-muted-foreground\" />;\n}\n\n/** What a chip reads: the label, and for an anchored asset the place (`p.5`, `B3:C7`, …). */\nexport function attachedReferenceChipText(reference: AttachableReference): string {\n  const label = attachableReferenceLabel(reference);\n  if (reference.referenced !== 'asset' || !reference.anchor) return label;\n  const place = formatReferenceAnchor(reference.anchor, 'short', reference.meta);\n  return place ? `${label} · ${place}` : label;\n}\n\nfunction ReferenceChip({\n  reference,\n  onRemove,\n}: {\n  reference: AttachableReference;\n  onRemove?: () => void;\n}) {\n  const text = attachedReferenceChipText(reference);\n  return (\n    <span className=\"inline-flex max-w-full items-center gap-1 rounded-md border border-border bg-muted/60 py-0 pr-0.5 pl-1.5 font-medium text-foreground text-xs\">\n      <KindIcon reference={reference} />\n      <span className={cn('max-w-48 truncate', !onRemove && 'pr-1')}>\n        <span className=\"sr-only\">{KIND_NAME[reference.referenced]}: </span>\n        {text}\n      </span>\n      {onRemove ? (\n        <button\n          type=\"button\"\n          className=\"inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n          aria-label={`Remove ${text}`}\n          data-attached-reference-remove=\"\"\n          onClick={onRemove}\n        >\n          <XIcon aria-hidden=\"true\" className=\"size-3\" />\n        </button>\n      ) : null}\n    </span>\n  );\n}\n\nexport interface ComposerAttachedReferencesProps {\n  /** The conversation whose next message carries the references; defaults to the provider's. */\n  threadId?: string;\n  /** The last reference was removed: where focus goes next (the editor). */\n  onEmptied?: () => void;\n  className?: string;\n}\n\n/**\n * The references the next message carries (`useAttachToChat`), as removable chips above the\n * editor: each with its kind's icon, its label (and an anchored asset's place) and a labelled\n * remove button. Renders nothing while none are attached. Removing one hands focus to the chip\n * that took its place, else the one before it, else back to the editor (`onEmptied`).\n */\nexport const ComposerAttachedReferences: FC<ComposerAttachedReferencesProps> = ({\n  threadId: threadIdProp,\n  onEmptied,\n  className,\n}) => {\n  const providerThreadId = useContext(AthenaStatewireThreadIdContext);\n  const threadId = threadIdProp ?? providerThreadId;\n  const references = usePendingAttachedReferences(threadId);\n  const listRef = useRef<HTMLUListElement>(null);\n  if (references.length === 0) return null;\n\n  const remove = (reference: AttachableReference, index: number): void => {\n    detachReferenceFromThread({ threadId, reference });\n    // After React has painted the row without the chip (or unmounted it).\n    requestAnimationFrame(() => {\n      const buttons = listRef.current?.querySelectorAll<HTMLButtonElement>(\n        'button[data-attached-reference-remove]',\n      );\n      const next = buttons?.length ? buttons[Math.min(index, buttons.length - 1)] : undefined;\n      if (next) next.focus();\n      else onEmptied?.();\n    });\n  };\n\n  return (\n    <div\n      className={cn('aui-composer-attached-references mx-3 mt-2 flex items-start', className)}\n      data-testid=\"athena-attached-references\"\n    >\n      <ul\n        ref={listRef}\n        aria-label=\"Attached to this message\"\n        className=\"flex min-w-0 flex-1 flex-wrap gap-1.5\"\n      >\n        {references.map((reference, index) => {\n          const key = attachableReferenceKey(reference);\n          return (\n            <li key={key} className=\"min-w-0\" data-attached-reference={key}>\n              <ReferenceChip reference={reference} onRemove={() => remove(reference, index)} />\n            </li>\n          );\n        })}\n      </ul>\n    </div>\n  );\n};\n\n/**\n * The references a sent user message carried (`message.metadata.custom.attachedReferences`, as\n * agora kept them), as read-only chips above its bubble. Renders nothing for a message that\n * attached nothing. Use it inside a message (`MessagePrimitive.Root`).\n */\nexport const MessageAttachedReferences: FC<{ className?: string }> = ({ className }) => {\n  const custom = useAuiState((s) => s.message.metadata?.custom);\n  const references = useMemo(() => readMessageAttachedReferences(custom), [custom]);\n  if (references.length === 0) return null;\n  return (\n    <ul\n      aria-label=\"Attached to this message\"\n      className={cn('aui-message-attached-references flex flex-wrap justify-end gap-1.5', className)}\n      data-testid=\"athena-message-attached-references\"\n    >\n      {references.map((reference) => {\n        const key = attachableReferenceKey(reference);\n        return (\n          <li key={key} className=\"min-w-0\" data-attached-reference={key}>\n            <ReferenceChip reference={reference} />\n          </li>\n        );\n      })}\n    </ul>\n  );\n};\n"],"names":["readMessageAttachedReferences"],"mappings":"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"}

package/dist/composer/ComposerNamedAgents.cjs

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const namedAgents = require("../agent-runtime/src/named-agents.cjs");
+const lucideReact = require("lucide-react");
+const require$$0 = require("react");
+const cnfast = require("cnfast");
+const ComposerNamedAgents = ({
+  threadId,
+  onEmptied,
+  className
+}) => {
+  const agents = namedAgents.useDeepAgentNamedAgents(threadId);
+  const listRef = require$$0.useRef(null);
+  if (agents.length === 0) return null;
+  const remove = (agent, index) => {
+    namedAgents.removeDeepAgentNamedAgent({ threadId, ref: agent.ref });
+    requestAnimationFrame(() => {
+      var _a;
+      const buttons = (_a = listRef.current) == null ? void 0 : _a.querySelectorAll(
+        "button[data-named-agent-remove]"
+      );
+      const next = (buttons == null ? void 0 : buttons.length) ? buttons[Math.min(index, buttons.length - 1)] : void 0;
+      if (next) next.focus();
+      else onEmptied == null ? void 0 : onEmptied();
+    });
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: cnfast.cn("aui-composer-named-agents mx-3 mt-2 flex items-start gap-2", className),
+      "data-testid": "athena-named-agents",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { "aria-hidden": "true", className: "py-0.5 text-muted-foreground text-xs", children: "To" }),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "ul",
+          {
+            ref: listRef,
+            "aria-label": "Agents this message goes to",
+            className: "flex min-w-0 flex-1 flex-wrap gap-1.5",
+            children: agents.map((agent, index) => /* @__PURE__ */ jsxRuntime.jsx("li", { className: "min-w-0", "data-named-agent": agent.ref, children: /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "inline-flex max-w-full items-center gap-1 rounded-md border border-border bg-muted/60 py-0 pr-0.5 pl-1.5 font-medium text-foreground text-xs", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(lucideReact.BotIcon, { "aria-hidden": "true", className: "size-3 shrink-0 text-muted-foreground" }),
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "max-w-48 truncate", children: agent.name }),
+              /* @__PURE__ */ jsxRuntime.jsx(
+                "button",
+                {
+                  type: "button",
+                  className: "inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+                  "aria-label": `Remove ${agent.name}`,
+                  "data-named-agent-remove": "",
+                  onClick: () => remove(agent, index),
+                  children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.XIcon, { "aria-hidden": "true", className: "size-3" })
+                }
+              )
+            ] }) }, agent.ref))
+          }
+        )
+      ]
+    }
+  );
+};
+exports.ComposerNamedAgents = ComposerNamedAgents;
+//# sourceMappingURL=ComposerNamedAgents.cjs.map

package/dist/composer/ComposerNamedAgents.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerNamedAgents.cjs","sources":["../../src/composer/ComposerNamedAgents.tsx"],"sourcesContent":["import {\n  type DeepAgentNamedAgent,\n  removeDeepAgentNamedAgent,\n  useDeepAgentNamedAgents,\n} from '@athenaintel/agent-runtime/named-agents';\nimport { BotIcon, XIcon } from 'lucide-react';\nimport { type FC, useRef } from 'react';\nimport { cn } from '../lib/utils';\n\nexport interface ComposerNamedAgentsProps {\n  /** The conversation whose next message the chips name agents for. */\n  threadId: string;\n  /** The last named agent was removed: where focus goes next (the editor). */\n  onEmptied?: () => void;\n  className?: string;\n}\n\n/**\n * The composer's To line (identity v7 D13), as Olympus's composer shows it: the agents the person\n * named from the `@` menu's Agents section, in the order named, each answering the message in its\n * own turn and each with a labelled remove button. They stay for every message until the person\n * changes them. Renders nothing while none are named. Removing an agent hands focus to the chip that\n * took its place, else the one before it, else back to the editor (`onEmptied`).\n */\nexport const ComposerNamedAgents: FC<ComposerNamedAgentsProps> = ({\n  threadId,\n  onEmptied,\n  className,\n}) => {\n  const agents = useDeepAgentNamedAgents(threadId);\n  const listRef = useRef<HTMLUListElement>(null);\n  if (agents.length === 0) return null;\n\n  const remove = (agent: DeepAgentNamedAgent, index: number): void => {\n    removeDeepAgentNamedAgent({ threadId, ref: agent.ref });\n    // After React has painted the row without the chip (or unmounted it).\n    requestAnimationFrame(() => {\n      const buttons = listRef.current?.querySelectorAll<HTMLButtonElement>(\n        'button[data-named-agent-remove]',\n      );\n      const next = buttons?.length ? buttons[Math.min(index, buttons.length - 1)] : undefined;\n      if (next) next.focus();\n      else onEmptied?.();\n    });\n  };\n\n  return (\n    <div\n      className={cn('aui-composer-named-agents mx-3 mt-2 flex items-start gap-2', className)}\n      data-testid=\"athena-named-agents\"\n    >\n      <span aria-hidden=\"true\" className=\"py-0.5 text-muted-foreground text-xs\">\n        To\n      </span>\n      <ul\n        ref={listRef}\n        aria-label=\"Agents this message goes to\"\n        className=\"flex min-w-0 flex-1 flex-wrap gap-1.5\"\n      >\n        {agents.map((agent, index) => (\n          <li key={agent.ref} className=\"min-w-0\" data-named-agent={agent.ref}>\n            <span className=\"inline-flex max-w-full items-center gap-1 rounded-md border border-border bg-muted/60 py-0 pr-0.5 pl-1.5 font-medium text-foreground text-xs\">\n              <BotIcon aria-hidden=\"true\" className=\"size-3 shrink-0 text-muted-foreground\" />\n              <span className=\"max-w-48 truncate\">{agent.name}</span>\n              <button\n                type=\"button\"\n                className=\"inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n                aria-label={`Remove ${agent.name}`}\n                data-named-agent-remove=\"\"\n                onClick={() => remove(agent, index)}\n              >\n                <XIcon aria-hidden=\"true\" className=\"size-3\" />\n              </button>\n            </span>\n          </li>\n        ))}\n      </ul>\n    </div>\n  );\n};\n"],"names":["useDeepAgentNamedAgents","useRef","removeDeepAgentNamedAgent","jsxs","cn","jsx","BotIcon","XIcon"],"mappings":";;;;;;;AAwBO,MAAM,sBAAoD,CAAC;AAAA,EAChE;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,SAASA,YAAAA,wBAAwB,QAAQ;AAC/C,QAAM,UAAUC,WAAAA,OAAyB,IAAI;AAC7C,MAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,QAAM,SAAS,CAAC,OAA4B,UAAwB;AAClEC,gBAAAA,0BAA0B,EAAE,UAAU,KAAK,MAAM,KAAK;AAEtD,0BAAsB,MAAM;;AAC1B,YAAM,WAAU,aAAQ,YAAR,mBAAiB;AAAA,QAC/B;AAAA;AAEF,YAAM,QAAO,mCAAS,UAAS,QAAQ,KAAK,IAAI,OAAO,QAAQ,SAAS,CAAC,CAAC,IAAI;AAC9E,UAAI,WAAW,MAAA;AAAA,UACV;AAAA,IACP,CAAC;AAAA,EACH;AAEA,SACEC,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,OAAAA,GAAG,8DAA8D,SAAS;AAAA,MACrF,eAAY;AAAA,MAEZ,UAAA;AAAA,QAAAC,+BAAC,QAAA,EAAK,eAAY,QAAO,WAAU,wCAAuC,UAAA,MAE1E;AAAA,QACAA,2BAAAA;AAAAA,UAAC;AAAA,UAAA;AAAA,YACC,KAAK;AAAA,YACL,cAAW;AAAA,YACX,WAAU;AAAA,YAET,UAAA,OAAO,IAAI,CAAC,OAAO,UAClBA,2BAAAA,IAAC,MAAA,EAAmB,WAAU,WAAU,oBAAkB,MAAM,KAC9D,UAAAF,2BAAAA,KAAC,QAAA,EAAK,WAAU,gJACd,UAAA;AAAA,cAAAE,2BAAAA,IAACC,YAAAA,SAAA,EAAQ,eAAY,QAAO,WAAU,yCAAwC;AAAA,cAC9ED,2BAAAA,IAAC,QAAA,EAAK,WAAU,qBAAqB,gBAAM,MAAK;AAAA,cAChDA,2BAAAA;AAAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,MAAK;AAAA,kBACL,WAAU;AAAA,kBACV,cAAY,UAAU,MAAM,IAAI;AAAA,kBAChC,2BAAwB;AAAA,kBACxB,SAAS,MAAM,OAAO,OAAO,KAAK;AAAA,kBAElC,UAAAA,2BAAAA,IAACE,mBAAA,EAAM,eAAY,QAAO,WAAU,SAAA,CAAS;AAAA,gBAAA;AAAA,cAAA;AAAA,YAC/C,GACF,EAAA,GAbO,MAAM,GAcf,CACD;AAAA,UAAA;AAAA,QAAA;AAAA,MACH;AAAA,IAAA;AAAA,EAAA;AAGN;;"}

package/dist/composer/ComposerNamedAgents.d.ts

@@ -0,0 +1,16 @@
+import { type FC } from 'react';
+export interface ComposerNamedAgentsProps {
+    /** The conversation whose next message the chips name agents for. */
+    threadId: string;
+    /** The last named agent was removed: where focus goes next (the editor). */
+    onEmptied?: () => void;
+    className?: string;
+}
+/**
+ * The composer's To line (identity v7 D13), as Olympus's composer shows it: the agents the person
+ * named from the `@` menu's Agents section, in the order named, each answering the message in its
+ * own turn and each with a labelled remove button. They stay for every message until the person
+ * changes them. Renders nothing while none are named. Removing an agent hands focus to the chip that
+ * took its place, else the one before it, else back to the editor (`onEmptied`).
+ */
+export declare const ComposerNamedAgents: FC<ComposerNamedAgentsProps>;

package/dist/composer/ComposerNamedAgents.js

@@ -0,0 +1,63 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useDeepAgentNamedAgents, removeDeepAgentNamedAgent } from "../agent-runtime/src/named-agents.js";
+import { BotIcon, XIcon } from "lucide-react";
+import { useRef } from "react";
+import { cn } from "cnfast";
+const ComposerNamedAgents = ({
+  threadId,
+  onEmptied,
+  className
+}) => {
+  const agents = useDeepAgentNamedAgents(threadId);
+  const listRef = useRef(null);
+  if (agents.length === 0) return null;
+  const remove = (agent, index) => {
+    removeDeepAgentNamedAgent({ threadId, ref: agent.ref });
+    requestAnimationFrame(() => {
+      var _a;
+      const buttons = (_a = listRef.current) == null ? void 0 : _a.querySelectorAll(
+        "button[data-named-agent-remove]"
+      );
+      const next = (buttons == null ? void 0 : buttons.length) ? buttons[Math.min(index, buttons.length - 1)] : void 0;
+      if (next) next.focus();
+      else onEmptied == null ? void 0 : onEmptied();
+    });
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn("aui-composer-named-agents mx-3 mt-2 flex items-start gap-2", className),
+      "data-testid": "athena-named-agents",
+      children: [
+        /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: "py-0.5 text-muted-foreground text-xs", children: "To" }),
+        /* @__PURE__ */ jsx(
+          "ul",
+          {
+            ref: listRef,
+            "aria-label": "Agents this message goes to",
+            className: "flex min-w-0 flex-1 flex-wrap gap-1.5",
+            children: agents.map((agent, index) => /* @__PURE__ */ jsx("li", { className: "min-w-0", "data-named-agent": agent.ref, children: /* @__PURE__ */ jsxs("span", { className: "inline-flex max-w-full items-center gap-1 rounded-md border border-border bg-muted/60 py-0 pr-0.5 pl-1.5 font-medium text-foreground text-xs", children: [
+              /* @__PURE__ */ jsx(BotIcon, { "aria-hidden": "true", className: "size-3 shrink-0 text-muted-foreground" }),
+              /* @__PURE__ */ jsx("span", { className: "max-w-48 truncate", children: agent.name }),
+              /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  className: "inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+                  "aria-label": `Remove ${agent.name}`,
+                  "data-named-agent-remove": "",
+                  onClick: () => remove(agent, index),
+                  children: /* @__PURE__ */ jsx(XIcon, { "aria-hidden": "true", className: "size-3" })
+                }
+              )
+            ] }) }, agent.ref))
+          }
+        )
+      ]
+    }
+  );
+};
+export {
+  ComposerNamedAgents
+};
+//# sourceMappingURL=ComposerNamedAgents.js.map

package/dist/composer/ComposerNamedAgents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerNamedAgents.js","sources":["../../src/composer/ComposerNamedAgents.tsx"],"sourcesContent":["import {\n  type DeepAgentNamedAgent,\n  removeDeepAgentNamedAgent,\n  useDeepAgentNamedAgents,\n} from '@athenaintel/agent-runtime/named-agents';\nimport { BotIcon, XIcon } from 'lucide-react';\nimport { type FC, useRef } from 'react';\nimport { cn } from '../lib/utils';\n\nexport interface ComposerNamedAgentsProps {\n  /** The conversation whose next message the chips name agents for. */\n  threadId: string;\n  /** The last named agent was removed: where focus goes next (the editor). */\n  onEmptied?: () => void;\n  className?: string;\n}\n\n/**\n * The composer's To line (identity v7 D13), as Olympus's composer shows it: the agents the person\n * named from the `@` menu's Agents section, in the order named, each answering the message in its\n * own turn and each with a labelled remove button. They stay for every message until the person\n * changes them. Renders nothing while none are named. Removing an agent hands focus to the chip that\n * took its place, else the one before it, else back to the editor (`onEmptied`).\n */\nexport const ComposerNamedAgents: FC<ComposerNamedAgentsProps> = ({\n  threadId,\n  onEmptied,\n  className,\n}) => {\n  const agents = useDeepAgentNamedAgents(threadId);\n  const listRef = useRef<HTMLUListElement>(null);\n  if (agents.length === 0) return null;\n\n  const remove = (agent: DeepAgentNamedAgent, index: number): void => {\n    removeDeepAgentNamedAgent({ threadId, ref: agent.ref });\n    // After React has painted the row without the chip (or unmounted it).\n    requestAnimationFrame(() => {\n      const buttons = listRef.current?.querySelectorAll<HTMLButtonElement>(\n        'button[data-named-agent-remove]',\n      );\n      const next = buttons?.length ? buttons[Math.min(index, buttons.length - 1)] : undefined;\n      if (next) next.focus();\n      else onEmptied?.();\n    });\n  };\n\n  return (\n    <div\n      className={cn('aui-composer-named-agents mx-3 mt-2 flex items-start gap-2', className)}\n      data-testid=\"athena-named-agents\"\n    >\n      <span aria-hidden=\"true\" className=\"py-0.5 text-muted-foreground text-xs\">\n        To\n      </span>\n      <ul\n        ref={listRef}\n        aria-label=\"Agents this message goes to\"\n        className=\"flex min-w-0 flex-1 flex-wrap gap-1.5\"\n      >\n        {agents.map((agent, index) => (\n          <li key={agent.ref} className=\"min-w-0\" data-named-agent={agent.ref}>\n            <span className=\"inline-flex max-w-full items-center gap-1 rounded-md border border-border bg-muted/60 py-0 pr-0.5 pl-1.5 font-medium text-foreground text-xs\">\n              <BotIcon aria-hidden=\"true\" className=\"size-3 shrink-0 text-muted-foreground\" />\n              <span className=\"max-w-48 truncate\">{agent.name}</span>\n              <button\n                type=\"button\"\n                className=\"inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n                aria-label={`Remove ${agent.name}`}\n                data-named-agent-remove=\"\"\n                onClick={() => remove(agent, index)}\n              >\n                <XIcon aria-hidden=\"true\" className=\"size-3\" />\n              </button>\n            </span>\n          </li>\n        ))}\n      </ul>\n    </div>\n  );\n};\n"],"names":[],"mappings":";;;;;AAwBO,MAAM,sBAAoD,CAAC;AAAA,EAChE;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,SAAS,wBAAwB,QAAQ;AAC/C,QAAM,UAAU,OAAyB,IAAI;AAC7C,MAAI,OAAO,WAAW,EAAG,QAAO;AAEhC,QAAM,SAAS,CAAC,OAA4B,UAAwB;AAClE,8BAA0B,EAAE,UAAU,KAAK,MAAM,KAAK;AAEtD,0BAAsB,MAAM;;AAC1B,YAAM,WAAU,aAAQ,YAAR,mBAAiB;AAAA,QAC/B;AAAA;AAEF,YAAM,QAAO,mCAAS,UAAS,QAAQ,KAAK,IAAI,OAAO,QAAQ,SAAS,CAAC,CAAC,IAAI;AAC9E,UAAI,WAAW,MAAA;AAAA,UACV;AAAA,IACP,CAAC;AAAA,EACH;AAEA,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAW,GAAG,8DAA8D,SAAS;AAAA,MACrF,eAAY;AAAA,MAEZ,UAAA;AAAA,QAAA,oBAAC,QAAA,EAAK,eAAY,QAAO,WAAU,wCAAuC,UAAA,MAE1E;AAAA,QACA;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,KAAK;AAAA,YACL,cAAW;AAAA,YACX,WAAU;AAAA,YAET,UAAA,OAAO,IAAI,CAAC,OAAO,UAClB,oBAAC,MAAA,EAAmB,WAAU,WAAU,oBAAkB,MAAM,KAC9D,UAAA,qBAAC,QAAA,EAAK,WAAU,gJACd,UAAA;AAAA,cAAA,oBAAC,SAAA,EAAQ,eAAY,QAAO,WAAU,yCAAwC;AAAA,cAC9E,oBAAC,QAAA,EAAK,WAAU,qBAAqB,gBAAM,MAAK;AAAA,cAChD;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,MAAK;AAAA,kBACL,WAAU;AAAA,kBACV,cAAY,UAAU,MAAM,IAAI;AAAA,kBAChC,2BAAwB;AAAA,kBACxB,SAAS,MAAM,OAAO,OAAO,KAAK;AAAA,kBAElC,UAAA,oBAAC,OAAA,EAAM,eAAY,QAAO,WAAU,SAAA,CAAS;AAAA,gBAAA;AAAA,cAAA;AAAA,YAC/C,GACF,EAAA,GAbO,MAAM,GAcf,CACD;AAAA,UAAA;AAAA,QAAA;AAAA,MACH;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/composer/attached-references.cjs

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const attachable = require("../references/src/attachable.cjs");
+const require$$0 = require("react");
+const EMPTY = Object.freeze([]);
+const pending = /* @__PURE__ */ new Map();
+const listeners = /* @__PURE__ */ new Set();
+let attachedForIdentity = null;
+function notify() {
+  for (const listener of [...listeners]) listener();
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function setPending(threadId, references) {
+  if (references.length === 0) pending.delete(threadId);
+  else pending.set(threadId, Object.freeze([...references]));
+  notify();
+}
+function attachReferenceToThread({
+  threadId,
+  reference
+}) {
+  if (!threadId) return { attached: false, reason: "no_thread" };
+  const normalized = attachable.normalizeAttachableReference(reference);
+  if (normalized === null) return { attached: false, reason: "invalid_reference" };
+  const key = attachable.attachableReferenceKey(normalized);
+  const current = pending.get(threadId) ?? EMPTY;
+  const index = current.findIndex((entry) => attachable.attachableReferenceKey(entry) === key);
+  if (index >= 0) {
+    setPending(
+      threadId,
+      current.map((entry, position) => position === index ? normalized : entry)
+    );
+    return { attached: true, reference: normalized, duplicate: true };
+  }
+  if (current.length >= attachable.MAX_ATTACHED_REFERENCES) return { attached: false, reason: "too_many" };
+  setPending(threadId, [...current, normalized]);
+  return { attached: true, reference: normalized, duplicate: false };
+}
+function detachReferenceFromThread({
+  threadId,
+  reference
+}) {
+  if (!threadId) return;
+  const current = pending.get(threadId);
+  if (!current) return;
+  const key = attachable.attachableReferenceKey(reference);
+  const kept = current.filter((entry) => attachable.attachableReferenceKey(entry) !== key);
+  if (kept.length !== current.length) setPending(threadId, kept);
+}
+function clearAttachedReferences(threadId) {
+  if (!threadId || !pending.has(threadId)) return;
+  setPending(threadId, EMPTY);
+}
+function readPendingAttachedReferences(threadId) {
+  return (threadId ? pending.get(threadId) : void 0) ?? EMPTY;
+}
+function usePendingAttachedReferences(threadId) {
+  const read = require$$0.useCallback(() => readPendingAttachedReferences(threadId), [threadId]);
+  return require$$0.useSyncExternalStore(subscribe, read, read);
+}
+function forgetAllAttachedReferences() {
+  pending.clear();
+  stagedForSend.clear();
+  sentWithText.clear();
+  notify();
+}
+function keepAttachedReferencesForIdentity(identity) {
+  if (attachedForIdentity !== null && attachedForIdentity !== identity) {
+    forgetAllAttachedReferences();
+  }
+  attachedForIdentity = identity;
+}
+const ATTACHED_REFERENCES_STAGED_TTL_MS = 1e4;
+const stagedForSend = /* @__PURE__ */ new Map();
+function stageAttachedReferencesForSend({
+  threadId,
+  references
+}) {
+  if (!threadId) return;
+  if (references.length === 0) {
+    stagedForSend.delete(threadId);
+    return;
+  }
+  stagedForSend.set(threadId, { references, stagedAt: Date.now() });
+}
+function takeStagedAttachedReferences(threadId) {
+  const staged = stagedForSend.get(threadId);
+  stagedForSend.delete(threadId);
+  if (!staged || Date.now() - staged.stagedAt > ATTACHED_REFERENCES_STAGED_TTL_MS) return EMPTY;
+  return staged.references;
+}
+function withStagedAttachedReferences(threadId, metadata) {
+  const references = takeStagedAttachedReferences(threadId);
+  return references.length === 0 ? metadata : attachable.withAttachedReferences(metadata, references);
+}
+const SENT_TEXTS_KEPT_PER_THREAD = 20;
+const THREADS_WITH_SENT_TEXTS_KEPT = 50;
+const sentWithText = /* @__PURE__ */ new Map();
+function setBounded(map, key, value, limit) {
+  map.delete(key);
+  map.set(key, value);
+  while (map.size > limit) {
+    const oldest = map.keys().next();
+    if (oldest.done) break;
+    map.delete(oldest.value);
+  }
+}
+function stageThreadAttachedReferencesForSend({
+  threadId,
+  text
+}) {
+  const references = readPendingAttachedReferences(threadId);
+  stageAttachedReferencesForSend({ threadId, references });
+  if (!threadId) return references;
+  const texts = sentWithText.get(threadId);
+  if (references.length === 0) {
+    texts == null ? void 0 : texts.delete(text);
+    return references;
+  }
+  const kept = texts ?? /* @__PURE__ */ new Map();
+  setBounded(kept, text, references, SENT_TEXTS_KEPT_PER_THREAD);
+  setBounded(sentWithText, threadId, kept, THREADS_WITH_SENT_TEXTS_KEPT);
+  clearAttachedReferences(threadId);
+  return references;
+}
+function reattach(threadId, references) {
+  for (const reference of references) attachReferenceToThread({ threadId, reference });
+}
+function restoreSentAttachedReferences({
+  threadId,
+  text
+}) {
+  var _a;
+  const references = (_a = sentWithText.get(threadId)) == null ? void 0 : _a.get(text);
+  if (references) reattach(threadId, references);
+}
+function giveBackHeldAttachedReferences(entry) {
+  reattach(entry.threadId, attachable.readAttachedReferences(entry.metadata));
+}
+exports.ATTACHED_REFERENCES_STAGED_TTL_MS = ATTACHED_REFERENCES_STAGED_TTL_MS;
+exports.attachReferenceToThread = attachReferenceToThread;
+exports.clearAttachedReferences = clearAttachedReferences;
+exports.detachReferenceFromThread = detachReferenceFromThread;
+exports.forgetAllAttachedReferences = forgetAllAttachedReferences;
+exports.giveBackHeldAttachedReferences = giveBackHeldAttachedReferences;
+exports.keepAttachedReferencesForIdentity = keepAttachedReferencesForIdentity;
+exports.readPendingAttachedReferences = readPendingAttachedReferences;
+exports.restoreSentAttachedReferences = restoreSentAttachedReferences;
+exports.stageAttachedReferencesForSend = stageAttachedReferencesForSend;
+exports.stageThreadAttachedReferencesForSend = stageThreadAttachedReferencesForSend;
+exports.takeStagedAttachedReferences = takeStagedAttachedReferences;
+exports.usePendingAttachedReferences = usePendingAttachedReferences;
+exports.withStagedAttachedReferences = withStagedAttachedReferences;
+//# sourceMappingURL=attached-references.cjs.map