@smart-cloud/ai-kit-ui 1.5.41 → 1.5.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,9 @@
1
+ import type { ConfirmedVisitorAction } from "@smart-cloud/ai-kit-core";
2
+ export declare function VisitorActions({ proposals: input, result: inputResult, busy, consumedHandles, retryDisabled, onConfirm }: {
3
+ proposals?: unknown;
4
+ result?: unknown;
5
+ busy?: boolean;
6
+ consumedHandles?: readonly string[];
7
+ retryDisabled?: boolean;
8
+ onConfirm: (action: ConfirmedVisitorAction, label: string) => void;
9
+ }): import("react").JSX.Element;
@@ -2,6 +2,8 @@ import { type AnswerEntity, type AnswerPresentation } from "@smart-cloud/ai-kit-
2
2
  /** Browser storage and transport values are untrusted, including old history. */
3
3
  export declare function normalizeAnswerPresentation(value: unknown): AnswerPresentation | undefined;
4
4
  export declare function answerAttributeText(attribute: AnswerEntity["attributes"][number], locale?: string): string | undefined;
5
+ /** Optional display metadata never replaces the exact source-backed plain fallback. */
6
+ export declare function answerAttributeMarkdown(attribute: AnswerEntity["attributes"][number]): string | string[] | undefined;
5
7
  /** Join source-backed attribute IDs only; conflicting row contracts are never guessed. */
6
8
  export declare function answerComparisonRows(entities: AnswerEntity[]): AnswerEntity["attributes"];
7
9
  /** Retain only a validated envelope when crossing a history boundary. */
@@ -1,4 +1,4 @@
1
- import { type ProcessedCitations, type PromptResult, type AnswerPresentation } from "@smart-cloud/ai-kit-core";
1
+ import { type ConfirmedVisitorAction, type VisitorActionProposal, type VisitorActionResult, type ProcessedCitations, type PromptResult, type AnswerPresentation } from "@smart-cloud/ai-kit-core";
2
2
  export type ChatActivity = {
3
3
  activityId: string;
4
4
  kind: "knowledge_search" | "web_search" | "web_read" | "calculation" | "script" | "validation" | "thinking" | "generating_response" | "checking_sources" | "other";
@@ -24,6 +24,8 @@ export type ChatStreamCheckpoint = {
24
24
  };
25
25
  export type ChatStreamView = {
26
26
  text: string;
27
+ visitorActions?: VisitorActionProposal[];
28
+ visitorActionResult?: VisitorActionResult;
27
29
  presentation?: AnswerPresentation;
28
30
  activities: ChatActivity[];
29
31
  citations: StreamCitation[];
@@ -39,6 +41,8 @@ export type StreamCitation = {
39
41
  };
40
42
  export type ChatStreamResult = {
41
43
  result: string;
44
+ visitorActions?: VisitorActionProposal[];
45
+ visitorActionResult?: VisitorActionResult;
42
46
  presentation?: AnswerPresentation;
43
47
  sessionId: string;
44
48
  messageId?: string;
@@ -56,10 +60,12 @@ export type ChatStreamOptions = {
56
60
  text: string;
57
61
  locale: string;
58
62
  /** Selected only after a verified backend capability advertises this schema. */
59
- presentationVersion?: 1 | 2;
63
+ presentationVersion?: 1 | 2 | 3;
60
64
  /** Selected only after verified ai.catalog.pagination capability discovery; handles contain no client-selected queries. */
61
65
  catalogPageVersion?: 1;
62
66
  catalogContinuation?: string;
67
+ visitorActionVersion?: 1;
68
+ visitorAction?: ConfirmedVisitorAction;
63
69
  sessionId?: string;
64
70
  requestId: string;
65
71
  resume?: ChatStreamCheckpoint;
@@ -96,10 +102,12 @@ export declare function summarizeChatActivities(activities: ChatActivity[]): {
96
102
  websites: number;
97
103
  otherTools: number;
98
104
  };
99
- export declare function chatPresentationVersionForCapabilities(capabilities?: Record<string, unknown>): 1 | 2;
105
+ export declare function chatPresentationVersionForCapabilities(capabilities?: Record<string, unknown>): 1 | 2 | 3;
100
106
  export declare function chatCatalogPageVersionForCapabilities(capabilities?: Record<string, unknown>): 1 | undefined;
107
+ export declare function chatVisitorActionVersionForCapabilities(capabilities?: Record<string, unknown>): 1 | undefined;
108
+ export declare function discoverChatVisitorActionVersion(): Promise<1 | undefined>;
101
109
  /** The same negotiation applies to HTTP prompts and every stream resume frame. */
102
- export declare function discoverChatPresentationVersion(): Promise<1 | 2>;
110
+ export declare function discoverChatPresentationVersion(): Promise<1 | 2 | 3>;
103
111
  /** Older or unverified backends must never receive the new catalog request fields. */
104
112
  export declare function discoverChatCatalogPageVersion(): Promise<1 | undefined>;
105
113
  /** The backend advertises streaming only when its WebSocket route is ready. */
@@ -1,2 +1,3 @@
1
1
  export { AiChatbot, DEFAULT_CHATBOT_LABELS } from "./AiChatbot";
2
2
  export { AnswerPresentationView } from "./AnswerPresentation";
3
+ export { VisitorActions } from "./VisitorActions";
@@ -0,0 +1,19 @@
1
+ import { parseVisitorActionResult, type VisitorActionProposal, type VisitorActionResult, type ConfirmedVisitorAction } from "@smart-cloud/ai-kit-core";
2
+ /** Transport and persisted history cross the same bounded consent boundary. */
3
+ export declare function normalizeVisitorActions(value: unknown): VisitorActionProposal[] | undefined;
4
+ export { parseVisitorActionResult as normalizeVisitorActionResult };
5
+ /** Form values live only in component state and in this explicit outbound request. */
6
+ export declare function confirmedVisitorAction(proposalValue: unknown, input: Record<string, string>, options?: {
7
+ busy?: boolean;
8
+ consumed?: boolean;
9
+ now?: number;
10
+ }): ConfirmedVisitorAction | undefined;
11
+ /** Never serialize a confirmation request or its input values into chat history. */
12
+ export declare function withSafeVisitorActions<T extends {
13
+ visitorActions?: unknown;
14
+ visitorActionResult?: unknown;
15
+ visitorAction?: unknown;
16
+ }>(value: T): Omit<T, "visitorActions" | "visitorActionResult" | "visitorAction"> & {
17
+ visitorActions?: VisitorActionProposal[];
18
+ visitorActionResult?: VisitorActionResult;
19
+ };
@@ -1456,3 +1456,37 @@
1456
1456
  .ai-kit-audio-player::-webkit-media-controls-time-remaining-display {
1457
1457
  border-radius: 0;
1458
1458
  }
1459
+
1460
+ .ai-visitor-actions { min-width: 0; width: 100%; }
1461
+ .ai-visitor-action, .ai-visitor-action-result {
1462
+ box-sizing: border-box; min-width: 0; margin-block: .75rem; padding: 1rem;
1463
+ border: 1px solid var(--ai-kit-chat-border-color, #d9dfe8);
1464
+ border-radius: var(--ai-kit-radius-sm, .75rem); overflow-wrap: anywhere;
1465
+ }
1466
+ .ai-visitor-action h3, .ai-visitor-action-result h3 { margin: 0 0 .5rem; }
1467
+ .ai-visitor-action p, .ai-visitor-action-result p { margin-block: .5rem; }
1468
+ .ai-visitor-action fieldset { padding: 0; border: 0; min-width: 0; margin: 0; }
1469
+ .ai-visitor-action-summary { max-height: 14rem; overflow-y: auto; margin-block: .75rem; }
1470
+ .ai-visitor-action-summary > div { display: flex; flex-wrap: wrap; gap: .25rem .75rem; margin-block: .4rem; }
1471
+ .ai-visitor-action-summary dt { font-weight: 600; }
1472
+ .ai-visitor-action-summary dd { margin: 0; min-width: 0; }
1473
+ .ai-visitor-action-field { display: flex; flex-direction: column; gap: .3rem; margin-block: .75rem; min-width: 0; }
1474
+ .ai-visitor-action-field label { font-weight: 600; }
1475
+ .ai-visitor-action-field input {
1476
+ box-sizing: border-box; width: 100%; min-width: 0; min-height: 2.75rem; padding: .5rem .75rem;
1477
+ color: inherit; background: var(--ai-kit-chat-background-color, transparent);
1478
+ border: 1px solid var(--ai-kit-chat-border-color, #d9dfe8); border-radius: var(--ai-kit-radius-sm, .75rem);
1479
+ font: inherit;
1480
+ }
1481
+ .ai-visitor-action-buttons { display: flex; flex-wrap: wrap; gap: .5rem; }
1482
+ .ai-visitor-action-buttons button {
1483
+ box-sizing: border-box; min-height: 2.75rem; max-width: 100%; padding: .5rem .875rem; font: inherit;
1484
+ border: 1px solid var(--ai-kit-color-primary, #1c7ed6); border-radius: var(--ai-kit-radius-sm, .75rem);
1485
+ background: var(--ai-kit-color-primary, #1c7ed6); color: var(--ai-kit-color-primary-contrast, #fff);
1486
+ font-weight: 600; cursor: pointer; overflow-wrap: anywhere;
1487
+ }
1488
+ .ai-visitor-action-buttons button[type="button"] { color: var(--ai-kit-color-primary, #1c7ed6); background: transparent; }
1489
+ .ai-visitor-action input:focus-visible, .ai-visitor-action-buttons button:focus-visible { outline: 2px solid var(--ai-kit-color-primary, #1c7ed6); outline-offset: 2px; }
1490
+ .ai-visitor-action-buttons button:disabled { opacity: .65; cursor: not-allowed; }
1491
+ .ai-visitor-action fieldset:disabled { opacity: .65; }
1492
+ .ai-visitor-action fieldset:disabled button { cursor: not-allowed; }