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

package/dist/package.json.d.ts

@@ -0,0 +1,53 @@
+declare const _default: {
+  "name": "@opencx/widget-react-headless",
+  "private": false,
+  "version": "5.0.0-beta.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openchatai/widget"
+  },
+  "scripts": {
+    "clean": "rm -rf node_modules dist .turbo",
+    "clean:dist": "rm -rf dist .turbo",
+    "build": "vite build",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write ."
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@opencx/widget-core": "workspace:*",
+    "uuid": "^11.0.4",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@types/react": ">=18 <20",
+    "@types/react-dom": ">=18 <20",
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20"
+  },
+  "devDependencies": {
+    "@ai-sdk/react": "4.0.34",
+    "@opencx/eslint-config": "workspace:*",
+    "@opencx/tsconfig": "workspace:*",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "ai": "^7.0.31",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8"
+  }
+}
+;
+
+export default _default;

package/dist/src/WidgetProvider.d.ts

@@ -10,7 +10,7 @@ interface WidgetProviderValue {
     version: string;
     contentIframeRef?: React.MutableRefObject<HTMLIFrameElement | null>;
 }
-export declare function WidgetProvider({ options: config, children, components, storage, loadingComponent, }: {
+export declare function WidgetProvider({ options: config, children, components, storage, loadingComponent, errorComponent, }: {
     options: WidgetConfig;
     children: React.ReactNode;
     components?: WidgetComponentType[];
@@ -20,7 +20,14 @@ export declare function WidgetProvider({ options: config, children, components,
      * Not to be confused with the `loading` custom component which renders when the bot's reply is pending
      */
     loadingComponent?: React.ReactNode;
-}): string | number | bigint | true | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null;
+    /**
+     * Render initialization failures (invalid token, network failure). When
+     * omitted the widget renders nothing and reports the failure to the
+     * console — a support widget must never take the host's React tree down
+     * with it.
+     */
+    errorComponent?: (error: Error) => React.ReactNode;
+}): React.ReactElement | null;
 export declare function useWidget(): WidgetProviderValue;
 export {};
 //# sourceMappingURL=WidgetProvider.d.ts.map

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,EACjB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,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,GACjB,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;CACpC,oRA0CA;AAED,wBAAgB,SAAS,wBAMxB"}
+{"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"}

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

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

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

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

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

@@ -0,0 +1,58 @@
+import { WidgetConfig, WidgetCtx, WidgetUserMessage } from '@opencx/widget-core';
+import { default as React } from 'react';
+import { StreamingTurnItem } from './agent-chat-stream';
+import { TurnRenderSource } from './agent-turn-sources';
+import { AskQuestionsRequest } from './ask-questions';
+import { AgentChatPageEffect } from './useAgentChat';
+/**
+ * Streaming state for the agent-chat surface, produced by the single
+ * `useAgentChat` (one useChat instance) and consumed by the message list
+ * (live overlay) and the shared composer (stop button + the queue pill above
+ * the input).
+ *
+ * On embeds whose org does not stream there is no provider, so the defaults
+ * below apply.
+ */
+export type AgentChatUiValue = {
+    isStreaming: boolean;
+    liveItems: StreamingTurnItem[];
+    /**
+     * Finished turns' render sources: the transcript rows each covers and the
+     * streaming items that replace those rows' plain bubbles (retained live
+     * turns + server-fetched historical `ui_parts`).
+     */
+    turnSources: TurnRenderSource[];
+    /**
+     * The live turn's node key — stable through the retained promotion. Null
+     * while no turn is live or settling.
+     */
+    liveTurnKey: string | null;
+    /** The last turn failed — the transcript shows an error row with retry. */
+    turnFailed: boolean;
+    retryFailedTurn: () => void;
+    /** Messages the user queued mid-turn — rendered in the composer's queue pill. */
+    queuedUserMessages: WidgetUserMessage[];
+    /** Drop one queued (not-yet-sent) message from the pill. */
+    removeQueued: (messageId: string) => void;
+    /** Stop the live response; queued messages survive and drain next. */
+    stop: () => void;
+    /** Host-page effects normalized from the current assistant tool parts. */
+    pageEffects: AgentChatPageEffect[];
+    /**
+     * The clarification the agent is waiting on — the composer shows the
+     * questionnaire in its place — or null.
+     */
+    pendingClarification: AskQuestionsRequest | null;
+};
+/** Reads the agent streaming state; safe defaults when not in an agent surface. */
+export declare function useAgentChatUi(): AgentChatUiValue;
+/**
+ * WidgetProvider-owned engine mount. Non-streaming widgets get the same safe
+ * context interface without loading a useChat instance.
+ */
+export declare function AgentChatProvider({ children, widgetCtx, config, }: {
+    children: React.ReactNode;
+    widgetCtx: WidgetCtx;
+    config: WidgetConfig;
+}): React.JSX.Element;
+//# sourceMappingURL=AgentChatContext.d.ts.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/src/agent-chat/__tests__/use-agent-chat.client-context.spec.d.ts

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

package/dist/src/agent-chat/__tests__/use-agent-chat.client-context.spec.d.ts.map

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

package/dist/src/agent-chat/__tests__/use-agent-chat.drain-order.spec.d.ts

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

package/dist/src/agent-chat/__tests__/use-agent-chat.drain-order.spec.d.ts.map

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

package/dist/src/agent-chat/__tests__/use-agent-chat.failed-turn.spec.d.ts

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

package/dist/src/agent-chat/__tests__/use-agent-chat.failed-turn.spec.d.ts.map

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

package/dist/src/agent-chat/__tests__/use-agent-chat.feature-narrowing.spec.d.ts

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

package/dist/src/agent-chat/__tests__/use-agent-chat.feature-narrowing.spec.d.ts.map

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

package/dist/src/agent-chat/__tests__/use-agent-chat.send-features.spec.d.ts

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

package/dist/src/agent-chat/__tests__/use-agent-chat.send-features.spec.d.ts.map

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

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

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

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

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

package/dist/src/agent-chat/__tests__/use-agent-chat.stop-partial.spec.d.ts

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

package/dist/src/agent-chat/__tests__/use-agent-chat.stop-partial.spec.d.ts.map

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

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

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

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

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

package/dist/src/agent-chat/__tests__/use-agent-chat.turn-retention.spec.d.ts

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

package/dist/src/agent-chat/__tests__/use-agent-chat.turn-retention.spec.d.ts.map

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

package/dist/src/agent-chat/__tests__/use-chat-post-finish-data-part.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-chat-post-finish-data-part.spec.d.ts.map

package/dist/src/agent-chat/__tests__/use-chat-post-finish-data-part.spec.d.ts.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * A bounded FIFO buffer for multi-send. While an agent turn is streaming
+ * (useChat `status !== 'ready'`) the user's sends are queued here and drained
+ * one-per-turn when the turn ends — by finishing, erroring, or being stopped.
+ * Once accepted, an item is never displaced by a later enqueue: capacity
+ * rejects the newest proposal so its caller can keep the payload intact.
+ */
+export declare class AgentChatQueue<T> {
+    private buffer;
+    /** Effective cap is at least 1. */
+    private readonly cap;
+    constructor(max: number);
+    get size(): number;
+    /** Read-only snapshot of pending items, oldest first. */
+    get items(): readonly T[];
+    /**
+     * Append an item when capacity permits. Returns `false` without mutating
+     * the accepted FIFO backlog when full.
+     */
+    enqueue(item: T): boolean;
+    /** Remove and return the next item (FIFO), or `null` when empty. */
+    dequeueNext(): T | null;
+    /**
+     * Remove and return the first item matching `predicate`, or `null` when
+     * nothing matches. Used by the queue pill's per-message remove button.
+     */
+    removeWhere(predicate: (item: T) => boolean): T | null;
+}
+//# sourceMappingURL=agent-chat-queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-chat-queue.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/agent-chat-queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,cAAc,CAAC,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAW;IACzB,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IAIvB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yDAAyD;IACzD,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CAExB;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAMzB,oEAAoE;IACpE,WAAW,IAAI,CAAC,GAAG,IAAI;IAIvB;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,IAAI;CAMvD"}

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

@@ -0,0 +1,74 @@
+import { AskQuestionsRequest } from './ask-questions';
+/** One line of a turn's activity trace (reasoning or a tool call). */
+export type StreamingStep = {
+    kind: 'reasoning' | 'tool';
+    /** Reasoning text, or the tool name. */
+    label: string;
+    done: boolean;
+    /**
+     * Tool steps only: the call's arguments and its result, carried straight
+     * off the part. Rendered only where the embedder opted in
+     * (`showStepToolIO`); every other surface reads the label alone, so this
+     * costs nothing but a reference.
+     */
+    input?: unknown;
+    output?: unknown;
+};
+/**
+ * The wire type `pipeJsonRender` gives the ` ```spec ` fenced JSONL patches it
+ * drains out of model text as typed `data-spec` UIMessage parts. The styled
+ * renderer assembles these into a renderable element-tree spec.
+ */
+declare const SPEC_DATA_PART_TYPE = "data-spec";
+export type SpecDataPart = {
+    type: typeof SPEC_DATA_PART_TYPE;
+    data: unknown;
+};
+/** One chronological render entry in an agent turn. */
+export type StreamingTurnItem = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'steps';
+    steps: StreamingStep[];
+} | {
+    kind: 'spec';
+    parts: SpecDataPart[];
+}
+/**
+ * A clarification the agent asked. Never rendered in the transcript: the
+ * NEWEST one still pending takes the composer's place instead
+ * (`pendingClarification`), and an answered one leaves no card behind.
+ */
+ | {
+    kind: 'questions';
+    request: AskQuestionsRequest;
+};
+/** The in-flight turn's render state: active + its ordered items. */
+export type StreamingTurnState = {
+    active: boolean;
+    items: StreamingTurnItem[];
+};
+/**
+ * The structural surface read from live AI SDK parts and persisted `ui_parts`,
+ * keeping both paths behind one mapper so they cannot drift.
+ */
+type UiPartLike = {
+    type: string;
+    text?: unknown;
+    state?: unknown;
+    data?: unknown;
+    toolName?: unknown;
+    toolCallId?: unknown;
+    input?: unknown;
+    output?: unknown;
+    [key: string]: unknown;
+};
+/** The message surface consumed by the item mapper. */
+export type UiMessageLike = {
+    parts: ReadonlyArray<UiPartLike>;
+};
+/** Flatten UIMessage parts into chronological render items. */
+export declare function mapUiPartsToItems(parts: ReadonlyArray<UiPartLike>): StreamingTurnItem[];
+export {};
+//# sourceMappingURL=agent-chat-stream.d.ts.map

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

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

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

@@ -0,0 +1,29 @@
+import { DefaultChatTransport, UIMessage } from 'ai';
+/** Wiring the api layer hands the agent-chat transport (send + reconnect URLs + auth). */
+export type AgentChatTransportOptions = {
+    /** POST endpoint that starts a turn and streams it. */
+    api: string;
+    /** Session-scoped GET the transport hits to resume an in-flight stream. */
+    reconnectApi: (sessionId: string) => string;
+    /**
+     * Auth headers (X-Bot-Token + Authorization), content-type stripped,
+     * resolved PER REQUEST: the contact JWT is minted lazily on first contact
+     * creation, so a snapshot taken at mount would send every stream request
+     * without Authorization (401) for the rest of the session.
+     */
+    headers: () => Record<string, string>;
+};
+/** Build the reconnect request used by `useChat` to resume a session stream. */
+export declare function agentChatReconnectPreparer(options: AgentChatTransportOptions): ({ id }: {
+    id: string;
+}) => {
+    api: string;
+    headers: Record<string, string>;
+};
+/**
+ * The AI SDK adapter for agent chat. It owns only SDK request wiring: the
+ * whole wire body is handed to each send (`buildSendMessageBody`) and
+ * forwarded as-is.
+ */
+export declare function buildAgentChatTransport(options: AgentChatTransportOptions): DefaultChatTransport<UIMessage>;
+//# sourceMappingURL=agent-chat-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-chat-transport.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/agent-chat-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,IAAI,CAAC;AAE1D,0FAA0F;AAC1F,MAAM,MAAM,yBAAyB,GAAG;IACtC,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C;;;;;OAKG;IACH,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,yBAAyB,IACnE,QAAQ;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;;;EAI/B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,yBAAyB,GACjC,oBAAoB,CAAC,SAAS,CAAC,CASjC"}

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

@@ -0,0 +1,23 @@
+import { AgentTurnMessagesDto } from '@opencx/widget-core';
+import { StreamingTurnItem } from './agent-chat-stream';
+/** One settled turn's transcript coverage and styled render model. */
+export type TurnRenderSource = {
+    key: string;
+    turnId: string;
+    rowIds: string[];
+    items: StreamingTurnItem[];
+};
+/** Fold a fresh history fetch into the current list of turn render sources. */
+export declare function mergeTurnSources({ existing, fetched, }: {
+    existing: TurnRenderSource[];
+    fetched: AgentTurnMessagesDto;
+}): TurnRenderSource[];
+/** Read the terminal turn identity emitted on a finished useChat message. */
+export declare function parseTurnSettledPart(parts: ReadonlyArray<{
+    type: string;
+    data?: unknown;
+}>): {
+    turnId: string;
+    rowIds: string[];
+} | null;
+//# sourceMappingURL=agent-turn-sources.d.ts.map

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

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

package/dist/src/agent-chat/ask-questions.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The `ask_questions` clarification payload.
+ *
+ * When the agent needs to narrow a request before acting it calls this tool
+ * instead of writing a paragraph of questions. Rendering that call as an
+ * ordinary tool step would show the customer raw JSON, so the stream mapper
+ * lifts it out of the activity trace and the styled layer renders the QUESTION
+ * — the same trade the companion has always made.
+ *
+ * The payload arrives in two shapes and both are accepted:
+ *
+ *  1. as the tool's INPUT — the model emits the questions in the tool-call
+ *     chunk and the step finishes without a result, because the customer's
+ *     reply IS the result, fed back as the next user message;
+ *  2. as the tool's OUTPUT — an MCP server answers with a structured response
+ *     carrying `request_id` and per-option `{ id, label }`.
+ *
+ * The loose model-emitted shape is normalised into the strict rendered shape,
+ * so selection state can key off stable ids no matter which shape arrived.
+ */
+export type AskQuestionsRequest = {
+    request_id: string;
+    questions: Array<{
+        id: string;
+        prompt: string;
+        selection: 'single' | 'multiple';
+        /**
+         * Chips to pick from. May be empty once the "I'll type it" restatements
+         * are dropped — the questionnaire then offers the free-text answer alone.
+         */
+        options: Array<{
+            id: string;
+            label: string;
+        }>;
+    }>;
+};
+/** Matches the bare name and any MCP-prefixed form (`mcp__opencx__ask_questions`). */
+export declare function isAskQuestionsToolName(toolName: string | undefined): boolean;
+/**
+ * Parses a clarification request from a tool part's output or input. Returns
+ * `null` on anything unrecognised — a malformed payload must fall back to the
+ * ordinary step rendering, never blank the turn or throw inside the stream.
+ */
+export declare function parseAskQuestionsPayload(payload: unknown, fallbackRequestId?: string): AskQuestionsRequest | null;
+/**
+ * The single combined message sent back when the customer submits. One
+ * `Q:`/`A:` block per answered question keeps the mapping explicit for the
+ * agent reading it as an ordinary user turn.
+ */
+export declare function formatAskQuestionsAnswers(request: AskQuestionsRequest, answersByQuestionId: ReadonlyMap<string, string>): string;
+//# sourceMappingURL=ask-questions.d.ts.map

package/dist/src/agent-chat/ask-questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-questions.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/ask-questions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,QAAQ,GAAG,UAAU,CAAC;QACjC;;;WAGG;QACH,OAAO,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/C,CAAC,CAAC;CACJ,CAAC;AAmBF,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE5E;AA2ED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,iBAAiB,CAAC,EAAE,MAAM,GACzB,mBAAmB,GAAG,IAAI,CAK5B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,mBAAmB,EAC5B,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/C,MAAM,CAQR"}

package/dist/src/agent-chat/pending-clarification.d.ts

@@ -0,0 +1,27 @@
+import { StreamingTurnItem } from './agent-chat-stream';
+import { AskQuestionsRequest } from './ask-questions';
+import { TurnRenderSource } from './agent-turn-sources';
+/**
+ * The clarification the agent is currently WAITING on, or `null`.
+ *
+ * A pending clarification replaces the composer, so this answers "should the
+ * customer be picking an option instead of typing?" — not merely "was a
+ * question asked at some point". Three rules decide it, and each one exists
+ * because of how the answer is delivered (as an ordinary user message):
+ *
+ *  - Nothing while the turn is still streaming. The agent may yet ask again,
+ *    and chips rendered mid-stream look clickable while the answer they would
+ *    send is about to be superseded.
+ *  - The NEWEST questionnaire wins — the live turn's over any settled turn's,
+ *    and the last of several within one turn.
+ *  - Nothing once the customer has spoken since. Their reply IS the answer, so
+ *    a questionnaire still on screen after it would collect a second one.
+ */
+export declare function pendingClarification({ turnSources, liveItems, isStreaming, lastMessageIsFromUser, }: {
+    turnSources: ReadonlyArray<Pick<TurnRenderSource, 'items'>>;
+    liveItems: ReadonlyArray<StreamingTurnItem>;
+    isStreaming: boolean;
+    /** The transcript's last row is the customer's — they have already answered. */
+    lastMessageIsFromUser: boolean;
+}): AskQuestionsRequest | null;
+//# sourceMappingURL=pending-clarification.d.ts.map

package/dist/src/agent-chat/pending-clarification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-clarification.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/pending-clarification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,WAAW,EACX,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,EAAE;IACD,WAAW,EAAE,aAAa,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,SAAS,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,qBAAqB,EAAE,OAAO,CAAC;CAChC,GAAG,mBAAmB,GAAG,IAAI,CAS7B"}

package/dist/src/agent-chat/steer-into-live-turn.d.ts

@@ -0,0 +1,35 @@
+import { UIMessageChunk } from 'ai';
+/**
+ * What the v5 stream endpoint did with a message POSTed while the session
+ * already had a live turn. Decided by the FIRST chunk of the request's own
+ * stream:
+ * - `steered`: the message joined the live turn (`data-turn-steered` is the
+ *   only chunk); the live turn's stream — already rendering — answers it.
+ * - `turn`: the live turn did not take it, so the backend superseded that
+ *   turn and opened a new one for this message on THIS stream. The caller
+ *   drops this copy and replays the new turn through the engine's own
+ *   stream (the session's resume pointer moved to it).
+ * - `failed`: the turn errored before producing anything.
+ * - `silent`: the stream ended with no chunk at all — the reply was withheld
+ *   (assist draft, handoff); the transcript rows say what happened.
+ */
+export type SteerOutcome = {
+    kind: 'steered';
+} | {
+    kind: 'turn';
+} | {
+    kind: 'failed';
+    errorText: string;
+} | {
+    kind: 'silent';
+};
+/**
+ * Classify a steer attempt from its stream's first DECISIVE chunk, then
+ * release the stream. The backend heartbeats (`data-keepalive`) while the
+ * request waits to be steered or for a fallback turn's first chunk — those
+ * decide nothing and are skipped. Releasing never cancels the server turn
+ * (resumable streams treat a client drop as a disconnect), so the `turn`
+ * case can be replayed.
+ */
+export declare function readSteerOutcome(stream: ReadableStream<UIMessageChunk>): Promise<SteerOutcome>;
+//# sourceMappingURL=steer-into-live-turn.d.ts.map

package/dist/src/agent-chat/steer-into-live-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steer-into-live-turn.d.ts","sourceRoot":"","sources":["../../../src/agent-chat/steer-into-live-turn.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC,GACrC,OAAO,CAAC,YAAY,CAAC,CAgBvB"}

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

@@ -0,0 +1,12 @@
+/**
+ * Stop a live streamed turn. With resumable streams, a client abort is only a
+ * disconnect, so the server generation must also be cancelled.
+ */
+export declare function stopAgentChatTurn({ api, sessionId, chatStop, }: {
+    api: {
+        stopStream: (sessionId: string) => Promise<void>;
+    };
+    sessionId: string | null;
+    chatStop: () => void | Promise<void>;
+}): Promise<void>;
+//# sourceMappingURL=stop-agent-chat-turn.d.ts.map