@streamoid/agent 0.6.17 → 0.6.18

package/dist/index.d.ts

@@ -201,3 +201,28 @@ export interface ConversationSearchDialogProps {
 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>;