@vinaverse/react-native 0.1.0-alpha.11 → 0.1.0-alpha.13

package/README.md

@@ -75,7 +75,10 @@ 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={({ entryPoint }) => openChat('professional', side, entryPoint)} />
+<AskAboutRow title={`Ask ${agentName} about ${name}`} agentKey={{ subject: user?.id ?? null, mode: side }}
+  place={{ screen: 'professional', entity: { type: 'professional', id }, preview: { title: name, image_url: photo } }}
+  question={`Is ${name} free this week?`} onPress={(open) => navigate('Chat', { open })} />
+// the chat screen forwards it as it is: <AgentChat {...route.params.open} />
 ```
 
 - **Parts:** `AgentChat` draws the conversation, a conversation that ended (`components.Ended`: `onStartNew`,
@@ -98,7 +101,16 @@ const imagePolicy = { hosts: ['images.example.com'], aspectRatio: 1.6, Placehold
   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
+  your own pages. It opens a conversation of the object's own: `askAboutKey(agentKey, place)`, your key on the thread
+  `ask:<type>:<id>`, so each booking, professional or space gets its own and your main conversation is left alone. On a
+  press it tells the runtime the place for that key, then hands back `{ entryPoint, agentKey, place, askAbout, entry,
+  anchor }` for `<AgentChat {...open} />`. There, at an object and before the person says anything, `question` leads as
+  a chip and the welcome's own chips give way; `place.preview` (`title`, `image_url`, `kind`) is drawn as the
+  conversation's first row, provisional, until the verified `anchor` card of that object takes its place, and is never sent. `entry`
+  (`ask_about`, `entryLabel` or the screen, cut to 60 code points at a whole character) and `anchor` (null unless its
+  type is the contract's; `anchorType` for a word of your own) reach your backend's session request only with the
+  runtime's `sendAnchor` (off until the gateway reads them), as `anchor_ref` and `entry`. The row is 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, and `testID` its test id.
 - **Policies and adapters:** `imagePolicy` (photo hosts, frame, the stand-in for a missing photo, given the card's `title` and `kind`) applies to every card
@@ -107,7 +119,8 @@ const imagePolicy = { hosts: ['images.example.com'], aspectRatio: 1.6, Placehold
 - **History** (`@vinaverse/react-native/history` only, never `.`, so an app without a history screen ships none
   of it): `AgentHistoryList` lists the person's past conversations, newest activity first, a page at a time as
   they scroll (title, when, how many messages, whether it ended); a row opens (`onOpen`: show `AgentTranscript`), an
-  open one continues (`onContinue(conversation, live)`: pinned under its own key, `useAgentHistory().keyOf`, show
+  open one continues (`onContinue(conversation, live)`: pinned under its own key, `useAgentHistory().keyOf`, or your
+  own with `keyOf` when your keys say your modes in your own words; continue and delete both go under it; show
   `AgentChat` with it), and deletes after the person confirms (`confirmDelete`, default the platform's alert with the
   copy's words; a refused delete is said on the row and through `onWarning`). `AgentTranscript` reads one back, the
   newest page first and earlier pages above (a button, and the top of the list), drawn with the chat's own bubbles and

package/dist/ask.cjs

@@ -1,22 +1,27 @@
 'use strict';
 
-var chunkNMKJ7LIJ_cjs = require('./chunk-NMKJ7LIJ.cjs');
-var chunk6QYDPGRS_cjs = require('./chunk-6QYDPGRS.cjs');
+var chunk35T5QPMT_cjs = require('./chunk-35T5QPMT.cjs');
+var chunkUMCOOQT6_cjs = require('./chunk-UMCOOQT6.cjs');
+var agent$1 = require('@vinaverse/client/agent');
 var agent = require('@vinaverse/react/agent');
 
 
 
 Object.defineProperty(exports, "AskAboutRow", {
   enumerable: true,
-  get: function () { return chunkNMKJ7LIJ_cjs.AskAboutRow; }
+  get: function () { return chunk35T5QPMT_cjs.AskAboutRow; }
 });
 Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.ThemeProvider; }
+  get: function () { return chunkUMCOOQT6_cjs.ThemeProvider; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.useTheme; }
+  get: function () { return chunkUMCOOQT6_cjs.useTheme; }
+});
+Object.defineProperty(exports, "askAboutKey", {
+  enumerable: true,
+  get: function () { return agent$1.askAboutKey; }
 });
 Object.defineProperty(exports, "AgentRuntimeProvider", {
   enumerable: true,

package/dist/ask.d.cts

@@ -1,3 +1,5 @@
+import { AgentKey, AskAboutPlace, AgentEntry, AgentAnchorRef, AgentAnchorType } from '@vinaverse/client/agent';
+export { AgentAnchorRef, AgentEntry, AgentPlacePreview, AskAboutPlace, askAboutKey } from '@vinaverse/client/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';
@@ -12,14 +14,42 @@ interface AskAboutRowAppearance {
     /** The chevron at the row's end. Default true. */
     readonly chevron?: boolean;
 }
+/** What the row hands back on a press: everything `<AgentChat {...open} />` needs to open the object's conversation. */
+interface AskAboutOpen {
+    readonly entryPoint: 'ask';
+    /** The app's key on the object's own thread (`askAboutKey`): each object its own conversation. */
+    readonly agentKey: AgentKey;
+    /** The place as given, its `preview` included (AgentChat draws it, and never sends it). */
+    readonly place: AskAboutPlace;
+    /** The question offered first, before the person says anything; null without one. */
+    readonly askAbout: string | null;
+    /** `ask_about`, with the app's label (at most 60 code points); sent only with the runtime's `sendAnchor`. */
+    readonly entry: AgentEntry;
+    /**
+     * The object, for the contract's anchor (contracts#86); null when its type is not one of the contract's
+     * (`AgentAnchorType`; pass `anchorType` for an app word such as "space"). Sent only with the runtime's `sendAnchor`.
+     */
+    readonly anchor: AgentAnchorRef | null;
+}
 interface AskAboutRowProps {
     /** "Ask Example Agent about Riley Sample". */
     readonly title: string;
     readonly body?: string;
-    /** 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 key as it holds it (its mode as it is): the row puts the object's thread on it. Keep it stable. */
+    readonly agentKey: AgentKey;
+    /** The screen and the object on it; `preview` draws the object in the chat until the agent's verified card comes. */
+    readonly place: AskAboutPlace;
+    /** A question about the object, offered first in the chat as a chip the person taps; never sent in their name. */
+    readonly question?: string;
+    /**
+     * The app's own word for this way in, for analytics: cut to 60 code points at a whole character (`entryLabel`).
+     * Default: the place's screen.
+     */
+    readonly entryLabel?: string;
+    /** The contract's type for the object, when the app's `place.entity.type` is a word of its own ("space"). */
+    readonly anchorType?: AgentAnchorType;
+    /** The person asks: the runtime was told the place for the object's key; open `<AgentChat {...open} />`. */
+    readonly onPress: (open: AskAboutOpen) => void;
     /** The app's brand mark at the row's start; default the agent name's first letter. */
     readonly Mark?: ComponentType<{
         readonly size: number;
@@ -35,4 +65,4 @@ interface AskAboutRowProps {
 }
 declare function AskAboutRow(props: AskAboutRowProps): ReactNode;
 
-export { AskAboutRow, type AskAboutRowAppearance, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };
+export { type AskAboutOpen, AskAboutRow, type AskAboutRowAppearance, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };

package/dist/ask.d.ts

@@ -1,3 +1,5 @@
+import { AgentKey, AskAboutPlace, AgentEntry, AgentAnchorRef, AgentAnchorType } from '@vinaverse/client/agent';
+export { AgentAnchorRef, AgentEntry, AgentPlacePreview, AskAboutPlace, askAboutKey } from '@vinaverse/client/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';
@@ -12,14 +14,42 @@ interface AskAboutRowAppearance {
     /** The chevron at the row's end. Default true. */
     readonly chevron?: boolean;
 }
+/** What the row hands back on a press: everything `<AgentChat {...open} />` needs to open the object's conversation. */
+interface AskAboutOpen {
+    readonly entryPoint: 'ask';
+    /** The app's key on the object's own thread (`askAboutKey`): each object its own conversation. */
+    readonly agentKey: AgentKey;
+    /** The place as given, its `preview` included (AgentChat draws it, and never sends it). */
+    readonly place: AskAboutPlace;
+    /** The question offered first, before the person says anything; null without one. */
+    readonly askAbout: string | null;
+    /** `ask_about`, with the app's label (at most 60 code points); sent only with the runtime's `sendAnchor`. */
+    readonly entry: AgentEntry;
+    /**
+     * The object, for the contract's anchor (contracts#86); null when its type is not one of the contract's
+     * (`AgentAnchorType`; pass `anchorType` for an app word such as "space"). Sent only with the runtime's `sendAnchor`.
+     */
+    readonly anchor: AgentAnchorRef | null;
+}
 interface AskAboutRowProps {
     /** "Ask Example Agent about Riley Sample". */
     readonly title: string;
     readonly body?: string;
-    /** 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 key as it holds it (its mode as it is): the row puts the object's thread on it. Keep it stable. */
+    readonly agentKey: AgentKey;
+    /** The screen and the object on it; `preview` draws the object in the chat until the agent's verified card comes. */
+    readonly place: AskAboutPlace;
+    /** A question about the object, offered first in the chat as a chip the person taps; never sent in their name. */
+    readonly question?: string;
+    /**
+     * The app's own word for this way in, for analytics: cut to 60 code points at a whole character (`entryLabel`).
+     * Default: the place's screen.
+     */
+    readonly entryLabel?: string;
+    /** The contract's type for the object, when the app's `place.entity.type` is a word of its own ("space"). */
+    readonly anchorType?: AgentAnchorType;
+    /** The person asks: the runtime was told the place for the object's key; open `<AgentChat {...open} />`. */
+    readonly onPress: (open: AskAboutOpen) => void;
     /** The app's brand mark at the row's start; default the agent name's first letter. */
     readonly Mark?: ComponentType<{
         readonly size: number;
@@ -35,4 +65,4 @@ interface AskAboutRowProps {
 }
 declare function AskAboutRow(props: AskAboutRowProps): ReactNode;
 
-export { AskAboutRow, type AskAboutRowAppearance, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };
+export { type AskAboutOpen, AskAboutRow, type AskAboutRowAppearance, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };

package/dist/ask.js

@@ -1,5 +1,6 @@
-export { AskAboutRow } from './chunk-7KPCO443.js';
-export { ThemeProvider, useTheme } from './chunk-EFEXTVIT.js';
+export { AskAboutRow } from './chunk-GFD4T3IA.js';
+export { ThemeProvider, useTheme } from './chunk-35A77CNF.js';
+export { askAboutKey } from '@vinaverse/client/agent';
 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,274 +1,274 @@
 'use strict';
 
-var chunk4PXQ7DEY_cjs = require('./chunk-4PXQ7DEY.cjs');
-var chunkXAG2P447_cjs = require('./chunk-XAG2P447.cjs');
-var chunk6QYDPGRS_cjs = require('./chunk-6QYDPGRS.cjs');
+var chunkYVCMKSJG_cjs = require('./chunk-YVCMKSJG.cjs');
+var chunk272ACDLI_cjs = require('./chunk-272ACDLI.cjs');
+var chunkUMCOOQT6_cjs = require('./chunk-UMCOOQT6.cjs');
 
 
 
 Object.defineProperty(exports, "AgentChat", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.AgentChat; }
+  get: function () { return chunkYVCMKSJG_cjs.AgentChat; }
 });
 Object.defineProperty(exports, "AgentFooter", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.AgentFooter; }
+  get: function () { return chunkYVCMKSJG_cjs.AgentFooter; }
 });
 Object.defineProperty(exports, "AgentRuntimeProvider", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.AgentRuntimeProvider; }
+  get: function () { return chunkYVCMKSJG_cjs.AgentRuntimeProvider; }
 });
 Object.defineProperty(exports, "Composer", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.Composer; }
+  get: function () { return chunkYVCMKSJG_cjs.Composer; }
 });
 Object.defineProperty(exports, "DefaultComposer", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.DefaultComposer; }
+  get: function () { return chunkYVCMKSJG_cjs.DefaultComposer; }
 });
 Object.defineProperty(exports, "DefaultEnded", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.DefaultEnded; }
+  get: function () { return chunkYVCMKSJG_cjs.DefaultEnded; }
 });
 Object.defineProperty(exports, "DefaultUnavailable", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.DefaultUnavailable; }
+  get: function () { return chunkYVCMKSJG_cjs.DefaultUnavailable; }
 });
 Object.defineProperty(exports, "DefaultUnavailableScreen", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.DefaultUnavailableScreen; }
+  get: function () { return chunkYVCMKSJG_cjs.DefaultUnavailableScreen; }
 });
 Object.defineProperty(exports, "DefaultUnreachable", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.DefaultUnreachable; }
+  get: function () { return chunkYVCMKSJG_cjs.DefaultUnreachable; }
 });
 Object.defineProperty(exports, "StatusBanner", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.StatusBanner; }
+  get: function () { return chunkYVCMKSJG_cjs.StatusBanner; }
 });
 Object.defineProperty(exports, "VinaverseChat", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.VinaverseChat; }
+  get: function () { return chunkYVCMKSJG_cjs.VinaverseChat; }
 });
 Object.defineProperty(exports, "VinaverseChatProvider", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.VinaverseChatProvider; }
+  get: function () { return chunkYVCMKSJG_cjs.VinaverseChatProvider; }
 });
 Object.defineProperty(exports, "forgetGreeting", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.forgetGreeting; }
+  get: function () { return chunkYVCMKSJG_cjs.forgetGreeting; }
 });
 Object.defineProperty(exports, "greetedKey", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.greetedKey; }
+  get: function () { return chunkYVCMKSJG_cjs.greetedKey; }
 });
 Object.defineProperty(exports, "newestWholeReply", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.newestWholeReply; }
+  get: function () { return chunkYVCMKSJG_cjs.newestWholeReply; }
 });
 Object.defineProperty(exports, "useAgentConversation", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.useAgentConversation; }
+  get: function () { return chunkYVCMKSJG_cjs.useAgentConversation; }
 });
 Object.defineProperty(exports, "useAgentFeatures", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.useAgentFeatures; }
+  get: function () { return chunkYVCMKSJG_cjs.useAgentFeatures; }
 });
 Object.defineProperty(exports, "useAgentLauncher", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.useAgentLauncher; }
+  get: function () { return chunkYVCMKSJG_cjs.useAgentLauncher; }
 });
 Object.defineProperty(exports, "useAgentName", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.useAgentName; }
+  get: function () { return chunkYVCMKSJG_cjs.useAgentName; }
 });
 Object.defineProperty(exports, "useAgentProfile", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.useAgentProfile; }
+  get: function () { return chunkYVCMKSJG_cjs.useAgentProfile; }
 });
 Object.defineProperty(exports, "useAgentRuntime", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.useAgentRuntime; }
+  get: function () { return chunkYVCMKSJG_cjs.useAgentRuntime; }
 });
 Object.defineProperty(exports, "useAgentStatus", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.useAgentStatus; }
+  get: function () { return chunkYVCMKSJG_cjs.useAgentStatus; }
 });
 Object.defineProperty(exports, "useAgentStatusState", {
   enumerable: true,
-  get: function () { return chunk4PXQ7DEY_cjs.useAgentStatusState; }
+  get: function () { return chunkYVCMKSJG_cjs.useAgentStatusState; }
 });
 Object.defineProperty(exports, "ActivityLine", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.ActivityLine; }
+  get: function () { return chunk272ACDLI_cjs.ActivityLine; }
 });
 Object.defineProperty(exports, "Avatar", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.Avatar; }
+  get: function () { return chunk272ACDLI_cjs.Avatar; }
 });
 Object.defineProperty(exports, "Button", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.Button; }
+  get: function () { return chunk272ACDLI_cjs.Button; }
 });
 Object.defineProperty(exports, "CardActions", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.CardActions; }
+  get: function () { return chunk272ACDLI_cjs.CardActions; }
 });
 Object.defineProperty(exports, "CardCarousel", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.CardCarousel; }
+  get: function () { return chunk272ACDLI_cjs.CardCarousel; }
 });
 Object.defineProperty(exports, "CardFrame", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.CardFrame; }
+  get: function () { return chunk272ACDLI_cjs.CardFrame; }
 });
 Object.defineProperty(exports, "CardView", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.CardView; }
+  get: function () { return chunk272ACDLI_cjs.CardView; }
 });
 Object.defineProperty(exports, "ChatHeader", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.ChatHeader; }
+  get: function () { return chunk272ACDLI_cjs.ChatHeader; }
 });
 Object.defineProperty(exports, "ChatSkeleton", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.ChatSkeleton; }
+  get: function () { return chunk272ACDLI_cjs.ChatSkeleton; }
 });
 Object.defineProperty(exports, "DefaultBubble", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.DefaultBubble; }
+  get: function () { return chunk272ACDLI_cjs.DefaultBubble; }
 });
 Object.defineProperty(exports, "DefaultHeader", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.DefaultHeader; }
+  get: function () { return chunk272ACDLI_cjs.DefaultHeader; }
 });
 Object.defineProperty(exports, "DefaultTurnFailed", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.DefaultTurnFailed; }
+  get: function () { return chunk272ACDLI_cjs.DefaultTurnFailed; }
 });
 Object.defineProperty(exports, "DisclosureBar", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.DisclosureBar; }
+  get: function () { return chunk272ACDLI_cjs.DisclosureBar; }
 });
 Object.defineProperty(exports, "FailureActionButton", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.FailureActionButton; }
+  get: function () { return chunk272ACDLI_cjs.FailureActionButton; }
 });
 Object.defineProperty(exports, "InfoCard", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.InfoCard; }
+  get: function () { return chunk272ACDLI_cjs.InfoCard; }
 });
 Object.defineProperty(exports, "LinksCard", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.LinksCard; }
+  get: function () { return chunk272ACDLI_cjs.LinksCard; }
 });
 Object.defineProperty(exports, "ListingCard", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.ListingCard; }
+  get: function () { return chunk272ACDLI_cjs.ListingCard; }
 });
 Object.defineProperty(exports, "MessageBubble", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.MessageBubble; }
+  get: function () { return chunk272ACDLI_cjs.MessageBubble; }
 });
 Object.defineProperty(exports, "MessageList", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.MessageList; }
+  get: function () { return chunk272ACDLI_cjs.MessageList; }
 });
 Object.defineProperty(exports, "NextStepCard", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.NextStepCard; }
+  get: function () { return chunk272ACDLI_cjs.NextStepCard; }
 });
 Object.defineProperty(exports, "ProposalCard", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.ProposalCard; }
+  get: function () { return chunk272ACDLI_cjs.ProposalCard; }
 });
 Object.defineProperty(exports, "QuestionCard", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.QuestionCard; }
+  get: function () { return chunk272ACDLI_cjs.QuestionCard; }
 });
 Object.defineProperty(exports, "Row", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.Row; }
+  get: function () { return chunk272ACDLI_cjs.Row; }
 });
 Object.defineProperty(exports, "StreamingBubble", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.StreamingBubble; }
+  get: function () { return chunk272ACDLI_cjs.StreamingBubble; }
 });
 Object.defineProperty(exports, "SystemRow", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.SystemRow; }
+  get: function () { return chunk272ACDLI_cjs.SystemRow; }
 });
 Object.defineProperty(exports, "TimeSlotsCard", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.TimeSlotsCard; }
+  get: function () { return chunk272ACDLI_cjs.TimeSlotsCard; }
 });
 Object.defineProperty(exports, "Welcome", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.Welcome; }
+  get: function () { return chunk272ACDLI_cjs.Welcome; }
 });
 Object.defineProperty(exports, "allowedImage", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.allowedImage; }
+  get: function () { return chunk272ACDLI_cjs.allowedImage; }
 });
 Object.defineProperty(exports, "answerText", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.answerText; }
+  get: function () { return chunk272ACDLI_cjs.answerText; }
 });
 Object.defineProperty(exports, "carousels", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.carousels; }
+  get: function () { return chunk272ACDLI_cjs.carousels; }
 });
 Object.defineProperty(exports, "defaultCard", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.defaultCard; }
+  get: function () { return chunk272ACDLI_cjs.defaultCard; }
 });
 Object.defineProperty(exports, "fieldText", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.fieldText; }
+  get: function () { return chunk272ACDLI_cjs.fieldText; }
 });
 Object.defineProperty(exports, "itemType", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.itemType; }
+  get: function () { return chunk272ACDLI_cjs.itemType; }
 });
 Object.defineProperty(exports, "monogram", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.monogram; }
+  get: function () { return chunk272ACDLI_cjs.monogram; }
 });
 Object.defineProperty(exports, "ratingText", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.ratingText; }
+  get: function () { return chunk272ACDLI_cjs.ratingText; }
 });
 Object.defineProperty(exports, "useChat", {
   enumerable: true,
-  get: function () { return chunkXAG2P447_cjs.useChat; }
+  get: function () { return chunk272ACDLI_cjs.useChat; }
 });
 Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.ThemeProvider; }
+  get: function () { return chunkUMCOOQT6_cjs.ThemeProvider; }
 });
 Object.defineProperty(exports, "announce", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.announce; }
+  get: function () { return chunkUMCOOQT6_cjs.announce; }
 });
 Object.defineProperty(exports, "createTheme", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.createTheme; }
+  get: function () { return chunkUMCOOQT6_cjs.createTheme; }
 });
 Object.defineProperty(exports, "themeProblems", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.themeProblems; }
+  get: function () { return chunkUMCOOQT6_cjs.themeProblems; }
 });
 Object.defineProperty(exports, "useNativeLifecycle", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.useNativeLifecycle; }
+  get: function () { return chunkUMCOOQT6_cjs.useNativeLifecycle; }
 });
 Object.defineProperty(exports, "useReducedMotion", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.useReducedMotion; }
+  get: function () { return chunkUMCOOQT6_cjs.useReducedMotion; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
-  get: function () { return chunk6QYDPGRS_cjs.useTheme; }
+  get: function () { return chunkUMCOOQT6_cjs.useTheme; }
 });
 //# sourceMappingURL=chat.cjs.map
 //# sourceMappingURL=chat.cjs.map

package/dist/chat.d.cts

@@ -1,11 +1,11 @@
 export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus, useAgentStatusState } from '@vinaverse/react/agent';
-import { b as CardProps, c as ChatHandlers, d as ChatSlots, g as Chip, I as ImagePolicy, H as HeaderProps, h as ComposerProps, j as FailureState, M as MessageBubbleProps } from './context-gHCLFsJh.cjs';
-export { C as CardCarousel, a as CardGroupProps, e as ChatStore, f as ChatWarning, E as EmptyStateProps, F as FailureAction, i as FailureProps, L as ListProps, P as ProposalDecision, u as useChat } from './context-gHCLFsJh.cjs';
+import { b as CardProps, c as ChatHandlers, d as ChatSlots, g as Chip, I as ImagePolicy, H as HeaderProps, h as ComposerProps, j as FailureState, M as MessageBubbleProps } from './context-B4ctXjm5.cjs';
+export { C as CardCarousel, a as CardGroupProps, e as ChatStore, f as ChatWarning, E as EmptyStateProps, F as FailureAction, i as FailureProps, L as ListProps, k as MessageTimeProps, P as ProposalDecision, u as useChat } from './context-B4ctXjm5.cjs';
 import * as react from 'react';
-import { ReactNode, ComponentType } from 'react';
+import { ReactNode, ComponentType, ReactElement } from 'react';
 import * as _vinaverse_client_conversation from '@vinaverse/client/conversation';
 import { CardItem, Question, ConversationStore, MessageItem, TimelineItem, SystemItem, Welcome as Welcome$1 } from '@vinaverse/client/conversation';
-import { AgentKey, AgentPlace, AgentEntryPoint, AgentFailureReason, AgentRating } from '@vinaverse/client/agent';
+import { AgentKey, AgentPlace, AgentPlacePreview, AgentEntryPoint, AgentEntry, AgentAnchorRef, AgentFailureReason, AgentRating } from '@vinaverse/client/agent';
 import { CopyOverrides } from '@vinaverse/react';
 import { StyleProp, ViewStyle } from 'react-native';
 import { a as ThemeOverrides, C as ColorSchemeSetting } from './theme-BhiEGv64.cjs';
@@ -80,8 +80,15 @@ interface VinaverseChatProps extends ChatHandlers {
      */
     readonly keyboardBehavior?: 'padding' | 'height' | 'position' | 'none';
     readonly style?: StyleProp<ViewStyle>;
+    /**
+     * The AI disclosure the app already holds for this conversation (its cache, or the open's answer): drawn from the
+     * first frame until the session's own arrives, in the same bar. Default: the kit's line.
+     */
+    readonly disclosure?: string;
     /** Chips for an empty conversation when the session brings no welcome (`Session.welcome` comes first). Keep stable. */
     readonly starters?: readonly Chip[];
+    /** False: the welcome's chips and the starters give way, its text stays (`AgentChat`: a question about an object leads). */
+    readonly welcomeChips?: boolean;
     /** Which card photos are drawn, their frame, and what stands in for one that is not. Keep stable. */
     readonly imagePolicy?: ImagePolicy;
     /** One chip above the composer: a question about where the person now is (`AgentChat` offers it when they moved). */
@@ -90,6 +97,19 @@ interface VinaverseChatProps extends ChatHandlers {
     readonly suggestionTestID?: string;
     /** Drawn under the composer, inside the kit's providers (`AgentChat`'s thumbs and footer). */
     readonly footer?: ReactNode;
+    /**
+     * When each message was sent: its time over the first message and over one after `gapMinutes` (default 10) of quiet,
+     * and the exact date and time in every message's screen-reader label, in `locale` and `timeZone`. `false` draws none.
+     * The line is the `MessageTime` slot. Default on.
+     */
+    readonly messageTimes?: boolean | {
+        readonly gapMinutes?: number;
+    };
+    /**
+     * Drawn as the conversation's first row, scrolling with it (`AgentChat`: the object asked about, until its verified
+     * card takes the same place). Keep it stable.
+     */
+    readonly listHeader?: ReactElement | null;
 }
 /** The providers alone, for a tenant composing its own layout from the exported parts. */
 declare function VinaverseChatProvider(props: Omit<VinaverseChatProps, 'hideHeader' | 'keyboardVerticalOffset' | 'keyboardBehavior' | 'style' | 'suggestion' | 'suggestionTestID' | 'footer'> & {
@@ -150,14 +170,28 @@ interface AgentChatSlots extends ChatSlots {
     /** Under the composer; null hides it. Default: thumbs on the newest whole reply, and the privacy link. */
     readonly Footer?: Slot<AgentFooterProps> | null;
 }
-interface AgentChatProps extends Omit<VinaverseChatProps, 'conversation' | 'components' | 'suggestion' | 'suggestionTestID' | 'footer'> {
+interface AgentChatProps extends Omit<VinaverseChatProps, 'conversation' | 'components' | 'suggestion' | 'suggestionTestID' | 'footer' | 'listHeader' | 'welcomeChips'> {
     /** Whose conversation: one per person, mode, business and thread. */
     readonly agentKey: AgentKey;
-    /** Where the person asks from, told to the agent as a session opens. */
-    readonly place?: AgentPlace | null;
+    /**
+     * Where the person asks from, told to the agent as a session opens. Its `preview` (from `AskAboutRow`) is drawn as the
+     * conversation's first row, in a card's frame, until the agent's verified card of that object (an `anchor` card)
+     * arrives and takes its place; never sent.
+     */
+    readonly place?: (AgentPlace & {
+        readonly preview?: AgentPlacePreview;
+    }) | 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`). */
+    /** How the person came in, in the contract's words (`ask_about`); sent only with the runtime's `sendAnchor`. */
+    readonly entry?: AgentEntry | null;
+    /** The object the conversation is about (contracts#86); sent only with the runtime's `sendAnchor`. */
+    readonly anchor?: AgentAnchorRef | null;
+    /**
+     * The question about this place. At an object (`place.entity`), before the person says anything, it leads: a chip
+     * above the composer, the welcome's own chips giving way. Elsewhere it is offered when the session was told another
+     * place (`moved`).
+     */
     readonly askAbout?: string | null;
     /** A person: offered on a failed turn, "couldn't connect" and no agent. */
     readonly onContact?: () => void;
@@ -256,6 +290,8 @@ declare const Row: react.NamedExoticComponent<{
     readonly run?: readonly CardItem[] | undefined;
     /** A card a carousel earlier in the list draws. */
     readonly inside?: boolean;
+    /** The message starts a new stretch: its time is drawn over it (`messageTimes`). */
+    readonly time?: string | undefined;
 }>;
 declare const MessageList: react.NamedExoticComponent<object>;