@adzenai/ai 1.1.1 → 1.2.0

package/dist/copilotkit/react/index.cjs

@@ -21,8 +21,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var react_exports = {};
 __export(react_exports, {
   AdzenCard: () => AdzenCard,
+  InlineAd: () => InlineAd,
+  buildInlineAdSegments: () => buildInlineAdSegments,
+  dispatchInlineAdEvent: () => dispatchInlineAdEvent,
   dispatchPlacementEvent: () => dispatchPlacementEvent,
   dispatchPlacementEvents: () => dispatchPlacementEvents,
+  useAdzenInlineAds: () => useAdzenInlineAds,
   useAdzenPlacement: () => useAdzenPlacement
 });
 module.exports = __toCommonJS(react_exports);
@@ -220,13 +224,194 @@ var cardStyles = {
   }
 };
 
+// src/copilotkit/react/InlineAd.tsx
+var import_react3 = require("react");
+var import_core2 = require("@adzenai/core");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function fireBeacon2(url) {
+  fetch(url, { method: "GET", keepalive: true }).catch(() => {
+    setTimeout(() => {
+      fetch(url, { method: "GET", keepalive: true }).catch(() => {
+      });
+    }, 1e3);
+  });
+}
+function InlineAd({
+  ad,
+  viewabilityThresholdMs = 1e3,
+  className
+}) {
+  const ref = (0, import_react3.useRef)(null);
+  const [renderFired, setRenderFired] = (0, import_react3.useState)(false);
+  const [viewed, setViewed] = (0, import_react3.useState)(false);
+  (0, import_react3.useEffect)(() => {
+    if (renderFired || !ad.tracking.impression_url) return;
+    setRenderFired(true);
+    const url = new URL(ad.tracking.impression_url);
+    url.searchParams.set("timestamp", (/* @__PURE__ */ new Date()).toISOString());
+    fireBeacon2(url.toString());
+  }, [ad, renderFired]);
+  (0, import_react3.useEffect)(() => {
+    if (!ref.current || viewed || !ad.tracking.impression_url) return;
+    return (0, import_core2.observeViewability)({
+      element: ref.current,
+      thresholdMs: viewabilityThresholdMs,
+      onViewed: () => {
+        setViewed(true);
+        if (!ad.tracking.impression_url) return;
+        const url = new URL(ad.tracking.impression_url);
+        url.searchParams.set("type", "view");
+        url.searchParams.set("viewability_ms", String(viewabilityThresholdMs));
+        url.searchParams.set("timestamp", (/* @__PURE__ */ new Date()).toISOString());
+        fireBeacon2(url.toString());
+      }
+    });
+  }, [ad, viewed, viewabilityThresholdMs]);
+  const advertiser = ad.creative.advertiser_name ?? ad.creative.headline;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { ref, className, style: inlineStyles.wrapper, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: inlineStyles.badge, "aria-label": "Advertisement", children: "Ad" }),
+    advertiser ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { style: inlineStyles.advertiser, children: [
+      advertiser,
+      " "
+    ] }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "a",
+      {
+        href: ad.creative.destination_url,
+        target: "_blank",
+        rel: "noopener sponsored",
+        style: inlineStyles.cta,
+        children: ad.creative.cta_text
+      }
+    )
+  ] });
+}
+var inlineStyles = {
+  // Block-level so the snippet starts on its own line below the text it
+  // follows, but otherwise plain: no border, background, or padding.
+  wrapper: {
+    display: "block",
+    margin: "0.5rem 0",
+    fontSize: "0.9em",
+    lineHeight: 1.5
+  },
+  badge: {
+    display: "inline-block",
+    marginRight: "0.4em",
+    padding: "0.1em 0.4em",
+    borderRadius: 4,
+    background: "#30363d",
+    color: "#8b949e",
+    fontSize: "0.75em",
+    fontWeight: 700,
+    letterSpacing: "0.05em",
+    textTransform: "uppercase",
+    verticalAlign: "middle"
+  },
+  advertiser: {
+    color: "#8b949e"
+  },
+  cta: {
+    color: "#58a6ff",
+    textDecoration: "none",
+    fontWeight: 500
+  }
+};
+
+// src/copilotkit/react/useAdzenInlineAds.ts
+var import_react4 = require("react");
+function readOffset(payload) {
+  return typeof payload.content_offset === "number" ? payload.content_offset : Number.MAX_SAFE_INTEGER;
+}
+var PARAGRAPH_BREAK = /\n[ \t]*\n/;
+var ENDS_ON_PARAGRAPH_BREAK = /\n[ \t]*\n$/;
+function snapToParagraphEnd(content, offset) {
+  if (offset >= content.length) return content.length;
+  if (ENDS_ON_PARAGRAPH_BREAK.test(content.slice(0, offset))) return offset;
+  return nextParagraphEnd(content, Math.max(0, offset - 1));
+}
+function nextParagraphEnd(content, from) {
+  if (from >= content.length) return content.length;
+  const match = PARAGRAPH_BREAK.exec(content.slice(from));
+  return match ? from + match.index + match[0].length : content.length;
+}
+function buildInlineAdSegments(content, ads) {
+  if (ads.length === 0) {
+    return content ? [{ kind: "text", text: content }] : [];
+  }
+  const segments = [];
+  let cursor = 0;
+  let lastAnchor = -1;
+  for (const ad of ads) {
+    let anchor = snapToParagraphEnd(content, Math.max(ad.content_offset, 0));
+    if (anchor <= lastAnchor) anchor = nextParagraphEnd(content, lastAnchor);
+    if (anchor <= lastAnchor) continue;
+    if (anchor > cursor) {
+      segments.push({ kind: "text", text: content.slice(cursor, anchor) });
+    }
+    segments.push({ kind: "ad", ad });
+    cursor = anchor;
+    lastAnchor = anchor;
+  }
+  if (cursor < content.length) {
+    segments.push({ kind: "text", text: content.slice(cursor) });
+  }
+  return segments;
+}
+function useAdzenInlineAds() {
+  const [adsMap, setAdsMap] = (0, import_react4.useState)(
+    () => /* @__PURE__ */ new Map()
+  );
+  (0, import_react4.useEffect)(() => {
+    function handler(e) {
+      const detail = e.detail;
+      if (!detail || typeof detail !== "object") return;
+      const payload = detail;
+      const messageId = payload.message_id;
+      if (!messageId) return;
+      const anchored = {
+        ...payload,
+        message_id: messageId,
+        content_offset: readOffset(payload)
+      };
+      setAdsMap((prev) => {
+        const existing = prev.get(messageId) ?? [];
+        if (existing.some((a) => a.ad_id === anchored.ad_id)) return prev;
+        const next = new Map(prev);
+        next.set(
+          messageId,
+          [...existing, anchored].sort(
+            (a, b) => a.content_offset - b.content_offset
+          )
+        );
+        return next;
+      });
+    }
+    window.addEventListener("adzen_inline_ad", handler);
+    return () => window.removeEventListener("adzen_inline_ad", handler);
+  }, []);
+  const getInlineAdsForMessage = (0, import_react4.useCallback)(
+    (messageId) => {
+      return adsMap.get(messageId) ?? [];
+    },
+    [adsMap]
+  );
+  const getInlineAdSegments = (0, import_react4.useCallback)(
+    (messageId, content) => buildInlineAdSegments(content, adsMap.get(messageId) ?? []),
+    [adsMap]
+  );
+  return { getInlineAdsForMessage, getInlineAdSegments };
+}
+
 // src/copilotkit/react/bridge.ts
+function isCustomEvent(event) {
+  const type = String(event.type ?? "");
+  return type === "CUSTOM_EVENT" || type === "CUSTOM" || type === "CustomEvent";
+}
 function dispatchPlacementEvent(event) {
   if (typeof window === "undefined") return false;
   if (event.name !== "adzen_placement") return false;
-  const type = String(event.type ?? "");
-  if (type !== "CUSTOM_EVENT" && type !== "CUSTOM" && type !== "CustomEvent")
-    return false;
+  if (!isCustomEvent(event)) return false;
   const value = event.value;
   if (!value) return false;
   window.dispatchEvent(
@@ -234,16 +419,32 @@ function dispatchPlacementEvent(event) {
   );
   return true;
 }
+function dispatchInlineAdEvent(event) {
+  if (typeof window === "undefined") return false;
+  if (event.name !== "adzen_inline_ad") return false;
+  if (!isCustomEvent(event)) return false;
+  const value = event.value;
+  if (!value) return false;
+  window.dispatchEvent(
+    new CustomEvent("adzen_inline_ad", { detail: value })
+  );
+  return true;
+}
 function dispatchPlacementEvents(events) {
   for (const event of events) {
     dispatchPlacementEvent(event);
+    dispatchInlineAdEvent(event);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdzenCard,
+  InlineAd,
+  buildInlineAdSegments,
+  dispatchInlineAdEvent,
   dispatchPlacementEvent,
   dispatchPlacementEvents,
+  useAdzenInlineAds,
   useAdzenPlacement
 });
 //# sourceMappingURL=index.cjs.map

package/dist/copilotkit/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/copilotkit/react/index.ts","../../../src/copilotkit/react/AdzenCard.tsx","../../../src/copilotkit/react/useAdzenPlacement.ts","../../../src/copilotkit/react/bridge.ts"],"sourcesContent":["export { AdzenCard } from \"./AdzenCard.js\";\nexport type { AdzenCardProps } from \"./AdzenCard.js\";\nexport { useAdzenPlacement } from \"./useAdzenPlacement.js\";\nexport type { UseAdzenPlacementReturn } from \"./useAdzenPlacement.js\";\nexport { dispatchPlacementEvent, dispatchPlacementEvents } from \"./bridge.js\";\n","import { useRef, useEffect, useState } from \"react\";\nimport { observeViewability } from \"@adzenai/core\";\nimport { useAdzenPlacement } from \"./useAdzenPlacement.js\";\n\nexport interface AdzenCardProps {\n  messageId: string;\n  adUnitPosition?: string;\n  viewabilityThresholdMs?: number;\n  className?: string;\n}\n\nfunction fireBeacon(url: string): void {\n  fetch(url, { method: \"GET\", keepalive: true }).catch(() => {\n    setTimeout(() => {\n      fetch(url, { method: \"GET\", keepalive: true }).catch(() => {});\n    }, 1000);\n  });\n}\n\n/**\n * Renders a sponsored ad card for a given assistant message. Returns `null`\n * (no DOM output) when there is no ad for the message.\n */\nexport function AdzenCard({\n  messageId,\n  adUnitPosition = \"chin\",\n  viewabilityThresholdMs = 1000,\n  className,\n}: AdzenCardProps) {\n  const { getAdForMessage } = useAdzenPlacement();\n  const ad = getAdForMessage(messageId);\n  const cardRef = useRef<HTMLDivElement>(null);\n  const [renderFired, setRenderFired] = useState(false);\n  const [viewed, setViewed] = useState(false);\n\n  useEffect(() => {\n    if (!ad || renderFired || !ad.render_impression_url) return;\n    setRenderFired(true);\n\n    const url = new URL(ad.render_impression_url);\n    url.searchParams.set(\"ad_unit_position\", adUnitPosition);\n    url.searchParams.set(\"timestamp\", new Date().toISOString());\n    fireBeacon(url.toString());\n  }, [ad, renderFired, adUnitPosition]);\n\n  useEffect(() => {\n    if (!ad || !cardRef.current || viewed || !ad.view_impression_url) return;\n\n    return observeViewability({\n      element: cardRef.current,\n      thresholdMs: viewabilityThresholdMs,\n      onViewed: () => {\n        setViewed(true);\n        if (!ad.view_impression_url) return;\n        const url = new URL(ad.view_impression_url);\n        url.searchParams.set(\"ad_unit_position\", adUnitPosition);\n        url.searchParams.set(\"viewability_ms\", String(viewabilityThresholdMs));\n        url.searchParams.set(\"timestamp\", new Date().toISOString());\n        fireBeacon(url.toString());\n      },\n    });\n  }, [ad, viewed, adUnitPosition, viewabilityThresholdMs]);\n\n  if (!ad) return null;\n\n  const initial = ad.advertiser_name?.charAt(0).toUpperCase() ?? \"?\";\n\n  return (\n    <div\n      ref={cardRef}\n      className={className}\n      data-adzen-ad-unit-position={adUnitPosition}\n      style={cardStyles.wrapper}\n    >\n      <div style={cardStyles.avatar}>\n        {ad.advertiser_image_url ? (\n          <img\n            src={ad.advertiser_image_url}\n            alt={ad.advertiser_name}\n            style={cardStyles.avatarImg}\n          />\n        ) : (\n          <span style={cardStyles.avatarLetter}>{initial}</span>\n        )}\n      </div>\n\n      <div style={cardStyles.content}>\n        <div style={cardStyles.topRow}>\n          <span style={cardStyles.advertiserName}>{ad.advertiser_name}</span>\n          <span style={cardStyles.relevantAd}>Relevant Ad</span>\n        </div>\n        <div style={cardStyles.bottomRow}>\n          <span style={cardStyles.headline}>{ad.headline}</span>\n          <a\n            href={ad.destination_url}\n            target=\"_blank\"\n            rel=\"noopener sponsored\"\n            style={cardStyles.cta}\n          >\n            {ad.cta_text}\n          </a>\n        </div>\n      </div>\n    </div>\n  );\n}\n\nconst cardStyles: Record<string, React.CSSProperties> = {\n  wrapper: {\n    display: \"flex\",\n    alignItems: \"center\",\n    gap: \"0.625rem\",\n    fontSize: \"0.85rem\",\n    padding: \"0.625rem 0.75rem\",\n  },\n  avatar: {\n    width: 32,\n    height: 32,\n    borderRadius: \"50%\",\n    background: \"#d1d5db\",\n    display: \"flex\",\n    alignItems: \"center\",\n    justifyContent: \"center\",\n    flexShrink: 0,\n    overflow: \"hidden\",\n  },\n  avatarImg: {\n    width: \"100%\",\n    height: \"100%\",\n    objectFit: \"cover\" as const,\n    borderRadius: \"50%\",\n  },\n  avatarLetter: {\n    fontSize: \"0.8rem\",\n    fontWeight: 700,\n    color: \"#374151\",\n    lineHeight: 1,\n  },\n  content: {\n    display: \"flex\",\n    flexDirection: \"column\",\n    gap: \"0.125rem\",\n    minWidth: 0,\n  },\n  topRow: {\n    display: \"flex\",\n    alignItems: \"center\",\n    gap: \"0.5rem\",\n  },\n  advertiserName: {\n    fontWeight: 700,\n    color: \"inherit\",\n  },\n  relevantAd: {\n    color: \"#8b949e\",\n    fontSize: \"0.8rem\",\n  },\n  bottomRow: {\n    display: \"flex\",\n    alignItems: \"center\",\n    gap: \"0.5rem\",\n    whiteSpace: \"nowrap\" as const,\n    overflow: \"hidden\",\n    textOverflow: \"ellipsis\",\n  },\n  headline: {\n    overflow: \"hidden\",\n    textOverflow: \"ellipsis\",\n  },\n  cta: {\n    color: \"#58a6ff\",\n    textDecoration: \"none\",\n    fontWeight: 500,\n    flexShrink: 0,\n  },\n};\n","import { useState, useEffect, useCallback } from \"react\";\nimport type { AdzenPlacement } from \"@adzenai/core\";\n\nexport interface UseAdzenPlacementReturn {\n  getAdForMessage(messageId: string): AdzenPlacement | null;\n  placements: Map<string, AdzenPlacement>;\n}\n\n/**\n * React hook that subscribes to `adzen_placement` custom events and\n * maintains a map of messageId -> AdzenPlacement.\n *\n * Works anywhere in the React tree below `<CopilotKit>` — no wrapper\n * provider required.\n */\nexport function useAdzenPlacement(): UseAdzenPlacementReturn {\n  const [placements, setPlacements] = useState<Map<string, AdzenPlacement>>(\n    () => new Map(),\n  );\n\n  useEffect(() => {\n    function handler(e: Event) {\n      const detail = (e as CustomEvent).detail;\n      if (!detail || typeof detail !== \"object\") return;\n\n      const placement = detail as AdzenPlacement & { message_id?: string };\n      const messageId = placement.message_id;\n      if (!messageId) return;\n\n      setPlacements((prev) => {\n        const existing = prev.get(messageId);\n        if (existing && existing.ad_id === placement.ad_id) return prev;\n        const next = new Map(prev);\n        next.set(messageId, placement);\n        return next;\n      });\n    }\n\n    window.addEventListener(\"adzen_placement\", handler);\n    return () => window.removeEventListener(\"adzen_placement\", handler);\n  }, []);\n\n  const getAdForMessage = useCallback(\n    (messageId: string): AdzenPlacement | null => {\n      return placements.get(messageId) ?? null;\n    },\n    [placements],\n  );\n\n  return { getAdForMessage, placements };\n}\n","import type { AdzenPlacement } from \"@adzenai/core\";\n\n/**\n * Checks whether an AG-UI event is an `adzen_placement` custom event\n * and, if so, dispatches it as a browser `CustomEvent` on `window`\n * so that `useAdzenPlacement` can pick it up.\n *\n * Call this for every event returned by `AdzenAsyncMiddleware.processEvent()`.\n * Non-placement events are silently ignored.\n */\nexport function dispatchPlacementEvent(\n  event: Record<string, unknown>,\n): boolean {\n  if (typeof window === \"undefined\") return false;\n  if (event.name !== \"adzen_placement\") return false;\n\n  const type = String(event.type ?? \"\");\n  if (type !== \"CUSTOM_EVENT\" && type !== \"CUSTOM\" && type !== \"CustomEvent\")\n    return false;\n\n  const value = event.value as (AdzenPlacement & { message_id?: string }) | undefined;\n  if (!value) return false;\n\n  window.dispatchEvent(\n    new CustomEvent(\"adzen_placement\", { detail: value }),\n  );\n  return true;\n}\n\n/**\n * Convenience wrapper: iterates an array of AG-UI events (as returned by\n * `AdzenAsyncMiddleware.processEvent()`) and dispatches any placement\n * events to the browser.\n */\nexport function dispatchPlacementEvents(\n  events: Record<string, unknown>[],\n): void {\n  for (const event of events) {\n    dispatchPlacementEvent(event);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,gBAA4C;AAC5C,kBAAmC;;;ACDnC,mBAAiD;AAe1C,SAAS,oBAA6C;AAC3D,QAAM,CAAC,YAAY,aAAa,QAAI;AAAA,IAClC,MAAM,oBAAI,IAAI;AAAA,EAChB;AAEA,8BAAU,MAAM;AACd,aAAS,QAAQ,GAAU;AACzB,YAAM,SAAU,EAAkB;AAClC,UAAI,CAAC,UAAU,OAAO,WAAW,SAAU;AAE3C,YAAM,YAAY;AAClB,YAAM,YAAY,UAAU;AAC5B,UAAI,CAAC,UAAW;AAEhB,oBAAc,CAAC,SAAS;AACtB,cAAM,WAAW,KAAK,IAAI,SAAS;AACnC,YAAI,YAAY,SAAS,UAAU,UAAU,MAAO,QAAO;AAC3D,cAAM,OAAO,IAAI,IAAI,IAAI;AACzB,aAAK,IAAI,WAAW,SAAS;AAC7B,eAAO;AAAA,MACT,CAAC;AAAA,IACH;AAEA,WAAO,iBAAiB,mBAAmB,OAAO;AAClD,WAAO,MAAM,OAAO,oBAAoB,mBAAmB,OAAO;AAAA,EACpE,GAAG,CAAC,CAAC;AAEL,QAAM,sBAAkB;AAAA,IACtB,CAAC,cAA6C;AAC5C,aAAO,WAAW,IAAI,SAAS,KAAK;AAAA,IACtC;AAAA,IACA,CAAC,UAAU;AAAA,EACb;AAEA,SAAO,EAAE,iBAAiB,WAAW;AACvC;;;AD0BU;AAjEV,SAAS,WAAW,KAAmB;AACrC,QAAM,KAAK,EAAE,QAAQ,OAAO,WAAW,KAAK,CAAC,EAAE,MAAM,MAAM;AACzD,eAAW,MAAM;AACf,YAAM,KAAK,EAAE,QAAQ,OAAO,WAAW,KAAK,CAAC,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IAC/D,GAAG,GAAI;AAAA,EACT,CAAC;AACH;AAMO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA,iBAAiB;AAAA,EACjB,yBAAyB;AAAA,EACzB;AACF,GAAmB;AACjB,QAAM,EAAE,gBAAgB,IAAI,kBAAkB;AAC9C,QAAM,KAAK,gBAAgB,SAAS;AACpC,QAAM,cAAU,sBAAuB,IAAI;AAC3C,QAAM,CAAC,aAAa,cAAc,QAAI,wBAAS,KAAK;AACpD,QAAM,CAAC,QAAQ,SAAS,QAAI,wBAAS,KAAK;AAE1C,+BAAU,MAAM;AACd,QAAI,CAAC,MAAM,eAAe,CAAC,GAAG,sBAAuB;AACrD,mBAAe,IAAI;AAEnB,UAAM,MAAM,IAAI,IAAI,GAAG,qBAAqB;AAC5C,QAAI,aAAa,IAAI,oBAAoB,cAAc;AACvD,QAAI,aAAa,IAAI,cAAa,oBAAI,KAAK,GAAE,YAAY,CAAC;AAC1D,eAAW,IAAI,SAAS,CAAC;AAAA,EAC3B,GAAG,CAAC,IAAI,aAAa,cAAc,CAAC;AAEpC,+BAAU,MAAM;AACd,QAAI,CAAC,MAAM,CAAC,QAAQ,WAAW,UAAU,CAAC,GAAG,oBAAqB;AAElE,eAAO,gCAAmB;AAAA,MACxB,SAAS,QAAQ;AAAA,MACjB,aAAa;AAAA,MACb,UAAU,MAAM;AACd,kBAAU,IAAI;AACd,YAAI,CAAC,GAAG,oBAAqB;AAC7B,cAAM,MAAM,IAAI,IAAI,GAAG,mBAAmB;AAC1C,YAAI,aAAa,IAAI,oBAAoB,cAAc;AACvD,YAAI,aAAa,IAAI,kBAAkB,OAAO,sBAAsB,CAAC;AACrE,YAAI,aAAa,IAAI,cAAa,oBAAI,KAAK,GAAE,YAAY,CAAC;AAC1D,mBAAW,IAAI,SAAS,CAAC;AAAA,MAC3B;AAAA,IACF,CAAC;AAAA,EACH,GAAG,CAAC,IAAI,QAAQ,gBAAgB,sBAAsB,CAAC;AAEvD,MAAI,CAAC,GAAI,QAAO;AAEhB,QAAM,UAAU,GAAG,iBAAiB,OAAO,CAAC,EAAE,YAAY,KAAK;AAE/D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK;AAAA,MACL;AAAA,MACA,+BAA6B;AAAA,MAC7B,OAAO,WAAW;AAAA,MAElB;AAAA,oDAAC,SAAI,OAAO,WAAW,QACpB,aAAG,uBACF;AAAA,UAAC;AAAA;AAAA,YACC,KAAK,GAAG;AAAA,YACR,KAAK,GAAG;AAAA,YACR,OAAO,WAAW;AAAA;AAAA,QACpB,IAEA,4CAAC,UAAK,OAAO,WAAW,cAAe,mBAAQ,GAEnD;AAAA,QAEA,6CAAC,SAAI,OAAO,WAAW,SACrB;AAAA,uDAAC,SAAI,OAAO,WAAW,QACrB;AAAA,wDAAC,UAAK,OAAO,WAAW,gBAAiB,aAAG,iBAAgB;AAAA,YAC5D,4CAAC,UAAK,OAAO,WAAW,YAAY,yBAAW;AAAA,aACjD;AAAA,UACA,6CAAC,SAAI,OAAO,WAAW,WACrB;AAAA,wDAAC,UAAK,OAAO,WAAW,UAAW,aAAG,UAAS;AAAA,YAC/C;AAAA,cAAC;AAAA;AAAA,gBACC,MAAM,GAAG;AAAA,gBACT,QAAO;AAAA,gBACP,KAAI;AAAA,gBACJ,OAAO,WAAW;AAAA,gBAEjB,aAAG;AAAA;AAAA,YACN;AAAA,aACF;AAAA,WACF;AAAA;AAAA;AAAA,EACF;AAEJ;AAEA,IAAM,aAAkD;AAAA,EACtD,SAAS;AAAA,IACP,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,KAAK;AAAA,IACL,UAAU;AAAA,IACV,SAAS;AAAA,EACX;AAAA,EACA,QAAQ;AAAA,IACN,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,UAAU;AAAA,EACZ;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,cAAc;AAAA,EAChB;AAAA,EACA,cAAc;AAAA,IACZ,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,YAAY;AAAA,EACd;AAAA,EACA,SAAS;AAAA,IACP,SAAS;AAAA,IACT,eAAe;AAAA,IACf,KAAK;AAAA,IACL,UAAU;AAAA,EACZ;AAAA,EACA,QAAQ;AAAA,IACN,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,KAAK;AAAA,EACP;AAAA,EACA,gBAAgB;AAAA,IACd,YAAY;AAAA,IACZ,OAAO;AAAA,EACT;AAAA,EACA,YAAY;AAAA,IACV,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,WAAW;AAAA,IACT,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,KAAK;AAAA,IACL,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,cAAc;AAAA,EAChB;AAAA,EACA,UAAU;AAAA,IACR,UAAU;AAAA,IACV,cAAc;AAAA,EAChB;AAAA,EACA,KAAK;AAAA,IACH,OAAO;AAAA,IACP,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,YAAY;AAAA,EACd;AACF;;;AErKO,SAAS,uBACd,OACS;AACT,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,MAAI,MAAM,SAAS,kBAAmB,QAAO;AAE7C,QAAM,OAAO,OAAO,MAAM,QAAQ,EAAE;AACpC,MAAI,SAAS,kBAAkB,SAAS,YAAY,SAAS;AAC3D,WAAO;AAET,QAAM,QAAQ,MAAM;AACpB,MAAI,CAAC,MAAO,QAAO;AAEnB,SAAO;AAAA,IACL,IAAI,YAAY,mBAAmB,EAAE,QAAQ,MAAM,CAAC;AAAA,EACtD;AACA,SAAO;AACT;AAOO,SAAS,wBACd,QACM;AACN,aAAW,SAAS,QAAQ;AAC1B,2BAAuB,KAAK;AAAA,EAC9B;AACF;","names":["import_react"]}
+{"version":3,"sources":["../../../src/copilotkit/react/index.ts","../../../src/copilotkit/react/AdzenCard.tsx","../../../src/copilotkit/react/useAdzenPlacement.ts","../../../src/copilotkit/react/InlineAd.tsx","../../../src/copilotkit/react/useAdzenInlineAds.ts","../../../src/copilotkit/react/bridge.ts"],"sourcesContent":["export { AdzenCard } from \"./AdzenCard.js\";\nexport type { AdzenCardProps } from \"./AdzenCard.js\";\nexport { InlineAd } from \"./InlineAd.js\";\nexport type { InlineAdProps } from \"./InlineAd.js\";\nexport { useAdzenPlacement } from \"./useAdzenPlacement.js\";\nexport type { UseAdzenPlacementReturn } from \"./useAdzenPlacement.js\";\nexport {\n  useAdzenInlineAds,\n  buildInlineAdSegments,\n} from \"./useAdzenInlineAds.js\";\nexport type {\n  UseAdzenInlineAdsReturn,\n  InlineAdSegment,\n} from \"./useAdzenInlineAds.js\";\nexport {\n  dispatchPlacementEvent,\n  dispatchInlineAdEvent,\n  dispatchPlacementEvents,\n} from \"./bridge.js\";\n","import { useRef, useEffect, useState } from \"react\";\nimport { observeViewability } from \"@adzenai/core\";\nimport { useAdzenPlacement } from \"./useAdzenPlacement.js\";\n\nexport interface AdzenCardProps {\n  messageId: string;\n  adUnitPosition?: string;\n  viewabilityThresholdMs?: number;\n  className?: string;\n}\n\nfunction fireBeacon(url: string): void {\n  fetch(url, { method: \"GET\", keepalive: true }).catch(() => {\n    setTimeout(() => {\n      fetch(url, { method: \"GET\", keepalive: true }).catch(() => {});\n    }, 1000);\n  });\n}\n\n/**\n * Renders a sponsored ad card for a given assistant message. Returns `null`\n * (no DOM output) when there is no ad for the message.\n */\nexport function AdzenCard({\n  messageId,\n  adUnitPosition = \"chin\",\n  viewabilityThresholdMs = 1000,\n  className,\n}: AdzenCardProps) {\n  const { getAdForMessage } = useAdzenPlacement();\n  const ad = getAdForMessage(messageId);\n  const cardRef = useRef<HTMLDivElement>(null);\n  const [renderFired, setRenderFired] = useState(false);\n  const [viewed, setViewed] = useState(false);\n\n  useEffect(() => {\n    if (!ad || renderFired || !ad.render_impression_url) return;\n    setRenderFired(true);\n\n    const url = new URL(ad.render_impression_url);\n    url.searchParams.set(\"ad_unit_position\", adUnitPosition);\n    url.searchParams.set(\"timestamp\", new Date().toISOString());\n    fireBeacon(url.toString());\n  }, [ad, renderFired, adUnitPosition]);\n\n  useEffect(() => {\n    if (!ad || !cardRef.current || viewed || !ad.view_impression_url) return;\n\n    return observeViewability({\n      element: cardRef.current,\n      thresholdMs: viewabilityThresholdMs,\n      onViewed: () => {\n        setViewed(true);\n        if (!ad.view_impression_url) return;\n        const url = new URL(ad.view_impression_url);\n        url.searchParams.set(\"ad_unit_position\", adUnitPosition);\n        url.searchParams.set(\"viewability_ms\", String(viewabilityThresholdMs));\n        url.searchParams.set(\"timestamp\", new Date().toISOString());\n        fireBeacon(url.toString());\n      },\n    });\n  }, [ad, viewed, adUnitPosition, viewabilityThresholdMs]);\n\n  if (!ad) return null;\n\n  const initial = ad.advertiser_name?.charAt(0).toUpperCase() ?? \"?\";\n\n  return (\n    <div\n      ref={cardRef}\n      className={className}\n      data-adzen-ad-unit-position={adUnitPosition}\n      style={cardStyles.wrapper}\n    >\n      <div style={cardStyles.avatar}>\n        {ad.advertiser_image_url ? (\n          <img\n            src={ad.advertiser_image_url}\n            alt={ad.advertiser_name}\n            style={cardStyles.avatarImg}\n          />\n        ) : (\n          <span style={cardStyles.avatarLetter}>{initial}</span>\n        )}\n      </div>\n\n      <div style={cardStyles.content}>\n        <div style={cardStyles.topRow}>\n          <span style={cardStyles.advertiserName}>{ad.advertiser_name}</span>\n          <span style={cardStyles.relevantAd}>Relevant Ad</span>\n        </div>\n        <div style={cardStyles.bottomRow}>\n          <span style={cardStyles.headline}>{ad.headline}</span>\n          <a\n            href={ad.destination_url}\n            target=\"_blank\"\n            rel=\"noopener sponsored\"\n            style={cardStyles.cta}\n          >\n            {ad.cta_text}\n          </a>\n        </div>\n      </div>\n    </div>\n  );\n}\n\nconst cardStyles: Record<string, React.CSSProperties> = {\n  wrapper: {\n    display: \"flex\",\n    alignItems: \"center\",\n    gap: \"0.625rem\",\n    fontSize: \"0.85rem\",\n    padding: \"0.625rem 0.75rem\",\n  },\n  avatar: {\n    width: 32,\n    height: 32,\n    borderRadius: \"50%\",\n    background: \"#d1d5db\",\n    display: \"flex\",\n    alignItems: \"center\",\n    justifyContent: \"center\",\n    flexShrink: 0,\n    overflow: \"hidden\",\n  },\n  avatarImg: {\n    width: \"100%\",\n    height: \"100%\",\n    objectFit: \"cover\" as const,\n    borderRadius: \"50%\",\n  },\n  avatarLetter: {\n    fontSize: \"0.8rem\",\n    fontWeight: 700,\n    color: \"#374151\",\n    lineHeight: 1,\n  },\n  content: {\n    display: \"flex\",\n    flexDirection: \"column\",\n    gap: \"0.125rem\",\n    minWidth: 0,\n  },\n  topRow: {\n    display: \"flex\",\n    alignItems: \"center\",\n    gap: \"0.5rem\",\n  },\n  advertiserName: {\n    fontWeight: 700,\n    color: \"inherit\",\n  },\n  relevantAd: {\n    color: \"#8b949e\",\n    fontSize: \"0.8rem\",\n  },\n  bottomRow: {\n    display: \"flex\",\n    alignItems: \"center\",\n    gap: \"0.5rem\",\n    whiteSpace: \"nowrap\" as const,\n    overflow: \"hidden\",\n    textOverflow: \"ellipsis\",\n  },\n  headline: {\n    overflow: \"hidden\",\n    textOverflow: \"ellipsis\",\n  },\n  cta: {\n    color: \"#58a6ff\",\n    textDecoration: \"none\",\n    fontWeight: 500,\n    flexShrink: 0,\n  },\n};\n","import { useState, useEffect, useCallback } from \"react\";\nimport type { AdzenPlacement } from \"@adzenai/core\";\n\nexport interface UseAdzenPlacementReturn {\n  getAdForMessage(messageId: string): AdzenPlacement | null;\n  placements: Map<string, AdzenPlacement>;\n}\n\n/**\n * React hook that subscribes to `adzen_placement` custom events and\n * maintains a map of messageId -> AdzenPlacement.\n *\n * Works anywhere in the React tree below `<CopilotKit>` — no wrapper\n * provider required.\n */\nexport function useAdzenPlacement(): UseAdzenPlacementReturn {\n  const [placements, setPlacements] = useState<Map<string, AdzenPlacement>>(\n    () => new Map(),\n  );\n\n  useEffect(() => {\n    function handler(e: Event) {\n      const detail = (e as CustomEvent).detail;\n      if (!detail || typeof detail !== \"object\") return;\n\n      const placement = detail as AdzenPlacement & { message_id?: string };\n      const messageId = placement.message_id;\n      if (!messageId) return;\n\n      setPlacements((prev) => {\n        const existing = prev.get(messageId);\n        if (existing && existing.ad_id === placement.ad_id) return prev;\n        const next = new Map(prev);\n        next.set(messageId, placement);\n        return next;\n      });\n    }\n\n    window.addEventListener(\"adzen_placement\", handler);\n    return () => window.removeEventListener(\"adzen_placement\", handler);\n  }, []);\n\n  const getAdForMessage = useCallback(\n    (messageId: string): AdzenPlacement | null => {\n      return placements.get(messageId) ?? null;\n    },\n    [placements],\n  );\n\n  return { getAdForMessage, placements };\n}\n","import { useRef, useEffect, useState } from \"react\";\nimport { observeViewability } from \"@adzenai/core\";\nimport type { InlineAdEvent } from \"@adzenai/core\";\n\nexport interface InlineAdProps {\n  ad: InlineAdEvent;\n  viewabilityThresholdMs?: number;\n  className?: string;\n}\n\nfunction fireBeacon(url: string): void {\n  fetch(url, { method: \"GET\", keepalive: true }).catch(() => {\n    setTimeout(() => {\n      fetch(url, { method: \"GET\", keepalive: true }).catch(() => {});\n    }, 1000);\n  });\n}\n\n/**\n * Renders an inline ad as a single line of text — an \"Ad\" pill, the advertiser\n * name, and the CTA as the only link — rather than a card, so it sits in the\n * message body without competing with the assistant's own content.\n *\n * Tracks render/view impressions via the same beacon pattern as AdzenCard.\n */\nexport function InlineAd({\n  ad,\n  viewabilityThresholdMs = 1000,\n  className,\n}: InlineAdProps) {\n  const ref = useRef<HTMLDivElement>(null);\n  const [renderFired, setRenderFired] = useState(false);\n  const [viewed, setViewed] = useState(false);\n\n  useEffect(() => {\n    if (renderFired || !ad.tracking.impression_url) return;\n    setRenderFired(true);\n\n    const url = new URL(ad.tracking.impression_url);\n    url.searchParams.set(\"timestamp\", new Date().toISOString());\n    fireBeacon(url.toString());\n  }, [ad, renderFired]);\n\n  useEffect(() => {\n    if (!ref.current || viewed || !ad.tracking.impression_url) return;\n\n    return observeViewability({\n      element: ref.current,\n      thresholdMs: viewabilityThresholdMs,\n      onViewed: () => {\n        setViewed(true);\n        if (!ad.tracking.impression_url) return;\n        const url = new URL(ad.tracking.impression_url);\n        url.searchParams.set(\"type\", \"view\");\n        url.searchParams.set(\"viewability_ms\", String(viewabilityThresholdMs));\n        url.searchParams.set(\"timestamp\", new Date().toISOString());\n        fireBeacon(url.toString());\n      },\n    });\n  }, [ad, viewed, viewabilityThresholdMs]);\n\n  const advertiser = ad.creative.advertiser_name ?? ad.creative.headline;\n\n  return (\n    <div ref={ref} className={className} style={inlineStyles.wrapper}>\n      <span style={inlineStyles.badge} aria-label=\"Advertisement\">\n        Ad\n      </span>\n      {advertiser ? (\n        <span style={inlineStyles.advertiser}>{advertiser} </span>\n      ) : null}\n      <a\n        href={ad.creative.destination_url}\n        target=\"_blank\"\n        rel=\"noopener sponsored\"\n        style={inlineStyles.cta}\n      >\n        {ad.creative.cta_text}\n      </a>\n    </div>\n  );\n}\n\nconst inlineStyles: Record<string, React.CSSProperties> = {\n  // Block-level so the snippet starts on its own line below the text it\n  // follows, but otherwise plain: no border, background, or padding.\n  wrapper: {\n    display: \"block\",\n    margin: \"0.5rem 0\",\n    fontSize: \"0.9em\",\n    lineHeight: 1.5,\n  },\n  badge: {\n    display: \"inline-block\",\n    marginRight: \"0.4em\",\n    padding: \"0.1em 0.4em\",\n    borderRadius: 4,\n    background: \"#30363d\",\n    color: \"#8b949e\",\n    fontSize: \"0.75em\",\n    fontWeight: 700,\n    letterSpacing: \"0.05em\",\n    textTransform: \"uppercase\" as const,\n    verticalAlign: \"middle\",\n  },\n  advertiser: {\n    color: \"#8b949e\",\n  },\n  cta: {\n    color: \"#58a6ff\",\n    textDecoration: \"none\",\n    fontWeight: 500,\n  },\n};\n","import { useState, useEffect, useCallback } from \"react\";\nimport type { InlineAdEvent, InlineAdEventPayload } from \"@adzenai/core\";\n\n/** A run of message text, or an ad anchored to the end of the run before it. */\nexport type InlineAdSegment =\n  | { kind: \"text\"; text: string }\n  | { kind: \"ad\"; ad: InlineAdEventPayload };\n\nexport interface UseAdzenInlineAdsReturn {\n  getInlineAdsForMessage(messageId: string): InlineAdEventPayload[];\n  getInlineAdSegments(messageId: string, content: string): InlineAdSegment[];\n}\n\n/**\n * Ads without an anchor sort last so they render at the end of the message,\n * which is the best guess for a payload that predates `content_offset`.\n */\nfunction readOffset(payload: InlineAdEvent & { content_offset?: unknown }): number {\n  return typeof payload.content_offset === \"number\"\n    ? payload.content_offset\n    : Number.MAX_SAFE_INTEGER;\n}\n\n/** A blank line, which ends a paragraph in both plain text and Markdown. */\nconst PARAGRAPH_BREAK = /\\n[ \\t]*\\n/;\nconst ENDS_ON_PARAGRAPH_BREAK = /\\n[ \\t]*\\n$/;\n\n/**\n * Moves an anchor forward to the end of the paragraph it falls in.\n *\n * Deltas are token-sized, so a raw offset routinely lands mid-word or inside\n * a Markdown construct (`**bold te|xt**`). Splitting there would break both\n * the sentence and the Markdown, so the ad is deferred to the next paragraph\n * break — the `paragraph_break` position the API asks for. While the paragraph\n * is still streaming there is no break yet, so the ad sits at the end of the\n * content and settles into place once the paragraph closes.\n */\nfunction snapToParagraphEnd(content: string, offset: number): number {\n  if (offset >= content.length) return content.length;\n\n  // The preceding frame already ended on a blank line, so this is the start of\n  // a fresh paragraph and the ad belongs here.\n  if (ENDS_ON_PARAGRAPH_BREAK.test(content.slice(0, offset))) return offset;\n\n  // Search from one character back so an offset landing inside the blank line\n  // itself still resolves to that break rather than skipping to the next one.\n  return nextParagraphEnd(content, Math.max(0, offset - 1));\n}\n\n/**\n * Position just past the first paragraph break at or after `from`, or the end\n * of the content when no break follows.\n */\nfunction nextParagraphEnd(content: string, from: number): number {\n  if (from >= content.length) return content.length;\n  const match = PARAGRAPH_BREAK.exec(content.slice(from));\n  return match ? from + match.index + match[0].length : content.length;\n}\n\n/**\n * Splits `content` into text and ad segments, placing each ad after the text\n * that had streamed when it arrived.\n *\n * At most one ad is placed per paragraph break. Several ads routinely resolve\n * to the same break — the API can emit a burst of them, and every ad anchored\n * inside one paragraph snaps to that paragraph's end — so each ad after the\n * first is moved to the next free break, with the end of the content usable as\n * a final slot. An ad with no free slot is left out and appears once the\n * message has grown enough to hold it, which keeps ads from piling up in one\n * spot while a paragraph is still streaming.\n *\n * @param ads Must be sorted by `content_offset` ascending.\n */\nexport function buildInlineAdSegments(\n  content: string,\n  ads: InlineAdEventPayload[],\n): InlineAdSegment[] {\n  if (ads.length === 0) {\n    return content ? [{ kind: \"text\", text: content }] : [];\n  }\n\n  const segments: InlineAdSegment[] = [];\n  let cursor = 0;\n  let lastAnchor = -1;\n\n  for (const ad of ads) {\n    let anchor = snapToParagraphEnd(content, Math.max(ad.content_offset, 0));\n    if (anchor <= lastAnchor) anchor = nextParagraphEnd(content, lastAnchor);\n    if (anchor <= lastAnchor) continue;\n\n    if (anchor > cursor) {\n      segments.push({ kind: \"text\", text: content.slice(cursor, anchor) });\n    }\n    segments.push({ kind: \"ad\", ad });\n    cursor = anchor;\n    lastAnchor = anchor;\n  }\n\n  if (cursor < content.length) {\n    segments.push({ kind: \"text\", text: content.slice(cursor) });\n  }\n\n  return segments;\n}\n\n/**\n * React hook that subscribes to `adzen_inline_ad` custom events on\n * `window` and maintains a map of messageId -> InlineAdEventPayload[].\n *\n * Supports multiple inline ads per message per the cardinality requirements.\n * Ads are kept sorted by `content_offset` so they can be interleaved with the\n * message text at the point in the stream where they arrived.\n */\nexport function useAdzenInlineAds(): UseAdzenInlineAdsReturn {\n  const [adsMap, setAdsMap] = useState<Map<string, InlineAdEventPayload[]>>(\n    () => new Map(),\n  );\n\n  useEffect(() => {\n    function handler(e: Event) {\n      const detail = (e as CustomEvent).detail;\n      if (!detail || typeof detail !== \"object\") return;\n\n      const payload = detail as InlineAdEvent & { message_id?: string };\n      const messageId = payload.message_id;\n      if (!messageId) return;\n\n      const anchored: InlineAdEventPayload = {\n        ...payload,\n        message_id: messageId,\n        content_offset: readOffset(payload),\n      };\n\n      setAdsMap((prev) => {\n        const existing = prev.get(messageId) ?? [];\n        if (existing.some((a) => a.ad_id === anchored.ad_id)) return prev;\n        const next = new Map(prev);\n        next.set(\n          messageId,\n          [...existing, anchored].sort(\n            (a, b) => a.content_offset - b.content_offset,\n          ),\n        );\n        return next;\n      });\n    }\n\n    window.addEventListener(\"adzen_inline_ad\", handler);\n    return () => window.removeEventListener(\"adzen_inline_ad\", handler);\n  }, []);\n\n  const getInlineAdsForMessage = useCallback(\n    (messageId: string): InlineAdEventPayload[] => {\n      return adsMap.get(messageId) ?? [];\n    },\n    [adsMap],\n  );\n\n  const getInlineAdSegments = useCallback(\n    (messageId: string, content: string): InlineAdSegment[] =>\n      buildInlineAdSegments(content, adsMap.get(messageId) ?? []),\n    [adsMap],\n  );\n\n  return { getInlineAdsForMessage, getInlineAdSegments };\n}\n","import type { AdzenPlacement, InlineAdEventPayload } from \"@adzenai/core\";\n\nfunction isCustomEvent(event: Record<string, unknown>): boolean {\n  const type = String(event.type ?? \"\");\n  return type === \"CUSTOM_EVENT\" || type === \"CUSTOM\" || type === \"CustomEvent\";\n}\n\n/**\n * Checks whether an AG-UI event is an `adzen_placement` custom event\n * and, if so, dispatches it as a browser `CustomEvent` on `window`\n * so that `useAdzenPlacement` can pick it up.\n *\n * Call this for every event returned by middleware `processEvent()` or\n * `processStream()`. Non-placement events are silently ignored.\n */\nexport function dispatchPlacementEvent(\n  event: Record<string, unknown>,\n): boolean {\n  if (typeof window === \"undefined\") return false;\n  if (event.name !== \"adzen_placement\") return false;\n  if (!isCustomEvent(event)) return false;\n\n  const value = event.value as (AdzenPlacement & { message_id?: string }) | undefined;\n  if (!value) return false;\n\n  window.dispatchEvent(\n    new CustomEvent(\"adzen_placement\", { detail: value }),\n  );\n  return true;\n}\n\n/**\n * Checks whether an AG-UI event is an `adzen_inline_ad` custom event\n * and, if so, dispatches it as a browser `CustomEvent` on `window`\n * so that `useAdzenInlineAds` can pick it up.\n */\nexport function dispatchInlineAdEvent(\n  event: Record<string, unknown>,\n): boolean {\n  if (typeof window === \"undefined\") return false;\n  if (event.name !== \"adzen_inline_ad\") return false;\n  if (!isCustomEvent(event)) return false;\n\n  const value = event.value as Partial<InlineAdEventPayload> | undefined;\n  if (!value) return false;\n\n  window.dispatchEvent(\n    new CustomEvent(\"adzen_inline_ad\", { detail: value }),\n  );\n  return true;\n}\n\n/**\n * Convenience wrapper: iterates an array of AG-UI events and dispatches\n * any placement or inline ad events to the browser.\n */\nexport function dispatchPlacementEvents(\n  events: Record<string, unknown>[],\n): void {\n  for (const event of events) {\n    dispatchPlacementEvent(event);\n    dispatchInlineAdEvent(event);\n  }\n}\n"],"mappings":"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","names":["import_react","import_react","import_core","import_jsx_runtime","fireBeacon","import_react"]}

package/dist/copilotkit/react/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { AdzenPlacement } from '@adzenai/core';
+import { InlineAdEvent, AdzenPlacement, InlineAdEventPayload } from '@adzenai/core';
 
 interface AdzenCardProps {
     messageId: string;
@@ -13,6 +13,20 @@ interface AdzenCardProps {
  */
 declare function AdzenCard({ messageId, adUnitPosition, viewabilityThresholdMs, className, }: AdzenCardProps): react.JSX.Element | null;
 
+interface InlineAdProps {
+    ad: InlineAdEvent;
+    viewabilityThresholdMs?: number;
+    className?: string;
+}
+/**
+ * Renders an inline ad as a single line of text — an "Ad" pill, the advertiser
+ * name, and the CTA as the only link — rather than a card, so it sits in the
+ * message body without competing with the assistant's own content.
+ *
+ * Tracks render/view impressions via the same beacon pattern as AdzenCard.
+ */
+declare function InlineAd({ ad, viewabilityThresholdMs, className, }: InlineAdProps): react.JSX.Element;
+
 interface UseAdzenPlacementReturn {
     getAdForMessage(messageId: string): AdzenPlacement | null;
     placements: Map<string, AdzenPlacement>;
@@ -26,20 +40,62 @@ interface UseAdzenPlacementReturn {
  */
 declare function useAdzenPlacement(): UseAdzenPlacementReturn;
 
+/** A run of message text, or an ad anchored to the end of the run before it. */
+type InlineAdSegment = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "ad";
+    ad: InlineAdEventPayload;
+};
+interface UseAdzenInlineAdsReturn {
+    getInlineAdsForMessage(messageId: string): InlineAdEventPayload[];
+    getInlineAdSegments(messageId: string, content: string): InlineAdSegment[];
+}
+/**
+ * Splits `content` into text and ad segments, placing each ad after the text
+ * that had streamed when it arrived.
+ *
+ * At most one ad is placed per paragraph break. Several ads routinely resolve
+ * to the same break — the API can emit a burst of them, and every ad anchored
+ * inside one paragraph snaps to that paragraph's end — so each ad after the
+ * first is moved to the next free break, with the end of the content usable as
+ * a final slot. An ad with no free slot is left out and appears once the
+ * message has grown enough to hold it, which keeps ads from piling up in one
+ * spot while a paragraph is still streaming.
+ *
+ * @param ads Must be sorted by `content_offset` ascending.
+ */
+declare function buildInlineAdSegments(content: string, ads: InlineAdEventPayload[]): InlineAdSegment[];
+/**
+ * React hook that subscribes to `adzen_inline_ad` custom events on
+ * `window` and maintains a map of messageId -> InlineAdEventPayload[].
+ *
+ * Supports multiple inline ads per message per the cardinality requirements.
+ * Ads are kept sorted by `content_offset` so they can be interleaved with the
+ * message text at the point in the stream where they arrived.
+ */
+declare function useAdzenInlineAds(): UseAdzenInlineAdsReturn;
+
 /**
  * Checks whether an AG-UI event is an `adzen_placement` custom event
  * and, if so, dispatches it as a browser `CustomEvent` on `window`
  * so that `useAdzenPlacement` can pick it up.
  *
- * Call this for every event returned by `AdzenAsyncMiddleware.processEvent()`.
- * Non-placement events are silently ignored.
+ * Call this for every event returned by middleware `processEvent()` or
+ * `processStream()`. Non-placement events are silently ignored.
  */
 declare function dispatchPlacementEvent(event: Record<string, unknown>): boolean;
 /**
- * Convenience wrapper: iterates an array of AG-UI events (as returned by
- * `AdzenAsyncMiddleware.processEvent()`) and dispatches any placement
- * events to the browser.
+ * Checks whether an AG-UI event is an `adzen_inline_ad` custom event
+ * and, if so, dispatches it as a browser `CustomEvent` on `window`
+ * so that `useAdzenInlineAds` can pick it up.
+ */
+declare function dispatchInlineAdEvent(event: Record<string, unknown>): boolean;
+/**
+ * Convenience wrapper: iterates an array of AG-UI events and dispatches
+ * any placement or inline ad events to the browser.
  */
 declare function dispatchPlacementEvents(events: Record<string, unknown>[]): void;
 
-export { AdzenCard, type AdzenCardProps, type UseAdzenPlacementReturn, dispatchPlacementEvent, dispatchPlacementEvents, useAdzenPlacement };
+export { AdzenCard, type AdzenCardProps, InlineAd, type InlineAdProps, type InlineAdSegment, type UseAdzenInlineAdsReturn, type UseAdzenPlacementReturn, buildInlineAdSegments, dispatchInlineAdEvent, dispatchPlacementEvent, dispatchPlacementEvents, useAdzenInlineAds, useAdzenPlacement };

package/dist/copilotkit/react/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { AdzenPlacement } from '@adzenai/core';
+import { InlineAdEvent, AdzenPlacement, InlineAdEventPayload } from '@adzenai/core';
 
 interface AdzenCardProps {
     messageId: string;
@@ -13,6 +13,20 @@ interface AdzenCardProps {
  */
 declare function AdzenCard({ messageId, adUnitPosition, viewabilityThresholdMs, className, }: AdzenCardProps): react.JSX.Element | null;
 
+interface InlineAdProps {
+    ad: InlineAdEvent;
+    viewabilityThresholdMs?: number;
+    className?: string;
+}
+/**
+ * Renders an inline ad as a single line of text — an "Ad" pill, the advertiser
+ * name, and the CTA as the only link — rather than a card, so it sits in the
+ * message body without competing with the assistant's own content.
+ *
+ * Tracks render/view impressions via the same beacon pattern as AdzenCard.
+ */
+declare function InlineAd({ ad, viewabilityThresholdMs, className, }: InlineAdProps): react.JSX.Element;
+
 interface UseAdzenPlacementReturn {
     getAdForMessage(messageId: string): AdzenPlacement | null;
     placements: Map<string, AdzenPlacement>;
@@ -26,20 +40,62 @@ interface UseAdzenPlacementReturn {
  */
 declare function useAdzenPlacement(): UseAdzenPlacementReturn;
 
+/** A run of message text, or an ad anchored to the end of the run before it. */
+type InlineAdSegment = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "ad";
+    ad: InlineAdEventPayload;
+};
+interface UseAdzenInlineAdsReturn {
+    getInlineAdsForMessage(messageId: string): InlineAdEventPayload[];
+    getInlineAdSegments(messageId: string, content: string): InlineAdSegment[];
+}
+/**
+ * Splits `content` into text and ad segments, placing each ad after the text
+ * that had streamed when it arrived.
+ *
+ * At most one ad is placed per paragraph break. Several ads routinely resolve
+ * to the same break — the API can emit a burst of them, and every ad anchored
+ * inside one paragraph snaps to that paragraph's end — so each ad after the
+ * first is moved to the next free break, with the end of the content usable as
+ * a final slot. An ad with no free slot is left out and appears once the
+ * message has grown enough to hold it, which keeps ads from piling up in one
+ * spot while a paragraph is still streaming.
+ *
+ * @param ads Must be sorted by `content_offset` ascending.
+ */
+declare function buildInlineAdSegments(content: string, ads: InlineAdEventPayload[]): InlineAdSegment[];
+/**
+ * React hook that subscribes to `adzen_inline_ad` custom events on
+ * `window` and maintains a map of messageId -> InlineAdEventPayload[].
+ *
+ * Supports multiple inline ads per message per the cardinality requirements.
+ * Ads are kept sorted by `content_offset` so they can be interleaved with the
+ * message text at the point in the stream where they arrived.
+ */
+declare function useAdzenInlineAds(): UseAdzenInlineAdsReturn;
+
 /**
  * Checks whether an AG-UI event is an `adzen_placement` custom event
  * and, if so, dispatches it as a browser `CustomEvent` on `window`
  * so that `useAdzenPlacement` can pick it up.
  *
- * Call this for every event returned by `AdzenAsyncMiddleware.processEvent()`.
- * Non-placement events are silently ignored.
+ * Call this for every event returned by middleware `processEvent()` or
+ * `processStream()`. Non-placement events are silently ignored.
  */
 declare function dispatchPlacementEvent(event: Record<string, unknown>): boolean;
 /**
- * Convenience wrapper: iterates an array of AG-UI events (as returned by
- * `AdzenAsyncMiddleware.processEvent()`) and dispatches any placement
- * events to the browser.
+ * Checks whether an AG-UI event is an `adzen_inline_ad` custom event
+ * and, if so, dispatches it as a browser `CustomEvent` on `window`
+ * so that `useAdzenInlineAds` can pick it up.
+ */
+declare function dispatchInlineAdEvent(event: Record<string, unknown>): boolean;
+/**
+ * Convenience wrapper: iterates an array of AG-UI events and dispatches
+ * any placement or inline ad events to the browser.
  */
 declare function dispatchPlacementEvents(events: Record<string, unknown>[]): void;
 
-export { AdzenCard, type AdzenCardProps, type UseAdzenPlacementReturn, dispatchPlacementEvent, dispatchPlacementEvents, useAdzenPlacement };
+export { AdzenCard, type AdzenCardProps, InlineAd, type InlineAdProps, type InlineAdSegment, type UseAdzenInlineAdsReturn, type UseAdzenPlacementReturn, buildInlineAdSegments, dispatchInlineAdEvent, dispatchPlacementEvent, dispatchPlacementEvents, useAdzenInlineAds, useAdzenPlacement };