@opencx/widget-react-headless 5.0.0-beta.0 → 5.0.0-beta.10

package/dist/package.json.d.ts

@@ -1,7 +1,7 @@
 declare const _default: {
   "name": "@opencx/widget-react-headless",
   "private": false,
-  "version": "5.0.0-beta.0",
+  "version": "5.0.0-beta.10",
   "type": "module",
   "repository": {
     "type": "git",
@@ -10,11 +10,12 @@ declare const _default: {
   "scripts": {
     "clean": "rm -rf node_modules dist .turbo",
     "clean:dist": "rm -rf dist .turbo",
-    "build": "vite build",
+    "build": "NODE_ENV=production vite build && node ../../scripts/check-production-build.mjs dist",
     "test": "vitest run",
     "type-check": "tsc --noEmit",
     "lint": "eslint .",
-    "format": "prettier --write ."
+    "format": "prettier --write .",
+    "prepack": "node ../../scripts/check-production-build.mjs dist"
   },
   "files": [
     "dist"

package/dist/src/ComponentRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentRegistry.d.ts","sourceRoot":"","sources":["../../src/ComponentRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,qBAAa,iBAAiB;IAC5B,UAAU,EAAE,mBAAmB,EAAE,CAAM;gBAE3B,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAA;KAAE;IAgBxD,QAAQ,CAAC,SAAS,EAAE,mBAAmB;IAWvC,OAAO,CAAC,GAAG;IAQJ,YAAY,CAAC,GAAG,EAAE,MAAM;CAGhC"}
+{"version":3,"file":"ComponentRegistry.d.ts","sourceRoot":"","sources":["../../src/ComponentRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,qBAAa,iBAAiB;IAC5B,UAAU,EAAE,mBAAmB,EAAE,CAAM;gBAE3B,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAA;KAAE;IAexD,QAAQ,CAAC,SAAS,EAAE,mBAAmB;IAavC,OAAO,CAAC,GAAG;IAQJ,YAAY,CAAC,GAAG,EAAE,MAAM;CAGhC"}

package/dist/src/ConversationWorkspace.d.ts

@@ -0,0 +1,61 @@
+import { default as React } from 'react';
+import { PrimitiveState, WidgetConfig, WidgetCtx } from '@opencx/widget-core';
+import { AgentChatUiValue } from './agent-chat/AgentChatContext';
+import { ConnectionState } from './agent-chat/useConnection';
+export type CompanionChat = {
+    id: number;
+    ctx: WidgetCtx;
+    title: string;
+    working: boolean;
+    hasSession: boolean;
+    hasDraft: boolean;
+    ui: AgentChatUiValue;
+    connection: ConnectionState | null;
+    /** A closed tab may finish its current turn before its runtime is released. */
+    closed?: boolean;
+};
+/** Keeps each send engine mounted while the visible conversation changes. */
+export declare class ConversationWorkspace {
+    private root;
+    state: PrimitiveState<{
+        chats: CompanionChat[];
+        activeId: number;
+    }>;
+    private nextId;
+    private mountVersion;
+    private disposed;
+    constructor(root: WidgetCtx);
+    private makeChat;
+    /** Attach only after commit: Strict Mode may discard render-time workspaces. */
+    mount: () => () => void;
+    dispose: () => void;
+    select: (id: number) => void;
+    close: (id: number) => void;
+    private releaseChat;
+    private isWorking;
+    canCreateChat: () => boolean;
+    private isEmpty;
+    open: (sessionId?: string) => WidgetCtx | undefined;
+    update: (id: number, update: Partial<Pick<CompanionChat, "title" | "working" | "hasSession" | "hasDraft" | "ui" | "connection">>) => void;
+}
+/** Optional only for shared hooks that also serve popover and inline widgets. */
+export declare function useConversationWorkspace(): {
+    workspace: ConversationWorkspace | null;
+    chats: CompanionChat[];
+    openChats: CompanionChat[];
+    activeId: number;
+};
+export declare function useCompanionChats(): {
+    selectChat: (id: number) => void;
+    closeChat: (id: number) => void;
+    newChat: (sessionId?: string) => WidgetCtx | undefined;
+    chats: CompanionChat[];
+    openChats: CompanionChat[];
+    activeId: number;
+};
+export declare function CompanionConversationProvider({ widgetCtx, config, children, }: {
+    widgetCtx: WidgetCtx;
+    config?: WidgetConfig;
+    children: (active: WidgetCtx) => React.ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=ConversationWorkspace.d.ts.map

package/dist/src/ConversationWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationWorkspace.d.ts","sourceRoot":"","sources":["../../src/ConversationWorkspace.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAC;AACf,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAGpC,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,EAAE,EAAE,gBAAgB,CAAC;IACrB,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,6EAA6E;AAC7E,qBAAa,qBAAqB;IAKpB,OAAO,CAAC,IAAI;IAJxB,KAAK,EAAE,cAAc,CAAC;QAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAS;gBACL,IAAI,EAAE,SAAS;IAInC,OAAO,CAAC,QAAQ;IAYhB,gFAAgF;IAChF,KAAK,mBAgBH;IAEF,OAAO,aAaL;IAEF,MAAM,GAAI,IAAI,MAAM,UAiBlB;IACF,KAAK,GAAI,IAAI,MAAM,UA2BjB;IACF,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;IAOjB,aAAa,gBAU2B;IAExC,OAAO,CAAC,OAAO;IAcf,IAAI,GAAI,YAAY,MAAM,2BAiCxB;IACF,MAAM,GACJ,IAAI,MAAM,EACV,QAAQ,OAAO,CACb,IAAI,CACF,aAAa,EACb,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,IAAI,GAAG,YAAY,CACtE,CACF,UA2BD;CACH;AAQD,iFAAiF;AACjF,wBAAgB,wBAAwB;;;;;EAQvC;AAED,wBAAgB,iBAAiB;qBA7KjB,MAAM;oBAkBP,MAAM;0BAmEC,MAAM;;;;EAkG3B;AA4DD,wBAAgB,6BAA6B,CAAC,EAC5C,SAAS,EACT,MAAyB,EACzB,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC;CAClD,qBA+BA"}

package/dist/src/WidgetProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetProvider.d.ts","sourceRoot":"","sources":["../../src/WidgetProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAEjB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,UAAU,mBAAmB;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACnC,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACrE;AAID,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EACR,UAAU,EACV,OAAO,EACP,gBAAgB,EAChB,cAAc,GACf,EAAE;IACD,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC;CACpD,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAkE5B;AAED,wBAAgB,SAAS,wBAMxB"}
+{"version":3,"file":"WidgetProvider.d.ts","sourceRoot":"","sources":["../../src/WidgetProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAEjB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,UAAU,mBAAmB;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACnC,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACrE;AAID,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EACR,UAAU,EACV,OAAO,EACP,gBAAgB,EAChB,cAAc,GACf,EAAE;IACD,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC;CACpD,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA8I5B;AAED,wBAAgB,SAAS,wBAMxB"}

package/dist/src/agent-chat/AgentChatContext.d.ts

@@ -1,9 +1,9 @@
 import { WidgetConfig, WidgetCtx, WidgetUserMessage } from '@opencx/widget-core';
 import { default as React } from 'react';
-import { StreamingTurnItem } from './agent-chat-stream';
+import { ConnectionRequest, StreamingTurnItem } from './agent-chat-stream';
 import { TurnRenderSource } from './agent-turn-sources';
 import { AskQuestionsRequest } from './ask-questions';
-import { AgentChatPageEffect } from './useAgentChat';
+import { AgentChatPageEffect, PendingPageAction } from './useAgentChat';
 /**
  * Streaming state for the agent-chat surface, produced by the single
  * `useAgentChat` (one useChat instance) and consumed by the message list
@@ -38,12 +38,38 @@ export type AgentChatUiValue = {
     stop: () => void;
     /** Host-page effects normalized from the current assistant tool parts. */
     pageEffects: AgentChatPageEffect[];
+    /**
+     * Tell the waiting turn what actually happened on the page. The adapter
+     * that performs an effect owes exactly one of these per call; without it
+     * the agent only knows that it asked.
+     */
+    /**
+     * The committing action waiting on the visitor's yes, or null. Shown as a
+     * chip naming the exact control; a decline is final.
+     */
+    pendingPageAction: PendingPageAction | null;
+    /** The visitor's answer to that chip. */
+    resolvePageAction: (callId: string, allowed: boolean) => void;
+    /** Raised by the adapter that is about to act. Resolves false on decline. */
+    requestPageActionConsent: (request: PendingPageAction) => Promise<boolean>;
+    replyToPageCall: (callId: string, outcome: 'done' | 'covered' | 'gone' | 'hidden' | 'unsupported' | 'no_change' | 'declined', detail?: string, page?: {
+        controls: {
+            ref: string;
+            role: string;
+            name: string;
+            disabled?: boolean;
+        }[];
+        truncated: boolean;
+    }) => void;
     /**
      * The clarification the agent is waiting on — the composer shows the
      * questionnaire in its place — or null.
      */
     pendingClarification: AskQuestionsRequest | null;
+    pendingConnection: ConnectionRequest | null;
 };
+export declare const DEFAULT_AGENT_CHAT_UI: AgentChatUiValue;
+export declare const AgentChatContext: React.Context<AgentChatUiValue | null>;
 /** Reads the agent streaming state; safe defaults when not in an agent surface. */
 export declare function useAgentChatUi(): AgentChatUiValue;
 /**

package/dist/src/agent-chat/AgentChatContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentChatContext.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/AgentChatContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;OAIG;IACH,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,iFAAiF;IACjF,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,4DAA4D;IAC5D,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,sEAAsE;IACtE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,0EAA0E;IAC1E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC;;;OAGG;IACH,oBAAoB,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAClD,CAAC;AAkBF,mFAAmF;AACnF,wBAAgB,cAAc,IAAI,gBAAgB,CAEjD;AA6ED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB,qBAaA"}
+{"version":3,"file":"AgentChatContext.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/AgentChatContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;OAIG;IACH,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,iFAAiF;IACjF,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,4DAA4D;IAC5D,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,sEAAsE;IACtE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,0EAA0E;IAC1E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC;;;;OAIG;IACH;;;OAGG;IACH,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,yCAAyC;IACzC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9D,6EAA6E;IAC7E,wBAAwB,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,eAAe,EAAE,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EACH,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,GACR,aAAa,GACb,WAAW,GACX,UAAU,EACd,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE;YACR,GAAG,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,EAAE,CAAC;QACJ,SAAS,EAAE,OAAO,CAAC;KACpB,KACE,IAAI,CAAC;IACV;;;OAGG;IACH,oBAAoB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjD,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAiBnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,wCAA+C,CAAC;AAE7E,mFAAmF;AACnF,wBAAgB,cAAc,IAAI,gBAAgB,CAEjD;AAwKD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB,qBAeA"}

package/dist/src/agent-chat/agent-chat-stream.d.ts

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { AskQuestionsRequest } from './ask-questions';
 /** One line of a turn's activity trace (reasoning or a tool call). */
 export type StreamingStep = {
@@ -19,7 +20,23 @@ export type StreamingStep = {
  * drains out of model text as typed `data-spec` UIMessage parts. The styled
  * renderer assembles these into a renderable element-tree spec.
  */
+export declare const connectionRequestSchema: z.ZodObject<{
+    request_id: z.ZodString;
+    server_id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type ConnectionRequest = z.infer<typeof connectionRequestSchema>;
 declare const SPEC_DATA_PART_TYPE = "data-spec";
+declare const planSchema: z.ZodObject<{
+    plan: z.ZodArray<z.ZodObject<{
+        step: z.ZodString;
+        status: z.ZodEnum<{
+            pending: "pending";
+            in_progress: "in_progress";
+            completed: "completed";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type SpecDataPart = {
     type: typeof SPEC_DATA_PART_TYPE;
     data: unknown;
@@ -28,12 +45,16 @@ export type SpecDataPart = {
 export type StreamingTurnItem = {
     kind: 'text';
     text: string;
+    streaming?: boolean;
 } | {
     kind: 'steps';
     steps: StreamingStep[];
 } | {
     kind: 'spec';
     parts: SpecDataPart[];
+} | {
+    kind: 'plan';
+    plan: z.infer<typeof planSchema>['plan'];
 }
 /**
  * A clarification the agent asked. Never rendered in the transcript: the
@@ -43,6 +64,9 @@ export type StreamingTurnItem = {
  | {
     kind: 'questions';
     request: AskQuestionsRequest;
+} | {
+    kind: 'connection';
+    request: ConnectionRequest;
 };
 /** The in-flight turn's render state: active + its ordered items. */
 export type StreamingTurnState = {

package/dist/src/agent-chat/agent-chat-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-chat-stream.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/agent-chat-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,mBAAmB,cAAc,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,mBAAmB,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/E,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE;AACzC;;;;GAIG;GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAExD,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAClC,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,GAC/B,iBAAiB,EAAE,CA0DrB"}
+{"version":3,"file":"agent-chat-stream.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/agent-chat-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIxE,QAAA,MAAM,mBAAmB,cAAc,CAAC;AAExC,QAAA,MAAM,UAAU;;;;;;;;;iBAOd,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,mBAAmB,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/E,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;CAAE;AAC5D;;;;GAIG;GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEvD,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAClC,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,GAC/B,iBAAiB,EAAE,CAiGrB"}

package/dist/src/agent-chat/agent-turn-sources.d.ts

@@ -8,9 +8,11 @@ export type TurnRenderSource = {
     items: StreamingTurnItem[];
 };
 /** Fold a fresh history fetch into the current list of turn render sources. */
-export declare function mergeTurnSources({ existing, fetched, }: {
+export declare function mergeTurnSources({ existing, fetched, refreshItems, }: {
     existing: TurnRenderSource[];
     fetched: AgentTurnMessagesDto;
+    /** Replace stale visibility projections while preserving each turn’s React key. */
+    refreshItems?: boolean;
 }): TurnRenderSource[];
 /** Read the terminal turn identity emitted on a finished useChat message. */
 export declare function parseTurnSettledPart(parts: ReadonlyArray<{

package/dist/src/agent-chat/agent-turn-sources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-turn-sources.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/agent-turn-sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,oBAAoB,CAAC;CAC/B,GAAG,gBAAgB,EAAE,CAyCrB;AAQD,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GACrD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAc7C"}
+{"version":3,"file":"agent-turn-sources.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/agent-turn-sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,OAAO,EACP,YAAoB,GACrB,EAAE;IACD,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,gBAAgB,EAAE,CAyCrB;AAQD,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GACrD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAc7C"}

package/dist/src/agent-chat/apply-presentation.d.ts

@@ -0,0 +1,5 @@
+import { WidgetConfig } from '@opencx/widget-core';
+import { StreamingTurnItem } from './agent-chat-stream';
+/** Narrow cached or live activity immediately, even before history refreshes. */
+export declare function applyPresentation(items: StreamingTurnItem[], presentation: WidgetConfig['presentation']): StreamingTurnItem[];
+//# sourceMappingURL=apply-presentation.d.ts.map

package/dist/src/agent-chat/apply-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-presentation.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/apply-presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EAAE,EAC1B,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,GACzC,iBAAiB,EAAE,CAkCrB"}

package/dist/src/agent-chat/session-plan.d.ts

@@ -0,0 +1,10 @@
+import { StreamingTurnItem } from './agent-chat-stream';
+import { TurnRenderSource } from './agent-turn-sources';
+/** The latest plan snapshot belongs to the session, even when later turns have no plan update. */
+export declare function sessionPlan({ liveItems, turnSources, }: {
+    liveItems: readonly StreamingTurnItem[];
+    turnSources: ReadonlyArray<Pick<TurnRenderSource, 'items'>>;
+}): Extract<StreamingTurnItem, {
+    kind: 'plan';
+}>['plan'] | undefined;
+//# sourceMappingURL=session-plan.d.ts.map

package/dist/src/agent-chat/session-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-plan.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/session-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,WAAW,GACZ,EAAE;IACD,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC,WAAW,EAAE,aAAa,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7D,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAYnE"}

package/dist/src/agent-chat/useAgentChat.d.ts

@@ -1,27 +1,39 @@
 import { WidgetConfig, WidgetCtx, WidgetMessageU } from '@opencx/widget-core';
 import { StreamingTurnItem } from './agent-chat-stream';
 import { TurnRenderSource } from './agent-turn-sources';
+/**
+ * Something the visitor has to say yes to before it happens. Raised by the
+ * adapter that is about to act — it is the one that knows which control the
+ * reference points at, and what that control is called.
+ */
+export type PendingPageAction = {
+    callId: string;
+    /** What is about to be done: clicked, filled in, switched on. */
+    action: string;
+    /** The control's own name on the page, read off the page, not the model. */
+    controlName: string;
+};
 /** A normalized browser effect for a styled renderer to perform on its host. */
 export type AgentChatPageEffect = {
     key: string;
-    type: 'highlight-element';
+    type: 'highlight-element' | 'act-on-page';
     input: unknown;
+    /**
+     * The tool call this effect belongs to. The adapter performs the effect,
+     * sees what happened, and answers with `replyToPageCall(callId, …)` —
+     * which is how the turn finds out anything at all about the page it just
+     * touched.
+     */
+    callId: string;
 };
 /**
  * The agent-chat engine, powered by the AI SDK `useChat`.
  *
  * - **Streaming** is driven by `status` ('submitted' | 'streaming' | 'ready').
  * - **Resume** is native (`resume: true` reconnects to a live turn on mount).
- * - **Steering**: a message sent while a turn is STREAMING enters the
- *   transcript at once and is POSTed at once; the backend steers it into the
- *   live turn (`data-turn-steered`), whose single reply — still rendering on
- *   this engine's stream, untouched — answers both messages. When the live
- *   turn cannot take it (already over), the backend opens a new turn for it
- *   on that request's stream, which is replayed here via resume.
- * - **Multi-send queues** cover the gaps steering cannot: a turn that has
- *   not started streaming yet, a stop awaiting its ACK, and the post-turn
- *   reconcile window. A queued message is held in a queue pill above the
- *   composer and enters the transcript when its own turn starts.
+ * - **Multi-send queues** hold follow-ups until the active reply has settled
+ *   and its persisted rows have been reconciled. Each queued message enters
+ *   the transcript when its own turn starts.
  * - **Stop cancels the RESPONSE, not the conversation**: it aborts the client
  *   stream and POSTs `/stop` so the server cancels generation, then the next
  *   queued message (if any) is sent to the API immediately. The queue is
@@ -50,5 +62,19 @@ export declare function useAgentChat({ widgetCtx, config, sessionId, persistedMe
     removeQueued: (messageId: string) => void;
     stop: () => void;
     pageEffects: AgentChatPageEffect[];
+    replyToPageCall: (callId: string, outcome: "done" | "covered" | "gone" | "hidden" | "unsupported" | "no_change" | "declined", detail?: string, page?: {
+        controls: {
+            ref: string;
+            role: string;
+            name: string;
+            disabled?: boolean;
+        }[];
+        truncated: boolean;
+    }) => void;
+    pendingPageAction: PendingPageAction | null;
+    requestPageActionConsent: (request: PendingPageAction) => Promise<boolean>;
+    resolvePageAction: (callId: string, allowed: boolean) => void;
+    handledConnectionRequestIds: string[];
+    sourceSessionId: string | null;
 };
 //# sourceMappingURL=useAgentChat.d.ts.map

package/dist/src/agent-chat/useAgentChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAgentChat.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/useAgentChat.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAS9B,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAqBF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,MAAM,EACN,SAAS,EACT,iBAAiB,GAClB,EAAE;IACD,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,cAAc,EAAE,CAAC;CACrC;;;IAwsBG,+DAA+D;;IAE/D,wEAAwE;;IAExE,yEAAyE;;;;8BA7M9B,MAAM;;;EAqNpD"}
+{"version":3,"file":"useAgentChat.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/useAgentChat.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAS9B;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAAC;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAqBF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,MAAM,EACN,SAAS,EACT,iBAAiB,GAClB,EAAE;IACD,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,cAAc,EAAE,CAAC;CACrC;;;IA63BG,+DAA+D;;IAE/D,wEAAwE;;IAExE,yEAAyE;;;;8BA1a9B,MAAM;;;8BA8JvC,MAAM,WAEV,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,GACR,aAAa,GACb,WAAW,GACX,UAAU,WACL,MAAM,SACR;QACL,QAAQ,EAAE;YACR,GAAG,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,EAAE,CAAC;QACJ,SAAS,EAAE,OAAO,CAAC;KACpB;;wCAoCO,iBAAiB;gCAQkB,MAAM,WAAW,OAAO;;;EA4NxE"}

package/dist/src/agent-chat/useConnection.d.ts

@@ -0,0 +1,39 @@
+import { WidgetCtx } from '@opencx/widget-core';
+import { default as React } from 'react';
+import { ConnectionRequest } from './agent-chat-stream';
+export type ConnectionPhase = 'idle' | 'loading' | 'ready' | 'waiting' | 'connected' | 'external';
+type ContinuationKind = 'resume' | 'external' | 'renew' | 'dismiss';
+export type ConnectionState = {
+    request: ConnectionRequest;
+    phase: ConnectionPhase;
+    authorization: {
+        url: string;
+        host: string;
+        completion: 'oauth' | 'external';
+        attemptId?: string;
+    } | null;
+    continuation: ContinuationKind | null;
+    error: string | null;
+    start: () => Promise<void>;
+    opened: () => void;
+    cancel: () => Promise<void>;
+    retryContinuation: () => Promise<void>;
+};
+/** Owns one authorization attempt above the card/view lifecycle. */
+export declare function ConnectionAttemptProvider({ children, request, widgetCtx, onHandled, }: {
+    children: React.ReactNode;
+    request: ConnectionRequest | null;
+    widgetCtx: WidgetCtx;
+    onHandled: (requestId: string) => void;
+}): React.FunctionComponentElement<React.ProviderProps<ConnectionState | null>>;
+/** Re-exposes an already-owned controller across a companion workspace boundary. */
+export declare function ConnectionControllerProvider({ children, connection, }: {
+    children: React.ReactNode;
+    connection: ConnectionState | null;
+}): React.FunctionComponentElement<React.ProviderProps<ConnectionState | null>>;
+/** Reads the active controller without requiring a connection request. */
+export declare function useConnectionController(): ConnectionState | null;
+/** Reads the provider-owned attempt; rendering the card never owns cleanup. */
+export declare function useConnection(request: ConnectionRequest): ConnectionState;
+export {};
+//# sourceMappingURL=useConnection.d.ts.map

package/dist/src/agent-chat/useConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnection.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/useConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAQN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,WAAW,GACX,UAAU,CAAC;AAEf,KAAK,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa,EAAE;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAmCF,oEAAoE;AACpE,wBAAgB,yBAAyB,CAAC,EACxC,QAAQ,EACR,OAAO,EACP,SAAS,EACT,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,+EAiVA;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,CAAC,EAC3C,QAAQ,EACR,UAAU,GACX,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;CACpC,+EAMA;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,IAAI,eAAe,GAAG,IAAI,CAEhE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAQzE"}

package/dist/src/hooks/useComposerDraft.d.ts

@@ -0,0 +1,11 @@
+import { SetStateAction } from 'react';
+import { WidgetMention } from '@opencx/widget-core';
+/** The composer reads and writes its conversation's draft directly. */
+export declare function useComposerDraft(): {
+    setText: (value: SetStateAction<string>) => void;
+    setMentions: (value: SetStateAction<WidgetMention[]>) => void;
+    clearSubmitted: () => boolean;
+    text: string;
+    mentions: WidgetMention[];
+};
+//# sourceMappingURL=useComposerDraft.d.ts.map

package/dist/src/hooks/useComposerDraft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComposerDraft.d.ts","sourceRoot":"","sources":["../../../src/hooks/useComposerDraft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,uEAAuE;AACvE,wBAAgB,gBAAgB;qBAKpB,cAAc,CAAC,MAAM,CAAC;yBAQtB,cAAc,CAAC,aAAa,EAAE,CAAC;;;;EAc1C"}

package/dist/src/hooks/useIsAwaitingBotReply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIsAwaitingBotReply.d.ts","sourceRoot":"","sources":["../../../src/hooks/useIsAwaitingBotReply.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB;;EAqBpC"}
+{"version":3,"file":"useIsAwaitingBotReply.d.ts","sourceRoot":"","sources":["../../../src/hooks/useIsAwaitingBotReply.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB;;EAuBpC"}

package/dist/src/hooks/useMessages.d.ts

@@ -3,6 +3,7 @@ export declare function useMessages(): {
         messages: import('@opencx/widget-core').WidgetMessageU[];
         isSendingMessage: boolean;
         isSendingMessageToAI: boolean;
+        settledAgentUserMessageId: string | null;
         lastAIResMightSolveUserIssue: boolean;
         isInitialFetchLoading: boolean;
     };

package/dist/src/hooks/useMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMessages.d.ts","sourceRoot":"","sources":["../../../src/hooks/useMessages.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW;;;;;;;;;;;EAkB1B"}
+{"version":3,"file":"useMessages.d.ts","sourceRoot":"","sources":["../../../src/hooks/useMessages.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW;;;;;;;;;;;;EAkB1B"}

package/dist/src/hooks/useSessions.d.ts

@@ -16,6 +16,10 @@ export declare function useSessions(): {
         readonly success: false;
         readonly error: "Session is not opened";
         readonly data?: undefined;
+    } | {
+        readonly success: false;
+        readonly error: "Session was reset";
+        readonly data?: undefined;
     } | {
         readonly success: true;
         readonly data: {

package/dist/src/hooks/useSessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSessions.d.ts","sourceRoot":"","sources":["../../../src/hooks/useSessions.ts"],"names":[],"mappings":"AAKA,wBAAgB,WAAW;;;;;;;;;;;;;;;;;qBA+BmuD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAA2lC,CAAC;;;;sBAAwG,CAAC;mBAA6B,CAAC;iBAA2B,CAAC;;qBAA0C,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EADxiG"}
+{"version":3,"file":"useSessions.d.ts","sourceRoot":"","sources":["../../../src/hooks/useSessions.ts"],"names":[],"mappings":"AAMA,wBAAgB,WAAW;;;;;;;;;;;;;;;;;qBAgC6uE,CAAC;;;;qBAA0H,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAA2lC,CAAC;;;;sBAAwG,CAAC;mBAA6B,CAAC;iBAA2B,CAAC;;qBAA0C,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAD7qH"}

package/dist/src/hooks/useUploadFiles.d.ts

@@ -1,22 +1,14 @@
-interface FileWithProgress {
-    status: 'pending' | 'uploading' | 'success' | 'error';
-    id: string;
-    file: File;
-    fileUrl?: string;
-    progress: number;
-    error?: string;
-}
-declare function useUploadFiles(): {
-    allFiles: FileWithProgress[];
+export type { FileWithProgress } from '@opencx/widget-core';
+export declare function useUploadFiles(): {
+    allFiles: import('@opencx/widget-core').FileWithProgress[];
     appendFiles: (files: File[]) => void;
-    handleCancelUpload: (fileId: string) => void;
-    successFiles: FileWithProgress[];
+    handleCancelUpload: (id: string) => void;
+    successFiles: import('@opencx/widget-core').FileWithProgress[];
     emptyTheFiles: () => void;
-    getFileById: (id: string) => FileWithProgress | undefined;
+    getFileById: (id: string) => import('@opencx/widget-core').FileWithProgress | undefined;
     getUploadProgress: (id: string) => number;
     getUploadStatus: (id: string) => "success" | "error" | "pending" | "uploading" | undefined;
     hasErrors: boolean;
     isUploading: boolean;
 };
-export { useUploadFiles, type FileWithProgress };
 //# sourceMappingURL=useUploadFiles.d.ts.map

package/dist/src/hooks/useUploadFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useUploadFiles.d.ts","sourceRoot":"","sources":["../../../src/hooks/useUploadFiles.ts"],"names":[],"mappings":"AAMA,UAAU,gBAAgB;IACxB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iBAAS,cAAc;;yBAKO,IAAI,EAAE;iCA2DE,MAAM;;;sBAgCtB,MAAM;4BACA,MAAM;0BAER,MAAM;;;EAI/B;AAED,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"useUploadFiles.d.ts","sourceRoot":"","sources":["../../../src/hooks/useUploadFiles.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,wBAAgB,cAAc;;;;;;sBAeR,MAAM;4BACA,MAAM;0BAER,MAAM;;;EAK/B"}

package/dist/src/hooks/useWidgetRouter.d.ts

@@ -3,6 +3,6 @@ export declare function useWidgetRouter(): {
         screen: import('@opencx/widget-core').ScreenU;
     };
     toSessionsScreen: () => void;
-    toChatScreen: (sessionId?: string) => void;
+    toChatScreen: (sessionId?: string) => import('@opencx/widget-core').WidgetCtx | undefined;
 };
 //# sourceMappingURL=useWidgetRouter.d.ts.map

package/dist/src/index.d.ts

@@ -1,6 +1,8 @@
 export type { WidgetComponentType, WidgetComponentProps, } from './types/components';
 export { WidgetProvider, useWidget } from './WidgetProvider';
 export { useAgentChatUi } from './agent-chat/AgentChatContext';
+export { applyPresentation } from './agent-chat/apply-presentation';
+export { sessionPlan } from './agent-chat/session-plan';
 export type { SpecDataPart, StreamingStep, StreamingTurnState, StreamingTurnItem, } from './agent-chat/agent-chat-stream';
 export type { TurnRenderSource } from './agent-chat/agent-turn-sources';
 export { formatAskQuestionsAnswers } from './agent-chat/ask-questions';
@@ -22,4 +24,9 @@ export { useWidgetLayout, WidgetLayoutProvider } from './hooks/useWidgetLayout';
 export { useModes } from './hooks/useModes';
 export { useCsat } from './hooks/useCsat';
 export { useDictation } from './hooks/useDictation';
+export { useCompanionChats } from './ConversationWorkspace';
+export { useComposerDraft } from './hooks/useComposerDraft';
+export type { ConnectionRequest } from './agent-chat/agent-chat-stream';
+export type { PendingPageAction } from './agent-chat/useAgentChat';
+export { useConnection } from './agent-chat/useConnection';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAC1B,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,KAAK,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,YAAY,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,0BAA0B,EAC1B,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,KAAK,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/widget-user-identity.d.ts

@@ -0,0 +1,8 @@
+import { WidgetConfig } from '@opencx/widget-core';
+/**
+ * A local lifecycle fingerprint, never an authorization decision. Expiry and
+ * signatures intentionally do not participate, so a newly minted token for
+ * the same owner updates the transport without destroying session state.
+ */
+export declare const widgetUserIdentity: (config: WidgetConfig) => string;
+//# sourceMappingURL=widget-user-identity.d.ts.map

package/dist/src/widget-user-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-user-identity.d.ts","sourceRoot":"","sources":["../../src/widget-user-identity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA4BxD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,YAAY,KAAG,MAoCzD,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@opencx/widget-react-headless",
   "private": false,
-  "version": "5.0.0-beta.0",
+  "version": "5.0.0-beta.10",
   "type": "module",
   "repository": {
     "type": "git",
@@ -20,7 +20,7 @@
   "dependencies": {
     "uuid": "^11.0.4",
     "zod": "^4.3.6",
-    "@opencx/widget-core": "5.0.0-beta.0"
+    "@opencx/widget-core": "5.0.0-beta.10"
   },
   "peerDependencies": {
     "@types/react": ">=18 <20",
@@ -35,13 +35,13 @@
     "ai": "^7.0.31",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "@opencx/eslint-config": "0.0.1",
-    "@opencx/tsconfig": "0.0.2"
+    "@opencx/tsconfig": "0.0.2",
+    "@opencx/eslint-config": "0.0.1"
   },
   "scripts": {
     "clean": "rm -rf node_modules dist .turbo",
     "clean:dist": "rm -rf dist .turbo",
-    "build": "vite build",
+    "build": "NODE_ENV=production vite build && node ../../scripts/check-production-build.mjs dist",
     "test": "vitest run",
     "type-check": "tsc --noEmit",
     "lint": "eslint .",

package/dist/src/__tests__/WidgetProvider.initialization.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=WidgetProvider.initialization.spec.d.ts.map

package/dist/src/__tests__/WidgetProvider.initialization.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WidgetProvider.initialization.spec.d.ts","sourceRoot":"","sources":["../../../src/__tests__/WidgetProvider.initialization.spec.tsx"],"names":[],"mappings":""}

package/dist/src/agent-chat/__tests__/WidgetProvider.agent-chat.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=WidgetProvider.agent-chat.spec.d.ts.map

package/dist/src/agent-chat/__tests__/WidgetProvider.agent-chat.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WidgetProvider.agent-chat.spec.d.ts","sourceRoot":"","sources":["../../../../src/agent-chat/__tests__/WidgetProvider.agent-chat.spec.tsx"],"names":[],"mappings":""}

package/dist/src/agent-chat/__tests__/agent-chat-queue.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=agent-chat-queue.spec.d.ts.map

package/dist/src/agent-chat/__tests__/agent-chat-queue.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-chat-queue.spec.d.ts","sourceRoot":"","sources":["../../../../src/agent-chat/__tests__/agent-chat-queue.spec.ts"],"names":[],"mappings":""}

package/dist/src/agent-chat/__tests__/agent-chat-stream.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=agent-chat-stream.spec.d.ts.map

package/dist/src/agent-chat/__tests__/agent-chat-stream.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-chat-stream.spec.d.ts","sourceRoot":"","sources":["../../../../src/agent-chat/__tests__/agent-chat-stream.spec.ts"],"names":[],"mappings":""}