@vinaverse/client 0.1.0-alpha.11 → 0.1.0-alpha.13

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 export { C as CONTRACT } from './contract-Be2oVHNr.cjs';
-export { A as AnswerInput, h as AuthMode, a as Card, d as CardKind, e as ClientErrorCode, j as ClientEvent, k as ClientSecret, l as Connection, m as ConversationEngine, n as ConversationState, F as FetchLike, o as Frame, H as HeldCard, f as HeldQuestion, M as Message, P as Proposal, g as ProposalOutcome, Q as Question, R as Reconnect, S as Schemas, p as ServerEvent, q as ServerEventOf, r as ServerEventType, s as SessionEvents, t as SessionInfo, u as SessionOptions, v as SessionStatus, w as SseTarget, T as ToolLine, x as TranscriptItem, y as TurnInput, V as VinaverseClientError, z as VinaverseSession, B as WebSocketFactory, D as WebSocketLike, E as cardActionSse, G as components, i as isKnownCard, I as operations, J as paths, K as sseFrames, L as turnSse } from './session-D0ijOQX3.cjs';
+export { A as AnswerInput, h as AuthMode, a as Card, d as CardKind, e as ClientErrorCode, j as ClientEvent, k as ClientSecret, l as Connection, m as ConversationEngine, n as ConversationState, F as FetchLike, o as Frame, H as HeldCard, f as HeldQuestion, M as Message, P as Proposal, g as ProposalOutcome, Q as Question, R as Reconnect, S as Schemas, p as ServerEvent, q as ServerEventOf, r as ServerEventType, s as SessionEvents, t as SessionInfo, u as SessionOptions, v as SessionStatus, w as SseTarget, T as ToolLine, x as TranscriptItem, y as TurnInput, V as VinaverseClientError, z as VinaverseSession, B as WebSocketFactory, D as WebSocketLike, E as cardActionSse, G as components, i as isKnownCard, I as operations, J as paths, K as sseFrames, L as turnSse } from './session-lPGrKdhf.cjs';
 
 /**
  * The client secret, checked: an app holds only the session's `vv_cs_` secret, which the tenant's backend got from

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { C as CONTRACT } from './contract-Be2oVHNr.js';
-export { A as AnswerInput, h as AuthMode, a as Card, d as CardKind, e as ClientErrorCode, j as ClientEvent, k as ClientSecret, l as Connection, m as ConversationEngine, n as ConversationState, F as FetchLike, o as Frame, H as HeldCard, f as HeldQuestion, M as Message, P as Proposal, g as ProposalOutcome, Q as Question, R as Reconnect, S as Schemas, p as ServerEvent, q as ServerEventOf, r as ServerEventType, s as SessionEvents, t as SessionInfo, u as SessionOptions, v as SessionStatus, w as SseTarget, T as ToolLine, x as TranscriptItem, y as TurnInput, V as VinaverseClientError, z as VinaverseSession, B as WebSocketFactory, D as WebSocketLike, E as cardActionSse, G as components, i as isKnownCard, I as operations, J as paths, K as sseFrames, L as turnSse } from './session-D0ijOQX3.js';
+export { A as AnswerInput, h as AuthMode, a as Card, d as CardKind, e as ClientErrorCode, j as ClientEvent, k as ClientSecret, l as Connection, m as ConversationEngine, n as ConversationState, F as FetchLike, o as Frame, H as HeldCard, f as HeldQuestion, M as Message, P as Proposal, g as ProposalOutcome, Q as Question, R as Reconnect, S as Schemas, p as ServerEvent, q as ServerEventOf, r as ServerEventType, s as SessionEvents, t as SessionInfo, u as SessionOptions, v as SessionStatus, w as SseTarget, T as ToolLine, x as TranscriptItem, y as TurnInput, V as VinaverseClientError, z as VinaverseSession, B as WebSocketFactory, D as WebSocketLike, E as cardActionSse, G as components, i as isKnownCard, I as operations, J as paths, K as sseFrames, L as turnSse } from './session-lPGrKdhf.js';
 
 /**
  * The client secret, checked: an app holds only the session's `vv_cs_` secret, which the tenant's backend got from

package/dist/index.js

@@ -1,4 +1,4 @@
 export { CONTRACT } from './chunk-D56MNG3E.js';
-export { ConversationEngine, VinaverseClientError, VinaverseSession, cardActionSse, clientSecret, isKnownCard, sseFrames, turnSse } from './chunk-GWLLUOFY.js';
+export { ConversationEngine, VinaverseClientError, VinaverseSession, cardActionSse, clientSecret, isKnownCard, sseFrames, turnSse } from './chunk-LAB2FPXF.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{runtime-CNgz2_8G.d.ts → runtime-44JlV32O.d.ts}

@@ -1,5 +1,5 @@
-import { S as SessionRequest, b as ConversationSession, C as ConversationStore, f as ConversationPersistence, a as ConversationOptions } from './store-CGRSxVcL.js';
-import { S as Schemas, k as ClientSecret } from './session-D0ijOQX3.js';
+import { S as SessionRequest, b as ConversationSession, C as ConversationStore, f as ConversationPersistence, a as ConversationOptions } from './store-Cjw9YmXA.js';
+import { S as Schemas, k as ClientSecret } from './session-lPGrKdhf.js';
 
 /** Whose conversation: a person (null for a guest), the app's side, the business acted for, and the thread. */
 interface AgentKey {
@@ -22,6 +22,58 @@ interface AgentPlace {
     } | null;
     readonly filters?: ScreenContext['filters'];
 }
+/**
+ * The object a conversation is about, as the contract's anchor names it (vinaverse-v1 v1-draft.37 `createSession.anchor`,
+ * contracts#86): its type and id. The tenant's backend builds the anchor itself, from its own reads.
+ */
+interface AgentAnchorRef {
+    readonly type: AgentAnchorType;
+    readonly id: string;
+}
+/** The contract's closed list of objects a conversation can be about (`AnchorType`). */
+type AgentAnchorType = 'booking' | 'rental' | 'professional' | 'workspace' | 'service' | 'class' | 'policy';
+/** The anchor reference for an object, or null when its type is not the contract's or its id not a tool id. */
+declare function anchorRef(type: string, id: string): AgentAnchorRef | null;
+/**
+ * An entry label as the contract takes it (`SessionEntry.label`): trimmed, at most 60 code points, cut at a whole
+ * character so no accent or emoji is split; undefined when nothing is left. The same rule as the .NET SDK's.
+ */
+declare function entryLabel(label: string): string | undefined;
+/**
+ * How the person came in, as the contract will carry it (`entry_point`, `entry_label`): `ask_about` from an "ask about
+ * this" row, with the app's own word for analytics (`label`, at most 64 characters).
+ */
+interface AgentEntry {
+    readonly point: 'ask_about' | (string & Record<never, never>);
+    readonly label?: string;
+}
+/**
+ * The object as the screen the person just left showed it: drawn, marked provisional, until the agent's verified card
+ * arrives. Never sent.
+ */
+interface AgentPlacePreview {
+    readonly title: string;
+    readonly image_url?: string;
+    readonly kind?: string;
+}
+/** A place at one of the app's objects (a booking, a professional, a space), where "ask about this" opens a conversation. */
+interface AskAboutPlace extends AgentPlace {
+    readonly entity: {
+        readonly type: string;
+        readonly id: string;
+    };
+    readonly preview?: AgentPlacePreview;
+}
+/**
+ * The key of the conversation about one object: the app's key (its person, mode and business as they are), on a thread
+ * of the object's own (`ask:<type>:<id>`), so each object gets its own conversation and the app's main one is left alone.
+ */
+declare function askAboutKey(key: AgentKey, place: {
+    readonly entity: {
+        readonly type: string;
+        readonly id: string;
+    };
+}): AgentKey;
 /** How the person came in: the kit's parts say `launcher` and `ask`; an app adds `deep_link` or its own words. */
 type AgentEntryPoint = 'launcher' | 'ask' | 'deep_link' | (string & Record<never, never>);
 /** What the runtime asks the tenant's backend for: a session, for this key, told this place. */
@@ -44,6 +96,10 @@ interface AgentSessionRequest extends SessionRequest {
     readonly placeRevision: number;
     /** How the person came in (`launcher`, `ask`, `deep_link`, the app's own words), passed through. */
     readonly entryPoint: AgentEntryPoint | null;
+    /** The object the conversation is about; only with `sendAnchor`. */
+    readonly anchor?: AgentAnchorRef;
+    /** How the person came in, in the contract's words; only with `sendAnchor`. */
+    readonly entry?: AgentEntry;
 }
 /** Why there is no session, typed, so an app never needs sentinel errors of its own. */
 type AgentFailureReason = 
@@ -198,6 +254,15 @@ interface AgentConversationState {
     /** The open the backend could not settle (`unknown_open`), for support; null otherwise. */
     readonly openId: string | null;
 }
+/** Where and how a view opens a conversation. `undefined` keeps what was told; `null` clears it. */
+interface AgentOpen {
+    readonly place?: AgentPlace | null;
+    readonly entryPoint?: AgentEntryPoint | null;
+    /** The object the conversation is about; sent only with `sendAnchor`. */
+    readonly anchor?: AgentAnchorRef | null;
+    /** How the person came in, in the contract's words; sent only with `sendAnchor`. */
+    readonly entry?: AgentEntry | null;
+}
 interface AgentConversation {
     /** The key as a string, for the app's own maps and the events. */
     readonly key: string;
@@ -208,18 +273,12 @@ interface AgentConversation {
      * (`keepAlive: 'session'`), and let go when it has none, is past its end, or `keepAlive` is `'view'`. Separate from the
      * app's background, which the platform adapter tells the store.
      */
-    show(open?: {
-        readonly place?: AgentPlace | null;
-        readonly entryPoint?: AgentEntryPoint | null;
-    }): () => void;
+    show(open?: AgentOpen): () => void;
     /**
      * The place and the way in changed while a view is attached: told live where the backend can, else on the next
      * session. `undefined` keeps what was told; `null` clears it.
      */
-    tell(open: {
-        readonly place?: AgentPlace | null;
-        readonly entryPoint?: AgentEntryPoint | null;
-    }): void;
+    tell(open: AgentOpen): void;
     getState(): AgentConversationState;
     subscribe(listener: () => void): () => void;
     /** Asks for a session again, after the backend could not be reached. */
@@ -261,6 +320,12 @@ interface AgentRuntimeOptions {
     readonly clock?: AgentClock;
     /** `session` (default): kept while its session lives with no view attached; `view`: let go when the last view goes. */
     readonly keepAlive?: 'session' | 'view';
+    /**
+     * How long a conversation no view shows stays connected before it is suspended, so a quick reopen (back, then in
+     * again) is instant: no reconnect, no new secret. Default 60 s; 0 suspends at once. The app going to the background
+     * ends the grace at once (`background()`).
+     */
+    readonly graceMs?: number;
     /** How long a status read stays fresh. Default 5 minutes. */
     readonly statusStaleMs?: number;
     /**
@@ -283,6 +348,11 @@ interface AgentRuntimeOptions {
     readonly legacyKeys?: readonly string[];
     /** Where the runtime's warnings go (the app's logger, crash reporter); default `console.warn`. */
     readonly onWarning?: (message: string, warning: AgentWarning) => void;
+    /**
+     * Sends `anchor` and `entry` in the session request, for the tenant's backend to pass on once the gateway reads them
+     * (vinaverse-v1 v1-draft.37, contracts#86). Default false: kept with the conversation, never sent.
+     */
+    readonly sendAnchor?: boolean;
 }
 /**
  * What a warning is about, for an app's logger to count without reading the message: `insecure_addresses` (a leg let
@@ -290,7 +360,7 @@ interface AgentRuntimeOptions {
  * `callback` names it), `events_dropped` (the oldest analytics events, while the salt is read).
  */
 interface AgentWarning {
-    readonly code: 'insecure_addresses' | 'callback_threw' | 'events_dropped';
+    readonly code: 'insecure_addresses' | 'callback_threw' | 'events_dropped' | 'context_refused';
     readonly callback?: 'onEvent' | 'onActivity';
 }
 /** The legs whose session address may be plaintext: `realtime` (the WebSocket), `turns` (HTTP). */
@@ -322,6 +392,11 @@ interface AgentRuntime {
     forget(key: AgentKey): void;
     /** Ends every conversation no view shows that is past its session's end. The kits call it when the app comes back. */
     sweep(): void;
+    /**
+     * The app went to the background: every conversation no view shows is suspended now, its grace cut short (its socket
+     * closes with `closeInBackground`). The kits' parts call it; an app with none mounted calls it from its own listener.
+     */
+    background(): void;
     /**
      * History's delete: the backend deletes the conversation, then the device forgets it, only where the key still
      * continues that conversation (an older history entry never forgets the key's newer one).
@@ -361,8 +436,11 @@ interface AgentRuntime {
      * older one (a history page, a transcript) is dropped when it lands.
      */
     epoch(): number;
-    /** The agent's name: from the newest session, else from the status. */
-    getName(): string | null;
+    /**
+     * The agent's name: from the newest session, else from the status. With `mode`, only that mode's sessions count: a
+     * business agent's name never names the customer side's agent.
+     */
+    getName(mode?: string): string | null;
     /** Told when the status or name changes, and when a key's conversation is let go (its next one is another). */
     subscribe(listener: () => void): () => void;
     /** An event from a kit or the app, passed to `onEvent`. */
@@ -391,4 +469,4 @@ declare function createAgentRuntime(options: AgentRuntimeOptions): AgentRuntime;
  */
 declare function isRefusal(error: unknown): error is AgentRefusal;
 
-export { type AgentBackend as A, type AgentClock as a, type AgentConversation as b, type AgentConversationState as c, type AgentEntryPoint as d, type AgentEvent as e, type AgentEventType as f, type AgentFailure as g, type AgentFailureReason as h, type AgentInsecureAddresses as i, type AgentKey as j, type AgentPlace as k, type AgentRating as l, AgentRefusal as m, type AgentRetryPolicy as n, type AgentRuntime as o, type AgentRuntimeOptions as p, type AgentSessionRequest as q, type AgentStatus as r, type AgentStatusRead as s, type AgentStatusState as t, type AgentWarning as u, agentKey as v, createAgentRuntime as w, greetedKey as x, hashKey as y, isRefusal as z };
+export { type AgentAnchorRef as A, type AskAboutPlace as B, agentKey as C, anchorRef as D, askAboutKey as E, createAgentRuntime as F, entryLabel as G, greetedKey as H, hashKey as I, isRefusal as J, type AgentAnchorType as a, type AgentBackend as b, type AgentClock as c, type AgentConversation as d, type AgentConversationState as e, type AgentEntry as f, type AgentEntryPoint as g, type AgentEvent as h, type AgentEventType as i, type AgentFailure as j, type AgentFailureReason as k, type AgentInsecureAddresses as l, type AgentKey as m, type AgentOpen as n, type AgentPlace as o, type AgentPlacePreview as p, type AgentRating as q, AgentRefusal as r, type AgentRetryPolicy as s, type AgentRuntime as t, type AgentRuntimeOptions as u, type AgentSessionRequest as v, type AgentStatus as w, type AgentStatusRead as x, type AgentStatusState as y, type AgentWarning as z };

package/dist/{runtime-6O0qIPmo.d.cts → runtime-DWiB-XHX.d.cts}

@@ -1,5 +1,5 @@
-import { S as SessionRequest, b as ConversationSession, C as ConversationStore, f as ConversationPersistence, a as ConversationOptions } from './store-CxoHwd64.cjs';
-import { S as Schemas, k as ClientSecret } from './session-D0ijOQX3.cjs';
+import { S as SessionRequest, b as ConversationSession, C as ConversationStore, f as ConversationPersistence, a as ConversationOptions } from './store-D-an5vch.cjs';
+import { S as Schemas, k as ClientSecret } from './session-lPGrKdhf.cjs';
 
 /** Whose conversation: a person (null for a guest), the app's side, the business acted for, and the thread. */
 interface AgentKey {
@@ -22,6 +22,58 @@ interface AgentPlace {
     } | null;
     readonly filters?: ScreenContext['filters'];
 }
+/**
+ * The object a conversation is about, as the contract's anchor names it (vinaverse-v1 v1-draft.37 `createSession.anchor`,
+ * contracts#86): its type and id. The tenant's backend builds the anchor itself, from its own reads.
+ */
+interface AgentAnchorRef {
+    readonly type: AgentAnchorType;
+    readonly id: string;
+}
+/** The contract's closed list of objects a conversation can be about (`AnchorType`). */
+type AgentAnchorType = 'booking' | 'rental' | 'professional' | 'workspace' | 'service' | 'class' | 'policy';
+/** The anchor reference for an object, or null when its type is not the contract's or its id not a tool id. */
+declare function anchorRef(type: string, id: string): AgentAnchorRef | null;
+/**
+ * An entry label as the contract takes it (`SessionEntry.label`): trimmed, at most 60 code points, cut at a whole
+ * character so no accent or emoji is split; undefined when nothing is left. The same rule as the .NET SDK's.
+ */
+declare function entryLabel(label: string): string | undefined;
+/**
+ * How the person came in, as the contract will carry it (`entry_point`, `entry_label`): `ask_about` from an "ask about
+ * this" row, with the app's own word for analytics (`label`, at most 64 characters).
+ */
+interface AgentEntry {
+    readonly point: 'ask_about' | (string & Record<never, never>);
+    readonly label?: string;
+}
+/**
+ * The object as the screen the person just left showed it: drawn, marked provisional, until the agent's verified card
+ * arrives. Never sent.
+ */
+interface AgentPlacePreview {
+    readonly title: string;
+    readonly image_url?: string;
+    readonly kind?: string;
+}
+/** A place at one of the app's objects (a booking, a professional, a space), where "ask about this" opens a conversation. */
+interface AskAboutPlace extends AgentPlace {
+    readonly entity: {
+        readonly type: string;
+        readonly id: string;
+    };
+    readonly preview?: AgentPlacePreview;
+}
+/**
+ * The key of the conversation about one object: the app's key (its person, mode and business as they are), on a thread
+ * of the object's own (`ask:<type>:<id>`), so each object gets its own conversation and the app's main one is left alone.
+ */
+declare function askAboutKey(key: AgentKey, place: {
+    readonly entity: {
+        readonly type: string;
+        readonly id: string;
+    };
+}): AgentKey;
 /** How the person came in: the kit's parts say `launcher` and `ask`; an app adds `deep_link` or its own words. */
 type AgentEntryPoint = 'launcher' | 'ask' | 'deep_link' | (string & Record<never, never>);
 /** What the runtime asks the tenant's backend for: a session, for this key, told this place. */
@@ -44,6 +96,10 @@ interface AgentSessionRequest extends SessionRequest {
     readonly placeRevision: number;
     /** How the person came in (`launcher`, `ask`, `deep_link`, the app's own words), passed through. */
     readonly entryPoint: AgentEntryPoint | null;
+    /** The object the conversation is about; only with `sendAnchor`. */
+    readonly anchor?: AgentAnchorRef;
+    /** How the person came in, in the contract's words; only with `sendAnchor`. */
+    readonly entry?: AgentEntry;
 }
 /** Why there is no session, typed, so an app never needs sentinel errors of its own. */
 type AgentFailureReason = 
@@ -198,6 +254,15 @@ interface AgentConversationState {
     /** The open the backend could not settle (`unknown_open`), for support; null otherwise. */
     readonly openId: string | null;
 }
+/** Where and how a view opens a conversation. `undefined` keeps what was told; `null` clears it. */
+interface AgentOpen {
+    readonly place?: AgentPlace | null;
+    readonly entryPoint?: AgentEntryPoint | null;
+    /** The object the conversation is about; sent only with `sendAnchor`. */
+    readonly anchor?: AgentAnchorRef | null;
+    /** How the person came in, in the contract's words; sent only with `sendAnchor`. */
+    readonly entry?: AgentEntry | null;
+}
 interface AgentConversation {
     /** The key as a string, for the app's own maps and the events. */
     readonly key: string;
@@ -208,18 +273,12 @@ interface AgentConversation {
      * (`keepAlive: 'session'`), and let go when it has none, is past its end, or `keepAlive` is `'view'`. Separate from the
      * app's background, which the platform adapter tells the store.
      */
-    show(open?: {
-        readonly place?: AgentPlace | null;
-        readonly entryPoint?: AgentEntryPoint | null;
-    }): () => void;
+    show(open?: AgentOpen): () => void;
     /**
      * The place and the way in changed while a view is attached: told live where the backend can, else on the next
      * session. `undefined` keeps what was told; `null` clears it.
      */
-    tell(open: {
-        readonly place?: AgentPlace | null;
-        readonly entryPoint?: AgentEntryPoint | null;
-    }): void;
+    tell(open: AgentOpen): void;
     getState(): AgentConversationState;
     subscribe(listener: () => void): () => void;
     /** Asks for a session again, after the backend could not be reached. */
@@ -261,6 +320,12 @@ interface AgentRuntimeOptions {
     readonly clock?: AgentClock;
     /** `session` (default): kept while its session lives with no view attached; `view`: let go when the last view goes. */
     readonly keepAlive?: 'session' | 'view';
+    /**
+     * How long a conversation no view shows stays connected before it is suspended, so a quick reopen (back, then in
+     * again) is instant: no reconnect, no new secret. Default 60 s; 0 suspends at once. The app going to the background
+     * ends the grace at once (`background()`).
+     */
+    readonly graceMs?: number;
     /** How long a status read stays fresh. Default 5 minutes. */
     readonly statusStaleMs?: number;
     /**
@@ -283,6 +348,11 @@ interface AgentRuntimeOptions {
     readonly legacyKeys?: readonly string[];
     /** Where the runtime's warnings go (the app's logger, crash reporter); default `console.warn`. */
     readonly onWarning?: (message: string, warning: AgentWarning) => void;
+    /**
+     * Sends `anchor` and `entry` in the session request, for the tenant's backend to pass on once the gateway reads them
+     * (vinaverse-v1 v1-draft.37, contracts#86). Default false: kept with the conversation, never sent.
+     */
+    readonly sendAnchor?: boolean;
 }
 /**
  * What a warning is about, for an app's logger to count without reading the message: `insecure_addresses` (a leg let
@@ -290,7 +360,7 @@ interface AgentRuntimeOptions {
  * `callback` names it), `events_dropped` (the oldest analytics events, while the salt is read).
  */
 interface AgentWarning {
-    readonly code: 'insecure_addresses' | 'callback_threw' | 'events_dropped';
+    readonly code: 'insecure_addresses' | 'callback_threw' | 'events_dropped' | 'context_refused';
     readonly callback?: 'onEvent' | 'onActivity';
 }
 /** The legs whose session address may be plaintext: `realtime` (the WebSocket), `turns` (HTTP). */
@@ -322,6 +392,11 @@ interface AgentRuntime {
     forget(key: AgentKey): void;
     /** Ends every conversation no view shows that is past its session's end. The kits call it when the app comes back. */
     sweep(): void;
+    /**
+     * The app went to the background: every conversation no view shows is suspended now, its grace cut short (its socket
+     * closes with `closeInBackground`). The kits' parts call it; an app with none mounted calls it from its own listener.
+     */
+    background(): void;
     /**
      * History's delete: the backend deletes the conversation, then the device forgets it, only where the key still
      * continues that conversation (an older history entry never forgets the key's newer one).
@@ -361,8 +436,11 @@ interface AgentRuntime {
      * older one (a history page, a transcript) is dropped when it lands.
      */
     epoch(): number;
-    /** The agent's name: from the newest session, else from the status. */
-    getName(): string | null;
+    /**
+     * The agent's name: from the newest session, else from the status. With `mode`, only that mode's sessions count: a
+     * business agent's name never names the customer side's agent.
+     */
+    getName(mode?: string): string | null;
     /** Told when the status or name changes, and when a key's conversation is let go (its next one is another). */
     subscribe(listener: () => void): () => void;
     /** An event from a kit or the app, passed to `onEvent`. */
@@ -391,4 +469,4 @@ declare function createAgentRuntime(options: AgentRuntimeOptions): AgentRuntime;
  */
 declare function isRefusal(error: unknown): error is AgentRefusal;
 
-export { type AgentBackend as A, type AgentClock as a, type AgentConversation as b, type AgentConversationState as c, type AgentEntryPoint as d, type AgentEvent as e, type AgentEventType as f, type AgentFailure as g, type AgentFailureReason as h, type AgentInsecureAddresses as i, type AgentKey as j, type AgentPlace as k, type AgentRating as l, AgentRefusal as m, type AgentRetryPolicy as n, type AgentRuntime as o, type AgentRuntimeOptions as p, type AgentSessionRequest as q, type AgentStatus as r, type AgentStatusRead as s, type AgentStatusState as t, type AgentWarning as u, agentKey as v, createAgentRuntime as w, greetedKey as x, hashKey as y, isRefusal as z };
+export { type AgentAnchorRef as A, type AskAboutPlace as B, agentKey as C, anchorRef as D, askAboutKey as E, createAgentRuntime as F, entryLabel as G, greetedKey as H, hashKey as I, isRefusal as J, type AgentAnchorType as a, type AgentBackend as b, type AgentClock as c, type AgentConversation as d, type AgentConversationState as e, type AgentEntry as f, type AgentEntryPoint as g, type AgentEvent as h, type AgentEventType as i, type AgentFailure as j, type AgentFailureReason as k, type AgentInsecureAddresses as l, type AgentKey as m, type AgentOpen as n, type AgentPlace as o, type AgentPlacePreview as p, type AgentRating as q, AgentRefusal as r, type AgentRetryPolicy as s, type AgentRuntime as t, type AgentRuntimeOptions as u, type AgentSessionRequest as v, type AgentStatus as w, type AgentStatusRead as x, type AgentStatusState as y, type AgentWarning as z };

package/dist/{session-D0ijOQX3.d.ts → session-lPGrKdhf.d.cts}

@@ -3326,6 +3326,8 @@ interface Message {
     readonly received?: true;
     /** The agent's reply is a guardrail refusal (`input.rejected` `guardrail`, its `message`). */
     readonly refusal?: true;
+    /** When it was said (ISO 8601): the server's time where the event or transcript gives one, else when it arrived. */
+    readonly at: string;
 }
 /** A person from the business is replying (`takeover.started`); `by` is their role as the person sees it. */
 interface Takeover {
@@ -3418,6 +3420,9 @@ interface ConversationState {
     readonly turnsLeft: number | null;
 }
 declare class ConversationEngine {
+    private readonly now;
+    /** `now`: the clock a message is stamped by when the server gives no time. */
+    constructor(now?: () => number);
     private sessionId;
     private conversationId;
     private connection;

package/dist/{session-D0ijOQX3.d.cts → session-lPGrKdhf.d.ts}

@@ -3326,6 +3326,8 @@ interface Message {
     readonly received?: true;
     /** The agent's reply is a guardrail refusal (`input.rejected` `guardrail`, its `message`). */
     readonly refusal?: true;
+    /** When it was said (ISO 8601): the server's time where the event or transcript gives one, else when it arrived. */
+    readonly at: string;
 }
 /** A person from the business is replying (`takeover.started`); `by` is their role as the person sees it. */
 interface Takeover {
@@ -3418,6 +3420,9 @@ interface ConversationState {
     readonly turnsLeft: number | null;
 }
 declare class ConversationEngine {
+    private readonly now;
+    /** `now`: the clock a message is stamped by when the server gives no time. */
+    constructor(now?: () => number);
     private sessionId;
     private conversationId;
     private connection;

package/dist/{store-CGRSxVcL.d.ts → store-Cjw9YmXA.d.ts}

@@ -1,4 +1,4 @@
-import { W as Welcome, H as HeldCard, T as ToolLine, t as SessionInfo, k as ClientSecret, u as SessionOptions, A as AnswerInput, g as ProposalOutcome } from './session-D0ijOQX3.js';
+import { W as Welcome, H as HeldCard, T as ToolLine, t as SessionInfo, k as ClientSecret, u as SessionOptions, A as AnswerInput, g as ProposalOutcome } from './session-lPGrKdhf.js';
 
 type ConversationStatus = 
 /** Asking the tenant's backend for a session. */
@@ -51,6 +51,11 @@ interface MessageItem {
         readonly code: string;
         readonly message: string;
     };
+    /**
+     * When it was said (ISO 8601): the server's time where it gives one (a resumed transcript, history, a business's
+     * reply), else when this device sent or received it. Absent on a message kept by a version before alpha.13.
+     */
+    readonly at?: string;
 }
 interface CardItem {
     readonly type: 'card';

package/dist/{store-CxoHwd64.d.cts → store-D-an5vch.d.cts}

@@ -1,4 +1,4 @@
-import { W as Welcome, H as HeldCard, T as ToolLine, t as SessionInfo, k as ClientSecret, u as SessionOptions, A as AnswerInput, g as ProposalOutcome } from './session-D0ijOQX3.cjs';
+import { W as Welcome, H as HeldCard, T as ToolLine, t as SessionInfo, k as ClientSecret, u as SessionOptions, A as AnswerInput, g as ProposalOutcome } from './session-lPGrKdhf.cjs';
 
 type ConversationStatus = 
 /** Asking the tenant's backend for a session. */
@@ -51,6 +51,11 @@ interface MessageItem {
         readonly code: string;
         readonly message: string;
     };
+    /**
+     * When it was said (ISO 8601): the server's time where it gives one (a resumed transcript, history, a business's
+     * reply), else when this device sent or received it. Absent on a message kept by a version before alpha.13.
+     */
+    readonly at?: string;
 }
 interface CardItem {
     readonly type: 'card';