capman 0.5.5 → 0.6.1

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.
Files changed (60) hide show
  1. package/CHANGELOG.md +1 -1
  2. package/bin/lib/cmd-generate.js +156 -12
  3. package/bin/lib/cmd-help.js +3 -0
  4. package/dist/cjs/cache.d.ts +9 -0
  5. package/dist/cjs/cache.d.ts.map +1 -1
  6. package/dist/cjs/cache.js +37 -7
  7. package/dist/cjs/cache.js.map +1 -1
  8. package/dist/cjs/engine.d.ts +68 -1
  9. package/dist/cjs/engine.d.ts.map +1 -1
  10. package/dist/cjs/engine.js +313 -13
  11. package/dist/cjs/engine.js.map +1 -1
  12. package/dist/cjs/generator.d.ts.map +1 -1
  13. package/dist/cjs/generator.js +28 -6
  14. package/dist/cjs/generator.js.map +1 -1
  15. package/dist/cjs/index.d.ts +3 -1
  16. package/dist/cjs/index.d.ts.map +1 -1
  17. package/dist/cjs/index.js +5 -1
  18. package/dist/cjs/index.js.map +1 -1
  19. package/dist/cjs/learning.d.ts +7 -0
  20. package/dist/cjs/learning.d.ts.map +1 -1
  21. package/dist/cjs/learning.js +44 -23
  22. package/dist/cjs/learning.js.map +1 -1
  23. package/dist/cjs/matcher.d.ts +92 -0
  24. package/dist/cjs/matcher.d.ts.map +1 -1
  25. package/dist/cjs/matcher.js +354 -35
  26. package/dist/cjs/matcher.js.map +1 -1
  27. package/dist/cjs/parser.js +27 -9
  28. package/dist/cjs/parser.js.map +1 -1
  29. package/dist/cjs/resolver.d.ts +2 -2
  30. package/dist/cjs/resolver.d.ts.map +1 -1
  31. package/dist/cjs/resolver.js +66 -26
  32. package/dist/cjs/resolver.js.map +1 -1
  33. package/dist/cjs/schema.d.ts +865 -94
  34. package/dist/cjs/schema.d.ts.map +1 -1
  35. package/dist/cjs/schema.js +62 -12
  36. package/dist/cjs/schema.js.map +1 -1
  37. package/dist/cjs/types.d.ts +153 -9
  38. package/dist/cjs/types.d.ts.map +1 -1
  39. package/dist/cjs/version.d.ts +1 -1
  40. package/dist/cjs/version.js +1 -1
  41. package/dist/esm/cache.d.ts +9 -0
  42. package/dist/esm/cache.js +37 -7
  43. package/dist/esm/engine.d.ts +68 -1
  44. package/dist/esm/engine.js +314 -14
  45. package/dist/esm/generator.js +28 -6
  46. package/dist/esm/index.d.ts +3 -1
  47. package/dist/esm/index.js +2 -0
  48. package/dist/esm/learning.d.ts +7 -0
  49. package/dist/esm/learning.js +45 -24
  50. package/dist/esm/matcher.d.ts +92 -0
  51. package/dist/esm/matcher.js +346 -35
  52. package/dist/esm/parser.js +27 -9
  53. package/dist/esm/resolver.d.ts +2 -2
  54. package/dist/esm/resolver.js +66 -26
  55. package/dist/esm/schema.d.ts +865 -94
  56. package/dist/esm/schema.js +62 -12
  57. package/dist/esm/types.d.ts +153 -9
  58. package/dist/esm/version.d.ts +1 -1
  59. package/dist/esm/version.js +1 -1
  60. package/package.json +1 -1
package/dist/esm/schema.d.ts CHANGED
@@ -2,58 +2,172 @@ import { z } from 'zod';
2
2
  export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
3
3
  app: z.ZodString;
4
4
  baseUrl: z.ZodOptional<z.ZodString>;
5
+ info: z.ZodOptional<z.ZodObject<{
6
+ title: z.ZodOptional<z.ZodString>;
7
+ description: z.ZodOptional<z.ZodString>;
8
+ version: z.ZodOptional<z.ZodString>;
9
+ homepage: z.ZodOptional<z.ZodString>;
10
+ contact: z.ZodOptional<z.ZodObject<{
11
+ name: z.ZodOptional<z.ZodString>;
12
+ email: z.ZodOptional<z.ZodString>;
13
+ url: z.ZodOptional<z.ZodString>;
14
+ }, "strip", z.ZodTypeAny, {
15
+ name?: string | undefined;
16
+ email?: string | undefined;
17
+ url?: string | undefined;
18
+ }, {
19
+ name?: string | undefined;
20
+ email?: string | undefined;
21
+ url?: string | undefined;
22
+ }>>;
23
+ license: z.ZodOptional<z.ZodObject<{
24
+ name: z.ZodString;
25
+ url: z.ZodOptional<z.ZodString>;
26
+ }, "strip", z.ZodTypeAny, {
27
+ name: string;
28
+ url?: string | undefined;
29
+ }, {
30
+ name: string;
31
+ url?: string | undefined;
32
+ }>>;
33
+ }, "strip", z.ZodTypeAny, {
34
+ description?: string | undefined;
35
+ version?: string | undefined;
36
+ title?: string | undefined;
37
+ homepage?: string | undefined;
38
+ contact?: {
39
+ name?: string | undefined;
40
+ email?: string | undefined;
41
+ url?: string | undefined;
42
+ } | undefined;
43
+ license?: {
44
+ name: string;
45
+ url?: string | undefined;
46
+ } | undefined;
47
+ }, {
48
+ description?: string | undefined;
49
+ version?: string | undefined;
50
+ title?: string | undefined;
51
+ homepage?: string | undefined;
52
+ contact?: {
53
+ name?: string | undefined;
54
+ email?: string | undefined;
55
+ url?: string | undefined;
56
+ } | undefined;
57
+ license?: {
58
+ name: string;
59
+ url?: string | undefined;
60
+ } | undefined;
61
+ }>>;
62
+ servers: z.ZodOptional<z.ZodArray<z.ZodObject<{
63
+ url: z.ZodString;
64
+ description: z.ZodOptional<z.ZodString>;
65
+ environment: z.ZodOptional<z.ZodString>;
66
+ }, "strip", z.ZodTypeAny, {
67
+ url: string;
68
+ description?: string | undefined;
69
+ environment?: string | undefined;
70
+ }, {
71
+ url: string;
72
+ description?: string | undefined;
73
+ environment?: string | undefined;
74
+ }>, "many">>;
75
+ tagRegistry: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
76
+ description: z.ZodString;
77
+ }, "strip", z.ZodTypeAny, {
78
+ description: string;
79
+ }, {
80
+ description: string;
81
+ }>>>;
5
82
  capabilities: z.ZodEffects<z.ZodArray<z.ZodObject<{
6
83
  id: z.ZodString;
7
84
  name: z.ZodString;
8
85
  description: z.ZodString;
9
86
  examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
10
- params: z.ZodArray<z.ZodObject<{
87
+ params: z.ZodArray<z.ZodEffects<z.ZodObject<{
11
88
  name: z.ZodString;
12
89
  description: z.ZodString;
13
90
  required: z.ZodBoolean;
14
91
  source: z.ZodEnum<["user_query", "session"]>;
15
- default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
92
+ pattern: z.ZodOptional<z.ZodString>;
93
+ type: z.ZodOptional<z.ZodEnum<["string", "number", "boolean", "date", "email", "url", "enum", "object"]>>;
94
+ enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
95
+ example: z.ZodOptional<z.ZodString>;
16
96
  }, "strip", z.ZodTypeAny, {
17
97
  name: string;
18
- required: boolean;
19
98
  description: string;
99
+ required: boolean;
20
100
  source: "user_query" | "session";
21
- default?: string | number | boolean | undefined;
101
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
102
+ enum?: string[] | undefined;
103
+ pattern?: string | undefined;
104
+ example?: string | undefined;
22
105
  }, {
23
106
  name: string;
107
+ description: string;
108
+ required: boolean;
109
+ source: "user_query" | "session";
110
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
111
+ enum?: string[] | undefined;
112
+ pattern?: string | undefined;
113
+ example?: string | undefined;
114
+ }>, {
115
+ name: string;
116
+ description: string;
24
117
  required: boolean;
118
+ source: "user_query" | "session";
119
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
120
+ enum?: string[] | undefined;
121
+ pattern?: string | undefined;
122
+ example?: string | undefined;
123
+ }, {
124
+ name: string;
25
125
  description: string;
126
+ required: boolean;
26
127
  source: "user_query" | "session";
27
- default?: string | number | boolean | undefined;
128
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
129
+ enum?: string[] | undefined;
130
+ pattern?: string | undefined;
131
+ example?: string | undefined;
28
132
  }>, "many">;
29
133
  returns: z.ZodArray<z.ZodString, "many">;
30
134
  resolver: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
31
135
  type: z.ZodLiteral<"api">;
32
136
  endpoints: z.ZodArray<z.ZodObject<{
33
- method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
137
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
34
138
  path: z.ZodString;
35
139
  params: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
140
+ idempotent: z.ZodOptional<z.ZodBoolean>;
141
+ idempotencyKey: z.ZodOptional<z.ZodString>;
36
142
  }, "strip", z.ZodTypeAny, {
37
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
143
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
38
144
  path: string;
145
+ idempotent?: boolean | undefined;
146
+ idempotencyKey?: string | undefined;
39
147
  params?: string[] | undefined;
40
148
  }, {
41
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
149
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
42
150
  path: string;
151
+ idempotent?: boolean | undefined;
152
+ idempotencyKey?: string | undefined;
43
153
  params?: string[] | undefined;
44
154
  }>, "many">;
45
155
  }, "strip", z.ZodTypeAny, {
46
156
  type: "api";
47
157
  endpoints: {
48
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
158
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
49
159
  path: string;
160
+ idempotent?: boolean | undefined;
161
+ idempotencyKey?: string | undefined;
50
162
  params?: string[] | undefined;
51
163
  }[];
52
164
  }, {
53
165
  type: "api";
54
166
  endpoints: {
55
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
167
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
56
168
  path: string;
169
+ idempotent?: boolean | undefined;
170
+ idempotencyKey?: string | undefined;
57
171
  params?: string[] | undefined;
58
172
  }[];
59
173
  }>, z.ZodObject<{
@@ -72,28 +186,38 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
72
186
  type: z.ZodLiteral<"hybrid">;
73
187
  api: z.ZodObject<{
74
188
  endpoints: z.ZodArray<z.ZodObject<{
75
- method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
189
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
76
190
  path: z.ZodString;
77
191
  params: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
192
+ idempotent: z.ZodOptional<z.ZodBoolean>;
193
+ idempotencyKey: z.ZodOptional<z.ZodString>;
78
194
  }, "strip", z.ZodTypeAny, {
79
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
195
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
80
196
  path: string;
197
+ idempotent?: boolean | undefined;
198
+ idempotencyKey?: string | undefined;
81
199
  params?: string[] | undefined;
82
200
  }, {
83
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
201
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
84
202
  path: string;
203
+ idempotent?: boolean | undefined;
204
+ idempotencyKey?: string | undefined;
85
205
  params?: string[] | undefined;
86
206
  }>, "many">;
87
207
  }, "strip", z.ZodTypeAny, {
88
208
  endpoints: {
89
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
209
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
90
210
  path: string;
211
+ idempotent?: boolean | undefined;
212
+ idempotencyKey?: string | undefined;
91
213
  params?: string[] | undefined;
92
214
  }[];
93
215
  }, {
94
216
  endpoints: {
95
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
217
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
96
218
  path: string;
219
+ idempotent?: boolean | undefined;
220
+ idempotencyKey?: string | undefined;
97
221
  params?: string[] | undefined;
98
222
  }[];
99
223
  }>;
@@ -111,8 +235,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
111
235
  type: "hybrid";
112
236
  api: {
113
237
  endpoints: {
114
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
238
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
115
239
  path: string;
240
+ idempotent?: boolean | undefined;
241
+ idempotencyKey?: string | undefined;
116
242
  params?: string[] | undefined;
117
243
  }[];
118
244
  };
@@ -124,8 +250,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
124
250
  type: "hybrid";
125
251
  api: {
126
252
  endpoints: {
127
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
253
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
128
254
  path: string;
255
+ idempotent?: boolean | undefined;
256
+ idempotencyKey?: string | undefined;
129
257
  params?: string[] | undefined;
130
258
  }[];
131
259
  };
@@ -144,23 +272,71 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
144
272
  level: "public" | "user_owned" | "admin";
145
273
  note?: string | undefined;
146
274
  }>;
275
+ lifecycle: z.ZodOptional<z.ZodObject<{
276
+ status: z.ZodEnum<["stable", "beta", "experimental", "deprecated"]>;
277
+ deprecatedAt: z.ZodOptional<z.ZodString>;
278
+ sunsetAt: z.ZodOptional<z.ZodString>;
279
+ successor: z.ZodOptional<z.ZodString>;
280
+ note: z.ZodOptional<z.ZodString>;
281
+ }, "strip", z.ZodTypeAny, {
282
+ status: "stable" | "beta" | "experimental" | "deprecated";
283
+ sunsetAt?: string | undefined;
284
+ successor?: string | undefined;
285
+ note?: string | undefined;
286
+ deprecatedAt?: string | undefined;
287
+ }, {
288
+ status: "stable" | "beta" | "experimental" | "deprecated";
289
+ sunsetAt?: string | undefined;
290
+ successor?: string | undefined;
291
+ note?: string | undefined;
292
+ deprecatedAt?: string | undefined;
293
+ }>>;
294
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
295
+ errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
296
+ code: z.ZodString;
297
+ description: z.ZodString;
298
+ httpStatus: z.ZodOptional<z.ZodNumber>;
299
+ retryable: z.ZodOptional<z.ZodBoolean>;
300
+ }, "strip", z.ZodTypeAny, {
301
+ code: string;
302
+ description: string;
303
+ httpStatus?: number | undefined;
304
+ retryable?: boolean | undefined;
305
+ }, {
306
+ code: string;
307
+ description: string;
308
+ httpStatus?: number | undefined;
309
+ retryable?: boolean | undefined;
310
+ }>, "many">>;
311
+ matchHint: z.ZodOptional<z.ZodObject<{
312
+ preferredMode: z.ZodOptional<z.ZodEnum<["cheap", "balanced", "accurate"]>>;
313
+ }, "strip", z.ZodTypeAny, {
314
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
315
+ }, {
316
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
317
+ }>>;
147
318
  }, "strip", z.ZodTypeAny, {
148
319
  name: string;
149
320
  id: string;
321
+ description: string;
150
322
  params: {
151
323
  name: string;
152
- required: boolean;
153
324
  description: string;
325
+ required: boolean;
154
326
  source: "user_query" | "session";
155
- default?: string | number | boolean | undefined;
327
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
328
+ enum?: string[] | undefined;
329
+ pattern?: string | undefined;
330
+ example?: string | undefined;
156
331
  }[];
157
- description: string;
158
332
  returns: string[];
159
333
  resolver: {
160
334
  type: "api";
161
335
  endpoints: {
162
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
336
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
163
337
  path: string;
338
+ idempotent?: boolean | undefined;
339
+ idempotencyKey?: string | undefined;
164
340
  params?: string[] | undefined;
165
341
  }[];
166
342
  } | {
@@ -171,8 +347,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
171
347
  type: "hybrid";
172
348
  api: {
173
349
  endpoints: {
174
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
350
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
175
351
  path: string;
352
+ idempotent?: boolean | undefined;
353
+ idempotencyKey?: string | undefined;
176
354
  params?: string[] | undefined;
177
355
  }[];
178
356
  };
@@ -186,23 +364,45 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
186
364
  note?: string | undefined;
187
365
  };
188
366
  examples?: string[] | undefined;
367
+ lifecycle?: {
368
+ status: "stable" | "beta" | "experimental" | "deprecated";
369
+ sunsetAt?: string | undefined;
370
+ successor?: string | undefined;
371
+ note?: string | undefined;
372
+ deprecatedAt?: string | undefined;
373
+ } | undefined;
374
+ tags?: string[] | undefined;
375
+ errors?: {
376
+ code: string;
377
+ description: string;
378
+ httpStatus?: number | undefined;
379
+ retryable?: boolean | undefined;
380
+ }[] | undefined;
381
+ matchHint?: {
382
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
383
+ } | undefined;
189
384
  }, {
190
385
  name: string;
191
386
  id: string;
387
+ description: string;
192
388
  params: {
193
389
  name: string;
194
- required: boolean;
195
390
  description: string;
391
+ required: boolean;
196
392
  source: "user_query" | "session";
197
- default?: string | number | boolean | undefined;
393
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
394
+ enum?: string[] | undefined;
395
+ pattern?: string | undefined;
396
+ example?: string | undefined;
198
397
  }[];
199
- description: string;
200
398
  returns: string[];
201
399
  resolver: {
202
400
  type: "api";
203
401
  endpoints: {
204
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
402
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
205
403
  path: string;
404
+ idempotent?: boolean | undefined;
405
+ idempotencyKey?: string | undefined;
206
406
  params?: string[] | undefined;
207
407
  }[];
208
408
  } | {
@@ -213,8 +413,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
213
413
  type: "hybrid";
214
414
  api: {
215
415
  endpoints: {
216
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
416
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
217
417
  path: string;
418
+ idempotent?: boolean | undefined;
419
+ idempotencyKey?: string | undefined;
218
420
  params?: string[] | undefined;
219
421
  }[];
220
422
  };
@@ -228,23 +430,45 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
228
430
  note?: string | undefined;
229
431
  };
230
432
  examples?: string[] | undefined;
433
+ lifecycle?: {
434
+ status: "stable" | "beta" | "experimental" | "deprecated";
435
+ sunsetAt?: string | undefined;
436
+ successor?: string | undefined;
437
+ note?: string | undefined;
438
+ deprecatedAt?: string | undefined;
439
+ } | undefined;
440
+ tags?: string[] | undefined;
441
+ errors?: {
442
+ code: string;
443
+ description: string;
444
+ httpStatus?: number | undefined;
445
+ retryable?: boolean | undefined;
446
+ }[] | undefined;
447
+ matchHint?: {
448
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
449
+ } | undefined;
231
450
  }>, "many">, {
232
451
  name: string;
233
452
  id: string;
453
+ description: string;
234
454
  params: {
235
455
  name: string;
236
- required: boolean;
237
456
  description: string;
457
+ required: boolean;
238
458
  source: "user_query" | "session";
239
- default?: string | number | boolean | undefined;
459
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
460
+ enum?: string[] | undefined;
461
+ pattern?: string | undefined;
462
+ example?: string | undefined;
240
463
  }[];
241
- description: string;
242
464
  returns: string[];
243
465
  resolver: {
244
466
  type: "api";
245
467
  endpoints: {
246
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
468
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
247
469
  path: string;
470
+ idempotent?: boolean | undefined;
471
+ idempotencyKey?: string | undefined;
248
472
  params?: string[] | undefined;
249
473
  }[];
250
474
  } | {
@@ -255,8 +479,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
255
479
  type: "hybrid";
256
480
  api: {
257
481
  endpoints: {
258
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
482
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
259
483
  path: string;
484
+ idempotent?: boolean | undefined;
485
+ idempotencyKey?: string | undefined;
260
486
  params?: string[] | undefined;
261
487
  }[];
262
488
  };
@@ -270,23 +496,45 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
270
496
  note?: string | undefined;
271
497
  };
272
498
  examples?: string[] | undefined;
499
+ lifecycle?: {
500
+ status: "stable" | "beta" | "experimental" | "deprecated";
501
+ sunsetAt?: string | undefined;
502
+ successor?: string | undefined;
503
+ note?: string | undefined;
504
+ deprecatedAt?: string | undefined;
505
+ } | undefined;
506
+ tags?: string[] | undefined;
507
+ errors?: {
508
+ code: string;
509
+ description: string;
510
+ httpStatus?: number | undefined;
511
+ retryable?: boolean | undefined;
512
+ }[] | undefined;
513
+ matchHint?: {
514
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
515
+ } | undefined;
273
516
  }[], {
274
517
  name: string;
275
518
  id: string;
519
+ description: string;
276
520
  params: {
277
521
  name: string;
278
- required: boolean;
279
522
  description: string;
523
+ required: boolean;
280
524
  source: "user_query" | "session";
281
- default?: string | number | boolean | undefined;
525
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
526
+ enum?: string[] | undefined;
527
+ pattern?: string | undefined;
528
+ example?: string | undefined;
282
529
  }[];
283
- description: string;
284
530
  returns: string[];
285
531
  resolver: {
286
532
  type: "api";
287
533
  endpoints: {
288
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
534
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
289
535
  path: string;
536
+ idempotent?: boolean | undefined;
537
+ idempotencyKey?: string | undefined;
290
538
  params?: string[] | undefined;
291
539
  }[];
292
540
  } | {
@@ -297,8 +545,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
297
545
  type: "hybrid";
298
546
  api: {
299
547
  endpoints: {
300
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
548
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
301
549
  path: string;
550
+ idempotent?: boolean | undefined;
551
+ idempotencyKey?: string | undefined;
302
552
  params?: string[] | undefined;
303
553
  }[];
304
554
  };
@@ -312,26 +562,48 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
312
562
  note?: string | undefined;
313
563
  };
314
564
  examples?: string[] | undefined;
565
+ lifecycle?: {
566
+ status: "stable" | "beta" | "experimental" | "deprecated";
567
+ sunsetAt?: string | undefined;
568
+ successor?: string | undefined;
569
+ note?: string | undefined;
570
+ deprecatedAt?: string | undefined;
571
+ } | undefined;
572
+ tags?: string[] | undefined;
573
+ errors?: {
574
+ code: string;
575
+ description: string;
576
+ httpStatus?: number | undefined;
577
+ retryable?: boolean | undefined;
578
+ }[] | undefined;
579
+ matchHint?: {
580
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
581
+ } | undefined;
315
582
  }[]>;
316
583
  }, "strip", z.ZodTypeAny, {
317
584
  app: string;
318
585
  capabilities: {
319
586
  name: string;
320
587
  id: string;
588
+ description: string;
321
589
  params: {
322
590
  name: string;
323
- required: boolean;
324
591
  description: string;
592
+ required: boolean;
325
593
  source: "user_query" | "session";
326
- default?: string | number | boolean | undefined;
594
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
595
+ enum?: string[] | undefined;
596
+ pattern?: string | undefined;
597
+ example?: string | undefined;
327
598
  }[];
328
- description: string;
329
599
  returns: string[];
330
600
  resolver: {
331
601
  type: "api";
332
602
  endpoints: {
333
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
603
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
334
604
  path: string;
605
+ idempotent?: boolean | undefined;
606
+ idempotencyKey?: string | undefined;
335
607
  params?: string[] | undefined;
336
608
  }[];
337
609
  } | {
@@ -342,8 +614,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
342
614
  type: "hybrid";
343
615
  api: {
344
616
  endpoints: {
345
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
617
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
346
618
  path: string;
619
+ idempotent?: boolean | undefined;
620
+ idempotencyKey?: string | undefined;
347
621
  params?: string[] | undefined;
348
622
  }[];
349
623
  };
@@ -357,27 +631,72 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
357
631
  note?: string | undefined;
358
632
  };
359
633
  examples?: string[] | undefined;
634
+ lifecycle?: {
635
+ status: "stable" | "beta" | "experimental" | "deprecated";
636
+ sunsetAt?: string | undefined;
637
+ successor?: string | undefined;
638
+ note?: string | undefined;
639
+ deprecatedAt?: string | undefined;
640
+ } | undefined;
641
+ tags?: string[] | undefined;
642
+ errors?: {
643
+ code: string;
644
+ description: string;
645
+ httpStatus?: number | undefined;
646
+ retryable?: boolean | undefined;
647
+ }[] | undefined;
648
+ matchHint?: {
649
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
650
+ } | undefined;
360
651
  }[];
652
+ info?: {
653
+ description?: string | undefined;
654
+ version?: string | undefined;
655
+ title?: string | undefined;
656
+ homepage?: string | undefined;
657
+ contact?: {
658
+ name?: string | undefined;
659
+ email?: string | undefined;
660
+ url?: string | undefined;
661
+ } | undefined;
662
+ license?: {
663
+ name: string;
664
+ url?: string | undefined;
665
+ } | undefined;
666
+ } | undefined;
361
667
  baseUrl?: string | undefined;
668
+ servers?: {
669
+ url: string;
670
+ description?: string | undefined;
671
+ environment?: string | undefined;
672
+ }[] | undefined;
673
+ tagRegistry?: Record<string, {
674
+ description: string;
675
+ }> | undefined;
362
676
  }, {
363
677
  app: string;
364
678
  capabilities: {
365
679
  name: string;
366
680
  id: string;
681
+ description: string;
367
682
  params: {
368
683
  name: string;
369
- required: boolean;
370
684
  description: string;
685
+ required: boolean;
371
686
  source: "user_query" | "session";
372
- default?: string | number | boolean | undefined;
687
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
688
+ enum?: string[] | undefined;
689
+ pattern?: string | undefined;
690
+ example?: string | undefined;
373
691
  }[];
374
- description: string;
375
692
  returns: string[];
376
693
  resolver: {
377
694
  type: "api";
378
695
  endpoints: {
379
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
696
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
380
697
  path: string;
698
+ idempotent?: boolean | undefined;
699
+ idempotencyKey?: string | undefined;
381
700
  params?: string[] | undefined;
382
701
  }[];
383
702
  } | {
@@ -388,8 +707,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
388
707
  type: "hybrid";
389
708
  api: {
390
709
  endpoints: {
391
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
710
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
392
711
  path: string;
712
+ idempotent?: boolean | undefined;
713
+ idempotencyKey?: string | undefined;
393
714
  params?: string[] | undefined;
394
715
  }[];
395
716
  };
@@ -403,27 +724,72 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
403
724
  note?: string | undefined;
404
725
  };
405
726
  examples?: string[] | undefined;
727
+ lifecycle?: {
728
+ status: "stable" | "beta" | "experimental" | "deprecated";
729
+ sunsetAt?: string | undefined;
730
+ successor?: string | undefined;
731
+ note?: string | undefined;
732
+ deprecatedAt?: string | undefined;
733
+ } | undefined;
734
+ tags?: string[] | undefined;
735
+ errors?: {
736
+ code: string;
737
+ description: string;
738
+ httpStatus?: number | undefined;
739
+ retryable?: boolean | undefined;
740
+ }[] | undefined;
741
+ matchHint?: {
742
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
743
+ } | undefined;
406
744
  }[];
745
+ info?: {
746
+ description?: string | undefined;
747
+ version?: string | undefined;
748
+ title?: string | undefined;
749
+ homepage?: string | undefined;
750
+ contact?: {
751
+ name?: string | undefined;
752
+ email?: string | undefined;
753
+ url?: string | undefined;
754
+ } | undefined;
755
+ license?: {
756
+ name: string;
757
+ url?: string | undefined;
758
+ } | undefined;
759
+ } | undefined;
407
760
  baseUrl?: string | undefined;
761
+ servers?: {
762
+ url: string;
763
+ description?: string | undefined;
764
+ environment?: string | undefined;
765
+ }[] | undefined;
766
+ tagRegistry?: Record<string, {
767
+ description: string;
768
+ }> | undefined;
408
769
  }>, {
409
770
  app: string;
410
771
  capabilities: {
411
772
  name: string;
412
773
  id: string;
774
+ description: string;
413
775
  params: {
414
776
  name: string;
415
- required: boolean;
416
777
  description: string;
778
+ required: boolean;
417
779
  source: "user_query" | "session";
418
- default?: string | number | boolean | undefined;
780
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
781
+ enum?: string[] | undefined;
782
+ pattern?: string | undefined;
783
+ example?: string | undefined;
419
784
  }[];
420
- description: string;
421
785
  returns: string[];
422
786
  resolver: {
423
787
  type: "api";
424
788
  endpoints: {
425
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
789
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
426
790
  path: string;
791
+ idempotent?: boolean | undefined;
792
+ idempotencyKey?: string | undefined;
427
793
  params?: string[] | undefined;
428
794
  }[];
429
795
  } | {
@@ -434,8 +800,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
434
800
  type: "hybrid";
435
801
  api: {
436
802
  endpoints: {
437
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
803
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
438
804
  path: string;
805
+ idempotent?: boolean | undefined;
806
+ idempotencyKey?: string | undefined;
439
807
  params?: string[] | undefined;
440
808
  }[];
441
809
  };
@@ -449,27 +817,72 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
449
817
  note?: string | undefined;
450
818
  };
451
819
  examples?: string[] | undefined;
820
+ lifecycle?: {
821
+ status: "stable" | "beta" | "experimental" | "deprecated";
822
+ sunsetAt?: string | undefined;
823
+ successor?: string | undefined;
824
+ note?: string | undefined;
825
+ deprecatedAt?: string | undefined;
826
+ } | undefined;
827
+ tags?: string[] | undefined;
828
+ errors?: {
829
+ code: string;
830
+ description: string;
831
+ httpStatus?: number | undefined;
832
+ retryable?: boolean | undefined;
833
+ }[] | undefined;
834
+ matchHint?: {
835
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
836
+ } | undefined;
452
837
  }[];
838
+ info?: {
839
+ description?: string | undefined;
840
+ version?: string | undefined;
841
+ title?: string | undefined;
842
+ homepage?: string | undefined;
843
+ contact?: {
844
+ name?: string | undefined;
845
+ email?: string | undefined;
846
+ url?: string | undefined;
847
+ } | undefined;
848
+ license?: {
849
+ name: string;
850
+ url?: string | undefined;
851
+ } | undefined;
852
+ } | undefined;
453
853
  baseUrl?: string | undefined;
854
+ servers?: {
855
+ url: string;
856
+ description?: string | undefined;
857
+ environment?: string | undefined;
858
+ }[] | undefined;
859
+ tagRegistry?: Record<string, {
860
+ description: string;
861
+ }> | undefined;
454
862
  }, {
455
863
  app: string;
456
864
  capabilities: {
457
865
  name: string;
458
866
  id: string;
867
+ description: string;
459
868
  params: {
460
869
  name: string;
461
- required: boolean;
462
870
  description: string;
871
+ required: boolean;
463
872
  source: "user_query" | "session";
464
- default?: string | number | boolean | undefined;
873
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
874
+ enum?: string[] | undefined;
875
+ pattern?: string | undefined;
876
+ example?: string | undefined;
465
877
  }[];
466
- description: string;
467
878
  returns: string[];
468
879
  resolver: {
469
880
  type: "api";
470
881
  endpoints: {
471
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
882
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
472
883
  path: string;
884
+ idempotent?: boolean | undefined;
885
+ idempotencyKey?: string | undefined;
473
886
  params?: string[] | undefined;
474
887
  }[];
475
888
  } | {
@@ -480,8 +893,10 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
480
893
  type: "hybrid";
481
894
  api: {
482
895
  endpoints: {
483
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
896
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
484
897
  path: string;
898
+ idempotent?: boolean | undefined;
899
+ idempotencyKey?: string | undefined;
485
900
  params?: string[] | undefined;
486
901
  }[];
487
902
  };
@@ -495,10 +910,51 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
495
910
  note?: string | undefined;
496
911
  };
497
912
  examples?: string[] | undefined;
913
+ lifecycle?: {
914
+ status: "stable" | "beta" | "experimental" | "deprecated";
915
+ sunsetAt?: string | undefined;
916
+ successor?: string | undefined;
917
+ note?: string | undefined;
918
+ deprecatedAt?: string | undefined;
919
+ } | undefined;
920
+ tags?: string[] | undefined;
921
+ errors?: {
922
+ code: string;
923
+ description: string;
924
+ httpStatus?: number | undefined;
925
+ retryable?: boolean | undefined;
926
+ }[] | undefined;
927
+ matchHint?: {
928
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
929
+ } | undefined;
498
930
  }[];
931
+ info?: {
932
+ description?: string | undefined;
933
+ version?: string | undefined;
934
+ title?: string | undefined;
935
+ homepage?: string | undefined;
936
+ contact?: {
937
+ name?: string | undefined;
938
+ email?: string | undefined;
939
+ url?: string | undefined;
940
+ } | undefined;
941
+ license?: {
942
+ name: string;
943
+ url?: string | undefined;
944
+ } | undefined;
945
+ } | undefined;
499
946
  baseUrl?: string | undefined;
947
+ servers?: {
948
+ url: string;
949
+ description?: string | undefined;
950
+ environment?: string | undefined;
951
+ }[] | undefined;
952
+ tagRegistry?: Record<string, {
953
+ description: string;
954
+ }> | undefined;
500
955
  }>;
501
956
  export declare const ManifestSchema: z.ZodObject<{
957
+ schemaVersion: z.ZodString;
502
958
  version: z.ZodString;
503
959
  app: z.ZodString;
504
960
  generatedAt: z.ZodString;
@@ -507,53 +963,90 @@ export declare const ManifestSchema: z.ZodObject<{
507
963
  name: z.ZodString;
508
964
  description: z.ZodString;
509
965
  examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
510
- params: z.ZodArray<z.ZodObject<{
966
+ params: z.ZodArray<z.ZodEffects<z.ZodObject<{
511
967
  name: z.ZodString;
512
968
  description: z.ZodString;
513
969
  required: z.ZodBoolean;
514
970
  source: z.ZodEnum<["user_query", "session"]>;
515
- default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
971
+ pattern: z.ZodOptional<z.ZodString>;
972
+ type: z.ZodOptional<z.ZodEnum<["string", "number", "boolean", "date", "email", "url", "enum", "object"]>>;
973
+ enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
974
+ example: z.ZodOptional<z.ZodString>;
516
975
  }, "strip", z.ZodTypeAny, {
517
976
  name: string;
518
- required: boolean;
519
977
  description: string;
978
+ required: boolean;
520
979
  source: "user_query" | "session";
521
- default?: string | number | boolean | undefined;
980
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
981
+ enum?: string[] | undefined;
982
+ pattern?: string | undefined;
983
+ example?: string | undefined;
522
984
  }, {
523
985
  name: string;
986
+ description: string;
987
+ required: boolean;
988
+ source: "user_query" | "session";
989
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
990
+ enum?: string[] | undefined;
991
+ pattern?: string | undefined;
992
+ example?: string | undefined;
993
+ }>, {
994
+ name: string;
995
+ description: string;
524
996
  required: boolean;
997
+ source: "user_query" | "session";
998
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
999
+ enum?: string[] | undefined;
1000
+ pattern?: string | undefined;
1001
+ example?: string | undefined;
1002
+ }, {
1003
+ name: string;
525
1004
  description: string;
1005
+ required: boolean;
526
1006
  source: "user_query" | "session";
527
- default?: string | number | boolean | undefined;
1007
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
1008
+ enum?: string[] | undefined;
1009
+ pattern?: string | undefined;
1010
+ example?: string | undefined;
528
1011
  }>, "many">;
529
1012
  returns: z.ZodArray<z.ZodString, "many">;
530
1013
  resolver: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
531
1014
  type: z.ZodLiteral<"api">;
532
1015
  endpoints: z.ZodArray<z.ZodObject<{
533
- method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
1016
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
534
1017
  path: z.ZodString;
535
1018
  params: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1019
+ idempotent: z.ZodOptional<z.ZodBoolean>;
1020
+ idempotencyKey: z.ZodOptional<z.ZodString>;
536
1021
  }, "strip", z.ZodTypeAny, {
537
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1022
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
538
1023
  path: string;
1024
+ idempotent?: boolean | undefined;
1025
+ idempotencyKey?: string | undefined;
539
1026
  params?: string[] | undefined;
540
1027
  }, {
541
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1028
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
542
1029
  path: string;
1030
+ idempotent?: boolean | undefined;
1031
+ idempotencyKey?: string | undefined;
543
1032
  params?: string[] | undefined;
544
1033
  }>, "many">;
545
1034
  }, "strip", z.ZodTypeAny, {
546
1035
  type: "api";
547
1036
  endpoints: {
548
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1037
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
549
1038
  path: string;
1039
+ idempotent?: boolean | undefined;
1040
+ idempotencyKey?: string | undefined;
550
1041
  params?: string[] | undefined;
551
1042
  }[];
552
1043
  }, {
553
1044
  type: "api";
554
1045
  endpoints: {
555
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1046
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
556
1047
  path: string;
1048
+ idempotent?: boolean | undefined;
1049
+ idempotencyKey?: string | undefined;
557
1050
  params?: string[] | undefined;
558
1051
  }[];
559
1052
  }>, z.ZodObject<{
@@ -572,28 +1065,38 @@ export declare const ManifestSchema: z.ZodObject<{
572
1065
  type: z.ZodLiteral<"hybrid">;
573
1066
  api: z.ZodObject<{
574
1067
  endpoints: z.ZodArray<z.ZodObject<{
575
- method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>;
1068
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
576
1069
  path: z.ZodString;
577
1070
  params: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1071
+ idempotent: z.ZodOptional<z.ZodBoolean>;
1072
+ idempotencyKey: z.ZodOptional<z.ZodString>;
578
1073
  }, "strip", z.ZodTypeAny, {
579
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1074
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
580
1075
  path: string;
1076
+ idempotent?: boolean | undefined;
1077
+ idempotencyKey?: string | undefined;
581
1078
  params?: string[] | undefined;
582
1079
  }, {
583
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1080
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
584
1081
  path: string;
1082
+ idempotent?: boolean | undefined;
1083
+ idempotencyKey?: string | undefined;
585
1084
  params?: string[] | undefined;
586
1085
  }>, "many">;
587
1086
  }, "strip", z.ZodTypeAny, {
588
1087
  endpoints: {
589
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1088
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
590
1089
  path: string;
1090
+ idempotent?: boolean | undefined;
1091
+ idempotencyKey?: string | undefined;
591
1092
  params?: string[] | undefined;
592
1093
  }[];
593
1094
  }, {
594
1095
  endpoints: {
595
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1096
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
596
1097
  path: string;
1098
+ idempotent?: boolean | undefined;
1099
+ idempotencyKey?: string | undefined;
597
1100
  params?: string[] | undefined;
598
1101
  }[];
599
1102
  }>;
@@ -611,8 +1114,10 @@ export declare const ManifestSchema: z.ZodObject<{
611
1114
  type: "hybrid";
612
1115
  api: {
613
1116
  endpoints: {
614
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1117
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
615
1118
  path: string;
1119
+ idempotent?: boolean | undefined;
1120
+ idempotencyKey?: string | undefined;
616
1121
  params?: string[] | undefined;
617
1122
  }[];
618
1123
  };
@@ -624,8 +1129,10 @@ export declare const ManifestSchema: z.ZodObject<{
624
1129
  type: "hybrid";
625
1130
  api: {
626
1131
  endpoints: {
627
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1132
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
628
1133
  path: string;
1134
+ idempotent?: boolean | undefined;
1135
+ idempotencyKey?: string | undefined;
629
1136
  params?: string[] | undefined;
630
1137
  }[];
631
1138
  };
@@ -644,23 +1151,71 @@ export declare const ManifestSchema: z.ZodObject<{
644
1151
  level: "public" | "user_owned" | "admin";
645
1152
  note?: string | undefined;
646
1153
  }>;
1154
+ lifecycle: z.ZodOptional<z.ZodObject<{
1155
+ status: z.ZodEnum<["stable", "beta", "experimental", "deprecated"]>;
1156
+ deprecatedAt: z.ZodOptional<z.ZodString>;
1157
+ sunsetAt: z.ZodOptional<z.ZodString>;
1158
+ successor: z.ZodOptional<z.ZodString>;
1159
+ note: z.ZodOptional<z.ZodString>;
1160
+ }, "strip", z.ZodTypeAny, {
1161
+ status: "stable" | "beta" | "experimental" | "deprecated";
1162
+ sunsetAt?: string | undefined;
1163
+ successor?: string | undefined;
1164
+ note?: string | undefined;
1165
+ deprecatedAt?: string | undefined;
1166
+ }, {
1167
+ status: "stable" | "beta" | "experimental" | "deprecated";
1168
+ sunsetAt?: string | undefined;
1169
+ successor?: string | undefined;
1170
+ note?: string | undefined;
1171
+ deprecatedAt?: string | undefined;
1172
+ }>>;
1173
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1174
+ errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
1175
+ code: z.ZodString;
1176
+ description: z.ZodString;
1177
+ httpStatus: z.ZodOptional<z.ZodNumber>;
1178
+ retryable: z.ZodOptional<z.ZodBoolean>;
1179
+ }, "strip", z.ZodTypeAny, {
1180
+ code: string;
1181
+ description: string;
1182
+ httpStatus?: number | undefined;
1183
+ retryable?: boolean | undefined;
1184
+ }, {
1185
+ code: string;
1186
+ description: string;
1187
+ httpStatus?: number | undefined;
1188
+ retryable?: boolean | undefined;
1189
+ }>, "many">>;
1190
+ matchHint: z.ZodOptional<z.ZodObject<{
1191
+ preferredMode: z.ZodOptional<z.ZodEnum<["cheap", "balanced", "accurate"]>>;
1192
+ }, "strip", z.ZodTypeAny, {
1193
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
1194
+ }, {
1195
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
1196
+ }>>;
647
1197
  }, "strip", z.ZodTypeAny, {
648
1198
  name: string;
649
1199
  id: string;
1200
+ description: string;
650
1201
  params: {
651
1202
  name: string;
652
- required: boolean;
653
1203
  description: string;
1204
+ required: boolean;
654
1205
  source: "user_query" | "session";
655
- default?: string | number | boolean | undefined;
1206
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
1207
+ enum?: string[] | undefined;
1208
+ pattern?: string | undefined;
1209
+ example?: string | undefined;
656
1210
  }[];
657
- description: string;
658
1211
  returns: string[];
659
1212
  resolver: {
660
1213
  type: "api";
661
1214
  endpoints: {
662
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1215
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
663
1216
  path: string;
1217
+ idempotent?: boolean | undefined;
1218
+ idempotencyKey?: string | undefined;
664
1219
  params?: string[] | undefined;
665
1220
  }[];
666
1221
  } | {
@@ -671,8 +1226,10 @@ export declare const ManifestSchema: z.ZodObject<{
671
1226
  type: "hybrid";
672
1227
  api: {
673
1228
  endpoints: {
674
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1229
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
675
1230
  path: string;
1231
+ idempotent?: boolean | undefined;
1232
+ idempotencyKey?: string | undefined;
676
1233
  params?: string[] | undefined;
677
1234
  }[];
678
1235
  };
@@ -686,23 +1243,45 @@ export declare const ManifestSchema: z.ZodObject<{
686
1243
  note?: string | undefined;
687
1244
  };
688
1245
  examples?: string[] | undefined;
1246
+ lifecycle?: {
1247
+ status: "stable" | "beta" | "experimental" | "deprecated";
1248
+ sunsetAt?: string | undefined;
1249
+ successor?: string | undefined;
1250
+ note?: string | undefined;
1251
+ deprecatedAt?: string | undefined;
1252
+ } | undefined;
1253
+ tags?: string[] | undefined;
1254
+ errors?: {
1255
+ code: string;
1256
+ description: string;
1257
+ httpStatus?: number | undefined;
1258
+ retryable?: boolean | undefined;
1259
+ }[] | undefined;
1260
+ matchHint?: {
1261
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
1262
+ } | undefined;
689
1263
  }, {
690
1264
  name: string;
691
1265
  id: string;
1266
+ description: string;
692
1267
  params: {
693
1268
  name: string;
694
- required: boolean;
695
1269
  description: string;
1270
+ required: boolean;
696
1271
  source: "user_query" | "session";
697
- default?: string | number | boolean | undefined;
1272
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
1273
+ enum?: string[] | undefined;
1274
+ pattern?: string | undefined;
1275
+ example?: string | undefined;
698
1276
  }[];
699
- description: string;
700
1277
  returns: string[];
701
1278
  resolver: {
702
1279
  type: "api";
703
1280
  endpoints: {
704
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1281
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
705
1282
  path: string;
1283
+ idempotent?: boolean | undefined;
1284
+ idempotencyKey?: string | undefined;
706
1285
  params?: string[] | undefined;
707
1286
  }[];
708
1287
  } | {
@@ -713,8 +1292,10 @@ export declare const ManifestSchema: z.ZodObject<{
713
1292
  type: "hybrid";
714
1293
  api: {
715
1294
  endpoints: {
716
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1295
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
717
1296
  path: string;
1297
+ idempotent?: boolean | undefined;
1298
+ idempotencyKey?: string | undefined;
718
1299
  params?: string[] | undefined;
719
1300
  }[];
720
1301
  };
@@ -728,27 +1309,126 @@ export declare const ManifestSchema: z.ZodObject<{
728
1309
  note?: string | undefined;
729
1310
  };
730
1311
  examples?: string[] | undefined;
1312
+ lifecycle?: {
1313
+ status: "stable" | "beta" | "experimental" | "deprecated";
1314
+ sunsetAt?: string | undefined;
1315
+ successor?: string | undefined;
1316
+ note?: string | undefined;
1317
+ deprecatedAt?: string | undefined;
1318
+ } | undefined;
1319
+ tags?: string[] | undefined;
1320
+ errors?: {
1321
+ code: string;
1322
+ description: string;
1323
+ httpStatus?: number | undefined;
1324
+ retryable?: boolean | undefined;
1325
+ }[] | undefined;
1326
+ matchHint?: {
1327
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
1328
+ } | undefined;
731
1329
  }>, "many">;
1330
+ tagRegistry: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1331
+ description: z.ZodString;
1332
+ }, "strip", z.ZodTypeAny, {
1333
+ description: string;
1334
+ }, {
1335
+ description: string;
1336
+ }>>>;
1337
+ servers: z.ZodOptional<z.ZodArray<z.ZodObject<{
1338
+ url: z.ZodString;
1339
+ description: z.ZodOptional<z.ZodString>;
1340
+ environment: z.ZodOptional<z.ZodString>;
1341
+ }, "strip", z.ZodTypeAny, {
1342
+ url: string;
1343
+ description?: string | undefined;
1344
+ environment?: string | undefined;
1345
+ }, {
1346
+ url: string;
1347
+ description?: string | undefined;
1348
+ environment?: string | undefined;
1349
+ }>, "many">>;
1350
+ info: z.ZodOptional<z.ZodObject<{
1351
+ title: z.ZodOptional<z.ZodString>;
1352
+ description: z.ZodOptional<z.ZodString>;
1353
+ version: z.ZodOptional<z.ZodString>;
1354
+ homepage: z.ZodOptional<z.ZodString>;
1355
+ contact: z.ZodOptional<z.ZodObject<{
1356
+ name: z.ZodOptional<z.ZodString>;
1357
+ email: z.ZodOptional<z.ZodString>;
1358
+ url: z.ZodOptional<z.ZodString>;
1359
+ }, "strip", z.ZodTypeAny, {
1360
+ name?: string | undefined;
1361
+ email?: string | undefined;
1362
+ url?: string | undefined;
1363
+ }, {
1364
+ name?: string | undefined;
1365
+ email?: string | undefined;
1366
+ url?: string | undefined;
1367
+ }>>;
1368
+ license: z.ZodOptional<z.ZodObject<{
1369
+ name: z.ZodString;
1370
+ url: z.ZodOptional<z.ZodString>;
1371
+ }, "strip", z.ZodTypeAny, {
1372
+ name: string;
1373
+ url?: string | undefined;
1374
+ }, {
1375
+ name: string;
1376
+ url?: string | undefined;
1377
+ }>>;
1378
+ }, "strip", z.ZodTypeAny, {
1379
+ description?: string | undefined;
1380
+ version?: string | undefined;
1381
+ title?: string | undefined;
1382
+ homepage?: string | undefined;
1383
+ contact?: {
1384
+ name?: string | undefined;
1385
+ email?: string | undefined;
1386
+ url?: string | undefined;
1387
+ } | undefined;
1388
+ license?: {
1389
+ name: string;
1390
+ url?: string | undefined;
1391
+ } | undefined;
1392
+ }, {
1393
+ description?: string | undefined;
1394
+ version?: string | undefined;
1395
+ title?: string | undefined;
1396
+ homepage?: string | undefined;
1397
+ contact?: {
1398
+ name?: string | undefined;
1399
+ email?: string | undefined;
1400
+ url?: string | undefined;
1401
+ } | undefined;
1402
+ license?: {
1403
+ name: string;
1404
+ url?: string | undefined;
1405
+ } | undefined;
1406
+ }>>;
732
1407
  }, "strip", z.ZodTypeAny, {
733
1408
  version: string;
734
1409
  app: string;
735
1410
  capabilities: {
736
1411
  name: string;
737
1412
  id: string;
1413
+ description: string;
738
1414
  params: {
739
1415
  name: string;
740
- required: boolean;
741
1416
  description: string;
1417
+ required: boolean;
742
1418
  source: "user_query" | "session";
743
- default?: string | number | boolean | undefined;
1419
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
1420
+ enum?: string[] | undefined;
1421
+ pattern?: string | undefined;
1422
+ example?: string | undefined;
744
1423
  }[];
745
- description: string;
746
1424
  returns: string[];
747
1425
  resolver: {
748
1426
  type: "api";
749
1427
  endpoints: {
750
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1428
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
751
1429
  path: string;
1430
+ idempotent?: boolean | undefined;
1431
+ idempotencyKey?: string | undefined;
752
1432
  params?: string[] | undefined;
753
1433
  }[];
754
1434
  } | {
@@ -759,8 +1439,10 @@ export declare const ManifestSchema: z.ZodObject<{
759
1439
  type: "hybrid";
760
1440
  api: {
761
1441
  endpoints: {
762
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1442
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
763
1443
  path: string;
1444
+ idempotent?: boolean | undefined;
1445
+ idempotencyKey?: string | undefined;
764
1446
  params?: string[] | undefined;
765
1447
  }[];
766
1448
  };
@@ -774,28 +1456,74 @@ export declare const ManifestSchema: z.ZodObject<{
774
1456
  note?: string | undefined;
775
1457
  };
776
1458
  examples?: string[] | undefined;
1459
+ lifecycle?: {
1460
+ status: "stable" | "beta" | "experimental" | "deprecated";
1461
+ sunsetAt?: string | undefined;
1462
+ successor?: string | undefined;
1463
+ note?: string | undefined;
1464
+ deprecatedAt?: string | undefined;
1465
+ } | undefined;
1466
+ tags?: string[] | undefined;
1467
+ errors?: {
1468
+ code: string;
1469
+ description: string;
1470
+ httpStatus?: number | undefined;
1471
+ retryable?: boolean | undefined;
1472
+ }[] | undefined;
1473
+ matchHint?: {
1474
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
1475
+ } | undefined;
777
1476
  }[];
1477
+ schemaVersion: string;
778
1478
  generatedAt: string;
1479
+ info?: {
1480
+ description?: string | undefined;
1481
+ version?: string | undefined;
1482
+ title?: string | undefined;
1483
+ homepage?: string | undefined;
1484
+ contact?: {
1485
+ name?: string | undefined;
1486
+ email?: string | undefined;
1487
+ url?: string | undefined;
1488
+ } | undefined;
1489
+ license?: {
1490
+ name: string;
1491
+ url?: string | undefined;
1492
+ } | undefined;
1493
+ } | undefined;
1494
+ servers?: {
1495
+ url: string;
1496
+ description?: string | undefined;
1497
+ environment?: string | undefined;
1498
+ }[] | undefined;
1499
+ tagRegistry?: Record<string, {
1500
+ description: string;
1501
+ }> | undefined;
779
1502
  }, {
780
1503
  version: string;
781
1504
  app: string;
782
1505
  capabilities: {
783
1506
  name: string;
784
1507
  id: string;
1508
+ description: string;
785
1509
  params: {
786
1510
  name: string;
787
- required: boolean;
788
1511
  description: string;
1512
+ required: boolean;
789
1513
  source: "user_query" | "session";
790
- default?: string | number | boolean | undefined;
1514
+ type?: "string" | "number" | "boolean" | "object" | "date" | "email" | "url" | "enum" | undefined;
1515
+ enum?: string[] | undefined;
1516
+ pattern?: string | undefined;
1517
+ example?: string | undefined;
791
1518
  }[];
792
- description: string;
793
1519
  returns: string[];
794
1520
  resolver: {
795
1521
  type: "api";
796
1522
  endpoints: {
797
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1523
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
798
1524
  path: string;
1525
+ idempotent?: boolean | undefined;
1526
+ idempotencyKey?: string | undefined;
799
1527
  params?: string[] | undefined;
800
1528
  }[];
801
1529
  } | {
@@ -806,8 +1534,10 @@ export declare const ManifestSchema: z.ZodObject<{
806
1534
  type: "hybrid";
807
1535
  api: {
808
1536
  endpoints: {
809
- method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
1537
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
810
1538
  path: string;
1539
+ idempotent?: boolean | undefined;
1540
+ idempotencyKey?: string | undefined;
811
1541
  params?: string[] | undefined;
812
1542
  }[];
813
1543
  };
@@ -821,8 +1551,49 @@ export declare const ManifestSchema: z.ZodObject<{
821
1551
  note?: string | undefined;
822
1552
  };
823
1553
  examples?: string[] | undefined;
1554
+ lifecycle?: {
1555
+ status: "stable" | "beta" | "experimental" | "deprecated";
1556
+ sunsetAt?: string | undefined;
1557
+ successor?: string | undefined;
1558
+ note?: string | undefined;
1559
+ deprecatedAt?: string | undefined;
1560
+ } | undefined;
1561
+ tags?: string[] | undefined;
1562
+ errors?: {
1563
+ code: string;
1564
+ description: string;
1565
+ httpStatus?: number | undefined;
1566
+ retryable?: boolean | undefined;
1567
+ }[] | undefined;
1568
+ matchHint?: {
1569
+ preferredMode?: "cheap" | "balanced" | "accurate" | undefined;
1570
+ } | undefined;
824
1571
  }[];
1572
+ schemaVersion: string;
825
1573
  generatedAt: string;
1574
+ info?: {
1575
+ description?: string | undefined;
1576
+ version?: string | undefined;
1577
+ title?: string | undefined;
1578
+ homepage?: string | undefined;
1579
+ contact?: {
1580
+ name?: string | undefined;
1581
+ email?: string | undefined;
1582
+ url?: string | undefined;
1583
+ } | undefined;
1584
+ license?: {
1585
+ name: string;
1586
+ url?: string | undefined;
1587
+ } | undefined;
1588
+ } | undefined;
1589
+ servers?: {
1590
+ url: string;
1591
+ description?: string | undefined;
1592
+ environment?: string | undefined;
1593
+ }[] | undefined;
1594
+ tagRegistry?: Record<string, {
1595
+ description: string;
1596
+ }> | undefined;
826
1597
  }>;
827
1598
  export type ZodValidationResult = {
828
1599
  valid: boolean;