@actioneer/ads 0.1.0

package/components/assistant-ui/attachment.d.ts

@@ -0,0 +1,50 @@
+import { FC } from 'react';
+import { AttachmentAdapter } from '@assistant-ui/react';
+export declare const UserMessageAttachments: FC;
+export declare const ComposerAttachments: FC;
+export declare const ComposerAddAttachment: FC;
+/** File types the Responses API can accept as input_file. Keep this list
+ * explicit so a user is never invited to upload an archive or executable the
+ * model cannot read. Extensions cover browsers that leave File.type empty. */
+export declare const ACTIONEER_FILE_ACCEPT: string;
+/**
+ * Keeps a chosen document as a real file attachment, so the chat adapter can
+ * forward its bytes to the Responses API as an input_file part.
+ */
+export declare class ActioneerFileAttachmentAdapter implements AttachmentAdapter {
+    accept: string;
+    add({ file }: {
+        file: File;
+    }): Promise<{
+        id: string;
+        type: "document";
+        name: string;
+        contentType: string;
+        file: File;
+        status: {
+            type: "requires-action";
+            reason: "composer-send";
+        };
+    }>;
+    send(attachment: Parameters<AttachmentAdapter["send"]>[0]): Promise<{
+        status: {
+            type: "complete";
+        };
+        content: {
+            type: "file";
+            filename: string;
+            data: string;
+            mimeType: string;
+        }[];
+        id: string;
+        type: "image" | "document" | "file" | (string & {});
+        name: string;
+        contentType?: string | undefined;
+        file: File;
+    }>;
+    remove(): Promise<void>;
+}
+export declare const ComposerAddImage: FC;
+/** Document-only picker used by onboarding, where business files can be
+ * shared as context but image analysis and product harnesses are irrelevant. */
+export declare const ComposerAddDocument: FC;

package/components/assistant-ui/attachment.js

@@ -0,0 +1,353 @@
+"use client";
+var E = Object.defineProperty;
+var P = (a, t, n) => t in a ? E(a, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : a[t] = n;
+var y = (a, t, n) => P(a, typeof t != "symbol" ? t + "" : t, n);
+import { jsx as e, jsxs as o, Fragment as A } from "react/jsx-runtime";
+import { useRef as N, useState as w, useEffect as U } from "react";
+import { Plus as _, FileText as h, Loader as C, WarningCircle as k, At as L, Bolt as S, Close as R } from "../../lib/icons.js";
+import { CONTEXT_MIME as D } from "./composer-add-context.js";
+import { HARNESS_MIME as F } from "./composer-harness.js";
+import { ComposerPrimitive as T, useComposerRuntime as z, MessagePrimitive as M, useAui as O, useAuiState as l, AttachmentPrimitive as s } from "@assistant-ui/react";
+import { useShallow as H } from "zustand/shallow";
+import { Tooltip as $, TooltipTrigger as q, TooltipContent as B } from "../ui/tooltip.js";
+import { Dialog as G, DialogTrigger as W, DialogContent as X, DialogTitle as Y } from "../ui/dialog.js";
+import { Avatar as J, AvatarImage as K, AvatarFallback as Q } from "../ui/avatar.js";
+import { TooltipIconButton as g } from "./tooltip-icon-button.js";
+import { cn as p } from "../../lib/cn.js";
+const V = (a) => {
+  const [t, n] = w(void 0);
+  return U(() => {
+    if (!a) {
+      n(void 0);
+      return;
+    }
+    const r = URL.createObjectURL(a);
+    return n(r), () => {
+      URL.revokeObjectURL(r);
+    };
+  }, [a]), t;
+}, j = () => {
+  const { file: a, src: t } = l(
+    H((n) => {
+      var c, m;
+      if (n.attachment.type !== "image") return {};
+      if (n.attachment.file) return { file: n.attachment.file };
+      const r = (m = (c = n.attachment.content) == null ? void 0 : c.filter((d) => d.type === "image")[0]) == null ? void 0 : m.image;
+      return r ? { src: r } : {};
+    })
+  );
+  return V(a) ?? t;
+}, Z = ({ src: a }) => {
+  const [t, n] = w(!1);
+  return /* @__PURE__ */ e(
+    "img",
+    {
+      src: a,
+      alt: "Attachment preview",
+      className: p(
+        "block h-auto max-h-[80vh] w-auto max-w-full object-contain",
+        t ? "aui-attachment-preview-image-loaded" : "aui-attachment-preview-image-loading invisible"
+      ),
+      onLoad: () => n(!0)
+    }
+  );
+}, ee = ({ children: a }) => {
+  const t = j();
+  return t ? /* @__PURE__ */ o(G, { children: [
+    /* @__PURE__ */ e(
+      W,
+      {
+        className: "aui-attachment-preview-trigger hover:bg-accent/50 cursor-pointer transition-colors",
+        asChild: !0,
+        children: a
+      }
+    ),
+    /* @__PURE__ */ o(X, { className: "aui-attachment-preview-dialog-content [&>button]:bg-foreground/60 [&_svg]:text-background [&>button]:hover:[&_svg]:text-destructive p-2 sm:max-w-3xl [&>button]:rounded-full [&>button]:p-1 [&>button]:opacity-100 [&>button]:ring-0!", children: [
+      /* @__PURE__ */ e(Y, { className: "aui-sr-only sr-only", children: "Image Attachment Preview" }),
+      /* @__PURE__ */ e("div", { className: "aui-attachment-preview bg-background relative mx-auto flex max-h-[80dvh] w-full items-center justify-center overflow-hidden", children: /* @__PURE__ */ e(Z, { src: t }) })
+    ] })
+  ] }) : a;
+}, te = () => {
+  const a = j();
+  return /* @__PURE__ */ o(J, { className: "aui-attachment-tile-avatar h-full w-full rounded-none", children: [
+    /* @__PURE__ */ e(
+      K,
+      {
+        src: a,
+        alt: "Attachment preview",
+        className: "aui-attachment-tile-image object-cover"
+      }
+    ),
+    /* @__PURE__ */ e(Q, { children: /* @__PURE__ */ e(h, { className: "aui-attachment-tile-fallback-icon text-muted-foreground size-8" }) })
+  ] });
+}, I = () => {
+  const t = O().attachment.source !== "message", n = l((i) => i.attachment.contentType === D), r = l((i) => i.attachment.contentType === F), c = l((i) => i.attachment.type === "image"), m = l((i) => {
+    const b = i.attachment.type;
+    switch (b) {
+      case "image":
+        return "Image";
+      case "document":
+        return "Document";
+      case "file":
+        return "File";
+      default:
+        return b;
+    }
+  }), d = l(
+    (i) => i.attachment.status.type === "running" ? "uploading" : i.attachment.status.type === "incomplete" && i.attachment.status.reason === "error" ? "error" : void 0
+  ), f = d === "uploading", u = d === "error";
+  return n ? /* @__PURE__ */ e(ae, { isComposer: t }) : r ? /* @__PURE__ */ e(re, { isComposer: t }) : c ? /* @__PURE__ */ o($, { children: [
+    /* @__PURE__ */ o(
+      s.Root,
+      {
+        className: p(
+          "aui-attachment-root relative",
+          c && !t && "aui-attachment-root-message only:*:first:size-24"
+        ),
+        children: [
+          /* @__PURE__ */ e(ee, { children: /* @__PURE__ */ e(q, { asChild: !0, children: /* @__PURE__ */ o(
+            "div",
+            {
+              className: p(
+                "aui-attachment-tile bg-muted relative size-14 cursor-pointer overflow-hidden rounded-[calc(var(--composer-radius)-var(--composer-padding))] border transition-opacity hover:opacity-75",
+                u && "border-destructive"
+              ),
+              role: "button",
+              tabIndex: 0,
+              "aria-label": `${m} attachment${u ? ", upload failed" : f ? ", uploading" : ""}`,
+              children: [
+                /* @__PURE__ */ e(te, {}),
+                f && /* @__PURE__ */ e(
+                  "div",
+                  {
+                    "aria-hidden": "true",
+                    className: "aui-attachment-tile-uploading bg-background/60 absolute inset-0 flex items-center justify-center backdrop-blur-[1px]",
+                    children: /* @__PURE__ */ e(C, { className: "text-muted-foreground size-5 animate-spin" })
+                  }
+                ),
+                u && /* @__PURE__ */ e(
+                  "div",
+                  {
+                    "aria-hidden": "true",
+                    className: "aui-attachment-tile-error bg-destructive/10 absolute inset-0 flex items-center justify-center",
+                    children: /* @__PURE__ */ e(k, { className: "text-destructive size-5" })
+                  }
+                )
+              ]
+            }
+          ) }) }),
+          t && /* @__PURE__ */ e(oe, {})
+        ]
+      }
+    ),
+    /* @__PURE__ */ e(B, { side: "top", children: /* @__PURE__ */ e(s.Name, {}) })
+  ] }) : /* @__PURE__ */ e(
+    ne,
+    {
+      isComposer: t,
+      typeLabel: m,
+      isUploading: f,
+      isError: u
+    }
+  );
+}, v = ({
+  label: a = "Remove attachment"
+}) => /* @__PURE__ */ e(s.Remove, { asChild: !0, children: /* @__PURE__ */ e(
+  "button",
+  {
+    type: "button",
+    "aria-label": a,
+    className: "flex size-5 shrink-0 items-center justify-center rounded text-muted-foreground outline-none transition-colors hover:bg-foreground/10 hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring [&_svg]:size-3.5",
+    children: /* @__PURE__ */ e(R, {})
+  }
+) }), ae = ({ isComposer: a }) => /* @__PURE__ */ e(s.Root, { className: "aui-attachment-root", children: /* @__PURE__ */ o("div", { className: "inline-flex max-w-[15rem] items-center gap-1.5 rounded-md bg-muted py-1 pe-1 ps-2 text-xs text-foreground", children: [
+  /* @__PURE__ */ e(L, { className: "size-3.5 shrink-0 text-muted-foreground" }),
+  /* @__PURE__ */ e("span", { className: "truncate", children: /* @__PURE__ */ e(s.Name, {}) }),
+  a && /* @__PURE__ */ e(v, { label: "Remove context" })
+] }) }), re = ({ isComposer: a }) => /* @__PURE__ */ e(s.Root, { className: "aui-attachment-root", children: /* @__PURE__ */ o("div", { className: "inline-flex max-w-[15rem] items-center gap-1.5 rounded-md bg-info-50 py-1 pe-1 ps-2 text-xs text-info-700", children: [
+  /* @__PURE__ */ e(S, { className: "size-3.5 shrink-0" }),
+  /* @__PURE__ */ o("span", { className: "truncate", children: [
+    "Harness · ",
+    /* @__PURE__ */ e(s.Name, {})
+  ] }),
+  a && /* @__PURE__ */ e(v, { label: "Remove harness" })
+] }) }), ne = ({ isComposer: a, typeLabel: t, isUploading: n, isError: r }) => /* @__PURE__ */ e(s.Root, { className: "aui-attachment-root", children: /* @__PURE__ */ o("div", { className: "flex w-56 max-w-full items-center gap-2.5 rounded-lg bg-muted p-1.5", children: [
+  /* @__PURE__ */ e(
+    "div",
+    {
+      className: p(
+        "flex size-9 shrink-0 items-center justify-center rounded-md bg-background text-muted-foreground [&_svg]:size-4.5",
+        r && "text-destructive"
+      ),
+      children: n ? /* @__PURE__ */ e(C, { className: "size-4 animate-spin" }) : r ? /* @__PURE__ */ e(k, {}) : /* @__PURE__ */ e(h, {})
+    }
+  ),
+  /* @__PURE__ */ o("div", { className: "min-w-0 flex-1", children: [
+    /* @__PURE__ */ e("div", { className: "truncate text-xs font-medium leading-tight text-foreground", children: /* @__PURE__ */ e(s.Name, {}) }),
+    /* @__PURE__ */ e("div", { className: "truncate text-[11px] leading-tight text-muted-foreground", children: r ? "Upload failed" : n ? "Uploading…" : t })
+  ] }),
+  a && /* @__PURE__ */ e(v, { label: "Remove file" })
+] }) }), oe = () => /* @__PURE__ */ e(s.Remove, { asChild: !0, children: /* @__PURE__ */ e(
+  g,
+  {
+    tooltip: "Remove file",
+    className: "aui-attachment-tile-remove text-muted-foreground hover:[&_svg]:text-destructive absolute end-1.5 top-1.5 size-3.5 rounded-full bg-white opacity-100 shadow-sm hover:bg-white! [&_svg]:text-black",
+    side: "top",
+    children: /* @__PURE__ */ e(R, { className: "aui-attachment-remove-icon size-3 dark:stroke-[2.5px]" })
+  }
+) }), we = () => /* @__PURE__ */ e("div", { className: "aui-user-message-attachments-end col-span-full col-start-1 row-start-1 flex w-full flex-row justify-end gap-2", children: /* @__PURE__ */ e(M.Attachments, { children: () => /* @__PURE__ */ e(I, {}) }) }), Ce = () => /* @__PURE__ */ e("div", { className: "aui-composer-attachments flex w-full flex-row items-center gap-2 overflow-x-auto empty:hidden", children: /* @__PURE__ */ e(T.Attachments, { children: () => /* @__PURE__ */ e(I, {}) }) }), ke = () => /* @__PURE__ */ e(T.AddAttachment, { asChild: !0, children: /* @__PURE__ */ e(
+  g,
+  {
+    tooltip: "Add Attachment",
+    side: "bottom",
+    variant: "ghost",
+    size: "icon",
+    className: "aui-composer-add-attachment hover:bg-muted-foreground/15 dark:border-muted-foreground/15 dark:hover:bg-muted-foreground/30 size-7 rounded-full p-1 text-xs font-semibold",
+    "aria-label": "Add Attachment",
+    children: /* @__PURE__ */ e(_, { className: "aui-attachment-add-icon size-4.5 stroke-[1.5px]" })
+  }
+) }), ie = "image/png,image/jpeg,image/webp,image/gif", se = /* @__PURE__ */ new Set([
+  "image/png",
+  "image/jpeg",
+  "image/webp",
+  "image/gif"
+]), x = [
+  "application/pdf",
+  "application/msword",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  "application/rtf",
+  "application/vnd.oasis.opendocument.text",
+  "application/vnd.ms-powerpoint",
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  "application/vnd.ms-excel",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  "text/plain",
+  "text/markdown",
+  "text/csv",
+  "text/tab-separated-values",
+  "text/html",
+  "text/xml",
+  "text/css",
+  "application/json",
+  "application/javascript",
+  "application/typescript",
+  ".pdf,.doc,.docx,.odt,.rtf,.ppt,.pptx,.xls,.xlsx,.csv,.tsv,.txt,.md,.markdown,.json,.html,.xml,.css,.js,.jsx,.ts,.tsx,.sql,.py,.yaml,.yml,.log"
+].join(","), ce = `${ie},${x}`, le = (a) => new Promise((t, n) => {
+  const r = new FileReader();
+  r.onload = () => t(r.result), r.onerror = () => n(r.error), r.readAsDataURL(a);
+});
+class Re {
+  constructor() {
+    y(this, "accept", x);
+  }
+  async add({ file: t }) {
+    return {
+      id: t.name,
+      type: "document",
+      name: t.name,
+      contentType: t.type || "application/octet-stream",
+      file: t,
+      status: { type: "requires-action", reason: "composer-send" }
+    };
+  }
+  async send(t) {
+    return {
+      ...t,
+      status: { type: "complete" },
+      content: [
+        {
+          type: "file",
+          filename: t.name,
+          data: await le(t.file),
+          mimeType: t.contentType || "application/octet-stream"
+        }
+      ]
+    };
+  }
+  async remove() {
+  }
+}
+const Te = () => {
+  const a = z(), t = N(null), n = (r) => {
+    if (r != null && r.length)
+      for (const c of Array.from(r))
+        c.type.startsWith("image/") && !se.has(c.type) || a.addAttachment(c);
+  };
+  return /* @__PURE__ */ o(A, { children: [
+    /* @__PURE__ */ e(
+      "input",
+      {
+        ref: t,
+        hidden: !0,
+        type: "file",
+        accept: ce,
+        multiple: !0,
+        onChange: (r) => {
+          n(r.currentTarget.files), r.currentTarget.value = "";
+        }
+      }
+    ),
+    /* @__PURE__ */ e(
+      g,
+      {
+        tooltip: "Upload image or file",
+        side: "top",
+        type: "button",
+        variant: "ghost",
+        size: "icon",
+        className: "aui-composer-add-image hover:bg-muted-foreground/15 dark:border-muted-foreground/15 dark:hover:bg-muted-foreground/30 size-7 rounded-full p-1",
+        "aria-label": "Upload image or file",
+        onClick: () => {
+          var r;
+          return (r = t.current) == null ? void 0 : r.click();
+        },
+        children: /* @__PURE__ */ e(h, { className: "aui-attachment-add-file-icon size-4.5 stroke-[1.5px]" })
+      }
+    )
+  ] });
+}, ze = () => {
+  const a = z(), t = N(null);
+  return /* @__PURE__ */ o(A, { children: [
+    /* @__PURE__ */ e(
+      "input",
+      {
+        ref: t,
+        hidden: !0,
+        type: "file",
+        accept: x,
+        multiple: !0,
+        onChange: (n) => {
+          for (const r of Array.from(n.currentTarget.files ?? []))
+            a.addAttachment(r);
+          n.currentTarget.value = "";
+        }
+      }
+    ),
+    /* @__PURE__ */ e(
+      g,
+      {
+        tooltip: "Attach business documents",
+        side: "top",
+        type: "button",
+        variant: "ghost",
+        size: "icon",
+        className: "aui-composer-add-document hover:bg-muted-foreground/15 size-7 rounded-full p-1",
+        "aria-label": "Attach business documents",
+        onClick: () => {
+          var n;
+          return (n = t.current) == null ? void 0 : n.click();
+        },
+        children: /* @__PURE__ */ e(h, { className: "size-4.5 stroke-[1.5px]" })
+      }
+    )
+  ] });
+};
+export {
+  x as ACTIONEER_FILE_ACCEPT,
+  Re as ActioneerFileAttachmentAdapter,
+  ke as ComposerAddAttachment,
+  ze as ComposerAddDocument,
+  Te as ComposerAddImage,
+  Ce as ComposerAttachments,
+  we as UserMessageAttachments
+};

package/components/assistant-ui/badge.d.ts

@@ -0,0 +1,11 @@
+import { ComponentProps } from 'react';
+import { VariantProps } from 'class-variance-authority';
+declare const badgeVariants: (props?: ({
+    variant?: "success" | "warning" | "info" | "muted" | "secondary" | "outline" | "ghost" | "destructive" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export type BadgeProps = ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
+    asChild?: boolean;
+};
+declare function Badge({ className, variant, size, asChild, ...props }: BadgeProps): import("react").JSX.Element;
+export { Badge, badgeVariants };

package/components/assistant-ui/badge.js

@@ -0,0 +1,54 @@
+"use client";
+import { jsx as n } from "react/jsx-runtime";
+import { Slot as g } from "radix-ui";
+import { cva as s } from "class-variance-authority";
+import { cn as b } from "../../lib/cn.js";
+const m = s(
+  "inline-flex items-center justify-center gap-1 rounded-md text-xs font-medium transition-colors [&_svg]:size-3 [&_svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        outline: "border-input text-muted-foreground [a&]:hover:bg-accent [a&]:hover:text-accent-foreground border bg-transparent",
+        secondary: "bg-secondary text-secondary-foreground [a&]:hover:bg-secondary/80",
+        muted: "bg-muted text-muted-foreground [a&]:hover:bg-muted/80 [a&]:hover:text-foreground",
+        ghost: "text-muted-foreground [a&]:hover:bg-accent [a&]:hover:text-accent-foreground bg-transparent",
+        info: "bg-blue-100 text-blue-700 dark:bg-blue-900/50 dark:text-blue-300 [a&]:hover:bg-blue-100/80",
+        warning: "bg-amber-100 text-amber-700 dark:bg-amber-900/50 dark:text-amber-300 [a&]:hover:bg-amber-100/80",
+        success: "bg-emerald-100 text-emerald-700 dark:bg-emerald-900/50 dark:text-emerald-300 [a&]:hover:bg-emerald-100/80",
+        destructive: "bg-red-100 text-red-700 dark:bg-red-900/50 dark:text-red-300 [a&]:hover:bg-red-100/80"
+      },
+      size: {
+        sm: "px-1.5 py-0.5",
+        default: "px-2 py-1",
+        lg: "px-2.5 py-1.5 text-sm"
+      }
+    },
+    defaultVariants: {
+      variant: "outline",
+      size: "default"
+    }
+  }
+);
+function x({
+  className: r,
+  variant: e,
+  size: t,
+  asChild: a = !1,
+  ...o
+}) {
+  const d = a ? g.Root : "span";
+  return /* @__PURE__ */ n(
+    d,
+    {
+      "data-slot": "badge",
+      "data-variant": e,
+      "data-size": t,
+      className: b(m({ variant: e, size: t }), r),
+      ...o
+    }
+  );
+}
+export {
+  x as Badge,
+  m as badgeVariants
+};

package/components/assistant-ui/branch-picker.d.ts

@@ -0,0 +1,3 @@
+import { BranchPickerPrimitive } from '@assistant-ui/react';
+import { FC } from 'react';
+export declare const BranchPicker: FC<BranchPickerPrimitive.Root.Props>;

package/components/assistant-ui/branch-picker.js

@@ -0,0 +1,36 @@
+"use client";
+import { jsxs as t, jsx as e } from "react/jsx-runtime";
+import { TooltipIconButton as i } from "./tooltip-icon-button.js";
+import { cn as m } from "../../lib/cn.js";
+import { BranchPickerPrimitive as r } from "@assistant-ui/react";
+import { ChevronLeft as s, ChevronRight as l } from "../../lib/icons.js";
+const f = ({
+  className: o,
+  // Default matches production usage — the picker hides on messages with
+  // only one branch. Showcase demos pass `hideWhenSingleBranch={false}` to
+  // keep it visible without seeding a real branch history.
+  hideWhenSingleBranch: n = !0,
+  ...c
+}) => /* @__PURE__ */ t(
+  r.Root,
+  {
+    hideWhenSingleBranch: n,
+    className: m(
+      "aui-branch-picker-root text-muted-foreground -ms-2 me-2 inline-flex items-center text-xs",
+      o
+    ),
+    ...c,
+    children: [
+      /* @__PURE__ */ e(r.Previous, { asChild: !0, children: /* @__PURE__ */ e(i, { tooltip: "Previous", children: /* @__PURE__ */ e(s, {}) }) }),
+      /* @__PURE__ */ t("span", { className: "aui-branch-picker-state font-medium", children: [
+        /* @__PURE__ */ e(r.Number, {}),
+        " / ",
+        /* @__PURE__ */ e(r.Count, {})
+      ] }),
+      /* @__PURE__ */ e(r.Next, { asChild: !0, children: /* @__PURE__ */ e(i, { tooltip: "Next", children: /* @__PURE__ */ e(l, {}) }) })
+    ]
+  }
+);
+export {
+  f as BranchPicker
+};

package/components/assistant-ui/chain-of-thought.d.ts

@@ -0,0 +1,46 @@
+import { FC, PropsWithChildren } from 'react';
+import { VariantProps } from 'class-variance-authority';
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from '../ui/collapsible';
+declare const chainOfThoughtVariants: (props?: ({
+    variant?: "muted" | "outline" | "ghost" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export type ChainOfThoughtRootProps = Omit<React.ComponentProps<typeof Collapsible>, "open" | "onOpenChange"> & VariantProps<typeof chainOfThoughtVariants>;
+/**
+ * Collapsible wrapper for a message's chain of thought (reasoning +
+ * tool-call parts). Open state is the assistant-ui `chainOfThought` scope's
+ * `collapsed` flag, so `ChainOfThoughtPrimitive.AccordionTrigger` elsewhere
+ * stays in sync. Must render inside a message scope.
+ */
+declare function ChainOfThoughtRoot({ className, variant, children, ...props }: ChainOfThoughtRootProps): import("react").JSX.Element;
+declare function ChainOfThoughtTrigger({ active, className, children, ...props }: React.ComponentProps<typeof CollapsibleTrigger> & {
+    /** Shimmer + spinner while the chain is streaming. Defaults to the scope's running status. */
+    active?: boolean;
+}): import("react").JSX.Element;
+declare function ChainOfThoughtContent({ className, children, ...props }: React.ComponentProps<typeof CollapsibleContent>): import("react").JSX.Element;
+type ChainOfThoughtProps = PropsWithChildren<{
+    /**
+     * The `"group-chainOfThought"` group part from
+     * `MessagePrimitive.GroupedParts`. REQUIRED there: `GroupedParts` does not
+     * provide the `chainOfThought` scope itself (only `MessagePrimitive.Parts`'
+     * components path does), so the indices are used to mount
+     * `ChainOfThoughtByIndicesProvider` — without it the scope selectors throw.
+     */
+    group?: {
+        indices: readonly number[];
+    } | undefined;
+}>;
+type ChainOfThoughtComponent = FC<ChainOfThoughtProps> & {
+    Root: typeof ChainOfThoughtRoot;
+    Trigger: typeof ChainOfThoughtTrigger;
+    Content: typeof ChainOfThoughtContent;
+};
+/**
+ * Assembled chain-of-thought accordion. Two integration paths:
+ * - `MessagePrimitive.Parts` `components={{ ChainOfThought }}` — the scope is
+ *   auto-mounted; `ChainOfThought` renders its own parts. (Preferred.)
+ * - Thread's `ChainOfThoughtGroup` override — pass the group + children so the
+ *   scope mounts: `({ group, children }) => <ChainOfThought group={group}>
+ *   {children}</ChainOfThought>`.
+ */
+declare const ChainOfThought: ChainOfThoughtComponent;
+export { ChainOfThought, ChainOfThoughtRoot, ChainOfThoughtTrigger, ChainOfThoughtContent, chainOfThoughtVariants, };

package/components/assistant-ui/composer-add-context.d.ts

@@ -0,0 +1,50 @@
+import { ReactNode } from 'react';
+import { AttachmentAdapter, Attachment, CompleteAttachment, PendingAttachment } from '@assistant-ui/react';
+/**
+ * "@" context linking for the chat composer — replaces the stock
+ * add-attachment "+" with a cascading picker over the agent's context. It
+ * drills into a tree (e.g. Data Integrations → connection → table → columns,
+ * or Studio → Skills / Memory) and attaches the chosen node as a composer
+ * attachment chip via `ContextAttachmentAdapter`, so removal + per-message
+ * chips come from assistant-ui's own plumbing.
+ *
+ * The tree comes from `ComposerContextProvider` (supplied by the product
+ * screen), keeping this component product-agnostic.
+ */
+export declare const CONTEXT_MIME = "application/x-actioneer-context";
+export interface ContextNode {
+    id: string;
+    label: string;
+    /** Leading icon (ReactNode) — an ADS icon or an <img> logo. */
+    icon?: ReactNode;
+    /** Trailing meta shown muted (e.g. a column type). */
+    hint?: string;
+    /** A branch that can ALSO be attached wholesale ("Add all of …"). */
+    addable?: boolean;
+    children?: ContextNode[];
+}
+/** Called when a Studio context node is attached, so the host can record file
+ *  usage. `name` is the attachment name; `keys` are the Studio file keys it
+ *  covers. Injected by the host — ADS ships no telemetry, so the default is a
+ *  no-op. */
+export type StageUsageHandler = (name: string, keys: string[]) => void;
+export declare function ComposerContextProvider({ tree, onStageUsage, children, }: {
+    tree: ContextNode[];
+    /** Optional usage-recording hook; see {@link StageUsageHandler}. */
+    onStageUsage?: StageUsageHandler;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function ComposerAddContext(): import("react").JSX.Element | null;
+/**
+ * Turns a picked context node (a synthetic `.context` File) into a document
+ * attachment chip; on send it becomes a file part the model adapter can read
+ * from `message.attachments` — nothing leaks into the visible message text.
+ */
+export declare class ContextAttachmentAdapter implements AttachmentAdapter {
+    accept: string;
+    add(state: {
+        file: File;
+    }): Promise<PendingAttachment>;
+    send(attachment: PendingAttachment): Promise<CompleteAttachment>;
+    remove(_attachment: Attachment): Promise<void>;
+}