stream-chat-react-native-core 9.12.1 → 9.14.0

package/lib/typescript/ai-components/conversation-state/controller/types.d.ts

@@ -0,0 +1,142 @@
+import type { AIMessageRating } from '../../message/AIReplyActions';
+import type { AIChatOption } from '../../message-composer/ChatOptions';
+import type { MediaAsset } from '../../services/media-picker-service/AbstractMediaPickerService';
+import type { AIMessage } from '../types';
+/**
+ * Where the latest exchange with the agent is:
+ * - `ready`: nothing is on its way: the agent answered, or the person stopped it.
+ * - `submitted`: the person's request is on its way, or the agent is working on it and its reply
+ *   shows nothing yet.
+ * - `streaming`: the agent is writing its reply.
+ * - `error`: the latest request failed, or the agent couldn't answer it. `retry()` tries again.
+ */
+export type AIConversationStatus = 'ready' | 'submitted' | 'streaming' | 'error';
+/** Whether the agent is answering: the request is submitted, or its reply streaming. */
+export declare const isAIConversationAnswering: (status: AIConversationStatus) => status is "streaming" | "submitted";
+/**
+ * What the person asks for:
+ * - `message`: a new message from the person.
+ * - `regenerate`: a new reply in place of the request's `message`, which is a reply, and of those
+ *   after it. Without `message`, a reply to the latest message, which has none, such as after the
+ *   agent couldn't answer it.
+ * - `edit`: the person changed the request's `message`, one of theirs, to say its `text`: it is
+ *   answered again, in place of the replies after it.
+ *
+ * An open set: a kind of your own is on its way like a message.
+ */
+export type AIConversationRequestKind = 'message' | 'regenerate' | 'edit' | (string & {});
+/** What the person asks the agent, as an `AIConversationTransport` sends it. */
+export type AIConversationRequest<Message extends AIMessage = AIMessage> = {
+    /** What the person asks for. */
+    kind: AIConversationRequestKind;
+    /**
+     * An id for the person's message. A transport that creates the message with it lets the
+     * conversation find its copy by it. A retry of the request keeps it.
+     */
+    messageId: string;
+    /** What the person wrote. When a reply is written again, the message it answers says it. */
+    text: string;
+    /** The files the person picked, on this device, to upload with their message. */
+    attachments: MediaAsset[];
+    /** The option the person picked in the composer, such as thinking harder. */
+    chatOption?: AIChatOption;
+    /** What the composer held besides, as `ComposerState.custom`. */
+    custom?: Record<string, unknown>;
+    /** The message it is about: the reply to write again, or the person's message they edited. */
+    message?: Message;
+};
+/** The ids of the states Stream Chat's AI indicator reports. */
+export declare const AIAgentActivityStates: {
+    readonly checkingExternalSources: "AI_STATE_EXTERNAL_SOURCES";
+    readonly error: "AI_STATE_ERROR";
+    readonly generating: "AI_STATE_GENERATING";
+    readonly thinking: "AI_STATE_THINKING";
+};
+/**
+ * What the agent is doing. An open set: compare against the states you know. Those of
+ * `AIAgentActivityStates` are Stream Chat's AI indicator's.
+ */
+export type AIAgentActivityState = (typeof AIAgentActivityStates)[keyof typeof AIAgentActivityStates] | (string & {});
+/** What the agent says it is doing besides what its reply shows, such as checking sources. */
+export type AIAgentActivity = {
+    state: AIAgentActivityState;
+    /** What it says about it, such as "Searching the web", or why it couldn't answer. */
+    text?: string;
+};
+/** What the conversation's views offer the person to do with its messages. All by default. */
+export type AIConversationActions = {
+    /** Editing the person's latest message, which is then answered again. */
+    edit?: boolean;
+    /** Rating replies. */
+    rate?: boolean;
+    /** Asking for a new reply in place of the latest. */
+    regenerate?: boolean;
+};
+/**
+ * Where an `AIConversationTransport` tells its `AIConversationController` what the conversation
+ * holds. Once the controller is disposed, its updates go nowhere.
+ */
+export type AIConversationFeed<Message extends AIMessage = AIMessage> = {
+    /** Whether the controller it updates is still there. Stop following what it holds once it isn't. */
+    readonly isConnected: boolean;
+    /** The conversation's messages, oldest first, each time they change. */
+    updateMessages: (messages: readonly Message[]) => void;
+    /** Whether there are messages before the first one, which `loadOlderMessages` loads. */
+    updateHasOlderMessages: (hasOlderMessages: boolean) => void;
+    /** What the agent says it is doing, or `undefined` once it stops saying. */
+    updateActivity: (activity: AIAgentActivity | undefined) => void;
+};
+/**
+ * How an `AIConversationController` reaches the agent and learns what it holds: it sends what the
+ * person asks, stops the agent, and tells the controller its messages as they change.
+ *
+ * With Stream Chat, the conversation is a channel: the transport follows its messages and AI
+ * indicator events, and sends each request through the channel or your agent's own API.
+ *
+ * ```ts
+ * const transport: AIConversationTransport = {
+ *   connect: (feed) => {
+ *     const update = () => feed.updateMessages(channel.state.messages.map(fromStreamMessage));
+ *     update();
+ *     return channel.on(update).unsubscribe;
+ *   },
+ *   send: (request) => agent.respond(request.text, request.attachments),
+ *   stop: () => agent.interrupt(),
+ * };
+ * ```
+ */
+export type AIConversationTransport<Message extends AIMessage = AIMessage> = {
+    /**
+     * Starts telling `feed` what the conversation holds: its messages each time they change,
+     * whether there are older ones to load, and what the agent says it is doing. The controller
+     * calls it once, as it is made, and calls what it returns once it is disposed.
+     */
+    connect: (feed: AIConversationFeed<Message>) => void | (() => void);
+    /**
+     * Sends what the person asks. Resolve once the agent has the request: its reply arrives
+     * through the feed. A rejection shows as the conversation's error, and the person can retry,
+     * which sends the same request again with the same `messageId`: if the first attempt reached
+     * your backend, or you keep a copy of the failed message, use the id so the message isn't added
+     * twice. A rejection with an `AbortError` ends the request without an error.
+     *
+     * The controller leaves out the messages a `regenerate` or an `edit` replaces only until the
+     * new reply starts. From then on it shows the messages as the feed has them, so update the
+     * conversation before the new reply arrives:
+     * - For a regenerate, remove the request's `message` and the messages after it, or write the
+     *   new reply in place of `message`, under its id.
+     * - For an edit, change the person's `message` to say the request's `text`, under its id, and
+     *   remove the messages after it.
+     */
+    send: (request: AIConversationRequest<Message>) => Promise<void>;
+    /** Stops the reply the agent is writing. What it wrote so far stays. */
+    stop: () => Promise<void>;
+    /** Loads the messages before the first one, which arrive through the feed. */
+    loadOlderMessages?: () => Promise<void>;
+    /**
+     * Tells your backend how the person rated a reply, or that they took their rating back with
+     * `null`. Without it, the controller keeps the ratings on this device. Ratings your backend has
+     * show through each message's `rating`.
+     */
+    rate?: (reply: Message, rating: AIMessageRating | null) => Promise<void>;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/ai-components/conversation-state/controller/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation-state/controller/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/ai-components/conversation-state/controller/useAIConversationState.d.ts

@@ -0,0 +1,9 @@
+import type { AIConversationController, AIConversationControllerState } from './AIConversationController';
+import type { AIMessage } from '../types';
+/**
+ * Follows what `selector` picks of a conversation's state, such as its `status` or `error`: the
+ * component renders again when it changes. Keep `selector` outside the component, so it stays the
+ * same between renders.
+ */
+export declare const useAIConversationState: <Message extends AIMessage, Selected extends Readonly<Record<string, unknown>>>(conversation: AIConversationController<Message>, selector: (state: AIConversationControllerState<Message>) => Selected) => Selected;
+//# sourceMappingURL=useAIConversationState.d.ts.map

package/lib/typescript/ai-components/conversation-state/controller/useAIConversationState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAIConversationState.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation-state/controller/useAIConversationState.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,6BAA6B,EAC9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,SAAS,SAAS,EACzB,QAAQ,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAElD,cAAc,wBAAwB,CAAC,OAAO,CAAC,EAC/C,UAAU,CAAC,KAAK,EAAE,6BAA6B,CAAC,OAAO,CAAC,KAAK,QAAQ,aACvB,CAAC"}

package/lib/typescript/ai-components/conversation-state/fromStreamMessage.d.ts

@@ -0,0 +1,25 @@
+import type { LocalMessage, MessageResponse } from 'stream-chat';
+import type { AIMessage } from './types';
+/** A Stream message, as the channel's state or an event has it. */
+export type AIStreamMessage = Pick<LocalMessage | MessageResponse, 'attachments' | 'id' | 'text'> & Record<string, unknown>;
+export type FromStreamMessageOptions = {
+    /** Whether the agent wrote it. Defaults to the message's `ai_generated` field. */
+    isAssistant?: (message: AIStreamMessage) => boolean;
+    /** The whole of a reasoning step's thinking, when the app has it, such as from live updates. */
+    reasoningText?: (messageId: string, stepId: string) => string | undefined;
+};
+/**
+ * Adapts a Stream message for `AIConversation`: a reply is one with `ai_generated: true`, it is
+ * being written while `generating: true`, its steps are its `ai_reasoning` and `ai_tool_call`
+ * attachments, its images and files are its other attachments, and the UI the agent wrote for
+ * it is its `ai_ui` field. A person's message has no UI, whatever its fields say.
+ */
+export declare const fromStreamMessage: (message: AIStreamMessage, { isAssistant, reasoningText }?: FromStreamMessageOptions) => AIMessage;
+/**
+ * A `fromStreamMessage` that gives back the same `AIMessage` for the same Stream message object.
+ * The channel's state replaces only the messages that change, so mapping its messages through it
+ * on every update leaves the others as they were, and `AIConversation` renders only the changed
+ * ones again. Make one per conversation, such as with `useState(() => createFromStreamMessage())`.
+ */
+export declare const createFromStreamMessage: (options?: FromStreamMessageOptions) => (message: AIStreamMessage) => AIMessage;
+//# sourceMappingURL=fromStreamMessage.d.ts.map

package/lib/typescript/ai-components/conversation-state/fromStreamMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromStreamMessage.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/conversation-state/fromStreamMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMzC,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,GAAG,eAAe,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAAC,GAC/F,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B,MAAM,MAAM,wBAAwB,GAAG;IACrC,kFAAkF;IAClF,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC;IACpD,gGAAgG;IAChG,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC3E,CAAC;AA0BF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,eAAe,EACxB,iCAAgC,wBAA6B,KAC5D,SAkBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,wBAAwB,MAEhE,SAAS,eAAe,cAQjC,CAAC"}

package/lib/typescript/ai-components/conversation-state/index.d.ts

@@ -0,0 +1,4 @@
+export * from './controller';
+export * from './fromStreamMessage';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/ai-components/conversation-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/conversation-state/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/lib/typescript/ai-components/conversation-state/types.d.ts

@@ -0,0 +1,55 @@
+import type { AIUIDocument } from '../generative-ui/AIUIDocument';
+import type { AIMessageAttachmentData } from '../message/AIMessageAttachment';
+import type { AIMessageRating } from '../message/AIReplyActions';
+import type { AIMessagePartData } from '../message-parts/types';
+/** Who wrote a message: the person using the app (`user`) or the agent (`assistant`). */
+export type AIMessageRole = 'user' | 'assistant' | (string & {});
+/**
+ * A message of the conversation as the AI components show it. `fromStreamMessage` makes one
+ * from a Stream message.
+ */
+export type AIMessage = {
+    id: string;
+    /** Who wrote it. Each of the person's messages starts a turn. */
+    role: AIMessageRole;
+    /** What it says. A reply's text is Markdown. */
+    text: string;
+    /** What it carries besides its text, such as images and files. */
+    attachments?: AIMessageAttachmentData[];
+    /** Whether the agent is still writing it. */
+    isGenerating?: boolean;
+    /**
+     * How the person rated a reply, as your backend has it. An `AIConversationController` shows it
+     * until the person rates the reply on this device.
+     */
+    rating?: AIMessageRating | null;
+    /** The steps the agent took for it, in order: reasoning, tool calls and kinds of its own. */
+    parts?: AIMessagePartData[];
+    /**
+     * The whole of a reasoning step's thinking when the app has it, such as from live updates.
+     * Without it, the step shows its own excerpt. It is read on every render, so look it up
+     * rather than work it out.
+     */
+    reasoningText?: (stepId: string) => string | undefined;
+    /**
+     * The UI the agent wrote for a reply, which shows in place of its text when the
+     * conversation's `ui` host has a renderer for it. A person's message has none.
+     */
+    uiDocument?: AIUIDocument;
+};
+/**
+ * A message the person sent that is not in the conversation's messages yet. The conversation
+ * shows it until its copy arrives, and shows the agent thinking meanwhile.
+ */
+export type AIPendingMessage = {
+    /**
+     * The message's id once it arrives, when you know it (such as the id you send it with). Its
+     * copy is then found by it rather than by where it lands. Keep it the same while it waits.
+     */
+    id: string;
+    /** What the person wrote. */
+    text: string;
+    /** What they sent with it, such as the photos and files they picked. Its copy shows these too. */
+    attachments?: AIMessageAttachmentData[];
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/ai-components/conversation-state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/conversation-state/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,IAAI,EAAE,aAAa,CAAC;IACpB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACxC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,6FAA6F;IAC7F,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACzC,CAAC"}

package/lib/typescript/ai-components/generative-ui/AIUIAction.d.ts

@@ -0,0 +1,48 @@
+import type { AIUIFormat } from './AIUIDocument';
+/**
+ * What the person did in a reply's UI, such as tapping a place or submitting a form. It goes to
+ * the agent as their next message: `label` is its text and `aiUIActionJSON(action)` what it
+ * carries.
+ */
+export type AIUIAction = {
+    /** The format of the UI it came from. */
+    format: AIUIFormat;
+    /** What the person did, in their words, such as "Tell me more about St. Naum". */
+    label: string;
+    /** The reply whose UI it came from. */
+    messageId: string;
+    /**
+     * What happened, such as an event of an app's component (`ask_about`) or OpenUI's
+     * `continue_conversation`.
+     */
+    name: string;
+    /** The details in the format's own shape, such as what was chosen and a form's values. */
+    payload: Record<string, unknown>;
+};
+/** The action as the JSON object an agent's backend reads. */
+export type AIUIActionJSON = {
+    format: AIUIFormat;
+    message_id: string;
+    name: string;
+    payload: Record<string, unknown>;
+    v: 1;
+};
+/** The custom field of the person's message that holds the action. */
+export declare const AI_UI_ACTION_CUSTOM_DATA_KEY = "ai_ui_action";
+/**
+ * The most an action may take as JSON. The agents router refuses a larger one, and its
+ * refusal would lose the person's message with it.
+ */
+export declare const AI_UI_ACTION_MAX_BYTES: number;
+/**
+ * The action as the JSON object an agent's backend reads, such as the `uiAction` of
+ * `session.responses.create(action.label, { uiAction })`. The label is not in it: it is the
+ * text of the person's message.
+ */
+export declare const aiUIActionJSON: (action: AIUIAction) => AIUIActionJSON;
+/**
+ * Why the agent's backend would refuse the action, or `undefined` when it would take it: it
+ * names its reply, its format and what happened, in at most `AI_UI_ACTION_MAX_BYTES` of JSON.
+ */
+export declare const aiUIActionProblem: (action: AIUIAction) => string | undefined;
+//# sourceMappingURL=AIUIAction.d.ts.map

package/lib/typescript/ai-components/generative-ui/AIUIAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIUIAction.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/generative-ui/AIUIAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,yCAAyC;IACzC,MAAM,EAAE,UAAU,CAAC;IACnB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,CAAC;CACN,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAC3D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAW,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,UAAU,KAAG,cAMlD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,UAAU,KAAG,MAAM,GAAG,SAc/D,CAAC"}

package/lib/typescript/ai-components/generative-ui/AIUIArguments.d.ts

@@ -0,0 +1,15 @@
+import type { AIUIParameter } from './AIUIComponentDefinition';
+/**
+ * A date the agent wrote: an RFC 3339 moment, or a whole day as `yyyy-MM-dd` that the calendar
+ * has, which is that day's start where the person is. Anything else is not a date.
+ */
+export declare const aiUIDate: (text: string) => Date | undefined;
+/** `place_name` as `placeName`, the way the agent's snake_case reads in JavaScript. */
+export declare const aiUICamelCase: (key: string) => string;
+/**
+ * The arguments the agent wrote for a component, as its view reads them: keys in camelCase,
+ * dates as `Date`s. `undefined` while they do not fit its parameters, such as while they are
+ * still streaming in: a required one is missing, or one is of the wrong type.
+ */
+export declare const decodeAIUIArguments: <Arguments = Record<string, unknown>>(args: Record<string, unknown>, parameters: AIUIParameter[]) => Arguments | undefined;
+//# sourceMappingURL=AIUIArguments.d.ts.map

package/lib/typescript/ai-components/generative-ui/AIUIArguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIUIArguments.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/generative-ui/AIUIArguments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAU/E;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,IAAI,GAAG,SAa9C,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,WAUxC,CAAC;AA6DF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,aAAa,EAAE,KAC1B,SAAS,GAAG,SAOd,CAAC"}

package/lib/typescript/ai-components/generative-ui/AIUIComponent.d.ts

@@ -0,0 +1,51 @@
+import React, { type ComponentType } from 'react';
+import type { AIUIComponentDefinition } from './AIUIComponentDefinition';
+import type { AIUIHost } from './AIUIHost';
+/** Where an app's component is shown, and how it tells the agent what the person did. */
+export type AIUIComponentContext = {
+    /**
+     * Tells the agent about one of the component's events, as the person's next message.
+     * `label` is what the person did, in their words, such as "Tell me more about St. Naum".
+     */
+    emit: (event: string, label: string, payload?: Record<string, unknown>) => void;
+    /** The conversation's host, for running the app's tools and opening links. */
+    host: AIUIHost;
+    /** Whether the agent is still writing the reply's UI, so the arguments may still change. */
+    isStreaming: boolean;
+    /** The reply the component is in. */
+    messageId: string;
+};
+export type AIUIComponentProps<Arguments> = {
+    /** What the agent filled in: keys in camelCase, dates as `Date`s. */
+    args: Arguments;
+    context: AIUIComponentContext;
+};
+/**
+ * One of the app's views that the agent can place in a reply's UI, in whichever format it
+ * writes, such as a map or a card over the app's own data.
+ */
+export type AIUIComponent = {
+    Component: ComponentType<AIUIComponentProps<never>>;
+    /** Its description, the same on every platform and for the agent. */
+    definition: AIUIComponentDefinition;
+};
+/**
+ * One of the app's components, with what its view reads from the agent's arguments. The view
+ * gets them only once they fit the definition's parameters, so it can rely on their types.
+ *
+ * A conversation reuses its views: one scrolled out of sight shows another reply's UI next, so
+ * state the view keeps of its own has to start afresh for a new `context.messageId`.
+ */
+export declare const defineAIUIComponent: <Arguments>(definition: AIUIComponentDefinition, Component: ComponentType<AIUIComponentProps<Arguments>>) => AIUIComponent;
+/**
+ * An app's component for the arguments the agent wrote, coming in as it shows, or nothing
+ * while they don't fit its parameters, such as while they are still streaming in. Renderers
+ * place the app's components with it. One that throws leaves only itself out of the reply's
+ * UI, is tried again when its arguments change, and is reported once the reply is written.
+ */
+export declare const AIUIComponentView: ({ args, component, context, }: {
+    args: Record<string, unknown>;
+    component: AIUIComponent;
+    context: AIUIComponentContext;
+}) => React.JSX.Element | null;
+//# sourceMappingURL=AIUIComponent.d.ts.map

package/lib/typescript/ai-components/generative-ui/AIUIComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIUIComponent.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/generative-ui/AIUIComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,aAAa,EAAW,MAAM,OAAO,CAAC;AAG3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,yFAAyF;AACzF,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChF,8EAA8E;IAC9E,IAAI,EAAE,QAAQ,CAAC;IACf,4FAA4F;IAC5F,WAAW,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,SAAS,IAAI;IAC1C,qEAAqE;IACrE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,oBAAoB,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,aAAa,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,qEAAqE;IACrE,UAAU,EAAE,uBAAuB,CAAC;CACrC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,EAC3C,YAAY,uBAAuB,EACnC,WAAW,aAAa,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,KACtD,aAID,CAAC;AAWH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,+BAI/B;IACD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,oBAAoB,CAAC;CAC/B,6BA2BA,CAAC"}

package/lib/typescript/ai-components/generative-ui/AIUIComponentDefinition.d.ts

@@ -0,0 +1,84 @@
+/** A JSON Schema, as a component's parameters are described to the agent. */
+export type AIUIJSONSchema = Record<string, unknown>;
+/** Something the agent fills in for a component. */
+export type AIUIParameter = {
+    /** Whether the agent must fill it in. */
+    isRequired: boolean;
+    /** The name the agent fills it in by, such as `title`. */
+    name: string;
+    /** What it holds, as a JSON Schema, such as `AIUIParameterType.string`. */
+    type: AIUIJSONSchema;
+    /** What it is, for the agent. */
+    description?: string;
+};
+/** Something a component reports when the person uses it, such as tapping a place. */
+export type AIUIComponentEvent = {
+    /** When it happens, for the agent. */
+    description: string;
+    /** The name it is reported by, such as `ask_about`. */
+    name: string;
+    /** What it carries, in order. */
+    parameters: AIUIParameter[];
+};
+/**
+ * An app's component as the agent knows it: its name, what it shows, what the agent fills in
+ * and what it reports. It is portable JSON, the same on every platform, so one description
+ * (such as a `UIComponents.json` shared with the iOS and Android apps) serves them all.
+ */
+export type AIUIComponentDefinition = {
+    /** What it shows and when to use it, for the agent. */
+    description: string;
+    /** What it reports when the person uses it. */
+    events: AIUIComponentEvent[];
+    /** The name the agent places it by, such as `place_card`. */
+    name: string;
+    /**
+     * What the agent fills in, in order: a format such as OpenUI Lang passes arguments by
+     * position.
+     */
+    parameters: AIUIParameter[];
+};
+/** The types a parameter commonly has, as JSON Schemas. */
+export declare const AIUIParameterType: {
+    /** A list of values of one type. */
+    array: (items: AIUIJSONSchema) => AIUIJSONSchema;
+    boolean: AIUIJSONSchema;
+    /** A day, such as `2026-11-14`. */
+    date: AIUIJSONSchema;
+    /** A moment, such as `2026-11-14T09:30:00Z`. */
+    dateTime: AIUIJSONSchema;
+    /** One of a fixed set of strings. */
+    enumeration: (values: string[]) => AIUIJSONSchema;
+    integer: AIUIJSONSchema;
+    number: AIUIJSONSchema;
+    /** An object with named fields, in order. */
+    object: (fields: AIUIParameter[]) => AIUIJSONSchema;
+    string: AIUIJSONSchema;
+    /** A link, such as an image's. */
+    url: AIUIJSONSchema;
+};
+/** A parameter the agent must fill in. */
+export declare const requiredAIUIParameter: (name: string, type: AIUIJSONSchema, description?: string) => AIUIParameter;
+/** A parameter the agent may leave out. */
+export declare const optionalAIUIParameter: (name: string, type: AIUIJSONSchema, description?: string) => AIUIParameter;
+/** Parameters as a JSON Schema object, the way a tool's are described, keeping their order. */
+export declare const aiUIObjectSchema: (parameters: AIUIParameter[]) => AIUIJSONSchema;
+/** The fields of a JSON Schema object, in the order it keeps, then by name. */
+export declare const aiUIParametersOf: (schema: unknown) => AIUIParameter[];
+/**
+ * Reads a component's portable JSON, such as one entry of a `UIComponents.json`, or returns
+ * `undefined` for one without a name.
+ */
+export declare const parseAIUIComponentDefinition: (json: unknown) => AIUIComponentDefinition | undefined;
+/** A component's portable JSON, as `parseAIUIComponentDefinition` reads it back. */
+export declare const aiUIComponentDefinitionJSON: (definition: AIUIComponentDefinition) => {
+    description: string;
+    events: {
+        parameters?: AIUIJSONSchema | undefined;
+        description: string;
+        name: string;
+    }[];
+    name: string;
+    parameters: AIUIJSONSchema;
+};
+//# sourceMappingURL=AIUIComponentDefinition.d.ts.map

package/lib/typescript/ai-components/generative-ui/AIUIComponentDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIUIComponentDefinition.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/generative-ui/AIUIComponentDefinition.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG;IAC1B,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,IAAI,EAAE,cAAc,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB;IAC5B,oCAAoC;mBACrB,cAAc,KAAG,cAAc;aACd,cAAc;IAC9C,mCAAmC;UACS,cAAc;IAC1D,gDAAgD;cACK,cAAc;IACnE,qCAAqC;0BACf,MAAM,EAAE,KAAG,cAAc;aACf,cAAc;YAChB,cAAc;IAC5C,6CAA6C;qBAC5B,aAAa,EAAE,KAAG,cAAc;YACnB,cAAc;IAC5C,kCAAkC;SACQ,cAAc;CACzD,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,MAAM,cAAc,EACpB,cAAc,MAAM,KACnB,aAAgE,CAAC;AAEpE,2CAA2C;AAC3C,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,MAAM,cAAc,EACpB,cAAc,MAAM,KACnB,aAAiE,CAAC;AAQrE,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,GAAI,YAAY,aAAa,EAAE,KAAG,cAU7D,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,QAAQ,OAAO,KAAG,aAAa,EAqB/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,OAAO,KACZ,uBAAuB,GAAG,SAqB5B,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,GAAI,YAAY,uBAAuB;;;;;;;;;CAS7E,CAAC"}

package/lib/typescript/ai-components/generative-ui/AIUIDocument.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The format a reply's UI is written in, such as `a2ui` or `openui`. Formats are an open set:
+ * a renderer says which one it reads.
+ */
+export type AIUIFormat = 'a2ui' | 'openui' | (string & {});
+/**
+ * The UI an agent wrote for a reply, which shows in place of the reply's text.
+ */
+export type AIUIDocument = {
+    /** The document in its format's own shape: a program's text, or JSON. */
+    content: unknown;
+    /** The format it is written in. */
+    format: AIUIFormat;
+    /** Whether the agent is still writing it. */
+    isStreaming: boolean;
+    /** The format's version, when the agent names one. */
+    version?: string;
+};
+/**
+ * A reply's `ai_ui` field as the agents router writes it. An app that reads it from its Stream
+ * messages types it there with `ai_ui?: AIUIDocumentJSON` in its `CustomMessageData`.
+ */
+export type AIUIDocumentJSON = {
+    /** The document in its format's own shape: usually text, such as A2UI's JSON lines. */
+    content: unknown;
+    format: AIUIFormat;
+    /** `streaming` while the agent writes it, then `complete`. */
+    status?: 'streaming' | 'complete' | (string & {});
+    /** The version of the field's own layout; a newer one than this SDK reads shows the text. */
+    v?: number;
+    version?: string;
+};
+/** The custom field of a message that holds its document. */
+export declare const AI_UI_CUSTOM_DATA_KEY = "ai_ui";
+/** The newest version of the `ai_ui` field this SDK reads. */
+export declare const AI_UI_SUPPORTED_VERSION = 1;
+/**
+ * Reads the document of a message's `ai_ui` field, or returns `undefined` when it carries none
+ * this SDK can read: no format, no content, or a field newer than this SDK, which can lay its
+ * documents out differently. The reply then shows its text.
+ */
+export declare const parseAIUIDocument: (field: unknown) => AIUIDocument | undefined;
+/** The content of a document when it is text, such as an OpenUI program or A2UI's JSON lines. */
+export declare const aiUIDocumentText: (document: AIUIDocument) => string | undefined;
+/**
+ * Whether two documents are the same, content included. A message is a new object on every
+ * update while a reply streams, so a document is compared by what it holds.
+ */
+export declare const isSameAIUIDocument: (a: AIUIDocument | undefined, b: AIUIDocument | undefined) => boolean;
+//# sourceMappingURL=AIUIDocument.d.ts.map

package/lib/typescript/ai-components/generative-ui/AIUIDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIUIDocument.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/generative-ui/AIUIDocument.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,6CAA6C;IAC7C,WAAW,EAAE,OAAO,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClD,6FAA6F;IAC7F,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,YAAY,GAAG,SAYjE,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,gBAAgB,GAAI,UAAU,YAAY,uBACc,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,YAAY,GAAG,SAAS,EAAE,GAAG,YAAY,GAAG,SAAS,YAOtD,CAAC"}

package/lib/typescript/ai-components/generative-ui/AIUIEntrance.d.ts

@@ -0,0 +1,76 @@
+import React, { type ReactNode } from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+/**
+ * Spaces out the parts of a reply's UI that come in together, so they come in one after another
+ * rather than at once.
+ */
+export declare class AIUICascade {
+    /** How long after the part before it a part comes in, in seconds. */
+    static readonly step = 0.1;
+    /** The longest a part waits for the parts before it, in seconds. */
+    static readonly longestWait = 0.4;
+    private next;
+    /** How long a part that comes in at `now`, in seconds, waits for the parts before it. */
+    delay(now?: number): number;
+}
+/**
+ * A reply's generated UI as a whole: it comes in when it first shows while the agent writes it,
+ * and shows at once when it was written before, such as a reply from history.
+ */
+export declare const AIUIEntranceStage: ({ children, isStreaming, resetKey, style, }: {
+    children: ReactNode;
+    /** Whether the agent is writing the UI as it first shows. */
+    isStreaming: boolean;
+    /**
+     * Which reply's UI it shows: when it changes, it shows the UI as one mounted for it would, as
+     * when a list reuses it for another reply.
+     */
+    resetKey?: unknown;
+    style?: StyleProp<ViewStyle>;
+}) => React.JSX.Element;
+/**
+ * Whether a part of a reply's generated UI comes in, as it was when the part first showed: a
+ * part that shows at once, such as one of a reply from history, can show in a plain view. A part
+ * mounted before it has anything to show passes `shows` as false until it does.
+ */
+export declare const useAIUIComesIn: (shows?: boolean) => boolean;
+/**
+ * What a part of a reply's generated UI needs to come in when it shows, for a renderer that
+ * animates a view of its own rather than wrap the part in `AIUIEntrance`: the animated `style`
+ * for that view, and `scope`, to wrap what the part shows in, so what shows with it comes in
+ * with it. The same entrance as `AIUIEntrance`'s.
+ */
+export declare const useAIUIEntrance: () => {
+    scope: (children: ReactNode) => React.JSX.Element;
+    style: ({
+        transformOrigin: string;
+    } | import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
+        opacity: number;
+    } | {
+        filter?: {
+            blur: number;
+        }[] | undefined;
+        opacity: number;
+        transform: ({
+            translateY: number;
+            scale?: undefined;
+        } | {
+            scale: number;
+            translateY?: undefined;
+        })[];
+    }>)[];
+};
+/**
+ * Brings a part of a reply's generated UI in when it shows, such as when the agent writes it:
+ * the part fades in, rising into place and, on Android 12 and later, coming into focus, after the
+ * parts that came in just before it. What shows together with the reply's UI, or with a part
+ * around it, comes in with that, so a reply written before it showed shows at once. With reduced
+ * motion it only fades.
+ *
+ * Renderers give it to each part they place. Every app component has it.
+ */
+export declare const AIUIEntrance: ({ children, style, }: {
+    children: ReactNode;
+    style?: StyleProp<ViewStyle>;
+}) => React.JSX.Element;
+//# sourceMappingURL=AIUIEntrance.d.ts.map

package/lib/typescript/ai-components/generative-ui/AIUIEntrance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIUIEntrance.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/generative-ui/AIUIEntrance.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAEZ,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AACf,OAAO,EAAY,KAAK,SAAS,EAAoB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAa1F;;;GAGG;AACH,qBAAa,WAAW;IACtB,qEAAqE;IACrE,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO;IAC3B,oEAAoE;IACpE,MAAM,CAAC,QAAQ,CAAC,WAAW,OAAO;IAElC,OAAO,CAAC,IAAI,CAAK;IAEjB,yFAAyF;IACzF,KAAK,CAAC,GAAG,SAA+E;CAKzF;AAqED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,6CAK/B;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,sBAsBA,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,eAAY,YAS1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe;sBAQP,SAAS;;;;;;;;;;;;;;;;;;CAM7B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,sBAG1B;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,sBAOA,CAAC"}