@vinaverse/react-native 0.1.0-alpha.6 → 0.1.0-alpha.7

package/README.md

@@ -53,7 +53,7 @@ const imagePolicy = { hosts: ['images.example.com'], aspectRatio: 1.6, Placehold
   <Tabs />
   <AgentLauncher subject={user?.id ?? null} mode={side} Mark={YourMark}
     route={currentTab} routes={['home', 'explore']} hidden={sheetOpen}  // never with the keyboard up
-    storage={preferences} onOpen={({ route, mode }) => openChat(route, mode)}
+    storage={preferences} onOpen={({ route, mode, entryPoint }) => openChat(route, mode, entryPoint)}
     style={{ position: 'absolute', right: 16, bottom: tabBarHeight + 16 }} />
 </AgentRuntimeProvider>
 
@@ -61,6 +61,7 @@ const imagePolicy = { hosts: ['images.example.com'], aspectRatio: 1.6, Placehold
 <AgentChat
   agentKey={{ subject: user?.id ?? null, mode: side, scope: businessId }}
   place={{ screen: 'professional', entity: { type: 'professional', id } }}
+  entryPoint={entryPoint}                   // 'launcher', 'ask', 'deep_link': session_opened says it
   askAbout={`Tell me about ${name}`}        // offered when the session was told another place
   starters={startersFor(screen)}            // when the session brings no welcome
   components={components}
@@ -73,23 +74,30 @@ const imagePolicy = { hosts: ['images.example.com'], aspectRatio: 1.6, Placehold
 />
 
 // On the app's own page about a professional
-<AskAboutRow title={`Ask ${agentName} about ${name}`} onPress={() => openChat('professional', side)} />
+<AskAboutRow title={`Ask ${agentName} about ${name}`} onPress={({ entryPoint }) => openChat('professional', side, entryPoint)} />
 ```
 
-- **Parts:** `AgentChat` draws the conversation, a conversation that ended (`components.Ended`, start over), the backend
-  out of reach (`components.Unreachable`, try again), no agent at all (`components.UnavailableScreen`, the whole
-  screen: off, or the session refused, with a person through `onContact`), and under the composer thumbs on the newest
-  whole reply and the privacy link (`components.Footer`, `null` to hide); each slot gets the kit's part as `Default`,
-  to wrap it. `opener` is a first question as a chip the person taps (a flow that asks for itself), until they say
-  anything; nothing is ever sent in their name. `AgentLauncher` is a round button with
+- **Parts:** `AgentChat` draws the conversation, a conversation that ended (`components.Ended`: `onStartNew`,
+  `reason`, `code`, `onContact`), the backend out of reach (`components.Unreachable`: `onRetry`, `reason`,
+  `onContact`), no agent at all (`components.UnavailableScreen`, the whole screen: off, or the session refused;
+  `reason`, `code`, `onRetry`, `onContact`), and under the composer thumbs on the newest whole reply seen live and the
+  privacy link (`components.Footer`, `null` to hide). Each slot replaces its screen entirely, layout and words, and gets
+  the kit's part as `Default` to wrap instead; to change only the words, pass `copy`. A person to contact
+  (`onContact`) reaches every full-screen slot. `opener` is a first question as a chip the person taps (a flow that asks for itself), until they say
+  anything; nothing is ever sent in their name. So a setup flow starts when the person taps it, never on its own:
+  starting it automatically would put words in their mouth, which the kit declines by design. `AgentLauncher` is a round button with
   a greeting bubble once per person and mode (`storage`: your preferences store; `greeting`: words or words by mode,
   read through `announce`; `storageKey` maps the record to one your app already keeps, so nobody is greeted twice),
   your `Mark` inside, floating where `placement` says (`edge`, `bottom` above your tab bar, `inset`; `style` after it),
   with `appearance` (a `ring`, the `shadow`, the bubble's `tail`), shown on your `routes` only, never with the keyboard
-  up (`hideWithKeyboard`), stepping aside when you say (`hidden`), and only when the status offers it; its button,
+  up (`hideWithKeyboard`; on iOS it goes as the keyboard starts to rise, on Android once it is up), stepping aside when you say (`hidden`), and only when the status offers it; its button,
   bubble and entrance are slots (`LauncherButton`, `LauncherGreeting`, `LauncherEntrance`: a short fade and scale,
-  none with reduced motion). `AskAboutRow` is "ask the agent about this" on
-  your own pages, shown when the agent is available, decided once per visit.
+  none with reduced motion). Its `onOpen` and the ask row's `onPress` give `entryPoint` (`launcher`, `ask`): pass it to
+  `AgentChat`'s `entryPoint` (or `deep_link`, or your own words) and `session_opened` says where the chat was opened
+  from. Every agent part asks the runtime to `sweep()` when the app comes back to the foreground. `AskAboutRow` is "ask the agent about this" on
+  your own pages, decided once as the page draws, from the status already read: it is never added under a drawn page
+  (an agent whose status arrives later shows from the next visit), and `appearance` gives it a tint (`background`) and the
+  `chevron` or none.
 - **Policies and adapters:** `imagePolicy` (photo hosts, frame, the stand-in for a missing photo) applies to every card
   and every fetch ahead; `announce` reads finished replies and the greeting your way; `onChip` hears a tapped chip.
   Card renderers get the card read once (`read`).

package/dist/ask.cjs

@@ -1,27 +1,31 @@
 'use strict';
 
-var chunk643GOUTG_cjs = require('./chunk-643GOUTG.cjs');
-var chunkOWUKWVEZ_cjs = require('./chunk-OWUKWVEZ.cjs');
+var chunkV6HHPE5K_cjs = require('./chunk-V6HHPE5K.cjs');
+var chunk6QYDPGRS_cjs = require('./chunk-6QYDPGRS.cjs');
 var agent = require('@vinaverse/react/agent');
 
 
 
 Object.defineProperty(exports, "AskAboutRow", {
   enumerable: true,
-  get: function () { return chunk643GOUTG_cjs.AskAboutRow; }
+  get: function () { return chunkV6HHPE5K_cjs.AskAboutRow; }
 });
 Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,
-  get: function () { return chunkOWUKWVEZ_cjs.ThemeProvider; }
+  get: function () { return chunk6QYDPGRS_cjs.ThemeProvider; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
-  get: function () { return chunkOWUKWVEZ_cjs.useTheme; }
+  get: function () { return chunk6QYDPGRS_cjs.useTheme; }
 });
 Object.defineProperty(exports, "AgentRuntimeProvider", {
   enumerable: true,
   get: function () { return agent.AgentRuntimeProvider; }
 });
+Object.defineProperty(exports, "forgetGreeting", {
+  enumerable: true,
+  get: function () { return agent.forgetGreeting; }
+});
 Object.defineProperty(exports, "greetedKey", {
   enumerable: true,
   get: function () { return agent.greetedKey; }

package/dist/ask.d.cts

@@ -1,20 +1,31 @@
-export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
 import { CopyOverrides } from '@vinaverse/react';
 import { ComponentType, ReactNode } from 'react';
 import { a as ThemeOverrides, C as ColorSchemeSetting } from './theme-BhiEGv64.cjs';
 export { T as Theme, b as ThemeProvider, u as useTheme } from './theme-BhiEGv64.cjs';
 import '@vinaverse/tokens';
 
+/** The row's look beyond the theme. */
+interface AskAboutRowAppearance {
+    /** A tint behind the row; default the theme's `surface`. */
+    readonly background?: string;
+    /** The chevron at the row's end. Default true. */
+    readonly chevron?: boolean;
+}
 interface AskAboutRowProps {
     /** "Ask Example Agent about Riley Sample". */
     readonly title: string;
     readonly body?: string;
-    readonly onPress: () => void;
+    /** The person asks: open the chat with `entryPoint` (`ask`), so the session says where it was opened from. */
+    readonly onPress: (from: {
+        readonly entryPoint: 'ask';
+    }) => void;
     /** The app's brand mark at the row's start; default the agent name's first letter. */
     readonly Mark?: ComponentType<{
         readonly size: number;
         readonly color: string;
     }>;
+    readonly appearance?: AskAboutRowAppearance;
     readonly locale?: string;
     readonly copy?: CopyOverrides;
     readonly theme?: ThemeOverrides;
@@ -22,4 +33,4 @@ interface AskAboutRowProps {
 }
 declare function AskAboutRow(props: AskAboutRowProps): ReactNode;
 
-export { AskAboutRow, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };
+export { AskAboutRow, type AskAboutRowAppearance, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };

package/dist/ask.d.ts

@@ -1,20 +1,31 @@
-export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
 import { CopyOverrides } from '@vinaverse/react';
 import { ComponentType, ReactNode } from 'react';
 import { a as ThemeOverrides, C as ColorSchemeSetting } from './theme-BhiEGv64.js';
 export { T as Theme, b as ThemeProvider, u as useTheme } from './theme-BhiEGv64.js';
 import '@vinaverse/tokens';
 
+/** The row's look beyond the theme. */
+interface AskAboutRowAppearance {
+    /** A tint behind the row; default the theme's `surface`. */
+    readonly background?: string;
+    /** The chevron at the row's end. Default true. */
+    readonly chevron?: boolean;
+}
 interface AskAboutRowProps {
     /** "Ask Example Agent about Riley Sample". */
     readonly title: string;
     readonly body?: string;
-    readonly onPress: () => void;
+    /** The person asks: open the chat with `entryPoint` (`ask`), so the session says where it was opened from. */
+    readonly onPress: (from: {
+        readonly entryPoint: 'ask';
+    }) => void;
     /** The app's brand mark at the row's start; default the agent name's first letter. */
     readonly Mark?: ComponentType<{
         readonly size: number;
         readonly color: string;
     }>;
+    readonly appearance?: AskAboutRowAppearance;
     readonly locale?: string;
     readonly copy?: CopyOverrides;
     readonly theme?: ThemeOverrides;
@@ -22,4 +33,4 @@ interface AskAboutRowProps {
 }
 declare function AskAboutRow(props: AskAboutRowProps): ReactNode;
 
-export { AskAboutRow, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };
+export { AskAboutRow, type AskAboutRowAppearance, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };

package/dist/ask.js

@@ -1,5 +1,5 @@
-export { AskAboutRow } from './chunk-Y7P7DDHD.js';
-export { ThemeProvider, useTheme } from './chunk-WKRCCPSN.js';
-export { AgentRuntimeProvider, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+export { AskAboutRow } from './chunk-NJ6ARGZS.js';
+export { ThemeProvider, useTheme } from './chunk-EFEXTVIT.js';
+export { AgentRuntimeProvider, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
 //# sourceMappingURL=ask.js.map
 //# sourceMappingURL=ask.js.map

package/dist/chat.cjs

@@ -1,266 +1,269 @@
 'use strict';
 
-var chunkH2Y2YW2Q_cjs = require('./chunk-H2Y2YW2Q.cjs');
-var chunkPYPO6F7L_cjs = require('./chunk-PYPO6F7L.cjs');
-var chunkOWUKWVEZ_cjs = require('./chunk-OWUKWVEZ.cjs');
+var chunkAGZ7IH7E_cjs = require('./chunk-AGZ7IH7E.cjs');
+var chunk6QYDPGRS_cjs = require('./chunk-6QYDPGRS.cjs');
 
 
 
 Object.defineProperty(exports, "ActivityLine", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.ActivityLine; }
+  get: function () { return chunkAGZ7IH7E_cjs.ActivityLine; }
 });
 Object.defineProperty(exports, "AgentChat", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.AgentChat; }
+  get: function () { return chunkAGZ7IH7E_cjs.AgentChat; }
 });
 Object.defineProperty(exports, "AgentFooter", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.AgentFooter; }
+  get: function () { return chunkAGZ7IH7E_cjs.AgentFooter; }
 });
 Object.defineProperty(exports, "AgentRuntimeProvider", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.AgentRuntimeProvider; }
+  get: function () { return chunkAGZ7IH7E_cjs.AgentRuntimeProvider; }
 });
 Object.defineProperty(exports, "Avatar", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.Avatar; }
+  get: function () { return chunkAGZ7IH7E_cjs.Avatar; }
 });
 Object.defineProperty(exports, "Button", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.Button; }
+  get: function () { return chunkAGZ7IH7E_cjs.Button; }
 });
 Object.defineProperty(exports, "CardActions", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.CardActions; }
+  get: function () { return chunkAGZ7IH7E_cjs.CardActions; }
 });
 Object.defineProperty(exports, "CardCarousel", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.CardCarousel; }
+  get: function () { return chunkAGZ7IH7E_cjs.CardCarousel; }
 });
 Object.defineProperty(exports, "CardFrame", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.CardFrame; }
+  get: function () { return chunkAGZ7IH7E_cjs.CardFrame; }
 });
 Object.defineProperty(exports, "CardView", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.CardView; }
+  get: function () { return chunkAGZ7IH7E_cjs.CardView; }
 });
 Object.defineProperty(exports, "ChatHeader", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.ChatHeader; }
+  get: function () { return chunkAGZ7IH7E_cjs.ChatHeader; }
 });
 Object.defineProperty(exports, "ChatSkeleton", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.ChatSkeleton; }
+  get: function () { return chunkAGZ7IH7E_cjs.ChatSkeleton; }
 });
 Object.defineProperty(exports, "Composer", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.Composer; }
+  get: function () { return chunkAGZ7IH7E_cjs.Composer; }
 });
 Object.defineProperty(exports, "DefaultBubble", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DefaultBubble; }
+  get: function () { return chunkAGZ7IH7E_cjs.DefaultBubble; }
 });
 Object.defineProperty(exports, "DefaultComposer", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DefaultComposer; }
+  get: function () { return chunkAGZ7IH7E_cjs.DefaultComposer; }
 });
 Object.defineProperty(exports, "DefaultEnded", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DefaultEnded; }
+  get: function () { return chunkAGZ7IH7E_cjs.DefaultEnded; }
 });
 Object.defineProperty(exports, "DefaultHeader", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DefaultHeader; }
+  get: function () { return chunkAGZ7IH7E_cjs.DefaultHeader; }
 });
 Object.defineProperty(exports, "DefaultTurnFailed", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DefaultTurnFailed; }
+  get: function () { return chunkAGZ7IH7E_cjs.DefaultTurnFailed; }
 });
 Object.defineProperty(exports, "DefaultUnavailable", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DefaultUnavailable; }
+  get: function () { return chunkAGZ7IH7E_cjs.DefaultUnavailable; }
 });
 Object.defineProperty(exports, "DefaultUnavailableScreen", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DefaultUnavailableScreen; }
+  get: function () { return chunkAGZ7IH7E_cjs.DefaultUnavailableScreen; }
 });
 Object.defineProperty(exports, "DefaultUnreachable", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DefaultUnreachable; }
+  get: function () { return chunkAGZ7IH7E_cjs.DefaultUnreachable; }
 });
 Object.defineProperty(exports, "DisclosureBar", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.DisclosureBar; }
+  get: function () { return chunkAGZ7IH7E_cjs.DisclosureBar; }
 });
 Object.defineProperty(exports, "FailureActionButton", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.FailureActionButton; }
+  get: function () { return chunkAGZ7IH7E_cjs.FailureActionButton; }
 });
 Object.defineProperty(exports, "InfoCard", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.InfoCard; }
+  get: function () { return chunkAGZ7IH7E_cjs.InfoCard; }
 });
 Object.defineProperty(exports, "LinksCard", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.LinksCard; }
+  get: function () { return chunkAGZ7IH7E_cjs.LinksCard; }
 });
 Object.defineProperty(exports, "ListingCard", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.ListingCard; }
+  get: function () { return chunkAGZ7IH7E_cjs.ListingCard; }
 });
 Object.defineProperty(exports, "MessageBubble", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.MessageBubble; }
+  get: function () { return chunkAGZ7IH7E_cjs.MessageBubble; }
 });
 Object.defineProperty(exports, "MessageList", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.MessageList; }
+  get: function () { return chunkAGZ7IH7E_cjs.MessageList; }
 });
 Object.defineProperty(exports, "NextStepCard", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.NextStepCard; }
+  get: function () { return chunkAGZ7IH7E_cjs.NextStepCard; }
 });
 Object.defineProperty(exports, "ProposalCard", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.ProposalCard; }
+  get: function () { return chunkAGZ7IH7E_cjs.ProposalCard; }
 });
 Object.defineProperty(exports, "QuestionCard", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.QuestionCard; }
+  get: function () { return chunkAGZ7IH7E_cjs.QuestionCard; }
 });
 Object.defineProperty(exports, "Row", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.Row; }
+  get: function () { return chunkAGZ7IH7E_cjs.Row; }
 });
 Object.defineProperty(exports, "StatusBanner", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.StatusBanner; }
+  get: function () { return chunkAGZ7IH7E_cjs.StatusBanner; }
 });
 Object.defineProperty(exports, "StreamingBubble", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.StreamingBubble; }
+  get: function () { return chunkAGZ7IH7E_cjs.StreamingBubble; }
 });
 Object.defineProperty(exports, "SystemRow", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.SystemRow; }
+  get: function () { return chunkAGZ7IH7E_cjs.SystemRow; }
 });
 Object.defineProperty(exports, "TimeSlotsCard", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.TimeSlotsCard; }
+  get: function () { return chunkAGZ7IH7E_cjs.TimeSlotsCard; }
 });
 Object.defineProperty(exports, "VinaverseChat", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.VinaverseChat; }
+  get: function () { return chunkAGZ7IH7E_cjs.VinaverseChat; }
 });
 Object.defineProperty(exports, "VinaverseChatProvider", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.VinaverseChatProvider; }
+  get: function () { return chunkAGZ7IH7E_cjs.VinaverseChatProvider; }
 });
 Object.defineProperty(exports, "Welcome", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.Welcome; }
+  get: function () { return chunkAGZ7IH7E_cjs.Welcome; }
 });
 Object.defineProperty(exports, "allowedImage", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.allowedImage; }
+  get: function () { return chunkAGZ7IH7E_cjs.allowedImage; }
 });
 Object.defineProperty(exports, "answerText", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.answerText; }
+  get: function () { return chunkAGZ7IH7E_cjs.answerText; }
 });
 Object.defineProperty(exports, "carousels", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.carousels; }
+  get: function () { return chunkAGZ7IH7E_cjs.carousels; }
 });
 Object.defineProperty(exports, "defaultCard", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.defaultCard; }
+  get: function () { return chunkAGZ7IH7E_cjs.defaultCard; }
 });
 Object.defineProperty(exports, "fieldText", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.fieldText; }
+  get: function () { return chunkAGZ7IH7E_cjs.fieldText; }
+});
+Object.defineProperty(exports, "forgetGreeting", {
+  enumerable: true,
+  get: function () { return chunkAGZ7IH7E_cjs.forgetGreeting; }
 });
 Object.defineProperty(exports, "greetedKey", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.greetedKey; }
+  get: function () { return chunkAGZ7IH7E_cjs.greetedKey; }
 });
 Object.defineProperty(exports, "itemType", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.itemType; }
+  get: function () { return chunkAGZ7IH7E_cjs.itemType; }
 });
 Object.defineProperty(exports, "monogram", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.monogram; }
+  get: function () { return chunkAGZ7IH7E_cjs.monogram; }
 });
 Object.defineProperty(exports, "newestWholeReply", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.newestWholeReply; }
+  get: function () { return chunkAGZ7IH7E_cjs.newestWholeReply; }
 });
 Object.defineProperty(exports, "ratingText", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.ratingText; }
+  get: function () { return chunkAGZ7IH7E_cjs.ratingText; }
 });
 Object.defineProperty(exports, "useAgentConversation", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.useAgentConversation; }
+  get: function () { return chunkAGZ7IH7E_cjs.useAgentConversation; }
 });
 Object.defineProperty(exports, "useAgentFeatures", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.useAgentFeatures; }
+  get: function () { return chunkAGZ7IH7E_cjs.useAgentFeatures; }
 });
 Object.defineProperty(exports, "useAgentLauncher", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.useAgentLauncher; }
+  get: function () { return chunkAGZ7IH7E_cjs.useAgentLauncher; }
 });
 Object.defineProperty(exports, "useAgentName", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.useAgentName; }
+  get: function () { return chunkAGZ7IH7E_cjs.useAgentName; }
 });
 Object.defineProperty(exports, "useAgentProfile", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.useAgentProfile; }
+  get: function () { return chunkAGZ7IH7E_cjs.useAgentProfile; }
 });
 Object.defineProperty(exports, "useAgentRuntime", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.useAgentRuntime; }
+  get: function () { return chunkAGZ7IH7E_cjs.useAgentRuntime; }
 });
 Object.defineProperty(exports, "useAgentStatus", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.useAgentStatus; }
+  get: function () { return chunkAGZ7IH7E_cjs.useAgentStatus; }
 });
 Object.defineProperty(exports, "useChat", {
   enumerable: true,
-  get: function () { return chunkH2Y2YW2Q_cjs.useChat; }
+  get: function () { return chunkAGZ7IH7E_cjs.useChat; }
 });
-Object.defineProperty(exports, "announce", {
+Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,
-  get: function () { return chunkPYPO6F7L_cjs.announce; }
+  get: function () { return chunk6QYDPGRS_cjs.ThemeProvider; }
 });
-Object.defineProperty(exports, "useNativeLifecycle", {
+Object.defineProperty(exports, "announce", {
   enumerable: true,
-  get: function () { return chunkPYPO6F7L_cjs.useNativeLifecycle; }
+  get: function () { return chunk6QYDPGRS_cjs.announce; }
 });
-Object.defineProperty(exports, "useReducedMotion", {
+Object.defineProperty(exports, "createTheme", {
   enumerable: true,
-  get: function () { return chunkPYPO6F7L_cjs.useReducedMotion; }
+  get: function () { return chunk6QYDPGRS_cjs.createTheme; }
 });
-Object.defineProperty(exports, "ThemeProvider", {
+Object.defineProperty(exports, "themeProblems", {
   enumerable: true,
-  get: function () { return chunkOWUKWVEZ_cjs.ThemeProvider; }
+  get: function () { return chunk6QYDPGRS_cjs.themeProblems; }
 });
-Object.defineProperty(exports, "createTheme", {
+Object.defineProperty(exports, "useNativeLifecycle", {
   enumerable: true,
-  get: function () { return chunkOWUKWVEZ_cjs.createTheme; }
+  get: function () { return chunk6QYDPGRS_cjs.useNativeLifecycle; }
 });
-Object.defineProperty(exports, "themeProblems", {
+Object.defineProperty(exports, "useReducedMotion", {
   enumerable: true,
-  get: function () { return chunkOWUKWVEZ_cjs.themeProblems; }
+  get: function () { return chunk6QYDPGRS_cjs.useReducedMotion; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
-  get: function () { return chunkOWUKWVEZ_cjs.useTheme; }
+  get: function () { return chunk6QYDPGRS_cjs.useTheme; }
 });
 //# sourceMappingURL=chat.cjs.map
 //# sourceMappingURL=chat.cjs.map

package/dist/chat.d.cts

@@ -1,9 +1,9 @@
-export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
 import * as react from 'react';
 import { ComponentType, ReactElement, ReactNode, RefObject } from 'react';
 import * as _vinaverse_client_conversation from '@vinaverse/client/conversation';
 import { MessageItem, Welcome as Welcome$1, TimelineItem, CardItem, HeldCard, Question, ProposalOutcome, ConversationStore, SystemItem } from '@vinaverse/client/conversation';
-import { ReadCard, AgentCardTarget, AgentKey, AgentPlace, AgentFailureReason, AgentRating } from '@vinaverse/client/agent';
+import { ReadCard, AgentCardTarget, AgentKey, AgentPlace, AgentEntryPoint, AgentFailureReason, AgentRating } from '@vinaverse/client/agent';
 import { ImageProps, StyleProp, ViewStyle } from 'react-native';
 import { CopyOverrides } from '@vinaverse/react';
 import { a as ThemeOverrides, C as ColorSchemeSetting } from './theme-BhiEGv64.cjs';
@@ -269,10 +269,19 @@ declare function VinaverseChatProvider(props: Omit<VinaverseChatProps, 'hideHead
 }): ReactNode;
 declare function VinaverseChat(props: VinaverseChatProps): ReactNode;
 
+/**
+ * The full-screen states (`Ended`, `Unreachable`, `UnavailableScreen`) are slots: each gets everything its screen
+ * needs (why, the actions, a person to contact) and the kit's own part as `Default`, so an app replaces the layout and
+ * the words entirely, or only the words through `copy`.
+ */
 interface AgentEndedProps {
     readonly onStartNew: () => void;
+    /** Why: `ended`, `not_found`, `expired`, `mismatch`, `completed`. */
+    readonly reason: AgentFailureReason | null;
     /** The API's code (`conversation_not_found`, `conversation_expired`), when it gave one. */
     readonly code: string | null;
+    /** A person instead (the chat's `onContact`); absent when the app gave none. */
+    readonly onContact: (() => void) | undefined;
 }
 /** No agent here: switched off for this tenant, mode or person, or the backend refused the session. */
 interface AgentUnavailableScreenProps {
@@ -288,13 +297,15 @@ interface AgentUnreachableProps {
     readonly onRetry: () => void;
     /** Why: `network`, `server`, `rate_limited`, … */
     readonly reason: AgentFailureReason | null;
+    /** A person instead (the chat's `onContact`); absent when the app gave none. */
+    readonly onContact: (() => void) | undefined;
 }
 /** A slot gets the kit's own part as `Default`, to wrap rather than rewrite. */
 type Slot<P> = ComponentType<P & {
     readonly Default: ComponentType<P>;
 }>;
 interface AgentFooterProps {
-    /** The newest whole reply's turn, to rate; null when there is none. */
+    /** The newest whole reply's turn, to rate; null when there is none or it was restored from before. */
     readonly turnId: string | null;
     readonly rating: AgentRating | undefined;
     readonly onRate: (rating: AgentRating) => void;
@@ -316,7 +327,8 @@ interface AgentChatProps extends Omit<VinaverseChatProps, 'conversation' | 'comp
     readonly agentKey: AgentKey;
     /** Where the person asks from, told to the agent as a session opens. */
     readonly place?: AgentPlace | null;
-    readonly entryPoint?: string | null;
+    /** How the person came in: `launcher` and `ask` from the kit's parts, `deep_link`, or the app's own words. */
+    readonly entryPoint?: AgentEntryPoint | null;
     /** The question about this place, offered when the session was told another one (`moved`). */
     readonly askAbout?: string | null;
     /** A person: offered on a failed turn, "couldn't connect" and no agent. */