@perstack/api-client 0.0.14 → 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/README.md ADDED
@@ -0,0 +1,124 @@
1
+ # @perstack/api-client
2
+
3
+ The official TypeScript/JavaScript API client for Perstack.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install @perstack/api-client
9
+ # or
10
+ pnpm add @perstack/api-client
11
+ # or
12
+ yarn add @perstack/api-client
13
+ ```
14
+
15
+ ## Usage
16
+
17
+ ### Initialization
18
+
19
+ ```typescript
20
+ import { ApiV1Client } from "@perstack/api-client";
21
+
22
+ const client = new ApiV1Client({
23
+ baseUrl: "https://api.perstack.ai", // Optional, defaults to https://api.perstack.ai
24
+ apiKey: "YOUR_API_KEY", // Required for authenticated requests
25
+ });
26
+ ```
27
+
28
+ ### Registry
29
+
30
+ Interact with the Expert Registry.
31
+
32
+ ```typescript
33
+ // Get all experts in the registry
34
+ const experts = await client.registry.experts.getMany({});
35
+
36
+ // Get a specific expert
37
+ const expert = await client.registry.experts.get({
38
+ owner: "perstack",
39
+ slug: "software-engineer",
40
+ });
41
+
42
+ // Get expert versions
43
+ const versions = await client.registry.experts.getVersions({
44
+ owner: "perstack",
45
+ slug: "software-engineer",
46
+ });
47
+ ```
48
+
49
+ ### Studio
50
+
51
+ Interact with the Studio (Experts, Jobs, Workspace).
52
+
53
+ #### Experts
54
+
55
+ ```typescript
56
+ // Create a studio expert
57
+ const newExpert = await client.studio.experts.create({
58
+ slug: "my-custom-expert",
59
+ description: "A custom expert for my needs",
60
+ });
61
+
62
+ // Get studio experts
63
+ const myExperts = await client.studio.experts.getMany({});
64
+ ```
65
+
66
+ #### Expert Jobs
67
+
68
+ Manage expert execution jobs.
69
+
70
+ ```typescript
71
+ // Start a job
72
+ const job = await client.studio.expertJobs.start({
73
+ expertId: "expert-id",
74
+ input: {
75
+ // ... input data
76
+ },
77
+ });
78
+
79
+ // Get job status
80
+ const jobStatus = await client.studio.expertJobs.get({
81
+ id: job.id,
82
+ });
83
+
84
+ // Continue a job (if waiting for input)
85
+ await client.studio.expertJobs.continue({
86
+ id: job.id,
87
+ input: {
88
+ // ... user input
89
+ },
90
+ });
91
+ ```
92
+
93
+ #### Workspace
94
+
95
+ Manage workspace resources (Items, Variables, Secrets).
96
+
97
+ ```typescript
98
+ // Get workspace details
99
+ const workspace = await client.studio.workspace.get();
100
+
101
+ // Create a workspace item (file)
102
+ await client.studio.workspace.items.create({
103
+ path: "/path/to/file.txt",
104
+ content: "Hello, World!",
105
+ });
106
+
107
+ // Create a secret
108
+ await client.studio.workspace.secrets.create({
109
+ key: "OPENAI_API_KEY",
110
+ value: "sk-...",
111
+ });
112
+ ```
113
+
114
+ ## Error Handling
115
+
116
+ The client throws errors for failed requests.
117
+
118
+ ```typescript
119
+ try {
120
+ await client.registry.experts.get({ owner: "invalid", slug: "expert" });
121
+ } catch (error) {
122
+ console.error("Failed to fetch expert:", error);
123
+ }
124
+ ```
@@ -9,13 +9,14 @@ declare class ApiError extends Error {
9
9
  }
10
10
 
11
11
  declare const apiBaseExpertSchema: z.ZodObject<{
12
- id: z.ZodCUID2;
12
+ version: z.ZodString;
13
13
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
14
14
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
15
+ description: z.ZodString;
16
+ id: z.ZodCUID2;
15
17
  minRuntimeVersion: z.ZodEnum<{
16
18
  "v1.0": "v1.0";
17
19
  }>;
18
- description: z.ZodString;
19
20
  owner: z.ZodObject<{
20
21
  name: z.ZodOptional<z.ZodString>;
21
22
  organizationId: z.ZodCUID2;
@@ -25,13 +26,13 @@ declare const apiBaseExpertSchema: z.ZodObject<{
25
26
  updatedAt: z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>;
26
27
  }, z.core.$strip>;
27
28
  declare const apiRegistryExpertSchema: z.ZodObject<{
28
- id: z.ZodCUID2;
29
29
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
30
30
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
31
+ description: z.ZodString;
32
+ id: z.ZodCUID2;
31
33
  minRuntimeVersion: z.ZodEnum<{
32
34
  "v1.0": "v1.0";
33
35
  }>;
34
- description: z.ZodString;
35
36
  owner: z.ZodObject<{
36
37
  name: z.ZodOptional<z.ZodString>;
37
38
  organizationId: z.ZodCUID2;
@@ -76,13 +77,14 @@ declare const apiRegistryExpertSchema: z.ZodObject<{
76
77
  }, z.core.$strip>;
77
78
  type ApiRegistryExpert = z.infer<typeof apiRegistryExpertSchema>;
78
79
  declare const apiStudioExpertSchema: z.ZodObject<{
79
- id: z.ZodCUID2;
80
+ version: z.ZodString;
80
81
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
81
82
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
83
+ description: z.ZodString;
84
+ id: z.ZodCUID2;
82
85
  minRuntimeVersion: z.ZodEnum<{
83
86
  "v1.0": "v1.0";
84
87
  }>;
85
- description: z.ZodString;
86
88
  owner: z.ZodObject<{
87
89
  name: z.ZodOptional<z.ZodString>;
88
90
  organizationId: z.ZodCUID2;
@@ -147,13 +149,13 @@ declare const apiStudioExpertSchema: z.ZodObject<{
147
149
  }, z.core.$strip>;
148
150
  type ApiStudioExpert = z.infer<typeof apiStudioExpertSchema>;
149
151
  declare const apiExpertDigestSchema: z.ZodObject<{
150
- id: z.ZodCUID2;
151
152
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
152
153
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
154
+ description: z.ZodString;
155
+ id: z.ZodCUID2;
153
156
  minRuntimeVersion: z.ZodEnum<{
154
157
  "v1.0": "v1.0";
155
158
  }>;
156
- description: z.ZodString;
157
159
  owner: z.ZodObject<{
158
160
  name: z.ZodOptional<z.ZodString>;
159
161
  organizationId: z.ZodCUID2;
@@ -167,13 +169,13 @@ declare const apiExpertDigestSchema: z.ZodObject<{
167
169
  }, z.core.$strip>;
168
170
  type ApiExpertDigest = z.infer<typeof apiExpertDigestSchema>;
169
171
  declare const apiExpertSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
170
- id: z.ZodCUID2;
171
172
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
172
173
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
174
+ description: z.ZodString;
175
+ id: z.ZodCUID2;
173
176
  minRuntimeVersion: z.ZodEnum<{
174
177
  "v1.0": "v1.0";
175
178
  }>;
176
- description: z.ZodString;
177
179
  owner: z.ZodObject<{
178
180
  name: z.ZodOptional<z.ZodString>;
179
181
  organizationId: z.ZodCUID2;
@@ -185,13 +187,13 @@ declare const apiExpertSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
185
187
  version: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
186
188
  tags: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
187
189
  }, z.core.$strip>, z.ZodObject<{
188
- id: z.ZodCUID2;
189
190
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
190
191
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
192
+ description: z.ZodString;
193
+ id: z.ZodCUID2;
191
194
  minRuntimeVersion: z.ZodEnum<{
192
195
  "v1.0": "v1.0";
193
196
  }>;
194
- description: z.ZodString;
195
197
  owner: z.ZodObject<{
196
198
  name: z.ZodOptional<z.ZodString>;
197
199
  organizationId: z.ZodCUID2;
@@ -234,13 +236,14 @@ declare const apiExpertSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
234
236
  delegates: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
235
237
  tags: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
236
238
  }, z.core.$strip>, z.ZodObject<{
237
- id: z.ZodCUID2;
239
+ version: z.ZodString;
238
240
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
239
241
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
242
+ description: z.ZodString;
243
+ id: z.ZodCUID2;
240
244
  minRuntimeVersion: z.ZodEnum<{
241
245
  "v1.0": "v1.0";
242
246
  }>;
243
- description: z.ZodString;
244
247
  owner: z.ZodObject<{
245
248
  name: z.ZodOptional<z.ZodString>;
246
249
  organizationId: z.ZodCUID2;
@@ -391,6 +394,18 @@ declare function getRegistryExpertVersions(input: GetRegistryExpertVersionsInput
391
394
  latest: string;
392
395
  total: number;
393
396
  }>;
397
+ /**
398
+ * Update a registry expert
399
+ */
400
+ declare const updateRegistryExpertInput: z.ZodObject<{
401
+ expertKey: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
402
+ status: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"available">, z.ZodLiteral<"deprecated">, z.ZodLiteral<"disabled">]>>;
403
+ tags: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>>;
404
+ }, z.core.$strip>;
405
+ type UpdateRegistryExpertInput = z.input<typeof updateRegistryExpertInput>;
406
+ declare function updateRegistryExpert(input: UpdateRegistryExpertInput, client: ApiV1Client): Promise<{
407
+ expert: ApiRegistryExpert;
408
+ }>;
394
409
  /**
395
410
  * Delete a registry expert
396
411
  */
@@ -554,13 +569,13 @@ declare const apiCheckpointActionDelegateSchema: z.ZodObject<{
554
569
  error: z.ZodOptional<z.ZodString>;
555
570
  type: z.ZodLiteral<"delegate">;
556
571
  delegateTo: z.ZodObject<{
557
- id: z.ZodCUID2;
558
572
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
559
573
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
574
+ description: z.ZodString;
575
+ id: z.ZodCUID2;
560
576
  minRuntimeVersion: z.ZodEnum<{
561
577
  "v1.0": "v1.0";
562
578
  }>;
563
- description: z.ZodString;
564
579
  owner: z.ZodObject<{
565
580
  name: z.ZodOptional<z.ZodString>;
566
581
  organizationId: z.ZodCUID2;
@@ -785,13 +800,13 @@ declare const apiCheckpointActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
785
800
  error: z.ZodOptional<z.ZodString>;
786
801
  type: z.ZodLiteral<"delegate">;
787
802
  delegateTo: z.ZodObject<{
788
- id: z.ZodCUID2;
789
803
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
790
804
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
805
+ description: z.ZodString;
806
+ id: z.ZodCUID2;
791
807
  minRuntimeVersion: z.ZodEnum<{
792
808
  "v1.0": "v1.0";
793
809
  }>;
794
- description: z.ZodString;
795
810
  owner: z.ZodObject<{
796
811
  name: z.ZodOptional<z.ZodString>;
797
812
  organizationId: z.ZodCUID2;
@@ -879,6 +894,8 @@ declare const apiCheckpointActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
879
894
  }, z.core.$strip>], "type">;
880
895
  type ApiCheckpointAction = z.infer<typeof apiCheckpointActionSchema>;
881
896
  declare const apiCheckpointSchema: z.ZodObject<{
897
+ runId: z.ZodString;
898
+ stepNumber: z.ZodNumber;
882
899
  type: z.ZodLiteral<"checkpoint">;
883
900
  id: z.ZodCUID2;
884
901
  action: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1017,13 +1034,13 @@ declare const apiCheckpointSchema: z.ZodObject<{
1017
1034
  error: z.ZodOptional<z.ZodString>;
1018
1035
  type: z.ZodLiteral<"delegate">;
1019
1036
  delegateTo: z.ZodObject<{
1020
- id: z.ZodCUID2;
1021
1037
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1022
1038
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1039
+ description: z.ZodString;
1040
+ id: z.ZodCUID2;
1023
1041
  minRuntimeVersion: z.ZodEnum<{
1024
1042
  "v1.0": "v1.0";
1025
1043
  }>;
1026
- description: z.ZodString;
1027
1044
  owner: z.ZodObject<{
1028
1045
  name: z.ZodOptional<z.ZodString>;
1029
1046
  organizationId: z.ZodCUID2;
@@ -1110,16 +1127,15 @@ declare const apiCheckpointSchema: z.ZodObject<{
1110
1127
  type: z.ZodLiteral<"error">;
1111
1128
  }, z.core.$strip>], "type">;
1112
1129
  expertJobId: z.ZodCUID2;
1113
- stepNumber: z.ZodNumber;
1114
1130
  status: z.ZodUnion<readonly [z.ZodLiteral<"init">, z.ZodLiteral<"proceeding">, z.ZodLiteral<"completed">, z.ZodLiteral<"stoppedByInteractiveTool">, z.ZodLiteral<"stoppedByDelegate">, z.ZodLiteral<"stoppedByExceededMaxSteps">, z.ZodLiteral<"stoppedByError">]>;
1115
1131
  expert: z.ZodObject<{
1116
- id: z.ZodCUID2;
1117
1132
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1118
1133
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1134
+ description: z.ZodString;
1135
+ id: z.ZodCUID2;
1119
1136
  minRuntimeVersion: z.ZodEnum<{
1120
1137
  "v1.0": "v1.0";
1121
1138
  }>;
1122
- description: z.ZodString;
1123
1139
  owner: z.ZodObject<{
1124
1140
  name: z.ZodOptional<z.ZodString>;
1125
1141
  organizationId: z.ZodCUID2;
@@ -1135,13 +1151,13 @@ declare const apiCheckpointSchema: z.ZodObject<{
1135
1151
  toolName: z.ZodOptional<z.ZodString>;
1136
1152
  delegateTo: z.ZodOptional<z.ZodObject<{
1137
1153
  expert: z.ZodObject<{
1138
- id: z.ZodCUID2;
1139
1154
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1140
1155
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1156
+ description: z.ZodString;
1157
+ id: z.ZodCUID2;
1141
1158
  minRuntimeVersion: z.ZodEnum<{
1142
1159
  "v1.0": "v1.0";
1143
1160
  }>;
1144
- description: z.ZodString;
1145
1161
  owner: z.ZodObject<{
1146
1162
  name: z.ZodOptional<z.ZodString>;
1147
1163
  organizationId: z.ZodCUID2;
@@ -1158,13 +1174,13 @@ declare const apiCheckpointSchema: z.ZodObject<{
1158
1174
  }, z.core.$strip>>;
1159
1175
  delegatedBy: z.ZodOptional<z.ZodObject<{
1160
1176
  expert: z.ZodObject<{
1161
- id: z.ZodCUID2;
1162
1177
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1163
1178
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1179
+ description: z.ZodString;
1180
+ id: z.ZodCUID2;
1164
1181
  minRuntimeVersion: z.ZodEnum<{
1165
1182
  "v1.0": "v1.0";
1166
1183
  }>;
1167
- description: z.ZodString;
1168
1184
  owner: z.ZodObject<{
1169
1185
  name: z.ZodOptional<z.ZodString>;
1170
1186
  organizationId: z.ZodCUID2;
@@ -1516,13 +1532,13 @@ declare const apiExpertJobSchema: z.ZodObject<{
1516
1532
  files: z.ZodOptional<z.ZodArray<z.ZodString>>;
1517
1533
  interactiveToolCallResult: z.ZodOptional<z.ZodBoolean>;
1518
1534
  expert: z.ZodDiscriminatedUnion<[z.ZodObject<{
1519
- id: z.ZodCUID2;
1520
1535
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1521
1536
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1537
+ description: z.ZodString;
1538
+ id: z.ZodCUID2;
1522
1539
  minRuntimeVersion: z.ZodEnum<{
1523
1540
  "v1.0": "v1.0";
1524
1541
  }>;
1525
- description: z.ZodString;
1526
1542
  owner: z.ZodObject<{
1527
1543
  name: z.ZodOptional<z.ZodString>;
1528
1544
  organizationId: z.ZodCUID2;
@@ -1534,13 +1550,13 @@ declare const apiExpertJobSchema: z.ZodObject<{
1534
1550
  version: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
1535
1551
  tags: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
1536
1552
  }, z.core.$strip>, z.ZodObject<{
1537
- id: z.ZodCUID2;
1538
1553
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1539
1554
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1555
+ description: z.ZodString;
1556
+ id: z.ZodCUID2;
1540
1557
  minRuntimeVersion: z.ZodEnum<{
1541
1558
  "v1.0": "v1.0";
1542
1559
  }>;
1543
- description: z.ZodString;
1544
1560
  owner: z.ZodObject<{
1545
1561
  name: z.ZodOptional<z.ZodString>;
1546
1562
  organizationId: z.ZodCUID2;
@@ -1583,13 +1599,14 @@ declare const apiExpertJobSchema: z.ZodObject<{
1583
1599
  delegates: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
1584
1600
  tags: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
1585
1601
  }, z.core.$strip>, z.ZodObject<{
1586
- id: z.ZodCUID2;
1602
+ version: z.ZodString;
1587
1603
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1588
1604
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
1605
+ description: z.ZodString;
1606
+ id: z.ZodCUID2;
1589
1607
  minRuntimeVersion: z.ZodEnum<{
1590
1608
  "v1.0": "v1.0";
1591
1609
  }>;
1592
- description: z.ZodString;
1593
1610
  owner: z.ZodObject<{
1594
1611
  name: z.ZodOptional<z.ZodString>;
1595
1612
  organizationId: z.ZodCUID2;
@@ -2577,13 +2594,13 @@ declare const apiWorkspaceInstanceSchema: z.ZodObject<{
2577
2594
  files: z.ZodOptional<z.ZodArray<z.ZodString>>;
2578
2595
  interactiveToolCallResult: z.ZodOptional<z.ZodBoolean>;
2579
2596
  expert: z.ZodDiscriminatedUnion<[z.ZodObject<{
2580
- id: z.ZodCUID2;
2581
2597
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
2582
2598
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
2599
+ description: z.ZodString;
2600
+ id: z.ZodCUID2;
2583
2601
  minRuntimeVersion: z.ZodEnum<{
2584
2602
  "v1.0": "v1.0";
2585
2603
  }>;
2586
- description: z.ZodString;
2587
2604
  owner: z.ZodObject<{
2588
2605
  name: z.ZodOptional<z.ZodString>;
2589
2606
  organizationId: z.ZodCUID2;
@@ -2595,13 +2612,13 @@ declare const apiWorkspaceInstanceSchema: z.ZodObject<{
2595
2612
  version: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
2596
2613
  tags: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
2597
2614
  }, z.core.$strip>, z.ZodObject<{
2598
- id: z.ZodCUID2;
2599
2615
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
2600
2616
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
2617
+ description: z.ZodString;
2618
+ id: z.ZodCUID2;
2601
2619
  minRuntimeVersion: z.ZodEnum<{
2602
2620
  "v1.0": "v1.0";
2603
2621
  }>;
2604
- description: z.ZodString;
2605
2622
  owner: z.ZodObject<{
2606
2623
  name: z.ZodOptional<z.ZodString>;
2607
2624
  organizationId: z.ZodCUID2;
@@ -2644,13 +2661,14 @@ declare const apiWorkspaceInstanceSchema: z.ZodObject<{
2644
2661
  delegates: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
2645
2662
  tags: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>>;
2646
2663
  }, z.core.$strip>, z.ZodObject<{
2647
- id: z.ZodCUID2;
2664
+ version: z.ZodString;
2648
2665
  key: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
2649
2666
  name: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodString>, z.ZodString>, z.ZodString>;
2667
+ description: z.ZodString;
2668
+ id: z.ZodCUID2;
2650
2669
  minRuntimeVersion: z.ZodEnum<{
2651
2670
  "v1.0": "v1.0";
2652
2671
  }>;
2653
- description: z.ZodString;
2654
2672
  owner: z.ZodObject<{
2655
2673
  name: z.ZodOptional<z.ZodString>;
2656
2674
  organizationId: z.ZodCUID2;
@@ -2848,6 +2866,17 @@ declare const deleteWorkspaceInstanceItemInput: z.ZodObject<{
2848
2866
  }, z.core.$strip>;
2849
2867
  type DeleteWorkspaceInstanceItemInput = z.input<typeof deleteWorkspaceInstanceItemInput>;
2850
2868
  declare function deleteWorkspaceInstanceItem(input: DeleteWorkspaceInstanceItemInput, client: ApiV1Client): Promise<void>;
2869
+ /**
2870
+ * Find workspace instance items by path
2871
+ */
2872
+ declare const findWorkspaceInstanceItemsInput: z.ZodObject<{
2873
+ expertJobId: z.ZodString;
2874
+ path: z.ZodString;
2875
+ }, z.core.$strip>;
2876
+ type FindWorkspaceInstanceItemsInput = z.input<typeof findWorkspaceInstanceItemsInput>;
2877
+ declare function findWorkspaceInstanceItems(input: FindWorkspaceInstanceItemsInput, client: ApiV1Client): Promise<{
2878
+ workspaceItems: ApiWorkspaceItem[];
2879
+ }>;
2851
2880
 
2852
2881
  type ApiV1Config = {
2853
2882
  baseUrl?: string;
@@ -2880,6 +2909,9 @@ declare class ApiV1Client {
2880
2909
  latest: string;
2881
2910
  total: number;
2882
2911
  }>;
2912
+ update: (input: UpdateRegistryExpertInput) => Promise<{
2913
+ expert: ApiRegistryExpert;
2914
+ }>;
2883
2915
  delete: (input: DeleteRegistryExpertInput) => Promise<void>;
2884
2916
  };
2885
2917
  };
@@ -2955,6 +2987,9 @@ declare class ApiV1Client {
2955
2987
  take: number;
2956
2988
  skip: number;
2957
2989
  }>;
2990
+ find: (input: FindWorkspaceInstanceItemsInput) => Promise<{
2991
+ workspaceItems: ApiWorkspaceItem[];
2992
+ }>;
2958
2993
  download: (input: DownloadWorkspaceInstanceItemInput) => Promise<Blob>;
2959
2994
  update: (input: UpdateWorkspaceInstanceItemInput) => Promise<{
2960
2995
  workspaceItem: ApiWorkspaceItem;
@@ -3120,4 +3155,4 @@ declare const apiSkillSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
3120
3155
  }, z.core.$strip>], "type">;
3121
3156
  type ApiSkill = z.infer<typeof apiSkillSchema>;
3122
3157
 
3123
- export { type ApiApplication, type ApiApplicationStatus, type ApiCheckpoint, type ApiCheckpointAction, type ApiCheckpointStatus, ApiError, type ApiExpert, type ApiExpertDigest, type ApiExpertJob, type ApiExpertJobStatus, type ApiInteractiveSkill, type ApiMcpSseSkill, type ApiMcpStdioSkill, type ApiMcpStdioSkillCommand, type ApiOrganization, type ApiOrganizationStatus, type ApiOrganizationType, type ApiRegistryExpert, type ApiSkill, type ApiSkillName, type ApiStudioExpert, ApiV1Client, type ApiV1Config, type ApiWorkspace, type ApiWorkspaceInstance, type ApiWorkspaceItem, type ApiWorkspaceItemDirectory, type ApiWorkspaceItemFile, type ApiWorkspaceItemLifecycle, type ApiWorkspaceItemOwner, type ApiWorkspaceItemPermission, type ContinueExpertJobInput, type CreateCheckpointInput, type CreateRegistryExpertInput, type CreateStudioExpertInput, type CreateWorkspaceInstanceItemInput, type CreateWorkspaceItemInput, type CreateWorkspaceSecretInput, type CreateWorkspaceVariableInput, type DeleteRegistryExpertInput, type DeleteStudioExpertInput, type DeleteWorkspaceInstanceItemInput, type DeleteWorkspaceItemInput, type DeleteWorkspaceSecretInput, type DeleteWorkspaceVariableInput, type DownloadWorkspaceInstanceItemInput, type DownloadWorkspaceItemInput, type GetCheckpointInput, type GetCheckpointsInput, type GetExpertJobInput, type GetExpertJobsInput, type GetRegistryExpertInput, type GetRegistryExpertVersionsInput, type GetRegistryExpertsInput, type GetStudioExpertInput, type GetStudioExpertsInput, type GetWorkspaceInstanceInput, type GetWorkspaceInstanceItemInput, type GetWorkspaceInstanceItemsInput, type GetWorkspaceItemInput, type GetWorkspaceItemsInput, type ResumeExpertJobFromCheckpointInput, type StartExpertJobInput, type UpdateExpertJobInput, type UpdateStudioExpertInput, type UpdateWorkspaceInstanceItemInput, type UpdateWorkspaceItemInput, type UpdateWorkspaceVariableInput, apiApplicationSchema, apiApplicationStatusSchema, apiBaseExpertSchema, apiBaseWorkspaceItemSchema, apiCheckpointActionAppendTextFileSchema, apiCheckpointActionAttemptCompletionSchema, apiCheckpointActionCreateDirectorySchema, apiCheckpointActionDelegateSchema, apiCheckpointActionDeleteFileSchema, apiCheckpointActionEditTextFileSchema, apiCheckpointActionErrorSchema, apiCheckpointActionGeneralToolSchema, apiCheckpointActionGetFileInfoSchema, apiCheckpointActionInteractiveTool, apiCheckpointActionListDirectorySchema, apiCheckpointActionMoveFileSchema, apiCheckpointActionReadImageFileSchema, apiCheckpointActionReadPdfFileSchema, apiCheckpointActionReadTextFileSchema, apiCheckpointActionRetrySchema, apiCheckpointActionSchema, apiCheckpointActionTestUrlSchema, apiCheckpointActionThinkSchema, apiCheckpointActionTodoSchema, apiCheckpointActionWriteTextFileSchema, apiCheckpointSchema, apiCheckpointStatusSchema, apiExpertDigestSchema, apiExpertJobSchema, apiExpertJobStatusSchema, apiExpertSchema, apiInteractiveSkillSchema, apiMcpSseSkillSchema, apiMcpStdioSkillCommandSchema, apiMcpStdioSkillSchema, apiOrganizationSchema, apiOrganizationStatusSchema, apiOrganizationTypeSchema, apiRegistryExpertSchema, apiSkillNameSchema, apiSkillSchema, apiStudioExpertSchema, apiWorkspaceInstanceSchema, apiWorkspaceItemDirectorySchema, apiWorkspaceItemFileSchema, apiWorkspaceItemLifecycleSchema, apiWorkspaceItemOwnerSchema, apiWorkspaceItemPermissionSchema, apiWorkspaceItemSchema, apiWorkspaceSchema, continueExpertJob, createCheckpoint, createRegistryExpert, createStudioExpert, createWorkspaceInstanceItem, createWorkspaceItem, createWorkspaceSecret, createWorkspaceVariable, deleteRegistryExpert, deleteStudioExpert, deleteWorkspaceInstanceItem, deleteWorkspaceItem, deleteWorkspaceSecret, deleteWorkspaceVariable, downloadWorkspaceInstanceItem, downloadWorkspaceItem, getCheckpoint, getCheckpoints, getExpertJob, getExpertJobs, getRegistryExpert, getRegistryExpertVersions, getRegistryExperts, getStudioExpert, getStudioExperts, getWorkspace, getWorkspaceInstance, getWorkspaceInstanceItem, getWorkspaceInstanceItems, getWorkspaceItem, getWorkspaceItems, resumeExpertJobFromCheckpoint, startExpertJob, updateExpertJob, updateStudioExpert, updateWorkspaceInstanceItem, updateWorkspaceItem, updateWorkspaceVariable };
3158
+ export { type ApiApplication, type ApiApplicationStatus, type ApiCheckpoint, type ApiCheckpointAction, type ApiCheckpointStatus, ApiError, type ApiExpert, type ApiExpertDigest, type ApiExpertJob, type ApiExpertJobStatus, type ApiInteractiveSkill, type ApiMcpSseSkill, type ApiMcpStdioSkill, type ApiMcpStdioSkillCommand, type ApiOrganization, type ApiOrganizationStatus, type ApiOrganizationType, type ApiRegistryExpert, type ApiSkill, type ApiSkillName, type ApiStudioExpert, ApiV1Client, type ApiV1Config, type ApiWorkspace, type ApiWorkspaceInstance, type ApiWorkspaceItem, type ApiWorkspaceItemDirectory, type ApiWorkspaceItemFile, type ApiWorkspaceItemLifecycle, type ApiWorkspaceItemOwner, type ApiWorkspaceItemPermission, type ContinueExpertJobInput, type CreateCheckpointInput, type CreateRegistryExpertInput, type CreateStudioExpertInput, type CreateWorkspaceInstanceItemInput, type CreateWorkspaceItemInput, type CreateWorkspaceSecretInput, type CreateWorkspaceVariableInput, type DeleteRegistryExpertInput, type DeleteStudioExpertInput, type DeleteWorkspaceInstanceItemInput, type DeleteWorkspaceItemInput, type DeleteWorkspaceSecretInput, type DeleteWorkspaceVariableInput, type DownloadWorkspaceInstanceItemInput, type DownloadWorkspaceItemInput, type FindWorkspaceInstanceItemsInput, type GetCheckpointInput, type GetCheckpointsInput, type GetExpertJobInput, type GetExpertJobsInput, type GetRegistryExpertInput, type GetRegistryExpertVersionsInput, type GetRegistryExpertsInput, type GetStudioExpertInput, type GetStudioExpertsInput, type GetWorkspaceInstanceInput, type GetWorkspaceInstanceItemInput, type GetWorkspaceInstanceItemsInput, type GetWorkspaceItemInput, type GetWorkspaceItemsInput, type ResumeExpertJobFromCheckpointInput, type StartExpertJobInput, type UpdateExpertJobInput, type UpdateRegistryExpertInput, type UpdateStudioExpertInput, type UpdateWorkspaceInstanceItemInput, type UpdateWorkspaceItemInput, type UpdateWorkspaceVariableInput, apiApplicationSchema, apiApplicationStatusSchema, apiBaseExpertSchema, apiBaseWorkspaceItemSchema, apiCheckpointActionAppendTextFileSchema, apiCheckpointActionAttemptCompletionSchema, apiCheckpointActionCreateDirectorySchema, apiCheckpointActionDelegateSchema, apiCheckpointActionDeleteFileSchema, apiCheckpointActionEditTextFileSchema, apiCheckpointActionErrorSchema, apiCheckpointActionGeneralToolSchema, apiCheckpointActionGetFileInfoSchema, apiCheckpointActionInteractiveTool, apiCheckpointActionListDirectorySchema, apiCheckpointActionMoveFileSchema, apiCheckpointActionReadImageFileSchema, apiCheckpointActionReadPdfFileSchema, apiCheckpointActionReadTextFileSchema, apiCheckpointActionRetrySchema, apiCheckpointActionSchema, apiCheckpointActionTestUrlSchema, apiCheckpointActionThinkSchema, apiCheckpointActionTodoSchema, apiCheckpointActionWriteTextFileSchema, apiCheckpointSchema, apiCheckpointStatusSchema, apiExpertDigestSchema, apiExpertJobSchema, apiExpertJobStatusSchema, apiExpertSchema, apiInteractiveSkillSchema, apiMcpSseSkillSchema, apiMcpStdioSkillCommandSchema, apiMcpStdioSkillSchema, apiOrganizationSchema, apiOrganizationStatusSchema, apiOrganizationTypeSchema, apiRegistryExpertSchema, apiSkillNameSchema, apiSkillSchema, apiStudioExpertSchema, apiWorkspaceInstanceSchema, apiWorkspaceItemDirectorySchema, apiWorkspaceItemFileSchema, apiWorkspaceItemLifecycleSchema, apiWorkspaceItemOwnerSchema, apiWorkspaceItemPermissionSchema, apiWorkspaceItemSchema, apiWorkspaceSchema, continueExpertJob, createCheckpoint, createRegistryExpert, createStudioExpert, createWorkspaceInstanceItem, createWorkspaceItem, createWorkspaceSecret, createWorkspaceVariable, deleteRegistryExpert, deleteStudioExpert, deleteWorkspaceInstanceItem, deleteWorkspaceItem, deleteWorkspaceSecret, deleteWorkspaceVariable, downloadWorkspaceInstanceItem, downloadWorkspaceItem, findWorkspaceInstanceItems, getCheckpoint, getCheckpoints, getExpertJob, getExpertJobs, getRegistryExpert, getRegistryExpertVersions, getRegistryExperts, getStudioExpert, getStudioExperts, getWorkspace, getWorkspaceInstance, getWorkspaceInstanceItem, getWorkspaceInstanceItems, getWorkspaceItem, getWorkspaceItems, resumeExpertJobFromCheckpoint, startExpertJob, updateExpertJob, updateRegistryExpert, updateStudioExpert, updateWorkspaceInstanceItem, updateWorkspaceItem, updateWorkspaceVariable };