@blocksdiy/react-common 1.63.1 → 1.64.0

package/dist/hooks/floating-agent-chat.d.ts

@@ -10,8 +10,10 @@ export interface FloatingAgentChatHandle {
 /** What to open: a conversation (`{ chatThreadId }`; a deprecated `chatId` on it is ignored), or the new chat. */
 export type FloatingAgentChatTarget = AgentConversationRef | "new";
 /**
- * How the open session shows: the floating prompt — the new chat as a one-line composer, until
- * its first send — or the panel with the conversation. One engine underneath either way.
+ * How the open session shows: the panel with the conversation. `prompt` — the new chat as a
+ * one-line composer until its first send — is retired: the controller never opens it. The type
+ * keeps it for the registry item's faces and the reducers until the item drops the prompt parts
+ * (the agent-chat item's RETIRED-PROMPT note says when).
  */
 export type FloatingAgentChatFace = "prompt" | "panel";
 /**
@@ -33,7 +35,7 @@ export interface FloatingAgentChatOpenOptions<Handle extends FloatingAgentChatHa
     newChatHref?: string;
     /** Extra context handed to the agent on every turn (like `AgentChat`'s `chatContext`). */
     chatContext?: unknown;
-    /** The face to open with — the panel by default; the prompt always opens the new chat. */
+    /** Ignored: the controller opens the panel. `prompt` is retired. */
     face?: FloatingAgentChatFace;
 }
 /** The open options with the ids resolved from the handle. */

package/dist/hooks/floating-agent-chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floating-agent-chat.d.ts","sourceRoot":"","sources":["../../src/hooks/floating-agent-chat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"floating-agent-chat.d.ts","sourceRoot":"","sources":["../../src/hooks/floating-agent-chat.ts"],"names":[],"mappings":"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"}

package/dist/hooks/floating-agent-chat.js

@@ -1,10 +1,10 @@
 // The floating agent chat's state, headless: what the open session shows (which agent, which
-// conversation), the face it wears (the floating prompt until a new chat's first send, the panel
-// after), the draft the new chat is until that send, and the opener that gets focus back on
-// close. The agent-chat registry item renders it. Mirrors the conversation selection rules of
-// useAgentConversationSelection: a new chat is a draft minted here and listed nowhere until the
-// first send; "New chat" on an untouched draft keeps it; a thread opened beside it leaves it
-// standing by. The reducers are pure and tested; the hook is the thin React shell.
+// conversation), the face it wears (the panel; see FloatingAgentChatFace), the draft the new
+// chat is until that send, and the opener that gets focus back on close. The agent-chat registry
+// item renders it. Mirrors the conversation selection rules of useAgentConversationSelection: a
+// new chat is a draft minted here and listed nowhere until the first send; "New chat" on an
+// untouched draft keeps it; a thread opened beside it leaves it standing by. The reducers are
+// pure and tested; the hook is the thin React shell.
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 /** The panel shows the new chat, nothing sent on it yet. */
 export const isFloatingAgentChatDraft = (state) => state.conversation.chatThreadId === state.draftThreadId && !state.draftSent;
@@ -82,7 +82,7 @@ export const useFloatingAgentChatController = () => {
                 agentChat: options.agentChat,
                 agentChatId,
                 target: options.target ?? "new",
-                face: options.face ?? "panel",
+                face: "panel",
                 expandHref: options.expandHref,
                 newChatHref: options.newChatHref,
                 chatContext: options.chatContext,

package/dist/hooks/floating-agent-prompt-requests.js

@@ -1,10 +1,10 @@
-// The platform's door to an app's floating agent prompt. The platform asks through the iframe
-// bridge; app-render, which answers the bridge, posts the request here; the app's
-// FloatingAgentChatProvider, which renders the prompt, subscribes. Both run in the iframe on
-// this one module (`@blocksdiy/react-common/agent-threads` is a UMD external the bundle takes
-// from app-render), so no window global is needed. A request posted before the provider mounts
-// (the bundle is still loading) waits for it; one nothing claims in time is dropped and the
-// platform told — an app built without the prompt.
+// The platform's door to an app's floating agent chat: a new chat with one of its agents, in
+// the panel. The platform asks through the iframe bridge; app-render, which answers the bridge,
+// posts the request here; the app's FloatingAgentChatProvider, which renders the chat,
+// subscribes. Both run in the iframe on this one module (`@blocksdiy/react-common/agent-threads`
+// is a UMD external the bundle takes from app-render), so no window global is needed. A request
+// posted before the provider mounts (the bundle is still loading) waits for it; one nothing
+// claims in time is dropped and the platform told — an app built without the floating chat.
 /** How long a request waits for a subscriber before it is withdrawn. */
 export const FLOATING_AGENT_PROMPT_CLAIM_TIMEOUT_MS = 5000;
 // Read at call time, so a test's fake timers apply.

package/dist/hooks/floating-agent-prompt.d.ts

@@ -1,17 +1,26 @@
-import type { FloatingAgentChatExpandHref, FloatingAgentChatHandle, UseFloatingAgentChatControllerResult } from "./floating-agent-chat.js";
+import type { FloatingAgentChatExpandHref, FloatingAgentChatHandle, FloatingAgentChatOpenOptions, UseFloatingAgentChatControllerResult } from "./floating-agent-chat.js";
 /**
- * One agent the prompt can open, as the app resolved it: its id (the agent block's name — what
- * the platform asks for), the agent's own chat the session opens, and where the panel's expand
- * goes for a conversation started here.
+ * One agent on offer, as the app resolved it: its id (the agent block's name — what the
+ * platform asks for), the agent's own chat the session opens, and where the panel's expand
+ * goes for a conversation started here — and for the new chat, nothing sent on it yet.
  */
 export interface FloatingAgentPromptAgentEntry<Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle> {
     id: string;
     agentChatId: string;
     handle: Handle;
     expandHref?: FloatingAgentChatExpandHref;
+    /** The agent's full-page new chat (its mini-app's `/new`); without it the new chat has no expand. */
+    newChatHref?: string;
 }
 /** The entry for an id, or the first entry when none is named; null for an id not on offer, or without entries. */
 export declare const resolveFloatingAgentPromptAgent: <Handle extends FloatingAgentChatHandle>(agents: readonly FloatingAgentPromptAgentEntry<Handle>[], agentId?: string) => FloatingAgentPromptAgentEntry<Handle> | null;
+/**
+ * The open for one of the agents on offer: a new chat with it, which expands to the agent's
+ * new-chat page, and to the thread's page once sent. Null when there is nothing to open — no
+ * agents, the agent asked for not among them, an anonymous visitor — so the platform falls back
+ * to the agent's own new-chat page.
+ */
+export declare const floatingAgentPromptOpen: <Handle extends FloatingAgentChatHandle>(agents: readonly FloatingAgentPromptAgentEntry<Handle>[], agentId: string | undefined, canOpen: boolean, chatContext?: unknown) => FloatingAgentChatOpenOptions<Handle> | null;
 /** What the open agent's chat lends the prompt, which renders outside it (it shows while the chat loads). */
 export interface FloatingAgentPromptChat {
     canSend: boolean;
@@ -24,34 +33,33 @@ export interface FloatingAgentPromptOpenOptions {
     chatContext?: unknown;
 }
 export interface UseFloatingAgentPromptControllerOptions<Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle> {
-    /** The session the prompt opens: one controller per app. */
+    /** The session the doors open: one controller per app. */
     session: UseFloatingAgentChatControllerResult<Handle>;
     agents: readonly FloatingAgentPromptAgentEntry<Handle>[];
     /** False for an anonymous visitor: nothing opens, and the platform's requests go unclaimed. */
     canOpen: boolean;
 }
 export interface UseFloatingAgentPromptControllerResult {
-    /** The session wears the prompt face. */
+    /** The session wears the prompt face: never. */
     isOpen: boolean;
     /** The open session's agent, as an entry id; null while nothing is open or for an agent not on offer. */
     agentId: string | null;
-    /** True once the prompt opened; false without agents, for an agent not on offer, or for an anonymous visitor. */
+    /**
+     * Opens a new chat with the agent in the floating chat panel ({@link floatingAgentPromptOpen}).
+     * True once it opened; false without agents, for an agent not on offer, or for an anonymous visitor.
+     */
     openPrompt: (options?: FloatingAgentPromptOpenOptions) => boolean;
+    /** The prompt's text: always empty. */
     text: string;
     setText: (text: string) => void;
-    /** Counts the opens, re-points included — the message takes focus on each. */
+    /** The prompt's opens: always zero. */
     openCount: number;
-    /** The open agent's chat is up and free. */
+    /** The prompt can send: never. */
     canSend: boolean;
-    /** Sends through the open agent's chat; its first send turns the prompt into the panel. */
+    /** No-op, like `setText` and `setChat`. */
     send: (content: string) => void;
-    /** The open agent's chat lends itself here once it is up, and takes itself back when it goes. */
     setChat: (chat: FloatingAgentPromptChat | null) => void;
 }
-/**
- * The prompt's state and transitions, for the one provider at the app's root. A fresh prompt
- * starts empty; re-pointing it at another agent keeps the text; a sent message is the chat's
- * (the pill is gone), a refused one stays where it was.
- */
+/** The doors, for the one provider at the app's root, with the prompt's fixed state. */
 export declare const useFloatingAgentPromptController: <Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle>({ session, agents, canOpen, }: UseFloatingAgentPromptControllerOptions<Handle>) => UseFloatingAgentPromptControllerResult;
 //# sourceMappingURL=floating-agent-prompt.d.ts.map

package/dist/hooks/floating-agent-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floating-agent-prompt.d.ts","sourceRoot":"","sources":["../../src/hooks/floating-agent-prompt.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,oCAAoC,EACrC,MAAM,uBAAuB,CAAC;AAG/B;;;;GAIG;AACH,MAAM,WAAW,6BAA6B,CAAC,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IAC7G,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,2BAA2B,CAAC;CAC1C;AAED,mHAAmH;AACnH,eAAO,MAAM,+BAA+B,GAAI,MAAM,SAAS,uBAAuB,EACpF,QAAQ,SAAS,6BAA6B,CAAC,MAAM,CAAC,EAAE,EACxD,UAAU,MAAM,KACf,6BAA6B,CAAC,MAAM,CAAC,GAAG,IACiD,CAAC;AAE7F,6GAA6G;AAC7G,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,8BAA8B;IAC7C,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,uCAAuC,CACtD,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IAEhE,4DAA4D;IAC5D,OAAO,EAAE,oCAAoC,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,SAAS,6BAA6B,CAAC,MAAM,CAAC,EAAE,CAAC;IACzD,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sCAAsC;IACrD,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,yGAAyG;IACzG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iHAAiH;IACjH,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,8BAA8B,KAAK,OAAO,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,iGAAiG;IACjG,OAAO,EAAE,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,KAAK,IAAI,CAAC;CACzD;AAED;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAAI,MAAM,SAAS,uBAAuB,GAAG,uBAAuB,EAAE,+BAIhH,uCAAuC,CAAC,MAAM,CAAC,KAAG,sCAwDpD,CAAC"}
+{"version":3,"file":"floating-agent-prompt.d.ts","sourceRoot":"","sources":["../../src/hooks/floating-agent-prompt.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,oCAAoC,EACrC,MAAM,uBAAuB,CAAC;AAG/B;;;;GAIG;AACH,MAAM,WAAW,6BAA6B,CAAC,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IAC7G,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mHAAmH;AACnH,eAAO,MAAM,+BAA+B,GAAI,MAAM,SAAS,uBAAuB,EACpF,QAAQ,SAAS,6BAA6B,CAAC,MAAM,CAAC,EAAE,EACxD,UAAU,MAAM,KACf,6BAA6B,CAAC,MAAM,CAAC,GAAG,IACiD,CAAC;AAE7F;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM,SAAS,uBAAuB,EAC5E,QAAQ,SAAS,6BAA6B,CAAC,MAAM,CAAC,EAAE,EACxD,SAAS,MAAM,GAAG,SAAS,EAC3B,SAAS,OAAO,EAChB,cAAc,OAAO,KACpB,4BAA4B,CAAC,MAAM,CAAC,GAAG,IAMzC,CAAC;AAEF,6GAA6G;AAC7G,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,8BAA8B;IAC7C,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,uCAAuC,CACtD,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IAEhE,0DAA0D;IAC1D,OAAO,EAAE,oCAAoC,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,SAAS,6BAA6B,CAAC,MAAM,CAAC,EAAE,CAAC;IACzD,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sCAAsC;IACrD,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,yGAAyG;IACzG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,8BAA8B,KAAK,OAAO,CAAC;IAClE,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,KAAK,IAAI,CAAC;CACzD;AAID,wFAAwF;AACxF,eAAO,MAAM,gCAAgC,GAAI,MAAM,SAAS,uBAAuB,GAAG,uBAAuB,EAAE,+BAIhH,uCAAuC,CAAC,MAAM,CAAC,KAAG,sCAqDpD,CAAC"}

package/dist/hooks/floating-agent-prompt.js

@@ -1,42 +1,42 @@
-// The floating agent prompt's state, headless: which of the app's agents it is for, the text
-// typed, the opens (the message takes focus on each), what the open agent's chat lends it (can it
-// send, the send), and the platform's requests for it (the rail's chat bubble, through
-// app-render's mailbox). The session it opens is useFloatingAgentChatController's; the
-// agent-chat registry item resolves the agents and renders the prompt.
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+// The floating agent chat's doors for the app's agents, headless: a page's `openPrompt` and the
+// platform's requests for one of the agents (the rail's chat bubble, through app-render's
+// mailbox) open a new chat with the agent in the floating chat panel. The one-line prompt face
+// is retired — the session never wears it — so its state below is fixed; it stays for the
+// agent-chat registry item's prompt parts. The session is useFloatingAgentChatController's; the
+// registry item resolves the agents.
+import { useCallback, useEffect, useMemo, useRef } from "react";
 import { subscribeFloatingAgentPromptRequests } from "./floating-agent-prompt-requests.js";
 /** The entry for an id, or the first entry when none is named; null for an id not on offer, or without entries. */
 export const resolveFloatingAgentPromptAgent = (agents, agentId) => (agentId === undefined ? agents[0] : agents.find((entry) => entry.id === agentId)) ?? null;
 /**
- * The prompt's state and transitions, for the one provider at the app's root. A fresh prompt
- * starts empty; re-pointing it at another agent keeps the text; a sent message is the chat's
- * (the pill is gone), a refused one stays where it was.
+ * The open for one of the agents on offer: a new chat with it, which expands to the agent's
+ * new-chat page, and to the thread's page once sent. Null when there is nothing to open — no
+ * agents, the agent asked for not among them, an anonymous visitor — so the platform falls back
+ * to the agent's own new-chat page.
  */
+export const floatingAgentPromptOpen = (agents, agentId, canOpen, chatContext) => {
+    const entry = resolveFloatingAgentPromptAgent(agents, agentId);
+    if (!entry || !canOpen) {
+        return null;
+    }
+    return { agentChat: entry.handle, expandHref: entry.expandHref, newChatHref: entry.newChatHref, chatContext };
+};
+const noop = () => { };
+/** The doors, for the one provider at the app's root, with the prompt's fixed state. */
 export const useFloatingAgentPromptController = ({ session, agents, canOpen, }) => {
     const { state, open } = session;
-    const isOpen = state !== null && state.face === "prompt";
-    const [text, setText] = useState("");
-    const [openCount, setOpenCount] = useState(0);
-    const [chat, setChat] = useState(null);
-    // Opens the prompt for an agent; false when there is nothing to open — no agents, the agent
-    // asked for not among them, an anonymous visitor.
+    // Opens the agent's new chat; false when there is nothing to open.
     const openFor = useCallback((agentId, chatContext) => {
-        const entry = resolveFloatingAgentPromptAgent(agents, agentId);
-        if (!entry || !canOpen) {
-            return false;
-        }
-        if (!isOpen) {
-            setText("");
+        const openOptions = floatingAgentPromptOpen(agents, agentId, canOpen, chatContext);
+        if (openOptions) {
+            open(openOptions);
         }
-        setOpenCount((count) => count + 1);
-        // No `newChatHref`: the prompt has no header, and its first send makes the new chat a thread.
-        open({ agentChat: entry.handle, face: "prompt", expandHref: entry.expandHref, chatContext });
-        return true;
-    }, [agents, canOpen, isOpen, open]);
+        return openOptions !== null;
+    }, [agents, canOpen, open]);
     const openPrompt = useCallback((options) => {
         const opened = openFor(options?.agent, options?.chatContext);
         if (!opened) {
-            console.warn("Floating agent prompt: nothing to open — it needs agents on offer (the one asked for among them) and a signed-in user.");
+            console.warn("Floating agent chat: nothing to open — it needs agents on offer (the one asked for among them) and a signed-in user.");
         }
         return opened;
     }, [openFor]);
@@ -50,7 +50,15 @@ export const useFloatingAgentPromptController = ({ session, agents, canOpen, })
     }, [openFor]);
     useEffect(() => subscribeFloatingAgentPromptRequests((request) => openForRef.current(request.agent)), []);
     const agentId = state === null ? null : (agents.find((entry) => entry.agentChatId === state.agentChatId)?.id ?? null);
-    const canSend = chat?.canSend ?? false;
-    const send = useCallback((content) => chat?.send(content), [chat]);
-    return useMemo(() => ({ isOpen, agentId, openPrompt, text, setText, openCount, canSend, send, setChat }), [isOpen, agentId, openPrompt, text, openCount, canSend, send]);
+    return useMemo(() => ({
+        isOpen: false,
+        agentId,
+        openPrompt,
+        text: "",
+        setText: noop,
+        openCount: 0,
+        canSend: false,
+        send: noop,
+        setChat: noop,
+    }), [agentId, openPrompt]);
 };

package/dist/iframe-communication/types.d.ts

@@ -120,9 +120,9 @@ export interface IframeApi extends Methods {
      */
     onLockChatComponentFocus: (isLocked: boolean) => Promise<void>;
     /**
-     * Opens the app's floating agent prompt for one of its agents (`agent` is the agent's block
-     * name). Resolves `false` when nothing in the app took the request — an app built without the
-     * prompt — so the platform can fall back to the agent's own new-chat page.
+     * Opens a new chat with one of the app's agents in its floating agent chat panel (`agent` is
+     * the agent's block name). Resolves `false` when nothing in the app took the request — an app
+     * built without the floating chat — so the platform can fall back to the agent's own new-chat page.
      */
     onOpenAgentPrompt: (args: {
         agent: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocksdiy/react-common",
-  "version": "1.63.1",
+  "version": "1.64.0",
   "type": "module",
   "description": "React common",
   "keywords": [],