@cntyclub/agent-react 0.12.0 → 0.13.0

package/dist/components/agent-widget.d.ts

@@ -5,6 +5,17 @@ export interface AgentWidgetProps {
     /** Controlled open state (optional). */
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /**
+     * How the panel is presented:
+     * - `"floating"` (default): a launcher button + a popup/fullscreen panel,
+     *   positioned by the widget itself (fixed to a screen corner).
+     * - `"docked"`: no launcher; the panel fills its parent element so the host
+     *   can place it in the layout (e.g. a resizable side pane on desktop, or a
+     *   fullscreen overlay on smaller screens). Open state is controlled by the
+     *   host via `open`/`onOpenChange`. Page-follow navigation stays enabled so
+     *   the agent can drive the main view alongside the chat.
+     */
+    presentation?: "floating" | "docked";
 }
 /**
  * The embeddable Agent Mode widget.
@@ -19,5 +30,5 @@ export interface AgentWidgetProps {
  * corner; size morph between popup and fullscreen). All colors come from the
  * host app's UI-kit theme tokens.
  */
-export declare function AgentWidget({ config, onOpenChange, open: controlledOpen }: AgentWidgetProps): React.JSX.Element;
+export declare function AgentWidget({ config, onOpenChange, open: controlledOpen, presentation, }: AgentWidgetProps): React.JSX.Element;
 //# sourceMappingURL=agent-widget.d.ts.map

package/dist/components/agent-widget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-widget.d.ts","sourceRoot":"","sources":["../../src/components/agent-widget.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,UAAU,CAAC;AAK1D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,gBAAgB,qBAqR3F"}
+{"version":3,"file":"agent-widget.d.ts","sourceRoot":"","sources":["../../src/components/agent-widget.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,UAAU,CAAC;AAK1D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CACtC;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,YAAY,EACZ,IAAI,EAAE,cAAc,EACpB,YAAyB,GAC1B,EAAE,gBAAgB,qBA2TlB"}

package/dist/index.js

@@ -2120,10 +2120,16 @@ function isUnreadable(message) {
   if (message.id.startsWith("streaming-")) return false;
   return message.role === "assistant" || message.role === "tool";
 }
-function AgentWidget({ config, onOpenChange, open: controlledOpen }) {
+function AgentWidget({
+  config,
+  onOpenChange,
+  open: controlledOpen,
+  presentation = "floating"
+}) {
   const behavior = config.behavior ?? {};
   const position = config.appearance?.position ?? "bottom-right";
   const isControlled = controlledOpen !== void 0;
+  const isDocked = presentation === "docked";
   const storageKey2 = `cc-agent-open:${config.clientId}`;
   const [uncontrolledOpen, setUncontrolledOpen] = React11.useState(false);
   const open = controlledOpen ?? uncontrolledOpen;
@@ -2154,7 +2160,8 @@ function AgentWidget({ config, onOpenChange, open: controlledOpen }) {
   const { messages, pendingApprovals, resolveApproval, resolvingApprovalId, sending } = chat;
   const bootRef = React11.useRef(false);
   React11.useEffect(() => {
-    if (isControlled || bootRef.current) return;
+    if (bootRef.current) return;
+    if (isControlled && !isDocked) return;
     bootRef.current = true;
     let cancelled = false;
     void (async () => {
@@ -2164,17 +2171,19 @@ function AgentWidget({ config, onOpenChange, open: controlledOpen }) {
         if (list.length) await chat.openConversation(list[0].id);
         if (cancelled) return;
       }
-      let shouldOpen = behavior.initialOpen ?? false;
-      if (behavior.persistOpenState) {
-        try {
-          const stored = window.localStorage.getItem(storageKey2);
-          if (stored !== null) shouldOpen = stored === "1";
-        } catch {
+      if (!isControlled) {
+        let shouldOpen = behavior.initialOpen ?? false;
+        if (behavior.persistOpenState) {
+          try {
+            const stored = window.localStorage.getItem(storageKey2);
+            if (stored !== null) shouldOpen = stored === "1";
+          } catch {
+          }
+        }
+        if (shouldOpen) {
+          setUncontrolledOpen(true);
+          onOpenChange?.(true);
         }
-      }
-      if (shouldOpen) {
-        setUncontrolledOpen(true);
-        onOpenChange?.(true);
       }
       setBootstrapDone(true);
     })();
@@ -2244,7 +2253,7 @@ function AgentWidget({ config, onOpenChange, open: controlledOpen }) {
     setAgentMode(false);
   }, [setOpen]);
   const transformOrigin = position === "bottom-left" ? "bottom left" : "bottom right";
-  const launcherHidden = open || config.appearance?.hideLauncher;
+  const launcherHidden = open || config.appearance?.hideLauncher || isDocked;
   return /* @__PURE__ */ jsxs(TooltipProvider, { children: [
     /* @__PURE__ */ jsx(AnimatePresence, { children: !launcherHidden ? /* @__PURE__ */ jsxs(
       motion.div,
@@ -2289,7 +2298,32 @@ function AgentWidget({ config, onOpenChange, open: controlledOpen }) {
       },
       "agent-launcher"
     ) : null }),
-    /* @__PURE__ */ jsx(AnimatePresence, { children: open ? /* @__PURE__ */ jsx(
+    isDocked ? /* @__PURE__ */ jsx(AnimatePresence, { children: open ? /* @__PURE__ */ jsx(
+      motion.div,
+      {
+        initial: { opacity: 0, x: 28 },
+        animate: { opacity: 1, x: 0 },
+        exit: { opacity: 0, x: 28 },
+        transition: { type: "spring", stiffness: 260, damping: 30 },
+        className: "flex h-full w-full flex-col overflow-hidden bg-background",
+        children: /* @__PURE__ */ jsx(
+          AgentPanel,
+          {
+            agentMode: false,
+            canToggleAgentMode: false,
+            chat,
+            className: "flex-1",
+            config,
+            newMessageAnchorId: anchorId,
+            onAlwaysApprove: alwaysApprove.setAlwaysApprove,
+            onClose: closePanel,
+            onToggleAgentMode: () => {
+            }
+          }
+        )
+      },
+      "agent-docked"
+    ) : null }) : /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(AnimatePresence, { children: open ? /* @__PURE__ */ jsx(
       motion.div,
       {
         layout: true,
@@ -2329,7 +2363,7 @@ function AgentWidget({ config, onOpenChange, open: controlledOpen }) {
         )
       },
       "agent-panel"
-    ) : null })
+    ) : null }) })
   ] });
 }
 function StatusChip({