@native-knowledge/knowledge-sdk 0.0.0-stage → 0.1.0-rc.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 (101) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +46 -2
  3. package/dist/index.js +6577 -0
  4. package/dist/types/contracts/artifact.d.ts +120 -0
  5. package/dist/types/contracts/collection-control.d.ts +160 -0
  6. package/dist/types/contracts/collection.d.ts +263 -0
  7. package/dist/types/contracts/common.d.ts +17 -0
  8. package/dist/types/contracts/currentness.d.ts +477 -0
  9. package/dist/types/contracts/event.d.ts +60 -0
  10. package/dist/types/contracts/evidence.d.ts +202 -0
  11. package/dist/types/contracts/index.d.ts +55 -0
  12. package/dist/types/contracts/material-capability.d.ts +88 -0
  13. package/dist/types/contracts/material-carrier.d.ts +104 -0
  14. package/dist/types/contracts/material-context.d.ts +28 -0
  15. package/dist/types/contracts/material-read.d.ts +152 -0
  16. package/dist/types/contracts/observation.d.ts +75 -0
  17. package/dist/types/contracts/persistence.d.ts +370 -0
  18. package/dist/types/contracts/project-intent.d.ts +218 -0
  19. package/dist/types/contracts/projection.d.ts +380 -0
  20. package/dist/types/contracts/public-reference.d.ts +237 -0
  21. package/dist/types/contracts/reference-record.d.ts +124 -0
  22. package/dist/types/contracts/remote-file.d.ts +128 -0
  23. package/dist/types/contracts/resource-scope.d.ts +40 -0
  24. package/dist/types/contracts/resource-transfer.d.ts +24 -0
  25. package/dist/types/contracts/review-packet.d.ts +274 -0
  26. package/dist/types/contracts/review-plane.d.ts +90 -0
  27. package/dist/types/contracts/rich-document.d.ts +641 -0
  28. package/dist/types/contracts/runtime-compatibility.d.ts +22 -0
  29. package/dist/types/contracts/runtime.d.ts +59 -0
  30. package/dist/types/contracts/scheduler.d.ts +348 -0
  31. package/dist/types/contracts/signal.d.ts +113 -0
  32. package/dist/types/contracts/source-governance.d.ts +375 -0
  33. package/dist/types/contracts/source.d.ts +62 -0
  34. package/dist/types/contracts/tenant-budget.d.ts +59 -0
  35. package/dist/types/contracts/tenant-collection-request.d.ts +209 -0
  36. package/dist/types/contracts/tenant-collection.d.ts +199 -0
  37. package/dist/types/contracts/tenant-currentness.d.ts +117 -0
  38. package/dist/types/contracts/tenant-management.d.ts +286 -0
  39. package/dist/types/contracts/tenant-material-api.d.ts +584 -0
  40. package/dist/types/contracts/tenant-pdf-text.d.ts +27 -0
  41. package/dist/types/contracts/tenant-project-control.d.ts +94 -0
  42. package/dist/types/contracts/tenant-public-reference.d.ts +179 -0
  43. package/dist/types/contracts/tenant-resource-api.d.ts +738 -0
  44. package/dist/types/contracts/tenant-resource.d.ts +298 -0
  45. package/dist/types/contracts/tenant-rich-document.d.ts +317 -0
  46. package/dist/types/contracts/tenant-source-binding.d.ts +44 -0
  47. package/dist/types/contracts/tenant-source-bridge.d.ts +70 -0
  48. package/dist/types/contracts/tenant-source-cutover.d.ts +226 -0
  49. package/dist/types/contracts/tenant-source-document.d.ts +163 -0
  50. package/dist/types/contracts/tenant-source-lease.d.ts +1 -0
  51. package/dist/types/contracts/tenant-source.d.ts +223 -0
  52. package/dist/types/contracts/tenant-web-collection.d.ts +287 -0
  53. package/dist/types/contracts/tenant-web-content-plan.d.ts +86 -0
  54. package/dist/types/contracts/tenant-web-content-result.d.ts +63 -0
  55. package/dist/types/contracts/tenant-web-content.d.ts +383 -0
  56. package/dist/types/contracts/tenant-web-crawl.d.ts +310 -0
  57. package/dist/types/contracts/tenant-web-dynamic.d.ts +698 -0
  58. package/dist/types/contracts/tenant-web-results.d.ts +66 -0
  59. package/dist/types/contracts/tenant-web-workflow.d.ts +494 -0
  60. package/dist/types/sdk/agent-entry.d.ts +291 -0
  61. package/dist/types/sdk/agent-guidance-error.d.ts +15 -0
  62. package/dist/types/sdk/index.d.ts +289 -0
  63. package/dist/types/sdk/material-stream.d.ts +18 -0
  64. package/dist/types/sdk/oauth.d.ts +268 -0
  65. package/dist/types/sdk/resource-integrity.d.ts +21 -0
  66. package/dist/types/sdk/resource.d.ts +88 -0
  67. package/dist/types/sdk/tenant-management.d.ts +240 -0
  68. package/dist/types/sdk/tenant-project.d.ts +57 -0
  69. package/dist/types/sdk/tenant-runtime.d.ts +174 -0
  70. package/dist/types/sdk/tenant-web-content.d.ts +44 -0
  71. package/dist/types/sdk/tenant-web-crawl.d.ts +42 -0
  72. package/dist/types/sdk/tenant-web-dynamic.d.ts +42 -0
  73. package/dist/types/sdk/tenant-web-workflow.d.ts +43 -0
  74. package/dist/types/sdk/tenant-web.d.ts +42 -0
  75. package/dist/types/sdk/tenant-workspace.d.ts +36 -0
  76. package/dist/types/sdk/transport.d.ts +16 -0
  77. package/dist/types/serving-contracts/agent-catalog.d.ts +70 -0
  78. package/dist/types/serving-contracts/agent-entry.d.ts +13148 -0
  79. package/dist/types/serving-contracts/agent-guidance-shapes.d.ts +263 -0
  80. package/dist/types/serving-contracts/agent-input-hints.d.ts +24 -0
  81. package/dist/types/serving-contracts/body-search.d.ts +231 -0
  82. package/dist/types/serving-contracts/consumer.d.ts +989 -0
  83. package/dist/types/serving-contracts/core.d.ts +333 -0
  84. package/dist/types/serving-contracts/http.d.ts +2874 -0
  85. package/dist/types/serving-contracts/index.d.ts +23 -0
  86. package/dist/types/serving-contracts/management.d.ts +424 -0
  87. package/dist/types/serving-contracts/material-capabilities.d.ts +508 -0
  88. package/dist/types/serving-contracts/material-index-status.d.ts +55 -0
  89. package/dist/types/serving-contracts/mcp.d.ts +2218 -0
  90. package/dist/types/serving-contracts/tenant-governance.d.ts +236 -0
  91. package/dist/types/serving-contracts/tenant-management.d.ts +6276 -0
  92. package/dist/types/serving-contracts/tenant-project.d.ts +7550 -0
  93. package/dist/types/serving-contracts/tenant-runtime.d.ts +9674 -0
  94. package/dist/types/serving-contracts/tenant-web-content.d.ts +4606 -0
  95. package/dist/types/serving-contracts/tenant-web-crawl.d.ts +2958 -0
  96. package/dist/types/serving-contracts/tenant-web-dynamic.d.ts +3902 -0
  97. package/dist/types/serving-contracts/tenant-web-workflow.d.ts +5750 -0
  98. package/dist/types/serving-contracts/tenant-web.d.ts +6418 -0
  99. package/dist/types/serving-contracts/tenant-workspace.d.ts +6451 -0
  100. package/dist/types/serving-contracts/workflow.d.ts +439 -0
  101. package/package.json +34 -4
@@ -0,0 +1,698 @@
1
+ import { z } from 'zod';
2
+ export declare const TENANT_WEB_DYNAMIC_CAPABILITY = "TENANT_WEB_DYNAMIC_V1";
3
+ export declare const tenantWebRenderSchema: z.ZodObject<{
4
+ mode: z.ZodDefault<z.ZodEnum<{
5
+ HTTP_ONLY: "HTTP_ONLY";
6
+ AUTO: "AUTO";
7
+ ALWAYS: "ALWAYS";
8
+ }>>;
9
+ requiredSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
10
+ minTextChars: z.ZodDefault<z.ZodNumber>;
11
+ resourceOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
12
+ interaction: z.ZodDefault<z.ZodObject<{
13
+ kind: z.ZodEnum<{
14
+ NONE: "NONE";
15
+ NEXT_PAGE: "NEXT_PAGE";
16
+ LOAD_MORE: "LOAD_MORE";
17
+ SCROLL: "SCROLL";
18
+ }>;
19
+ selector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
20
+ endSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
21
+ maxSteps: z.ZodDefault<z.ZodNumber>;
22
+ }, z.core.$strict>>;
23
+ }, z.core.$strict>;
24
+ export declare const tenantWebDynamicSpecSchema: z.ZodObject<{
25
+ schemaVersion: z.ZodLiteral<2>;
26
+ render: z.ZodDefault<z.ZodObject<{
27
+ mode: z.ZodDefault<z.ZodEnum<{
28
+ HTTP_ONLY: "HTTP_ONLY";
29
+ AUTO: "AUTO";
30
+ ALWAYS: "ALWAYS";
31
+ }>>;
32
+ requiredSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
33
+ minTextChars: z.ZodDefault<z.ZodNumber>;
34
+ resourceOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
35
+ interaction: z.ZodDefault<z.ZodObject<{
36
+ kind: z.ZodEnum<{
37
+ NONE: "NONE";
38
+ NEXT_PAGE: "NEXT_PAGE";
39
+ LOAD_MORE: "LOAD_MORE";
40
+ SCROLL: "SCROLL";
41
+ }>;
42
+ selector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
43
+ endSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
44
+ maxSteps: z.ZodDefault<z.ZodNumber>;
45
+ }, z.core.$strict>>;
46
+ }, z.core.$strict>>;
47
+ url: z.ZodString;
48
+ scope: z.ZodObject<{
49
+ mode: z.ZodEnum<{
50
+ FEED: "FEED";
51
+ SINGLE_PAGE: "SINGLE_PAGE";
52
+ URL_LIST: "URL_LIST";
53
+ SITE_SECTION: "SITE_SECTION";
54
+ SITEMAP: "SITEMAP";
55
+ }>;
56
+ allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
57
+ includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
58
+ excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
59
+ urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
60
+ followPagination: z.ZodDefault<z.ZodBoolean>;
61
+ followDetailLinks: z.ZodDefault<z.ZodBoolean>;
62
+ }, z.core.$strict>;
63
+ requirements: z.ZodObject<{
64
+ instruction: z.ZodString;
65
+ fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
66
+ name: z.ZodString;
67
+ type: z.ZodEnum<{
68
+ string: "string";
69
+ number: "number";
70
+ boolean: "boolean";
71
+ object: "object";
72
+ array: "array";
73
+ }>;
74
+ required: z.ZodDefault<z.ZodBoolean>;
75
+ }, z.core.$strict>>>;
76
+ outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
77
+ RAW: "RAW";
78
+ DOCUMENT: "DOCUMENT";
79
+ RECORDS: "RECORDS";
80
+ }>>>;
81
+ attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
82
+ PDF: "PDF";
83
+ IMAGE: "IMAGE";
84
+ AUDIO: "AUDIO";
85
+ VIDEO: "VIDEO";
86
+ OTHER: "OTHER";
87
+ }>>>;
88
+ }, z.core.$strict>;
89
+ limits: z.ZodDefault<z.ZodObject<{
90
+ maxPages: z.ZodDefault<z.ZodNumber>;
91
+ maxDepth: z.ZodDefault<z.ZodNumber>;
92
+ maxResourceBytes: z.ZodDefault<z.ZodNumber>;
93
+ maxTotalBytes: z.ZodDefault<z.ZodNumber>;
94
+ maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
95
+ maxInteractions: z.ZodDefault<z.ZodNumber>;
96
+ maxFiles: z.ZodDefault<z.ZodNumber>;
97
+ }, z.core.$strict>>;
98
+ refresh: z.ZodDefault<z.ZodObject<{
99
+ mode: z.ZodLiteral<"ONCE">;
100
+ }, z.core.$strict>>;
101
+ }, z.core.$strict>;
102
+ export type TenantWebDynamicSpec = z.infer<typeof tenantWebDynamicSpecSchema>;
103
+ export declare const tenantWebDynamicSpecRevision: (v: TenantWebDynamicSpec) => string;
104
+ export declare const tenantWebDynamicIntentSchema: z.ZodObject<{
105
+ schemaVersion: z.ZodLiteral<2>;
106
+ requestedSpec: z.ZodObject<{
107
+ schemaVersion: z.ZodLiteral<2>;
108
+ render: z.ZodDefault<z.ZodObject<{
109
+ mode: z.ZodDefault<z.ZodEnum<{
110
+ HTTP_ONLY: "HTTP_ONLY";
111
+ AUTO: "AUTO";
112
+ ALWAYS: "ALWAYS";
113
+ }>>;
114
+ requiredSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
115
+ minTextChars: z.ZodDefault<z.ZodNumber>;
116
+ resourceOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
117
+ interaction: z.ZodDefault<z.ZodObject<{
118
+ kind: z.ZodEnum<{
119
+ NONE: "NONE";
120
+ NEXT_PAGE: "NEXT_PAGE";
121
+ LOAD_MORE: "LOAD_MORE";
122
+ SCROLL: "SCROLL";
123
+ }>;
124
+ selector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
125
+ endSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
126
+ maxSteps: z.ZodDefault<z.ZodNumber>;
127
+ }, z.core.$strict>>;
128
+ }, z.core.$strict>>;
129
+ url: z.ZodString;
130
+ scope: z.ZodObject<{
131
+ mode: z.ZodEnum<{
132
+ FEED: "FEED";
133
+ SINGLE_PAGE: "SINGLE_PAGE";
134
+ URL_LIST: "URL_LIST";
135
+ SITE_SECTION: "SITE_SECTION";
136
+ SITEMAP: "SITEMAP";
137
+ }>;
138
+ allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
139
+ includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
140
+ excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
141
+ urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
142
+ followPagination: z.ZodDefault<z.ZodBoolean>;
143
+ followDetailLinks: z.ZodDefault<z.ZodBoolean>;
144
+ }, z.core.$strict>;
145
+ requirements: z.ZodObject<{
146
+ instruction: z.ZodString;
147
+ fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
148
+ name: z.ZodString;
149
+ type: z.ZodEnum<{
150
+ string: "string";
151
+ number: "number";
152
+ boolean: "boolean";
153
+ object: "object";
154
+ array: "array";
155
+ }>;
156
+ required: z.ZodDefault<z.ZodBoolean>;
157
+ }, z.core.$strict>>>;
158
+ outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
159
+ RAW: "RAW";
160
+ DOCUMENT: "DOCUMENT";
161
+ RECORDS: "RECORDS";
162
+ }>>>;
163
+ attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
164
+ PDF: "PDF";
165
+ IMAGE: "IMAGE";
166
+ AUDIO: "AUDIO";
167
+ VIDEO: "VIDEO";
168
+ OTHER: "OTHER";
169
+ }>>>;
170
+ }, z.core.$strict>;
171
+ limits: z.ZodDefault<z.ZodObject<{
172
+ maxPages: z.ZodDefault<z.ZodNumber>;
173
+ maxDepth: z.ZodDefault<z.ZodNumber>;
174
+ maxResourceBytes: z.ZodDefault<z.ZodNumber>;
175
+ maxTotalBytes: z.ZodDefault<z.ZodNumber>;
176
+ maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
177
+ maxInteractions: z.ZodDefault<z.ZodNumber>;
178
+ maxFiles: z.ZodDefault<z.ZodNumber>;
179
+ }, z.core.$strict>>;
180
+ refresh: z.ZodDefault<z.ZodObject<{
181
+ mode: z.ZodLiteral<"ONCE">;
182
+ }, z.core.$strict>>;
183
+ }, z.core.$strict>;
184
+ spec: z.ZodObject<{
185
+ schemaVersion: z.ZodLiteral<2>;
186
+ render: z.ZodDefault<z.ZodObject<{
187
+ mode: z.ZodDefault<z.ZodEnum<{
188
+ HTTP_ONLY: "HTTP_ONLY";
189
+ AUTO: "AUTO";
190
+ ALWAYS: "ALWAYS";
191
+ }>>;
192
+ requiredSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
193
+ minTextChars: z.ZodDefault<z.ZodNumber>;
194
+ resourceOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
195
+ interaction: z.ZodDefault<z.ZodObject<{
196
+ kind: z.ZodEnum<{
197
+ NONE: "NONE";
198
+ NEXT_PAGE: "NEXT_PAGE";
199
+ LOAD_MORE: "LOAD_MORE";
200
+ SCROLL: "SCROLL";
201
+ }>;
202
+ selector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
203
+ endSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
204
+ maxSteps: z.ZodDefault<z.ZodNumber>;
205
+ }, z.core.$strict>>;
206
+ }, z.core.$strict>>;
207
+ url: z.ZodString;
208
+ scope: z.ZodObject<{
209
+ mode: z.ZodEnum<{
210
+ FEED: "FEED";
211
+ SINGLE_PAGE: "SINGLE_PAGE";
212
+ URL_LIST: "URL_LIST";
213
+ SITE_SECTION: "SITE_SECTION";
214
+ SITEMAP: "SITEMAP";
215
+ }>;
216
+ allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
217
+ includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
218
+ excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
219
+ urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
220
+ followPagination: z.ZodDefault<z.ZodBoolean>;
221
+ followDetailLinks: z.ZodDefault<z.ZodBoolean>;
222
+ }, z.core.$strict>;
223
+ requirements: z.ZodObject<{
224
+ instruction: z.ZodString;
225
+ fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
226
+ name: z.ZodString;
227
+ type: z.ZodEnum<{
228
+ string: "string";
229
+ number: "number";
230
+ boolean: "boolean";
231
+ object: "object";
232
+ array: "array";
233
+ }>;
234
+ required: z.ZodDefault<z.ZodBoolean>;
235
+ }, z.core.$strict>>>;
236
+ outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
237
+ RAW: "RAW";
238
+ DOCUMENT: "DOCUMENT";
239
+ RECORDS: "RECORDS";
240
+ }>>>;
241
+ attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
242
+ PDF: "PDF";
243
+ IMAGE: "IMAGE";
244
+ AUDIO: "AUDIO";
245
+ VIDEO: "VIDEO";
246
+ OTHER: "OTHER";
247
+ }>>>;
248
+ }, z.core.$strict>;
249
+ limits: z.ZodDefault<z.ZodObject<{
250
+ maxPages: z.ZodDefault<z.ZodNumber>;
251
+ maxDepth: z.ZodDefault<z.ZodNumber>;
252
+ maxResourceBytes: z.ZodDefault<z.ZodNumber>;
253
+ maxTotalBytes: z.ZodDefault<z.ZodNumber>;
254
+ maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
255
+ maxInteractions: z.ZodDefault<z.ZodNumber>;
256
+ maxFiles: z.ZodDefault<z.ZodNumber>;
257
+ }, z.core.$strict>>;
258
+ refresh: z.ZodDefault<z.ZodObject<{
259
+ mode: z.ZodLiteral<"ONCE">;
260
+ }, z.core.$strict>>;
261
+ }, z.core.$strict>;
262
+ tenantId: z.ZodString;
263
+ requestId: z.ZodString;
264
+ jobRef: z.ZodString;
265
+ inputRevision: z.ZodString;
266
+ specRevision: z.ZodString;
267
+ actor: z.ZodObject<{
268
+ tenantId: z.ZodString;
269
+ userId: z.ZodString;
270
+ agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
271
+ }, z.core.$strict>;
272
+ authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
273
+ type: z.ZodLiteral<"HOST">;
274
+ }, z.core.$strict>, z.ZodObject<{
275
+ type: z.ZodLiteral<"OAUTH">;
276
+ authorityVersion: z.ZodLiteral<2>;
277
+ clientId: z.ZodString;
278
+ grantId: z.ZodString;
279
+ resource: z.ZodString;
280
+ }, z.core.$strict>], "type">;
281
+ submittedAt: z.ZodISODateTime;
282
+ }, z.core.$strict>;
283
+ export declare const tenantWebDynamicJobSchema: z.ZodObject<{
284
+ schemaVersion: z.ZodLiteral<3>;
285
+ intent: z.ZodObject<{
286
+ schemaVersion: z.ZodLiteral<2>;
287
+ requestedSpec: z.ZodObject<{
288
+ schemaVersion: z.ZodLiteral<2>;
289
+ render: z.ZodDefault<z.ZodObject<{
290
+ mode: z.ZodDefault<z.ZodEnum<{
291
+ HTTP_ONLY: "HTTP_ONLY";
292
+ AUTO: "AUTO";
293
+ ALWAYS: "ALWAYS";
294
+ }>>;
295
+ requiredSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
296
+ minTextChars: z.ZodDefault<z.ZodNumber>;
297
+ resourceOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
298
+ interaction: z.ZodDefault<z.ZodObject<{
299
+ kind: z.ZodEnum<{
300
+ NONE: "NONE";
301
+ NEXT_PAGE: "NEXT_PAGE";
302
+ LOAD_MORE: "LOAD_MORE";
303
+ SCROLL: "SCROLL";
304
+ }>;
305
+ selector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
306
+ endSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
307
+ maxSteps: z.ZodDefault<z.ZodNumber>;
308
+ }, z.core.$strict>>;
309
+ }, z.core.$strict>>;
310
+ url: z.ZodString;
311
+ scope: z.ZodObject<{
312
+ mode: z.ZodEnum<{
313
+ FEED: "FEED";
314
+ SINGLE_PAGE: "SINGLE_PAGE";
315
+ URL_LIST: "URL_LIST";
316
+ SITE_SECTION: "SITE_SECTION";
317
+ SITEMAP: "SITEMAP";
318
+ }>;
319
+ allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
320
+ includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
321
+ excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
322
+ urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
323
+ followPagination: z.ZodDefault<z.ZodBoolean>;
324
+ followDetailLinks: z.ZodDefault<z.ZodBoolean>;
325
+ }, z.core.$strict>;
326
+ requirements: z.ZodObject<{
327
+ instruction: z.ZodString;
328
+ fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
329
+ name: z.ZodString;
330
+ type: z.ZodEnum<{
331
+ string: "string";
332
+ number: "number";
333
+ boolean: "boolean";
334
+ object: "object";
335
+ array: "array";
336
+ }>;
337
+ required: z.ZodDefault<z.ZodBoolean>;
338
+ }, z.core.$strict>>>;
339
+ outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
340
+ RAW: "RAW";
341
+ DOCUMENT: "DOCUMENT";
342
+ RECORDS: "RECORDS";
343
+ }>>>;
344
+ attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
345
+ PDF: "PDF";
346
+ IMAGE: "IMAGE";
347
+ AUDIO: "AUDIO";
348
+ VIDEO: "VIDEO";
349
+ OTHER: "OTHER";
350
+ }>>>;
351
+ }, z.core.$strict>;
352
+ limits: z.ZodDefault<z.ZodObject<{
353
+ maxPages: z.ZodDefault<z.ZodNumber>;
354
+ maxDepth: z.ZodDefault<z.ZodNumber>;
355
+ maxResourceBytes: z.ZodDefault<z.ZodNumber>;
356
+ maxTotalBytes: z.ZodDefault<z.ZodNumber>;
357
+ maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
358
+ maxInteractions: z.ZodDefault<z.ZodNumber>;
359
+ maxFiles: z.ZodDefault<z.ZodNumber>;
360
+ }, z.core.$strict>>;
361
+ refresh: z.ZodDefault<z.ZodObject<{
362
+ mode: z.ZodLiteral<"ONCE">;
363
+ }, z.core.$strict>>;
364
+ }, z.core.$strict>;
365
+ spec: z.ZodObject<{
366
+ schemaVersion: z.ZodLiteral<2>;
367
+ render: z.ZodDefault<z.ZodObject<{
368
+ mode: z.ZodDefault<z.ZodEnum<{
369
+ HTTP_ONLY: "HTTP_ONLY";
370
+ AUTO: "AUTO";
371
+ ALWAYS: "ALWAYS";
372
+ }>>;
373
+ requiredSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
374
+ minTextChars: z.ZodDefault<z.ZodNumber>;
375
+ resourceOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
376
+ interaction: z.ZodDefault<z.ZodObject<{
377
+ kind: z.ZodEnum<{
378
+ NONE: "NONE";
379
+ NEXT_PAGE: "NEXT_PAGE";
380
+ LOAD_MORE: "LOAD_MORE";
381
+ SCROLL: "SCROLL";
382
+ }>;
383
+ selector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
384
+ endSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
385
+ maxSteps: z.ZodDefault<z.ZodNumber>;
386
+ }, z.core.$strict>>;
387
+ }, z.core.$strict>>;
388
+ url: z.ZodString;
389
+ scope: z.ZodObject<{
390
+ mode: z.ZodEnum<{
391
+ FEED: "FEED";
392
+ SINGLE_PAGE: "SINGLE_PAGE";
393
+ URL_LIST: "URL_LIST";
394
+ SITE_SECTION: "SITE_SECTION";
395
+ SITEMAP: "SITEMAP";
396
+ }>;
397
+ allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
398
+ includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
399
+ excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
400
+ urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
401
+ followPagination: z.ZodDefault<z.ZodBoolean>;
402
+ followDetailLinks: z.ZodDefault<z.ZodBoolean>;
403
+ }, z.core.$strict>;
404
+ requirements: z.ZodObject<{
405
+ instruction: z.ZodString;
406
+ fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
407
+ name: z.ZodString;
408
+ type: z.ZodEnum<{
409
+ string: "string";
410
+ number: "number";
411
+ boolean: "boolean";
412
+ object: "object";
413
+ array: "array";
414
+ }>;
415
+ required: z.ZodDefault<z.ZodBoolean>;
416
+ }, z.core.$strict>>>;
417
+ outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
418
+ RAW: "RAW";
419
+ DOCUMENT: "DOCUMENT";
420
+ RECORDS: "RECORDS";
421
+ }>>>;
422
+ attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
423
+ PDF: "PDF";
424
+ IMAGE: "IMAGE";
425
+ AUDIO: "AUDIO";
426
+ VIDEO: "VIDEO";
427
+ OTHER: "OTHER";
428
+ }>>>;
429
+ }, z.core.$strict>;
430
+ limits: z.ZodDefault<z.ZodObject<{
431
+ maxPages: z.ZodDefault<z.ZodNumber>;
432
+ maxDepth: z.ZodDefault<z.ZodNumber>;
433
+ maxResourceBytes: z.ZodDefault<z.ZodNumber>;
434
+ maxTotalBytes: z.ZodDefault<z.ZodNumber>;
435
+ maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
436
+ maxInteractions: z.ZodDefault<z.ZodNumber>;
437
+ maxFiles: z.ZodDefault<z.ZodNumber>;
438
+ }, z.core.$strict>>;
439
+ refresh: z.ZodDefault<z.ZodObject<{
440
+ mode: z.ZodLiteral<"ONCE">;
441
+ }, z.core.$strict>>;
442
+ }, z.core.$strict>;
443
+ tenantId: z.ZodString;
444
+ requestId: z.ZodString;
445
+ jobRef: z.ZodString;
446
+ inputRevision: z.ZodString;
447
+ specRevision: z.ZodString;
448
+ actor: z.ZodObject<{
449
+ tenantId: z.ZodString;
450
+ userId: z.ZodString;
451
+ agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
452
+ }, z.core.$strict>;
453
+ authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
454
+ type: z.ZodLiteral<"HOST">;
455
+ }, z.core.$strict>, z.ZodObject<{
456
+ type: z.ZodLiteral<"OAUTH">;
457
+ authorityVersion: z.ZodLiteral<2>;
458
+ clientId: z.ZodString;
459
+ grantId: z.ZodString;
460
+ resource: z.ZodString;
461
+ }, z.core.$strict>], "type">;
462
+ submittedAt: z.ZodISODateTime;
463
+ }, z.core.$strict>;
464
+ policy: z.ZodObject<{
465
+ ref: z.ZodString;
466
+ revision: z.ZodString;
467
+ acquisition: z.ZodEnum<{
468
+ ALLOW: "ALLOW";
469
+ DENY: "DENY";
470
+ }>;
471
+ propagation: z.ZodEnum<{
472
+ TENANT_ONLY: "TENANT_ONLY";
473
+ SHARE_ALLOWED: "SHARE_ALLOWED";
474
+ PUBLIC_ALLOWED: "PUBLIC_ALLOWED";
475
+ }>;
476
+ }, z.core.$strict>;
477
+ }, z.core.$strict>;
478
+ export type TenantWebDynamicJob = z.infer<typeof tenantWebDynamicJobSchema>;
479
+ export declare const tenantWebDynamicTargetSchema: z.ZodObject<{
480
+ ordinal: z.ZodNumber;
481
+ role: z.ZodEnum<{
482
+ FEED: "FEED";
483
+ SITEMAP: "SITEMAP";
484
+ PAGE: "PAGE";
485
+ ATTACHMENT: "ATTACHMENT";
486
+ }>;
487
+ attachment: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
488
+ PDF: "PDF";
489
+ IMAGE: "IMAGE";
490
+ AUDIO: "AUDIO";
491
+ VIDEO: "VIDEO";
492
+ OTHER: "OTHER";
493
+ }>>>;
494
+ url: z.ZodString;
495
+ parent: z.ZodNullable<z.ZodString>;
496
+ depth: z.ZodNumber;
497
+ }, z.core.$strict>;
498
+ export type TenantWebDynamicTarget = z.infer<typeof tenantWebDynamicTargetSchema>;
499
+ export declare const tenantWebDynamicOutcomeSchema: z.ZodObject<{
500
+ ordinal: z.ZodNumber;
501
+ batchId: z.ZodNullable<z.ZodString>;
502
+ capture: z.ZodNullable<z.ZodObject<{
503
+ schemaVersion: z.ZodLiteral<1>;
504
+ tenantId: z.ZodString;
505
+ batchRef: z.ZodString;
506
+ sourceRevisionRef: z.ZodString;
507
+ taskId: z.ZodString;
508
+ evidenceRef: z.ZodString;
509
+ contentHash: z.ZodString;
510
+ byteLength: z.ZodNumber;
511
+ mediaType: z.ZodString;
512
+ observedAt: z.ZodISODateTime;
513
+ finalLocator: z.ZodString;
514
+ httpStatus: z.ZodNullable<z.ZodNumber>;
515
+ acquisitionRevision: z.ZodNullable<z.ZodString>;
516
+ headersRecorded: z.ZodBoolean;
517
+ }, z.core.$strict>>;
518
+ registered: z.ZodBoolean;
519
+ errorCode: z.ZodNullable<z.ZodString>;
520
+ reused: z.ZodBoolean;
521
+ }, z.core.$strict>;
522
+ export type TenantWebDynamicOutcome = z.infer<typeof tenantWebDynamicOutcomeSchema>;
523
+ export declare const tenantWebDynamicHeadSchema: z.ZodObject<{
524
+ schemaVersion: z.ZodLiteral<2>;
525
+ queued: z.ZodNumber;
526
+ cursor: z.ZodNumber;
527
+ acquired: z.ZodNumber;
528
+ registered: z.ZodNumber;
529
+ phase: z.ZodDefault<z.ZodEnum<{
530
+ PDF: "PDF";
531
+ RENDER: "RENDER";
532
+ LINKS: "LINKS";
533
+ }>>;
534
+ renderIndex: z.ZodNumber;
535
+ linkState: z.ZodNumber;
536
+ browserPages: z.ZodNumber;
537
+ pagesQueued: z.ZodNumber;
538
+ filesQueued: z.ZodNumber;
539
+ renderedStates: z.ZodNumber;
540
+ pdfExtracted: z.ZodNumber;
541
+ interactions: z.ZodNumber;
542
+ reservation: z.ZodNullable<z.ZodObject<{
543
+ bytes: z.ZodNumber;
544
+ ms: z.ZodNumber;
545
+ interactions: z.ZodNumber;
546
+ }, z.core.$strict>>;
547
+ seq: z.ZodNumber;
548
+ stage: z.ZodEnum<{
549
+ ACQUIRE: "ACQUIRE";
550
+ DISCOVER: "DISCOVER";
551
+ }>;
552
+ after: z.ZodNumber;
553
+ attempts: z.ZodNumber;
554
+ currentAcquired: z.ZodBoolean;
555
+ chargedBytes: z.ZodNumber;
556
+ chargedMs: z.ZodNumber;
557
+ gaps: z.ZodArray<z.ZodString>;
558
+ state: z.ZodEnum<{
559
+ PARTIAL: "PARTIAL";
560
+ COMPLETE: "COMPLETE";
561
+ QUEUED: "QUEUED";
562
+ RUNNING: "RUNNING";
563
+ }>;
564
+ finishedAt: z.ZodNullable<z.ZodISODateTime>;
565
+ notBefore: z.ZodNullable<z.ZodISODateTime>;
566
+ }, z.core.$strict>;
567
+ export type TenantWebDynamicHead = z.infer<typeof tenantWebDynamicHeadSchema>;
568
+ export declare const tenantWebDynamicChildOwnerSchema: z.ZodObject<{
569
+ schemaVersion: z.ZodLiteral<2>;
570
+ ordinal: z.ZodNumber;
571
+ jobRef: z.ZodString;
572
+ requestId: z.ZodString;
573
+ batchId: z.ZodString;
574
+ }, z.core.$strict>;
575
+ export declare const tenantWebDynamicStatusSchema: z.ZodObject<{
576
+ phase: z.ZodLiteral<"DYNAMIC_ACQUISITION">;
577
+ ocr: z.ZodObject<{
578
+ capability: z.ZodLiteral<"UNAVAILABLE">;
579
+ budgetState: z.ZodLiteral<"NOT_CONFIGURED">;
580
+ processedPages: z.ZodLiteral<0>;
581
+ }, z.core.$strict>;
582
+ dynamic: z.ZodObject<{
583
+ browserPages: z.ZodNumber;
584
+ pagesQueued: z.ZodNumber;
585
+ filesQueued: z.ZodNumber;
586
+ renderedStates: z.ZodNumber;
587
+ pdfExtracted: z.ZodNumber;
588
+ interactions: z.ZodNumber;
589
+ }, z.core.$strict>;
590
+ requestId: z.ZodString;
591
+ jobRef: z.ZodString;
592
+ specRevision: z.ZodString;
593
+ state: z.ZodEnum<{
594
+ PARTIAL: "PARTIAL";
595
+ COMPLETE: "COMPLETE";
596
+ QUEUED: "QUEUED";
597
+ RUNNING: "RUNNING";
598
+ }>;
599
+ requirementsState: z.ZodLiteral<"DECLARED_NOT_EVALUATED">;
600
+ indexState: z.ZodLiteral<"NOT_EVALUATED">;
601
+ coverage: z.ZodObject<{
602
+ total: z.ZodNullable<z.ZodNumber>;
603
+ discovered: z.ZodNumber;
604
+ acquired: z.ZodNumber;
605
+ registered: z.ZodNumber;
606
+ pending: z.ZodNumber;
607
+ gaps: z.ZodArray<z.ZodString>;
608
+ }, z.core.$strict>;
609
+ budget: z.ZodObject<{
610
+ chargedBytes: z.ZodNumber;
611
+ chargedMs: z.ZodNumber;
612
+ conservativeReservation: z.ZodBoolean;
613
+ }, z.core.$strict>;
614
+ finishedAt: z.ZodNullable<z.ZodISODateTime>;
615
+ nextEligibleAt: z.ZodNullable<z.ZodISODateTime>;
616
+ }, z.core.$strict>;
617
+ export declare function tenantWebDynamicStatus(job: TenantWebDynamicJob, h: TenantWebDynamicHead): {
618
+ phase: "DYNAMIC_ACQUISITION";
619
+ ocr: {
620
+ capability: "UNAVAILABLE";
621
+ budgetState: "NOT_CONFIGURED";
622
+ processedPages: 0;
623
+ };
624
+ dynamic: {
625
+ browserPages: number;
626
+ pagesQueued: number;
627
+ filesQueued: number;
628
+ renderedStates: number;
629
+ pdfExtracted: number;
630
+ interactions: number;
631
+ };
632
+ requestId: string;
633
+ jobRef: string;
634
+ specRevision: string;
635
+ state: "PARTIAL" | "COMPLETE" | "QUEUED" | "RUNNING";
636
+ requirementsState: "DECLARED_NOT_EVALUATED";
637
+ indexState: "NOT_EVALUATED";
638
+ coverage: {
639
+ total: number | null;
640
+ discovered: number;
641
+ acquired: number;
642
+ registered: number;
643
+ pending: number;
644
+ gaps: string[];
645
+ };
646
+ budget: {
647
+ chargedBytes: number;
648
+ chargedMs: number;
649
+ conservativeReservation: boolean;
650
+ };
651
+ finishedAt: string | null;
652
+ nextEligibleAt: string | null;
653
+ };
654
+ export declare function tenantWebAttachmentInScope(spec: TenantWebDynamicSpec, url: string, robots?: boolean): boolean;
655
+ /** Browser records refer to retained immutable evidence, never inline runtime bodies. */
656
+ export declare const tenantWebBrowserResponseSchema: z.ZodObject<{
657
+ url: z.ZodString;
658
+ finalUrl: z.ZodString;
659
+ status: z.ZodNumber;
660
+ headers: z.ZodRecord<z.ZodString, z.ZodString>;
661
+ ref: z.ZodString;
662
+ hash: z.ZodString;
663
+ observedAt: z.ZodISODateTime;
664
+ }, z.core.$strict>;
665
+ export declare const tenantWebBrowserStateSchema: z.ZodObject<{
666
+ schemaVersion: z.ZodLiteral<1>;
667
+ ordinal: z.ZodNumber;
668
+ index: z.ZodNumber;
669
+ url: z.ZodString;
670
+ domRef: z.ZodString;
671
+ domHash: z.ZodString;
672
+ visibleRef: z.ZodOptional<z.ZodString>;
673
+ visibleHash: z.ZodOptional<z.ZodString>;
674
+ observedAt: z.ZodISODateTime;
675
+ responseCount: z.ZodNumber;
676
+ navigationCount: z.ZodNumber;
677
+ actions: z.ZodNumber;
678
+ done: z.ZodBoolean;
679
+ gap: z.ZodNullable<z.ZodString>;
680
+ interactionRef: z.ZodString;
681
+ }, z.core.$strict>;
682
+ export type TenantWebBrowserState = z.infer<typeof tenantWebBrowserStateSchema>;
683
+ export declare function tenantWebPartIdentity(tenantId: string, parentRef: string, part: string): {
684
+ identityRef: string;
685
+ ref: string;
686
+ resourceId: string;
687
+ version: 1;
688
+ };
689
+ export declare const tenantWebBrowserCapabilitySchema: z.ZodObject<{
690
+ executablePath: z.ZodString;
691
+ navigationTimeoutMs: z.ZodDefault<z.ZodNumber>;
692
+ settleMs: z.ZodDefault<z.ZodNumber>;
693
+ maxRequests: z.ZodDefault<z.ZodNumber>;
694
+ captureVisible: z.ZodOptional<z.ZodBoolean>;
695
+ }, z.core.$strict>;
696
+ export type TenantWebBrowserCapability = z.infer<typeof tenantWebBrowserCapabilitySchema>;
697
+ export type TenantWebBrowserResponse = z.infer<typeof tenantWebBrowserResponseSchema>;
698
+ export type TenantWebDynamicChildOwner = z.infer<typeof tenantWebDynamicChildOwnerSchema>;