@perstack/core 0.0.15 → 0.0.16
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/dist/src/index.d.ts +1311 -565
- package/dist/src/index.js +254 -187
- package/dist/src/index.js.map +1 -1
- package/package.json +1 -1
package/dist/src/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { z } from 'zod';
|
|
1
|
+
import { z, ZodError, ZodSchema } from 'zod';
|
|
2
2
|
|
|
3
3
|
declare const defaultPerstackApiBaseUrl = "https://api.perstack.ai";
|
|
4
4
|
declare const organizationNameRegex: RegExp;
|
|
@@ -37,6 +37,460 @@ declare const maxCheckpointToolCallIdLength = 255;
|
|
|
37
37
|
declare const envNameRegex: RegExp;
|
|
38
38
|
declare const maxEnvNameLength = 255;
|
|
39
39
|
|
|
40
|
+
declare const knownModels: {
|
|
41
|
+
provider: string;
|
|
42
|
+
models: {
|
|
43
|
+
name: string;
|
|
44
|
+
contextWindow: number;
|
|
45
|
+
maxOutputTokens: number;
|
|
46
|
+
}[];
|
|
47
|
+
}[];
|
|
48
|
+
|
|
49
|
+
/** Base properties shared by all message parts */
|
|
50
|
+
interface BasePart {
|
|
51
|
+
/** Unique identifier for this part */
|
|
52
|
+
id: string;
|
|
53
|
+
}
|
|
54
|
+
declare const basePartSchema: z.ZodObject<{
|
|
55
|
+
id: z.ZodString;
|
|
56
|
+
}, z.core.$strip>;
|
|
57
|
+
/** Plain text content */
|
|
58
|
+
interface TextPart extends BasePart {
|
|
59
|
+
type: "textPart";
|
|
60
|
+
/** The text content */
|
|
61
|
+
text: string;
|
|
62
|
+
}
|
|
63
|
+
declare const textPartSchema: z.ZodObject<{
|
|
64
|
+
id: z.ZodString;
|
|
65
|
+
type: z.ZodLiteral<"textPart">;
|
|
66
|
+
text: z.ZodString;
|
|
67
|
+
}, z.core.$strip>;
|
|
68
|
+
/** Image referenced by URL */
|
|
69
|
+
interface ImageUrlPart extends BasePart {
|
|
70
|
+
type: "imageUrlPart";
|
|
71
|
+
/** URL to the image */
|
|
72
|
+
url: string;
|
|
73
|
+
/** MIME type of the image */
|
|
74
|
+
mimeType: string;
|
|
75
|
+
}
|
|
76
|
+
declare const imageUrlPartSchema: z.ZodObject<{
|
|
77
|
+
id: z.ZodString;
|
|
78
|
+
type: z.ZodLiteral<"imageUrlPart">;
|
|
79
|
+
url: z.ZodURL;
|
|
80
|
+
mimeType: z.ZodString;
|
|
81
|
+
}, z.core.$strip>;
|
|
82
|
+
/** Image with base64-encoded inline data */
|
|
83
|
+
interface ImageInlinePart extends BasePart {
|
|
84
|
+
type: "imageInlinePart";
|
|
85
|
+
/** Base64-encoded image data */
|
|
86
|
+
encodedData: string;
|
|
87
|
+
/** MIME type of the image */
|
|
88
|
+
mimeType: string;
|
|
89
|
+
}
|
|
90
|
+
declare const imageInlinePartSchema: z.ZodObject<{
|
|
91
|
+
id: z.ZodString;
|
|
92
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
93
|
+
encodedData: z.ZodString;
|
|
94
|
+
mimeType: z.ZodString;
|
|
95
|
+
}, z.core.$strip>;
|
|
96
|
+
/** Image with binary data (internal use) */
|
|
97
|
+
interface ImageBinaryPart extends BasePart {
|
|
98
|
+
type: "imageBinaryPart";
|
|
99
|
+
/** Binary data as string */
|
|
100
|
+
data: string;
|
|
101
|
+
/** MIME type of the image */
|
|
102
|
+
mimeType: string;
|
|
103
|
+
}
|
|
104
|
+
declare const imageBinaryPartSchema: z.ZodObject<{
|
|
105
|
+
id: z.ZodString;
|
|
106
|
+
type: z.ZodLiteral<"imageBinaryPart">;
|
|
107
|
+
data: z.ZodString;
|
|
108
|
+
mimeType: z.ZodString;
|
|
109
|
+
}, z.core.$strip>;
|
|
110
|
+
/** File referenced by URL */
|
|
111
|
+
interface FileUrlPart extends BasePart {
|
|
112
|
+
type: "fileUrlPart";
|
|
113
|
+
/** URL to the file */
|
|
114
|
+
url: string;
|
|
115
|
+
/** MIME type of the file */
|
|
116
|
+
mimeType: string;
|
|
117
|
+
}
|
|
118
|
+
declare const fileUrlPartSchema: z.ZodObject<{
|
|
119
|
+
id: z.ZodString;
|
|
120
|
+
type: z.ZodLiteral<"fileUrlPart">;
|
|
121
|
+
url: z.ZodString;
|
|
122
|
+
mimeType: z.ZodString;
|
|
123
|
+
}, z.core.$strip>;
|
|
124
|
+
/** File with base64-encoded inline data */
|
|
125
|
+
interface FileInlinePart extends BasePart {
|
|
126
|
+
type: "fileInlinePart";
|
|
127
|
+
/** Base64-encoded file data */
|
|
128
|
+
encodedData: string;
|
|
129
|
+
/** MIME type of the file */
|
|
130
|
+
mimeType: string;
|
|
131
|
+
}
|
|
132
|
+
declare const fileInlinePartSchema: z.ZodObject<{
|
|
133
|
+
id: z.ZodString;
|
|
134
|
+
type: z.ZodLiteral<"fileInlinePart">;
|
|
135
|
+
encodedData: z.ZodString;
|
|
136
|
+
mimeType: z.ZodString;
|
|
137
|
+
}, z.core.$strip>;
|
|
138
|
+
/** File with binary data (internal use) */
|
|
139
|
+
interface FileBinaryPart extends BasePart {
|
|
140
|
+
type: "fileBinaryPart";
|
|
141
|
+
/** Binary data as string */
|
|
142
|
+
data: string;
|
|
143
|
+
/** MIME type of the file */
|
|
144
|
+
mimeType: string;
|
|
145
|
+
}
|
|
146
|
+
declare const fileBinaryPartSchema: z.ZodObject<{
|
|
147
|
+
id: z.ZodString;
|
|
148
|
+
type: z.ZodLiteral<"fileBinaryPart">;
|
|
149
|
+
data: z.ZodString;
|
|
150
|
+
mimeType: z.ZodString;
|
|
151
|
+
}, z.core.$strip>;
|
|
152
|
+
/** A tool call request from the Expert */
|
|
153
|
+
interface ToolCallPart extends BasePart {
|
|
154
|
+
type: "toolCallPart";
|
|
155
|
+
/** Unique identifier for this tool call */
|
|
156
|
+
toolCallId: string;
|
|
157
|
+
/** Name of the tool to call */
|
|
158
|
+
toolName: string;
|
|
159
|
+
/** Arguments to pass to the tool */
|
|
160
|
+
args: unknown;
|
|
161
|
+
}
|
|
162
|
+
declare const toolCallPartSchema: z.ZodObject<{
|
|
163
|
+
id: z.ZodString;
|
|
164
|
+
type: z.ZodLiteral<"toolCallPart">;
|
|
165
|
+
toolCallId: z.ZodString;
|
|
166
|
+
toolName: z.ZodString;
|
|
167
|
+
args: z.ZodUnknown;
|
|
168
|
+
}, z.core.$strip>;
|
|
169
|
+
/** Result of a tool call */
|
|
170
|
+
interface ToolResultPart extends BasePart {
|
|
171
|
+
type: "toolResultPart";
|
|
172
|
+
/** ID of the tool call this result corresponds to */
|
|
173
|
+
toolCallId: string;
|
|
174
|
+
/** Name of the tool that was called */
|
|
175
|
+
toolName: string;
|
|
176
|
+
/** Content of the tool result */
|
|
177
|
+
contents: (TextPart | ImageInlinePart)[];
|
|
178
|
+
/** Whether the tool call resulted in an error */
|
|
179
|
+
isError?: boolean;
|
|
180
|
+
}
|
|
181
|
+
declare const toolResultPartSchema: z.ZodObject<{
|
|
182
|
+
id: z.ZodString;
|
|
183
|
+
type: z.ZodLiteral<"toolResultPart">;
|
|
184
|
+
toolCallId: z.ZodString;
|
|
185
|
+
toolName: z.ZodString;
|
|
186
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
187
|
+
id: z.ZodString;
|
|
188
|
+
type: z.ZodLiteral<"textPart">;
|
|
189
|
+
text: z.ZodString;
|
|
190
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
191
|
+
id: z.ZodString;
|
|
192
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
193
|
+
encodedData: z.ZodString;
|
|
194
|
+
mimeType: z.ZodString;
|
|
195
|
+
}, z.core.$strip>]>>;
|
|
196
|
+
isError: z.ZodOptional<z.ZodBoolean>;
|
|
197
|
+
}, z.core.$strip>;
|
|
198
|
+
/** All possible message part types */
|
|
199
|
+
type MessagePart = TextPart | ImageUrlPart | ImageInlinePart | ImageBinaryPart | FileUrlPart | FileInlinePart | FileBinaryPart | ToolCallPart | ToolResultPart;
|
|
200
|
+
declare const messagePartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
201
|
+
id: z.ZodString;
|
|
202
|
+
type: z.ZodLiteral<"textPart">;
|
|
203
|
+
text: z.ZodString;
|
|
204
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
205
|
+
id: z.ZodString;
|
|
206
|
+
type: z.ZodLiteral<"imageUrlPart">;
|
|
207
|
+
url: z.ZodURL;
|
|
208
|
+
mimeType: z.ZodString;
|
|
209
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
210
|
+
id: z.ZodString;
|
|
211
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
212
|
+
encodedData: z.ZodString;
|
|
213
|
+
mimeType: z.ZodString;
|
|
214
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
215
|
+
id: z.ZodString;
|
|
216
|
+
type: z.ZodLiteral<"imageBinaryPart">;
|
|
217
|
+
data: z.ZodString;
|
|
218
|
+
mimeType: z.ZodString;
|
|
219
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
220
|
+
id: z.ZodString;
|
|
221
|
+
type: z.ZodLiteral<"fileUrlPart">;
|
|
222
|
+
url: z.ZodString;
|
|
223
|
+
mimeType: z.ZodString;
|
|
224
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
225
|
+
id: z.ZodString;
|
|
226
|
+
type: z.ZodLiteral<"fileInlinePart">;
|
|
227
|
+
encodedData: z.ZodString;
|
|
228
|
+
mimeType: z.ZodString;
|
|
229
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
230
|
+
id: z.ZodString;
|
|
231
|
+
type: z.ZodLiteral<"fileBinaryPart">;
|
|
232
|
+
data: z.ZodString;
|
|
233
|
+
mimeType: z.ZodString;
|
|
234
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
235
|
+
id: z.ZodString;
|
|
236
|
+
type: z.ZodLiteral<"toolCallPart">;
|
|
237
|
+
toolCallId: z.ZodString;
|
|
238
|
+
toolName: z.ZodString;
|
|
239
|
+
args: z.ZodUnknown;
|
|
240
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
241
|
+
id: z.ZodString;
|
|
242
|
+
type: z.ZodLiteral<"toolResultPart">;
|
|
243
|
+
toolCallId: z.ZodString;
|
|
244
|
+
toolName: z.ZodString;
|
|
245
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
246
|
+
id: z.ZodString;
|
|
247
|
+
type: z.ZodLiteral<"textPart">;
|
|
248
|
+
text: z.ZodString;
|
|
249
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
250
|
+
id: z.ZodString;
|
|
251
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
252
|
+
encodedData: z.ZodString;
|
|
253
|
+
mimeType: z.ZodString;
|
|
254
|
+
}, z.core.$strip>]>>;
|
|
255
|
+
isError: z.ZodOptional<z.ZodBoolean>;
|
|
256
|
+
}, z.core.$strip>], "type">;
|
|
257
|
+
|
|
258
|
+
/** Base properties shared by all messages */
|
|
259
|
+
interface BaseMessage {
|
|
260
|
+
/** Unique identifier for this message */
|
|
261
|
+
id: string;
|
|
262
|
+
}
|
|
263
|
+
/** System instruction message sent at the start of a conversation */
|
|
264
|
+
interface InstructionMessage extends BaseMessage {
|
|
265
|
+
type: "instructionMessage";
|
|
266
|
+
/** Text content of the instruction */
|
|
267
|
+
contents: TextPart[];
|
|
268
|
+
/** Whether to cache this message for prompt caching */
|
|
269
|
+
cache?: boolean;
|
|
270
|
+
}
|
|
271
|
+
declare const instructionMessageSchema: z.ZodObject<{
|
|
272
|
+
id: z.ZodString;
|
|
273
|
+
type: z.ZodLiteral<"instructionMessage">;
|
|
274
|
+
contents: z.ZodArray<z.ZodObject<{
|
|
275
|
+
id: z.ZodString;
|
|
276
|
+
type: z.ZodLiteral<"textPart">;
|
|
277
|
+
text: z.ZodString;
|
|
278
|
+
}, z.core.$strip>>;
|
|
279
|
+
cache: z.ZodOptional<z.ZodBoolean>;
|
|
280
|
+
}, z.core.$strip>;
|
|
281
|
+
/** Message from the user (human or system providing input) */
|
|
282
|
+
interface UserMessage extends BaseMessage {
|
|
283
|
+
type: "userMessage";
|
|
284
|
+
/** Content of the user message (text, images, or files) */
|
|
285
|
+
contents: (TextPart | ImageUrlPart | ImageInlinePart | ImageBinaryPart | FileUrlPart | FileInlinePart | FileBinaryPart)[];
|
|
286
|
+
/** Whether to cache this message for prompt caching */
|
|
287
|
+
cache?: boolean;
|
|
288
|
+
}
|
|
289
|
+
declare const userMessageSchema: z.ZodObject<{
|
|
290
|
+
id: z.ZodString;
|
|
291
|
+
type: z.ZodLiteral<"userMessage">;
|
|
292
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
293
|
+
id: z.ZodString;
|
|
294
|
+
type: z.ZodLiteral<"textPart">;
|
|
295
|
+
text: z.ZodString;
|
|
296
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
297
|
+
id: z.ZodString;
|
|
298
|
+
type: z.ZodLiteral<"imageUrlPart">;
|
|
299
|
+
url: z.ZodURL;
|
|
300
|
+
mimeType: z.ZodString;
|
|
301
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
302
|
+
id: z.ZodString;
|
|
303
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
304
|
+
encodedData: z.ZodString;
|
|
305
|
+
mimeType: z.ZodString;
|
|
306
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
307
|
+
id: z.ZodString;
|
|
308
|
+
type: z.ZodLiteral<"imageBinaryPart">;
|
|
309
|
+
data: z.ZodString;
|
|
310
|
+
mimeType: z.ZodString;
|
|
311
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
312
|
+
id: z.ZodString;
|
|
313
|
+
type: z.ZodLiteral<"fileUrlPart">;
|
|
314
|
+
url: z.ZodString;
|
|
315
|
+
mimeType: z.ZodString;
|
|
316
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
317
|
+
id: z.ZodString;
|
|
318
|
+
type: z.ZodLiteral<"fileInlinePart">;
|
|
319
|
+
encodedData: z.ZodString;
|
|
320
|
+
mimeType: z.ZodString;
|
|
321
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
322
|
+
id: z.ZodString;
|
|
323
|
+
type: z.ZodLiteral<"fileBinaryPart">;
|
|
324
|
+
data: z.ZodString;
|
|
325
|
+
mimeType: z.ZodString;
|
|
326
|
+
}, z.core.$strip>]>>;
|
|
327
|
+
cache: z.ZodOptional<z.ZodBoolean>;
|
|
328
|
+
}, z.core.$strip>;
|
|
329
|
+
/** Message generated by the Expert (LLM response) */
|
|
330
|
+
interface ExpertMessage extends BaseMessage {
|
|
331
|
+
type: "expertMessage";
|
|
332
|
+
/** Content generated by the Expert (text or tool calls) */
|
|
333
|
+
contents: (TextPart | ToolCallPart)[];
|
|
334
|
+
/** Whether to cache this message for prompt caching */
|
|
335
|
+
cache?: boolean;
|
|
336
|
+
}
|
|
337
|
+
declare const expertMessageSchema: z.ZodObject<{
|
|
338
|
+
id: z.ZodString;
|
|
339
|
+
type: z.ZodLiteral<"expertMessage">;
|
|
340
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
341
|
+
id: z.ZodString;
|
|
342
|
+
type: z.ZodLiteral<"textPart">;
|
|
343
|
+
text: z.ZodString;
|
|
344
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
345
|
+
id: z.ZodString;
|
|
346
|
+
type: z.ZodLiteral<"toolCallPart">;
|
|
347
|
+
toolCallId: z.ZodString;
|
|
348
|
+
toolName: z.ZodString;
|
|
349
|
+
args: z.ZodUnknown;
|
|
350
|
+
}, z.core.$strip>]>>;
|
|
351
|
+
cache: z.ZodOptional<z.ZodBoolean>;
|
|
352
|
+
}, z.core.$strip>;
|
|
353
|
+
/** Message containing tool execution results */
|
|
354
|
+
interface ToolMessage extends BaseMessage {
|
|
355
|
+
type: "toolMessage";
|
|
356
|
+
/** Tool result contents */
|
|
357
|
+
contents: ToolResultPart[];
|
|
358
|
+
/** Whether to cache this message for prompt caching */
|
|
359
|
+
cache?: boolean;
|
|
360
|
+
}
|
|
361
|
+
declare const toolMessageSchema: z.ZodObject<{
|
|
362
|
+
id: z.ZodString;
|
|
363
|
+
type: z.ZodLiteral<"toolMessage">;
|
|
364
|
+
contents: z.ZodArray<z.ZodObject<{
|
|
365
|
+
id: z.ZodString;
|
|
366
|
+
type: z.ZodLiteral<"toolResultPart">;
|
|
367
|
+
toolCallId: z.ZodString;
|
|
368
|
+
toolName: z.ZodString;
|
|
369
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
370
|
+
id: z.ZodString;
|
|
371
|
+
type: z.ZodLiteral<"textPart">;
|
|
372
|
+
text: z.ZodString;
|
|
373
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
374
|
+
id: z.ZodString;
|
|
375
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
376
|
+
encodedData: z.ZodString;
|
|
377
|
+
mimeType: z.ZodString;
|
|
378
|
+
}, z.core.$strip>]>>;
|
|
379
|
+
isError: z.ZodOptional<z.ZodBoolean>;
|
|
380
|
+
}, z.core.$strip>>;
|
|
381
|
+
cache: z.ZodOptional<z.ZodBoolean>;
|
|
382
|
+
}, z.core.$strip>;
|
|
383
|
+
/** All possible message types */
|
|
384
|
+
type Message = InstructionMessage | UserMessage | ExpertMessage | ToolMessage;
|
|
385
|
+
declare const messageSchema: z.ZodUnion<readonly [z.ZodObject<{
|
|
386
|
+
id: z.ZodString;
|
|
387
|
+
type: z.ZodLiteral<"instructionMessage">;
|
|
388
|
+
contents: z.ZodArray<z.ZodObject<{
|
|
389
|
+
id: z.ZodString;
|
|
390
|
+
type: z.ZodLiteral<"textPart">;
|
|
391
|
+
text: z.ZodString;
|
|
392
|
+
}, z.core.$strip>>;
|
|
393
|
+
cache: z.ZodOptional<z.ZodBoolean>;
|
|
394
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
395
|
+
id: z.ZodString;
|
|
396
|
+
type: z.ZodLiteral<"userMessage">;
|
|
397
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
398
|
+
id: z.ZodString;
|
|
399
|
+
type: z.ZodLiteral<"textPart">;
|
|
400
|
+
text: z.ZodString;
|
|
401
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
402
|
+
id: z.ZodString;
|
|
403
|
+
type: z.ZodLiteral<"imageUrlPart">;
|
|
404
|
+
url: z.ZodURL;
|
|
405
|
+
mimeType: z.ZodString;
|
|
406
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
407
|
+
id: z.ZodString;
|
|
408
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
409
|
+
encodedData: z.ZodString;
|
|
410
|
+
mimeType: z.ZodString;
|
|
411
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
412
|
+
id: z.ZodString;
|
|
413
|
+
type: z.ZodLiteral<"imageBinaryPart">;
|
|
414
|
+
data: z.ZodString;
|
|
415
|
+
mimeType: z.ZodString;
|
|
416
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
417
|
+
id: z.ZodString;
|
|
418
|
+
type: z.ZodLiteral<"fileUrlPart">;
|
|
419
|
+
url: z.ZodString;
|
|
420
|
+
mimeType: z.ZodString;
|
|
421
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
422
|
+
id: z.ZodString;
|
|
423
|
+
type: z.ZodLiteral<"fileInlinePart">;
|
|
424
|
+
encodedData: z.ZodString;
|
|
425
|
+
mimeType: z.ZodString;
|
|
426
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
427
|
+
id: z.ZodString;
|
|
428
|
+
type: z.ZodLiteral<"fileBinaryPart">;
|
|
429
|
+
data: z.ZodString;
|
|
430
|
+
mimeType: z.ZodString;
|
|
431
|
+
}, z.core.$strip>]>>;
|
|
432
|
+
cache: z.ZodOptional<z.ZodBoolean>;
|
|
433
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
434
|
+
id: z.ZodString;
|
|
435
|
+
type: z.ZodLiteral<"expertMessage">;
|
|
436
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
437
|
+
id: z.ZodString;
|
|
438
|
+
type: z.ZodLiteral<"textPart">;
|
|
439
|
+
text: z.ZodString;
|
|
440
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
441
|
+
id: z.ZodString;
|
|
442
|
+
type: z.ZodLiteral<"toolCallPart">;
|
|
443
|
+
toolCallId: z.ZodString;
|
|
444
|
+
toolName: z.ZodString;
|
|
445
|
+
args: z.ZodUnknown;
|
|
446
|
+
}, z.core.$strip>]>>;
|
|
447
|
+
cache: z.ZodOptional<z.ZodBoolean>;
|
|
448
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
449
|
+
id: z.ZodString;
|
|
450
|
+
type: z.ZodLiteral<"toolMessage">;
|
|
451
|
+
contents: z.ZodArray<z.ZodObject<{
|
|
452
|
+
id: z.ZodString;
|
|
453
|
+
type: z.ZodLiteral<"toolResultPart">;
|
|
454
|
+
toolCallId: z.ZodString;
|
|
455
|
+
toolName: z.ZodString;
|
|
456
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
457
|
+
id: z.ZodString;
|
|
458
|
+
type: z.ZodLiteral<"textPart">;
|
|
459
|
+
text: z.ZodString;
|
|
460
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
461
|
+
id: z.ZodString;
|
|
462
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
463
|
+
encodedData: z.ZodString;
|
|
464
|
+
mimeType: z.ZodString;
|
|
465
|
+
}, z.core.$strip>]>>;
|
|
466
|
+
isError: z.ZodOptional<z.ZodBoolean>;
|
|
467
|
+
}, z.core.$strip>>;
|
|
468
|
+
cache: z.ZodOptional<z.ZodBoolean>;
|
|
469
|
+
}, z.core.$strip>]>;
|
|
470
|
+
|
|
471
|
+
/** Token usage statistics for a single step or run */
|
|
472
|
+
interface Usage {
|
|
473
|
+
/** Number of tokens in the input prompt */
|
|
474
|
+
inputTokens: number;
|
|
475
|
+
/** Number of tokens generated in the response */
|
|
476
|
+
outputTokens: number;
|
|
477
|
+
/** Number of tokens used for reasoning (extended thinking) */
|
|
478
|
+
reasoningTokens: number;
|
|
479
|
+
/** Total tokens (input + output) */
|
|
480
|
+
totalTokens: number;
|
|
481
|
+
/** Number of input tokens served from cache */
|
|
482
|
+
cachedInputTokens: number;
|
|
483
|
+
}
|
|
484
|
+
declare const usageSchema: z.ZodObject<{
|
|
485
|
+
inputTokens: z.ZodNumber;
|
|
486
|
+
outputTokens: z.ZodNumber;
|
|
487
|
+
reasoningTokens: z.ZodNumber;
|
|
488
|
+
totalTokens: z.ZodNumber;
|
|
489
|
+
cachedInputTokens: z.ZodNumber;
|
|
490
|
+
}, z.core.$strip>;
|
|
491
|
+
|
|
492
|
+
/** Status of a checkpoint in the execution lifecycle */
|
|
493
|
+
type CheckpointStatus = "init" | "proceeding" | "completed" | "stoppedByInteractiveTool" | "stoppedByDelegate" | "stoppedByExceededMaxSteps" | "stoppedByError";
|
|
40
494
|
declare const checkpointStatusSchema: z.ZodEnum<{
|
|
41
495
|
init: "init";
|
|
42
496
|
proceeding: "proceeding";
|
|
@@ -46,7 +500,67 @@ declare const checkpointStatusSchema: z.ZodEnum<{
|
|
|
46
500
|
stoppedByExceededMaxSteps: "stoppedByExceededMaxSteps";
|
|
47
501
|
stoppedByError: "stoppedByError";
|
|
48
502
|
}>;
|
|
49
|
-
|
|
503
|
+
/**
|
|
504
|
+
* A checkpoint represents a point-in-time snapshot of an Expert's execution state.
|
|
505
|
+
* Used for resuming, debugging, and observability.
|
|
506
|
+
*/
|
|
507
|
+
interface Checkpoint {
|
|
508
|
+
/** Unique identifier for this checkpoint */
|
|
509
|
+
id: string;
|
|
510
|
+
/** Run ID this checkpoint belongs to */
|
|
511
|
+
runId: string;
|
|
512
|
+
/** Current execution status */
|
|
513
|
+
status: CheckpointStatus;
|
|
514
|
+
/** Current step number */
|
|
515
|
+
stepNumber: number;
|
|
516
|
+
/** All messages in the conversation so far */
|
|
517
|
+
messages: Message[];
|
|
518
|
+
/** Expert executing this checkpoint */
|
|
519
|
+
expert: {
|
|
520
|
+
/** Expert key (e.g., "my-expert@1.0.0") */
|
|
521
|
+
key: string;
|
|
522
|
+
/** Expert name */
|
|
523
|
+
name: string;
|
|
524
|
+
/** Expert version */
|
|
525
|
+
version: string;
|
|
526
|
+
};
|
|
527
|
+
/** If delegating, information about the target Expert */
|
|
528
|
+
delegateTo?: {
|
|
529
|
+
/** The Expert being delegated to */
|
|
530
|
+
expert: {
|
|
531
|
+
key: string;
|
|
532
|
+
name: string;
|
|
533
|
+
version: string;
|
|
534
|
+
};
|
|
535
|
+
/** Tool call ID that triggered delegation */
|
|
536
|
+
toolCallId: string;
|
|
537
|
+
/** Name of the delegation tool */
|
|
538
|
+
toolName: string;
|
|
539
|
+
/** Query passed to the delegate */
|
|
540
|
+
query: string;
|
|
541
|
+
};
|
|
542
|
+
/** If delegated, information about the parent Expert */
|
|
543
|
+
delegatedBy?: {
|
|
544
|
+
/** The parent Expert that delegated */
|
|
545
|
+
expert: {
|
|
546
|
+
key: string;
|
|
547
|
+
name: string;
|
|
548
|
+
version: string;
|
|
549
|
+
};
|
|
550
|
+
/** Tool call ID from the parent */
|
|
551
|
+
toolCallId: string;
|
|
552
|
+
/** Name of the delegation tool */
|
|
553
|
+
toolName: string;
|
|
554
|
+
/** Checkpoint ID of the parent */
|
|
555
|
+
checkpointId: string;
|
|
556
|
+
};
|
|
557
|
+
/** Accumulated token usage */
|
|
558
|
+
usage: Usage;
|
|
559
|
+
/** Model's context window size in tokens */
|
|
560
|
+
contextWindow?: number;
|
|
561
|
+
/** Context window usage ratio (0-1) */
|
|
562
|
+
contextWindowUsage?: number;
|
|
563
|
+
}
|
|
50
564
|
declare const checkpointSchema: z.ZodObject<{
|
|
51
565
|
id: z.ZodString;
|
|
52
566
|
runId: z.ZodString;
|
|
@@ -180,8 +694,178 @@ declare const checkpointSchema: z.ZodObject<{
|
|
|
180
694
|
contextWindow: z.ZodOptional<z.ZodNumber>;
|
|
181
695
|
contextWindowUsage: z.ZodOptional<z.ZodNumber>;
|
|
182
696
|
}, z.core.$strip>;
|
|
183
|
-
type Checkpoint = z.infer<typeof checkpointSchema>;
|
|
184
697
|
|
|
698
|
+
/** MCP skill using stdio transport */
|
|
699
|
+
interface McpStdioSkill {
|
|
700
|
+
type: "mcpStdioSkill";
|
|
701
|
+
/** Skill name (derived from key) */
|
|
702
|
+
name: string;
|
|
703
|
+
/** Human-readable description */
|
|
704
|
+
description?: string;
|
|
705
|
+
/** Usage rules for the LLM */
|
|
706
|
+
rule?: string;
|
|
707
|
+
/** Tool names to include (whitelist) */
|
|
708
|
+
pick: string[];
|
|
709
|
+
/** Tool names to exclude (blacklist) */
|
|
710
|
+
omit: string[];
|
|
711
|
+
/** Command to execute (e.g., "npx") */
|
|
712
|
+
command: string;
|
|
713
|
+
/** Package name for npx/uvx */
|
|
714
|
+
packageName?: string;
|
|
715
|
+
/** Additional arguments */
|
|
716
|
+
args: string[];
|
|
717
|
+
/** Environment variables required by this skill */
|
|
718
|
+
requiredEnv: string[];
|
|
719
|
+
/** Whether to delay initialization until first use */
|
|
720
|
+
lazyInit: boolean;
|
|
721
|
+
}
|
|
722
|
+
declare const mcpStdioSkillSchema: z.ZodObject<{
|
|
723
|
+
type: z.ZodLiteral<"mcpStdioSkill">;
|
|
724
|
+
name: z.ZodString;
|
|
725
|
+
description: z.ZodOptional<z.ZodString>;
|
|
726
|
+
rule: z.ZodOptional<z.ZodString>;
|
|
727
|
+
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
728
|
+
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
729
|
+
command: z.ZodString;
|
|
730
|
+
packageName: z.ZodOptional<z.ZodString>;
|
|
731
|
+
args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
732
|
+
requiredEnv: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
733
|
+
lazyInit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
734
|
+
}, z.core.$strip>;
|
|
735
|
+
/** MCP skill using SSE transport */
|
|
736
|
+
interface McpSseSkill {
|
|
737
|
+
type: "mcpSseSkill";
|
|
738
|
+
/** Skill name (derived from key) */
|
|
739
|
+
name: string;
|
|
740
|
+
/** Human-readable description */
|
|
741
|
+
description?: string;
|
|
742
|
+
/** Usage rules for the LLM */
|
|
743
|
+
rule?: string;
|
|
744
|
+
/** Tool names to include (whitelist) */
|
|
745
|
+
pick: string[];
|
|
746
|
+
/** Tool names to exclude (blacklist) */
|
|
747
|
+
omit: string[];
|
|
748
|
+
/** SSE endpoint URL */
|
|
749
|
+
endpoint: string;
|
|
750
|
+
}
|
|
751
|
+
declare const mcpSseSkillSchema: z.ZodObject<{
|
|
752
|
+
type: z.ZodLiteral<"mcpSseSkill">;
|
|
753
|
+
name: z.ZodString;
|
|
754
|
+
description: z.ZodOptional<z.ZodString>;
|
|
755
|
+
rule: z.ZodOptional<z.ZodString>;
|
|
756
|
+
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
757
|
+
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
758
|
+
endpoint: z.ZodString;
|
|
759
|
+
}, z.core.$strip>;
|
|
760
|
+
/** Definition of an interactive tool within an interactive skill */
|
|
761
|
+
interface InteractiveTool {
|
|
762
|
+
/** Tool name */
|
|
763
|
+
name: string;
|
|
764
|
+
/** Human-readable description */
|
|
765
|
+
description?: string;
|
|
766
|
+
/** JSON Schema for tool input as a string */
|
|
767
|
+
inputJsonSchema: string;
|
|
768
|
+
}
|
|
769
|
+
declare const interactiveToolSchema: z.ZodObject<{
|
|
770
|
+
name: z.ZodString;
|
|
771
|
+
description: z.ZodOptional<z.ZodString>;
|
|
772
|
+
inputJsonSchema: z.ZodString;
|
|
773
|
+
}, z.core.$strip>;
|
|
774
|
+
/** Skill that requires human interaction to complete tool calls */
|
|
775
|
+
interface InteractiveSkill {
|
|
776
|
+
type: "interactiveSkill";
|
|
777
|
+
/** Skill name (derived from key) */
|
|
778
|
+
name: string;
|
|
779
|
+
/** Human-readable description */
|
|
780
|
+
description?: string;
|
|
781
|
+
/** Usage rules for the LLM */
|
|
782
|
+
rule?: string;
|
|
783
|
+
/** Map of tool name to tool definition */
|
|
784
|
+
tools: Record<string, InteractiveTool>;
|
|
785
|
+
}
|
|
786
|
+
declare const interactiveSkillSchema: z.ZodObject<{
|
|
787
|
+
type: z.ZodLiteral<"interactiveSkill">;
|
|
788
|
+
name: z.ZodString;
|
|
789
|
+
description: z.ZodOptional<z.ZodString>;
|
|
790
|
+
rule: z.ZodOptional<z.ZodString>;
|
|
791
|
+
tools: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
792
|
+
description: z.ZodOptional<z.ZodString>;
|
|
793
|
+
inputJsonSchema: z.ZodString;
|
|
794
|
+
}, z.core.$strip>>, z.ZodTransform<{
|
|
795
|
+
[k: string]: {
|
|
796
|
+
name: string;
|
|
797
|
+
inputJsonSchema: string;
|
|
798
|
+
description?: string | undefined;
|
|
799
|
+
};
|
|
800
|
+
}, Record<string, {
|
|
801
|
+
inputJsonSchema: string;
|
|
802
|
+
description?: string | undefined;
|
|
803
|
+
}>>>;
|
|
804
|
+
}, z.core.$strip>;
|
|
805
|
+
/** All possible skill types */
|
|
806
|
+
type Skill = McpStdioSkill | McpSseSkill | InteractiveSkill;
|
|
807
|
+
declare const skillSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
808
|
+
type: z.ZodLiteral<"mcpStdioSkill">;
|
|
809
|
+
name: z.ZodString;
|
|
810
|
+
description: z.ZodOptional<z.ZodString>;
|
|
811
|
+
rule: z.ZodOptional<z.ZodString>;
|
|
812
|
+
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
813
|
+
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
814
|
+
command: z.ZodString;
|
|
815
|
+
packageName: z.ZodOptional<z.ZodString>;
|
|
816
|
+
args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
817
|
+
requiredEnv: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
818
|
+
lazyInit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
819
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
820
|
+
type: z.ZodLiteral<"mcpSseSkill">;
|
|
821
|
+
name: z.ZodString;
|
|
822
|
+
description: z.ZodOptional<z.ZodString>;
|
|
823
|
+
rule: z.ZodOptional<z.ZodString>;
|
|
824
|
+
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
825
|
+
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
826
|
+
endpoint: z.ZodString;
|
|
827
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
828
|
+
type: z.ZodLiteral<"interactiveSkill">;
|
|
829
|
+
name: z.ZodString;
|
|
830
|
+
description: z.ZodOptional<z.ZodString>;
|
|
831
|
+
rule: z.ZodOptional<z.ZodString>;
|
|
832
|
+
tools: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
833
|
+
description: z.ZodOptional<z.ZodString>;
|
|
834
|
+
inputJsonSchema: z.ZodString;
|
|
835
|
+
}, z.core.$strip>>, z.ZodTransform<{
|
|
836
|
+
[k: string]: {
|
|
837
|
+
name: string;
|
|
838
|
+
inputJsonSchema: string;
|
|
839
|
+
description?: string | undefined;
|
|
840
|
+
};
|
|
841
|
+
}, Record<string, {
|
|
842
|
+
inputJsonSchema: string;
|
|
843
|
+
description?: string | undefined;
|
|
844
|
+
}>>>;
|
|
845
|
+
}, z.core.$strip>], "type">;
|
|
846
|
+
|
|
847
|
+
/**
|
|
848
|
+
* An Expert definition - an AI agent with specific skills and instructions.
|
|
849
|
+
* Experts can delegate to other Experts and use MCP tools.
|
|
850
|
+
*/
|
|
851
|
+
interface Expert {
|
|
852
|
+
/** Unique key identifying this Expert (e.g., "my-expert" or "my-expert@1.0.0") */
|
|
853
|
+
key: string;
|
|
854
|
+
/** Display name for the Expert */
|
|
855
|
+
name: string;
|
|
856
|
+
/** Semantic version string */
|
|
857
|
+
version: string;
|
|
858
|
+
/** Human-readable description of what this Expert does */
|
|
859
|
+
description?: string;
|
|
860
|
+
/** System instruction defining the Expert's behavior */
|
|
861
|
+
instruction: string;
|
|
862
|
+
/** Map of skill name to skill configuration */
|
|
863
|
+
skills: Record<string, Skill>;
|
|
864
|
+
/** List of Expert keys this Expert can delegate to */
|
|
865
|
+
delegates: string[];
|
|
866
|
+
/** Tags for categorization and discovery */
|
|
867
|
+
tags: string[];
|
|
868
|
+
}
|
|
185
869
|
declare const expertSchema: z.ZodObject<{
|
|
186
870
|
key: z.ZodString;
|
|
187
871
|
name: z.ZodString;
|
|
@@ -190,8 +874,8 @@ declare const expertSchema: z.ZodObject<{
|
|
|
190
874
|
instruction: z.ZodString;
|
|
191
875
|
skills: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
192
876
|
type: z.ZodLiteral<"mcpStdioSkill">;
|
|
193
|
-
args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
194
877
|
description: z.ZodOptional<z.ZodString>;
|
|
878
|
+
args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
195
879
|
rule: z.ZodOptional<z.ZodString>;
|
|
196
880
|
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
197
881
|
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
@@ -290,412 +974,255 @@ declare const expertSchema: z.ZodObject<{
|
|
|
290
974
|
delegates: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
291
975
|
tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
292
976
|
}, z.core.$strip>;
|
|
293
|
-
type Expert = z.infer<typeof expertSchema>;
|
|
294
977
|
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
declare const basePartSchema: z.ZodObject<{
|
|
299
|
-
id: z.ZodString;
|
|
300
|
-
}, z.core.$strip>;
|
|
301
|
-
type BasePart = z.infer<typeof basePartSchema>;
|
|
302
|
-
declare const textPartSchema: z.ZodObject<{
|
|
303
|
-
id: z.ZodString;
|
|
304
|
-
type: z.ZodLiteral<"textPart">;
|
|
305
|
-
text: z.ZodString;
|
|
306
|
-
}, z.core.$strip>;
|
|
307
|
-
type TextPart = z.infer<typeof textPartSchema>;
|
|
308
|
-
declare const imageUrlPartSchema: z.ZodObject<{
|
|
309
|
-
id: z.ZodString;
|
|
310
|
-
type: z.ZodLiteral<"imageUrlPart">;
|
|
311
|
-
url: z.ZodURL;
|
|
312
|
-
mimeType: z.ZodString;
|
|
313
|
-
}, z.core.$strip>;
|
|
314
|
-
type ImageUrlPart = z.infer<typeof imageUrlPartSchema>;
|
|
315
|
-
declare const imageInlinePartSchema: z.ZodObject<{
|
|
316
|
-
id: z.ZodString;
|
|
317
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
318
|
-
encodedData: z.ZodString;
|
|
319
|
-
mimeType: z.ZodString;
|
|
320
|
-
}, z.core.$strip>;
|
|
321
|
-
type ImageInlinePart = z.infer<typeof imageInlinePartSchema>;
|
|
322
|
-
declare const imageBinaryPartSchema: z.ZodObject<{
|
|
323
|
-
id: z.ZodString;
|
|
324
|
-
type: z.ZodLiteral<"imageBinaryPart">;
|
|
325
|
-
data: z.ZodString;
|
|
326
|
-
mimeType: z.ZodString;
|
|
327
|
-
}, z.core.$strip>;
|
|
328
|
-
type ImageBinaryPart = z.infer<typeof imageBinaryPartSchema>;
|
|
329
|
-
declare const fileUrlPartSchema: z.ZodObject<{
|
|
330
|
-
id: z.ZodString;
|
|
331
|
-
type: z.ZodLiteral<"fileUrlPart">;
|
|
332
|
-
url: z.ZodString;
|
|
333
|
-
mimeType: z.ZodString;
|
|
334
|
-
}, z.core.$strip>;
|
|
335
|
-
type FileUrlPart = z.infer<typeof fileUrlPartSchema>;
|
|
336
|
-
declare const fileInlinePartSchema: z.ZodObject<{
|
|
337
|
-
id: z.ZodString;
|
|
338
|
-
type: z.ZodLiteral<"fileInlinePart">;
|
|
339
|
-
encodedData: z.ZodString;
|
|
340
|
-
mimeType: z.ZodString;
|
|
341
|
-
}, z.core.$strip>;
|
|
342
|
-
type FileInlinePart = z.infer<typeof fileInlinePartSchema>;
|
|
343
|
-
declare const fileBinaryPartSchema: z.ZodObject<{
|
|
344
|
-
id: z.ZodString;
|
|
345
|
-
type: z.ZodLiteral<"fileBinaryPart">;
|
|
346
|
-
data: z.ZodString;
|
|
347
|
-
mimeType: z.ZodString;
|
|
978
|
+
declare const anthropicSettingSchema: z.ZodObject<{
|
|
979
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
980
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
348
981
|
}, z.core.$strip>;
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
type: z.ZodLiteral<"toolCallPart">;
|
|
353
|
-
toolCallId: z.ZodString;
|
|
354
|
-
toolName: z.ZodString;
|
|
355
|
-
args: z.ZodUnknown;
|
|
982
|
+
declare const googleSettingSchema: z.ZodObject<{
|
|
983
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
984
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
356
985
|
}, z.core.$strip>;
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
364
|
-
id: z.ZodString;
|
|
365
|
-
type: z.ZodLiteral<"textPart">;
|
|
366
|
-
text: z.ZodString;
|
|
367
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
368
|
-
id: z.ZodString;
|
|
369
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
370
|
-
encodedData: z.ZodString;
|
|
371
|
-
mimeType: z.ZodString;
|
|
372
|
-
}, z.core.$strip>]>>;
|
|
373
|
-
isError: z.ZodOptional<z.ZodBoolean>;
|
|
986
|
+
declare const openAiSettingSchema: z.ZodObject<{
|
|
987
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
988
|
+
organization: z.ZodOptional<z.ZodString>;
|
|
989
|
+
project: z.ZodOptional<z.ZodString>;
|
|
990
|
+
name: z.ZodOptional<z.ZodString>;
|
|
991
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
374
992
|
}, z.core.$strip>;
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
type: z.ZodLiteral<"textPart">;
|
|
379
|
-
text: z.ZodString;
|
|
380
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
381
|
-
id: z.ZodString;
|
|
382
|
-
type: z.ZodLiteral<"imageUrlPart">;
|
|
383
|
-
url: z.ZodURL;
|
|
384
|
-
mimeType: z.ZodString;
|
|
385
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
386
|
-
id: z.ZodString;
|
|
387
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
388
|
-
encodedData: z.ZodString;
|
|
389
|
-
mimeType: z.ZodString;
|
|
390
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
391
|
-
id: z.ZodString;
|
|
392
|
-
type: z.ZodLiteral<"imageBinaryPart">;
|
|
393
|
-
data: z.ZodString;
|
|
394
|
-
mimeType: z.ZodString;
|
|
395
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
396
|
-
id: z.ZodString;
|
|
397
|
-
type: z.ZodLiteral<"fileUrlPart">;
|
|
398
|
-
url: z.ZodString;
|
|
399
|
-
mimeType: z.ZodString;
|
|
400
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
401
|
-
id: z.ZodString;
|
|
402
|
-
type: z.ZodLiteral<"fileInlinePart">;
|
|
403
|
-
encodedData: z.ZodString;
|
|
404
|
-
mimeType: z.ZodString;
|
|
405
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
406
|
-
id: z.ZodString;
|
|
407
|
-
type: z.ZodLiteral<"fileBinaryPart">;
|
|
408
|
-
data: z.ZodString;
|
|
409
|
-
mimeType: z.ZodString;
|
|
410
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
411
|
-
id: z.ZodString;
|
|
412
|
-
type: z.ZodLiteral<"toolCallPart">;
|
|
413
|
-
toolCallId: z.ZodString;
|
|
414
|
-
toolName: z.ZodString;
|
|
415
|
-
args: z.ZodUnknown;
|
|
416
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
417
|
-
id: z.ZodString;
|
|
418
|
-
type: z.ZodLiteral<"toolResultPart">;
|
|
419
|
-
toolCallId: z.ZodString;
|
|
420
|
-
toolName: z.ZodString;
|
|
421
|
-
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
422
|
-
id: z.ZodString;
|
|
423
|
-
type: z.ZodLiteral<"textPart">;
|
|
424
|
-
text: z.ZodString;
|
|
425
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
426
|
-
id: z.ZodString;
|
|
427
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
428
|
-
encodedData: z.ZodString;
|
|
429
|
-
mimeType: z.ZodString;
|
|
430
|
-
}, z.core.$strip>]>>;
|
|
431
|
-
isError: z.ZodOptional<z.ZodBoolean>;
|
|
432
|
-
}, z.core.$strip>], "type">;
|
|
433
|
-
type MessagePart = z.infer<typeof messagePartSchema>;
|
|
434
|
-
|
|
435
|
-
declare const instructionMessageSchema: z.ZodObject<{
|
|
436
|
-
id: z.ZodString;
|
|
437
|
-
type: z.ZodLiteral<"instructionMessage">;
|
|
438
|
-
contents: z.ZodArray<z.ZodObject<{
|
|
439
|
-
id: z.ZodString;
|
|
440
|
-
type: z.ZodLiteral<"textPart">;
|
|
441
|
-
text: z.ZodString;
|
|
442
|
-
}, z.core.$strip>>;
|
|
443
|
-
cache: z.ZodOptional<z.ZodBoolean>;
|
|
993
|
+
declare const ollamaSettingSchema: z.ZodObject<{
|
|
994
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
995
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
444
996
|
}, z.core.$strip>;
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
type: z.ZodLiteral<"textPart">;
|
|
452
|
-
text: z.ZodString;
|
|
453
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
454
|
-
id: z.ZodString;
|
|
455
|
-
type: z.ZodLiteral<"imageUrlPart">;
|
|
456
|
-
url: z.ZodURL;
|
|
457
|
-
mimeType: z.ZodString;
|
|
458
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
459
|
-
id: z.ZodString;
|
|
460
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
461
|
-
encodedData: z.ZodString;
|
|
462
|
-
mimeType: z.ZodString;
|
|
463
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
464
|
-
id: z.ZodString;
|
|
465
|
-
type: z.ZodLiteral<"imageBinaryPart">;
|
|
466
|
-
data: z.ZodString;
|
|
467
|
-
mimeType: z.ZodString;
|
|
468
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
469
|
-
id: z.ZodString;
|
|
470
|
-
type: z.ZodLiteral<"fileUrlPart">;
|
|
471
|
-
url: z.ZodString;
|
|
472
|
-
mimeType: z.ZodString;
|
|
473
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
474
|
-
id: z.ZodString;
|
|
475
|
-
type: z.ZodLiteral<"fileInlinePart">;
|
|
476
|
-
encodedData: z.ZodString;
|
|
477
|
-
mimeType: z.ZodString;
|
|
478
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
479
|
-
id: z.ZodString;
|
|
480
|
-
type: z.ZodLiteral<"fileBinaryPart">;
|
|
481
|
-
data: z.ZodString;
|
|
482
|
-
mimeType: z.ZodString;
|
|
483
|
-
}, z.core.$strip>]>>;
|
|
484
|
-
cache: z.ZodOptional<z.ZodBoolean>;
|
|
997
|
+
declare const azureOpenAiSettingSchema: z.ZodObject<{
|
|
998
|
+
resourceName: z.ZodOptional<z.ZodString>;
|
|
999
|
+
apiVersion: z.ZodOptional<z.ZodString>;
|
|
1000
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
1001
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
1002
|
+
useDeploymentBasedUrls: z.ZodOptional<z.ZodBoolean>;
|
|
485
1003
|
}, z.core.$strip>;
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
id: z.ZodString;
|
|
489
|
-
type: z.ZodLiteral<"expertMessage">;
|
|
490
|
-
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
491
|
-
id: z.ZodString;
|
|
492
|
-
type: z.ZodLiteral<"textPart">;
|
|
493
|
-
text: z.ZodString;
|
|
494
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
495
|
-
id: z.ZodString;
|
|
496
|
-
type: z.ZodLiteral<"toolCallPart">;
|
|
497
|
-
toolCallId: z.ZodString;
|
|
498
|
-
toolName: z.ZodString;
|
|
499
|
-
args: z.ZodUnknown;
|
|
500
|
-
}, z.core.$strip>]>>;
|
|
501
|
-
cache: z.ZodOptional<z.ZodBoolean>;
|
|
1004
|
+
declare const amazonBedrockSettingSchema: z.ZodObject<{
|
|
1005
|
+
region: z.ZodOptional<z.ZodString>;
|
|
502
1006
|
}, z.core.$strip>;
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
id: z.ZodString;
|
|
509
|
-
type: z.ZodLiteral<"toolResultPart">;
|
|
510
|
-
toolCallId: z.ZodString;
|
|
511
|
-
toolName: z.ZodString;
|
|
512
|
-
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
513
|
-
id: z.ZodString;
|
|
514
|
-
type: z.ZodLiteral<"textPart">;
|
|
515
|
-
text: z.ZodString;
|
|
516
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
517
|
-
id: z.ZodString;
|
|
518
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
519
|
-
encodedData: z.ZodString;
|
|
520
|
-
mimeType: z.ZodString;
|
|
521
|
-
}, z.core.$strip>]>>;
|
|
522
|
-
isError: z.ZodOptional<z.ZodBoolean>;
|
|
523
|
-
}, z.core.$strip>>;
|
|
524
|
-
cache: z.ZodOptional<z.ZodBoolean>;
|
|
1007
|
+
declare const googleVertexSettingSchema: z.ZodObject<{
|
|
1008
|
+
project: z.ZodOptional<z.ZodString>;
|
|
1009
|
+
location: z.ZodOptional<z.ZodString>;
|
|
1010
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
1011
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
525
1012
|
}, z.core.$strip>;
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
id: z.ZodString;
|
|
560
|
-
type: z.ZodLiteral<"fileUrlPart">;
|
|
561
|
-
url: z.ZodString;
|
|
562
|
-
mimeType: z.ZodString;
|
|
563
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
564
|
-
id: z.ZodString;
|
|
565
|
-
type: z.ZodLiteral<"fileInlinePart">;
|
|
566
|
-
encodedData: z.ZodString;
|
|
567
|
-
mimeType: z.ZodString;
|
|
568
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
569
|
-
id: z.ZodString;
|
|
570
|
-
type: z.ZodLiteral<"fileBinaryPart">;
|
|
571
|
-
data: z.ZodString;
|
|
572
|
-
mimeType: z.ZodString;
|
|
573
|
-
}, z.core.$strip>]>>;
|
|
574
|
-
cache: z.ZodOptional<z.ZodBoolean>;
|
|
575
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
576
|
-
id: z.ZodString;
|
|
577
|
-
type: z.ZodLiteral<"expertMessage">;
|
|
578
|
-
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
579
|
-
id: z.ZodString;
|
|
580
|
-
type: z.ZodLiteral<"textPart">;
|
|
581
|
-
text: z.ZodString;
|
|
582
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
583
|
-
id: z.ZodString;
|
|
584
|
-
type: z.ZodLiteral<"toolCallPart">;
|
|
585
|
-
toolCallId: z.ZodString;
|
|
586
|
-
toolName: z.ZodString;
|
|
587
|
-
args: z.ZodUnknown;
|
|
588
|
-
}, z.core.$strip>]>>;
|
|
589
|
-
cache: z.ZodOptional<z.ZodBoolean>;
|
|
590
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
591
|
-
id: z.ZodString;
|
|
592
|
-
type: z.ZodLiteral<"toolMessage">;
|
|
593
|
-
contents: z.ZodArray<z.ZodObject<{
|
|
594
|
-
id: z.ZodString;
|
|
595
|
-
type: z.ZodLiteral<"toolResultPart">;
|
|
596
|
-
toolCallId: z.ZodString;
|
|
597
|
-
toolName: z.ZodString;
|
|
598
|
-
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
599
|
-
id: z.ZodString;
|
|
600
|
-
type: z.ZodLiteral<"textPart">;
|
|
601
|
-
text: z.ZodString;
|
|
602
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
603
|
-
id: z.ZodString;
|
|
604
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
605
|
-
encodedData: z.ZodString;
|
|
606
|
-
mimeType: z.ZodString;
|
|
607
|
-
}, z.core.$strip>]>>;
|
|
608
|
-
isError: z.ZodOptional<z.ZodBoolean>;
|
|
609
|
-
}, z.core.$strip>>;
|
|
610
|
-
cache: z.ZodOptional<z.ZodBoolean>;
|
|
611
|
-
}, z.core.$strip>]>;
|
|
612
|
-
type Message = z.infer<typeof messageSchema>;
|
|
613
|
-
|
|
614
|
-
declare const providerTableSchema: z.ZodObject<{
|
|
615
|
-
providerName: z.ZodEnum<{
|
|
616
|
-
anthropic: "anthropic";
|
|
617
|
-
google: "google";
|
|
618
|
-
openai: "openai";
|
|
619
|
-
ollama: "ollama";
|
|
620
|
-
"azure-openai": "azure-openai";
|
|
621
|
-
"amazon-bedrock": "amazon-bedrock";
|
|
622
|
-
"google-vertex": "google-vertex";
|
|
623
|
-
}>;
|
|
624
|
-
setting: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
|
|
1013
|
+
declare const deepseekSettingSchema: z.ZodObject<{
|
|
1014
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
1015
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
1016
|
+
}, z.core.$strip>;
|
|
1017
|
+
/** Provider configuration in perstack.toml */
|
|
1018
|
+
type ProviderTable = {
|
|
1019
|
+
providerName: "anthropic";
|
|
1020
|
+
setting?: z.infer<typeof anthropicSettingSchema>;
|
|
1021
|
+
} | {
|
|
1022
|
+
providerName: "google";
|
|
1023
|
+
setting?: z.infer<typeof googleSettingSchema>;
|
|
1024
|
+
} | {
|
|
1025
|
+
providerName: "openai";
|
|
1026
|
+
setting?: z.infer<typeof openAiSettingSchema>;
|
|
1027
|
+
} | {
|
|
1028
|
+
providerName: "ollama";
|
|
1029
|
+
setting?: z.infer<typeof ollamaSettingSchema>;
|
|
1030
|
+
} | {
|
|
1031
|
+
providerName: "azure-openai";
|
|
1032
|
+
setting?: z.infer<typeof azureOpenAiSettingSchema>;
|
|
1033
|
+
} | {
|
|
1034
|
+
providerName: "amazon-bedrock";
|
|
1035
|
+
setting?: z.infer<typeof amazonBedrockSettingSchema>;
|
|
1036
|
+
} | {
|
|
1037
|
+
providerName: "google-vertex";
|
|
1038
|
+
setting?: z.infer<typeof googleVertexSettingSchema>;
|
|
1039
|
+
} | {
|
|
1040
|
+
providerName: "deepseek";
|
|
1041
|
+
setting?: z.infer<typeof deepseekSettingSchema>;
|
|
1042
|
+
};
|
|
1043
|
+
declare const providerTableSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
1044
|
+
providerName: z.ZodLiteral<"anthropic">;
|
|
1045
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
625
1046
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
626
1047
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
627
|
-
}, z.core.$strip
|
|
1048
|
+
}, z.core.$strip>>;
|
|
1049
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1050
|
+
providerName: z.ZodLiteral<"google">;
|
|
1051
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
628
1052
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
629
1053
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
630
|
-
}, z.core.$strip
|
|
1054
|
+
}, z.core.$strip>>;
|
|
1055
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1056
|
+
providerName: z.ZodLiteral<"openai">;
|
|
1057
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
631
1058
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
632
1059
|
organization: z.ZodOptional<z.ZodString>;
|
|
633
1060
|
project: z.ZodOptional<z.ZodString>;
|
|
634
1061
|
name: z.ZodOptional<z.ZodString>;
|
|
635
1062
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
636
|
-
}, z.core.$strip
|
|
1063
|
+
}, z.core.$strip>>;
|
|
1064
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1065
|
+
providerName: z.ZodLiteral<"ollama">;
|
|
1066
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
637
1067
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
638
1068
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
639
|
-
}, z.core.$strip
|
|
1069
|
+
}, z.core.$strip>>;
|
|
1070
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1071
|
+
providerName: z.ZodLiteral<"azure-openai">;
|
|
1072
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
640
1073
|
resourceName: z.ZodOptional<z.ZodString>;
|
|
641
1074
|
apiVersion: z.ZodOptional<z.ZodString>;
|
|
642
1075
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
643
1076
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
644
1077
|
useDeploymentBasedUrls: z.ZodOptional<z.ZodBoolean>;
|
|
645
|
-
}, z.core.$strip
|
|
1078
|
+
}, z.core.$strip>>;
|
|
1079
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1080
|
+
providerName: z.ZodLiteral<"amazon-bedrock">;
|
|
1081
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
646
1082
|
region: z.ZodOptional<z.ZodString>;
|
|
647
|
-
}, z.core.$strip
|
|
1083
|
+
}, z.core.$strip>>;
|
|
1084
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1085
|
+
providerName: z.ZodLiteral<"google-vertex">;
|
|
1086
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
648
1087
|
project: z.ZodOptional<z.ZodString>;
|
|
649
1088
|
location: z.ZodOptional<z.ZodString>;
|
|
650
1089
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
651
1090
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
652
|
-
}, z.core.$strip
|
|
653
|
-
}, z.core.$strip
|
|
654
|
-
|
|
1091
|
+
}, z.core.$strip>>;
|
|
1092
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1093
|
+
providerName: z.ZodLiteral<"deepseek">;
|
|
1094
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
1095
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
1096
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
1097
|
+
}, z.core.$strip>>;
|
|
1098
|
+
}, z.core.$strip>], "providerName">;
|
|
1099
|
+
/** Skill configuration in perstack.toml */
|
|
1100
|
+
type PerstackConfigSkill = {
|
|
1101
|
+
type: "mcpStdioSkill";
|
|
1102
|
+
description?: string;
|
|
1103
|
+
rule?: string;
|
|
1104
|
+
pick?: string[];
|
|
1105
|
+
omit?: string[];
|
|
1106
|
+
command: string;
|
|
1107
|
+
packageName?: string;
|
|
1108
|
+
args?: string[];
|
|
1109
|
+
requiredEnv?: string[];
|
|
1110
|
+
} | {
|
|
1111
|
+
type: "mcpSseSkill";
|
|
1112
|
+
description?: string;
|
|
1113
|
+
rule?: string;
|
|
1114
|
+
pick?: string[];
|
|
1115
|
+
omit?: string[];
|
|
1116
|
+
endpoint: string;
|
|
1117
|
+
} | {
|
|
1118
|
+
type: "interactiveSkill";
|
|
1119
|
+
description?: string;
|
|
1120
|
+
rule?: string;
|
|
1121
|
+
tools: Record<string, {
|
|
1122
|
+
description?: string;
|
|
1123
|
+
inputJsonSchema: string;
|
|
1124
|
+
}>;
|
|
1125
|
+
};
|
|
1126
|
+
/** Expert definition in perstack.toml (simplified from full Expert) */
|
|
1127
|
+
interface PerstackConfigExpert {
|
|
1128
|
+
/** Semantic version */
|
|
1129
|
+
version?: string;
|
|
1130
|
+
/** Minimum runtime version required */
|
|
1131
|
+
minRuntimeVersion?: string;
|
|
1132
|
+
/** Description of the Expert */
|
|
1133
|
+
description?: string;
|
|
1134
|
+
/** System instruction */
|
|
1135
|
+
instruction: string;
|
|
1136
|
+
/** Skills configuration */
|
|
1137
|
+
skills?: Record<string, PerstackConfigSkill>;
|
|
1138
|
+
/** Delegates list */
|
|
1139
|
+
delegates?: string[];
|
|
1140
|
+
/** Tags for categorization */
|
|
1141
|
+
tags?: string[];
|
|
1142
|
+
}
|
|
655
1143
|
/**
|
|
656
|
-
* perstack.toml
|
|
1144
|
+
* Configuration loaded from perstack.toml.
|
|
1145
|
+
* This is the primary configuration file for Perstack projects.
|
|
657
1146
|
*/
|
|
1147
|
+
interface PerstackConfig {
|
|
1148
|
+
/** Default provider configuration */
|
|
1149
|
+
provider?: ProviderTable;
|
|
1150
|
+
/** Default model name */
|
|
1151
|
+
model?: string;
|
|
1152
|
+
/** Default temperature (0-1) */
|
|
1153
|
+
temperature?: number;
|
|
1154
|
+
/** Maximum steps per run */
|
|
1155
|
+
maxSteps?: number;
|
|
1156
|
+
/** Maximum retries on generation failure */
|
|
1157
|
+
maxRetries?: number;
|
|
1158
|
+
/** Timeout per generation in milliseconds */
|
|
1159
|
+
timeout?: number;
|
|
1160
|
+
/** Expert definitions */
|
|
1161
|
+
experts?: Record<string, PerstackConfigExpert>;
|
|
1162
|
+
/** Custom Perstack API base URL */
|
|
1163
|
+
perstackApiBaseUrl?: string;
|
|
1164
|
+
/** Custom command for @perstack/base skill */
|
|
1165
|
+
perstackBaseSkillCommand?: string[];
|
|
1166
|
+
/** Paths to .env files */
|
|
1167
|
+
envPath?: string[];
|
|
1168
|
+
}
|
|
658
1169
|
declare const perstackConfigSchema: z.ZodObject<{
|
|
659
|
-
provider: z.ZodOptional<z.ZodObject<{
|
|
660
|
-
providerName: z.
|
|
661
|
-
|
|
662
|
-
google: "google";
|
|
663
|
-
openai: "openai";
|
|
664
|
-
ollama: "ollama";
|
|
665
|
-
"azure-openai": "azure-openai";
|
|
666
|
-
"amazon-bedrock": "amazon-bedrock";
|
|
667
|
-
"google-vertex": "google-vertex";
|
|
668
|
-
}>;
|
|
669
|
-
setting: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
|
|
1170
|
+
provider: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
1171
|
+
providerName: z.ZodLiteral<"anthropic">;
|
|
1172
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
670
1173
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
671
1174
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
672
|
-
}, z.core.$strip
|
|
1175
|
+
}, z.core.$strip>>;
|
|
1176
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1177
|
+
providerName: z.ZodLiteral<"google">;
|
|
1178
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
673
1179
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
674
1180
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
675
|
-
}, z.core.$strip
|
|
1181
|
+
}, z.core.$strip>>;
|
|
1182
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1183
|
+
providerName: z.ZodLiteral<"openai">;
|
|
1184
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
676
1185
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
677
1186
|
organization: z.ZodOptional<z.ZodString>;
|
|
678
1187
|
project: z.ZodOptional<z.ZodString>;
|
|
679
1188
|
name: z.ZodOptional<z.ZodString>;
|
|
680
1189
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
681
|
-
}, z.core.$strip
|
|
1190
|
+
}, z.core.$strip>>;
|
|
1191
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1192
|
+
providerName: z.ZodLiteral<"ollama">;
|
|
1193
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
682
1194
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
683
1195
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
684
|
-
}, z.core.$strip
|
|
1196
|
+
}, z.core.$strip>>;
|
|
1197
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1198
|
+
providerName: z.ZodLiteral<"azure-openai">;
|
|
1199
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
685
1200
|
resourceName: z.ZodOptional<z.ZodString>;
|
|
686
1201
|
apiVersion: z.ZodOptional<z.ZodString>;
|
|
687
1202
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
688
1203
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
689
1204
|
useDeploymentBasedUrls: z.ZodOptional<z.ZodBoolean>;
|
|
690
|
-
}, z.core.$strip
|
|
1205
|
+
}, z.core.$strip>>;
|
|
1206
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1207
|
+
providerName: z.ZodLiteral<"amazon-bedrock">;
|
|
1208
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
691
1209
|
region: z.ZodOptional<z.ZodString>;
|
|
692
|
-
}, z.core.$strip
|
|
1210
|
+
}, z.core.$strip>>;
|
|
1211
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1212
|
+
providerName: z.ZodLiteral<"google-vertex">;
|
|
1213
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
693
1214
|
project: z.ZodOptional<z.ZodString>;
|
|
694
1215
|
location: z.ZodOptional<z.ZodString>;
|
|
695
1216
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
696
1217
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
697
|
-
}, z.core.$strip
|
|
698
|
-
}, z.core.$strip
|
|
1218
|
+
}, z.core.$strip>>;
|
|
1219
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1220
|
+
providerName: z.ZodLiteral<"deepseek">;
|
|
1221
|
+
setting: z.ZodOptional<z.ZodObject<{
|
|
1222
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
1223
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
1224
|
+
}, z.core.$strip>>;
|
|
1225
|
+
}, z.core.$strip>], "providerName">>;
|
|
699
1226
|
model: z.ZodOptional<z.ZodString>;
|
|
700
1227
|
temperature: z.ZodOptional<z.ZodNumber>;
|
|
701
1228
|
maxSteps: z.ZodOptional<z.ZodNumber>;
|
|
@@ -733,38 +1260,76 @@ declare const perstackConfigSchema: z.ZodObject<{
|
|
|
733
1260
|
}, z.core.$strip>>;
|
|
734
1261
|
}, z.core.$strip>], "type">>>;
|
|
735
1262
|
delegates: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
1263
|
+
tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
736
1264
|
}, z.core.$strip>>>;
|
|
737
1265
|
perstackApiBaseUrl: z.ZodOptional<z.ZodURL>;
|
|
738
1266
|
perstackBaseSkillCommand: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
739
1267
|
envPath: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
740
1268
|
}, z.core.$strip>;
|
|
741
|
-
type PerstackConfig = z.infer<typeof perstackConfigSchema>;
|
|
742
1269
|
|
|
1270
|
+
/** HTTP headers for API requests */
|
|
1271
|
+
type Headers = Record<string, string> | undefined;
|
|
743
1272
|
declare const headersSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
1273
|
+
/** Supported LLM provider names */
|
|
1274
|
+
type ProviderName = "anthropic" | "google" | "openai" | "ollama" | "azure-openai" | "amazon-bedrock" | "google-vertex" | "deepseek";
|
|
744
1275
|
declare const providerNameSchema: z.ZodEnum<{
|
|
745
1276
|
anthropic: "anthropic";
|
|
746
1277
|
google: "google";
|
|
747
1278
|
openai: "openai";
|
|
1279
|
+
deepseek: "deepseek";
|
|
748
1280
|
ollama: "ollama";
|
|
749
1281
|
"azure-openai": "azure-openai";
|
|
750
1282
|
"amazon-bedrock": "amazon-bedrock";
|
|
751
1283
|
"google-vertex": "google-vertex";
|
|
752
1284
|
}>;
|
|
753
|
-
|
|
1285
|
+
/** Anthropic provider configuration */
|
|
1286
|
+
interface AnthropicProviderConfig {
|
|
1287
|
+
providerName: "anthropic";
|
|
1288
|
+
/** API key for Anthropic */
|
|
1289
|
+
apiKey: string;
|
|
1290
|
+
/** Custom base URL */
|
|
1291
|
+
baseUrl?: string;
|
|
1292
|
+
/** Custom headers */
|
|
1293
|
+
headers?: Headers;
|
|
1294
|
+
}
|
|
754
1295
|
declare const anthropicProviderConfigSchema: z.ZodObject<{
|
|
755
1296
|
providerName: z.ZodLiteral<"anthropic">;
|
|
756
1297
|
apiKey: z.ZodString;
|
|
757
1298
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
758
1299
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
759
1300
|
}, z.core.$strip>;
|
|
760
|
-
|
|
1301
|
+
/** Google Generative AI provider configuration */
|
|
1302
|
+
interface GoogleGenerativeAiProviderConfig {
|
|
1303
|
+
providerName: "google";
|
|
1304
|
+
/** API key for Google */
|
|
1305
|
+
apiKey: string;
|
|
1306
|
+
/** Custom base URL */
|
|
1307
|
+
baseUrl?: string;
|
|
1308
|
+
/** Custom headers */
|
|
1309
|
+
headers?: Headers;
|
|
1310
|
+
}
|
|
761
1311
|
declare const googleGenerativeAiProviderConfigSchema: z.ZodObject<{
|
|
762
1312
|
providerName: z.ZodLiteral<"google">;
|
|
763
1313
|
apiKey: z.ZodString;
|
|
764
1314
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
765
1315
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
766
1316
|
}, z.core.$strip>;
|
|
767
|
-
|
|
1317
|
+
/** OpenAI provider configuration */
|
|
1318
|
+
interface OpenAiProviderConfig {
|
|
1319
|
+
providerName: "openai";
|
|
1320
|
+
/** API key for OpenAI */
|
|
1321
|
+
apiKey: string;
|
|
1322
|
+
/** Custom base URL */
|
|
1323
|
+
baseUrl?: string;
|
|
1324
|
+
/** Organization ID */
|
|
1325
|
+
organization?: string;
|
|
1326
|
+
/** Project ID */
|
|
1327
|
+
project?: string;
|
|
1328
|
+
/** Custom name for the provider instance */
|
|
1329
|
+
name?: string;
|
|
1330
|
+
/** Custom headers */
|
|
1331
|
+
headers?: Headers;
|
|
1332
|
+
}
|
|
768
1333
|
declare const openAiProviderConfigSchema: z.ZodObject<{
|
|
769
1334
|
providerName: z.ZodLiteral<"openai">;
|
|
770
1335
|
apiKey: z.ZodString;
|
|
@@ -774,13 +1339,35 @@ declare const openAiProviderConfigSchema: z.ZodObject<{
|
|
|
774
1339
|
name: z.ZodOptional<z.ZodString>;
|
|
775
1340
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
776
1341
|
}, z.core.$strip>;
|
|
777
|
-
|
|
1342
|
+
/** Ollama provider configuration */
|
|
1343
|
+
interface OllamaProviderConfig {
|
|
1344
|
+
providerName: "ollama";
|
|
1345
|
+
/** Custom base URL (defaults to localhost) */
|
|
1346
|
+
baseUrl?: string;
|
|
1347
|
+
/** Custom headers */
|
|
1348
|
+
headers?: Headers;
|
|
1349
|
+
}
|
|
778
1350
|
declare const ollamaProviderConfigSchema: z.ZodObject<{
|
|
779
1351
|
providerName: z.ZodLiteral<"ollama">;
|
|
780
1352
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
781
1353
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
782
1354
|
}, z.core.$strip>;
|
|
783
|
-
|
|
1355
|
+
/** Azure OpenAI provider configuration */
|
|
1356
|
+
interface AzureOpenAiProviderConfig {
|
|
1357
|
+
providerName: "azure-openai";
|
|
1358
|
+
/** API key for Azure */
|
|
1359
|
+
apiKey: string;
|
|
1360
|
+
/** Azure resource name */
|
|
1361
|
+
resourceName?: string;
|
|
1362
|
+
/** API version */
|
|
1363
|
+
apiVersion?: string;
|
|
1364
|
+
/** Custom base URL */
|
|
1365
|
+
baseUrl?: string;
|
|
1366
|
+
/** Custom headers */
|
|
1367
|
+
headers?: Headers;
|
|
1368
|
+
/** Use deployment-based URLs */
|
|
1369
|
+
useDeploymentBasedUrls?: boolean;
|
|
1370
|
+
}
|
|
784
1371
|
declare const azureOpenAiProviderConfigSchema: z.ZodObject<{
|
|
785
1372
|
providerName: z.ZodLiteral<"azure-openai">;
|
|
786
1373
|
apiKey: z.ZodString;
|
|
@@ -790,7 +1377,18 @@ declare const azureOpenAiProviderConfigSchema: z.ZodObject<{
|
|
|
790
1377
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
791
1378
|
useDeploymentBasedUrls: z.ZodOptional<z.ZodBoolean>;
|
|
792
1379
|
}, z.core.$strip>;
|
|
793
|
-
|
|
1380
|
+
/** Amazon Bedrock provider configuration */
|
|
1381
|
+
interface AmazonBedrockProviderConfig {
|
|
1382
|
+
providerName: "amazon-bedrock";
|
|
1383
|
+
/** AWS access key ID */
|
|
1384
|
+
accessKeyId: string;
|
|
1385
|
+
/** AWS secret access key */
|
|
1386
|
+
secretAccessKey: string;
|
|
1387
|
+
/** AWS region */
|
|
1388
|
+
region: string;
|
|
1389
|
+
/** AWS session token (for temporary credentials) */
|
|
1390
|
+
sessionToken?: string;
|
|
1391
|
+
}
|
|
794
1392
|
declare const amazonBedrockProviderConfigSchema: z.ZodObject<{
|
|
795
1393
|
providerName: z.ZodLiteral<"amazon-bedrock">;
|
|
796
1394
|
accessKeyId: z.ZodString;
|
|
@@ -798,7 +1396,18 @@ declare const amazonBedrockProviderConfigSchema: z.ZodObject<{
|
|
|
798
1396
|
region: z.ZodString;
|
|
799
1397
|
sessionToken: z.ZodOptional<z.ZodString>;
|
|
800
1398
|
}, z.core.$strip>;
|
|
801
|
-
|
|
1399
|
+
/** Google Vertex AI provider configuration */
|
|
1400
|
+
interface GoogleVertexProviderConfig {
|
|
1401
|
+
providerName: "google-vertex";
|
|
1402
|
+
/** GCP project ID */
|
|
1403
|
+
project?: string;
|
|
1404
|
+
/** GCP location */
|
|
1405
|
+
location?: string;
|
|
1406
|
+
/** Custom base URL */
|
|
1407
|
+
baseUrl?: string;
|
|
1408
|
+
/** Custom headers */
|
|
1409
|
+
headers?: Headers;
|
|
1410
|
+
}
|
|
802
1411
|
declare const googleVertexProviderConfigSchema: z.ZodObject<{
|
|
803
1412
|
providerName: z.ZodLiteral<"google-vertex">;
|
|
804
1413
|
project: z.ZodOptional<z.ZodString>;
|
|
@@ -806,7 +1415,24 @@ declare const googleVertexProviderConfigSchema: z.ZodObject<{
|
|
|
806
1415
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
807
1416
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
808
1417
|
}, z.core.$strip>;
|
|
809
|
-
|
|
1418
|
+
/** DeepSeek provider configuration */
|
|
1419
|
+
interface DeepseekProviderConfig {
|
|
1420
|
+
providerName: "deepseek";
|
|
1421
|
+
/** API key for DeepSeek */
|
|
1422
|
+
apiKey: string;
|
|
1423
|
+
/** Custom base URL */
|
|
1424
|
+
baseUrl?: string;
|
|
1425
|
+
/** Custom headers */
|
|
1426
|
+
headers?: Headers;
|
|
1427
|
+
}
|
|
1428
|
+
declare const deepseekProviderConfigSchema: z.ZodObject<{
|
|
1429
|
+
providerName: z.ZodLiteral<"deepseek">;
|
|
1430
|
+
apiKey: z.ZodString;
|
|
1431
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
1432
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
1433
|
+
}, z.core.$strip>;
|
|
1434
|
+
/** Union of all provider configurations */
|
|
1435
|
+
type ProviderConfig = AnthropicProviderConfig | GoogleGenerativeAiProviderConfig | OpenAiProviderConfig | OllamaProviderConfig | AzureOpenAiProviderConfig | AmazonBedrockProviderConfig | GoogleVertexProviderConfig | DeepseekProviderConfig;
|
|
810
1436
|
declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
811
1437
|
providerName: z.ZodLiteral<"anthropic">;
|
|
812
1438
|
apiKey: z.ZodString;
|
|
@@ -849,9 +1475,53 @@ declare const providerConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
849
1475
|
location: z.ZodOptional<z.ZodString>;
|
|
850
1476
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
851
1477
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
1478
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1479
|
+
providerName: z.ZodLiteral<"deepseek">;
|
|
1480
|
+
apiKey: z.ZodString;
|
|
1481
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
1482
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
852
1483
|
}, z.core.$strip>], "providerName">;
|
|
853
|
-
type ProviderConfig = z.infer<typeof providerConfigSchema>;
|
|
854
1484
|
|
|
1485
|
+
/** Parsed command options after transformation */
|
|
1486
|
+
interface CommandOptions {
|
|
1487
|
+
/** Path to perstack.toml config file */
|
|
1488
|
+
config?: string;
|
|
1489
|
+
/** LLM provider to use */
|
|
1490
|
+
provider?: ProviderName;
|
|
1491
|
+
/** Model name */
|
|
1492
|
+
model?: string;
|
|
1493
|
+
/** Temperature (0-1) */
|
|
1494
|
+
temperature?: number;
|
|
1495
|
+
/** Maximum steps */
|
|
1496
|
+
maxSteps?: number;
|
|
1497
|
+
/** Maximum retries */
|
|
1498
|
+
maxRetries?: number;
|
|
1499
|
+
/** Timeout in milliseconds */
|
|
1500
|
+
timeout?: number;
|
|
1501
|
+
/** Custom run ID */
|
|
1502
|
+
runId?: string;
|
|
1503
|
+
/** Paths to .env files */
|
|
1504
|
+
envPath?: string[];
|
|
1505
|
+
/** Enable verbose logging */
|
|
1506
|
+
verbose?: boolean;
|
|
1507
|
+
/** Continue most recent run */
|
|
1508
|
+
continue?: boolean;
|
|
1509
|
+
/** Continue specific run by ID */
|
|
1510
|
+
continueRun?: string;
|
|
1511
|
+
/** Resume from specific checkpoint */
|
|
1512
|
+
resumeFrom?: string;
|
|
1513
|
+
/** Query is interactive tool call result */
|
|
1514
|
+
interactiveToolCallResult?: boolean;
|
|
1515
|
+
}
|
|
1516
|
+
/** Input for the `perstack run` command */
|
|
1517
|
+
interface RunCommandInput {
|
|
1518
|
+
/** Expert key to run */
|
|
1519
|
+
expertKey: string;
|
|
1520
|
+
/** Query or prompt */
|
|
1521
|
+
query: string;
|
|
1522
|
+
/** Command options */
|
|
1523
|
+
options: CommandOptions;
|
|
1524
|
+
}
|
|
855
1525
|
declare const runCommandInputSchema: z.ZodObject<{
|
|
856
1526
|
expertKey: z.ZodString;
|
|
857
1527
|
query: z.ZodString;
|
|
@@ -861,6 +1531,7 @@ declare const runCommandInputSchema: z.ZodObject<{
|
|
|
861
1531
|
anthropic: "anthropic";
|
|
862
1532
|
google: "google";
|
|
863
1533
|
openai: "openai";
|
|
1534
|
+
deepseek: "deepseek";
|
|
864
1535
|
ollama: "ollama";
|
|
865
1536
|
"azure-openai": "azure-openai";
|
|
866
1537
|
"amazon-bedrock": "amazon-bedrock";
|
|
@@ -880,7 +1551,15 @@ declare const runCommandInputSchema: z.ZodObject<{
|
|
|
880
1551
|
interactiveToolCallResult: z.ZodOptional<z.ZodBoolean>;
|
|
881
1552
|
}, z.core.$strip>;
|
|
882
1553
|
}, z.core.$strip>;
|
|
883
|
-
|
|
1554
|
+
/** Input for the `perstack start` command */
|
|
1555
|
+
interface StartCommandInput {
|
|
1556
|
+
/** Expert key to run (optional, prompts if not provided) */
|
|
1557
|
+
expertKey?: string;
|
|
1558
|
+
/** Query or prompt (optional, prompts if not provided) */
|
|
1559
|
+
query?: string;
|
|
1560
|
+
/** Command options */
|
|
1561
|
+
options: CommandOptions;
|
|
1562
|
+
}
|
|
884
1563
|
declare const startCommandInputSchema: z.ZodObject<{
|
|
885
1564
|
expertKey: z.ZodOptional<z.ZodString>;
|
|
886
1565
|
query: z.ZodOptional<z.ZodString>;
|
|
@@ -890,6 +1569,7 @@ declare const startCommandInputSchema: z.ZodObject<{
|
|
|
890
1569
|
anthropic: "anthropic";
|
|
891
1570
|
google: "google";
|
|
892
1571
|
openai: "openai";
|
|
1572
|
+
deepseek: "deepseek";
|
|
893
1573
|
ollama: "ollama";
|
|
894
1574
|
"azure-openai": "azure-openai";
|
|
895
1575
|
"amazon-bedrock": "amazon-bedrock";
|
|
@@ -909,8 +1589,121 @@ declare const startCommandInputSchema: z.ZodObject<{
|
|
|
909
1589
|
interactiveToolCallResult: z.ZodOptional<z.ZodBoolean>;
|
|
910
1590
|
}, z.core.$strip>;
|
|
911
1591
|
}, z.core.$strip>;
|
|
912
|
-
type StartCommandInput = z.infer<typeof startCommandInputSchema>;
|
|
913
1592
|
|
|
1593
|
+
/** A tool call made by an Expert during execution */
|
|
1594
|
+
interface ToolCall {
|
|
1595
|
+
/** Unique identifier for this tool call */
|
|
1596
|
+
id: string;
|
|
1597
|
+
/** Name of the skill providing the tool */
|
|
1598
|
+
skillName: string;
|
|
1599
|
+
/** Name of the tool being called */
|
|
1600
|
+
toolName: string;
|
|
1601
|
+
/** Arguments passed to the tool */
|
|
1602
|
+
args: Record<string, unknown>;
|
|
1603
|
+
}
|
|
1604
|
+
declare const toolCallSchema: z.ZodObject<{
|
|
1605
|
+
id: z.ZodString;
|
|
1606
|
+
skillName: z.ZodString;
|
|
1607
|
+
toolName: z.ZodString;
|
|
1608
|
+
args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
1609
|
+
}, z.core.$strip>;
|
|
1610
|
+
|
|
1611
|
+
/** Result returned from a tool call */
|
|
1612
|
+
interface ToolResult {
|
|
1613
|
+
/** Unique identifier for this result */
|
|
1614
|
+
id: string;
|
|
1615
|
+
/** Name of the skill that provided the tool */
|
|
1616
|
+
skillName: string;
|
|
1617
|
+
/** Name of the tool that was called */
|
|
1618
|
+
toolName: string;
|
|
1619
|
+
/** Content parts returned by the tool */
|
|
1620
|
+
result: MessagePart[];
|
|
1621
|
+
}
|
|
1622
|
+
declare const toolResultSchema: z.ZodObject<{
|
|
1623
|
+
id: z.ZodString;
|
|
1624
|
+
skillName: z.ZodString;
|
|
1625
|
+
toolName: z.ZodString;
|
|
1626
|
+
result: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
1627
|
+
id: z.ZodString;
|
|
1628
|
+
type: z.ZodLiteral<"textPart">;
|
|
1629
|
+
text: z.ZodString;
|
|
1630
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1631
|
+
id: z.ZodString;
|
|
1632
|
+
type: z.ZodLiteral<"imageUrlPart">;
|
|
1633
|
+
url: z.ZodURL;
|
|
1634
|
+
mimeType: z.ZodString;
|
|
1635
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1636
|
+
id: z.ZodString;
|
|
1637
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
1638
|
+
encodedData: z.ZodString;
|
|
1639
|
+
mimeType: z.ZodString;
|
|
1640
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1641
|
+
id: z.ZodString;
|
|
1642
|
+
type: z.ZodLiteral<"imageBinaryPart">;
|
|
1643
|
+
data: z.ZodString;
|
|
1644
|
+
mimeType: z.ZodString;
|
|
1645
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1646
|
+
id: z.ZodString;
|
|
1647
|
+
type: z.ZodLiteral<"fileUrlPart">;
|
|
1648
|
+
url: z.ZodString;
|
|
1649
|
+
mimeType: z.ZodString;
|
|
1650
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1651
|
+
id: z.ZodString;
|
|
1652
|
+
type: z.ZodLiteral<"fileInlinePart">;
|
|
1653
|
+
encodedData: z.ZodString;
|
|
1654
|
+
mimeType: z.ZodString;
|
|
1655
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1656
|
+
id: z.ZodString;
|
|
1657
|
+
type: z.ZodLiteral<"fileBinaryPart">;
|
|
1658
|
+
data: z.ZodString;
|
|
1659
|
+
mimeType: z.ZodString;
|
|
1660
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1661
|
+
id: z.ZodString;
|
|
1662
|
+
type: z.ZodLiteral<"toolCallPart">;
|
|
1663
|
+
toolCallId: z.ZodString;
|
|
1664
|
+
toolName: z.ZodString;
|
|
1665
|
+
args: z.ZodUnknown;
|
|
1666
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1667
|
+
id: z.ZodString;
|
|
1668
|
+
type: z.ZodLiteral<"toolResultPart">;
|
|
1669
|
+
toolCallId: z.ZodString;
|
|
1670
|
+
toolName: z.ZodString;
|
|
1671
|
+
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
1672
|
+
id: z.ZodString;
|
|
1673
|
+
type: z.ZodLiteral<"textPart">;
|
|
1674
|
+
text: z.ZodString;
|
|
1675
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1676
|
+
id: z.ZodString;
|
|
1677
|
+
type: z.ZodLiteral<"imageInlinePart">;
|
|
1678
|
+
encodedData: z.ZodString;
|
|
1679
|
+
mimeType: z.ZodString;
|
|
1680
|
+
}, z.core.$strip>]>>;
|
|
1681
|
+
isError: z.ZodOptional<z.ZodBoolean>;
|
|
1682
|
+
}, z.core.$strip>], "type">>;
|
|
1683
|
+
}, z.core.$strip>;
|
|
1684
|
+
|
|
1685
|
+
/**
|
|
1686
|
+
* A single execution step in an Expert run.
|
|
1687
|
+
* Each step represents one LLM generation cycle, optionally followed by a tool call.
|
|
1688
|
+
*/
|
|
1689
|
+
interface Step {
|
|
1690
|
+
/** Sequential step number (1-indexed) */
|
|
1691
|
+
stepNumber: number;
|
|
1692
|
+
/** Messages sent to the LLM for this step */
|
|
1693
|
+
inputMessages?: (InstructionMessage | UserMessage | ToolMessage)[];
|
|
1694
|
+
/** Messages generated during this step */
|
|
1695
|
+
newMessages: Message[];
|
|
1696
|
+
/** Tool call made during this step, if any */
|
|
1697
|
+
toolCall?: ToolCall;
|
|
1698
|
+
/** Result of the tool call, if any */
|
|
1699
|
+
toolResult?: ToolResult;
|
|
1700
|
+
/** Token usage for this step */
|
|
1701
|
+
usage: Usage;
|
|
1702
|
+
/** Unix timestamp (ms) when step started */
|
|
1703
|
+
startedAt: number;
|
|
1704
|
+
/** Unix timestamp (ms) when step finished */
|
|
1705
|
+
finishedAt?: number;
|
|
1706
|
+
}
|
|
914
1707
|
declare const stepSchema: z.ZodObject<{
|
|
915
1708
|
stepNumber: z.ZodNumber;
|
|
916
1709
|
inputMessages: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
@@ -1146,95 +1939,102 @@ declare const stepSchema: z.ZodObject<{
|
|
|
1146
1939
|
startedAt: z.ZodNumber;
|
|
1147
1940
|
finishedAt: z.ZodOptional<z.ZodNumber>;
|
|
1148
1941
|
}, z.core.$strip>;
|
|
1149
|
-
type Step = z.infer<typeof stepSchema>;
|
|
1150
|
-
|
|
1151
|
-
declare const toolCallSchema: z.ZodObject<{
|
|
1152
|
-
id: z.ZodString;
|
|
1153
|
-
skillName: z.ZodString;
|
|
1154
|
-
toolName: z.ZodString;
|
|
1155
|
-
args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
1156
|
-
}, z.core.$strip>;
|
|
1157
|
-
type ToolCall = z.infer<typeof toolCallSchema>;
|
|
1158
|
-
|
|
1159
|
-
declare const toolResultSchema: z.ZodObject<{
|
|
1160
|
-
id: z.ZodString;
|
|
1161
|
-
skillName: z.ZodString;
|
|
1162
|
-
toolName: z.ZodString;
|
|
1163
|
-
result: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
1164
|
-
id: z.ZodString;
|
|
1165
|
-
type: z.ZodLiteral<"textPart">;
|
|
1166
|
-
text: z.ZodString;
|
|
1167
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1168
|
-
id: z.ZodString;
|
|
1169
|
-
type: z.ZodLiteral<"imageUrlPart">;
|
|
1170
|
-
url: z.ZodURL;
|
|
1171
|
-
mimeType: z.ZodString;
|
|
1172
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1173
|
-
id: z.ZodString;
|
|
1174
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
1175
|
-
encodedData: z.ZodString;
|
|
1176
|
-
mimeType: z.ZodString;
|
|
1177
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1178
|
-
id: z.ZodString;
|
|
1179
|
-
type: z.ZodLiteral<"imageBinaryPart">;
|
|
1180
|
-
data: z.ZodString;
|
|
1181
|
-
mimeType: z.ZodString;
|
|
1182
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1183
|
-
id: z.ZodString;
|
|
1184
|
-
type: z.ZodLiteral<"fileUrlPart">;
|
|
1185
|
-
url: z.ZodString;
|
|
1186
|
-
mimeType: z.ZodString;
|
|
1187
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1188
|
-
id: z.ZodString;
|
|
1189
|
-
type: z.ZodLiteral<"fileInlinePart">;
|
|
1190
|
-
encodedData: z.ZodString;
|
|
1191
|
-
mimeType: z.ZodString;
|
|
1192
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1193
|
-
id: z.ZodString;
|
|
1194
|
-
type: z.ZodLiteral<"fileBinaryPart">;
|
|
1195
|
-
data: z.ZodString;
|
|
1196
|
-
mimeType: z.ZodString;
|
|
1197
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1198
|
-
id: z.ZodString;
|
|
1199
|
-
type: z.ZodLiteral<"toolCallPart">;
|
|
1200
|
-
toolCallId: z.ZodString;
|
|
1201
|
-
toolName: z.ZodString;
|
|
1202
|
-
args: z.ZodUnknown;
|
|
1203
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1204
|
-
id: z.ZodString;
|
|
1205
|
-
type: z.ZodLiteral<"toolResultPart">;
|
|
1206
|
-
toolCallId: z.ZodString;
|
|
1207
|
-
toolName: z.ZodString;
|
|
1208
|
-
contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
1209
|
-
id: z.ZodString;
|
|
1210
|
-
type: z.ZodLiteral<"textPart">;
|
|
1211
|
-
text: z.ZodString;
|
|
1212
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
1213
|
-
id: z.ZodString;
|
|
1214
|
-
type: z.ZodLiteral<"imageInlinePart">;
|
|
1215
|
-
encodedData: z.ZodString;
|
|
1216
|
-
mimeType: z.ZodString;
|
|
1217
|
-
}, z.core.$strip>]>>;
|
|
1218
|
-
isError: z.ZodOptional<z.ZodBoolean>;
|
|
1219
|
-
}, z.core.$strip>], "type">>;
|
|
1220
|
-
}, z.core.$strip>;
|
|
1221
|
-
type ToolResult = z.infer<typeof toolResultSchema>;
|
|
1222
|
-
|
|
1223
|
-
declare const usageSchema: z.ZodObject<{
|
|
1224
|
-
inputTokens: z.ZodNumber;
|
|
1225
|
-
outputTokens: z.ZodNumber;
|
|
1226
|
-
reasoningTokens: z.ZodNumber;
|
|
1227
|
-
totalTokens: z.ZodNumber;
|
|
1228
|
-
cachedInputTokens: z.ZodNumber;
|
|
1229
|
-
}, z.core.$strip>;
|
|
1230
|
-
type Usage = z.infer<typeof usageSchema>;
|
|
1231
1942
|
|
|
1943
|
+
/** Parse an expert key into its components */
|
|
1232
1944
|
declare function parseExpertKey(expertKey: string): {
|
|
1233
1945
|
key: string;
|
|
1234
1946
|
name: string;
|
|
1235
1947
|
version?: string;
|
|
1236
1948
|
tag?: string;
|
|
1237
1949
|
};
|
|
1950
|
+
/** Input for a run (text or interactive tool call result) */
|
|
1951
|
+
interface RunInput {
|
|
1952
|
+
/** Text query */
|
|
1953
|
+
text?: string;
|
|
1954
|
+
/** Interactive tool call result (when continuing from interactive tool) */
|
|
1955
|
+
interactiveToolCallResult?: {
|
|
1956
|
+
toolCallId: string;
|
|
1957
|
+
toolName: string;
|
|
1958
|
+
text: string;
|
|
1959
|
+
};
|
|
1960
|
+
}
|
|
1961
|
+
/** Runtime settings for an Expert run */
|
|
1962
|
+
interface RunSetting {
|
|
1963
|
+
/** Model name to use */
|
|
1964
|
+
model: string;
|
|
1965
|
+
/** Provider configuration */
|
|
1966
|
+
providerConfig: ProviderConfig;
|
|
1967
|
+
/** Unique run identifier */
|
|
1968
|
+
runId: string;
|
|
1969
|
+
/** Expert key to run */
|
|
1970
|
+
expertKey: string;
|
|
1971
|
+
/** Input for the run */
|
|
1972
|
+
input: RunInput;
|
|
1973
|
+
/** Map of expert keys to Expert definitions */
|
|
1974
|
+
experts: Record<string, Expert>;
|
|
1975
|
+
/** Temperature for generation (0-1) */
|
|
1976
|
+
temperature: number;
|
|
1977
|
+
/** Maximum steps before stopping */
|
|
1978
|
+
maxSteps?: number;
|
|
1979
|
+
/** Maximum retries on generation failure */
|
|
1980
|
+
maxRetries: number;
|
|
1981
|
+
/** Timeout per generation in milliseconds */
|
|
1982
|
+
timeout: number;
|
|
1983
|
+
/** Workspace directory path */
|
|
1984
|
+
workspace?: string;
|
|
1985
|
+
/** Unix timestamp when run started */
|
|
1986
|
+
startedAt: number;
|
|
1987
|
+
/** Unix timestamp of last update */
|
|
1988
|
+
updatedAt: number;
|
|
1989
|
+
/** Perstack API base URL */
|
|
1990
|
+
perstackApiBaseUrl: string;
|
|
1991
|
+
/** Perstack API key */
|
|
1992
|
+
perstackApiKey?: string;
|
|
1993
|
+
/** Custom command for @perstack/base */
|
|
1994
|
+
perstackBaseSkillCommand?: string[];
|
|
1995
|
+
/** Environment variables to pass to skills */
|
|
1996
|
+
env: Record<string, string>;
|
|
1997
|
+
}
|
|
1998
|
+
/** Parameters for starting a run */
|
|
1999
|
+
interface RunParams {
|
|
2000
|
+
/** Run settings */
|
|
2001
|
+
setting: RunSetting;
|
|
2002
|
+
/** Optional checkpoint to resume from */
|
|
2003
|
+
checkpoint?: Checkpoint;
|
|
2004
|
+
}
|
|
2005
|
+
/** Expert input type before schema transformation (skills without name, optional fields) */
|
|
2006
|
+
type ExpertInput = {
|
|
2007
|
+
name: string;
|
|
2008
|
+
version: string;
|
|
2009
|
+
description?: string;
|
|
2010
|
+
instruction: string;
|
|
2011
|
+
skills?: Record<string, PerstackConfigSkill>;
|
|
2012
|
+
delegates?: string[];
|
|
2013
|
+
tags?: string[];
|
|
2014
|
+
};
|
|
2015
|
+
/** Input type for runParamsSchema (before defaults/transforms) */
|
|
2016
|
+
type RunParamsInput = {
|
|
2017
|
+
setting: {
|
|
2018
|
+
model: string;
|
|
2019
|
+
providerConfig: ProviderConfig;
|
|
2020
|
+
runId?: string;
|
|
2021
|
+
expertKey: string;
|
|
2022
|
+
input: RunInput;
|
|
2023
|
+
experts?: Record<string, ExpertInput>;
|
|
2024
|
+
temperature?: number;
|
|
2025
|
+
maxSteps?: number;
|
|
2026
|
+
maxRetries?: number;
|
|
2027
|
+
timeout?: number;
|
|
2028
|
+
workspace?: string;
|
|
2029
|
+
startedAt?: number;
|
|
2030
|
+
updatedAt?: number;
|
|
2031
|
+
perstackApiBaseUrl?: string;
|
|
2032
|
+
perstackApiKey?: string;
|
|
2033
|
+
perstackBaseSkillCommand?: string[];
|
|
2034
|
+
env?: Record<string, string>;
|
|
2035
|
+
};
|
|
2036
|
+
checkpoint?: Checkpoint;
|
|
2037
|
+
};
|
|
1238
2038
|
declare const runParamsSchema: z.ZodObject<{
|
|
1239
2039
|
setting: z.ZodObject<{
|
|
1240
2040
|
model: z.ZodString;
|
|
@@ -1280,6 +2080,11 @@ declare const runParamsSchema: z.ZodObject<{
|
|
|
1280
2080
|
location: z.ZodOptional<z.ZodString>;
|
|
1281
2081
|
baseUrl: z.ZodOptional<z.ZodString>;
|
|
1282
2082
|
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
2083
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
2084
|
+
providerName: z.ZodLiteral<"deepseek">;
|
|
2085
|
+
apiKey: z.ZodString;
|
|
2086
|
+
baseUrl: z.ZodOptional<z.ZodString>;
|
|
2087
|
+
headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
1283
2088
|
}, z.core.$strip>], "providerName">;
|
|
1284
2089
|
runId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
|
|
1285
2090
|
expertKey: z.ZodString;
|
|
@@ -1292,14 +2097,14 @@ declare const runParamsSchema: z.ZodObject<{
|
|
|
1292
2097
|
}, z.core.$strip>>;
|
|
1293
2098
|
}, z.core.$strip>;
|
|
1294
2099
|
experts: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
2100
|
+
description: z.ZodOptional<z.ZodString>;
|
|
1295
2101
|
name: z.ZodString;
|
|
1296
2102
|
version: z.ZodString;
|
|
1297
|
-
description: z.ZodOptional<z.ZodString>;
|
|
1298
2103
|
instruction: z.ZodString;
|
|
1299
2104
|
skills: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
1300
2105
|
type: z.ZodLiteral<"mcpStdioSkill">;
|
|
1301
|
-
args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1302
2106
|
description: z.ZodOptional<z.ZodString>;
|
|
2107
|
+
args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1303
2108
|
rule: z.ZodOptional<z.ZodString>;
|
|
1304
2109
|
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1305
2110
|
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
@@ -1631,15 +2436,9 @@ declare const runParamsSchema: z.ZodObject<{
|
|
|
1631
2436
|
contextWindowUsage: z.ZodOptional<z.ZodNumber>;
|
|
1632
2437
|
}, z.core.$strip>>;
|
|
1633
2438
|
}, z.core.$strip>;
|
|
1634
|
-
type RunParamsInput = z.input<typeof runParamsSchema>;
|
|
1635
|
-
type RunParams = z.output<typeof runParamsSchema>;
|
|
1636
|
-
type RunSetting = z.infer<typeof runParamsSchema.shape.setting>;
|
|
1637
|
-
type RunInput = z.infer<typeof runParamsSchema.shape.setting.shape.input>;
|
|
1638
2439
|
/**
|
|
1639
|
-
*
|
|
1640
|
-
*
|
|
1641
|
-
* and later used to restore state when resuming execution. Non-serializable properties would cause
|
|
1642
|
-
* issues during serialization/deserialization process.
|
|
2440
|
+
* Expert run events - emitted during execution for observability.
|
|
2441
|
+
* All events contain deeply serializable properties for checkpoint storage.
|
|
1643
2442
|
*/
|
|
1644
2443
|
type ExpertEventPayloads = {
|
|
1645
2444
|
startRun: {
|
|
@@ -1713,22 +2512,32 @@ type ExpertEventPayloads = {
|
|
|
1713
2512
|
usage: Usage;
|
|
1714
2513
|
};
|
|
1715
2514
|
};
|
|
1716
|
-
|
|
2515
|
+
/** Base properties for all run events */
|
|
2516
|
+
interface BaseEvent {
|
|
2517
|
+
/** Unique event ID */
|
|
1717
2518
|
id: string;
|
|
2519
|
+
/** Expert key that emitted this event */
|
|
1718
2520
|
expertKey: string;
|
|
2521
|
+
/** Unix timestamp when event was emitted */
|
|
1719
2522
|
timestamp: number;
|
|
2523
|
+
/** Run ID this event belongs to */
|
|
1720
2524
|
runId: string;
|
|
2525
|
+
/** Step number when event was emitted */
|
|
1721
2526
|
stepNumber: number;
|
|
1722
|
-
}
|
|
2527
|
+
}
|
|
2528
|
+
/** All possible event types */
|
|
1723
2529
|
type EventType = keyof ExpertEventPayloads;
|
|
2530
|
+
/** Union type of all run events */
|
|
1724
2531
|
type RunEvent = {
|
|
1725
2532
|
[K in EventType]: BaseEvent & {
|
|
1726
2533
|
type: K;
|
|
1727
2534
|
} & ExpertEventPayloads[K];
|
|
1728
2535
|
}[EventType];
|
|
2536
|
+
/** Extract a specific event type */
|
|
1729
2537
|
type EventForType<T extends EventType> = Extract<RunEvent, {
|
|
1730
2538
|
type: T;
|
|
1731
2539
|
}>;
|
|
2540
|
+
/** Factory function to create typed events */
|
|
1732
2541
|
declare function createEvent<T extends EventType>(type: T): (setting: RunSetting, checkpoint: Checkpoint, data: Omit<EventForType<T>, "type" | "id" | "expertKey" | "timestamp" | "runId" | "stepNumber">) => EventForType<T>;
|
|
1733
2542
|
declare const startRun: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<BaseEvent & {
|
|
1734
2543
|
type: "startRun";
|
|
@@ -1921,11 +2730,16 @@ declare const continueToNextStep: (setting: RunSetting, checkpoint: Checkpoint,
|
|
|
1921
2730
|
step: Step;
|
|
1922
2731
|
nextCheckpoint: Checkpoint;
|
|
1923
2732
|
};
|
|
1924
|
-
|
|
2733
|
+
/** Base properties for runtime events */
|
|
2734
|
+
interface BaseRuntimeEvent {
|
|
2735
|
+
/** Unique event ID */
|
|
1925
2736
|
id: string;
|
|
2737
|
+
/** Unix timestamp */
|
|
1926
2738
|
timestamp: number;
|
|
2739
|
+
/** Run ID */
|
|
1927
2740
|
runId: string;
|
|
1928
|
-
}
|
|
2741
|
+
}
|
|
2742
|
+
/** Runtime event payloads (infrastructure-level events) */
|
|
1929
2743
|
type RuntimeEventPayloads = {
|
|
1930
2744
|
initializeRuntime: {
|
|
1931
2745
|
runtimeVersion: string;
|
|
@@ -1954,152 +2768,84 @@ type RuntimeEventPayloads = {
|
|
|
1954
2768
|
skillName: string;
|
|
1955
2769
|
};
|
|
1956
2770
|
};
|
|
2771
|
+
/** All runtime event types */
|
|
1957
2772
|
type RuntimeEventType = keyof RuntimeEventPayloads;
|
|
2773
|
+
/** Union type of all runtime events */
|
|
1958
2774
|
type RuntimeEvent = {
|
|
1959
2775
|
[K in RuntimeEventType]: BaseRuntimeEvent & {
|
|
1960
2776
|
type: K;
|
|
1961
2777
|
} & RuntimeEventPayloads[K];
|
|
1962
2778
|
}[RuntimeEventType];
|
|
2779
|
+
/** Extract a specific runtime event type */
|
|
1963
2780
|
type RuntimeEventForType<T extends RuntimeEventType> = Extract<RuntimeEvent, {
|
|
1964
2781
|
type: T;
|
|
1965
2782
|
}>;
|
|
2783
|
+
/** Factory function to create runtime events */
|
|
1966
2784
|
declare function createRuntimeEvent<T extends RuntimeEventType>(type: T, runId: string, data: Omit<RuntimeEventForType<T>, "type" | "id" | "timestamp" | "runId">): RuntimeEventForType<T>;
|
|
1967
2785
|
|
|
1968
|
-
|
|
1969
|
-
type: z.ZodLiteral<"mcpStdioSkill">;
|
|
1970
|
-
name: z.ZodString;
|
|
1971
|
-
description: z.ZodOptional<z.ZodString>;
|
|
1972
|
-
rule: z.ZodOptional<z.ZodString>;
|
|
1973
|
-
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1974
|
-
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1975
|
-
command: z.ZodString;
|
|
1976
|
-
packageName: z.ZodOptional<z.ZodString>;
|
|
1977
|
-
args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1978
|
-
requiredEnv: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1979
|
-
lazyInit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
1980
|
-
}, z.core.$strip>;
|
|
1981
|
-
type McpStdioSkill = z.infer<typeof mcpStdioSkillSchema>;
|
|
1982
|
-
declare const mcpSseSkillSchema: z.ZodObject<{
|
|
1983
|
-
type: z.ZodLiteral<"mcpSseSkill">;
|
|
1984
|
-
name: z.ZodString;
|
|
1985
|
-
description: z.ZodOptional<z.ZodString>;
|
|
1986
|
-
rule: z.ZodOptional<z.ZodString>;
|
|
1987
|
-
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1988
|
-
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
1989
|
-
endpoint: z.ZodString;
|
|
1990
|
-
}, z.core.$strip>;
|
|
1991
|
-
type McpSseSkill = z.infer<typeof mcpSseSkillSchema>;
|
|
1992
|
-
declare const interactiveToolSchema: z.ZodObject<{
|
|
1993
|
-
name: z.ZodString;
|
|
1994
|
-
description: z.ZodOptional<z.ZodString>;
|
|
1995
|
-
inputJsonSchema: z.ZodString;
|
|
1996
|
-
}, z.core.$strip>;
|
|
1997
|
-
type InteractiveTool = z.infer<typeof interactiveToolSchema>;
|
|
1998
|
-
declare const interactiveSkillSchema: z.ZodObject<{
|
|
1999
|
-
type: z.ZodLiteral<"interactiveSkill">;
|
|
2000
|
-
name: z.ZodString;
|
|
2001
|
-
description: z.ZodOptional<z.ZodString>;
|
|
2002
|
-
rule: z.ZodOptional<z.ZodString>;
|
|
2003
|
-
tools: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
2004
|
-
description: z.ZodOptional<z.ZodString>;
|
|
2005
|
-
inputJsonSchema: z.ZodString;
|
|
2006
|
-
}, z.core.$strip>>, z.ZodTransform<{
|
|
2007
|
-
[k: string]: {
|
|
2008
|
-
name: string;
|
|
2009
|
-
inputJsonSchema: string;
|
|
2010
|
-
description?: string | undefined;
|
|
2011
|
-
};
|
|
2012
|
-
}, Record<string, {
|
|
2013
|
-
inputJsonSchema: string;
|
|
2014
|
-
description?: string | undefined;
|
|
2015
|
-
}>>>;
|
|
2016
|
-
}, z.core.$strip>;
|
|
2017
|
-
type InteractiveSkill = z.infer<typeof interactiveSkillSchema>;
|
|
2018
|
-
declare const skillSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
2019
|
-
type: z.ZodLiteral<"mcpStdioSkill">;
|
|
2020
|
-
name: z.ZodString;
|
|
2021
|
-
description: z.ZodOptional<z.ZodString>;
|
|
2022
|
-
rule: z.ZodOptional<z.ZodString>;
|
|
2023
|
-
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
2024
|
-
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
2025
|
-
command: z.ZodString;
|
|
2026
|
-
packageName: z.ZodOptional<z.ZodString>;
|
|
2027
|
-
args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
2028
|
-
requiredEnv: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
2029
|
-
lazyInit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
2030
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
2031
|
-
type: z.ZodLiteral<"mcpSseSkill">;
|
|
2032
|
-
name: z.ZodString;
|
|
2033
|
-
description: z.ZodOptional<z.ZodString>;
|
|
2034
|
-
rule: z.ZodOptional<z.ZodString>;
|
|
2035
|
-
pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
2036
|
-
omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
|
|
2037
|
-
endpoint: z.ZodString;
|
|
2038
|
-
}, z.core.$strip>, z.ZodObject<{
|
|
2039
|
-
type: z.ZodLiteral<"interactiveSkill">;
|
|
2040
|
-
name: z.ZodString;
|
|
2041
|
-
description: z.ZodOptional<z.ZodString>;
|
|
2042
|
-
rule: z.ZodOptional<z.ZodString>;
|
|
2043
|
-
tools: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
2044
|
-
description: z.ZodOptional<z.ZodString>;
|
|
2045
|
-
inputJsonSchema: z.ZodString;
|
|
2046
|
-
}, z.core.$strip>>, z.ZodTransform<{
|
|
2047
|
-
[k: string]: {
|
|
2048
|
-
name: string;
|
|
2049
|
-
inputJsonSchema: string;
|
|
2050
|
-
description?: string | undefined;
|
|
2051
|
-
};
|
|
2052
|
-
}, Record<string, {
|
|
2053
|
-
inputJsonSchema: string;
|
|
2054
|
-
description?: string | undefined;
|
|
2055
|
-
}>>>;
|
|
2056
|
-
}, z.core.$strip>], "type">;
|
|
2057
|
-
type Skill = z.infer<typeof skillSchema>;
|
|
2058
|
-
|
|
2786
|
+
/** Discriminator for skill manager types */
|
|
2059
2787
|
type SkillType = "mcp" | "interactive" | "delegate";
|
|
2788
|
+
/** Parameters for initializing an MCP-based skill manager (stdio or SSE) */
|
|
2060
2789
|
interface McpSkillManagerParams {
|
|
2061
2790
|
type: "mcp";
|
|
2791
|
+
/** MCP skill configuration */
|
|
2062
2792
|
skill: McpStdioSkill | McpSseSkill;
|
|
2793
|
+
/** Environment variables to pass to the MCP server */
|
|
2063
2794
|
env: Record<string, string>;
|
|
2064
2795
|
}
|
|
2796
|
+
/** Parameters for initializing an interactive skill manager */
|
|
2065
2797
|
interface InteractiveSkillManagerParams {
|
|
2066
2798
|
type: "interactive";
|
|
2799
|
+
/** Interactive skill configuration */
|
|
2067
2800
|
interactiveSkill: InteractiveSkill;
|
|
2068
2801
|
}
|
|
2802
|
+
/** Parameters for initializing a delegate skill manager */
|
|
2069
2803
|
interface DelegateSkillManagerParams {
|
|
2070
2804
|
type: "delegate";
|
|
2805
|
+
/** Expert to delegate to */
|
|
2071
2806
|
expert: Expert;
|
|
2072
2807
|
}
|
|
2808
|
+
/** Union type for all skill manager initialization parameters */
|
|
2073
2809
|
type SkillManagerParams = McpSkillManagerParams | InteractiveSkillManagerParams | DelegateSkillManagerParams;
|
|
2810
|
+
/** Definition of a tool exposed by a skill manager */
|
|
2074
2811
|
interface ToolDefinition {
|
|
2812
|
+
/** Name of the skill providing this tool */
|
|
2075
2813
|
skillName: string;
|
|
2814
|
+
/** Tool name */
|
|
2076
2815
|
name: string;
|
|
2816
|
+
/** Human-readable description */
|
|
2077
2817
|
description?: string;
|
|
2818
|
+
/** JSON Schema for tool input */
|
|
2078
2819
|
inputSchema: {
|
|
2079
2820
|
[k: string]: unknown;
|
|
2080
2821
|
};
|
|
2822
|
+
/** Whether this tool requires human interaction */
|
|
2081
2823
|
interactive: boolean;
|
|
2082
2824
|
}
|
|
2825
|
+
/** Content returned from a tool call */
|
|
2083
2826
|
type CallToolResultContent = {
|
|
2827
|
+
/** Content type */
|
|
2084
2828
|
type: "text" | "image" | "resource";
|
|
2829
|
+
/** Text content (when type is "text") */
|
|
2085
2830
|
text?: string;
|
|
2831
|
+
/** Base64-encoded data (when type is "image") */
|
|
2086
2832
|
data?: string;
|
|
2833
|
+
/** MIME type of the content */
|
|
2087
2834
|
mimeType?: string;
|
|
2835
|
+
/** Resource reference (when type is "resource") */
|
|
2088
2836
|
resource?: Resource;
|
|
2089
2837
|
};
|
|
2838
|
+
/** MCP resource reference */
|
|
2090
2839
|
type Resource = {
|
|
2840
|
+
/** MIME type of the resource */
|
|
2091
2841
|
mimeType?: string;
|
|
2842
|
+
/** Text content */
|
|
2092
2843
|
text?: string;
|
|
2844
|
+
/** Base64-encoded binary content */
|
|
2093
2845
|
blob?: string;
|
|
2094
2846
|
};
|
|
2095
2847
|
|
|
2096
|
-
declare
|
|
2097
|
-
|
|
2098
|
-
models: {
|
|
2099
|
-
name: string;
|
|
2100
|
-
contextWindow: number;
|
|
2101
|
-
maxOutputTokens: number;
|
|
2102
|
-
}[];
|
|
2103
|
-
}[];
|
|
2848
|
+
declare function formatZodError(error: ZodError): string;
|
|
2849
|
+
declare function parseWithFriendlyError<T>(schema: ZodSchema<T>, data: unknown, context?: string): T;
|
|
2104
2850
|
|
|
2105
|
-
export { type AmazonBedrockProviderConfig, type AnthropicProviderConfig, type AzureOpenAiProviderConfig, type BasePart, type CallToolResultContent, type Checkpoint, type CheckpointStatus, type DelegateSkillManagerParams, type EventForType, type EventType, type Expert, type ExpertMessage, type FileBinaryPart, type FileInlinePart, type FileUrlPart, type GoogleGenerativeAiProviderConfig, type GoogleVertexProviderConfig, type ImageBinaryPart, type ImageInlinePart, type ImageUrlPart, type InstructionMessage, type InteractiveSkill, type InteractiveSkillManagerParams, type InteractiveTool, type McpSkillManagerParams, type McpSseSkill, type McpStdioSkill, type Message, type MessagePart, type OllamaProviderConfig, type OpenAiProviderConfig, type PerstackConfig, type ProviderConfig, type ProviderName, type ProviderTable, type Resource, type RunCommandInput, type RunEvent, type RunInput, type RunParams, type RunParamsInput, type RunSetting, type RuntimeEvent, type RuntimeEventForType, type RuntimeEventType, type Skill, type SkillManagerParams, type SkillType, type StartCommandInput, type Step, type TextPart, type ToolCall, type ToolCallPart, type ToolDefinition, type ToolMessage, type ToolResult, type ToolResultPart, type Usage, type UserMessage, amazonBedrockProviderConfigSchema, anthropicProviderConfigSchema, attemptCompletion, azureOpenAiProviderConfigSchema, basePartSchema, callDelegate, callInteractiveTool, callTool, checkpointSchema, checkpointStatusSchema, completeRun, continueToNextStep, createEvent, createRuntimeEvent, defaultMaxRetries, defaultMaxSteps, defaultPerstackApiBaseUrl, defaultTemperature, defaultTimeout, envNameRegex, expertKeyRegex, expertMessageSchema, expertNameRegex, expertSchema, expertVersionRegex, fileBinaryPartSchema, fileInlinePartSchema, fileUrlPartSchema, finishToolCall, googleGenerativeAiProviderConfigSchema, googleVertexProviderConfigSchema, headersSchema, imageBinaryPartSchema, imageInlinePartSchema, imageUrlPartSchema, instructionMessageSchema, interactiveSkillSchema, interactiveToolSchema, knownModels, maxApplicationNameLength, maxCheckpointToolCallIdLength, maxEnvNameLength, maxExpertDelegateItems, maxExpertDescriptionLength, maxExpertInstructionLength, maxExpertJobFileNameLength, maxExpertJobQueryLength, maxExpertKeyLength, maxExpertNameLength, maxExpertSkillItems, maxExpertTagItems, maxExpertVersionTagLength, maxOrganizationNameLength, maxSkillDescriptionLength, maxSkillEndpointLength, maxSkillInputJsonSchemaLength, maxSkillNameLength, maxSkillPickOmitItems, maxSkillRequiredEnvItems, maxSkillRuleLength, maxSkillToolItems, maxSkillToolNameLength, mcpSseSkillSchema, mcpStdioSkillSchema, messagePartSchema, messageSchema, ollamaProviderConfigSchema, openAiProviderConfigSchema, organizationNameRegex, packageWithVersionRegex, parseExpertKey, perstackConfigSchema, providerConfigSchema, providerNameSchema, providerTableSchema, resolveImageFile, resolvePdfFile, resolveThought, resolveToolResult, retry, runCommandInputSchema, runParamsSchema, skillSchema, startCommandInputSchema, startGeneration, startRun, stepSchema, stopRunByDelegate, stopRunByExceededMaxSteps, stopRunByInteractiveTool, tagNameRegex, textPartSchema, toolCallPartSchema, toolCallSchema, toolMessageSchema, toolResultPartSchema, toolResultSchema, urlSafeRegex, usageSchema, userMessageSchema };
|
|
2851
|
+
export { type AmazonBedrockProviderConfig, type AnthropicProviderConfig, type AzureOpenAiProviderConfig, type BaseEvent, type BasePart, type CallToolResultContent, type Checkpoint, type CheckpointStatus, type CommandOptions, type DeepseekProviderConfig, type DelegateSkillManagerParams, type EventForType, type EventType, type Expert, type ExpertMessage, type FileBinaryPart, type FileInlinePart, type FileUrlPart, type GoogleGenerativeAiProviderConfig, type GoogleVertexProviderConfig, type Headers, type ImageBinaryPart, type ImageInlinePart, type ImageUrlPart, type InstructionMessage, type InteractiveSkill, type InteractiveSkillManagerParams, type InteractiveTool, type McpSkillManagerParams, type McpSseSkill, type McpStdioSkill, type Message, type MessagePart, type OllamaProviderConfig, type OpenAiProviderConfig, type PerstackConfig, type PerstackConfigExpert, type PerstackConfigSkill, type ProviderConfig, type ProviderName, type ProviderTable, type Resource, type RunCommandInput, type RunEvent, type RunInput, type RunParams, type RunParamsInput, type RunSetting, type RuntimeEvent, type RuntimeEventForType, type RuntimeEventType, type Skill, type SkillManagerParams, type SkillType, type StartCommandInput, type Step, type TextPart, type ToolCall, type ToolCallPart, type ToolDefinition, type ToolMessage, type ToolResult, type ToolResultPart, type Usage, type UserMessage, amazonBedrockProviderConfigSchema, anthropicProviderConfigSchema, attemptCompletion, azureOpenAiProviderConfigSchema, basePartSchema, callDelegate, callInteractiveTool, callTool, checkpointSchema, checkpointStatusSchema, completeRun, continueToNextStep, createEvent, createRuntimeEvent, deepseekProviderConfigSchema, defaultMaxRetries, defaultMaxSteps, defaultPerstackApiBaseUrl, defaultTemperature, defaultTimeout, envNameRegex, expertKeyRegex, expertMessageSchema, expertNameRegex, expertSchema, expertVersionRegex, fileBinaryPartSchema, fileInlinePartSchema, fileUrlPartSchema, finishToolCall, formatZodError, googleGenerativeAiProviderConfigSchema, googleVertexProviderConfigSchema, headersSchema, imageBinaryPartSchema, imageInlinePartSchema, imageUrlPartSchema, instructionMessageSchema, interactiveSkillSchema, interactiveToolSchema, knownModels, maxApplicationNameLength, maxCheckpointToolCallIdLength, maxEnvNameLength, maxExpertDelegateItems, maxExpertDescriptionLength, maxExpertInstructionLength, maxExpertJobFileNameLength, maxExpertJobQueryLength, maxExpertKeyLength, maxExpertNameLength, maxExpertSkillItems, maxExpertTagItems, maxExpertVersionTagLength, maxOrganizationNameLength, maxSkillDescriptionLength, maxSkillEndpointLength, maxSkillInputJsonSchemaLength, maxSkillNameLength, maxSkillPickOmitItems, maxSkillRequiredEnvItems, maxSkillRuleLength, maxSkillToolItems, maxSkillToolNameLength, mcpSseSkillSchema, mcpStdioSkillSchema, messagePartSchema, messageSchema, ollamaProviderConfigSchema, openAiProviderConfigSchema, organizationNameRegex, packageWithVersionRegex, parseExpertKey, parseWithFriendlyError, perstackConfigSchema, providerConfigSchema, providerNameSchema, providerTableSchema, resolveImageFile, resolvePdfFile, resolveThought, resolveToolResult, retry, runCommandInputSchema, runParamsSchema, skillSchema, startCommandInputSchema, startGeneration, startRun, stepSchema, stopRunByDelegate, stopRunByExceededMaxSteps, stopRunByInteractiveTool, tagNameRegex, textPartSchema, toolCallPartSchema, toolCallSchema, toolMessageSchema, toolResultPartSchema, toolResultSchema, urlSafeRegex, usageSchema, userMessageSchema };
|