@streamoid/agent 0.6.16 → 0.6.18

package/dist/index.d.ts

@@ -154,3 +154,75 @@ export declare function AgentPanel(props: AgentPanelProps): ReactElement;
 
 /** The embeddable chat shell AgentPanel wraps — for advanced composition. */
 export declare function AgentChatShell(props: { adapters: AgentChatShellAdapters }): ReactElement;
+
+/* ── Search or Ask CXO ─────────────────────────────────────────────────────
+ *
+ * NOTE FOR MAINTAINERS: this file is COPIED VERBATIM into the published
+ * package (`build:lib` does `cp lib-template/index.d.ts dist-lib/dist/`), so it
+ * is a second, hand-kept surface alongside `src/embed/index.ts`. Exporting
+ * something there and not here ships a value with no type, and the consumer's
+ * `tsc` fails on the import rather than at runtime. */
+
+/** One search hit. Mirrors `ConversationSearchResult` in `src/api/chat.ts` —
+ *  keep the two in step, field for field. */
+export interface ConversationSearchResult {
+  conversation_id: string;
+  workspace_id?: string | null;
+  message_id?: string | null;
+  conversation_title?: string | null;
+  /** The matching text. Required — the result row renders it. */
+  snippet: string;
+  role?: string | null;
+  created_at?: string | null;
+  updated_at?: string | null;
+  matched_on: 'message' | 'title';
+  rank: number;
+}
+
+export interface ConversationSearchDialogProps {
+  workspaceId?: string | null;
+  /** Override the search call. Defaults to this workspace's conversations, so a
+   *  host embedding the panel needs no API client of its own. */
+  search?: (query: string) => Promise<ConversationSearchResult[]>;
+  onClose(): void;
+  onSelectResult(result: ConversationSearchResult): void;
+  /** Start a NEW chat from the typed text. Supplying it turns the search box
+   *  into "Search or Ask CXO": an Ask row appears and Enter submits it. Throw
+   *  or reject to keep the dialog open with an inline error. Omit for
+   *  search-only. */
+  onAsk?(query: string): Promise<void> | void;
+  placeholder?: string;
+  emptyStateTitle?: string;
+  emptyStateDescription?: string;
+}
+
+/** "Search or Ask CXO" — the command dialog a host opens from its sidebar's
+ *  search trigger, identical in every product. */
+export declare function ConversationSearchDialog(
+  props: ConversationSearchDialogProps,
+): ReactElement;
+
+/** Input for {@link startConversation}. */
+export interface StartConversationInput {
+  workspaceId: string;
+  userId: string;
+  email: string;
+  /** The user's first message. Trimmed; empty is rejected. */
+  prompt: string;
+}
+
+/**
+ * Start a NEW conversation from a first message and return its id — for a host
+ * that has a question but no chat open yet (the dialog's Ask row). Hand the id
+ * back to the panel through `adapters.chatId`.
+ *
+ * Delegates to the same send path the chat itself uses, so `enc_token`,
+ * `color_mode` and `host_context` are filled in from inside the bundle; a host
+ * cannot see those and should not try to send them itself.
+ *
+ * Resolves `null` when the inputs are incomplete or the send fails, so a caller
+ * can show "could not start this chat" without unpacking an error.
+ */
+export declare function startConversation(
+  input: StartConversationInput,
+): Promise<string | null>;