@wix/auto_sdk_forms_interactive-form-sessions 1.0.0
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.
- package/build/cjs/index.d.ts +56 -0
- package/build/cjs/index.js +538 -0
- package/build/cjs/index.js.map +1 -0
- package/build/cjs/index.typings.d.ts +1082 -0
- package/build/cjs/index.typings.js +489 -0
- package/build/cjs/index.typings.js.map +1 -0
- package/build/cjs/meta.d.ts +494 -0
- package/build/cjs/meta.js +357 -0
- package/build/cjs/meta.js.map +1 -0
- package/build/es/index.d.mts +56 -0
- package/build/es/index.mjs +505 -0
- package/build/es/index.mjs.map +1 -0
- package/build/es/index.typings.d.mts +1082 -0
- package/build/es/index.typings.mjs +456 -0
- package/build/es/index.typings.mjs.map +1 -0
- package/build/es/meta.d.mts +494 -0
- package/build/es/meta.mjs +326 -0
- package/build/es/meta.mjs.map +1 -0
- package/build/es/package.json +3 -0
- package/build/internal/cjs/index.d.ts +56 -0
- package/build/internal/cjs/index.js +538 -0
- package/build/internal/cjs/index.js.map +1 -0
- package/build/internal/cjs/index.typings.d.ts +1082 -0
- package/build/internal/cjs/index.typings.js +489 -0
- package/build/internal/cjs/index.typings.js.map +1 -0
- package/build/internal/cjs/meta.d.ts +494 -0
- package/build/internal/cjs/meta.js +357 -0
- package/build/internal/cjs/meta.js.map +1 -0
- package/build/internal/es/index.d.mts +56 -0
- package/build/internal/es/index.mjs +505 -0
- package/build/internal/es/index.mjs.map +1 -0
- package/build/internal/es/index.typings.d.mts +1082 -0
- package/build/internal/es/index.typings.mjs +456 -0
- package/build/internal/es/index.typings.mjs.map +1 -0
- package/build/internal/es/meta.d.mts +494 -0
- package/build/internal/es/meta.mjs +326 -0
- package/build/internal/es/meta.mjs.map +1 -0
- package/meta/package.json +3 -0
- package/package.json +54 -0
|
@@ -0,0 +1,1082 @@
|
|
|
1
|
+
import { NonNullablePaths } from '@wix/sdk-types';
|
|
2
|
+
|
|
3
|
+
interface InteractiveFormSession {
|
|
4
|
+
/**
|
|
5
|
+
* Form completion id
|
|
6
|
+
* @format GUID
|
|
7
|
+
* @readonly
|
|
8
|
+
*/
|
|
9
|
+
_id?: string;
|
|
10
|
+
/**
|
|
11
|
+
* Form id to complete
|
|
12
|
+
* @format GUID
|
|
13
|
+
*/
|
|
14
|
+
formId?: string;
|
|
15
|
+
}
|
|
16
|
+
interface CreateInteractiveFormSessionRequest {
|
|
17
|
+
/**
|
|
18
|
+
* Interactive form session to be created.
|
|
19
|
+
* @format GUID
|
|
20
|
+
*/
|
|
21
|
+
formId: string;
|
|
22
|
+
/**
|
|
23
|
+
* ID of the prompt to use.
|
|
24
|
+
* @format GUID
|
|
25
|
+
*/
|
|
26
|
+
promptId?: string | null;
|
|
27
|
+
/**
|
|
28
|
+
* Sets current values for the form fields, used to pre-fill the form (e.g. when switching from classic form to chat form).
|
|
29
|
+
* These values are merged with existing values in the session.
|
|
30
|
+
* For example, if user has already filled field "Name" and then sends a message with current_values containing
|
|
31
|
+
* "LastName" field, "Name" will remain unchanged. If user sends a message with current_values containing "Name" field,
|
|
32
|
+
* it will override the existing value.
|
|
33
|
+
*/
|
|
34
|
+
currentValues?: Record<string, any> | null;
|
|
35
|
+
/**
|
|
36
|
+
* Dry run mode. The completion will not conduct submission if set to true. Intended for preview mode.
|
|
37
|
+
* @immutable
|
|
38
|
+
*/
|
|
39
|
+
dryRun?: boolean;
|
|
40
|
+
/**
|
|
41
|
+
* Current date-time string with user's timezone offset in ISO 8601 format (e.g. "2023-10-01T12:00:00+03:00").
|
|
42
|
+
* @minLength 1
|
|
43
|
+
* @maxLength 200
|
|
44
|
+
*/
|
|
45
|
+
currentTime?: string | null;
|
|
46
|
+
/** Current date-time of api client */
|
|
47
|
+
clientTime?: ClientTime;
|
|
48
|
+
}
|
|
49
|
+
interface ClientTime {
|
|
50
|
+
/**
|
|
51
|
+
* Current date-time string UTC in ISO 8601 format (e.g. "2023-10-01T12:00:00Z).
|
|
52
|
+
* @minLength 1
|
|
53
|
+
* @maxLength 200
|
|
54
|
+
*/
|
|
55
|
+
currentTime?: string | null;
|
|
56
|
+
/**
|
|
57
|
+
* Current time zone in format like: "Europe/Vilnius".
|
|
58
|
+
* @minLength 1
|
|
59
|
+
* @maxLength 50
|
|
60
|
+
*/
|
|
61
|
+
timeZone?: string | null;
|
|
62
|
+
}
|
|
63
|
+
interface CreateInteractiveFormSessionResponse {
|
|
64
|
+
/** Interactive form session created */
|
|
65
|
+
interactiveFormSession?: InteractiveFormSession;
|
|
66
|
+
/** Assistant response chunks for the session */
|
|
67
|
+
responseChunks?: InteractiveFormSessionResponseChunk[];
|
|
68
|
+
}
|
|
69
|
+
interface InteractiveFormSessionResponseChunk extends InteractiveFormSessionResponseChunkOfOneOf {
|
|
70
|
+
/** Text chunk to display to the user */
|
|
71
|
+
textDetails?: TextDetails;
|
|
72
|
+
/** Data chunk which was extracted from the user input */
|
|
73
|
+
textDataDetails?: TextDataDetails;
|
|
74
|
+
/** Multi-select input chunk to display to the user */
|
|
75
|
+
multiSelectInputDetails?: MultiSelectInputDetails;
|
|
76
|
+
/** Number input chunk to display to the user */
|
|
77
|
+
numberInputDetails?: NumberInputDetails;
|
|
78
|
+
/** Separator chunk (e.g. paragraph break) */
|
|
79
|
+
separatorDetails?: SeparatorDetails;
|
|
80
|
+
/** Single-select input chunk to display to the user */
|
|
81
|
+
singleSelectInputDetails?: SingleSelectInputDetails;
|
|
82
|
+
/** Exception happened during processing, contains error message and details */
|
|
83
|
+
errorDetails?: ErrorDetails;
|
|
84
|
+
/** Form submission event acknowledgment chunk, contains submission id and checkout id if applicable */
|
|
85
|
+
submissionDetails?: SubmissionDetails;
|
|
86
|
+
/** Important information which might be used to derive TEXT_DATA */
|
|
87
|
+
importantTextDetails?: ImportantTextDetails;
|
|
88
|
+
/** Debug information, what tools were called, what was the input, etc. */
|
|
89
|
+
debugDetails?: DebugDetails;
|
|
90
|
+
/** End of chunk stream, indicates that no more chunks will be sent */
|
|
91
|
+
endOfResponseDetails?: EndOfResponseDetails;
|
|
92
|
+
/** Multi-select input chunk to display to the user */
|
|
93
|
+
fileUploadDetails?: FileUploadDetails;
|
|
94
|
+
/** Multi-select input chunk to display to the user */
|
|
95
|
+
signatureDetails?: SignatureDetails;
|
|
96
|
+
/** Type of the chunk */
|
|
97
|
+
chunkType?: ChunkTypeWithLiterals;
|
|
98
|
+
/** Marks which part of the original user input deemed meaningful by the assistant for extracting the answer. */
|
|
99
|
+
meaningfulInput?: MeaningfulInput;
|
|
100
|
+
}
|
|
101
|
+
/** @oneof */
|
|
102
|
+
interface InteractiveFormSessionResponseChunkOfOneOf {
|
|
103
|
+
/** Text chunk to display to the user */
|
|
104
|
+
textDetails?: TextDetails;
|
|
105
|
+
/** Data chunk which was extracted from the user input */
|
|
106
|
+
textDataDetails?: TextDataDetails;
|
|
107
|
+
/** Multi-select input chunk to display to the user */
|
|
108
|
+
multiSelectInputDetails?: MultiSelectInputDetails;
|
|
109
|
+
/** Number input chunk to display to the user */
|
|
110
|
+
numberInputDetails?: NumberInputDetails;
|
|
111
|
+
/** Separator chunk (e.g. paragraph break) */
|
|
112
|
+
separatorDetails?: SeparatorDetails;
|
|
113
|
+
/** Single-select input chunk to display to the user */
|
|
114
|
+
singleSelectInputDetails?: SingleSelectInputDetails;
|
|
115
|
+
/** Exception happened during processing, contains error message and details */
|
|
116
|
+
errorDetails?: ErrorDetails;
|
|
117
|
+
/** Form submission event acknowledgment chunk, contains submission id and checkout id if applicable */
|
|
118
|
+
submissionDetails?: SubmissionDetails;
|
|
119
|
+
/** Important information which might be used to derive TEXT_DATA */
|
|
120
|
+
importantTextDetails?: ImportantTextDetails;
|
|
121
|
+
/** Debug information, what tools were called, what was the input, etc. */
|
|
122
|
+
debugDetails?: DebugDetails;
|
|
123
|
+
/** End of chunk stream, indicates that no more chunks will be sent */
|
|
124
|
+
endOfResponseDetails?: EndOfResponseDetails;
|
|
125
|
+
/** Multi-select input chunk to display to the user */
|
|
126
|
+
fileUploadDetails?: FileUploadDetails;
|
|
127
|
+
/** Multi-select input chunk to display to the user */
|
|
128
|
+
signatureDetails?: SignatureDetails;
|
|
129
|
+
}
|
|
130
|
+
declare enum ChunkType {
|
|
131
|
+
UNKNOWN_CHUNK_TYPE = "UNKNOWN_CHUNK_TYPE",
|
|
132
|
+
/** Text chunk to display to the user */
|
|
133
|
+
TEXT = "TEXT",
|
|
134
|
+
/** Data chunk which was extracted from the user input */
|
|
135
|
+
TEXT_DATA = "TEXT_DATA",
|
|
136
|
+
/** Multi-select input chunk to display to the user */
|
|
137
|
+
MULTI_SELECT_INPUT = "MULTI_SELECT_INPUT",
|
|
138
|
+
/** Number input chunk to display to the user */
|
|
139
|
+
NUMBER_INPUT = "NUMBER_INPUT",
|
|
140
|
+
SEPARATOR = "SEPARATOR",
|
|
141
|
+
/** Single-select input chunk to display to the user */
|
|
142
|
+
SINGLE_SELECT_INPUT = "SINGLE_SELECT_INPUT",
|
|
143
|
+
/** Exception happened during processing, contains error message and details */
|
|
144
|
+
ERROR = "ERROR",
|
|
145
|
+
/** Form submission event acknowledgment chunk, contains submission id and checkout id if applicable */
|
|
146
|
+
SUBMISSION = "SUBMISSION",
|
|
147
|
+
/** Important information which might be used to derive TEXT_DATA */
|
|
148
|
+
IMPORTANT_TEXT = "IMPORTANT_TEXT",
|
|
149
|
+
/** Debug information, what tools were called, what was the input, etc. */
|
|
150
|
+
DEBUG = "DEBUG",
|
|
151
|
+
/** End of chunk stream, indicates that no more chunks will be sent */
|
|
152
|
+
END_OF_RESPONSE = "END_OF_RESPONSE",
|
|
153
|
+
/** File Upload input chunk to display to the user */
|
|
154
|
+
FILE_UPLOAD = "FILE_UPLOAD",
|
|
155
|
+
/** Signature input chunk to display to the user */
|
|
156
|
+
SIGNATURE = "SIGNATURE"
|
|
157
|
+
}
|
|
158
|
+
/** @enumType */
|
|
159
|
+
type ChunkTypeWithLiterals = ChunkType | 'UNKNOWN_CHUNK_TYPE' | 'TEXT' | 'TEXT_DATA' | 'MULTI_SELECT_INPUT' | 'NUMBER_INPUT' | 'SEPARATOR' | 'SINGLE_SELECT_INPUT' | 'ERROR' | 'SUBMISSION' | 'IMPORTANT_TEXT' | 'DEBUG' | 'END_OF_RESPONSE' | 'FILE_UPLOAD' | 'SIGNATURE';
|
|
160
|
+
interface TextDetails {
|
|
161
|
+
/**
|
|
162
|
+
* Text content to display
|
|
163
|
+
* @minLength 1
|
|
164
|
+
* @maxLength 10000
|
|
165
|
+
*/
|
|
166
|
+
text?: string;
|
|
167
|
+
/** Style of the text (e.g. normal, bold) */
|
|
168
|
+
style?: StyleWithLiterals;
|
|
169
|
+
}
|
|
170
|
+
declare enum Style {
|
|
171
|
+
UNKNOWN_STYLE = "UNKNOWN_STYLE",
|
|
172
|
+
NORMAL = "NORMAL",
|
|
173
|
+
BOLD = "BOLD"
|
|
174
|
+
}
|
|
175
|
+
/** @enumType */
|
|
176
|
+
type StyleWithLiterals = Style | 'UNKNOWN_STYLE' | 'NORMAL' | 'BOLD';
|
|
177
|
+
interface TextDataDetails {
|
|
178
|
+
/**
|
|
179
|
+
* Target field key for the data
|
|
180
|
+
* @minLength 1
|
|
181
|
+
* @maxLength 200
|
|
182
|
+
*/
|
|
183
|
+
fieldTarget?: string;
|
|
184
|
+
/**
|
|
185
|
+
* Text content to display
|
|
186
|
+
* @minLength 1
|
|
187
|
+
* @maxLength 10000
|
|
188
|
+
*/
|
|
189
|
+
text?: string;
|
|
190
|
+
/** "Technical" value used for the form submission, e.g. if it's boolean, value will be `true` or `false` */
|
|
191
|
+
value?: any;
|
|
192
|
+
/**
|
|
193
|
+
* User friendly string to display user's submitted value, e.g. if it's boolean, value will be "Yes" or "No"
|
|
194
|
+
* @minLength 1
|
|
195
|
+
* @maxLength 10000
|
|
196
|
+
*/
|
|
197
|
+
displayValue?: string;
|
|
198
|
+
}
|
|
199
|
+
interface MultiSelectInputDetails {
|
|
200
|
+
/**
|
|
201
|
+
* Field id for the multi-select input
|
|
202
|
+
* @minLength 1
|
|
203
|
+
* @maxLength 200
|
|
204
|
+
*/
|
|
205
|
+
fieldTarget?: string;
|
|
206
|
+
/**
|
|
207
|
+
* Options available for selection
|
|
208
|
+
* @minSize 1
|
|
209
|
+
* @maxSize 100
|
|
210
|
+
*/
|
|
211
|
+
options?: Option[];
|
|
212
|
+
/** If present, then user is allowed to provide custom values */
|
|
213
|
+
allowedCustomValue?: CustomValue;
|
|
214
|
+
}
|
|
215
|
+
interface Option {
|
|
216
|
+
/**
|
|
217
|
+
* Value to be submitted for the option
|
|
218
|
+
* @minLength 1
|
|
219
|
+
* @maxLength 10000
|
|
220
|
+
*/
|
|
221
|
+
value?: string;
|
|
222
|
+
/**
|
|
223
|
+
* Label to display for the option
|
|
224
|
+
* @minLength 1
|
|
225
|
+
* @maxLength 10000
|
|
226
|
+
*/
|
|
227
|
+
label?: string;
|
|
228
|
+
}
|
|
229
|
+
interface CustomValue {
|
|
230
|
+
/**
|
|
231
|
+
* Description of expected custom value
|
|
232
|
+
* @maxLength 10000
|
|
233
|
+
*/
|
|
234
|
+
description?: string;
|
|
235
|
+
}
|
|
236
|
+
interface NumberInputDetails {
|
|
237
|
+
/**
|
|
238
|
+
* Field id for the number input
|
|
239
|
+
* @minLength 1
|
|
240
|
+
* @maxLength 200
|
|
241
|
+
*/
|
|
242
|
+
fieldTarget?: string;
|
|
243
|
+
/** Limit min and max range for the input */
|
|
244
|
+
rangeLimit?: NumberRangeLimit;
|
|
245
|
+
/** If provided, only multiples of this value are accepted */
|
|
246
|
+
multipleOf?: number | null;
|
|
247
|
+
}
|
|
248
|
+
interface NumberRangeLimit extends NumberRangeLimitEndOneOf {
|
|
249
|
+
/** Maximum value of the range (inclusive) */
|
|
250
|
+
maxInclusiveValue?: number | null;
|
|
251
|
+
/** Maximum value of the range (exclusive) */
|
|
252
|
+
maxExclusiveValue?: number | null;
|
|
253
|
+
/** Minimum value of the range (inclusive) */
|
|
254
|
+
minInclusiveValue?: number | null;
|
|
255
|
+
}
|
|
256
|
+
/** @oneof */
|
|
257
|
+
interface NumberRangeLimitEndOneOf {
|
|
258
|
+
/** Maximum value of the range (inclusive) */
|
|
259
|
+
maxInclusiveValue?: number | null;
|
|
260
|
+
/** Maximum value of the range (exclusive) */
|
|
261
|
+
maxExclusiveValue?: number | null;
|
|
262
|
+
}
|
|
263
|
+
interface SeparatorDetails {
|
|
264
|
+
/** Type of separator (e.g. paragraph) */
|
|
265
|
+
type?: TypeWithLiterals;
|
|
266
|
+
}
|
|
267
|
+
declare enum Type {
|
|
268
|
+
UNKNOWN_TYPE = "UNKNOWN_TYPE",
|
|
269
|
+
PARAGRAPH = "PARAGRAPH"
|
|
270
|
+
}
|
|
271
|
+
/** @enumType */
|
|
272
|
+
type TypeWithLiterals = Type | 'UNKNOWN_TYPE' | 'PARAGRAPH';
|
|
273
|
+
interface SingleSelectInputDetails {
|
|
274
|
+
/**
|
|
275
|
+
* Field id for the single-select input
|
|
276
|
+
* @minLength 1
|
|
277
|
+
* @maxLength 200
|
|
278
|
+
*/
|
|
279
|
+
fieldTarget?: string;
|
|
280
|
+
/**
|
|
281
|
+
* Options available for selection
|
|
282
|
+
* @minSize 1
|
|
283
|
+
* @maxSize 100
|
|
284
|
+
*/
|
|
285
|
+
options?: Option[];
|
|
286
|
+
/** If present, then user is allowed to provide custom values */
|
|
287
|
+
allowedCustomValue?: CustomValue;
|
|
288
|
+
}
|
|
289
|
+
interface ErrorDetails {
|
|
290
|
+
/**
|
|
291
|
+
* Error message text
|
|
292
|
+
* @minLength 1
|
|
293
|
+
* @maxLength 1000
|
|
294
|
+
*/
|
|
295
|
+
messageText?: string;
|
|
296
|
+
}
|
|
297
|
+
interface SubmissionDetails {
|
|
298
|
+
/**
|
|
299
|
+
* Created submission id
|
|
300
|
+
* @format GUID
|
|
301
|
+
*/
|
|
302
|
+
submissionId?: string;
|
|
303
|
+
/**
|
|
304
|
+
* ID of the ecom checkout related to submission (only applicable if a form has payments).
|
|
305
|
+
* @format GUID
|
|
306
|
+
* @readonly
|
|
307
|
+
*/
|
|
308
|
+
checkoutId?: string | null;
|
|
309
|
+
}
|
|
310
|
+
interface ImportantTextDetails {
|
|
311
|
+
/**
|
|
312
|
+
* Target field key for the important text
|
|
313
|
+
* @minLength 1
|
|
314
|
+
* @maxLength 200
|
|
315
|
+
*/
|
|
316
|
+
fieldTarget?: string;
|
|
317
|
+
/**
|
|
318
|
+
* Important text content to display
|
|
319
|
+
* @minLength 1
|
|
320
|
+
* @maxLength 10000
|
|
321
|
+
*/
|
|
322
|
+
text?: string;
|
|
323
|
+
}
|
|
324
|
+
interface DebugDetails {
|
|
325
|
+
/** Debug data for troubleshooting */
|
|
326
|
+
data?: Record<string, any> | null;
|
|
327
|
+
}
|
|
328
|
+
interface EndOfResponseDetails {
|
|
329
|
+
/** If the response was successful */
|
|
330
|
+
success?: boolean;
|
|
331
|
+
}
|
|
332
|
+
interface FileUploadDetails {
|
|
333
|
+
/**
|
|
334
|
+
* Field id for the file upload input
|
|
335
|
+
* @minLength 1
|
|
336
|
+
* @maxLength 200
|
|
337
|
+
*/
|
|
338
|
+
fieldTarget?: string;
|
|
339
|
+
}
|
|
340
|
+
interface SignatureDetails {
|
|
341
|
+
/**
|
|
342
|
+
* Field id for the signature input
|
|
343
|
+
* @minLength 1
|
|
344
|
+
* @maxLength 200
|
|
345
|
+
*/
|
|
346
|
+
fieldTarget?: string;
|
|
347
|
+
}
|
|
348
|
+
interface MeaningfulInput {
|
|
349
|
+
/**
|
|
350
|
+
* Character offset (0-indexed) from the start of the user input to where the meaningful text starts
|
|
351
|
+
* @max 10000
|
|
352
|
+
*/
|
|
353
|
+
startOffset?: number;
|
|
354
|
+
/**
|
|
355
|
+
* Length of the meaningful text in characters
|
|
356
|
+
* @max 10000
|
|
357
|
+
*/
|
|
358
|
+
length?: number;
|
|
359
|
+
}
|
|
360
|
+
interface CreateInteractiveFormSessionStreamedRequest {
|
|
361
|
+
/**
|
|
362
|
+
* Interactive form session to be created.
|
|
363
|
+
* @format GUID
|
|
364
|
+
*/
|
|
365
|
+
formId: string;
|
|
366
|
+
/**
|
|
367
|
+
* ID of the prompt to use.
|
|
368
|
+
* @format GUID
|
|
369
|
+
*/
|
|
370
|
+
promptId?: string | null;
|
|
371
|
+
/** Sets current values for the form fields, used to pre-fill the form (e.g. when switching from classic form to chat form). */
|
|
372
|
+
currentValues?: Record<string, any> | null;
|
|
373
|
+
/**
|
|
374
|
+
* Dry run mode. The completion will not conduct submission if set to true. Intended for preview mode.
|
|
375
|
+
* @immutable
|
|
376
|
+
*/
|
|
377
|
+
dryRun?: boolean;
|
|
378
|
+
/**
|
|
379
|
+
* Current date-time string with user's timezone offset in ISO 8601 format (e.g. "2023-10-01T12:00:00+03:00").
|
|
380
|
+
* @minLength 1
|
|
381
|
+
* @maxLength 200
|
|
382
|
+
*/
|
|
383
|
+
currentTime?: string | null;
|
|
384
|
+
/** Current date-time of api client */
|
|
385
|
+
clientTime?: ClientTime;
|
|
386
|
+
}
|
|
387
|
+
interface CreateInteractiveFormSessionStreamedResponse {
|
|
388
|
+
/** Assistant response chunk */
|
|
389
|
+
responseChunk?: InteractiveFormSessionResponseChunk;
|
|
390
|
+
/** Interactive form session. Only returned on the 1st chunk of the stream. */
|
|
391
|
+
interactiveFormSession?: InteractiveFormSession;
|
|
392
|
+
}
|
|
393
|
+
interface SendUserMessageRequest {
|
|
394
|
+
/**
|
|
395
|
+
* Interactive form session id
|
|
396
|
+
* @format GUID
|
|
397
|
+
*/
|
|
398
|
+
interactiveFormSessionId: string;
|
|
399
|
+
/**
|
|
400
|
+
* User input to add to the session
|
|
401
|
+
* @maxLength 10000
|
|
402
|
+
*/
|
|
403
|
+
input?: string | null;
|
|
404
|
+
/**
|
|
405
|
+
* Sets current values for the form fields, used to pre-fill the form (e.g. when switching from classic form to chat form).
|
|
406
|
+
* These values are merged with existing values in the session.
|
|
407
|
+
* For example, if user has already filled field "Name" and then sends a message with current_values containing
|
|
408
|
+
* "LastName" field, "Name" will remain unchanged. If user sends a message with current_values containing "Name" field,
|
|
409
|
+
* it will override the existing value.
|
|
410
|
+
*/
|
|
411
|
+
currentValues?: Record<string, any> | null;
|
|
412
|
+
}
|
|
413
|
+
interface SendUserMessageResponse {
|
|
414
|
+
/** Interactive form session after input is added */
|
|
415
|
+
interactiveFormSession?: InteractiveFormSession;
|
|
416
|
+
/** Assistant response chunks for the input */
|
|
417
|
+
responseChunks?: InteractiveFormSessionResponseChunk[];
|
|
418
|
+
}
|
|
419
|
+
interface SendUserMessageStreamedRequest {
|
|
420
|
+
/**
|
|
421
|
+
* Interactive form session id
|
|
422
|
+
* @format GUID
|
|
423
|
+
*/
|
|
424
|
+
interactiveFormSessionId: string;
|
|
425
|
+
/**
|
|
426
|
+
* User input to add to the session
|
|
427
|
+
* @maxLength 10000
|
|
428
|
+
*/
|
|
429
|
+
input?: string | null;
|
|
430
|
+
/**
|
|
431
|
+
* Sets current values for the form fields, used to pre-fill the form (e.g. when switching from classic form to chat form).
|
|
432
|
+
* These values are merged with existing values in the session.
|
|
433
|
+
* For example, if user has already filled field "Name" and then sends a message with current_values containing
|
|
434
|
+
* "LastName" field, "Name" will remain unchanged. If user sends a message with current_values containing "Name" field,
|
|
435
|
+
* it will override the existing value.
|
|
436
|
+
*/
|
|
437
|
+
currentValues?: Record<string, any> | null;
|
|
438
|
+
}
|
|
439
|
+
interface SendUserMessageStreamedResponse {
|
|
440
|
+
/** Assistant response chunk for the streamed input */
|
|
441
|
+
responseChunk?: InteractiveFormSessionResponseChunk;
|
|
442
|
+
/** Interactive form session after input is added */
|
|
443
|
+
interactiveFormSession?: InteractiveFormSession;
|
|
444
|
+
}
|
|
445
|
+
interface ConverseRequest extends ConverseRequestRequestOneOf {
|
|
446
|
+
/** Get state request */
|
|
447
|
+
getStateRequest?: GetStateRequest;
|
|
448
|
+
/** Call tools request */
|
|
449
|
+
callToolsRequest?: CallToolsRequest;
|
|
450
|
+
/** Relay assistant message request */
|
|
451
|
+
relayAssistantMessage?: RelayAssistantMessageRequest;
|
|
452
|
+
/** Usage request */
|
|
453
|
+
usageRequest?: UsageRequest;
|
|
454
|
+
/**
|
|
455
|
+
* Request ID used for mapping the request to the response
|
|
456
|
+
* @format GUID
|
|
457
|
+
*/
|
|
458
|
+
requestId?: string;
|
|
459
|
+
}
|
|
460
|
+
/** @oneof */
|
|
461
|
+
interface ConverseRequestRequestOneOf {
|
|
462
|
+
/** Get state request */
|
|
463
|
+
getStateRequest?: GetStateRequest;
|
|
464
|
+
/** Call tools request */
|
|
465
|
+
callToolsRequest?: CallToolsRequest;
|
|
466
|
+
/** Relay assistant message request */
|
|
467
|
+
relayAssistantMessage?: RelayAssistantMessageRequest;
|
|
468
|
+
/** Usage request */
|
|
469
|
+
usageRequest?: UsageRequest;
|
|
470
|
+
}
|
|
471
|
+
interface GetStateRequest {
|
|
472
|
+
/**
|
|
473
|
+
* Interactive form session ID
|
|
474
|
+
* @format GUID
|
|
475
|
+
*/
|
|
476
|
+
interactiveFormSessionId?: string;
|
|
477
|
+
/**
|
|
478
|
+
* System prompt ID
|
|
479
|
+
* @format GUID
|
|
480
|
+
*/
|
|
481
|
+
promptId?: string;
|
|
482
|
+
}
|
|
483
|
+
interface CallToolsRequest {
|
|
484
|
+
/**
|
|
485
|
+
* Tool calls to be executed
|
|
486
|
+
* @maxSize 100
|
|
487
|
+
*/
|
|
488
|
+
calls?: Call[];
|
|
489
|
+
/**
|
|
490
|
+
* Interactive form session ID
|
|
491
|
+
* @format GUID
|
|
492
|
+
*/
|
|
493
|
+
interactiveFormSessionId?: string;
|
|
494
|
+
}
|
|
495
|
+
interface Call {
|
|
496
|
+
/** Tool call arguments */
|
|
497
|
+
args?: Record<string, any> | null;
|
|
498
|
+
/**
|
|
499
|
+
* Tool name to call
|
|
500
|
+
* @minLength 1
|
|
501
|
+
* @maxLength 100
|
|
502
|
+
*/
|
|
503
|
+
toolName?: string;
|
|
504
|
+
/**
|
|
505
|
+
* Tool call ID
|
|
506
|
+
* @minLength 1
|
|
507
|
+
* @maxLength 100
|
|
508
|
+
*/
|
|
509
|
+
callId?: string;
|
|
510
|
+
}
|
|
511
|
+
interface RelayAssistantMessageRequest {
|
|
512
|
+
/**
|
|
513
|
+
* Assistant message text
|
|
514
|
+
* @minLength 1
|
|
515
|
+
* @maxLength 10000
|
|
516
|
+
*/
|
|
517
|
+
text?: string;
|
|
518
|
+
/**
|
|
519
|
+
* Interactive form session ID
|
|
520
|
+
* @format GUID
|
|
521
|
+
*/
|
|
522
|
+
interactiveFormSessionId?: string;
|
|
523
|
+
}
|
|
524
|
+
interface UsageRequest {
|
|
525
|
+
/** Microcents spent for the request */
|
|
526
|
+
microcentsSpent?: string;
|
|
527
|
+
/**
|
|
528
|
+
* Interactive form session ID
|
|
529
|
+
* @format GUID
|
|
530
|
+
*/
|
|
531
|
+
interactiveFormSessionId?: string;
|
|
532
|
+
/**
|
|
533
|
+
* Form ID
|
|
534
|
+
* @format GUID
|
|
535
|
+
*/
|
|
536
|
+
formId?: string;
|
|
537
|
+
/** Usage details for the request */
|
|
538
|
+
usage?: Usage;
|
|
539
|
+
}
|
|
540
|
+
interface Usage {
|
|
541
|
+
/**
|
|
542
|
+
* Model name used for the session
|
|
543
|
+
* @minLength 1
|
|
544
|
+
* @maxLength 100
|
|
545
|
+
*/
|
|
546
|
+
model?: string | null;
|
|
547
|
+
/** The total number of tokens in the Response including input and output text and audio tokens */
|
|
548
|
+
totalTokens?: string;
|
|
549
|
+
/** The number of input tokens used in the Response, including text and audio tokens. */
|
|
550
|
+
inputTokens?: string;
|
|
551
|
+
/** The number of output tokens sent in the Response, including text and audio tokens. */
|
|
552
|
+
outputTokens?: string;
|
|
553
|
+
/** Token details */
|
|
554
|
+
tokenDetails?: Record<string, any> | null;
|
|
555
|
+
}
|
|
556
|
+
interface ConverseResponse extends ConverseResponseResponseOneOf {
|
|
557
|
+
/** Get state response */
|
|
558
|
+
getStateResponse?: GetStateResponse;
|
|
559
|
+
/** Call tools response */
|
|
560
|
+
callToolsResponse?: CallToolsResponse;
|
|
561
|
+
/** Assistant response chunk */
|
|
562
|
+
responseChunk?: InteractiveFormSessionResponseChunk;
|
|
563
|
+
/** Response that signals that the request has been processed */
|
|
564
|
+
acknowledgmentResponse?: AcknowledgmentResponse;
|
|
565
|
+
/**
|
|
566
|
+
* Request ID used for mapping the request to the response
|
|
567
|
+
* @format GUID
|
|
568
|
+
*/
|
|
569
|
+
requestId?: string;
|
|
570
|
+
}
|
|
571
|
+
/** @oneof */
|
|
572
|
+
interface ConverseResponseResponseOneOf {
|
|
573
|
+
/** Get state response */
|
|
574
|
+
getStateResponse?: GetStateResponse;
|
|
575
|
+
/** Call tools response */
|
|
576
|
+
callToolsResponse?: CallToolsResponse;
|
|
577
|
+
/** Assistant response chunk */
|
|
578
|
+
responseChunk?: InteractiveFormSessionResponseChunk;
|
|
579
|
+
/** Response that signals that the request has been processed */
|
|
580
|
+
acknowledgmentResponse?: AcknowledgmentResponse;
|
|
581
|
+
}
|
|
582
|
+
interface GetStateResponse {
|
|
583
|
+
/**
|
|
584
|
+
* Available tools for the session
|
|
585
|
+
* @maxSize 100
|
|
586
|
+
*/
|
|
587
|
+
tools?: Tool[];
|
|
588
|
+
/**
|
|
589
|
+
* Context messages for the session
|
|
590
|
+
* @maxSize 10000
|
|
591
|
+
*/
|
|
592
|
+
contextMessages?: ContextMessage[];
|
|
593
|
+
/**
|
|
594
|
+
* System prompt text
|
|
595
|
+
* @minLength 1
|
|
596
|
+
* @maxLength 10000
|
|
597
|
+
*/
|
|
598
|
+
systemPrompt?: string;
|
|
599
|
+
/**
|
|
600
|
+
* Form ID for the session
|
|
601
|
+
* @format GUID
|
|
602
|
+
*/
|
|
603
|
+
formId?: string;
|
|
604
|
+
/**
|
|
605
|
+
* Submission state message
|
|
606
|
+
* @maxLength 10000
|
|
607
|
+
*/
|
|
608
|
+
submissionStateMessage?: string | null;
|
|
609
|
+
}
|
|
610
|
+
interface Tool {
|
|
611
|
+
/**
|
|
612
|
+
* Tool type identifier
|
|
613
|
+
* @minLength 1
|
|
614
|
+
* @maxLength 10000
|
|
615
|
+
*/
|
|
616
|
+
type?: string;
|
|
617
|
+
/**
|
|
618
|
+
* Tool name
|
|
619
|
+
* @minLength 1
|
|
620
|
+
* @maxLength 10000
|
|
621
|
+
*/
|
|
622
|
+
name?: string | null;
|
|
623
|
+
/**
|
|
624
|
+
* Tool description
|
|
625
|
+
* @minLength 1
|
|
626
|
+
* @maxLength 10000
|
|
627
|
+
*/
|
|
628
|
+
description?: string | null;
|
|
629
|
+
/** Tool parameters */
|
|
630
|
+
parameters?: Record<string, any> | null;
|
|
631
|
+
}
|
|
632
|
+
interface ContextMessage extends ContextMessageOptionsOneOf {
|
|
633
|
+
/** User options */
|
|
634
|
+
userOptions?: UserOptions;
|
|
635
|
+
/** Assistant options */
|
|
636
|
+
assistantOptions?: AssistantOptions;
|
|
637
|
+
/** Function call options */
|
|
638
|
+
functionCallOptions?: FunctionCallOptions;
|
|
639
|
+
/** Function call output options */
|
|
640
|
+
functionCallOutputOptions?: FunctionCallOutputOptions;
|
|
641
|
+
/** Developer options */
|
|
642
|
+
developerOptions?: DeveloperOptions;
|
|
643
|
+
/** Role of the message sender */
|
|
644
|
+
role?: RoleWithLiterals;
|
|
645
|
+
}
|
|
646
|
+
/** @oneof */
|
|
647
|
+
interface ContextMessageOptionsOneOf {
|
|
648
|
+
/** User options */
|
|
649
|
+
userOptions?: UserOptions;
|
|
650
|
+
/** Assistant options */
|
|
651
|
+
assistantOptions?: AssistantOptions;
|
|
652
|
+
/** Function call options */
|
|
653
|
+
functionCallOptions?: FunctionCallOptions;
|
|
654
|
+
/** Function call output options */
|
|
655
|
+
functionCallOutputOptions?: FunctionCallOutputOptions;
|
|
656
|
+
/** Developer options */
|
|
657
|
+
developerOptions?: DeveloperOptions;
|
|
658
|
+
}
|
|
659
|
+
declare enum Role {
|
|
660
|
+
UNKNOWN_ROLE = "UNKNOWN_ROLE",
|
|
661
|
+
USER = "USER",
|
|
662
|
+
ASSISTANT = "ASSISTANT",
|
|
663
|
+
FUNCTION_CALL = "FUNCTION_CALL",
|
|
664
|
+
FUNCTION_CALL_OUTPUT = "FUNCTION_CALL_OUTPUT",
|
|
665
|
+
DEVELOPER = "DEVELOPER"
|
|
666
|
+
}
|
|
667
|
+
/** @enumType */
|
|
668
|
+
type RoleWithLiterals = Role | 'UNKNOWN_ROLE' | 'USER' | 'ASSISTANT' | 'FUNCTION_CALL' | 'FUNCTION_CALL_OUTPUT' | 'DEVELOPER';
|
|
669
|
+
interface UserOptions {
|
|
670
|
+
/**
|
|
671
|
+
* User message content
|
|
672
|
+
* @minLength 1
|
|
673
|
+
* @maxLength 10000
|
|
674
|
+
*/
|
|
675
|
+
content?: string;
|
|
676
|
+
}
|
|
677
|
+
interface AssistantOptions {
|
|
678
|
+
/**
|
|
679
|
+
* Assistant message content
|
|
680
|
+
* @minLength 1
|
|
681
|
+
* @maxLength 10000
|
|
682
|
+
*/
|
|
683
|
+
content?: string;
|
|
684
|
+
}
|
|
685
|
+
interface FunctionCallOptions {
|
|
686
|
+
/**
|
|
687
|
+
* Call name
|
|
688
|
+
* @minLength 1
|
|
689
|
+
* @maxLength 100
|
|
690
|
+
*/
|
|
691
|
+
functionName?: string;
|
|
692
|
+
/** Call arguments */
|
|
693
|
+
args?: Record<string, any> | null;
|
|
694
|
+
/**
|
|
695
|
+
* Call ID
|
|
696
|
+
* @minLength 1
|
|
697
|
+
* @maxLength 100
|
|
698
|
+
*/
|
|
699
|
+
callId?: string;
|
|
700
|
+
}
|
|
701
|
+
interface FunctionCallOutputOptions {
|
|
702
|
+
/** Call output data */
|
|
703
|
+
output?: Record<string, any> | null;
|
|
704
|
+
/**
|
|
705
|
+
* Call ID
|
|
706
|
+
* @minLength 1
|
|
707
|
+
* @maxLength 100
|
|
708
|
+
*/
|
|
709
|
+
callId?: string;
|
|
710
|
+
}
|
|
711
|
+
interface DeveloperOptions {
|
|
712
|
+
/**
|
|
713
|
+
* Developer message content
|
|
714
|
+
* @minLength 1
|
|
715
|
+
* @maxLength 10000
|
|
716
|
+
*/
|
|
717
|
+
content?: string;
|
|
718
|
+
}
|
|
719
|
+
interface CallToolsResponse {
|
|
720
|
+
/**
|
|
721
|
+
* Tool call responses
|
|
722
|
+
* @maxSize 100
|
|
723
|
+
*/
|
|
724
|
+
responses?: Response[];
|
|
725
|
+
}
|
|
726
|
+
interface Response {
|
|
727
|
+
/**
|
|
728
|
+
* Tool call ID
|
|
729
|
+
* @minLength 1
|
|
730
|
+
* @maxLength 100
|
|
731
|
+
*/
|
|
732
|
+
callId?: string;
|
|
733
|
+
/** Tool call response data */
|
|
734
|
+
response?: Record<string, any> | null;
|
|
735
|
+
}
|
|
736
|
+
interface AcknowledgmentResponse {
|
|
737
|
+
/** If request processing is successful */
|
|
738
|
+
success?: boolean;
|
|
739
|
+
}
|
|
740
|
+
interface OutputInteractiveFormSessionStreamedRequest {
|
|
741
|
+
/**
|
|
742
|
+
* Interactive form session id to output
|
|
743
|
+
* @format GUID
|
|
744
|
+
*/
|
|
745
|
+
interactiveFormSessionId?: string;
|
|
746
|
+
}
|
|
747
|
+
interface OutputInteractiveFormSessionStreamedResponse {
|
|
748
|
+
/** Interactive form session id */
|
|
749
|
+
interactiveFormSession?: InteractiveFormSession;
|
|
750
|
+
/** Assistant response chunk for the session */
|
|
751
|
+
responseChunk?: InteractiveFormSessionResponseChunk;
|
|
752
|
+
}
|
|
753
|
+
interface ReportConversationRequest {
|
|
754
|
+
/**
|
|
755
|
+
* Interactive form session id
|
|
756
|
+
* @format GUID
|
|
757
|
+
*/
|
|
758
|
+
interactiveFormSessionId?: string;
|
|
759
|
+
/**
|
|
760
|
+
* Report description
|
|
761
|
+
* @minLength 1
|
|
762
|
+
* @maxLength 10000
|
|
763
|
+
*/
|
|
764
|
+
description?: string;
|
|
765
|
+
/**
|
|
766
|
+
* Viewer debug URL of the conversation
|
|
767
|
+
* @format WEB_URL
|
|
768
|
+
*/
|
|
769
|
+
viewerDebugUrl?: string;
|
|
770
|
+
}
|
|
771
|
+
interface ReportConversationResponse {
|
|
772
|
+
/** If the report was successfully created */
|
|
773
|
+
success?: boolean | null;
|
|
774
|
+
/**
|
|
775
|
+
* Error message if the report creation failed
|
|
776
|
+
* @maxLength 10000
|
|
777
|
+
*/
|
|
778
|
+
errorMessage?: string | null;
|
|
779
|
+
}
|
|
780
|
+
interface DomainEvent extends DomainEventBodyOneOf {
|
|
781
|
+
createdEvent?: EntityCreatedEvent;
|
|
782
|
+
updatedEvent?: EntityUpdatedEvent;
|
|
783
|
+
deletedEvent?: EntityDeletedEvent;
|
|
784
|
+
actionEvent?: ActionEvent;
|
|
785
|
+
/** Event ID. With this ID you can easily spot duplicated events and ignore them. */
|
|
786
|
+
_id?: string;
|
|
787
|
+
/**
|
|
788
|
+
* Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
|
|
789
|
+
* For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
|
|
790
|
+
*/
|
|
791
|
+
entityFqdn?: string;
|
|
792
|
+
/**
|
|
793
|
+
* Event action name, placed at the top level to make it easier for users to dispatch messages.
|
|
794
|
+
* For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
|
|
795
|
+
*/
|
|
796
|
+
slug?: string;
|
|
797
|
+
/** ID of the entity associated with the event. */
|
|
798
|
+
entityId?: string;
|
|
799
|
+
/** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
|
|
800
|
+
eventTime?: Date | null;
|
|
801
|
+
/**
|
|
802
|
+
* Whether the event was triggered as a result of a privacy regulation application
|
|
803
|
+
* (for example, GDPR).
|
|
804
|
+
*/
|
|
805
|
+
triggeredByAnonymizeRequest?: boolean | null;
|
|
806
|
+
/** If present, indicates the action that triggered the event. */
|
|
807
|
+
originatedFrom?: string | null;
|
|
808
|
+
/**
|
|
809
|
+
* A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
|
|
810
|
+
* You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
|
|
811
|
+
*/
|
|
812
|
+
entityEventSequence?: string | null;
|
|
813
|
+
}
|
|
814
|
+
/** @oneof */
|
|
815
|
+
interface DomainEventBodyOneOf {
|
|
816
|
+
createdEvent?: EntityCreatedEvent;
|
|
817
|
+
updatedEvent?: EntityUpdatedEvent;
|
|
818
|
+
deletedEvent?: EntityDeletedEvent;
|
|
819
|
+
actionEvent?: ActionEvent;
|
|
820
|
+
}
|
|
821
|
+
interface EntityCreatedEvent {
|
|
822
|
+
entity?: string;
|
|
823
|
+
}
|
|
824
|
+
interface RestoreInfo {
|
|
825
|
+
deletedDate?: Date | null;
|
|
826
|
+
}
|
|
827
|
+
interface EntityUpdatedEvent {
|
|
828
|
+
/**
|
|
829
|
+
* Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
|
|
830
|
+
* This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
|
|
831
|
+
* We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
|
|
832
|
+
*/
|
|
833
|
+
currentEntity?: string;
|
|
834
|
+
}
|
|
835
|
+
interface EntityDeletedEvent {
|
|
836
|
+
/** Entity that was deleted. */
|
|
837
|
+
deletedEntity?: string | null;
|
|
838
|
+
}
|
|
839
|
+
interface ActionEvent {
|
|
840
|
+
body?: string;
|
|
841
|
+
}
|
|
842
|
+
interface MessageEnvelope {
|
|
843
|
+
/**
|
|
844
|
+
* App instance ID.
|
|
845
|
+
* @format GUID
|
|
846
|
+
*/
|
|
847
|
+
instanceId?: string | null;
|
|
848
|
+
/**
|
|
849
|
+
* Event type.
|
|
850
|
+
* @maxLength 150
|
|
851
|
+
*/
|
|
852
|
+
eventType?: string;
|
|
853
|
+
/** The identification type and identity data. */
|
|
854
|
+
identity?: IdentificationData;
|
|
855
|
+
/** Stringify payload. */
|
|
856
|
+
data?: string;
|
|
857
|
+
}
|
|
858
|
+
interface IdentificationData extends IdentificationDataIdOneOf {
|
|
859
|
+
/**
|
|
860
|
+
* ID of a site visitor that has not logged in to the site.
|
|
861
|
+
* @format GUID
|
|
862
|
+
*/
|
|
863
|
+
anonymousVisitorId?: string;
|
|
864
|
+
/**
|
|
865
|
+
* ID of a site visitor that has logged in to the site.
|
|
866
|
+
* @format GUID
|
|
867
|
+
*/
|
|
868
|
+
memberId?: string;
|
|
869
|
+
/**
|
|
870
|
+
* ID of a Wix user (site owner, contributor, etc.).
|
|
871
|
+
* @format GUID
|
|
872
|
+
*/
|
|
873
|
+
wixUserId?: string;
|
|
874
|
+
/**
|
|
875
|
+
* ID of an app.
|
|
876
|
+
* @format GUID
|
|
877
|
+
*/
|
|
878
|
+
appId?: string;
|
|
879
|
+
/** @readonly */
|
|
880
|
+
identityType?: WebhookIdentityTypeWithLiterals;
|
|
881
|
+
}
|
|
882
|
+
/** @oneof */
|
|
883
|
+
interface IdentificationDataIdOneOf {
|
|
884
|
+
/**
|
|
885
|
+
* ID of a site visitor that has not logged in to the site.
|
|
886
|
+
* @format GUID
|
|
887
|
+
*/
|
|
888
|
+
anonymousVisitorId?: string;
|
|
889
|
+
/**
|
|
890
|
+
* ID of a site visitor that has logged in to the site.
|
|
891
|
+
* @format GUID
|
|
892
|
+
*/
|
|
893
|
+
memberId?: string;
|
|
894
|
+
/**
|
|
895
|
+
* ID of a Wix user (site owner, contributor, etc.).
|
|
896
|
+
* @format GUID
|
|
897
|
+
*/
|
|
898
|
+
wixUserId?: string;
|
|
899
|
+
/**
|
|
900
|
+
* ID of an app.
|
|
901
|
+
* @format GUID
|
|
902
|
+
*/
|
|
903
|
+
appId?: string;
|
|
904
|
+
}
|
|
905
|
+
declare enum WebhookIdentityType {
|
|
906
|
+
UNKNOWN = "UNKNOWN",
|
|
907
|
+
ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
|
|
908
|
+
MEMBER = "MEMBER",
|
|
909
|
+
WIX_USER = "WIX_USER",
|
|
910
|
+
APP = "APP"
|
|
911
|
+
}
|
|
912
|
+
/** @enumType */
|
|
913
|
+
type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
|
|
914
|
+
/** @docsIgnore */
|
|
915
|
+
type SendUserMessageApplicationErrors = {
|
|
916
|
+
code?: 'EMPTY_REQUEST';
|
|
917
|
+
description?: string;
|
|
918
|
+
data?: Record<string, any>;
|
|
919
|
+
};
|
|
920
|
+
/** @docsIgnore */
|
|
921
|
+
type SendUserMessageStreamedApplicationErrors = {
|
|
922
|
+
code?: 'EMPTY_REQUEST';
|
|
923
|
+
description?: string;
|
|
924
|
+
data?: Record<string, any>;
|
|
925
|
+
};
|
|
926
|
+
/**
|
|
927
|
+
* Starts interactive form session for a given form
|
|
928
|
+
* @param formId - Interactive form session to be created.
|
|
929
|
+
* @public
|
|
930
|
+
* @documentationMaturity preview
|
|
931
|
+
* @requiredField formId
|
|
932
|
+
* @permissionId WIX_FORMS.CREATE_INTERACTIVE_FORM_SESSION
|
|
933
|
+
* @applicableIdentity APP
|
|
934
|
+
* @returns Interactive form session created
|
|
935
|
+
* @fqn wix.forms.ai.v1.InteractiveFormSessionsService.CreateInteractiveFormSession
|
|
936
|
+
*/
|
|
937
|
+
declare function createInteractiveFormSession(formId: string, options?: CreateInteractiveFormSessionOptions): Promise<NonNullablePaths<InteractiveFormSession, `_id` | `formId`, 2>>;
|
|
938
|
+
interface CreateInteractiveFormSessionOptions {
|
|
939
|
+
/**
|
|
940
|
+
* ID of the prompt to use.
|
|
941
|
+
* @format GUID
|
|
942
|
+
*/
|
|
943
|
+
promptId?: string | null;
|
|
944
|
+
/**
|
|
945
|
+
* Sets current values for the form fields, used to pre-fill the form (e.g. when switching from classic form to chat form).
|
|
946
|
+
* These values are merged with existing values in the session.
|
|
947
|
+
* For example, if user has already filled field "Name" and then sends a message with current_values containing
|
|
948
|
+
* "LastName" field, "Name" will remain unchanged. If user sends a message with current_values containing "Name" field,
|
|
949
|
+
* it will override the existing value.
|
|
950
|
+
*/
|
|
951
|
+
currentValues?: Record<string, any> | null;
|
|
952
|
+
/**
|
|
953
|
+
* Dry run mode. The completion will not conduct submission if set to true. Intended for preview mode.
|
|
954
|
+
* @immutable
|
|
955
|
+
*/
|
|
956
|
+
dryRun?: boolean;
|
|
957
|
+
/**
|
|
958
|
+
* Current date-time string with user's timezone offset in ISO 8601 format (e.g. "2023-10-01T12:00:00+03:00").
|
|
959
|
+
* @minLength 1
|
|
960
|
+
* @maxLength 200
|
|
961
|
+
*/
|
|
962
|
+
currentTime?: string | null;
|
|
963
|
+
/** Current date-time of api client */
|
|
964
|
+
clientTime?: ClientTime;
|
|
965
|
+
}
|
|
966
|
+
/**
|
|
967
|
+
* Starts interactive form session for a given form with streamed response
|
|
968
|
+
* @param formId - Interactive form session to be created.
|
|
969
|
+
* @public
|
|
970
|
+
* @documentationMaturity preview
|
|
971
|
+
* @requiredField formId
|
|
972
|
+
* @permissionId WIX_FORMS.CREATE_INTERACTIVE_FORM_SESSION
|
|
973
|
+
* @applicableIdentity APP
|
|
974
|
+
* @fqn wix.forms.ai.v1.InteractiveFormSessionsService.CreateInteractiveFormSessionStreamed
|
|
975
|
+
*/
|
|
976
|
+
declare function createInteractiveFormSessionStreamed(formId: string, options?: CreateInteractiveFormSessionStreamedOptions): Promise<NonNullablePaths<CreateInteractiveFormSessionStreamedResponse, `responseChunk.textDetails.text` | `responseChunk.textDetails.style` | `responseChunk.textDataDetails.fieldTarget` | `responseChunk.textDataDetails.text` | `responseChunk.textDataDetails.displayValue` | `responseChunk.multiSelectInputDetails.fieldTarget` | `responseChunk.multiSelectInputDetails.options` | `responseChunk.multiSelectInputDetails.options.${number}.value` | `responseChunk.multiSelectInputDetails.options.${number}.label` | `responseChunk.multiSelectInputDetails.allowedCustomValue.description` | `responseChunk.numberInputDetails.fieldTarget` | `responseChunk.separatorDetails.type` | `responseChunk.singleSelectInputDetails.fieldTarget` | `responseChunk.singleSelectInputDetails.options` | `responseChunk.errorDetails.messageText` | `responseChunk.submissionDetails.submissionId` | `responseChunk.importantTextDetails.fieldTarget` | `responseChunk.importantTextDetails.text` | `responseChunk.endOfResponseDetails.success` | `responseChunk.fileUploadDetails.fieldTarget` | `responseChunk.signatureDetails.fieldTarget` | `responseChunk.chunkType` | `responseChunk.meaningfulInput.startOffset` | `responseChunk.meaningfulInput.length` | `interactiveFormSession._id` | `interactiveFormSession.formId`, 6>>;
|
|
977
|
+
interface CreateInteractiveFormSessionStreamedOptions {
|
|
978
|
+
/**
|
|
979
|
+
* ID of the prompt to use.
|
|
980
|
+
* @format GUID
|
|
981
|
+
*/
|
|
982
|
+
promptId?: string | null;
|
|
983
|
+
/** Sets current values for the form fields, used to pre-fill the form (e.g. when switching from classic form to chat form). */
|
|
984
|
+
currentValues?: Record<string, any> | null;
|
|
985
|
+
/**
|
|
986
|
+
* Dry run mode. The completion will not conduct submission if set to true. Intended for preview mode.
|
|
987
|
+
* @immutable
|
|
988
|
+
*/
|
|
989
|
+
dryRun?: boolean;
|
|
990
|
+
/**
|
|
991
|
+
* Current date-time string with user's timezone offset in ISO 8601 format (e.g. "2023-10-01T12:00:00+03:00").
|
|
992
|
+
* @minLength 1
|
|
993
|
+
* @maxLength 200
|
|
994
|
+
*/
|
|
995
|
+
currentTime?: string | null;
|
|
996
|
+
/** Current date-time of api client */
|
|
997
|
+
clientTime?: ClientTime;
|
|
998
|
+
}
|
|
999
|
+
/**
|
|
1000
|
+
* Sends user message to the interactive form session
|
|
1001
|
+
* @param interactiveFormSessionId - Interactive form session id
|
|
1002
|
+
* @public
|
|
1003
|
+
* @documentationMaturity preview
|
|
1004
|
+
* @requiredField interactiveFormSessionId
|
|
1005
|
+
* @permissionId WIX_FORMS.SEND_USER_MESSAGE_TO_INTERACTIVE_FORM_SESSION
|
|
1006
|
+
* @applicableIdentity APP
|
|
1007
|
+
* @fqn wix.forms.ai.v1.InteractiveFormSessionsService.SendUserMessage
|
|
1008
|
+
*/
|
|
1009
|
+
declare function sendUserMessage(interactiveFormSessionId: string, options?: SendUserMessageOptions): Promise<NonNullablePaths<SendUserMessageResponse, `interactiveFormSession._id` | `interactiveFormSession.formId` | `responseChunks` | `responseChunks.${number}.textDetails.text` | `responseChunks.${number}.textDetails.style` | `responseChunks.${number}.textDataDetails.fieldTarget` | `responseChunks.${number}.textDataDetails.text` | `responseChunks.${number}.textDataDetails.displayValue` | `responseChunks.${number}.multiSelectInputDetails.fieldTarget` | `responseChunks.${number}.multiSelectInputDetails.allowedCustomValue.description` | `responseChunks.${number}.numberInputDetails.fieldTarget` | `responseChunks.${number}.separatorDetails.type` | `responseChunks.${number}.singleSelectInputDetails.fieldTarget` | `responseChunks.${number}.errorDetails.messageText` | `responseChunks.${number}.submissionDetails.submissionId` | `responseChunks.${number}.importantTextDetails.fieldTarget` | `responseChunks.${number}.importantTextDetails.text` | `responseChunks.${number}.endOfResponseDetails.success` | `responseChunks.${number}.fileUploadDetails.fieldTarget` | `responseChunks.${number}.signatureDetails.fieldTarget` | `responseChunks.${number}.chunkType` | `responseChunks.${number}.meaningfulInput.startOffset` | `responseChunks.${number}.meaningfulInput.length`, 6> & {
|
|
1010
|
+
__applicationErrorsType?: SendUserMessageApplicationErrors;
|
|
1011
|
+
}>;
|
|
1012
|
+
interface SendUserMessageOptions {
|
|
1013
|
+
/**
|
|
1014
|
+
* User input to add to the session
|
|
1015
|
+
* @maxLength 10000
|
|
1016
|
+
*/
|
|
1017
|
+
input?: string | null;
|
|
1018
|
+
/**
|
|
1019
|
+
* Sets current values for the form fields, used to pre-fill the form (e.g. when switching from classic form to chat form).
|
|
1020
|
+
* These values are merged with existing values in the session.
|
|
1021
|
+
* For example, if user has already filled field "Name" and then sends a message with current_values containing
|
|
1022
|
+
* "LastName" field, "Name" will remain unchanged. If user sends a message with current_values containing "Name" field,
|
|
1023
|
+
* it will override the existing value.
|
|
1024
|
+
*/
|
|
1025
|
+
currentValues?: Record<string, any> | null;
|
|
1026
|
+
}
|
|
1027
|
+
/**
|
|
1028
|
+
* Sends user message to the interactive form session with streamed response
|
|
1029
|
+
* @param interactiveFormSessionId - Interactive form session id
|
|
1030
|
+
* @public
|
|
1031
|
+
* @documentationMaturity preview
|
|
1032
|
+
* @requiredField interactiveFormSessionId
|
|
1033
|
+
* @permissionId WIX_FORMS.SEND_USER_MESSAGE_TO_INTERACTIVE_FORM_SESSION
|
|
1034
|
+
* @applicableIdentity APP
|
|
1035
|
+
* @fqn wix.forms.ai.v1.InteractiveFormSessionsService.SendUserMessageStreamed
|
|
1036
|
+
*/
|
|
1037
|
+
declare function sendUserMessageStreamed(interactiveFormSessionId: string, options?: SendUserMessageStreamedOptions): Promise<NonNullablePaths<SendUserMessageStreamedResponse, `responseChunk.textDetails.text` | `responseChunk.textDetails.style` | `responseChunk.textDataDetails.fieldTarget` | `responseChunk.textDataDetails.text` | `responseChunk.textDataDetails.displayValue` | `responseChunk.multiSelectInputDetails.fieldTarget` | `responseChunk.multiSelectInputDetails.options` | `responseChunk.multiSelectInputDetails.options.${number}.value` | `responseChunk.multiSelectInputDetails.options.${number}.label` | `responseChunk.multiSelectInputDetails.allowedCustomValue.description` | `responseChunk.numberInputDetails.fieldTarget` | `responseChunk.separatorDetails.type` | `responseChunk.singleSelectInputDetails.fieldTarget` | `responseChunk.singleSelectInputDetails.options` | `responseChunk.errorDetails.messageText` | `responseChunk.submissionDetails.submissionId` | `responseChunk.importantTextDetails.fieldTarget` | `responseChunk.importantTextDetails.text` | `responseChunk.endOfResponseDetails.success` | `responseChunk.fileUploadDetails.fieldTarget` | `responseChunk.signatureDetails.fieldTarget` | `responseChunk.chunkType` | `responseChunk.meaningfulInput.startOffset` | `responseChunk.meaningfulInput.length` | `interactiveFormSession._id` | `interactiveFormSession.formId`, 6> & {
|
|
1038
|
+
__applicationErrorsType?: SendUserMessageStreamedApplicationErrors;
|
|
1039
|
+
}>;
|
|
1040
|
+
interface SendUserMessageStreamedOptions {
|
|
1041
|
+
/**
|
|
1042
|
+
* User input to add to the session
|
|
1043
|
+
* @maxLength 10000
|
|
1044
|
+
*/
|
|
1045
|
+
input?: string | null;
|
|
1046
|
+
/**
|
|
1047
|
+
* Sets current values for the form fields, used to pre-fill the form (e.g. when switching from classic form to chat form).
|
|
1048
|
+
* These values are merged with existing values in the session.
|
|
1049
|
+
* For example, if user has already filled field "Name" and then sends a message with current_values containing
|
|
1050
|
+
* "LastName" field, "Name" will remain unchanged. If user sends a message with current_values containing "Name" field,
|
|
1051
|
+
* it will override the existing value.
|
|
1052
|
+
*/
|
|
1053
|
+
currentValues?: Record<string, any> | null;
|
|
1054
|
+
}
|
|
1055
|
+
/**
|
|
1056
|
+
* Report conversation for quality assurance
|
|
1057
|
+
* @public
|
|
1058
|
+
* @documentationMaturity preview
|
|
1059
|
+
* @permissionId WIX_FORMS.REPORT_INTERACTIVE_FORM_SESSION
|
|
1060
|
+
* @fqn wix.forms.ai.v1.InteractiveFormSessionsService.ReportConversation
|
|
1061
|
+
*/
|
|
1062
|
+
declare function reportConversation(options?: ReportConversationOptions): Promise<ReportConversationResponse>;
|
|
1063
|
+
interface ReportConversationOptions {
|
|
1064
|
+
/**
|
|
1065
|
+
* Interactive form session id
|
|
1066
|
+
* @format GUID
|
|
1067
|
+
*/
|
|
1068
|
+
interactiveFormSessionId?: string;
|
|
1069
|
+
/**
|
|
1070
|
+
* Report description
|
|
1071
|
+
* @minLength 1
|
|
1072
|
+
* @maxLength 10000
|
|
1073
|
+
*/
|
|
1074
|
+
description?: string;
|
|
1075
|
+
/**
|
|
1076
|
+
* Viewer debug URL of the conversation
|
|
1077
|
+
* @format WEB_URL
|
|
1078
|
+
*/
|
|
1079
|
+
viewerDebugUrl?: string;
|
|
1080
|
+
}
|
|
1081
|
+
|
|
1082
|
+
export { type AcknowledgmentResponse, type ActionEvent, type AssistantOptions, type Call, type CallToolsRequest, type CallToolsResponse, ChunkType, type ChunkTypeWithLiterals, type ClientTime, type ContextMessage, type ContextMessageOptionsOneOf, type ConverseRequest, type ConverseRequestRequestOneOf, type ConverseResponse, type ConverseResponseResponseOneOf, type CreateInteractiveFormSessionOptions, type CreateInteractiveFormSessionRequest, type CreateInteractiveFormSessionResponse, type CreateInteractiveFormSessionStreamedOptions, type CreateInteractiveFormSessionStreamedRequest, type CreateInteractiveFormSessionStreamedResponse, type CustomValue, type DebugDetails, type DeveloperOptions, type DomainEvent, type DomainEventBodyOneOf, type EndOfResponseDetails, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type ErrorDetails, type FileUploadDetails, type FunctionCallOptions, type FunctionCallOutputOptions, type GetStateRequest, type GetStateResponse, type IdentificationData, type IdentificationDataIdOneOf, type ImportantTextDetails, type InteractiveFormSession, type InteractiveFormSessionResponseChunk, type InteractiveFormSessionResponseChunkOfOneOf, type MeaningfulInput, type MessageEnvelope, type MultiSelectInputDetails, type NumberInputDetails, type NumberRangeLimit, type NumberRangeLimitEndOneOf, type Option, type OutputInteractiveFormSessionStreamedRequest, type OutputInteractiveFormSessionStreamedResponse, type RelayAssistantMessageRequest, type ReportConversationOptions, type ReportConversationRequest, type ReportConversationResponse, type Response, type RestoreInfo, Role, type RoleWithLiterals, type SendUserMessageApplicationErrors, type SendUserMessageOptions, type SendUserMessageRequest, type SendUserMessageResponse, type SendUserMessageStreamedApplicationErrors, type SendUserMessageStreamedOptions, type SendUserMessageStreamedRequest, type SendUserMessageStreamedResponse, type SeparatorDetails, type SignatureDetails, type SingleSelectInputDetails, Style, type StyleWithLiterals, type SubmissionDetails, type TextDataDetails, type TextDetails, type Tool, Type, type TypeWithLiterals, type Usage, type UsageRequest, type UserOptions, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, createInteractiveFormSession, createInteractiveFormSessionStreamed, reportConversation, sendUserMessage, sendUserMessageStreamed };
|