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

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

@@ -0,0 +1 @@
+{"version":3,"file":"AIConversation.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/conversation/AIConversation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EACZ,KAAK,aAAa,EAGlB,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAMf,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,8BAA8B,CAAC;AAE3F,MAAM,MAAM,8BAA8B,GAAG;IAC3C,8DAA8D;IAC9D,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,wFAAwF;IACxF,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,aAAa,CAAC,mCAAmC,CAAC,CAAC;IACtE;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,iHAAiH;IACjH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C;;;OAGG;IACH,cAAc,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,8FAA8F;IAC9F,YAAY,CAAC,EAAE,aAAa,CAAC,+BAA+B,CAAC,GAAG,IAAI,CAAC;IACrE;;;;OAIG;IACH,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,KAChC,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACnD;;;;;;;OAOG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,sEAAsE;IACtE,WAAW,CAAC,EAAE,aAAa,CAAC,8BAA8B,CAAC,CAAC;CAC7D,CAAC;AAyQF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,mBAAmB,sBAKtD,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * The agent couldn't answer: it said so, with what it said as `agentMessage`, or it didn't start
+ * its reply in time.
+ */
+export declare class AIAgentError extends Error {
+    /** What the agent said about it, if anything. */
+    readonly agentMessage?: string;
+    constructor(agentMessage?: string);
+}
+//# sourceMappingURL=AIAgentError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AIAgentError.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation/controller/AIAgentError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,iDAAiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,YAAY,CAAC,EAAE,MAAM;CAKlC"}

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

@@ -0,0 +1,173 @@
+import { StateStore } from '@stream-io/state-store';
+import { type AIAgentActivity, type AIConversationActions, type AIConversationStatus, type AIConversationTransport } from './types';
+import type { AIMessageRating, AIReplyActionsProps } from '../../message/AIReplyActions';
+import type { AIChatOption } from '../../message-composer/ChatOptions';
+import type { MediaAsset } from '../../services/media-picker-service/AbstractMediaPickerService';
+import { type ComposerState } from '../../store/composer/store';
+import type { AIToolApprover } from '../../tool-calls/AIToolApprover';
+import type { AIMessage, AIPendingMessage } from '../types';
+export type AIConversationControllerState<Message extends AIMessage = AIMessage> = {
+    /** The conversation as it shows, oldest message first. */
+    messages: readonly Message[];
+    /**
+     * The message the person sent last that is not in the conversation yet. It stays until its
+     * reply starts, and after it was stopped or failed, while `retry()` can send it again.
+     */
+    pendingMessage: AIPendingMessage | undefined;
+    /** Where the latest exchange with the agent is. */
+    status: AIConversationStatus;
+    /**
+     * Why the latest request failed, or, as an `AIAgentError`, what the agent said when it couldn't
+     * answer or that it didn't answer in time. It stays until the next request, or until a reply
+     * starts after all.
+     */
+    error: Error | undefined;
+    /** What the agent says it is doing besides what its reply shows, such as checking sources. */
+    activity: AIAgentActivity | undefined;
+    /** Whether the conversation has messages before the first one, which `loadOlderMessages` loads. */
+    hasOlderMessages: boolean;
+    /**
+     * How the person rated replies, by the reply's id: the rating they gave on this device, or else
+     * the reply's own `rating`.
+     */
+    ratings: Readonly<Record<string, AIMessageRating>>;
+};
+export type AIConversationControllerOptions<Message extends AIMessage = AIMessage> = {
+    /** How the conversation reaches the agent and learns what it holds. Connected straight away. */
+    transport: AIConversationTransport<Message>;
+    /** What the conversation's views offer. All of them by default. */
+    actions?: AIConversationActions;
+    /** Who answers tool calls' questions and sign-ins on this device, which the conversation asks them. */
+    approver?: AIToolApprover;
+    /** What the person writes, such as a store the app fills itself. A new one by default. */
+    composer?: StateStore<ComposerState>;
+    /**
+     * How many milliseconds the controller waits, once the agent has the request, for the agent to
+     * start its reply or say what it is doing, before it shows an `AIAgentError`. While the agent
+     * says it is working, such as thinking, it waits as long as that takes. Five minutes by default;
+     * `null` or `Infinity` waits as long as it takes.
+     */
+    replyTimeout?: number | null;
+};
+/** What the person sends: what `ComposerView` hands on. */
+export type AIConversationSendData = {
+    text: string;
+    /** The files the person picked, on this device. */
+    attachments?: MediaAsset[];
+    /** The option the person picked in the composer. */
+    chatOption?: AIChatOption;
+    custom?: Record<string, unknown>;
+};
+/**
+ * The state behind an AI conversation, and what the person does in it.
+ *
+ * It holds the conversation's messages, where the latest exchange with the agent is and why it
+ * failed, and it sends what the person asks through its `AIConversationTransport`. Give it to
+ * `AIConversation` and `ComposerView` as `conversation`, which show it and act on it: sending,
+ * stopping, regenerating and rating replies, and editing the person's latest message.
+ *
+ * ```tsx
+ * const [conversation] = useState(() => new AIConversationController({ transport }));
+ * useEffect(() => () => conversation.dispose(), [conversation]);
+ *
+ * <AIConversation conversation={conversation} />
+ * <ComposerView conversation={conversation} />
+ * ```
+ *
+ * What the person sends shows straight away, and the agent thinks until its reply starts. While
+ * a reply is written again, or a message the person edited is answered again, the messages it
+ * replaces are left out of `messages` until the new reply starts.
+ */
+export declare class AIConversationController<Message extends AIMessage = AIMessage> {
+    /** The conversation's state, to follow with `useStateStore`. */
+    readonly state: StateStore<AIConversationControllerState<Message>>;
+    /** What the person is writing: `ComposerView` shows it, and editing a message fills it. */
+    readonly composer: StateStore<ComposerState>;
+    /** Who answers tool calls' questions and sign-ins on this device. */
+    readonly approver: AIToolApprover | undefined;
+    /** What the conversation's views offer the person to do with its messages. */
+    readonly actions: Required<AIConversationActions>;
+    private readonly transport;
+    private readonly replyTimeout;
+    private readonly disconnect;
+    private disposed;
+    private received;
+    private exchange;
+    private generation;
+    private stopped;
+    private activity;
+    private ignoresActivity;
+    private error;
+    private hasOlderMessages;
+    private stopping;
+    private replyTimer;
+    private edited;
+    private ratingChanges;
+    private ratingAttempts;
+    private isLoadingOlderMessages;
+    constructor({ actions, approver, composer, replyTimeout, transport, }: AIConversationControllerOptions<Message>);
+    /**
+     * The person's message they are editing in the composer, which the next message they send
+     * replaces. The composer shows that they are editing it, with a button that cancels it.
+     */
+    get editingMessage(): Message | undefined;
+    /** Stops following the transport and lets go of what is on its way. */
+    dispose(): void;
+    /** Sends a message, or the person's edit of the message they are editing. */
+    send({ attachments, chatOption, custom, text }: AIConversationSendData): void;
+    /**
+     * Stops the reply the agent is writing. What it wrote so far stays. When the reply hasn't
+     * started yet, the person's message stays, and a reply that still arrives is finished whatever
+     * it says.
+     */
+    stop(): void;
+    /** Asks the agent for a new reply in place of `reply`, and of those after it. */
+    regenerate(reply: Message): void;
+    /** Puts a message of the person's in the composer to edit. The next message they send replaces it. */
+    edit(message: Message): void;
+    /** Stops editing a message, and empties the composer. */
+    cancelEditing(): void;
+    /**
+     * Tries again after `error`: sends the request that failed again, with the same message id, or
+     * asks the agent again for the reply it couldn't write.
+     */
+    retry(): void;
+    /** Forgets `error`, and the request that failed. */
+    clearError(): void;
+    /**
+     * Rates a reply, or takes the rating back with `null`. Ratings reach the transport in the order
+     * the person gives them, and the reply's rating goes back to the one the transport has if it
+     * can't take the new one.
+     */
+    rate(reply: Message, rating: AIMessageRating | null): void;
+    /** Loads the messages before the first one, while there are any. */
+    loadOlderMessages: () => Promise<void>;
+    /**
+     * What the person can do with a finished reply: rate it, and write it again while it is the
+     * latest and the agent isn't answering.
+     */
+    replyActions(reply: Message, isLatestReply: boolean): Omit<AIReplyActionsProps, 'text'>;
+    /** Edits a message of the person's, when it is their latest and the agent isn't answering. */
+    editAction(message: Message): (() => void) | undefined;
+    private makeFeed;
+    private receiveMessages;
+    private receiveActivity;
+    private start;
+    private receiveReply;
+    private requestSent;
+    private requestFailed;
+    private stopFailed;
+    private agentCouldNotAnswer;
+    private waitForReply;
+    private clearReplyTimer;
+    private replyTimedOut;
+    private sendRating;
+    private regenerateRequest;
+    private get answerAgainRequest();
+    private get writingReply();
+    private indexOf;
+    private refresh;
+    private currentRatings;
+    private currentStatus;
+}
+//# sourceMappingURL=AIConversationController.d.ts.map

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

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

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

@@ -0,0 +1,23 @@
+import type { AIConversationRequest } from './types';
+import type { AIMessageAttachmentData } from '../../message/AIMessageAttachment';
+import type { MediaAsset } from '../../services/media-picker-service/AbstractMediaPickerService';
+import type { AIMessage, AIPendingMessage } from '../types';
+export type AIConversationExchangeState = 'waiting' | 'stopped' | 'failed' | 'unanswered';
+export declare const hasEmptyContent: (message: AIMessage) => boolean;
+export declare const attachmentOfAsset: (asset: MediaAsset) => AIMessageAttachmentData;
+export declare class AIConversationExchange<Message extends AIMessage> {
+    readonly id: number;
+    readonly request: AIConversationRequest<Message>;
+    state: AIConversationExchangeState;
+    readonly known: Set<string>;
+    readonly replaced: Map<string, Message>;
+    readonly pending: AIPendingMessage | undefined;
+    constructor(id: number, request: AIConversationRequest<Message>, conversation: readonly Message[]);
+    get hasFailed(): boolean;
+    get shownPending(): AIPendingMessage | undefined;
+    reply(conversation: readonly Message[]): Message | undefined;
+    hasReplyStarted(conversation: readonly Message[]): boolean;
+    hasMessageArrived(conversation: readonly Message[]): boolean;
+    retryRequest(conversation: readonly Message[]): AIConversationRequest<Message>;
+}
+//# sourceMappingURL=AIConversationExchange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AIConversationExchange.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation/controller/AIConversationExchange.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gEAAgE,CAAC;AACjG,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAI5D,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAI1F,eAAO,MAAM,eAAe,GAAI,SAAS,SAAS,YAIpB,CAAC;AAW/B,eAAO,MAAM,iBAAiB,GAAI,OAAO,UAAU,KAAG,uBAMpD,CAAC;AAGH,qBAAa,sBAAsB,CAAC,OAAO,SAAS,SAAS;IAYzD,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC;IAZlD,KAAK,EAAE,2BAA2B,CAAa;IAE/C,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAG5B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAExC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAAC;gBAIpC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAChD,YAAY,EAAE,SAAS,OAAO,EAAE;IAuBlC,IAAI,SAAS,YAEZ;IAKD,IAAI,YAAY,iCAEf;IAID,KAAK,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE;IAStC,eAAe,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE;IAOhD,iBAAiB,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE;IAWlD,YAAY,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE,GAAG,qBAAqB,CAAC,OAAO,CAAC;CAe/E"}

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

@@ -0,0 +1,5 @@
+export * from './AIAgentError';
+export * from './AIConversationController';
+export * from './types';
+export * from './useAIConversationState';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation/controller/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,0BAA0B,CAAC"}

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

@@ -0,0 +1,23 @@
+import { type AIConversationStatus } from './types';
+import type { AIMessageRating, AIReplyActionsProps } from '../../message/AIReplyActions';
+import type { AIMessage } from '../types';
+type Offerer<Message extends AIMessage> = {
+    actions: {
+        edit: boolean;
+        rate: boolean;
+        regenerate: boolean;
+    };
+    edit: (message: Message) => void;
+    rate: (reply: Message, rating: AIMessageRating | null) => void;
+    regenerate: (reply: Message) => void;
+};
+export declare const replyActionsOf: <Message extends AIMessage>(offerer: Offerer<Message>, { ratings, status, }: {
+    ratings: Readonly<Record<string, AIMessageRating>>;
+    status: AIConversationStatus;
+}, reply: Message, isLatestReply: boolean) => Omit<AIReplyActionsProps, "text">;
+export declare const editActionOf: <Message extends AIMessage>(offerer: Offerer<Message>, { messages, status }: {
+    messages: readonly Message[];
+    status: AIConversationStatus;
+}, message: Message) => (() => void) | undefined;
+export {};
+//# sourceMappingURL=offers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"offers.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation/controller/offers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAA6B,MAAM,SAAS,CAAC;AAE/E,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,KAAK,OAAO,CAAC,OAAO,SAAS,SAAS,IAAI;IACxC,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/D,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/D,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC,CAAC;AAIF,eAAO,MAAM,cAAc,GAAI,OAAO,SAAS,SAAS,EACtD,SAAS,OAAO,CAAC,OAAO,CAAC,EACzB,sBAGG;IAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,EACvF,OAAO,OAAO,EACd,eAAe,OAAO,KACrB,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAOjC,CAAC;AAGH,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,SAAS,EACpD,SAAS,OAAO,CAAC,OAAO,CAAC,EACzB,sBAAsB;IAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,EACpF,SAAS,OAAO,KACf,CAAC,MAAM,IAAI,CAAC,GAAG,SAMjB,CAAC"}

package/lib/typescript/ai-components/conversation/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/controller/types.d.ts.map

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

package/lib/typescript/ai-components/conversation/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/controller/useAIConversationState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAIConversationState.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation/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/entries.d.ts

@@ -0,0 +1,47 @@
+import type { AIMessage, AIPendingMessage } from './types';
+import type { AIUIDocument } from '../generative-ui/AIUIDocument';
+import type { AIMessageAttachmentData } from '../message/AIMessageAttachment';
+/** A row of the conversation: a message, or a message the person sent that is on its way. */
+export type AIConversationEntry = {
+    /** The message's id, or, for the copy of a message that was on its way, that message's. */
+    id: string;
+    isFromUser: boolean;
+    /** Whether it is a reply that ends the conversation. */
+    isLatestReply: boolean;
+    /** The message, or `undefined` for one on its way. */
+    message?: AIMessage;
+    /** The message on its way, until its copy arrives. */
+    pending?: AIPendingMessage;
+    /** What the person sent with a message on its way, which its copy shows rather than load it again. */
+    sentAttachments: AIMessageAttachmentData[];
+};
+/** The person's message and the replies to it. */
+export type AIConversationTurn = {
+    entries: AIConversationEntry[];
+    id: string;
+};
+/** Whether a reply's generated UI shows, such as `AIUIHost.canShow`. */
+export type AIConversationCanShowUI = (document: AIUIDocument) => boolean;
+/**
+ * Whether the reply is being written, took steps that are all over, and shows no UI: once its
+ * answer stops growing, the agent is thinking again, between its steps. An agent's backend can
+ * write a round of reasoning as a step only once it is done, so nothing would show meanwhile. A
+ * step still going, such as a call waiting for the person, shows itself instead.
+ */
+export declare const hasFinishedSteps: (message: AIMessage | undefined, canShowUI?: AIConversationCanShowUI) => message is AIMessage;
+/** Groups the rows into turns, each starting with one of the person's messages. */
+export declare const turnsOf: (entries: AIConversationEntry[]) => AIConversationTurn[];
+/**
+ * Follows a message the person sent until its copy arrives in the messages, so the copy takes
+ * over its row (and its key) without a flicker, and tells whether the agent is surely about to
+ * answer.
+ */
+export declare class AIPendingMessageTracker {
+    private seen;
+    private copies;
+    private lastPending?;
+    entries(messages: AIMessage[], pending?: AIPendingMessage | null, canShowUI?: AIConversationCanShowUI): AIConversationEntry[];
+    private copyOf;
+    isAwaitingReply(messages: AIMessage[], pending?: AIPendingMessage | null, canShowUI?: AIConversationCanShowUI): boolean;
+}
+//# sourceMappingURL=entries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/conversation/entries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAG9E,6FAA6F;AAC7F,MAAM,MAAM,mBAAmB,GAAG;IAChC,2FAA2F;IAC3F,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,aAAa,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,sDAAsD;IACtD,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,sGAAsG;IACtG,eAAe,EAAE,uBAAuB,EAAE,CAAC;CAC5C,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAAG;IAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,wEAAwE;AACxE,MAAM,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,OAAO,CAAC;AAsB1E;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,SAAS,GAAG,SAAS,EAC9B,YAAW,uBAAmC,KAC7C,OAAO,IAAI,SAM0C,CAAC;AAEzD,mFAAmF;AACnF,eAAO,MAAM,OAAO,GAAI,SAAS,mBAAmB,EAAE,yBAM9C,CAAC;AAET;;;;GAIG;AACH,qBAAa,uBAAuB;IAGlC,OAAO,CAAC,IAAI,CAAkC;IAE9C,OAAO,CAAC,MAAM,CAAuC;IAGrD,OAAO,CAAC,WAAW,CAAC,CAAmB;IAIvC,OAAO,CACL,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,EACjC,SAAS,GAAE,uBAAmC,GAC7C,mBAAmB,EAAE;IAoDxB,OAAO,CAAC,MAAM;IAiBd,eAAe,CACb,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,EACjC,SAAS,GAAE,uBAAmC;CAUjD"}

package/lib/typescript/ai-components/conversation/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/fromStreamMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromStreamMessage.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/conversation/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;AAwBF;;;;;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/index.d.ts

@@ -0,0 +1,6 @@
+export * from './AIConversation';
+export * from './controller';
+export * from './fromStreamMessage';
+export * from './types';
+export type { AIConversationCanShowUI, AIConversationEntry, AIConversationTurn } from './entries';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-components/conversation/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

package/lib/typescript/ai-components/conversation/list/AIChatList.d.ts

@@ -0,0 +1,30 @@
+import React, { type ReactNode } from 'react';
+import type { LegendListRenderItemProps } from '@legendapp/list/react-native';
+export type AIChatListProps<T> = {
+    /** The key of the row to pin to the top of what is visible, such as the latest question's. */
+    anchorKey: string | undefined;
+    data: T[];
+    getItemType: (item: T) => string;
+    keyExtractor: (item: T) => string;
+    renderItem: (props: LegendListRenderItemProps<T>) => ReactNode;
+    /** The room for a composer floating over the bottom of the list. */
+    bottomInset?: number;
+    /** What shows while there are no rows, centered. */
+    emptyContent?: ReactNode;
+    /**
+     * How far above the bottom of the screen the composer sits, such as above a tab bar: the
+     * keyboard covers the list only as far as it rises past that. Defaults to the bottom safe area.
+     */
+    keyboardOffset?: number;
+    /** Loads the rows before the first one. `undefined` once there are none left. */
+    loadOlderMessages?: () => Promise<void> | void;
+    testID?: string;
+};
+/**
+ * The list of a chat with an agent: virtualised on Reanimated LegendList, reusing the views of
+ * rows scrolled out of sight. It pins `anchorKey`'s row to the top of what is visible, opens at the
+ * end, loads older rows as the person scrolls to the start, and offers a button back to the latest
+ * row when the end is out of view. What the rows are is the caller's.
+ */
+export declare const AIChatList: <T>({ anchorKey, bottomInset, data, emptyContent, getItemType, keyboardOffset: keyboardOffsetProp, keyExtractor, loadOlderMessages, renderItem, testID, }: AIChatListProps<T>) => React.JSX.Element;
+//# sourceMappingURL=AIChatList.d.ts.map

package/lib/typescript/ai-components/conversation/list/AIChatList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIChatList.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation/list/AIChatList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAmB,MAAM,OAAO,CAAC;AAK/D,OAAO,KAAK,EAAiB,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAU7F,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,8FAA8F;IAC9F,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,UAAU,EAAE,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IAC/D,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA6DF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAG,uJAW5B,eAAe,CAAC,CAAC,CAAC,sBAsFpB,CAAC"}

package/lib/typescript/ai-components/conversation/list/useChatListController.d.ts

@@ -0,0 +1,45 @@
+import { type RefObject } from 'react';
+import type { LegendListRef } from '@legendapp/list/react-native';
+export type ChatListControllerOptions<T> = {
+    /** The key of the row to pin to the top, such as the latest question's. */
+    anchorKey: string | undefined;
+    /** The room for a composer floating over the bottom of the list. */
+    bottomInset: number;
+    data: readonly T[];
+    keyExtractor: (item: T) => string;
+    listRef: RefObject<LegendListRef | null>;
+    /** Loads the rows before the first one. `undefined` once there are none left. */
+    loadOlderMessages?: () => Promise<void> | void;
+};
+/**
+ * How a chat list behaves, apart from how it looks: the row to pin, whether the end is in view,
+ * and loading older rows. Renders nothing: `listProps` go on a LegendList given `listRef`, and
+ * the rest is for the views around it. Any LegendList that keeps `anchoredEndSpace` works.
+ */
+export declare const useChatListController: <T>({ anchorKey, bottomInset, data, keyExtractor, listRef, loadOlderMessages, }: ChatListControllerOptions<T>) => {
+    isEndInView: boolean;
+    /** The keyboard, for views that ride it, such as the button back to the latest row. */
+    keyboard: import("react-native-reanimated").SharedValue<import("./useKeyboardOverlap").KeyboardFrame>;
+    /** How far above the bottom of the screen the list ends; the list's view sets it. */
+    keyboardOffset: RefObject<number>;
+    /** Whether older rows load as the list nears its start, so it shows that they are loading. */
+    loadsOlder: boolean;
+    listProps: {
+        onMomentumScrollBegin?: (() => void) | undefined;
+        onMomentumScrollEnd?: (() => void) | undefined;
+        onScrollBeginDrag?: (() => void) | undefined;
+        onScrollEndDrag?: (() => void) | undefined;
+        onStartReached?: (() => void) | undefined;
+        onStartReachedThreshold?: number | undefined;
+        anchoredEndSpace: import("@legendapp/list/react-native").AnchoredEndSpaceConfig | undefined;
+        freeze: import("react-native-reanimated").SharedValue<boolean>;
+        onLayout: () => void;
+        onItemSizeChanged: () => void;
+        onMetricsChange: ({ headerSize: size }: {
+            headerSize: number;
+        }) => void;
+        onScroll: () => void;
+    };
+    scrollToEnd: () => void;
+};
+//# sourceMappingURL=useChatListController.d.ts.map

package/lib/typescript/ai-components/conversation/list/useChatListController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatListController.d.ts","sourceRoot":"","sources":["../../../../../src/ai-components/conversation/list/useChatListController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAG5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AASlE,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IACzC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACzC,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,6EAOtC,yBAAyB,CAAC,CAAC,CAAC;;IAoC3B,uFAAuF;;IAEvF,qFAAqF;;IAErF,8FAA8F;;;;;;;;;;;;;;;;;;;CAcjG,CAAC"}