@blocksdiy/react-common 1.54.0 → 1.55.1

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

@@ -0,0 +1,64 @@
+export type FloatingAgentChatEnginePhase = "loading" | "ready" | "error";
+export interface FloatingAgentChatEngineState {
+    /** Which engine this is: the agent's chat and the load attempt ({@link floatingAgentChatEngineKey}). */
+    key: string;
+    isReady: boolean;
+    loadError: Error | null;
+}
+export declare const floatingAgentChatEngineKey: (agentChatId: string, attempt: number) => string;
+/** A fresh engine: nothing reported yet. */
+export declare const floatingAgentChatEngineFor: (key: string) => FloatingAgentChatEngineState;
+/** The engine with this key is up. A report from an engine since replaced changes nothing. */
+export declare const floatingAgentChatEngineReady: (prev: FloatingAgentChatEngineState, key: string) => FloatingAgentChatEngineState;
+/** The engine with this key could not load. A report from an engine since replaced changes nothing. */
+export declare const floatingAgentChatEngineFailed: (prev: FloatingAgentChatEngineState, key: string, loadError: Error) => FloatingAgentChatEngineState;
+/** Ready once up; failed only while not up; loading before either. */
+export declare const floatingAgentChatEnginePhase: (state: FloatingAgentChatEngineState) => FloatingAgentChatEnginePhase;
+export interface UseFloatingAgentChatEngineResult {
+    /** The runtime's key: another agent, or a retry, is another runtime. */
+    key: string;
+    phase: FloatingAgentChatEnginePhase;
+    /** The runtime's parts are up (it resolved the agent). */
+    onReady: () => void;
+    /** The runtime could not load the agent. */
+    onLoadError: (error: Error) => void;
+    /** Starts over after a failed load: a new key, so the host mounts a new runtime. */
+    retry: () => void;
+}
+/** The engine's phase for the agent the session shows; reset the moment another agent takes over. */
+export declare const useFloatingAgentChatEngine: (agentChatId: string) => UseFloatingAgentChatEngineResult;
+/** What the URL on screen tells: the page's route params, and its query as an object. */
+export interface FloatingAgentChatUrlContext {
+    routeParams: Readonly<Record<string, string | undefined>>;
+    /** A key's value — its values, when the key repeats (`?tag=a&tag=b`). */
+    searchParams: Record<string, string | string[]>;
+}
+/** The query as an object: a key's value, or its values when the key repeats. */
+export declare const floatingAgentChatSearchParams: (params: URLSearchParams) => FloatingAgentChatUrlContext["searchParams"];
+/**
+ * The context the engine sends: the provider's (the app's, for every floating conversation), the
+ * opener's over it (a sidebar pick's layout context, `open`'s or `openPrompt`'s — key by key),
+ * and `urlContext` beside them. A plain object's keys stay at the top level (an agent's initial
+ * messages read `{{chatContext.<key>}}`); anything else goes under `context`.
+ */
+export declare const floatingAgentChatContext: (provided: unknown, opener: unknown, urlContext: FloatingAgentChatUrlContext) => {
+    urlContext: FloatingAgentChatUrlContext;
+};
+export interface UseFloatingAgentChatContextOptions {
+    /** The provider's context: the app's, for every floating conversation. */
+    provided: unknown;
+    /** The opener's context, over the provider's. */
+    opener: unknown;
+    /** The router's values — react-common knows no router; the host passes `useParams()`'s and `useSearchParams()`'s. */
+    routeParams: FloatingAgentChatUrlContext["routeParams"];
+    searchParams: URLSearchParams;
+}
+/**
+ * The context the engine sends with every turn, memoized on the URL's content (the router hands
+ * out a fresh params object on every render of its host) and the contexts' identity: the engine
+ * re-renders for a change of the URL or of a context, never for one of the surface or its host.
+ */
+export declare const useFloatingAgentChatContext: ({ provided, opener, routeParams, searchParams, }: UseFloatingAgentChatContextOptions) => {
+    urlContext: FloatingAgentChatUrlContext;
+};
+//# sourceMappingURL=floating-agent-chat-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"floating-agent-chat-engine.d.ts","sourceRoot":"","sources":["../../src/hooks/floating-agent-chat-engine.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzE,MAAM,WAAW,4BAA4B;IAC3C,wGAAwG;IACxG,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;CACzB;AAED,eAAO,MAAM,0BAA0B,GAAI,aAAa,MAAM,EAAE,SAAS,MAAM,KAAG,MAAqC,CAAC;AAExH,4CAA4C;AAC5C,eAAO,MAAM,0BAA0B,GAAI,KAAK,MAAM,KAAG,4BAIvD,CAAC;AAEH,8FAA8F;AAC9F,eAAO,MAAM,4BAA4B,GACvC,MAAM,4BAA4B,EAClC,KAAK,MAAM,KACV,4BAAsF,CAAC;AAE1F,uGAAuG;AACvG,eAAO,MAAM,6BAA6B,GACxC,MAAM,4BAA4B,EAClC,KAAK,MAAM,EACX,WAAW,KAAK,KACf,4BAAkF,CAAC;AAEtF,sEAAsE;AACtE,eAAO,MAAM,4BAA4B,GAAI,OAAO,4BAA4B,KAAG,4BAClB,CAAC;AAElE,MAAM,WAAW,gCAAgC;IAC/C,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,4BAA4B,CAAC;IACpC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4CAA4C;IAC5C,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,oFAAoF;IACpF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,qGAAqG;AACrG,eAAO,MAAM,0BAA0B,GAAI,aAAa,MAAM,KAAG,gCAiBhE,CAAC;AAEF,yFAAyF;AACzF,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC1D,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CACjD;AAED,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,GAAI,QAAQ,eAAe,KAAG,2BAA2B,CAAC,cAAc,CAQjH,CAAC;AASF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,OAAO,EACjB,QAAQ,OAAO,EACf,YAAY,2BAA2B;;CAKvC,CAAC;AAEH,MAAM,WAAW,kCAAkC;IACjD,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,qHAAqH;IACrH,WAAW,EAAE,2BAA2B,CAAC,aAAa,CAAC,CAAC;IACxD,YAAY,EAAE,eAAe,CAAC;CAC/B;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,kDAKzC,kCAAkC;;CAWpC,CAAC"}

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

@@ -0,0 +1,72 @@
+// The floating chat's engine, headless: one chat runtime per agent the session shows (and per
+// retry of a failed load), what it reports — up, or failed — is its own, never a previous
+// engine's, and the context it sends with every turn: the app's and the opener's with what the
+// URL on screen tells beside them. The agent-chat registry item mounts the runtime under the
+// key and renders the phase. The reducers are pure and tested; the hooks are the thin React shell.
+import { useCallback, useMemo, useState } from "react";
+export const floatingAgentChatEngineKey = (agentChatId, attempt) => `${agentChatId}:${attempt}`;
+/** A fresh engine: nothing reported yet. */
+export const floatingAgentChatEngineFor = (key) => ({
+    key,
+    isReady: false,
+    loadError: null,
+});
+/** The engine with this key is up. A report from an engine since replaced changes nothing. */
+export const floatingAgentChatEngineReady = (prev, key) => (prev.key === key ? { ...prev, isReady: true } : prev);
+/** The engine with this key could not load. A report from an engine since replaced changes nothing. */
+export const floatingAgentChatEngineFailed = (prev, key, loadError) => (prev.key === key ? { ...prev, loadError } : prev);
+/** Ready once up; failed only while not up; loading before either. */
+export const floatingAgentChatEnginePhase = (state) => state.isReady ? "ready" : state.loadError ? "error" : "loading";
+/** The engine's phase for the agent the session shows; reset the moment another agent takes over. */
+export const useFloatingAgentChatEngine = (agentChatId) => {
+    const [attempt, setAttempt] = useState(0);
+    const key = floatingAgentChatEngineKey(agentChatId, attempt);
+    const [state, setState] = useState(() => floatingAgentChatEngineFor(key));
+    // Another engine took over: a clean slate, adjusted during render so nothing commits with a
+    // previous engine's readiness.
+    if (state.key !== key) {
+        setState(floatingAgentChatEngineFor(key));
+    }
+    const onReady = useCallback(() => setState((prev) => floatingAgentChatEngineReady(prev, key)), [key]);
+    const onLoadError = useCallback((error) => setState((prev) => floatingAgentChatEngineFailed(prev, key, error)), [key]);
+    const retry = useCallback(() => setAttempt((count) => count + 1), []);
+    const phase = floatingAgentChatEnginePhase(state);
+    return useMemo(() => ({ key, phase, onReady, onLoadError, retry }), [key, phase, onReady, onLoadError, retry]);
+};
+/** The query as an object: a key's value, or its values when the key repeats. */
+export const floatingAgentChatSearchParams = (params) => {
+    // No prototype: a key like `constructor` or `__proto__` is a query key, not an inherited member.
+    const object = Object.create(null);
+    params.forEach((value, key) => {
+        const seen = object[key];
+        object[key] = seen === undefined ? value : [].concat(seen, value);
+    });
+    return object;
+};
+const isPlainObject = (value) => typeof value === "object" && value !== null && Object.getPrototypeOf(value) === Object.prototype;
+/** A context as top-level keys: a plain object's own; anything else under `context`; none for none. */
+const asTopLevelContext = (context) => isPlainObject(context) ? context : context == null ? {} : { context };
+/**
+ * The context the engine sends: the provider's (the app's, for every floating conversation), the
+ * opener's over it (a sidebar pick's layout context, `open`'s or `openPrompt`'s — key by key),
+ * and `urlContext` beside them. A plain object's keys stay at the top level (an agent's initial
+ * messages read `{{chatContext.<key>}}`); anything else goes under `context`.
+ */
+export const floatingAgentChatContext = (provided, opener, urlContext) => ({
+    ...asTopLevelContext(provided),
+    ...asTopLevelContext(opener),
+    urlContext,
+});
+/**
+ * The context the engine sends with every turn, memoized on the URL's content (the router hands
+ * out a fresh params object on every render of its host) and the contexts' identity: the engine
+ * re-renders for a change of the URL or of a context, never for one of the surface or its host.
+ */
+export const useFloatingAgentChatContext = ({ provided, opener, routeParams, searchParams, }) => {
+    const routeParamsJson = JSON.stringify(routeParams);
+    const search = searchParams.toString();
+    return useMemo(() => floatingAgentChatContext(provided, opener, {
+        routeParams: JSON.parse(routeParamsJson),
+        searchParams: floatingAgentChatSearchParams(new URLSearchParams(search)),
+    }), [provided, opener, routeParamsJson, search]);
+};

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

@@ -9,6 +9,11 @@ export interface FloatingAgentChatHandle {
 }
 /** What to open: a conversation (the `chatId` + `chatThreadId` pair), 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.
+ */
+export type FloatingAgentChatFace = "prompt" | "panel";
 /**
  * Where the panel's expand goes for the conversation it shows — the opener knows the full route
  * (an agent mini-app's thread page); `null` hides the expand control. Never asked for a draft:
@@ -23,13 +28,16 @@ export interface FloatingAgentChatOpenOptions<Handle extends FloatingAgentChatHa
     expandHref?: FloatingAgentChatExpandHref;
     /** 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. */
+    face?: FloatingAgentChatFace;
 }
 /** The open options with the ids resolved from the handle. */
-export interface FloatingAgentChatOpenRequest<Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle> extends Omit<FloatingAgentChatOpenOptions<Handle>, "target"> {
+export interface FloatingAgentChatOpenRequest<Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle> extends Omit<FloatingAgentChatOpenOptions<Handle>, "target" | "face"> {
     agentChatId: string;
     /** The chat the agent's own conversations live under (agentInboxChatId). */
     ownChatId: string;
     target: FloatingAgentChatTarget;
+    face: FloatingAgentChatFace;
 }
 export interface FloatingAgentChatState<Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle> {
     agentChat: Handle;
@@ -39,6 +47,7 @@ export interface FloatingAgentChatState<Handle extends FloatingAgentChatHandle =
     /** The draft's thread id — the new chat, until its first send turns it into a thread. */
     draftThreadId: string;
     draftSent: boolean;
+    face: FloatingAgentChatFace;
     expandHref?: FloatingAgentChatExpandHref;
     chatContext?: unknown;
 }
@@ -48,30 +57,34 @@ export declare const isFloatingAgentChatDraft: (state: FloatingAgentChatState) =
  * The state after an open. Within one agent the draft's bookkeeping carries over — the new chat
  * is kept while untouched, stands by while a thread is open, and is minted afresh once sent;
  * another agent starts clean. Opening what is already shown changes nothing but the opener's
- * `expandHref` / `chatContext`.
+ * `expandHref` / `chatContext` (and the face). The prompt face is the new chat by definition:
+ * a prompt open with a thread target opens the new chat.
  */
 export declare const floatingAgentChatAfterOpen: <Handle extends FloatingAgentChatHandle>(prev: FloatingAgentChatState<Handle> | null, request: FloatingAgentChatOpenRequest<Handle>, mintThreadId: () => string) => FloatingAgentChatState<Handle>;
-/** After the first send on the draft; unchanged when the draft is not what is shown. */
+/**
+ * After the first send on the draft: it is a thread now, shown in the panel — the prompt, if
+ * that is what sent it, turns into the panel. Unchanged when the draft is not what is shown.
+ */
 export declare const floatingAgentChatAfterDraftSent: <Handle extends FloatingAgentChatHandle>(prev: FloatingAgentChatState<Handle> | null) => FloatingAgentChatState<Handle> | null;
 export interface UseFloatingAgentChatControllerResult<Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle> {
-    /** What the panel shows; null while it is closed. */
+    /** What the session shows; null while nothing is open. */
     state: FloatingAgentChatState<Handle> | null;
     isOpen: boolean;
-    /** Open (or re-point) the panel. The same agent's draft carries over; another agent starts clean. */
+    /** Open (or re-point) the session. The same agent's draft carries over; another agent starts clean. */
     open: (options: FloatingAgentChatOpenOptions<Handle>) => void;
     close: () => void;
     /**
-     * Close the panel when it shows one of this agent's conversations — for a surface that puts
+     * Close the session when it shows one of this agent's conversations — for a surface that puts
      * that agent's full transcript on screen (an agent mini-app's conversation routes).
      */
     closeForAgent: (agentChatId: string) => void;
-    /** The panel's seam: the draft's first send made it a thread. */
+    /** The engine's seam: the draft's first send made it a thread (and the prompt the panel). */
     markDraftSent: () => void;
 }
 /**
  * The floating agent chat's state and transitions, for ONE provider at the app's root. Remembers
- * what had focus on the open that showed the panel (a sidebar row, an "Ask" button) and hands it
- * back on close, so keyboard users land where they were.
+ * what had focus on the open that showed the session (a sidebar row, an "Ask" button) and hands
+ * it back on close, so keyboard users land where they were.
  */
 export declare const useFloatingAgentChatController: <Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle>() => UseFloatingAgentChatControllerResult<Handle>;
 //# sourceMappingURL=floating-agent-chat.d.ts.map

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":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrE,8FAA8F;AAC9F,MAAM,WAAW,uBAAuB;IACtC,0BAA0B,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1F;AAED,0FAA0F;AAC1F,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,GAAG,KAAK,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,YAAY,EAAE,oBAAoB,KAAK,MAAM,GAAG,IAAI,CAAC;AAEhG,MAAM,WAAW,4BAA4B,CAAC,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IAC5G,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,0FAA0F;IAC1F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,4BAA4B,CAC3C,MAAM,SAAS,uBAAuB,GAAG,uBAAuB,CAChE,SAAQ,IAAI,CAAC,4BAA4B,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB,CAAC,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IACtG,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,oBAAoB,CAAC;IACnC,yFAAyF;IACzF,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB,GAAI,OAAO,sBAAsB,KAAG,OACI,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAM,SAAS,uBAAuB,EAC/E,MAAM,sBAAsB,CAAC,MAAM,CAAC,GAAG,IAAI,EAC3C,SAAS,4BAA4B,CAAC,MAAM,CAAC,EAC7C,cAAc,MAAM,MAAM,KACzB,sBAAsB,CAAC,MAAM,CAwB/B,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,+BAA+B,GAAI,MAAM,SAAS,uBAAuB,EACpF,MAAM,sBAAsB,CAAC,MAAM,CAAC,GAAG,IAAI,KAC1C,sBAAsB,CAAC,MAAM,CAAC,GAAG,IAC0C,CAAC;AAE/E,MAAM,WAAW,oCAAoC,CACnD,MAAM,SAAS,uBAAuB,GAAG,uBAAuB;IAEhE,qDAAqD;IACrD,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,qGAAqG;IACrG,IAAI,EAAE,CAAC,OAAO,EAAE,4BAA4B,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;OAGG;IACH,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,iEAAiE;IACjE,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GACzC,MAAM,SAAS,uBAAuB,GAAG,uBAAuB,OAC7D,oCAAoC,CAAC,MAAM,CAuD/C,CAAC"}
+{"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,9 +1,10 @@
-// The floating agent chat's state, headless: what the panel shows (which agent, which
-// conversation), the draft the new chat is until its first 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.
+// 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.
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { agentInboxChatId } from "./use-agent-threads.js";
 /** The panel shows the new chat, nothing sent on it yet. */
@@ -12,7 +13,8 @@ export const isFloatingAgentChatDraft = (state) => state.conversation.chatThread
  * The state after an open. Within one agent the draft's bookkeeping carries over — the new chat
  * is kept while untouched, stands by while a thread is open, and is minted afresh once sent;
  * another agent starts clean. Opening what is already shown changes nothing but the opener's
- * `expandHref` / `chatContext`.
+ * `expandHref` / `chatContext` (and the face). The prompt face is the new chat by definition:
+ * a prompt open with a thread target opens the new chat.
  */
 export const floatingAgentChatAfterOpen = (prev, request, mintThreadId) => {
     const sameAgent = prev !== null && prev.agentChatId === request.agentChatId;
@@ -23,11 +25,13 @@ export const floatingAgentChatAfterOpen = (prev, request, mintThreadId) => {
         agentChat: request.agentChat,
         agentChatId: request.agentChatId,
         ownChatId: request.ownChatId,
+        face: request.face,
         expandHref: request.expandHref,
         chatContext: request.chatContext,
     };
-    if (request.target !== "new") {
-        return { ...base, ...draft, conversation: request.target };
+    const target = request.face === "prompt" ? "new" : request.target;
+    if (target !== "new") {
+        return { ...base, ...draft, conversation: target };
     }
     // A sent draft is a thread now; the new chat needs a fresh one.
     const draftThreadId = draft.draftSent ? mintThreadId() : draft.draftThreadId;
@@ -38,18 +42,21 @@ export const floatingAgentChatAfterOpen = (prev, request, mintThreadId) => {
         conversation: { chatId: request.ownChatId, chatThreadId: draftThreadId },
     };
 };
-/** After the first send on the draft; unchanged when the draft is not what is shown. */
-export const floatingAgentChatAfterDraftSent = (prev) => prev && isFloatingAgentChatDraft(prev) ? { ...prev, draftSent: true } : prev;
+/**
+ * After the first send on the draft: it is a thread now, shown in the panel — the prompt, if
+ * that is what sent it, turns into the panel. Unchanged when the draft is not what is shown.
+ */
+export const floatingAgentChatAfterDraftSent = (prev) => prev && isFloatingAgentChatDraft(prev) ? { ...prev, draftSent: true, face: "panel" } : prev;
 /**
  * The floating agent chat's state and transitions, for ONE provider at the app's root. Remembers
- * what had focus on the open that showed the panel (a sidebar row, an "Ask" button) and hands it
- * back on close, so keyboard users land where they were.
+ * what had focus on the open that showed the session (a sidebar row, an "Ask" button) and hands
+ * it back on close, so keyboard users land where they were.
  */
 export const useFloatingAgentChatController = () => {
     const [state, setState] = useState(null);
     const openerRef = useRef(null);
-    // Focus goes back to the opener once the panel is gone — after the close commits, so the
-    // panel's own focused element has left the DOM by then.
+    // Focus goes back to the opener once the session is gone — after the close commits, so the
+    // session's own focused element has left the DOM by then.
     useEffect(() => {
         if (state !== null) {
             return;
@@ -68,7 +75,7 @@ export const useFloatingAgentChatController = () => {
             : null;
         const { agentChatId } = options.agentChat.getAgentChatComponentProps();
         setState((prev) => {
-            // Remembered on the open that shows the panel, not on a re-point while it is up.
+            // Remembered on the open that shows the session, not on a re-point while it is up.
             if (prev === null && active) {
                 openerRef.current = active;
             }
@@ -77,6 +84,7 @@ export const useFloatingAgentChatController = () => {
                 agentChatId,
                 ownChatId: agentInboxChatId(agentChatId),
                 target: options.target ?? "new",
+                face: options.face ?? "panel",
                 expandHref: options.expandHref,
                 chatContext: options.chatContext,
             }, () => crypto.randomUUID());
@@ -84,6 +92,6 @@ export const useFloatingAgentChatController = () => {
     }, []);
     const close = useCallback(() => setState(null), []);
     const closeForAgent = useCallback((agentChatId) => setState((prev) => (prev?.agentChatId === agentChatId ? null : prev)), []);
-    const markDraftSent = useCallback(() => setState(floatingAgentChatAfterDraftSent), []);
+    const markDraftSent = useCallback(() => setState((prev) => floatingAgentChatAfterDraftSent(prev)), []);
     return useMemo(() => ({ state, isOpen: state !== null, open, close, closeForAgent, markDraftSent }), [state, open, close, closeForAgent, markDraftSent]);
 };

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

@@ -0,0 +1,28 @@
+/** What the platform asks for: the agent to talk to, by its block name (`<Name>Agent.id`). */
+export interface FloatingAgentPromptRequest {
+    agent: string;
+}
+/** How long a request waits for a subscriber before it is withdrawn. */
+export declare const FLOATING_AGENT_PROMPT_CLAIM_TIMEOUT_MS = 5000;
+/** Takes a request; `false` declines it (the agent is not on offer) — anything else claims it. */
+export type FloatingAgentPromptListener = (request: FloatingAgentPromptRequest) => boolean | undefined;
+export interface FloatingAgentPromptMailbox {
+    /**
+     * Hands the request to the subscriber; resolves `true` once one took it, `false` when none did
+     * in time or the subscriber declined it.
+     */
+    post(request: FloatingAgentPromptRequest): Promise<boolean>;
+    /** Takes every request from now on — and the one waiting, if any. Returns the unsubscribe. */
+    subscribe(listener: FloatingAgentPromptListener): () => void;
+}
+export interface FloatingAgentPromptMailboxTimers {
+    setTimeout(callback: () => void, ms: number): ReturnType<typeof setTimeout>;
+    clearTimeout(id: ReturnType<typeof setTimeout>): void;
+}
+/** One parked request at most: a newer post takes the slot (the older resolves `false`). */
+export declare const createFloatingAgentPromptMailbox: (timers?: FloatingAgentPromptMailboxTimers) => FloatingAgentPromptMailbox;
+/** app-render's side: the bridge's `onOpenAgentPrompt` resolves with this. */
+export declare const postFloatingAgentPromptRequest: FloatingAgentPromptMailbox["post"];
+/** The provider's side: opens the prompt for each request. */
+export declare const subscribeFloatingAgentPromptRequests: FloatingAgentPromptMailbox["subscribe"];
+//# sourceMappingURL=floating-agent-prompt-requests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"floating-agent-prompt-requests.d.ts","sourceRoot":"","sources":["../../src/hooks/floating-agent-prompt-requests.ts"],"names":[],"mappings":"AAQA,8FAA8F;AAC9F,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,eAAO,MAAM,sCAAsC,OAAO,CAAC;AAE3D,kGAAkG;AAClG,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,EAAE,0BAA0B,KAAK,OAAO,GAAG,SAAS,CAAC;AAEvG,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,8FAA8F;IAC9F,SAAS,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC5E,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;CACvD;AAQD,4FAA4F;AAC5F,eAAO,MAAM,gCAAgC,GAC3C,SAAQ,gCAAgD,KACvD,0BAiDF,CAAC;AAIF,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B,EAAE,0BAA0B,CAAC,MAAM,CAAsC,CAAC;AAErH,8DAA8D;AAC9D,eAAO,MAAM,oCAAoC,EAAE,0BAA0B,CAAC,WAAW,CAC5D,CAAC"}

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

@@ -0,0 +1,64 @@
+// 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.
+/** 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.
+const defaultTimers = {
+    setTimeout: (callback, ms) => setTimeout(callback, ms),
+    clearTimeout: (id) => clearTimeout(id),
+};
+/** One parked request at most: a newer post takes the slot (the older resolves `false`). */
+export const createFloatingAgentPromptMailbox = (timers = defaultTimers) => {
+    const listeners = new Set();
+    let parked = null;
+    const withdraw = (claimed) => {
+        if (!parked) {
+            return;
+        }
+        const { resolve, timer } = parked;
+        parked = null;
+        timers.clearTimeout(timer);
+        resolve(claimed);
+    };
+    return {
+        post: (request) => {
+            if (listeners.size > 0) {
+                let claimed = false;
+                listeners.forEach((listener) => {
+                    if (listener(request) !== false) {
+                        claimed = true;
+                    }
+                });
+                return Promise.resolve(claimed);
+            }
+            withdraw(false);
+            return new Promise((resolve) => {
+                parked = {
+                    request,
+                    resolve,
+                    timer: timers.setTimeout(() => withdraw(false), FLOATING_AGENT_PROMPT_CLAIM_TIMEOUT_MS),
+                };
+            });
+        },
+        subscribe: (listener) => {
+            listeners.add(listener);
+            if (parked) {
+                const { request } = parked;
+                withdraw(listener(request) !== false);
+            }
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+};
+const mailbox = createFloatingAgentPromptMailbox();
+/** app-render's side: the bridge's `onOpenAgentPrompt` resolves with this. */
+export const postFloatingAgentPromptRequest = (request) => mailbox.post(request);
+/** The provider's side: opens the prompt for each request. */
+export const subscribeFloatingAgentPromptRequests = (listener) => mailbox.subscribe(listener);

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

@@ -0,0 +1,57 @@
+import type { FloatingAgentChatExpandHref, FloatingAgentChatHandle, 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.
+ */
+export interface FloatingAgentPromptAgentEntry<Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle> {
+    id: string;
+    agentChatId: string;
+    handle: Handle;
+    expandHref?: FloatingAgentChatExpandHref;
+}
+/** 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;
+/** What the open agent's chat lends the prompt, which renders outside it (it shows while the chat loads). */
+export interface FloatingAgentPromptChat {
+    canSend: boolean;
+    send: (content: string) => void;
+}
+export interface FloatingAgentPromptOpenOptions {
+    /** One of the entries, by id; the first one by default. */
+    agent?: string;
+    /** Extra context for the conversation it starts (like the session's `open`). */
+    chatContext?: unknown;
+}
+export interface UseFloatingAgentPromptControllerOptions<Handle extends FloatingAgentChatHandle = FloatingAgentChatHandle> {
+    /** The session the prompt opens: 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. */
+    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. */
+    openPrompt: (options?: FloatingAgentPromptOpenOptions) => boolean;
+    text: string;
+    setText: (text: string) => void;
+    /** Counts the opens, re-points included — the message takes focus on each. */
+    openCount: number;
+    /** The open agent's chat is up and free. */
+    canSend: boolean;
+    /** Sends through the open agent's chat; its first send turns the prompt into the panel. */
+    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.
+ */
+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

@@ -0,0 +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,sCAuDpD,CAAC"}

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

@@ -0,0 +1,55 @@
+// 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";
+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.
+ */
+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.
+    const openFor = useCallback((agentId, chatContext) => {
+        const entry = resolveFloatingAgentPromptAgent(agents, agentId);
+        if (!entry || !canOpen) {
+            return false;
+        }
+        if (!isOpen) {
+            setText("");
+        }
+        setOpenCount((count) => count + 1);
+        open({ agentChat: entry.handle, face: "prompt", expandHref: entry.expandHref, chatContext });
+        return true;
+    }, [agents, canOpen, isOpen, 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.");
+        }
+        return opened;
+    }, [openFor]);
+    // The platform's requests (the rail's chat bubble on an agent's row), posted through
+    // app-render: taken while mounted, and declined at once when there is nothing to open, so
+    // the platform falls back without waiting. An app without a provider leaves the request
+    // unclaimed; the mailbox withdraws it in time.
+    const openForRef = useRef(openFor);
+    useEffect(() => {
+        openForRef.current = openFor;
+    }, [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]);
+};

package/dist/hooks/use-agent-threads.d.ts

@@ -6,7 +6,10 @@ export { type AgentConversationChat, type AgentConversationRef, type AgentConver
 export { type AgentConversationContextValue, AgentConversationProvider, type AgentConversationProviderProps, AgentThreadConversationProvider, type AgentThreadConversationProviderProps, type AgentThreadFilters, useAgentConversationContext, } from "./agent-conversation-context.js";
 export { useAgentThread, type UseAgentThreadOptions, type UseAgentThreadResult } from "./use-agent-thread.js";
 export { useMediaQuery } from "./use-media-query.js";
-export { type FloatingAgentChatExpandHref, type FloatingAgentChatHandle, type FloatingAgentChatOpenOptions, type FloatingAgentChatOpenRequest, type FloatingAgentChatState, type FloatingAgentChatTarget, floatingAgentChatAfterDraftSent, floatingAgentChatAfterOpen, isFloatingAgentChatDraft, useFloatingAgentChatController, type UseFloatingAgentChatControllerResult, } from "./floating-agent-chat.js";
+export { type FloatingAgentChatExpandHref, type FloatingAgentChatFace, type FloatingAgentChatHandle, type FloatingAgentChatOpenOptions, type FloatingAgentChatOpenRequest, type FloatingAgentChatState, type FloatingAgentChatTarget, floatingAgentChatAfterDraftSent, floatingAgentChatAfterOpen, isFloatingAgentChatDraft, useFloatingAgentChatController, type UseFloatingAgentChatControllerResult, } from "./floating-agent-chat.js";
+export { type FloatingAgentChatEnginePhase, type FloatingAgentChatUrlContext, useFloatingAgentChatContext, useFloatingAgentChatEngine, type UseFloatingAgentChatEngineResult, } from "./floating-agent-chat-engine.js";
+export { type FloatingAgentPromptAgentEntry, type FloatingAgentPromptChat, type FloatingAgentPromptOpenOptions, useFloatingAgentPromptController, type UseFloatingAgentPromptControllerOptions, type UseFloatingAgentPromptControllerResult, } from "./floating-agent-prompt.js";
+export { type FloatingAgentPromptListener, type FloatingAgentPromptRequest, postFloatingAgentPromptRequest, subscribeFloatingAgentPromptRequests, } from "./floating-agent-prompt-requests.js";
 export { clampPanelSize, type PanelResizeAxis, type PanelResizeBounds, type PanelResizeHandleProps, type PanelSize, parseStoredPanelSize, useResizablePanel, type UseResizablePanelOptions, type UseResizablePanelResult, } from "./use-resizable-panel.js";
 /** The auth a reader carries — its SDK token and extra headers — read at call time. */
 export interface AgentThreadsAuth {

package/dist/hooks/use-agent-threads.d.ts.map

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

package/dist/hooks/use-agent-threads.js

@@ -10,6 +10,9 @@ export { AgentConversationProvider, AgentThreadConversationProvider, useAgentCon
 export { useAgentThread } from "./use-agent-thread.js";
 export { useMediaQuery } from "./use-media-query.js";
 export { floatingAgentChatAfterDraftSent, floatingAgentChatAfterOpen, isFloatingAgentChatDraft, useFloatingAgentChatController, } from "./floating-agent-chat.js";
+export { useFloatingAgentChatContext, useFloatingAgentChatEngine, } from "./floating-agent-chat-engine.js";
+export { useFloatingAgentPromptController, } from "./floating-agent-prompt.js";
+export { postFloatingAgentPromptRequest, subscribeFloatingAgentPromptRequests, } from "./floating-agent-prompt-requests.js";
 export { clampPanelSize, parseStoredPanelSize, useResizablePanel, } from "./use-resizable-panel.js";
 /** A non-2xx answer from the agent-threads API, with its status — a reader tells a 404 (no row) from a failure. */
 export class AgentThreadsRequestError extends Error {

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

@@ -89,5 +89,13 @@ export interface IframeApi extends Methods {
      * when its sample props re-render it.
      */
     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.
+     */
+    onOpenAgentPrompt: (args: {
+        agent: string;
+    }) => Promise<boolean>;
 }
 //# sourceMappingURL=types.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocksdiy/react-common",
-  "version": "1.54.0",
+  "version": "1.55.1",
   "type": "module",
   "description": "React common",
   "keywords": [],
@@ -33,15 +33,16 @@
   },
   "dependencies": {
     "@ag-ui/client": "0.0.59",
+    "@blocksdiy/blocks-client-api": "1.26.1",
     "@copilotkit/react-core": "1.70.2",
     "@radix-ui/react-slot": "^1.2.3",
     "@vapi-ai/web": "^2.5.2",
     "penpal": "^8.0.0",
     "react": "^19.2.8",
-    "use-stick-to-bottom": "1.1.4",
-    "@blocksdiy/blocks-client-api": "1.5.0"
+    "use-stick-to-bottom": "1.1.4"
   },
   "devDependencies": {
+    "@blockscom/eslint-config": "4.6.4",
     "@types/react": "^19.2.18",
     "babel-plugin-react-compiler": "^1.0.0",
     "eslint-plugin-react": "^7.37.5",
@@ -49,11 +50,10 @@
     "jest": "^29.7.0",
     "ts-jest": "^29.2.5",
     "tsc-alias": "^1.8.10",
-    "typescript": "^5.9.3",
-    "@blockscom/eslint-config": "4.6.4"
+    "typescript": "^5.9.3"
   },
   "engines": {
-    "node": ">=24.11.0"
+    "node": ">=24.14.0"
   },
   "scripts": {
     "clean": "rm -rf ./dist/ && rm -rf tsconfig.tsbuildinfo && rm -rf node_modules",