@work-shape/catalyst-asset-schemas 0.8.0-rc.1 → 0.8.0-rc.10

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 (3) hide show
  1. package/dist/index.d.ts +2158 -21
  2. package/dist/index.js +1419 -79
  3. package/package.json +2 -2
package/dist/index.d.ts CHANGED
@@ -4,6 +4,8 @@ import { z } from 'zod';
4
4
  * The shape of an agent and of a skill as a file holds it. These are the public half of the
5
5
  * asset model: a working copy, the command line tool and the instance read the same types.
6
6
  */
7
+ /** The configuration rights reported for an asset; publish applies to draft/published kinds. */
8
+ declare const ASSET_ACCESS_VERBS: readonly ["read", "write", "delete", "publish"];
7
9
  declare const localeCodes: readonly ["en", "de"];
8
10
  type LocaleCode = (typeof localeCodes)[number];
9
11
  type LocalizedStringConfig = string | {
@@ -36,13 +38,24 @@ interface AgentConfig {
36
38
  modelReasoningEfforts?: Record<string, ReasoningEffortConfig>;
37
39
  maxSteps?: number;
38
40
  toolNames: string[];
41
+ /**
42
+ * The other agents this agent may start as subagents with `run_agent`, besides itself. Each
43
+ * is started only where the person may use it in the conversation's workspace.
44
+ */
45
+ subagentNames?: string[];
39
46
  skillNames: string[];
40
47
  /**
41
48
  * The Knowledge Bases the agent answers from, by id. However many it lists, the agent has one
42
- * tool over all of them, `knowledge.query`. Missing means none.
49
+ * tool over those of tables, `knowledge.query`, and one over those of documents,
50
+ * `knowledge.search`. Missing means none.
43
51
  */
44
52
  knowledgeBases?: string[];
45
53
  initialPrompts: AgentInitialPromptConfig[];
54
+ /**
55
+ * An agent that ships with the platform: its fields as the release shipped them last. Only
56
+ * the release seed writes it; every other write keeps it as stored.
57
+ */
58
+ shipped?: Record<string, unknown>;
46
59
  }
47
60
  interface SkillConfig {
48
61
  name: string;
@@ -122,6 +135,8 @@ interface SkillResourceConfig {
122
135
  mediaType: SkillResourceMediaType;
123
136
  content: string;
124
137
  }
138
+ /** Ordered from the narrowest App audience to the widest. */
139
+ declare const APP_AUDIENCES: readonly ["self", "workspace", "instance"];
125
140
 
126
141
  /**
127
142
  * The values the HTTP contract of an instance is written with: scopes, actions, error codes
@@ -135,12 +150,12 @@ declare const FIRST_PARTY_AUTH_SCOPES: readonly ["*", "me:read", "me:delete", "c
135
150
  type ChatSessionAuthScope = (typeof CHAT_SESSION_AUTH_SCOPES)[number];
136
151
  type FirstPartyAuthScope = (typeof FIRST_PARTY_AUTH_SCOPES)[number];
137
152
  type OperationScope = Exclude<FirstPartyAuthScope, "*">;
138
- declare const ACTIONS: readonly ["agent.read", "agent.write", "agent.delete", "skill.read", "skill.write", "skill.delete", "skill.approve", "connection.read", "connection.use", "connection.write", "connection.delete", "connection.approve", "app.read", "app.write", "app.publish", "app.approve", "app.delete", "app.use", "workflow.read", "workflow.write", "workflow.publish", "workflow.approve", "workflow.delete", "workflow.use", "workflow.read_run_data", "data_store.read", "data_store.write", "data_store.publish", "data_store.delete", "data_store.insert", "data_store.execute", "knowledge_base.read", "knowledge_base.write", "knowledge_base.publish", "knowledge_base.delete", "knowledge_base.use", "guardrail.read", "guardrail.write", "guardrail.publish", "guardrail.delete", "operations.approve", "users.manage", "usage.view", "audit.view", "api_access.manage", "service_principals.manage", "agent_models.manage", "assets.release"];
153
+ /**
154
+ * Every right of the platform, one file per domain under `contract-values/`. The order is kept:
155
+ * `GRANTABLE_ACTIONS` filters it, and the rights dialog lists rights in it.
156
+ */
157
+ declare const ACTIONS: readonly ["agent.read", "agent.write", "agent.publish", "agent.approve", "agent.delete", "agent.use", "skill.read", "skill.write", "skill.delete", "skill.approve", "connection.read", "connection.use", "connection.write", "connection.delete", "connection.approve", "app.read", "app.write", "app.publish", "app.approve", "app.delete", "app.use", "workflow.read", "workflow.write", "workflow.publish", "workflow.approve", "workflow.delete", "workflow.use", "workflow.read_run_data", "data_store.read", "data_store.write", "data_store.publish", "data_store.delete", "data_store.insert", "data_store.execute", "data_store.records", "knowledge_base.read", "knowledge_base.write", "knowledge_base.ingest", "knowledge_base.publish", "knowledge_base.delete", "knowledge_base.use", "mail_sender.use", "guardrail.read", "guardrail.write", "guardrail.publish", "guardrail.delete", "operations.approve", "feedback.review", "users.manage", "users.delete", "usage.view", "limits.manage", "usage.view_users", "audit.view", "system.view", "jobs.retry", "api_access.manage", "service_principals.manage", "agent_models.manage", "roles.edit_built_in", "assets.release", "builder", "publisher"];
139
158
  type PlatformAction = (typeof ACTIONS)[number];
140
- /** A Namespace prefix: lowercase words joined by single hyphens, ending in one hyphen. */
141
- declare const NAMESPACE_PREFIX_PATTERN: RegExp;
142
- declare const NAMESPACE_PREFIX_MIN_LENGTH = 2;
143
- declare const NAMESPACE_PREFIX_MAX_LENGTH = 32;
144
159
  type AppErrorCode = (typeof APP_ERROR_CODES)[number];
145
160
  /** The HTTP status every error code answers with. */
146
161
  declare const APP_ERROR_STATUS_CODES: Record<AppErrorCode, number>;
@@ -154,11 +169,11 @@ declare const IDEMPOTENCY_KEY_MAX_LENGTH = 255;
154
169
  declare const PROVIDER_PORTS: readonly ["models", "mail", "objectStorage", "sandbox", "secrets"];
155
170
  type ProviderPort = (typeof PROVIDER_PORTS)[number];
156
171
  /**
157
- * Where a provider processes the data an instance sends it. Product-owned and closed: a vendor's
158
- * own region name is a separate field of its adapter, such as `bucketRegion`.
172
+ * Where a provider processes the data an instance sends it. Only `eu` admits personal
173
+ * Connections; other short strings describe routes outside that boundary.
159
174
  */
160
175
  declare const PROVIDER_REGIONS: readonly ["eu", "global"];
161
- type ProviderRegion = (typeof PROVIDER_REGIONS)[number];
176
+ type ProviderRegion = string;
162
177
  /**
163
178
  * Why a check failed. Product-owned and closed: it is all of a failure that reaches a log, the
164
179
  * API or a page, so a provider's own error text, which can repeat a key or an address, cannot.
@@ -167,7 +182,7 @@ declare const PROVIDER_CHECK_ERROR_CLASSES: readonly ["unreachable", "timeout",
167
182
  type ProviderCheckErrorClass = (typeof PROVIDER_CHECK_ERROR_CLASSES)[number];
168
183
  /**
169
184
  * The immutable machine name. It is part of every operation name of the Connection
170
- * (`connection.<name>.<operation>`), so it holds no dot. A Namespace prefix fits in front.
185
+ * (`connection.<name>.<operation>`), so it holds no dot.
171
186
  */
172
187
  declare const CONNECTION_NAME_PATTERN: RegExp;
173
188
  declare const CONNECTION_NAME_MAX_LENGTH = 64;
@@ -189,8 +204,16 @@ declare const CONNECTION_HEALTH_STATES: readonly ["unknown", "ok", "failed", "ne
189
204
  type ConnectionHealth = (typeof CONNECTION_HEALTH_STATES)[number];
190
205
  declare const GRANT_HOLDER_KINDS: readonly ["user", "service_principal", "role", "group"];
191
206
  type GrantHolderKind = (typeof GRANT_HOLDER_KINDS)[number];
192
- declare const GRANT_SCOPE_KINDS: readonly ["instance", "workspace", "namespace", "asset"];
207
+ declare const GRANT_SCOPE_KINDS: readonly ["instance", "workspace", "asset"];
193
208
  type GrantScopeKind = (typeof GRANT_SCOPE_KINDS)[number];
209
+ /** Where a role's grant lies: the whole instance, one workspace or one asset. */
210
+ declare const ROLE_GRANT_SCOPE_KINDS: readonly ["instance", "workspace", "asset"];
211
+ type RoleGrantScopeKind = (typeof ROLE_GRANT_SCOPE_KINDS)[number];
212
+ /** What a release did to an action of a built-in role's default that waits for a decision. */
213
+ declare const ROLE_PENDING_CHANGES: readonly ["added", "removed"];
214
+ /** The decision on a pending action: apply what the release did, or dismiss it. */
215
+ declare const ROLE_PENDING_DECISIONS: readonly ["apply", "dismiss"];
216
+ type RolePendingDecision = (typeof ROLE_PENDING_DECISIONS)[number];
194
217
  declare const GRANT_EFFECTS: readonly ["allow", "deny"];
195
218
  type GrantEffect = (typeof GRANT_EFFECTS)[number];
196
219
  declare const ACCESS_SOURCES: readonly ["role", "legacy_ref", "grant", "membership"];
@@ -203,12 +226,34 @@ declare const ADMINISTERED_USER_STATUSES: readonly ["active", "disabled", "delet
203
226
  type AdministeredUserStatus = (typeof ADMINISTERED_USER_STATUSES)[number];
204
227
  declare const SERVICE_PRINCIPAL_STATUSES: readonly ["active", "disabled"];
205
228
  type ServicePrincipalStatus = (typeof SERVICE_PRINCIPAL_STATUSES)[number];
229
+ /**
230
+ * When the account a Workflow runs as needs a right its definition names. `publish`: the
231
+ * publish is refused without it. `run`: the step that needs it fails when it runs.
232
+ */
233
+ declare const WORKFLOW_RIGHT_NEEDED_FOR: readonly ["publish", "run"];
234
+ /** The revision of a publish's Workflow the rights are read from: the one published, or a live child. */
235
+ declare const WORKFLOW_RIGHTS_REVISIONS: readonly ["draft", "published"];
236
+ /** How the account a Workflow names stands: a principal's status, or no principal of the name. */
237
+ declare const WORKFLOW_RUN_ACCOUNT_STATUSES: readonly ["active", "disabled", "unknown"];
238
+ /**
239
+ * Why a reader cannot give an account a right it lacks. `not_grantable`: nobody can give it to
240
+ * an account here. `not_administrator`: giving needs someone who administers technical
241
+ * accounts. `not_held`: the reader does not hold it there. `account_unavailable`: the account
242
+ * is missing or disabled. `asset_unavailable`: no active asset of the name exists.
243
+ */
244
+ declare const WORKFLOW_RIGHT_REFUSALS: readonly ["not_grantable", "not_administrator", "not_held", "account_unavailable", "asset_unavailable", "not_visible"];
206
245
  declare const SERVICE_PRINCIPAL_PERMISSIONS: readonly ["config_assets.read", "config_assets.release"];
207
246
  type ServicePrincipalPermission = (typeof SERVICE_PRINCIPAL_PERMISSIONS)[number];
208
247
  declare const API_CREDENTIAL_SCOPES: readonly ["config_assets:read", "config_assets:release"];
209
248
  type ApiCredentialScope = (typeof API_CREDENTIAL_SCOPES)[number];
210
249
  declare const APP_ERROR_CODES: readonly ["BAD_REQUEST", "UNAUTHENTICATED", "FORBIDDEN", "NOT_FOUND", "CONFLICT", "REVISION_CONFLICT", "PRECONDITION_REQUIRED", "TIMEOUT", "VALIDATION_FAILED", "RATE_LIMITED", "POLICY_DENIED", "GUARDRAIL_BLOCKED", "DECLINED", "IDEMPOTENCY_KEY_REUSED", "OPERATION_IN_PROGRESS", "OPERATION_EXPIRED", "OUTPUT_NOT_RETAINED", "INTERNAL"];
211
250
  declare const OPERATION_EFFECTS: readonly ["reading", "changing"];
251
+ /** The parts a catalogue entry can bring: tools agents call, or a Knowledge Base source. */
252
+ declare const CATALOGUE_PARTS: readonly ["tools", "source"];
253
+ type CataloguePart = (typeof CATALOGUE_PARTS)[number];
254
+ /** The categories a catalogue entry's card is filed under. */
255
+ declare const CATALOGUE_CATEGORIES: readonly ["mail", "files", "accounting", "databases", "other"];
256
+ type CatalogueCategory = (typeof CATALOGUE_CATEGORIES)[number];
212
257
  declare const OPERATION_TARGETS: readonly ["live", "test", "dry_run"];
213
258
  type OperationTarget = (typeof OPERATION_TARGETS)[number];
214
259
  declare const OPERATION_RUN_STATUSES: readonly ["running", "pending_confirmation", "pending_approval", "done", "failed", "denied", "expired"];
@@ -225,7 +270,7 @@ declare const APPROVAL_REQUEST_STATUSES: readonly ["pending", "approved", "rejec
225
270
  type ApprovalRequestStatus = (typeof APPROVAL_REQUEST_STATUSES)[number];
226
271
  declare const APPROVAL_CHECK_STATUSES: readonly ["passed", "warned", "blocked"];
227
272
  type ApprovalCheckStatus = (typeof APPROVAL_CHECK_STATUSES)[number];
228
- declare const APPROVAL_EXECUTIONS: readonly ["queued", "done", "failed", "interrupted", "refused", "expired"];
273
+ declare const APPROVAL_EXECUTIONS: readonly ["queued", "done", "failed", "interrupted", "refused", "expired", "held"];
229
274
  type ApprovalExecution = (typeof APPROVAL_EXECUTIONS)[number];
230
275
  declare const SKILL_CHANGE_TYPES: readonly ["replace", "add", "new_resource"];
231
276
  type SkillChangeType = (typeof SKILL_CHANGE_TYPES)[number];
@@ -247,6 +292,12 @@ declare const CONFIG_ASSET_CHANGE_OPERATIONS: readonly ["create", "update", "del
247
292
  type ConfigAssetChangeOperation = (typeof CONFIG_ASSET_CHANGE_OPERATIONS)[number];
248
293
  declare const AGENT_AVAILABILITY_MODES: readonly ["all", "selected"];
249
294
  type AgentAvailabilityMode = (typeof AGENT_AVAILABILITY_MODES)[number];
295
+ /**
296
+ * Who uses an agent where it is available (AGENT-USE-1): everyone who may work there, or only
297
+ * those `agent.use` allows on it. Every agent starts at `everyone`.
298
+ */
299
+ declare const AGENT_USE_SETTINGS: readonly ["everyone", "granted"];
300
+ type AgentUse = (typeof AGENT_USE_SETTINGS)[number];
250
301
  declare const AGENT_EDITABLE_FIELDS: readonly ["displayName", "description", "welcomeMessage", "welcomeSubtitle", "instructions", "modelBindingId", "reasoningEffort", "maxSteps", "toolNames", "skillNames", "knowledgeBases", "initialPrompts"];
251
302
  type AgentEditableField = (typeof AGENT_EDITABLE_FIELDS)[number];
252
303
  declare const ASSET_REPO_BUNDLE_KINDS: readonly ["full", "incremental"];
@@ -282,6 +333,9 @@ type OpenaiCompatibleApi = (typeof OPENAI_COMPATIBLE_APIS)[number];
282
333
  declare const MODEL_PROVIDER_AUTH_MODES: readonly ["bearer", "api-key"];
283
334
  type ModelProviderAuthMode = (typeof MODEL_PROVIDER_AUTH_MODES)[number];
284
335
  declare const CONVERSATION_VISIBILITIES: readonly ["workspace", "private"];
336
+ /** A conversation a person has, or the run thread of a Child Agent Run. */
337
+ declare const CONVERSATION_KINDS: readonly ["chat", "run_thread"];
338
+ type ConversationKind = (typeof CONVERSATION_KINDS)[number];
285
339
  type ConversationVisibility = (typeof CONVERSATION_VISIBILITIES)[number];
286
340
  declare const WEB_SOURCE_PROVIDERS: readonly ["openai-native", "serper", "tavily", "firecrawl", "browserbase", "direct"];
287
341
  type WebSourceProvider = (typeof WEB_SOURCE_PROVIDERS)[number];
@@ -293,7 +347,11 @@ declare const ATTACHMENT_CREATE_OUTCOMES: readonly ["created", "already_availabl
293
347
  type AttachmentCreateOutcome = (typeof ATTACHMENT_CREATE_OUTCOMES)[number];
294
348
  declare const STRUCTURED_DATA_REVIEW_REASONS: readonly ["uncertain", "conflicting"];
295
349
  type StructuredDataReviewReason = (typeof STRUCTURED_DATA_REVIEW_REASONS)[number];
296
- declare const AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_for_decision", "cancelling", "completed", "cancelled", "failed"];
350
+ /** Queued: sent as the next turn. Steer: taken in by the author's own running turn (FU-2). */
351
+ declare const FOLLOW_UP_MODES: readonly ["queue", "steer"];
352
+ /** `consumed`: a steer the running turn took in; `dispatched`: started as a turn of its own. */
353
+ declare const FOLLOW_UP_STATUSES: readonly ["pending", "dispatched", "consumed", "cancelled"];
354
+ declare const AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_for_decision", "waiting_for_subagents", "cancelling", "completed", "cancelled", "failed"];
297
355
  type AgentRunStatus = (typeof AGENT_RUN_STATUSES)[number];
298
356
  declare const AGENT_RUN_FAILURE_CATEGORIES: readonly ["app_error", "internal_error", "runtime_interrupted", "abort_error", "unknown_error"];
299
357
  type AgentRunFailureCategory = (typeof AGENT_RUN_FAILURE_CATEGORIES)[number];
@@ -301,6 +359,10 @@ declare const TOOL_INPUT_PARSE_ERROR_CODES: readonly ["invalid_json", "invalid_t
301
359
  type ToolInputParseErrorCode = (typeof TOOL_INPUT_PARSE_ERROR_CODES)[number];
302
360
  declare const WAITING_OPERATION_RUN_STATUSES: readonly ["pending_confirmation", "pending_approval"];
303
361
  declare const OPERATION_CONFIRMATION_DECISIONS: readonly ["confirm", "decline"];
362
+ /** A person's own value for an operation (OP-6): Always allow, Ask me, Never. */
363
+ declare const PERSON_POLICY_SETTINGS: readonly ["always_allow", "ask", "never"];
364
+ /** How far a changing operation reaches. One that declares none counts as `irreversible`. */
365
+ declare const OPERATION_CHANGE_CLASSES: readonly ["reversible", "irreversible", "outward"];
304
366
  declare const TOOL_DECISION_MODES: readonly ["confirm", "approval"];
305
367
  declare const TOOL_DECISION_OUTCOMES: readonly ["confirmed", "declined", "expired", "cancelled"];
306
368
  declare const TOOL_CALL_STATES: readonly ["input_available", "waiting_for_decision", "output_available", "output_error"];
@@ -333,8 +395,39 @@ declare const CONNECTION_OPERATION_STATUSES: readonly ["ready", "awaiting_discov
333
395
  type ConnectionOperationStatus = (typeof CONNECTION_OPERATION_STATUSES)[number];
334
396
  declare const CONNECTION_SECRET_STATES: readonly ["set", "not_set", "unreadable"];
335
397
  type ConnectionSecretState = (typeof CONNECTION_SECRET_STATES)[number];
336
- declare const CONNECTOR_TEST_STATUSES: readonly ["ready", "unauthorized", "network_denied", "unavailable"];
398
+ declare const CONNECTOR_TEST_STATUSES: readonly ["ready", "unauthorized", "network_denied", "unavailable", "oauth_required"];
337
399
  type ConnectorTestStatus = (typeof CONNECTOR_TEST_STATUSES)[number];
400
+ /** Shared account, or the acting person's own account. */
401
+ declare const CONNECTION_CREDENTIAL_MODES: readonly ["shared", "user"];
402
+ type ConnectionCredentialMode = (typeof CONNECTION_CREDENTIAL_MODES)[number];
403
+ /**
404
+ * The state of a Connection's sign-in. `connected`: calls use it. `needs_reconnect`: the
405
+ * outside system refused it and a new sign-in is needed. `revoked`: someone disconnected it,
406
+ * or its Connection went away.
407
+ */
408
+ declare const CONNECTION_BINDING_STATES: readonly ["connected", "needs_reconnect", "revoked"];
409
+ type ConnectionBindingState = (typeof CONNECTION_BINDING_STATES)[number];
410
+ /** What a chat Connection proposal's card needs to start setup or sign-in. */
411
+ declare const CONNECTION_PROPOSAL_STATES: readonly ["ready", "needs_setup"];
412
+ type ConnectionProposalState = (typeof CONNECTION_PROPOSAL_STATES)[number];
413
+ declare const CONNECTION_PROPOSAL_BINDING_STATES: readonly ["connected", "needs_reconnect", "not_connected"];
414
+ type ConnectionProposalBindingState = (typeof CONNECTION_PROPOSAL_BINDING_STATES)[number];
415
+ /** What a refused call of a personal Connection needs of its person: a first or a new sign-in. */
416
+ declare const CONNECTION_SIGN_IN_NEEDS: readonly ["not_connected", "needs_reconnect"];
417
+ type ConnectionSignInNeed = (typeof CONNECTION_SIGN_IN_NEEDS)[number];
418
+ /**
419
+ * How a Connection that signs in with OAuth has its client: registered by the platform
420
+ * (Dynamic Client Registration), issued by the provider and named in the settings, or the
421
+ * operator's managed client of release config (`infrastructure.oauthClients`, MS-APP-1).
422
+ */
423
+ declare const CONNECTION_OAUTH_REGISTRATIONS: readonly ["dcr", "preregistered", "managed"];
424
+ type ConnectionOAuthRegistration = (typeof CONNECTION_OAUTH_REGISTRATIONS)[number];
425
+ /**
426
+ * What the provider answered to the revocation of a sign-in (RFC 7009): it confirmed, it
427
+ * failed or was not reached, or it lists no revocation endpoint and was sent nothing.
428
+ */
429
+ declare const CONNECTION_PROVIDER_REVOCATIONS: readonly ["confirmed", "failed", "not_offered"];
430
+ type ConnectionProviderRevocation = (typeof CONNECTION_PROVIDER_REVOCATIONS)[number];
338
431
  declare const CONNECTION_ORIGINS: readonly ["release", "runtime"];
339
432
  type ConnectionOrigin = (typeof CONNECTION_ORIGINS)[number];
340
433
  declare const CONNECTION_NETWORKS: readonly ["public", "private"];
@@ -351,19 +444,111 @@ declare const DATA_STORE_STATUSES: readonly ["provisioning", "ready", "retired"]
351
444
  type DataStoreStatus = (typeof DATA_STORE_STATUSES)[number];
352
445
  declare const DATA_STORE_MIGRATION_OUTCOMES: readonly ["none", "pending", "applied", "failed"];
353
446
  type DataStoreMigrationOutcome = (typeof DATA_STORE_MIGRATION_OUTCOMES)[number];
354
- declare const KNOWLEDGE_BASE_STATUSES: readonly ["unchecked", "ok", "needs_attention"];
447
+ /**
448
+ * `unchecked` until the first check; `preparing` while the store a Knowledge Base of documents
449
+ * owns is still being made; then `ok` or `needs_attention`.
450
+ */
451
+ declare const KNOWLEDGE_BASE_STATUSES: readonly ["unchecked", "preparing", "ok", "needs_attention"];
355
452
  type KnowledgeBaseStatus = (typeof KNOWLEDGE_BASE_STATUSES)[number];
453
+ /**
454
+ * The embedding of a Knowledge Base that searches by meaning. `current`: its index embeds with
455
+ * the model it is set to. `reindex_needed`: the index's model is gone from the instance, so
456
+ * search answers by words and titles alone. `reindex_available`: it is set to another model
457
+ * than its index uses. `reindexing`: a new index is being built beside the one search reads.
458
+ * `none`: nothing is embedded yet.
459
+ */
460
+ declare const KNOWLEDGE_EMBEDDING_STATES: readonly ["current", "reindex_needed", "reindex_available", "reindexing", "none"];
461
+ /**
462
+ * What the page of a Knowledge Base shows of one document. `pending` is added and not yet
463
+ * searchable: waiting for its index job, being indexed or waiting for extraction. `indexed` is
464
+ * found by search. `failed` carries one of `KNOWLEDGE_DOCUMENT_FAILURE_CODES`; Retry puts it
465
+ * back to `pending`.
466
+ */
467
+ declare const KNOWLEDGE_DOCUMENT_STATES: readonly ["pending", "indexed", "failed"];
468
+ type KnowledgeDocumentState = (typeof KNOWLEDGE_DOCUMENT_STATES)[number];
469
+ /**
470
+ * The largest file a Knowledge Base takes, as document processing takes it. A larger file is
471
+ * refused when it is added, with this limit named.
472
+ */
473
+ declare const KNOWLEDGE_FILE_MAX_BYTES: number;
474
+ /**
475
+ * Why a document was not indexed. The first five and `knowledge_file_too_many_pages` can also
476
+ * come from the extraction of a PDF or DOCX (`KNOWLEDGE_EXTRACTION_FAILURE_CODES` in core); the
477
+ * rest are the index job's own. The list only gains members.
478
+ */
479
+ declare const KNOWLEDGE_DOCUMENT_FAILURE_CODES: readonly ["knowledge_file_format_unsupported", "knowledge_file_over_limit", "knowledge_file_unreadable", "knowledge_file_missing", "knowledge_extraction_failed", "knowledge_file_format_unavailable", "knowledge_text_unreadable", "knowledge_text_empty", "knowledge_index_failed", "knowledge_file_too_many_pages", "knowledge_processor_output_invalid", "knowledge_conversion_timeout"];
480
+ type KnowledgeDocumentFailureCode = (typeof KNOWLEDGE_DOCUMENT_FAILURE_CODES)[number];
481
+ /**
482
+ * Why a `pending` document waits, where it waits for something other than its turn. It goes on
483
+ * by itself once the cause is gone.
484
+ */
485
+ declare const KNOWLEDGE_DOCUMENT_WAIT_CODES: readonly ["knowledge_usage_limit_reached"];
486
+ type KnowledgeDocumentWaitCode = (typeof KNOWLEDGE_DOCUMENT_WAIT_CODES)[number];
487
+ /**
488
+ * Why a synced source of a Knowledge Base, or one item of it, did not come in. Beside the
489
+ * document codes: an item over the size limit or of a format the instance does not read is
490
+ * recorded with `knowledge_file_over_limit` or `knowledge_file_format_unsupported` and never
491
+ * fetched. Spec: Synced sources, Contract freezes (SRC-0).
492
+ */
493
+ declare const KNOWLEDGE_SOURCE_FAILURE_CODES: readonly ["knowledge_source_unreachable", "knowledge_source_refused", "knowledge_fetch_failed", "knowledge_source_limit_reached", "knowledge_item_invalid", "knowledge_fetch_not_allowed", "knowledge_ingest_cancelled", "knowledge_item_removed"];
494
+ type KnowledgeSourceFailureCode = (typeof KNOWLEDGE_SOURCE_FAILURE_CODES)[number];
495
+ /** The code a failed item of a synced source carries: a source code, or one it shares with a file added by hand. */
496
+ declare const KNOWLEDGE_SOURCE_ITEM_FAILURE_CODES: readonly ["knowledge_source_unreachable", "knowledge_source_refused", "knowledge_fetch_failed", "knowledge_source_limit_reached", "knowledge_item_invalid", "knowledge_fetch_not_allowed", "knowledge_ingest_cancelled", "knowledge_item_removed", "knowledge_file_over_limit", "knowledge_file_format_unsupported"];
497
+ type KnowledgeSourceItemFailureCode = (typeof KNOWLEDGE_SOURCE_ITEM_FAILURE_CODES)[number];
498
+ /**
499
+ * The state of an item of a synced source as the sync keeps it. It ends at `fetched`: from
500
+ * then on the item shows its document's state. `withdrawn` is out of search.
501
+ */
502
+ declare const KNOWLEDGE_SOURCE_ITEM_STATES: readonly ["discovered", "fetched", "failed", "withdrawn"];
503
+ type KnowledgeSourceItemState = (typeof KNOWLEDGE_SOURCE_ITEM_STATES)[number];
504
+ /**
505
+ * How a sync of a source walks it: `initial` and `full` list every item below its folders,
506
+ * `changes` reads the source's change feed from the stored cursor, and `ingest` is one call
507
+ * of `knowledge.<id>.ingest` from a Workflow into its Workflow-fed source.
508
+ */
509
+ declare const KNOWLEDGE_SYNC_MODES: readonly ["initial", "changes", "full", "ingest"];
510
+ type KnowledgeSyncMode = (typeof KNOWLEDGE_SYNC_MODES)[number];
511
+ declare const KNOWLEDGE_SYNC_RUN_STATES: readonly ["running", "done", "failed", "superseded"];
512
+ type KnowledgeSyncRunState = (typeof KNOWLEDGE_SYNC_RUN_STATES)[number];
513
+ /** What a sync run counts, in this order wherever it shows them. */
514
+ declare const KNOWLEDGE_SYNC_COUNTS: readonly ["discovered", "added", "changed", "moved", "withdrawn", "failed", "skipped"];
515
+ type KnowledgeSyncCount = (typeof KNOWLEDGE_SYNC_COUNTS)[number];
516
+ /**
517
+ * The ranked lists a search on the built-in backend fuses: cosine distance to the query's
518
+ * embedding, German and English full text, and the words of a document's title and file name.
519
+ */
520
+ declare const KNOWLEDGE_SEARCH_SIGNALS: readonly ["semantic", "keyword", "title"];
521
+ type KnowledgeSearchSignal = (typeof KNOWLEDGE_SEARCH_SIGNALS)[number];
356
522
  declare const DATABASE_RELATION_TYPES: readonly ["table", "view", "materialized_view", "foreign_table"];
357
523
  type DatabaseRelationType = (typeof DATABASE_RELATION_TYPES)[number];
358
- declare const WORKFLOW_RUN_STATUSES: readonly ["queued", "running", "waiting", "done", "failed", "cancelled", "limit_reached"];
524
+ declare const WORKFLOW_RUN_STATUSES: readonly ["continued", "queued", "running", "waiting", "done", "failed", "cancelled", "limit_reached"];
359
525
  type WorkflowRunStatus = (typeof WORKFLOW_RUN_STATUSES)[number];
360
526
  declare const WORKFLOW_STEP_TYPES: readonly ["trigger", "operation", "loop", "code", "output", "agent", "notify", "workflow"];
361
527
  type WorkflowStepType = (typeof WORKFLOW_STEP_TYPES)[number];
528
+ /**
529
+ * The step types this release executes. The engine accepts no definition that names another,
530
+ * and the interface offers no other in its palette (workflow-canvas 9.6). A list of its own, so
531
+ * it can be narrower than `WORKFLOW_STEP_TYPES` while a known type is not run yet.
532
+ */
533
+ declare const WORKFLOW_EXECUTED_STEP_TYPES: readonly ["trigger", "operation", "loop", "code", "output", "agent", "notify", "workflow"];
362
534
  declare const WORKFLOW_RESERVED_STEP_TYPES: readonly ["condition", "parallel"];
363
535
  type WorkflowReservedStepType = (typeof WORKFLOW_RESERVED_STEP_TYPES)[number];
364
536
  declare const WORKFLOW_TRIGGER_KINDS: readonly ["manual", "schedule", "parent"];
365
537
  type WorkflowTriggerKind = (typeof WORKFLOW_TRIGGER_KINDS)[number];
366
538
  declare const NOTIFY_CHANNELS: readonly ["inbox", "mail"];
539
+ /**
540
+ * What an operation step's facts name as its source (`stepFacts`, workflow-canvas.md 9.8). A
541
+ * step on `mail.send` names its sender as `mail_sender`, with the sender's icon key as
542
+ * `service` (`MAIL_SENDER_SYSTEM_ICON`, or a Connection's service).
543
+ */
544
+ declare const WORKFLOW_STEP_SOURCE_KINDS: readonly ["connection", "data_store", "knowledge_base", "workflow", "mail_sender", "other"];
545
+ type WorkflowStepSourceKind = (typeof WORKFLOW_STEP_SOURCE_KINDS)[number];
546
+ /**
547
+ * What an operation a step may call belongs to (`operations.list_callable`, WF-EDIT-3). `other`
548
+ * is an operation of the release.
549
+ */
550
+ declare const OPERATION_SOURCE_KINDS: readonly ["connection", "data_store", "knowledge_base", "workflow", "other"];
551
+ type OperationSourceKind = (typeof OPERATION_SOURCE_KINDS)[number];
367
552
  type NotifyChannel = (typeof NOTIFY_CHANNELS)[number];
368
553
  declare const PRINCIPAL_HOLDER_KINDS: readonly ["user", "service_principal"];
369
554
  type PrincipalHolderKind = (typeof PRINCIPAL_HOLDER_KINDS)[number];
@@ -375,13 +560,19 @@ declare const CONNECTION_OPERATION_POLICIES: readonly ["deny", "approval"];
375
560
  type ConnectionOperationPolicy = (typeof CONNECTION_OPERATION_POLICIES)[number];
376
561
  declare const WORKFLOW_RUN_MODES: readonly ["live", "test"];
377
562
  type WorkflowRunMode = (typeof WORKFLOW_RUN_MODES)[number];
563
+ /**
564
+ * Which revision of a Workflow a test run an App's draft started ran (DP-1): its draft, for a
565
+ * tester who may write it, or its published revision.
566
+ */
567
+ declare const WORKFLOW_TEST_REVISIONS: readonly ["draft", "published"];
568
+ type WorkflowTestRevision = (typeof WORKFLOW_TEST_REVISIONS)[number];
378
569
  declare const APP_ACTION_CALL_STATUSES: readonly ["done", "pending_approval"];
379
570
  type AppActionCallStatus = (typeof APP_ACTION_CALL_STATUSES)[number];
380
571
  declare const OPERATIONS_AUDIENCES: readonly ["workflow", "app"];
381
572
  type OperationsAudience = (typeof OPERATIONS_AUDIENCES)[number];
382
573
  declare const DECIDED_APPROVAL_REQUEST_STATUSES: readonly ["approved", "rejected", "changes_requested", "superseded", "withdrawn", "reverted"];
383
574
  type DecidedApprovalRequestStatus = (typeof DECIDED_APPROVAL_REQUEST_STATUSES)[number];
384
- declare const ENDED_APPROVAL_EXECUTIONS: readonly ["done", "failed", "interrupted", "refused", "expired"];
575
+ declare const ENDED_APPROVAL_EXECUTIONS: readonly ["done", "failed", "interrupted", "refused", "expired", "held"];
385
576
  type EndedApprovalExecution = (typeof ENDED_APPROVAL_EXECUTIONS)[number];
386
577
  declare const GUARDRAIL_HIT_OUTCOMES: readonly ["warn", "require_approval", "block"];
387
578
  type GuardrailHitOutcome = (typeof GUARDRAIL_HIT_OUTCOMES)[number];
@@ -395,7 +586,7 @@ declare const MESSAGE_FINISH_STATUSES: readonly ["completed", "cancelled"];
395
586
  type MessageFinishStatus = (typeof MESSAGE_FINISH_STATUSES)[number];
396
587
  declare const ENDED_AGENT_RUN_STATUSES: readonly ["completed", "cancelled", "failed"];
397
588
  type EndedAgentRunStatus = (typeof ENDED_AGENT_RUN_STATUSES)[number];
398
- declare const ACTIVE_AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_for_decision", "cancelling"];
589
+ declare const ACTIVE_AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_for_decision", "waiting_for_subagents", "cancelling"];
399
590
  type ActiveAgentRunStatus = (typeof ACTIVE_AGENT_RUN_STATUSES)[number];
400
591
  declare const ARTIFACT_PREVIEW_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/webp"];
401
592
  type ArtifactPreviewImageMimeType = (typeof ARTIFACT_PREVIEW_IMAGE_MIME_TYPES)[number];
@@ -407,13 +598,32 @@ declare const AUDIT_EVENT_STATUSES: readonly ["success", "failed", "denied"];
407
598
  type AuditEventStatus = (typeof AUDIT_EVENT_STATUSES)[number];
408
599
  declare const LISTED_DATA_STORE_STATUSES: readonly ["provisioning", "ready"];
409
600
  type ListedDataStoreStatus = (typeof LISTED_DATA_STORE_STATUSES)[number];
410
- declare const KNOWLEDGE_CHECK_STATUSES: readonly ["ok", "needs_attention"];
601
+ declare const KNOWLEDGE_CHECK_STATUSES: readonly ["preparing", "ok", "needs_attention"];
411
602
  type KnowledgeCheckStatus = (typeof KNOWLEDGE_CHECK_STATUSES)[number];
412
603
  declare const WORKFLOW_STEP_RUN_STATUSES: readonly ["queued", "running", "waiting", "done", "failed", "cancelled"];
413
604
  type WorkflowStepRunStatus = (typeof WORKFLOW_STEP_RUN_STATUSES)[number];
414
- declare const WORKFLOW_ENDED_STATUSES: readonly ["done", "failed", "cancelled", "limit_reached"];
605
+ declare const WORKFLOW_ENDED_STATUSES: readonly ["continued", "done", "failed", "cancelled", "limit_reached"];
415
606
  type WorkflowEndedStatus = (typeof WORKFLOW_ENDED_STATUSES)[number];
607
+ /** A released Managed File keeps its identity; original bytes live at the synced source. */
608
+ declare const MANAGED_FILE_STATUSES: readonly ["available", "released", "deleted"];
609
+ /** A Workflow automates a process unless it fills or processes data. */
610
+ declare const WORKFLOW_KINDS: readonly ["process", "data"];
611
+ type WorkflowKind = (typeof WORKFLOW_KINDS)[number];
612
+ /** Wire formats for a streamed Workflow result dataset. */
613
+ declare const WORKFLOW_DATASET_DOWNLOAD_FORMATS: readonly ["jsonl", "csv"];
614
+ type WorkflowDatasetDownloadFormat = (typeof WORKFLOW_DATASET_DOWNLOAD_FORMATS)[number];
615
+ /** Instance resources whose use may be inherited through workspace availability. */
616
+ declare const WORKSPACE_USE_ASSET_KINDS: readonly ["knowledge_base", "connection"];
617
+ /** Published assets that consume Connections or stored data. Agents hold tools separately. */
618
+ declare const PUBLISHED_DATA_CONSUMER_KINDS: readonly ["app", "workflow", "knowledge_base"];
619
+ type PublishedDataConsumerKind = (typeof PUBLISHED_DATA_CONSUMER_KINDS)[number];
620
+ /** State of a scheduled prompt. */
621
+ declare const SCHEDULED_START_STATES: readonly ["active", "paused"];
622
+ /** Which revision answered an agent preview turn. */
623
+ declare const AGENT_PREVIEW_SOURCES: readonly ["draft", "live"];
416
624
 
625
+ /** A short operator declaration of where a provider processes data. */
626
+ declare const providerRegionSchema: z.ZodString;
417
627
  declare const localizedStringSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
418
628
  en: z.ZodOptional<z.ZodString>;
419
629
  de: z.ZodOptional<z.ZodString>;
@@ -594,6 +804,7 @@ declare const agentConfigSchema: z.ZodObject<{
594
804
  }>>>;
595
805
  maxSteps: z.ZodOptional<z.ZodNumber>;
596
806
  toolNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
807
+ subagentNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
597
808
  skillNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
598
809
  knowledgeBases: z.ZodOptional<z.ZodArray<z.ZodString>>;
599
810
  initialPrompts: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -606,6 +817,7 @@ declare const agentConfigSchema: z.ZodObject<{
606
817
  de: z.ZodOptional<z.ZodString>;
607
818
  }, z.core.$strict>]>;
608
819
  }, z.core.$strip>>>;
820
+ shipped: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
609
821
  }, z.core.$strip>;
610
822
  /** The id of a Workflow, which is the name of its asset: part of `workflow.<id>.start`. */
611
823
  declare const WORKFLOW_NAME_PATTERN: RegExp;
@@ -756,4 +968,1929 @@ declare class YamlDataError extends Error {
756
968
  /** `readYamlData` for a caller that reports a refused file as an error: it throws `YamlDataError`. */
757
969
  declare function loadYamlData(text: string, file: string): unknown;
758
970
 
759
- export { ACCESS_SOURCES, ACTIONS, ACTIVE_AGENT_RUN_STATUSES, ADMINISTERED_USER_STATUSES, AGENT_AVAILABILITY_MODES, AGENT_EDITABLE_FIELDS, AGENT_RUN_FAILURE_CATEGORIES, AGENT_RUN_STATUSES, AGENT_STARTERS_MAX, API_CREDENTIAL_SCOPES, APPROVAL_CHECK_FAILURE_OUTCOMES, APPROVAL_CHECK_STATUSES, APPROVAL_EXECUTIONS, APPROVAL_REQUEST_STATUSES, APP_ACTION_CALL_STATUSES, APP_ERROR_CODES, APP_ERROR_STATUS_CODES, APP_MODES, ARTIFACT_PREVIEW_IMAGE_FORMATS, ARTIFACT_PREVIEW_IMAGE_MIME_TYPES, ARTIFACT_PREVIEW_STATUSES, ASSET_LIFECYCLES, ASSET_NAME_REFUSAL_REASONS, ASSET_OWNER_KINDS, ASSET_REPO_BUNDLE_KINDS, ASSET_REPRESENTATIONS, ASSET_SYNC_CHANGE_TYPES, ATTACHMENT_CREATE_OUTCOMES, AUDIT_ACTOR_KINDS, AUDIT_EVENT_STATUSES, AUDIT_OUTCOMES, AUDIT_TIERS, AUTH_PRINCIPAL_KINDS, AUTH_SCOPE_WILDCARD, type AccessSource, type ActiveAgentRunStatus, type AdministeredUserStatus, type AgentAvailabilityMode, type AgentConfig, type AgentEditableField, type AgentInitialPromptConfig, type AgentRunFailureCategory, type AgentRunStatus, type ApiCredentialScope, type AppActionCallStatus, type AppErrorCode, type AppMode, type ApprovalCheckFailureOutcome, type ApprovalCheckStatus, type ApprovalExecution, type ApprovalRequestStatus, type ArtifactPreviewImageFormat, type ArtifactPreviewImageMimeType, type ArtifactPreviewStatus, type AssetLifecycle, type AssetNameRefusalReason, type AssetOwnerKind, type AssetRepoBundleKind, type AssetRepresentation, type AssetSyncChangeType, type AttachmentCreateOutcome, type AuditActorKind, type AuditEventStatus, type AuditOutcome, type AuditTier, type AuthPrincipalKind, CHAT_MESSAGE_ROLES, CHAT_SESSION_AUTH_SCOPES, COLLABORATION_WORKSPACE_KINDS, CONFIG_ASSET_CHANGE_OPERATIONS, CONFIG_ASSET_KINDS, CONNECTION_EXPOSURES, CONNECTION_HEALTH_STATES, CONNECTION_NAME_MAX_LENGTH, CONNECTION_NAME_PATTERN, CONNECTION_NETWORKS, CONNECTION_OPERATION_POLICIES, CONNECTION_OPERATION_STATUSES, CONNECTION_ORIGINS, CONNECTION_SECRET_STATES, CONNECTOR_TEST_STATUSES, CONVERSATION_ATTACHMENT_STATUSES, CONVERSATION_VISIBILITIES, type ChatMessageRole, type ChatSessionAuthScope, type CollaborationWorkspaceKind, type ConfigAssetChangeOperation, type ConfigAssetKind, type ConnectionExposure, type ConnectionHealth, type ConnectionNetwork, type ConnectionOperationPolicy, type ConnectionOperationStatus, type ConnectionOrigin, type ConnectionSecretState, type ConnectorTestStatus, type ConversationAttachmentStatus, type ConversationVisibility, DATABASE_RELATION_TYPES, DATA_STORE_CONDITIONS, DATA_STORE_INSERT_CONFLICT_MODES, DATA_STORE_LOAD_CONFLICT_MODES, DATA_STORE_MIGRATION_OUTCOMES, DATA_STORE_SCALAR_TYPES, DATA_STORE_STATUSES, DECIDED_APPROVAL_REQUEST_STATUSES, DELETION_STATES, type DataStoreCondition, type DataStoreInsertConflictMode, type DataStoreLoadConflictMode, type DataStoreMigrationOutcome, type DataStoreScalarType, type DataStoreStatus, type DatabaseRelationType, type DecidedApprovalRequestStatus, type DeletionState, ENDED_AGENT_RUN_STATUSES, ENDED_APPROVAL_EXECUTIONS, type EndedAgentRunStatus, type EndedApprovalExecution, FAILED_JOB_STATUSES, FIRST_PARTY_AUTH_SCOPES, type FailedJobStatus, type FirstPartyAuthScope, GRANT_EFFECTS, GRANT_HOLDER_KINDS, GRANT_SCOPE_KINDS, GUARDRAIL_HIT_OUTCOMES, GUARDRAIL_NAME_MAX_LENGTH, GUARDRAIL_NAME_PATTERN, GUARDRAIL_OUTCOMES, type GrantEffect, type GrantHolderKind, type GrantScopeKind, type GuardrailHitOutcome, type GuardrailOutcome, IDEMPOTENCY_KEY_MAX_LENGTH, INFRASTRUCTURE_SECRET_STATES, INFRASTRUCTURE_WITHHELD_FIELDS, type InfrastructureSecretState, type InfrastructureWithheldField, JOB_STATUSES, type JobStatus, KNOWLEDGE_BASE_STATUSES, KNOWLEDGE_CHECK_STATUSES, type KnowledgeBaseStatus, type KnowledgeCheckStatus, LISTED_DATA_STORE_STATUSES, LIVE_JOB_STATUSES, type ListedDataStoreStatus, type LiveJobStatus, type LocaleCode, type LocalizedStringConfig, MESSAGE_FINISH_STATUSES, MODEL_PROVIDER_AUTH_MODES, MODEL_USAGE_EVENT_STATUSES, MODEL_USAGE_SOURCES, MODEL_USAGE_TIERS, type MessageFinishStatus, type ModelProviderAuthMode, type ModelUsageEventStatus, type ModelUsageSource, type ModelUsageTier, NAMESPACE_PREFIX_MAX_LENGTH, NAMESPACE_PREFIX_MIN_LENGTH, NAMESPACE_PREFIX_PATTERN, NOTIFY_CHANNELS, type NotifyChannel, OPENAI_COMPATIBLE_APIS, OPERATIONS_AUDIENCES, OPERATION_CONFIRMATION_DECISIONS, OPERATION_DENIAL_REASONS, OPERATION_EFFECTS, OPERATION_ORIGIN_KINDS, OPERATION_RUN_DECISION_MODES, OPERATION_RUN_DECISION_REASONS, OPERATION_RUN_STATUSES, OPERATION_TARGETS, type OpenaiCompatibleApi, type OperationDenialReason, type OperationEffect, type OperationOriginKind, type OperationRunDecisionMode, type OperationRunDecisionReason, type OperationRunStatus, type OperationScope, type OperationTarget, type OperationsAudience, POLICY_VALUES, PRINCIPAL_HOLDER_KINDS, PROVIDER_CHECK_ERROR_CLASSES, PROVIDER_PORTS, PROVIDER_REGIONS, type PlatformAction, type PolicyValue, type PrincipalHolderKind, type ProviderCheckErrorClass, type ProviderPort, type ProviderRegion, READING_POLICY_VALUES, REASONING_EFFORTS, type ReadingPolicyValue, type ReasoningEffortConfig, SERVICE_PRINCIPAL_PERMISSIONS, SERVICE_PRINCIPAL_STATUSES, SKILL_CHANGE_TYPES, SKILL_FRONTMATTER_FIELDS, SKILL_FRONTMATTER_MAX_BYTES, SKILL_FRONTMATTER_MAX_DEPTH, SKILL_NAME_PATTERN, SKILL_NAME_RULE, SKILL_ORIGINS, SKILL_PORTABLE_DESCRIPTION_MAX_CHARS, SKILL_PORTABLE_NAME_MAX_CHARS, SKILL_RESOURCE_MEDIA_TYPES, SKILL_STARTERS_MAX, SKILL_STARTER_LINE_MAX_LENGTH, SKILL_SUMMARY_MAX_LENGTH, STRUCTURED_DATA_REVIEW_REASONS, SUPPORTED_IMAGE_MIME_TYPES, type ServicePrincipalPermission, type ServicePrincipalStatus, type SkillChangeType, type SkillConfig, type SkillFileEntry, type SkillFrontmatterRefusal, SkillMarkdownError, type SkillOrigin, type SkillResourceConfig, type SkillResourceMediaType, type SkillStarterConfig, type StructuredDataReviewReason, type SupportedImageMimeType, THEME_MODES, THEME_MODE_PREFERENCES, TOOL_CALL_STATES, TOOL_DECISION_MODES, TOOL_DECISION_OUTCOMES, TOOL_DISPLAY_MODES, TOOL_GROUPS, TOOL_INPUT_PARSE_ERROR_CODES, type ThemeMode, type ThemeModePreference, type ToolCallState, type ToolDisplayMode, type ToolGroup, type ToolInputParseErrorCode, USAGE_COST_STATUSES, USER_STATUSES, type UsageCostStatus, type UserStatus, WAITING_OPERATION_RUN_STATUSES, WEB_SOURCE_PROVIDERS, WORKFLOW_ENDED_STATUSES, WORKFLOW_NAME_PATTERN, WORKFLOW_NAME_RULE, WORKFLOW_RESERVED_STEP_TYPES, WORKFLOW_RUN_MODES, WORKFLOW_RUN_STATUSES, WORKFLOW_STEP_RUN_STATUSES, WORKFLOW_STEP_TYPES, WORKFLOW_TRIGGER_KINDS, WORKSPACE_ACCENT_COLORS, WORKSPACE_ACCESS_STATES, WORKSPACE_COMMAND_STATUSES, WORKSPACE_FILE_KINDS, WORKSPACE_MEMBERSHIP_ROLES, WORKSPACE_SECTIONS, WORKSPACE_VISIBILITIES, type WebSourceProvider, type WorkflowAssetConfig, type WorkflowEndedStatus, type WorkflowReservedStepType, type WorkflowRunMode, type WorkflowRunStatus, type WorkflowStepRunStatus, type WorkflowStepType, type WorkflowTriggerKind, type WorkspaceAccentColor, type WorkspaceAccessState, type WorkspaceCommandStatus, type WorkspaceFileKind, type WorkspaceMembershipRole, type WorkspaceSection, type WorkspaceVisibility, YAML_DATA_MAX_VALUES, YamlDataError, type YamlDataIssue, type YamlDataIssueCode, type YamlDataOptions, type YamlDataResult, agentConfigSchema, checkStorableTexts, deriveSkillTitle, formatSkillMarkdown, isStorableText, loadYamlData, localeCodes, localizedStringSchema, parseSkillMarkdown, readYamlData, skillConfigSchema, skillFileEntrySchema, skillFileFrontmatterSchema, skillNameSchema, skillPortabilityIssues, skillResourceConfigSchema, skillResourceMediaTypeForPath, skillResourcePathSchema, skillStarterSchema, workflowConfigSchema, yamlValueIssue, yamlValueIssueSentence };
971
+ declare const knowledgeSyncInputSchema: z.ZodObject<{
972
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
973
+ mode: z.ZodOptional<z.ZodEnum<{
974
+ full: "full";
975
+ changes: "changes";
976
+ }>>;
977
+ confirm: z.ZodOptional<z.ZodBoolean>;
978
+ }, z.core.$strict>;
979
+ type KnowledgeSyncInput = z.infer<typeof knowledgeSyncInputSchema>;
980
+ /** What a sync run ends with: the result of its Operation Run, and a Workflow step's output. */
981
+ declare const knowledgeSyncResultSchema: z.ZodObject<{
982
+ syncRunId: z.ZodString;
983
+ source: z.ZodString;
984
+ mode: z.ZodEnum<{
985
+ full: "full";
986
+ initial: "initial";
987
+ changes: "changes";
988
+ ingest: "ingest";
989
+ }>;
990
+ reason: z.ZodOptional<z.ZodEnum<{
991
+ cursor_expired: "cursor_expired";
992
+ }>>;
993
+ state: z.ZodEnum<{
994
+ failed: "failed";
995
+ running: "running";
996
+ done: "done";
997
+ superseded: "superseded";
998
+ }>;
999
+ counts: z.ZodObject<{
1000
+ discovered: z.ZodNumber;
1001
+ added: z.ZodNumber;
1002
+ changed: z.ZodNumber;
1003
+ moved: z.ZodNumber;
1004
+ withdrawn: z.ZodNumber;
1005
+ failed: z.ZodNumber;
1006
+ skipped: z.ZodNumber;
1007
+ }, z.core.$strict>;
1008
+ bytesFetched: z.ZodNumber;
1009
+ failureCode: z.ZodOptional<z.ZodEnum<{
1010
+ knowledge_source_unreachable: "knowledge_source_unreachable";
1011
+ knowledge_source_refused: "knowledge_source_refused";
1012
+ knowledge_fetch_failed: "knowledge_fetch_failed";
1013
+ knowledge_source_limit_reached: "knowledge_source_limit_reached";
1014
+ knowledge_item_invalid: "knowledge_item_invalid";
1015
+ knowledge_fetch_not_allowed: "knowledge_fetch_not_allowed";
1016
+ knowledge_ingest_cancelled: "knowledge_ingest_cancelled";
1017
+ knowledge_item_removed: "knowledge_item_removed";
1018
+ }>>;
1019
+ startedAt: z.ZodString;
1020
+ endedAt: z.ZodOptional<z.ZodString>;
1021
+ }, z.core.$strict>;
1022
+ type KnowledgeSyncResult = z.infer<typeof knowledgeSyncResultSchema>;
1023
+ /**
1024
+ * What the page shows of an item: its own state up to `fetched`, then its document's.
1025
+ * "Gefunden", "Geladen", "Durchsuchbar", "Fehlgeschlagen", "Entfernt".
1026
+ */
1027
+ declare const KNOWLEDGE_SOURCE_ITEM_SHOWN_STATES: readonly ["discovered", "fetched", "indexed", "failed", "withdrawn"];
1028
+ type KnowledgeSourceItemShownState = (typeof KNOWLEDGE_SOURCE_ITEM_SHOWN_STATES)[number];
1029
+ /**
1030
+ * A first pass that stopped at 10,000 items and waits for one confirmation (KB-ISO-1b): what the
1031
+ * whole pass holds and what it would cost, estimated from the listed sizes with a factor per
1032
+ * format. Counts and sizes only, never a name.
1033
+ */
1034
+ declare const knowledgeFirstPassConfirmationSchema: z.ZodObject<{
1035
+ syncRunId: z.ZodString;
1036
+ items: z.ZodNumber;
1037
+ bytes: z.ZodNumber;
1038
+ stop: z.ZodNumber;
1039
+ tokens: z.ZodOptional<z.ZodObject<{
1040
+ min: z.ZodNumber;
1041
+ max: z.ZodNumber;
1042
+ }, z.core.$strict>>;
1043
+ passages: z.ZodOptional<z.ZodObject<{
1044
+ min: z.ZodNumber;
1045
+ max: z.ZodNumber;
1046
+ }, z.core.$strict>>;
1047
+ model: z.ZodOptional<z.ZodString>;
1048
+ cost: z.ZodOptional<z.ZodObject<{
1049
+ min: z.ZodNumber;
1050
+ max: z.ZodNumber;
1051
+ currency: z.ZodString;
1052
+ }, z.core.$strict>>;
1053
+ room: z.ZodOptional<z.ZodBoolean>;
1054
+ storeBytes: z.ZodNumber;
1055
+ addedBytes: z.ZodOptional<z.ZodNumber>;
1056
+ limitBytes: z.ZodOptional<z.ZodNumber>;
1057
+ }, z.core.$strict>;
1058
+ type KnowledgeFirstPassConfirmation = z.infer<typeof knowledgeFirstPassConfirmationSchema>;
1059
+ declare const knowledgeSourcesOutputSchema: z.ZodObject<{
1060
+ sources: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1061
+ id: z.ZodString;
1062
+ connection: z.ZodString;
1063
+ kind: z.ZodOptional<z.ZodLiteral<"connector">>;
1064
+ items: z.ZodObject<{
1065
+ discovered: z.ZodNumber;
1066
+ fetched: z.ZodNumber;
1067
+ indexed: z.ZodNumber;
1068
+ failed: z.ZodNumber;
1069
+ withdrawn: z.ZodNumber;
1070
+ }, z.core.$strict>;
1071
+ failures: z.ZodArray<z.ZodObject<{
1072
+ code: z.ZodUnion<readonly [z.ZodEnum<{
1073
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1074
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1075
+ knowledge_source_unreachable: "knowledge_source_unreachable";
1076
+ knowledge_source_refused: "knowledge_source_refused";
1077
+ knowledge_fetch_failed: "knowledge_fetch_failed";
1078
+ knowledge_source_limit_reached: "knowledge_source_limit_reached";
1079
+ knowledge_item_invalid: "knowledge_item_invalid";
1080
+ knowledge_fetch_not_allowed: "knowledge_fetch_not_allowed";
1081
+ knowledge_ingest_cancelled: "knowledge_ingest_cancelled";
1082
+ knowledge_item_removed: "knowledge_item_removed";
1083
+ }>, z.ZodEnum<{
1084
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1085
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1086
+ knowledge_file_unreadable: "knowledge_file_unreadable";
1087
+ knowledge_file_missing: "knowledge_file_missing";
1088
+ knowledge_extraction_failed: "knowledge_extraction_failed";
1089
+ knowledge_file_format_unavailable: "knowledge_file_format_unavailable";
1090
+ knowledge_text_unreadable: "knowledge_text_unreadable";
1091
+ knowledge_text_empty: "knowledge_text_empty";
1092
+ knowledge_index_failed: "knowledge_index_failed";
1093
+ knowledge_file_too_many_pages: "knowledge_file_too_many_pages";
1094
+ knowledge_processor_output_invalid: "knowledge_processor_output_invalid";
1095
+ knowledge_conversion_timeout: "knowledge_conversion_timeout";
1096
+ }>]>;
1097
+ count: z.ZodNumber;
1098
+ }, z.core.$strict>>;
1099
+ running: z.ZodOptional<z.ZodObject<{
1100
+ syncRunId: z.ZodString;
1101
+ mode: z.ZodEnum<{
1102
+ full: "full";
1103
+ initial: "initial";
1104
+ changes: "changes";
1105
+ ingest: "ingest";
1106
+ }>;
1107
+ startedAt: z.ZodString;
1108
+ itemsPerMinute: z.ZodOptional<z.ZodNumber>;
1109
+ estimatedEndAt: z.ZodOptional<z.ZodString>;
1110
+ }, z.core.$strict>>;
1111
+ last: z.ZodOptional<z.ZodObject<{
1112
+ syncRunId: z.ZodString;
1113
+ source: z.ZodString;
1114
+ mode: z.ZodEnum<{
1115
+ full: "full";
1116
+ initial: "initial";
1117
+ changes: "changes";
1118
+ ingest: "ingest";
1119
+ }>;
1120
+ reason: z.ZodOptional<z.ZodEnum<{
1121
+ cursor_expired: "cursor_expired";
1122
+ }>>;
1123
+ state: z.ZodEnum<{
1124
+ failed: "failed";
1125
+ running: "running";
1126
+ done: "done";
1127
+ superseded: "superseded";
1128
+ }>;
1129
+ counts: z.ZodObject<{
1130
+ discovered: z.ZodNumber;
1131
+ added: z.ZodNumber;
1132
+ changed: z.ZodNumber;
1133
+ moved: z.ZodNumber;
1134
+ withdrawn: z.ZodNumber;
1135
+ failed: z.ZodNumber;
1136
+ skipped: z.ZodNumber;
1137
+ }, z.core.$strict>;
1138
+ bytesFetched: z.ZodNumber;
1139
+ failureCode: z.ZodOptional<z.ZodEnum<{
1140
+ knowledge_source_unreachable: "knowledge_source_unreachable";
1141
+ knowledge_source_refused: "knowledge_source_refused";
1142
+ knowledge_fetch_failed: "knowledge_fetch_failed";
1143
+ knowledge_source_limit_reached: "knowledge_source_limit_reached";
1144
+ knowledge_item_invalid: "knowledge_item_invalid";
1145
+ knowledge_fetch_not_allowed: "knowledge_fetch_not_allowed";
1146
+ knowledge_ingest_cancelled: "knowledge_ingest_cancelled";
1147
+ knowledge_item_removed: "knowledge_item_removed";
1148
+ }>>;
1149
+ startedAt: z.ZodString;
1150
+ endedAt: z.ZodOptional<z.ZodString>;
1151
+ }, z.core.$strict>>;
1152
+ confirmation: z.ZodOptional<z.ZodObject<{
1153
+ syncRunId: z.ZodString;
1154
+ items: z.ZodNumber;
1155
+ bytes: z.ZodNumber;
1156
+ stop: z.ZodNumber;
1157
+ tokens: z.ZodOptional<z.ZodObject<{
1158
+ min: z.ZodNumber;
1159
+ max: z.ZodNumber;
1160
+ }, z.core.$strict>>;
1161
+ passages: z.ZodOptional<z.ZodObject<{
1162
+ min: z.ZodNumber;
1163
+ max: z.ZodNumber;
1164
+ }, z.core.$strict>>;
1165
+ model: z.ZodOptional<z.ZodString>;
1166
+ cost: z.ZodOptional<z.ZodObject<{
1167
+ min: z.ZodNumber;
1168
+ max: z.ZodNumber;
1169
+ currency: z.ZodString;
1170
+ }, z.core.$strict>>;
1171
+ room: z.ZodOptional<z.ZodBoolean>;
1172
+ storeBytes: z.ZodNumber;
1173
+ addedBytes: z.ZodOptional<z.ZodNumber>;
1174
+ limitBytes: z.ZodOptional<z.ZodNumber>;
1175
+ }, z.core.$strict>>;
1176
+ lastChangeAt: z.ZodOptional<z.ZodString>;
1177
+ oldestOpenChangeAt: z.ZodOptional<z.ZodString>;
1178
+ }, z.core.$strict>, z.ZodObject<{
1179
+ id: z.ZodString;
1180
+ kind: z.ZodLiteral<"workflow">;
1181
+ workflowId: z.ZodString;
1182
+ running: z.ZodOptional<z.ZodObject<{
1183
+ syncRunId: z.ZodString;
1184
+ mode: z.ZodEnum<{
1185
+ full: "full";
1186
+ initial: "initial";
1187
+ changes: "changes";
1188
+ ingest: "ingest";
1189
+ }>;
1190
+ startedAt: z.ZodString;
1191
+ itemsPerMinute: z.ZodOptional<z.ZodNumber>;
1192
+ estimatedEndAt: z.ZodOptional<z.ZodString>;
1193
+ }, z.core.$strict>>;
1194
+ failures: z.ZodArray<z.ZodObject<{
1195
+ code: z.ZodUnion<readonly [z.ZodEnum<{
1196
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1197
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1198
+ knowledge_source_unreachable: "knowledge_source_unreachable";
1199
+ knowledge_source_refused: "knowledge_source_refused";
1200
+ knowledge_fetch_failed: "knowledge_fetch_failed";
1201
+ knowledge_source_limit_reached: "knowledge_source_limit_reached";
1202
+ knowledge_item_invalid: "knowledge_item_invalid";
1203
+ knowledge_fetch_not_allowed: "knowledge_fetch_not_allowed";
1204
+ knowledge_ingest_cancelled: "knowledge_ingest_cancelled";
1205
+ knowledge_item_removed: "knowledge_item_removed";
1206
+ }>, z.ZodEnum<{
1207
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1208
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1209
+ knowledge_file_unreadable: "knowledge_file_unreadable";
1210
+ knowledge_file_missing: "knowledge_file_missing";
1211
+ knowledge_extraction_failed: "knowledge_extraction_failed";
1212
+ knowledge_file_format_unavailable: "knowledge_file_format_unavailable";
1213
+ knowledge_text_unreadable: "knowledge_text_unreadable";
1214
+ knowledge_text_empty: "knowledge_text_empty";
1215
+ knowledge_index_failed: "knowledge_index_failed";
1216
+ knowledge_file_too_many_pages: "knowledge_file_too_many_pages";
1217
+ knowledge_processor_output_invalid: "knowledge_processor_output_invalid";
1218
+ knowledge_conversion_timeout: "knowledge_conversion_timeout";
1219
+ }>]>;
1220
+ count: z.ZodNumber;
1221
+ }, z.core.$strict>>;
1222
+ items: z.ZodObject<{
1223
+ discovered: z.ZodNumber;
1224
+ fetched: z.ZodNumber;
1225
+ indexed: z.ZodNumber;
1226
+ failed: z.ZodNumber;
1227
+ withdrawn: z.ZodNumber;
1228
+ }, z.core.$strict>;
1229
+ last: z.ZodOptional<z.ZodObject<{
1230
+ syncRunId: z.ZodString;
1231
+ source: z.ZodString;
1232
+ mode: z.ZodEnum<{
1233
+ full: "full";
1234
+ initial: "initial";
1235
+ changes: "changes";
1236
+ ingest: "ingest";
1237
+ }>;
1238
+ reason: z.ZodOptional<z.ZodEnum<{
1239
+ cursor_expired: "cursor_expired";
1240
+ }>>;
1241
+ state: z.ZodEnum<{
1242
+ failed: "failed";
1243
+ running: "running";
1244
+ done: "done";
1245
+ superseded: "superseded";
1246
+ }>;
1247
+ counts: z.ZodObject<{
1248
+ discovered: z.ZodNumber;
1249
+ added: z.ZodNumber;
1250
+ changed: z.ZodNumber;
1251
+ moved: z.ZodNumber;
1252
+ withdrawn: z.ZodNumber;
1253
+ failed: z.ZodNumber;
1254
+ skipped: z.ZodNumber;
1255
+ }, z.core.$strict>;
1256
+ bytesFetched: z.ZodNumber;
1257
+ failureCode: z.ZodOptional<z.ZodEnum<{
1258
+ knowledge_source_unreachable: "knowledge_source_unreachable";
1259
+ knowledge_source_refused: "knowledge_source_refused";
1260
+ knowledge_fetch_failed: "knowledge_fetch_failed";
1261
+ knowledge_source_limit_reached: "knowledge_source_limit_reached";
1262
+ knowledge_item_invalid: "knowledge_item_invalid";
1263
+ knowledge_fetch_not_allowed: "knowledge_fetch_not_allowed";
1264
+ knowledge_ingest_cancelled: "knowledge_ingest_cancelled";
1265
+ knowledge_item_removed: "knowledge_item_removed";
1266
+ }>>;
1267
+ startedAt: z.ZodString;
1268
+ endedAt: z.ZodOptional<z.ZodString>;
1269
+ }, z.core.$strict>>;
1270
+ confirmation: z.ZodOptional<z.ZodObject<{
1271
+ syncRunId: z.ZodString;
1272
+ items: z.ZodNumber;
1273
+ bytes: z.ZodNumber;
1274
+ stop: z.ZodNumber;
1275
+ tokens: z.ZodOptional<z.ZodObject<{
1276
+ min: z.ZodNumber;
1277
+ max: z.ZodNumber;
1278
+ }, z.core.$strict>>;
1279
+ passages: z.ZodOptional<z.ZodObject<{
1280
+ min: z.ZodNumber;
1281
+ max: z.ZodNumber;
1282
+ }, z.core.$strict>>;
1283
+ model: z.ZodOptional<z.ZodString>;
1284
+ cost: z.ZodOptional<z.ZodObject<{
1285
+ min: z.ZodNumber;
1286
+ max: z.ZodNumber;
1287
+ currency: z.ZodString;
1288
+ }, z.core.$strict>>;
1289
+ room: z.ZodOptional<z.ZodBoolean>;
1290
+ storeBytes: z.ZodNumber;
1291
+ addedBytes: z.ZodOptional<z.ZodNumber>;
1292
+ limitBytes: z.ZodOptional<z.ZodNumber>;
1293
+ }, z.core.$strict>>;
1294
+ lastChangeAt: z.ZodOptional<z.ZodString>;
1295
+ oldestOpenChangeAt: z.ZodOptional<z.ZodString>;
1296
+ }, z.core.$strict>]>>;
1297
+ }, z.core.$strict>;
1298
+ type KnowledgeSourcesOutput = z.infer<typeof knowledgeSourcesOutputSchema>;
1299
+ declare const knowledgeSourceItemsInputSchema: z.ZodObject<{
1300
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
1301
+ state: z.ZodOptional<z.ZodEnum<{
1302
+ failed: "failed";
1303
+ withdrawn: "withdrawn";
1304
+ indexed: "indexed";
1305
+ discovered: "discovered";
1306
+ fetched: "fetched";
1307
+ }>>;
1308
+ failureCode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
1309
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1310
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1311
+ knowledge_source_unreachable: "knowledge_source_unreachable";
1312
+ knowledge_source_refused: "knowledge_source_refused";
1313
+ knowledge_fetch_failed: "knowledge_fetch_failed";
1314
+ knowledge_source_limit_reached: "knowledge_source_limit_reached";
1315
+ knowledge_item_invalid: "knowledge_item_invalid";
1316
+ knowledge_fetch_not_allowed: "knowledge_fetch_not_allowed";
1317
+ knowledge_ingest_cancelled: "knowledge_ingest_cancelled";
1318
+ knowledge_item_removed: "knowledge_item_removed";
1319
+ }>, z.ZodEnum<{
1320
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1321
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1322
+ knowledge_file_unreadable: "knowledge_file_unreadable";
1323
+ knowledge_file_missing: "knowledge_file_missing";
1324
+ knowledge_extraction_failed: "knowledge_extraction_failed";
1325
+ knowledge_file_format_unavailable: "knowledge_file_format_unavailable";
1326
+ knowledge_text_unreadable: "knowledge_text_unreadable";
1327
+ knowledge_text_empty: "knowledge_text_empty";
1328
+ knowledge_index_failed: "knowledge_index_failed";
1329
+ knowledge_file_too_many_pages: "knowledge_file_too_many_pages";
1330
+ knowledge_processor_output_invalid: "knowledge_processor_output_invalid";
1331
+ knowledge_conversion_timeout: "knowledge_conversion_timeout";
1332
+ }>]>>;
1333
+ limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1334
+ cursor: z.ZodOptional<z.ZodString>;
1335
+ }, z.core.$strict>;
1336
+ type KnowledgeSourceItemsInput = z.infer<typeof knowledgeSourceItemsInputSchema>;
1337
+ declare const knowledgeSourceItemsOutputSchema: z.ZodObject<{
1338
+ items: z.ZodArray<z.ZodObject<{
1339
+ id: z.ZodString;
1340
+ itemId: z.ZodString;
1341
+ name: z.ZodString;
1342
+ path: z.ZodString;
1343
+ state: z.ZodEnum<{
1344
+ failed: "failed";
1345
+ withdrawn: "withdrawn";
1346
+ indexed: "indexed";
1347
+ discovered: "discovered";
1348
+ fetched: "fetched";
1349
+ }>;
1350
+ failureCode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
1351
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1352
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1353
+ knowledge_source_unreachable: "knowledge_source_unreachable";
1354
+ knowledge_source_refused: "knowledge_source_refused";
1355
+ knowledge_fetch_failed: "knowledge_fetch_failed";
1356
+ knowledge_source_limit_reached: "knowledge_source_limit_reached";
1357
+ knowledge_item_invalid: "knowledge_item_invalid";
1358
+ knowledge_fetch_not_allowed: "knowledge_fetch_not_allowed";
1359
+ knowledge_ingest_cancelled: "knowledge_ingest_cancelled";
1360
+ knowledge_item_removed: "knowledge_item_removed";
1361
+ }>, z.ZodEnum<{
1362
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1363
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1364
+ knowledge_file_unreadable: "knowledge_file_unreadable";
1365
+ knowledge_file_missing: "knowledge_file_missing";
1366
+ knowledge_extraction_failed: "knowledge_extraction_failed";
1367
+ knowledge_file_format_unavailable: "knowledge_file_format_unavailable";
1368
+ knowledge_text_unreadable: "knowledge_text_unreadable";
1369
+ knowledge_text_empty: "knowledge_text_empty";
1370
+ knowledge_index_failed: "knowledge_index_failed";
1371
+ knowledge_file_too_many_pages: "knowledge_file_too_many_pages";
1372
+ knowledge_processor_output_invalid: "knowledge_processor_output_invalid";
1373
+ knowledge_conversion_timeout: "knowledge_conversion_timeout";
1374
+ }>]>>;
1375
+ documentId: z.ZodOptional<z.ZodString>;
1376
+ originLink: z.ZodOptional<z.ZodString>;
1377
+ changedAt: z.ZodString;
1378
+ }, z.core.$strict>>;
1379
+ nextCursor: z.ZodOptional<z.ZodString>;
1380
+ }, z.core.$strict>;
1381
+ type KnowledgeSourceItemsOutput = z.infer<typeof knowledgeSourceItemsOutputSchema>;
1382
+ /**
1383
+ * KB-5c's retry, widened: documents by id, or items of a source by id, by failure code or all
1384
+ * failed ones. A failed fetch is fetched again; a failed document of a synced source is
1385
+ * fetched and indexed again, because its original is not kept.
1386
+ */
1387
+ declare const knowledgeRetryInputSchema: z.ZodUnion<readonly [z.ZodObject<{
1388
+ documentIds: z.ZodArray<z.ZodString>;
1389
+ }, z.core.$strict>, z.ZodObject<{
1390
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
1391
+ sourceItemIds: z.ZodArray<z.ZodString>;
1392
+ }, z.core.$strict>, z.ZodObject<{
1393
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
1394
+ failureCode: z.ZodUnion<readonly [z.ZodEnum<{
1395
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1396
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1397
+ knowledge_source_unreachable: "knowledge_source_unreachable";
1398
+ knowledge_source_refused: "knowledge_source_refused";
1399
+ knowledge_fetch_failed: "knowledge_fetch_failed";
1400
+ knowledge_source_limit_reached: "knowledge_source_limit_reached";
1401
+ knowledge_item_invalid: "knowledge_item_invalid";
1402
+ knowledge_fetch_not_allowed: "knowledge_fetch_not_allowed";
1403
+ knowledge_ingest_cancelled: "knowledge_ingest_cancelled";
1404
+ knowledge_item_removed: "knowledge_item_removed";
1405
+ }>, z.ZodEnum<{
1406
+ knowledge_file_format_unsupported: "knowledge_file_format_unsupported";
1407
+ knowledge_file_over_limit: "knowledge_file_over_limit";
1408
+ knowledge_file_unreadable: "knowledge_file_unreadable";
1409
+ knowledge_file_missing: "knowledge_file_missing";
1410
+ knowledge_extraction_failed: "knowledge_extraction_failed";
1411
+ knowledge_file_format_unavailable: "knowledge_file_format_unavailable";
1412
+ knowledge_text_unreadable: "knowledge_text_unreadable";
1413
+ knowledge_text_empty: "knowledge_text_empty";
1414
+ knowledge_index_failed: "knowledge_index_failed";
1415
+ knowledge_file_too_many_pages: "knowledge_file_too_many_pages";
1416
+ knowledge_processor_output_invalid: "knowledge_processor_output_invalid";
1417
+ knowledge_conversion_timeout: "knowledge_conversion_timeout";
1418
+ }>]>;
1419
+ }, z.core.$strict>, z.ZodObject<{
1420
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
1421
+ all: z.ZodLiteral<true>;
1422
+ }, z.core.$strict>]>;
1423
+ type KnowledgeRetryInput = z.infer<typeof knowledgeRetryInputSchema>;
1424
+ declare const knowledgeRetryOutputSchema: z.ZodObject<{
1425
+ documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
1426
+ id: z.ZodString;
1427
+ state: z.ZodEnum<{
1428
+ failed: "failed";
1429
+ pending: "pending";
1430
+ indexed: "indexed";
1431
+ }>;
1432
+ }, z.core.$strict>>>;
1433
+ queued: z.ZodNumber;
1434
+ released: z.ZodOptional<z.ZodNumber>;
1435
+ }, z.core.$strict>;
1436
+ type KnowledgeRetryOutput = z.infer<typeof knowledgeRetryOutputSchema>;
1437
+ declare const knowledgeLocateInputSchema: z.ZodObject<{
1438
+ sourceItemId: z.ZodString;
1439
+ }, z.core.$strict>;
1440
+ type KnowledgeLocateInput = z.infer<typeof knowledgeLocateInputSchema>;
1441
+ /** An item's state and times, and no content, name or path. */
1442
+ declare const knowledgeLocateOutputSchema: z.ZodObject<{
1443
+ sourceItemId: z.ZodString;
1444
+ source: z.ZodString;
1445
+ itemId: z.ZodString;
1446
+ state: z.ZodEnum<{
1447
+ failed: "failed";
1448
+ withdrawn: "withdrawn";
1449
+ indexed: "indexed";
1450
+ discovered: "discovered";
1451
+ fetched: "fetched";
1452
+ }>;
1453
+ discoveredAt: z.ZodString;
1454
+ fetchedAt: z.ZodOptional<z.ZodString>;
1455
+ withdrawnAt: z.ZodOptional<z.ZodString>;
1456
+ purgedAt: z.ZodOptional<z.ZodString>;
1457
+ removedAt: z.ZodOptional<z.ZodString>;
1458
+ }, z.core.$strict>;
1459
+ type KnowledgeLocateOutput = z.infer<typeof knowledgeLocateOutputSchema>;
1460
+ /**
1461
+ * The delete question of a Workflow (KBW-2c): the Knowledge Bases its source feeds, each with
1462
+ * how many documents it holds there, which a delete withdraws. Those the reader may not open are
1463
+ * counted only, by number of Knowledge Bases and documents, and never named.
1464
+ */
1465
+ declare const knowledgeWorkflowSourcesOutputSchema: z.ZodObject<{
1466
+ knowledgeBases: z.ZodArray<z.ZodObject<{
1467
+ name: z.ZodString;
1468
+ title: z.ZodString;
1469
+ documents: z.ZodNumber;
1470
+ }, z.core.$strict>>;
1471
+ hidden: z.ZodObject<{
1472
+ knowledgeBases: z.ZodNumber;
1473
+ documents: z.ZodNumber;
1474
+ }, z.core.$strict>;
1475
+ }, z.core.$strict>;
1476
+ type KnowledgeWorkflowSourcesOutput = z.infer<typeof knowledgeWorkflowSourcesOutputSchema>;
1477
+
1478
+ /** Dataset checkpoints exposed in Workflow metadata; rows remain in object storage. */
1479
+ declare const WORKFLOW_DATASET_STATES: readonly ["writing", "complete", "deleted"];
1480
+ type WorkflowDatasetState = (typeof WORKFLOW_DATASET_STATES)[number];
1481
+
1482
+ /** The reference kept in step data; rows live in the owning run's dataset. */
1483
+ declare const workflowDatasetReferenceSchema: z.ZodObject<{
1484
+ $dataset: z.ZodString;
1485
+ rowCount: z.ZodNumber;
1486
+ bytes: z.ZodNumber;
1487
+ offset: z.ZodOptional<z.ZodNumber>;
1488
+ }, z.core.$strict>;
1489
+ /** One row of a batch's failures dataset, preserving the input item for a retry. */
1490
+ declare const operationBatchFailureSchema: z.ZodObject<{
1491
+ item: z.ZodJSONSchema;
1492
+ code: z.ZodString;
1493
+ message: z.ZodString;
1494
+ }, z.core.$strict>;
1495
+ /** One failed item never fails the call or its neighbours. */
1496
+ declare const operationBatchResultSchema: z.ZodObject<{
1497
+ done: z.ZodNumber;
1498
+ failed: z.ZodNumber;
1499
+ failures: z.ZodObject<{
1500
+ $dataset: z.ZodString;
1501
+ rowCount: z.ZodNumber;
1502
+ bytes: z.ZodNumber;
1503
+ offset: z.ZodOptional<z.ZodNumber>;
1504
+ }, z.core.$strict>;
1505
+ }, z.core.$strict>;
1506
+ type OperationBatchResult = z.infer<typeof operationBatchResultSchema>;
1507
+ type OperationBatchFailure = z.infer<typeof operationBatchFailureSchema>;
1508
+
1509
+ /** Reserved until CONN-DL: the Workflow's account must be allowed to use this Connection. */
1510
+ declare const knowledgeIngestFetchSchema: z.ZodObject<{
1511
+ connection: z.ZodString;
1512
+ operation: z.ZodString;
1513
+ input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1514
+ }, z.core.$strict>;
1515
+ /** Exactly one content, in both the TypeScript type and the runtime schema. */
1516
+ declare const knowledgeIngestItemSchema: z.ZodUnion<readonly [z.ZodObject<{
1517
+ itemId: z.ZodString;
1518
+ version: z.ZodString;
1519
+ name: z.ZodString;
1520
+ path: z.ZodOptional<z.ZodString>;
1521
+ originLink: z.ZodOptional<z.ZodURL>;
1522
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1523
+ fileId: z.ZodOptional<z.ZodNever>;
1524
+ fetch: z.ZodOptional<z.ZodNever>;
1525
+ text: z.ZodString;
1526
+ }, z.core.$strict>, z.ZodObject<{
1527
+ itemId: z.ZodString;
1528
+ version: z.ZodString;
1529
+ name: z.ZodString;
1530
+ path: z.ZodOptional<z.ZodString>;
1531
+ originLink: z.ZodOptional<z.ZodURL>;
1532
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1533
+ text: z.ZodOptional<z.ZodNever>;
1534
+ fetch: z.ZodOptional<z.ZodNever>;
1535
+ fileId: z.ZodString;
1536
+ }, z.core.$strict>, z.ZodObject<{
1537
+ itemId: z.ZodString;
1538
+ version: z.ZodString;
1539
+ name: z.ZodString;
1540
+ path: z.ZodOptional<z.ZodString>;
1541
+ originLink: z.ZodOptional<z.ZodURL>;
1542
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1543
+ text: z.ZodOptional<z.ZodNever>;
1544
+ fileId: z.ZodOptional<z.ZodNever>;
1545
+ fetch: z.ZodObject<{
1546
+ connection: z.ZodString;
1547
+ operation: z.ZodString;
1548
+ input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1549
+ }, z.core.$strict>;
1550
+ }, z.core.$strict>]>;
1551
+ type KnowledgeIngestItem = z.infer<typeof knowledgeIngestItemSchema>;
1552
+ declare const knowledgeIngestInputSchema: z.ZodUnion<readonly [z.ZodObject<{
1553
+ items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1554
+ itemId: z.ZodString;
1555
+ version: z.ZodString;
1556
+ name: z.ZodString;
1557
+ path: z.ZodOptional<z.ZodString>;
1558
+ originLink: z.ZodOptional<z.ZodURL>;
1559
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1560
+ fileId: z.ZodOptional<z.ZodNever>;
1561
+ fetch: z.ZodOptional<z.ZodNever>;
1562
+ text: z.ZodString;
1563
+ }, z.core.$strict>, z.ZodObject<{
1564
+ itemId: z.ZodString;
1565
+ version: z.ZodString;
1566
+ name: z.ZodString;
1567
+ path: z.ZodOptional<z.ZodString>;
1568
+ originLink: z.ZodOptional<z.ZodURL>;
1569
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1570
+ text: z.ZodOptional<z.ZodNever>;
1571
+ fetch: z.ZodOptional<z.ZodNever>;
1572
+ fileId: z.ZodString;
1573
+ }, z.core.$strict>, z.ZodObject<{
1574
+ itemId: z.ZodString;
1575
+ version: z.ZodString;
1576
+ name: z.ZodString;
1577
+ path: z.ZodOptional<z.ZodString>;
1578
+ originLink: z.ZodOptional<z.ZodURL>;
1579
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1580
+ text: z.ZodOptional<z.ZodNever>;
1581
+ fileId: z.ZodOptional<z.ZodNever>;
1582
+ fetch: z.ZodObject<{
1583
+ connection: z.ZodString;
1584
+ operation: z.ZodString;
1585
+ input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1586
+ }, z.core.$strict>;
1587
+ }, z.core.$strict>]>>;
1588
+ complete: z.ZodOptional<z.ZodBoolean>;
1589
+ }, z.core.$strict>, z.ZodObject<{
1590
+ dataset: z.ZodObject<{
1591
+ $dataset: z.ZodString;
1592
+ rowCount: z.ZodNumber;
1593
+ bytes: z.ZodNumber;
1594
+ offset: z.ZodOptional<z.ZodNumber>;
1595
+ }, z.core.$strict>;
1596
+ complete: z.ZodOptional<z.ZodBoolean>;
1597
+ }, z.core.$strict>]>;
1598
+ declare const knowledgeIngestOutputSchema: z.ZodObject<{
1599
+ done: z.ZodNumber;
1600
+ failed: z.ZodNumber;
1601
+ failures: z.ZodObject<{
1602
+ $dataset: z.ZodString;
1603
+ rowCount: z.ZodNumber;
1604
+ bytes: z.ZodNumber;
1605
+ offset: z.ZodOptional<z.ZodNumber>;
1606
+ }, z.core.$strict>;
1607
+ accepted: z.ZodNumber;
1608
+ withdrawn: z.ZodNumber;
1609
+ }, z.core.$strict>;
1610
+ declare const knowledgeWithdrawInputSchema: z.ZodObject<{
1611
+ itemIds: z.ZodArray<z.ZodString>;
1612
+ }, z.core.$strict>;
1613
+ declare const knowledgeWithdrawOutputSchema: z.ZodObject<{
1614
+ withdrawn: z.ZodNumber;
1615
+ }, z.core.$strict>;
1616
+ declare const knowledgePendingInputSchema: z.ZodObject<{
1617
+ type: z.ZodOptional<z.ZodString>;
1618
+ since: z.ZodOptional<z.ZodISODateTime>;
1619
+ limit: z.ZodNumber;
1620
+ }, z.core.$strict>;
1621
+ declare const knowledgePendingRowSchema: z.ZodObject<{
1622
+ id: z.ZodString;
1623
+ type: z.ZodString;
1624
+ contentHash: z.ZodString;
1625
+ pages: z.ZodObject<{
1626
+ $dataset: z.ZodString;
1627
+ rowCount: z.ZodNumber;
1628
+ bytes: z.ZodNumber;
1629
+ offset: z.ZodOptional<z.ZodNumber>;
1630
+ }, z.core.$strict>;
1631
+ }, z.core.$strict>;
1632
+ declare const knowledgePendingOutputSchema: z.ZodObject<{
1633
+ documents: z.ZodObject<{
1634
+ $dataset: z.ZodString;
1635
+ rowCount: z.ZodNumber;
1636
+ bytes: z.ZodNumber;
1637
+ offset: z.ZodOptional<z.ZodNumber>;
1638
+ }, z.core.$strict>;
1639
+ }, z.core.$strict>;
1640
+ /**
1641
+ * A processor returns logical documents and page text (tables as Markdown), optional
1642
+ * section boundaries and fields. Chunking and vectors remain the platform's. This is the
1643
+ * single validator for built-ins and Workflow write-back; every refusal has the code
1644
+ * knowledge_processor_output_invalid. Fields' declared JSON Schema is checked by PROC-1.
1645
+ */
1646
+ declare const knowledgeProcessorOutputSchema: z.ZodObject<{
1647
+ documents: z.ZodArray<z.ZodObject<{
1648
+ pageFrom: z.ZodNumber;
1649
+ pageTo: z.ZodNumber;
1650
+ }, z.core.$strict>>;
1651
+ sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
1652
+ pageFrom: z.ZodNumber;
1653
+ pageTo: z.ZodNumber;
1654
+ title: z.ZodString;
1655
+ }, z.core.$strict>>>;
1656
+ fields: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1657
+ pages: z.ZodArray<z.ZodObject<{
1658
+ page: z.ZodNumber;
1659
+ text: z.ZodString;
1660
+ }, z.core.$strict>>;
1661
+ }, z.core.$strict>;
1662
+ type KnowledgeProcessorOutput = z.infer<typeof knowledgeProcessorOutputSchema>;
1663
+ declare const knowledgePutProcessedInputSchema: z.ZodObject<{
1664
+ items: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
1665
+ documentId: z.ZodString;
1666
+ contentHash: z.ZodString;
1667
+ workflowRevision: z.ZodString;
1668
+ output: z.ZodObject<{
1669
+ documents: z.ZodArray<z.ZodObject<{
1670
+ pageFrom: z.ZodNumber;
1671
+ pageTo: z.ZodNumber;
1672
+ }, z.core.$strict>>;
1673
+ sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
1674
+ pageFrom: z.ZodNumber;
1675
+ pageTo: z.ZodNumber;
1676
+ title: z.ZodString;
1677
+ }, z.core.$strict>>>;
1678
+ fields: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1679
+ pages: z.ZodObject<{
1680
+ $dataset: z.ZodString;
1681
+ rowCount: z.ZodNumber;
1682
+ bytes: z.ZodNumber;
1683
+ offset: z.ZodOptional<z.ZodNumber>;
1684
+ }, z.core.$strict>;
1685
+ }, z.core.$strict>;
1686
+ }, z.core.$strict>>, z.ZodObject<{
1687
+ $dataset: z.ZodString;
1688
+ rowCount: z.ZodNumber;
1689
+ bytes: z.ZodNumber;
1690
+ offset: z.ZodOptional<z.ZodNumber>;
1691
+ }, z.core.$strict>]>;
1692
+ }, z.core.$strict>;
1693
+ declare const knowledgeFieldValueSchema: z.ZodJSONSchema;
1694
+ declare const knowledgeExtractFieldsInputSchema: z.ZodObject<{
1695
+ documentId: z.ZodString;
1696
+ schema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1697
+ }, z.core.$strict>;
1698
+ declare const knowledgeExtractFieldsOutputSchema: z.ZodObject<{
1699
+ droppedFields: z.ZodOptional<z.ZodNumber>;
1700
+ failedFields: z.ZodOptional<z.ZodNumber>;
1701
+ path: z.ZodString;
1702
+ date: z.ZodNullable<z.ZodISODate>;
1703
+ type: z.ZodString;
1704
+ fields: z.ZodRecord<z.ZodString, z.ZodObject<{
1705
+ value: z.ZodJSONSchema;
1706
+ page: z.ZodNumber;
1707
+ quote: z.ZodString;
1708
+ }, z.core.$strict>>;
1709
+ }, z.core.$strict>;
1710
+ /** Created by the first ingest, never authored in kb.yaml; the id cannot collide with a connector source. */
1711
+ declare const knowledgeWorkflowSourceSchema: z.ZodObject<{
1712
+ id: z.ZodString;
1713
+ kind: z.ZodLiteral<"workflow">;
1714
+ workflowId: z.ZodString;
1715
+ }, z.core.$strict>;
1716
+ type KnowledgeWorkflowSource = z.infer<typeof knowledgeWorkflowSourceSchema>;
1717
+ /** Contract inventory; completion, batch and dataset are present only where the table declares them. */
1718
+ declare const knowledgeWriteContracts: {
1719
+ readonly ingest: {
1720
+ readonly description: "Ingest items or a dataset into the calling data Workflow's source; complete promises a full pass, withdrawn only after the run succeeds.";
1721
+ readonly inputSchema: z.ZodUnion<readonly [z.ZodObject<{
1722
+ items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1723
+ itemId: z.ZodString;
1724
+ version: z.ZodString;
1725
+ name: z.ZodString;
1726
+ path: z.ZodOptional<z.ZodString>;
1727
+ originLink: z.ZodOptional<z.ZodURL>;
1728
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1729
+ fileId: z.ZodOptional<z.ZodNever>;
1730
+ fetch: z.ZodOptional<z.ZodNever>;
1731
+ text: z.ZodString;
1732
+ }, z.core.$strict>, z.ZodObject<{
1733
+ itemId: z.ZodString;
1734
+ version: z.ZodString;
1735
+ name: z.ZodString;
1736
+ path: z.ZodOptional<z.ZodString>;
1737
+ originLink: z.ZodOptional<z.ZodURL>;
1738
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1739
+ text: z.ZodOptional<z.ZodNever>;
1740
+ fetch: z.ZodOptional<z.ZodNever>;
1741
+ fileId: z.ZodString;
1742
+ }, z.core.$strict>, z.ZodObject<{
1743
+ itemId: z.ZodString;
1744
+ version: z.ZodString;
1745
+ name: z.ZodString;
1746
+ path: z.ZodOptional<z.ZodString>;
1747
+ originLink: z.ZodOptional<z.ZodURL>;
1748
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
1749
+ text: z.ZodOptional<z.ZodNever>;
1750
+ fileId: z.ZodOptional<z.ZodNever>;
1751
+ fetch: z.ZodObject<{
1752
+ connection: z.ZodString;
1753
+ operation: z.ZodString;
1754
+ input: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1755
+ }, z.core.$strict>;
1756
+ }, z.core.$strict>]>>;
1757
+ complete: z.ZodOptional<z.ZodBoolean>;
1758
+ }, z.core.$strict>, z.ZodObject<{
1759
+ dataset: z.ZodObject<{
1760
+ $dataset: z.ZodString;
1761
+ rowCount: z.ZodNumber;
1762
+ bytes: z.ZodNumber;
1763
+ offset: z.ZodOptional<z.ZodNumber>;
1764
+ }, z.core.$strict>;
1765
+ complete: z.ZodOptional<z.ZodBoolean>;
1766
+ }, z.core.$strict>]>;
1767
+ readonly outputSchema: z.ZodObject<{
1768
+ done: z.ZodNumber;
1769
+ failed: z.ZodNumber;
1770
+ failures: z.ZodObject<{
1771
+ $dataset: z.ZodString;
1772
+ rowCount: z.ZodNumber;
1773
+ bytes: z.ZodNumber;
1774
+ offset: z.ZodOptional<z.ZodNumber>;
1775
+ }, z.core.$strict>;
1776
+ accepted: z.ZodNumber;
1777
+ withdrawn: z.ZodNumber;
1778
+ }, z.core.$strict>;
1779
+ readonly effect: "changing";
1780
+ readonly right: "knowledge_base.ingest";
1781
+ readonly keyLevel: "write";
1782
+ readonly completion: "async";
1783
+ readonly batch: true;
1784
+ };
1785
+ readonly withdraw: {
1786
+ readonly description: "Withdraw item ids from the calling Workflow's source; removed from search immediately.";
1787
+ readonly inputSchema: z.ZodObject<{
1788
+ itemIds: z.ZodArray<z.ZodString>;
1789
+ }, z.core.$strict>;
1790
+ readonly outputSchema: z.ZodObject<{
1791
+ withdrawn: z.ZodNumber;
1792
+ }, z.core.$strict>;
1793
+ readonly effect: "changing";
1794
+ readonly right: "knowledge_base.ingest";
1795
+ readonly keyLevel: "write";
1796
+ };
1797
+ readonly pending: {
1798
+ readonly description: "Pull pending documents by type and time as a dataset; page text is another dataset reference.";
1799
+ readonly inputSchema: z.ZodObject<{
1800
+ type: z.ZodOptional<z.ZodString>;
1801
+ since: z.ZodOptional<z.ZodISODateTime>;
1802
+ limit: z.ZodNumber;
1803
+ }, z.core.$strict>;
1804
+ readonly outputSchema: z.ZodObject<{
1805
+ documents: z.ZodObject<{
1806
+ $dataset: z.ZodString;
1807
+ rowCount: z.ZodNumber;
1808
+ bytes: z.ZodNumber;
1809
+ offset: z.ZodOptional<z.ZodNumber>;
1810
+ }, z.core.$strict>;
1811
+ }, z.core.$strict>;
1812
+ readonly rowSchema: z.ZodObject<{
1813
+ id: z.ZodString;
1814
+ type: z.ZodString;
1815
+ contentHash: z.ZodString;
1816
+ pages: z.ZodObject<{
1817
+ $dataset: z.ZodString;
1818
+ rowCount: z.ZodNumber;
1819
+ bytes: z.ZodNumber;
1820
+ offset: z.ZodOptional<z.ZodNumber>;
1821
+ }, z.core.$strict>;
1822
+ }, z.core.$strict>;
1823
+ readonly effect: "reading";
1824
+ readonly right: "knowledge_base.read";
1825
+ readonly keyLevel: "read";
1826
+ readonly dataset: true;
1827
+ };
1828
+ readonly put_processed: {
1829
+ readonly description: "Write processor output by document, content hash and Workflow revision, with pages as a dataset reference like pending; the platform validates, chunks and indexes it, with per-item outcomes.";
1830
+ readonly inputSchema: z.ZodObject<{
1831
+ items: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
1832
+ documentId: z.ZodString;
1833
+ contentHash: z.ZodString;
1834
+ workflowRevision: z.ZodString;
1835
+ output: z.ZodObject<{
1836
+ documents: z.ZodArray<z.ZodObject<{
1837
+ pageFrom: z.ZodNumber;
1838
+ pageTo: z.ZodNumber;
1839
+ }, z.core.$strict>>;
1840
+ sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
1841
+ pageFrom: z.ZodNumber;
1842
+ pageTo: z.ZodNumber;
1843
+ title: z.ZodString;
1844
+ }, z.core.$strict>>>;
1845
+ fields: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1846
+ pages: z.ZodObject<{
1847
+ $dataset: z.ZodString;
1848
+ rowCount: z.ZodNumber;
1849
+ bytes: z.ZodNumber;
1850
+ offset: z.ZodOptional<z.ZodNumber>;
1851
+ }, z.core.$strict>;
1852
+ }, z.core.$strict>;
1853
+ }, z.core.$strict>>, z.ZodObject<{
1854
+ $dataset: z.ZodString;
1855
+ rowCount: z.ZodNumber;
1856
+ bytes: z.ZodNumber;
1857
+ offset: z.ZodOptional<z.ZodNumber>;
1858
+ }, z.core.$strict>]>;
1859
+ }, z.core.$strict>;
1860
+ readonly outputSchema: z.ZodObject<{
1861
+ done: z.ZodNumber;
1862
+ failed: z.ZodNumber;
1863
+ failures: z.ZodObject<{
1864
+ $dataset: z.ZodString;
1865
+ rowCount: z.ZodNumber;
1866
+ bytes: z.ZodNumber;
1867
+ offset: z.ZodOptional<z.ZodNumber>;
1868
+ }, z.core.$strict>;
1869
+ }, z.core.$strict>;
1870
+ readonly effect: "changing";
1871
+ readonly right: "knowledge_base.ingest";
1872
+ readonly keyLevel: "write";
1873
+ readonly batch: true;
1874
+ };
1875
+ readonly extract_fields: {
1876
+ readonly description: "Extract fields by schema through the approved model binding within the Knowledge Base budget; each value carries page and quote evidence.";
1877
+ readonly inputSchema: z.ZodObject<{
1878
+ documentId: z.ZodString;
1879
+ schema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
1880
+ }, z.core.$strict>;
1881
+ readonly outputSchema: z.ZodObject<{
1882
+ droppedFields: z.ZodOptional<z.ZodNumber>;
1883
+ failedFields: z.ZodOptional<z.ZodNumber>;
1884
+ path: z.ZodString;
1885
+ date: z.ZodNullable<z.ZodISODate>;
1886
+ type: z.ZodString;
1887
+ fields: z.ZodRecord<z.ZodString, z.ZodObject<{
1888
+ value: z.ZodJSONSchema;
1889
+ page: z.ZodNumber;
1890
+ quote: z.ZodString;
1891
+ }, z.core.$strict>>;
1892
+ }, z.core.$strict>;
1893
+ readonly effect: "reading";
1894
+ readonly right: "knowledge_base.read";
1895
+ readonly keyLevel: "read";
1896
+ };
1897
+ };
1898
+ /** Records rules belong to the Data Store; kb.yaml must never hold them. */
1899
+ declare const knowledgeRecordsRefusalSchema: z.ZodOptional<z.ZodNever>;
1900
+ type KnowledgeIngestInput = z.infer<typeof knowledgeIngestInputSchema>;
1901
+ type KnowledgeIngestOutput = z.infer<typeof knowledgeIngestOutputSchema>;
1902
+ type KnowledgeIngestFetch = z.infer<typeof knowledgeIngestFetchSchema>;
1903
+ type KnowledgeWithdrawInput = z.infer<typeof knowledgeWithdrawInputSchema>;
1904
+ type KnowledgeWithdrawOutput = z.infer<typeof knowledgeWithdrawOutputSchema>;
1905
+ type KnowledgePendingInput = z.infer<typeof knowledgePendingInputSchema>;
1906
+ type KnowledgePendingRow = z.infer<typeof knowledgePendingRowSchema>;
1907
+ type KnowledgePendingOutput = z.infer<typeof knowledgePendingOutputSchema>;
1908
+ type KnowledgePutProcessedInput = z.infer<typeof knowledgePutProcessedInputSchema>;
1909
+ type KnowledgeExtractFieldsInput = z.infer<typeof knowledgeExtractFieldsInputSchema>;
1910
+ type KnowledgeExtractFieldsOutput = z.infer<typeof knowledgeExtractFieldsOutputSchema>;
1911
+
1912
+ /** Paging settings shared by accepted Connections and their API view. */
1913
+ declare const operationPagingSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1914
+ by: z.ZodEnum<{
1915
+ page: "page";
1916
+ offset: "offset";
1917
+ }>;
1918
+ param: z.ZodString;
1919
+ sizeParam: z.ZodString;
1920
+ size: z.ZodNumber;
1921
+ start: z.ZodOptional<z.ZodNumber>;
1922
+ }, z.core.$strict>, z.ZodObject<{
1923
+ by: z.ZodEnum<{
1924
+ cursor: "cursor";
1925
+ next_link: "next_link";
1926
+ }>;
1927
+ param: z.ZodString;
1928
+ cursor: z.ZodString;
1929
+ }, z.core.$strict>], "by">;
1930
+ type OperationPaging = z.infer<typeof operationPagingSchema>;
1931
+
1932
+ /** Published data Workflows that fill or process an asset, with unreadable names withheld. */
1933
+ declare const workflowDataFlowsSchema: z.ZodObject<{
1934
+ fills: z.ZodArray<z.ZodObject<{
1935
+ id: z.ZodString;
1936
+ name: z.ZodString;
1937
+ title: z.ZodString;
1938
+ }, z.core.$strip>>;
1939
+ processes: z.ZodArray<z.ZodObject<{
1940
+ id: z.ZodString;
1941
+ name: z.ZodString;
1942
+ title: z.ZodString;
1943
+ }, z.core.$strip>>;
1944
+ hidden: z.ZodObject<{
1945
+ fills: z.ZodNumber;
1946
+ processes: z.ZodNumber;
1947
+ }, z.core.$strip>;
1948
+ truncated: z.ZodBoolean;
1949
+ }, z.core.$strip>;
1950
+
1951
+ declare const RECORDS_PROPOSE_MAX_ITEMS_PER_CALL = 1000;
1952
+ declare const RECORDS_PROPOSE_MAX_FIELDS_PER_ITEM = 1000;
1953
+ declare const RECORDS_FLAGGED_MAX_ITEMS_PER_PAGE = 10000;
1954
+ declare const dataStoreRecordsRuleSchema: z.ZodObject<{
1955
+ table: z.ZodString;
1956
+ key: z.ZodUnion<readonly [z.ZodObject<{
1957
+ column: z.ZodString;
1958
+ fromPath: z.ZodString;
1959
+ }, z.core.$strict>, z.ZodObject<{
1960
+ column: z.ZodString;
1961
+ fromField: z.ZodString;
1962
+ }, z.core.$strict>]>;
1963
+ precedence: z.ZodDefault<z.ZodArray<z.ZodString>>;
1964
+ review: z.ZodPrefault<z.ZodObject<{
1965
+ always: z.ZodDefault<z.ZodArray<z.ZodString>>;
1966
+ }, z.core.$strict>>;
1967
+ retainWithoutSource: z.ZodDefault<z.ZodBoolean>;
1968
+ }, z.core.$strict>;
1969
+ type DataStoreRecordsRule = z.infer<typeof dataStoreRecordsRuleSchema>;
1970
+ /** A necessary condition, never a model confidence score or proof of correctness. */
1971
+ declare const recordEvidenceResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1972
+ status: z.ZodLiteral<"passed">;
1973
+ }, z.core.$strict>, z.ZodObject<{
1974
+ status: z.ZodLiteral<"failed">;
1975
+ reason: z.ZodEnum<{
1976
+ page_not_found: "page_not_found";
1977
+ quote_not_found: "quote_not_found";
1978
+ value_not_parsed: "value_not_parsed";
1979
+ }>;
1980
+ }, z.core.$strict>], "status">;
1981
+ type RecordEvidenceResult = z.infer<typeof recordEvidenceResultSchema>;
1982
+ declare const RECORD_FIELD_STATES: readonly ["extracted", "confirmed", "corrected", "conflict"];
1983
+ /** Why a field waits for a person in "Prüfen". */
1984
+ declare const RECORD_FLAG_REASONS: readonly ["conflict", "not_evidenced", "confirmation_required", "key_unresolved"];
1985
+ declare const RECORD_FIELD_FAILURE_CODES: readonly ["record_field_unknown"];
1986
+ declare const dataStoreRecordProposalItemSchema: z.ZodObject<{
1987
+ knowledgeBaseId: z.ZodString;
1988
+ documentId: z.ZodString;
1989
+ kind: z.ZodString;
1990
+ documentDate: z.ZodNullable<z.ZodISODate>;
1991
+ path: z.ZodOptional<z.ZodString>;
1992
+ fields: z.ZodArray<z.ZodObject<{
1993
+ value: z.ZodJSONSchema;
1994
+ page: z.ZodNumber;
1995
+ quote: z.ZodString;
1996
+ name: z.ZodString;
1997
+ }, z.core.$strict>>;
1998
+ }, z.core.$strict>;
1999
+ type DataStoreRecordProposalItem = z.infer<typeof dataStoreRecordProposalItemSchema>;
2000
+ declare const dataStoreRecordsProposeInputSchema: z.ZodObject<{
2001
+ table: z.ZodString;
2002
+ items: z.ZodArray<z.ZodObject<{
2003
+ knowledgeBaseId: z.ZodString;
2004
+ documentId: z.ZodString;
2005
+ kind: z.ZodString;
2006
+ documentDate: z.ZodNullable<z.ZodISODate>;
2007
+ path: z.ZodOptional<z.ZodString>;
2008
+ fields: z.ZodArray<z.ZodObject<{
2009
+ value: z.ZodJSONSchema;
2010
+ page: z.ZodNumber;
2011
+ quote: z.ZodString;
2012
+ name: z.ZodString;
2013
+ }, z.core.$strict>>;
2014
+ }, z.core.$strict>>;
2015
+ }, z.core.$strict>;
2016
+ type DataStoreRecordsProposeInput = z.infer<typeof dataStoreRecordsProposeInputSchema>;
2017
+ declare const dataStoreRecordsDecideInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2018
+ table: z.ZodString;
2019
+ key: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
2020
+ field: z.ZodString;
2021
+ documentId: z.ZodOptional<z.ZodString>;
2022
+ knowledgeBaseId: z.ZodOptional<z.ZodString>;
2023
+ action: z.ZodLiteral<"confirm">;
2024
+ }, z.core.$strict>, z.ZodObject<{
2025
+ table: z.ZodString;
2026
+ key: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
2027
+ field: z.ZodString;
2028
+ documentId: z.ZodOptional<z.ZodString>;
2029
+ knowledgeBaseId: z.ZodOptional<z.ZodString>;
2030
+ action: z.ZodLiteral<"correct">;
2031
+ value: z.ZodJSONSchema;
2032
+ }, z.core.$strict>, z.ZodObject<{
2033
+ table: z.ZodString;
2034
+ key: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
2035
+ field: z.ZodString;
2036
+ action: z.ZodLiteral<"assign">;
2037
+ documentId: z.ZodString;
2038
+ knowledgeBaseId: z.ZodString;
2039
+ }, z.core.$strict>], "action">;
2040
+ type DataStoreRecordsDecideInput = z.infer<typeof dataStoreRecordsDecideInputSchema>;
2041
+ declare const dataStoreRecordsDecideOutputSchema: z.ZodObject<{
2042
+ decided: z.ZodLiteral<true>;
2043
+ }, z.core.$strict>;
2044
+ declare const dataStoreRecordsFlaggedInputSchema: z.ZodObject<{
2045
+ table: z.ZodOptional<z.ZodString>;
2046
+ cursor: z.ZodOptional<z.ZodString>;
2047
+ limit: z.ZodNumber;
2048
+ }, z.core.$strict>;
2049
+ declare const dataStoreRecordFieldSchema: z.ZodObject<{
2050
+ value: z.ZodJSONSchema;
2051
+ page: z.ZodNumber;
2052
+ quote: z.ZodString;
2053
+ name: z.ZodString;
2054
+ correctedValue: z.ZodNullable<z.ZodJSONSchema>;
2055
+ table: z.ZodString;
2056
+ key: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
2057
+ knowledgeBaseId: z.ZodString;
2058
+ documentId: z.ZodString;
2059
+ kind: z.ZodString;
2060
+ documentDate: z.ZodNullable<z.ZodISODate>;
2061
+ extractedAt: z.ZodISODateTime;
2062
+ evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
2063
+ status: z.ZodLiteral<"passed">;
2064
+ }, z.core.$strict>, z.ZodObject<{
2065
+ status: z.ZodLiteral<"failed">;
2066
+ reason: z.ZodEnum<{
2067
+ page_not_found: "page_not_found";
2068
+ quote_not_found: "quote_not_found";
2069
+ value_not_parsed: "value_not_parsed";
2070
+ }>;
2071
+ }, z.core.$strict>], "status">;
2072
+ state: z.ZodEnum<{
2073
+ confirmed: "confirmed";
2074
+ extracted: "extracted";
2075
+ corrected: "corrected";
2076
+ conflict: "conflict";
2077
+ }>;
2078
+ decidedBy: z.ZodNullable<z.ZodString>;
2079
+ decidedAt: z.ZodNullable<z.ZodISODateTime>;
2080
+ }, z.core.$strict>;
2081
+ type DataStoreRecordField = z.infer<typeof dataStoreRecordFieldSchema>;
2082
+ declare const dataStoreRecordsFlaggedOutputSchema: z.ZodObject<{
2083
+ items: z.ZodArray<z.ZodObject<{
2084
+ value: z.ZodJSONSchema;
2085
+ page: z.ZodNumber;
2086
+ quote: z.ZodString;
2087
+ name: z.ZodString;
2088
+ correctedValue: z.ZodNullable<z.ZodJSONSchema>;
2089
+ table: z.ZodString;
2090
+ key: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
2091
+ knowledgeBaseId: z.ZodString;
2092
+ documentId: z.ZodString;
2093
+ kind: z.ZodString;
2094
+ documentDate: z.ZodNullable<z.ZodISODate>;
2095
+ extractedAt: z.ZodISODateTime;
2096
+ evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
2097
+ status: z.ZodLiteral<"passed">;
2098
+ }, z.core.$strict>, z.ZodObject<{
2099
+ status: z.ZodLiteral<"failed">;
2100
+ reason: z.ZodEnum<{
2101
+ page_not_found: "page_not_found";
2102
+ quote_not_found: "quote_not_found";
2103
+ value_not_parsed: "value_not_parsed";
2104
+ }>;
2105
+ }, z.core.$strict>], "status">;
2106
+ state: z.ZodEnum<{
2107
+ confirmed: "confirmed";
2108
+ extracted: "extracted";
2109
+ corrected: "corrected";
2110
+ conflict: "conflict";
2111
+ }>;
2112
+ decidedBy: z.ZodNullable<z.ZodString>;
2113
+ decidedAt: z.ZodNullable<z.ZodISODateTime>;
2114
+ reason: z.ZodEnum<{
2115
+ conflict: "conflict";
2116
+ not_evidenced: "not_evidenced";
2117
+ confirmation_required: "confirmation_required";
2118
+ key_unresolved: "key_unresolved";
2119
+ }>;
2120
+ document: z.ZodOptional<z.ZodObject<{
2121
+ knowledgeBase: z.ZodString;
2122
+ fileName: z.ZodString;
2123
+ }, z.core.$strict>>;
2124
+ decidedByName: z.ZodOptional<z.ZodString>;
2125
+ }, z.core.$strict>>;
2126
+ nextCursor: z.ZodOptional<z.ZodString>;
2127
+ }, z.core.$strict>;
2128
+ type ColumnType = (typeof DATA_STORE_SCALAR_TYPES)[number];
2129
+ interface RecordColumn {
2130
+ name: string;
2131
+ type: ColumnType | `${ColumnType}[]` | "other";
2132
+ nullable: boolean;
2133
+ generated?: boolean;
2134
+ }
2135
+ /** Whether a column takes the value, as a proposal and a person's correction are checked. */
2136
+ declare function recordColumnTakes(column: RecordColumn, value: unknown): boolean;
2137
+ /**
2138
+ * Validate a whole item before any candidate or customer row is written. The batch writer
2139
+ * maps this refusal to record_field_unknown for that item and continues with other items.
2140
+ * Types come from the store catalog, never from the caller's extraction schema.
2141
+ */
2142
+ declare function proposalItemSchemaFor(columns: readonly RecordColumn[]): z.ZodObject<{
2143
+ knowledgeBaseId: z.ZodString;
2144
+ documentId: z.ZodString;
2145
+ kind: z.ZodString;
2146
+ documentDate: z.ZodNullable<z.ZodISODate>;
2147
+ path: z.ZodOptional<z.ZodString>;
2148
+ fields: z.ZodArray<z.ZodObject<{
2149
+ value: z.ZodJSONSchema;
2150
+ page: z.ZodNumber;
2151
+ quote: z.ZodString;
2152
+ name: z.ZodString;
2153
+ }, z.core.$strict>>;
2154
+ }, z.core.$strict>;
2155
+ /** Contracts only: REC-1a/1b/2 register the implementations, not REC-0. */
2156
+ declare const dataStoreRecordsContracts: {
2157
+ readonly propose: {
2158
+ readonly description: "Propose extracted fields with Knowledge Base/document/page/quote evidence. Validate each whole item against the published table before writing; failures are per item. Send at most 1000 items per call and 1000 fields per item; split larger work into batches. Merge by evidence precedence, then document date; unresolved keys and evidence go to review.";
2159
+ readonly inputSchema: z.ZodObject<{
2160
+ table: z.ZodString;
2161
+ items: z.ZodArray<z.ZodObject<{
2162
+ knowledgeBaseId: z.ZodString;
2163
+ documentId: z.ZodString;
2164
+ kind: z.ZodString;
2165
+ documentDate: z.ZodNullable<z.ZodISODate>;
2166
+ path: z.ZodOptional<z.ZodString>;
2167
+ fields: z.ZodArray<z.ZodObject<{
2168
+ value: z.ZodJSONSchema;
2169
+ page: z.ZodNumber;
2170
+ quote: z.ZodString;
2171
+ name: z.ZodString;
2172
+ }, z.core.$strict>>;
2173
+ }, z.core.$strict>>;
2174
+ }, z.core.$strict>;
2175
+ readonly outputSchema: z.ZodObject<{
2176
+ done: z.ZodNumber;
2177
+ failed: z.ZodNumber;
2178
+ failures: z.ZodObject<{
2179
+ $dataset: z.ZodString;
2180
+ rowCount: z.ZodNumber;
2181
+ bytes: z.ZodNumber;
2182
+ offset: z.ZodOptional<z.ZodNumber>;
2183
+ }, z.core.$strict>;
2184
+ }, z.core.$strict>;
2185
+ readonly itemSchemaFor: typeof proposalItemSchemaFor;
2186
+ readonly effect: "changing";
2187
+ readonly right: "data_store.records";
2188
+ readonly keyLevel: "write";
2189
+ readonly batch: true;
2190
+ };
2191
+ readonly decide: {
2192
+ readonly description: "Confirm or correct a field against its evidence, or assign a document to an object key. Decisions are pinned; audit table/field/action/actor only, never the value.";
2193
+ readonly inputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2194
+ table: z.ZodString;
2195
+ key: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
2196
+ field: z.ZodString;
2197
+ documentId: z.ZodOptional<z.ZodString>;
2198
+ knowledgeBaseId: z.ZodOptional<z.ZodString>;
2199
+ action: z.ZodLiteral<"confirm">;
2200
+ }, z.core.$strict>, z.ZodObject<{
2201
+ table: z.ZodString;
2202
+ key: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
2203
+ field: z.ZodString;
2204
+ documentId: z.ZodOptional<z.ZodString>;
2205
+ knowledgeBaseId: z.ZodOptional<z.ZodString>;
2206
+ action: z.ZodLiteral<"correct">;
2207
+ value: z.ZodJSONSchema;
2208
+ }, z.core.$strict>, z.ZodObject<{
2209
+ table: z.ZodString;
2210
+ key: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
2211
+ field: z.ZodString;
2212
+ action: z.ZodLiteral<"assign">;
2213
+ documentId: z.ZodString;
2214
+ knowledgeBaseId: z.ZodString;
2215
+ }, z.core.$strict>], "action">;
2216
+ readonly outputSchema: z.ZodObject<{
2217
+ decided: z.ZodLiteral<true>;
2218
+ }, z.core.$strict>;
2219
+ readonly effect: "changing";
2220
+ readonly right: "data_store.records";
2221
+ readonly keyLevel: "write";
2222
+ };
2223
+ readonly flagged: {
2224
+ readonly description: "Page through fields needing review, up to 10000 per call; pass nextCursor as cursor for the next page. Check Knowledge Base access before showing any document citation; the store right alone does not grant access to source documents.";
2225
+ readonly inputSchema: z.ZodObject<{
2226
+ table: z.ZodOptional<z.ZodString>;
2227
+ cursor: z.ZodOptional<z.ZodString>;
2228
+ limit: z.ZodNumber;
2229
+ }, z.core.$strict>;
2230
+ readonly outputSchema: z.ZodObject<{
2231
+ items: z.ZodArray<z.ZodObject<{
2232
+ value: z.ZodJSONSchema;
2233
+ page: z.ZodNumber;
2234
+ quote: z.ZodString;
2235
+ name: z.ZodString;
2236
+ correctedValue: z.ZodNullable<z.ZodJSONSchema>;
2237
+ table: z.ZodString;
2238
+ key: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
2239
+ knowledgeBaseId: z.ZodString;
2240
+ documentId: z.ZodString;
2241
+ kind: z.ZodString;
2242
+ documentDate: z.ZodNullable<z.ZodISODate>;
2243
+ extractedAt: z.ZodISODateTime;
2244
+ evidence: z.ZodDiscriminatedUnion<[z.ZodObject<{
2245
+ status: z.ZodLiteral<"passed">;
2246
+ }, z.core.$strict>, z.ZodObject<{
2247
+ status: z.ZodLiteral<"failed">;
2248
+ reason: z.ZodEnum<{
2249
+ page_not_found: "page_not_found";
2250
+ quote_not_found: "quote_not_found";
2251
+ value_not_parsed: "value_not_parsed";
2252
+ }>;
2253
+ }, z.core.$strict>], "status">;
2254
+ state: z.ZodEnum<{
2255
+ confirmed: "confirmed";
2256
+ extracted: "extracted";
2257
+ corrected: "corrected";
2258
+ conflict: "conflict";
2259
+ }>;
2260
+ decidedBy: z.ZodNullable<z.ZodString>;
2261
+ decidedAt: z.ZodNullable<z.ZodISODateTime>;
2262
+ reason: z.ZodEnum<{
2263
+ conflict: "conflict";
2264
+ not_evidenced: "not_evidenced";
2265
+ confirmation_required: "confirmation_required";
2266
+ key_unresolved: "key_unresolved";
2267
+ }>;
2268
+ document: z.ZodOptional<z.ZodObject<{
2269
+ knowledgeBase: z.ZodString;
2270
+ fileName: z.ZodString;
2271
+ }, z.core.$strict>>;
2272
+ decidedByName: z.ZodOptional<z.ZodString>;
2273
+ }, z.core.$strict>>;
2274
+ nextCursor: z.ZodOptional<z.ZodString>;
2275
+ }, z.core.$strict>;
2276
+ readonly effect: "reading";
2277
+ readonly right: "data_store.records";
2278
+ readonly keyLevel: "read";
2279
+ };
2280
+ };
2281
+ type DataStoreRecordsDecideOutput = z.infer<typeof dataStoreRecordsDecideOutputSchema>;
2282
+ type DataStoreRecordsFlaggedInput = z.infer<typeof dataStoreRecordsFlaggedInputSchema>;
2283
+ type DataStoreRecordsFlaggedOutput = z.infer<typeof dataStoreRecordsFlaggedOutputSchema>;
2284
+
2285
+ /** The UTC counter windows, metrics and scopes a model usage refusal may name. */
2286
+ declare const MODEL_USAGE_LIMIT_PERIODS: readonly ["day", "month"];
2287
+ declare const MODEL_USAGE_LIMIT_METRICS: readonly ["modelCallCount", "tokens", "costMicros"];
2288
+ declare const MODEL_USAGE_LIMIT_SCOPES: readonly ["instance", "user", "system", "workspace"];
2289
+ /**
2290
+ * Where an admin sets a spend limit (LU-2): the instance, one default for every shared
2291
+ * workspace and one for every user, and a value for one workspace or one user that replaces
2292
+ * that default.
2293
+ */
2294
+ declare const USAGE_SPEND_LIMIT_LEVELS: readonly ["instance", "workspace_default", "workspace", "user_default", "user"];
2295
+ /** The limit that refused a call: its period, what it counts, and whose counter it is. */
2296
+ interface ModelUsageRefusal {
2297
+ period: (typeof MODEL_USAGE_LIMIT_PERIODS)[number];
2298
+ metric: (typeof MODEL_USAGE_LIMIT_METRICS)[number];
2299
+ /**
2300
+ * `user`: the person's own calls. `system`: the calls the product makes for a person, or
2301
+ * those no person made. `workspace`: the calls inside one shared workspace. `instance`: the
2302
+ * spend budget everyone shares.
2303
+ */
2304
+ scope: (typeof MODEL_USAGE_LIMIT_SCOPES)[number];
2305
+ }
2306
+ /** The workspace key every Personal Workspace shares in the usage sums (LU-3): one row. */
2307
+ declare const PERSONAL_WORKSPACES_KEY = "personal";
2308
+ /** What the Breakdown of the Usage page groups by (LU-3, limits spec 3.3, view 2). */
2309
+ declare const USAGE_BREAKDOWN_DIMENSIONS: readonly ["workspace", "agent", "app", "workflow", "model", "origin"];
2310
+ /**
2311
+ * Where usage came from (limits spec 3.2): a conversation, an App, a Workflow, Knowledge Base
2312
+ * ingestion, or a call the product made for itself, such as a title or a guardrail check.
2313
+ */
2314
+ declare const USAGE_ORIGINS: readonly ["conversation", "app", "workflow", "knowledge_base", "system"];
2315
+
2316
+ /**
2317
+ * The JSON Schema `format` of a string field that takes Markdown, such as the body of
2318
+ * `mail.send`. In such a field a referenced list of strings joins as a bulleted list and a
2319
+ * list of flat records as a table, and every referenced value is escaped as Markdown text.
2320
+ */
2321
+ declare const WORKFLOW_TEXT_FORMAT_MARKDOWN = "markdown";
2322
+ /** The most parts one joined text has. */
2323
+ declare const WORKFLOW_TEXT_MAX_PARTS = 100;
2324
+ /** A referenced list in a Markdown field joins as at most this many rows; more is refused. */
2325
+ declare const WORKFLOW_MARKDOWN_MAX_ROWS = 100;
2326
+ /** A referenced list of records joins as a table of at most this many columns. */
2327
+ declare const WORKFLOW_MARKDOWN_MAX_COLUMNS = 8;
2328
+
2329
+ /** The platform operation. It exists on an instance only while `outbound.enabled` is true. */
2330
+ declare const MAIL_SEND_OPERATION = "mail.send";
2331
+ /** The resource kind of a sender. Its right is `mail_sender.use`, on one sender. */
2332
+ declare const MAIL_SENDER_RESOURCE_KIND = "mail_sender";
2333
+ declare const MAIL_SENDER_USE_ACTION = "mail_sender.use";
2334
+ /** The instance's own mailer (`infrastructure.mail`), the only sender until MAIL-M365S. */
2335
+ declare const MAIL_SENDER_SYSTEM = "system";
2336
+ /** The prefix of a Connection sender (MAIL-M365S, MAIL-M365P): `connection.<name>`. */
2337
+ declare const MAIL_SENDER_CONNECTION_PREFIX = "connection.";
2338
+ /**
2339
+ * The icon key the step shows for the system sender. An assembly may register the instance's
2340
+ * mark under it; without one the generic mail icon stands. A Connection sender shows its
2341
+ * Connection's `service` icon. The transport (Mailjet, capture, SMTP) never has an icon.
2342
+ */
2343
+ declare const MAIL_SENDER_SYSTEM_ICON = "system-mail";
2344
+ /** The template `packages/mail` renders a mail of `mail.send` in. */
2345
+ declare const MAIL_WORKFLOW_MESSAGE_TEMPLATE = "workflow-message";
2346
+ /** Addresses of one mail once `{ workspace }` recipients are expanded, over to, cc and bcc. */
2347
+ declare const MAIL_SEND_MAX_ADDRESSES = 50;
2348
+ declare const MAIL_SUBJECT_MAX_LENGTH = 200;
2349
+ declare const MAIL_BODY_MAX_BYTES: number;
2350
+ declare const MAIL_SENDER_NAME_MAX_LENGTH = 80;
2351
+ /** The longest address RFC 5321 lets through a path. */
2352
+ declare const MAIL_ADDRESS_MAX_LENGTH = 254;
2353
+ /** `infrastructure.mail.outbound.limits` unless release config sets them; only it raises them. */
2354
+ declare const MAIL_OUTBOUND_DEFAULT_LIMITS: {
2355
+ readonly perWorkflowPerHour: 200;
2356
+ readonly perInstancePerDay: 1000;
2357
+ };
2358
+ /** One language's legal footer (§ 37a HGB company details), as plain text. */
2359
+ declare const MAIL_OUTBOUND_FOOTER_MAX_LENGTH = 2000;
2360
+ /** `mail.sent` names at most this many distinct recipient domains, then counts the rest. */
2361
+ declare const MAIL_AUDIT_MAX_DOMAINS = 10;
2362
+ /** Reserved for MAIL-4: Managed Files and datasets of the run, together. */
2363
+ declare const MAIL_ATTACHMENTS_MAX_FILES = 10;
2364
+ declare const MAIL_ATTACHMENTS_MAX_BYTES: number;
2365
+ /**
2366
+ * Why `mail.send` refused or failed a mail, as `details.reason` of a VALIDATION_FAILED and as
2367
+ * the code of a failed step. None is retried.
2368
+ * - `recipient_not_allowed`: an address outside `recipientDomains` that is not a person of the
2369
+ * instance, or such a `replyTo`. `details.domain` names its domain. Nothing is sent to any
2370
+ * recipient of the mail.
2371
+ * - `no_recipient`: `to` named people or workspaces, and none of them has an address.
2372
+ * - `workspace_not_allowed`: a `{ workspace }` recipient is not a Shared Workspace the author
2373
+ * of the mail can see: they are no member of it and no instance admin (MAIL-2). The author
2374
+ * is the person who saves, publishes or tests the Workflow, or for whom an agent calls; in a
2375
+ * published run, its publisher. Nothing is sent and no member of it is named.
2376
+ * - `mail_rejected`: the provider refused the mail before accepting it. `details.providerCode`
2377
+ * holds the provider's own code; its text is never kept.
2378
+ * A transient failure is not one of these: a refused connection is retried by the step's
2379
+ * attempts, and an answer lost after the request left is `operation_interrupted`.
2380
+ */
2381
+ declare const MAIL_SEND_ERROR_CODES: {
2382
+ readonly recipientNotAllowed: "recipient_not_allowed";
2383
+ readonly noRecipient: "no_recipient";
2384
+ readonly mailRejected: "mail_rejected";
2385
+ readonly workspaceNotAllowed: "workspace_not_allowed";
2386
+ };
2387
+ type MailSendErrorCode = (typeof MAIL_SEND_ERROR_CODES)[keyof typeof MAIL_SEND_ERROR_CODES];
2388
+ declare const MAIL_SEND_REFUSAL_REASONS: readonly ["recipient_not_allowed", "no_recipient", "mail_rejected", "workspace_not_allowed"];
2389
+ /** `details` of a refused `mail.send`: the one refused domain, or the provider's code. */
2390
+ declare const mailSendRefusalDetailsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2391
+ reason: z.ZodLiteral<"recipient_not_allowed">;
2392
+ domain: z.ZodString;
2393
+ }, z.core.$strict>, z.ZodObject<{
2394
+ reason: z.ZodLiteral<"no_recipient">;
2395
+ }, z.core.$strict>, z.ZodObject<{
2396
+ reason: z.ZodLiteral<"workspace_not_allowed">;
2397
+ }, z.core.$strict>, z.ZodObject<{
2398
+ reason: z.ZodLiteral<"mail_rejected">;
2399
+ providerCode: z.ZodOptional<z.ZodString>;
2400
+ }, z.core.$strict>], "reason">;
2401
+ type MailSendRefusalDetails = z.infer<typeof mailSendRefusalDetailsSchema>;
2402
+ /** A user or workspace id, as `NOTICE_ID_PATTERN` of core reads it. */
2403
+ declare const MAIL_RECIPIENT_ID_PATTERN: RegExp;
2404
+ /** One address as written. Its domain is compared without regard to case. */
2405
+ declare const mailAddressSchema: z.ZodEmail;
2406
+ /**
2407
+ * A domain of `recipientDomains`, lowercase: `kanzlei.de` matches that domain only,
2408
+ * `*.kanzlei.de` its subdomains and not the domain itself. `*` alone admits every address.
2409
+ */
2410
+ declare const MAIL_RECIPIENT_DOMAIN_PATTERN: RegExp;
2411
+ declare const MAIL_RECIPIENT_DOMAINS_ANY = "*";
2412
+ declare const mailRecipientDomainSchema: z.ZodString;
2413
+ /**
2414
+ * Which sender the mail goes out as. `system` until MAIL-M365S; `connection.<name>` is
2415
+ * reserved and refused with `not_supported_yet`.
2416
+ */
2417
+ declare const mailSenderIdSchema: z.ZodUnion<readonly [z.ZodLiteral<"system">, z.ZodTemplateLiteral<`connection.${string}`>]>;
2418
+ type MailSenderId = typeof MAIL_SENDER_SYSTEM | `connection.${string}`;
2419
+ /**
2420
+ * One recipient of a literal list: an address, a person of the instance by id, or a workspace,
2421
+ * which stands for its members. A person or member without an address is skipped and counted.
2422
+ */
2423
+ declare const mailRecipientSchema: z.ZodUnion<readonly [z.ZodObject<{
2424
+ address: z.ZodEmail;
2425
+ }, z.core.$strict>, z.ZodObject<{
2426
+ user: z.ZodString;
2427
+ }, z.core.$strict>, z.ZodObject<{
2428
+ workspace: z.ZodString;
2429
+ }, z.core.$strict>]>;
2430
+ type MailSendRecipient = z.infer<typeof mailRecipientSchema>;
2431
+ declare const mailRecipientListSchema: z.ZodUnion<readonly [z.ZodEmail, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodUnion<readonly [z.ZodObject<{
2432
+ address: z.ZodEmail;
2433
+ }, z.core.$strict>, z.ZodObject<{
2434
+ user: z.ZodString;
2435
+ }, z.core.$strict>, z.ZodObject<{
2436
+ workspace: z.ZodString;
2437
+ }, z.core.$strict>]>, z.ZodObject<{
2438
+ email: z.ZodEmail;
2439
+ }, z.core.$loose>]>>]>;
2440
+ type MailSendRecipientList = z.infer<typeof mailRecipientListSchema>;
2441
+ /**
2442
+ * What `cc` and `bcc` take: as `to`, and an empty list too, since a referenced list of copy
2443
+ * recipients may hold nobody and the mail still goes to `to`.
2444
+ */
2445
+ declare const mailCopyRecipientListSchema: z.ZodUnion<readonly [z.ZodEmail, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodUnion<readonly [z.ZodObject<{
2446
+ address: z.ZodEmail;
2447
+ }, z.core.$strict>, z.ZodObject<{
2448
+ user: z.ZodString;
2449
+ }, z.core.$strict>, z.ZodObject<{
2450
+ workspace: z.ZodString;
2451
+ }, z.core.$strict>]>, z.ZodObject<{
2452
+ email: z.ZodEmail;
2453
+ }, z.core.$loose>]>>]>;
2454
+ /** One address, or a person of the instance. The recipient rule applies to it as to `to`. */
2455
+ declare const mailReplyToSchema: z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
2456
+ address: z.ZodEmail;
2457
+ }, z.core.$strict>, z.ZodObject<{
2458
+ user: z.ZodString;
2459
+ }, z.core.$strict>]>;
2460
+ /** One line of 1 to 200 characters with something besides spaces. */
2461
+ declare const mailSubjectSchema: z.ZodString;
2462
+ /**
2463
+ * The author's Markdown, rendered on the server: no raw HTML, no image, links over `https`,
2464
+ * `http` and `mailto` only. `format: markdown` is what makes a mapped field join lists and
2465
+ * tables (EW-TEXT) and escape every referenced value, and a field mapped as one reference show
2466
+ * each link's address after its label (MAIL-2).
2467
+ */
2468
+ declare const mailBodySchema: z.ZodString;
2469
+ /** The display name on the From line. The address stays the sender's. */
2470
+ declare const mailSenderNameSchema: z.ZodString;
2471
+ /**
2472
+ * The input of `mail.send`, as the operation reads it after a step's mapping is resolved. Each
2473
+ * field of a step's mapping takes a literal, a reference or, for the strings, text joined
2474
+ * from parts (EW-TEXT). `attachments` arrives with MAIL-4 and is refused until then.
2475
+ */
2476
+ declare const mailSendInputSchema: z.ZodObject<{
2477
+ sender: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"system">, z.ZodTemplateLiteral<`connection.${string}`>]>>;
2478
+ to: z.ZodUnion<readonly [z.ZodEmail, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodUnion<readonly [z.ZodObject<{
2479
+ address: z.ZodEmail;
2480
+ }, z.core.$strict>, z.ZodObject<{
2481
+ user: z.ZodString;
2482
+ }, z.core.$strict>, z.ZodObject<{
2483
+ workspace: z.ZodString;
2484
+ }, z.core.$strict>]>, z.ZodObject<{
2485
+ email: z.ZodEmail;
2486
+ }, z.core.$loose>]>>]>;
2487
+ cc: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodUnion<readonly [z.ZodObject<{
2488
+ address: z.ZodEmail;
2489
+ }, z.core.$strict>, z.ZodObject<{
2490
+ user: z.ZodString;
2491
+ }, z.core.$strict>, z.ZodObject<{
2492
+ workspace: z.ZodString;
2493
+ }, z.core.$strict>]>, z.ZodObject<{
2494
+ email: z.ZodEmail;
2495
+ }, z.core.$loose>]>>]>>;
2496
+ bcc: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodUnion<readonly [z.ZodObject<{
2497
+ address: z.ZodEmail;
2498
+ }, z.core.$strict>, z.ZodObject<{
2499
+ user: z.ZodString;
2500
+ }, z.core.$strict>, z.ZodObject<{
2501
+ workspace: z.ZodString;
2502
+ }, z.core.$strict>]>, z.ZodObject<{
2503
+ email: z.ZodEmail;
2504
+ }, z.core.$loose>]>>]>>;
2505
+ subject: z.ZodString;
2506
+ body: z.ZodString;
2507
+ senderName: z.ZodOptional<z.ZodString>;
2508
+ replyTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
2509
+ address: z.ZodEmail;
2510
+ }, z.core.$strict>, z.ZodObject<{
2511
+ user: z.ZodString;
2512
+ }, z.core.$strict>]>>;
2513
+ locale: z.ZodOptional<z.ZodEnum<{
2514
+ en: "en";
2515
+ de: "de";
2516
+ }>>;
2517
+ }, z.core.$strict>;
2518
+ type MailSendInput = z.infer<typeof mailSendInputSchema>;
2519
+ type MailSendInputFields = z.input<typeof mailSendInputSchema>;
2520
+ /**
2521
+ * What a live or test send answers: counts and the provider's message id, never an address.
2522
+ * `skipped` counts people and members without an address. `test` marks "Run live once",
2523
+ * which sent to the tester alone.
2524
+ */
2525
+ declare const mailSendOutputSchema: z.ZodObject<{
2526
+ sentAt: z.ZodISODateTime;
2527
+ messageId: z.ZodOptional<z.ZodString>;
2528
+ recipients: z.ZodObject<{
2529
+ to: z.ZodNumber;
2530
+ cc: z.ZodNumber;
2531
+ bcc: z.ZodNumber;
2532
+ }, z.core.$strict>;
2533
+ skipped: z.ZodNumber;
2534
+ test: z.ZodOptional<z.ZodLiteral<true>>;
2535
+ }, z.core.$strict>;
2536
+ type MailSendOutput = z.infer<typeof mailSendOutputSchema>;
2537
+ /** A recipient as a preview names it: a person by name, an address as written. */
2538
+ declare const mailPreviewRecipientSchema: z.ZodObject<{
2539
+ kind: z.ZodEnum<{
2540
+ address: "address";
2541
+ person: "person";
2542
+ }>;
2543
+ label: z.ZodString;
2544
+ }, z.core.$strict>;
2545
+ type MailPreviewRecipient = z.infer<typeof mailPreviewRecipientSchema>;
2546
+ /**
2547
+ * The mail as it would go out, checked against the recipient rule. It is step data of a test
2548
+ * run and the confirmation card's content; it is never audit data.
2549
+ */
2550
+ declare const mailSendPreviewSchema: z.ZodObject<{
2551
+ from: z.ZodObject<{
2552
+ name: z.ZodString;
2553
+ address: z.ZodEmail;
2554
+ }, z.core.$strict>;
2555
+ replyTo: z.ZodOptional<z.ZodEmail>;
2556
+ to: z.ZodArray<z.ZodObject<{
2557
+ kind: z.ZodEnum<{
2558
+ address: "address";
2559
+ person: "person";
2560
+ }>;
2561
+ label: z.ZodString;
2562
+ }, z.core.$strict>>;
2563
+ cc: z.ZodArray<z.ZodObject<{
2564
+ kind: z.ZodEnum<{
2565
+ address: "address";
2566
+ person: "person";
2567
+ }>;
2568
+ label: z.ZodString;
2569
+ }, z.core.$strict>>;
2570
+ bcc: z.ZodArray<z.ZodObject<{
2571
+ kind: z.ZodEnum<{
2572
+ address: "address";
2573
+ person: "person";
2574
+ }>;
2575
+ label: z.ZodString;
2576
+ }, z.core.$strict>>;
2577
+ skipped: z.ZodNumber;
2578
+ subject: z.ZodString;
2579
+ html: z.ZodString;
2580
+ text: z.ZodString;
2581
+ }, z.core.$strict>;
2582
+ type MailSendPreview = z.infer<typeof mailSendPreviewSchema>;
2583
+ /** What a simulated call (a test run's `dry_run`, an agent preview turn) answers. */
2584
+ declare const mailSendSimulatedOutputSchema: z.ZodObject<{
2585
+ simulated: z.ZodLiteral<true>;
2586
+ preview: z.ZodObject<{
2587
+ from: z.ZodObject<{
2588
+ name: z.ZodString;
2589
+ address: z.ZodEmail;
2590
+ }, z.core.$strict>;
2591
+ replyTo: z.ZodOptional<z.ZodEmail>;
2592
+ to: z.ZodArray<z.ZodObject<{
2593
+ kind: z.ZodEnum<{
2594
+ address: "address";
2595
+ person: "person";
2596
+ }>;
2597
+ label: z.ZodString;
2598
+ }, z.core.$strict>>;
2599
+ cc: z.ZodArray<z.ZodObject<{
2600
+ kind: z.ZodEnum<{
2601
+ address: "address";
2602
+ person: "person";
2603
+ }>;
2604
+ label: z.ZodString;
2605
+ }, z.core.$strict>>;
2606
+ bcc: z.ZodArray<z.ZodObject<{
2607
+ kind: z.ZodEnum<{
2608
+ address: "address";
2609
+ person: "person";
2610
+ }>;
2611
+ label: z.ZodString;
2612
+ }, z.core.$strict>>;
2613
+ skipped: z.ZodNumber;
2614
+ subject: z.ZodString;
2615
+ html: z.ZodString;
2616
+ text: z.ZodString;
2617
+ }, z.core.$strict>;
2618
+ }, z.core.$strict>;
2619
+ type MailSendSimulatedOutput = z.infer<typeof mailSendSimulatedOutputSchema>;
2620
+ /**
2621
+ * The params of the template `workflow-message`, per mail. The frame (the instance's name,
2622
+ * embedded logo, accent colour and `outbound.footer`) is the instance's and not a param; the
2623
+ * envelope (From name, to, cc, bcc, Reply-To) is the message's and not a param either.
2624
+ * `markdown` arrives with every joined referenced value already escaped, and a body mapped as
2625
+ * one reference with each link's address shown. `test` puts "[Test]" before
2626
+ * the subject and lists whom the mail would have reached.
2627
+ */
2628
+ declare const workflowMessageMailParamsSchema: z.ZodObject<{
2629
+ subject: z.ZodString;
2630
+ markdown: z.ZodString;
2631
+ sentBy: z.ZodDiscriminatedUnion<[z.ZodObject<{
2632
+ kind: z.ZodLiteral<"workflow">;
2633
+ workflowName: z.ZodString;
2634
+ }, z.core.$strict>, z.ZodObject<{
2635
+ kind: z.ZodLiteral<"agent">;
2636
+ onBehalfOf: z.ZodString;
2637
+ }, z.core.$strict>], "kind">;
2638
+ test: z.ZodOptional<z.ZodObject<{
2639
+ intendedRecipients: z.ZodObject<{
2640
+ to: z.ZodArray<z.ZodObject<{
2641
+ kind: z.ZodEnum<{
2642
+ address: "address";
2643
+ person: "person";
2644
+ }>;
2645
+ label: z.ZodString;
2646
+ }, z.core.$strict>>;
2647
+ cc: z.ZodArray<z.ZodObject<{
2648
+ kind: z.ZodEnum<{
2649
+ address: "address";
2650
+ person: "person";
2651
+ }>;
2652
+ label: z.ZodString;
2653
+ }, z.core.$strict>>;
2654
+ bcc: z.ZodArray<z.ZodObject<{
2655
+ kind: z.ZodEnum<{
2656
+ address: "address";
2657
+ person: "person";
2658
+ }>;
2659
+ label: z.ZodString;
2660
+ }, z.core.$strict>>;
2661
+ }, z.core.$strict>;
2662
+ }, z.core.$strict>>;
2663
+ }, z.core.$strict>;
2664
+ type WorkflowMessageMailParams = z.infer<typeof workflowMessageMailParamsSchema>;
2665
+ /**
2666
+ * What the step facts of a `mail.send` step carry beside `source { kind: "mail_sender", title,
2667
+ * service }`, where `service` is the icon key: the sender's address and the instance's
2668
+ * `recipientDomains`, so the panel marks an address a run would refuse.
2669
+ */
2670
+ declare const workflowMailSenderFactSchema: z.ZodObject<{
2671
+ sender: z.ZodString;
2672
+ title: z.ZodString;
2673
+ icon: z.ZodString;
2674
+ address: z.ZodEmail;
2675
+ recipientDomains: z.ZodArray<z.ZodString>;
2676
+ }, z.core.$strict>;
2677
+ type WorkflowMailSenderFact = z.infer<typeof workflowMailSenderFactSchema>;
2678
+ /** Contract only: MAIL-1 registers the operation while `outbound.enabled` is true. */
2679
+ declare const mailSendContract: {
2680
+ readonly name: "mail.send";
2681
+ readonly description: "Send one e-mail as a sender of the instance (system unless set). Recipients are addresses, people of the instance and workspaces; an address outside the instance's recipient domains is refused. The body is Markdown in the instance's frame. A test run previews the mail and sends nothing.";
2682
+ readonly inputSchema: z.ZodObject<{
2683
+ sender: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"system">, z.ZodTemplateLiteral<`connection.${string}`>]>>;
2684
+ to: z.ZodUnion<readonly [z.ZodEmail, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodUnion<readonly [z.ZodObject<{
2685
+ address: z.ZodEmail;
2686
+ }, z.core.$strict>, z.ZodObject<{
2687
+ user: z.ZodString;
2688
+ }, z.core.$strict>, z.ZodObject<{
2689
+ workspace: z.ZodString;
2690
+ }, z.core.$strict>]>, z.ZodObject<{
2691
+ email: z.ZodEmail;
2692
+ }, z.core.$loose>]>>]>;
2693
+ cc: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodUnion<readonly [z.ZodObject<{
2694
+ address: z.ZodEmail;
2695
+ }, z.core.$strict>, z.ZodObject<{
2696
+ user: z.ZodString;
2697
+ }, z.core.$strict>, z.ZodObject<{
2698
+ workspace: z.ZodString;
2699
+ }, z.core.$strict>]>, z.ZodObject<{
2700
+ email: z.ZodEmail;
2701
+ }, z.core.$loose>]>>]>>;
2702
+ bcc: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodArray<z.ZodUnion<readonly [z.ZodEmail, z.ZodUnion<readonly [z.ZodObject<{
2703
+ address: z.ZodEmail;
2704
+ }, z.core.$strict>, z.ZodObject<{
2705
+ user: z.ZodString;
2706
+ }, z.core.$strict>, z.ZodObject<{
2707
+ workspace: z.ZodString;
2708
+ }, z.core.$strict>]>, z.ZodObject<{
2709
+ email: z.ZodEmail;
2710
+ }, z.core.$loose>]>>]>>;
2711
+ subject: z.ZodString;
2712
+ body: z.ZodString;
2713
+ senderName: z.ZodOptional<z.ZodString>;
2714
+ replyTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodEmail, z.ZodObject<{
2715
+ address: z.ZodEmail;
2716
+ }, z.core.$strict>, z.ZodObject<{
2717
+ user: z.ZodString;
2718
+ }, z.core.$strict>]>>;
2719
+ locale: z.ZodOptional<z.ZodEnum<{
2720
+ en: "en";
2721
+ de: "de";
2722
+ }>>;
2723
+ }, z.core.$strict>;
2724
+ readonly outputSchema: z.ZodObject<{
2725
+ sentAt: z.ZodISODateTime;
2726
+ messageId: z.ZodOptional<z.ZodString>;
2727
+ recipients: z.ZodObject<{
2728
+ to: z.ZodNumber;
2729
+ cc: z.ZodNumber;
2730
+ bcc: z.ZodNumber;
2731
+ }, z.core.$strict>;
2732
+ skipped: z.ZodNumber;
2733
+ test: z.ZodOptional<z.ZodLiteral<true>>;
2734
+ }, z.core.$strict>;
2735
+ readonly simulatedOutputSchema: z.ZodObject<{
2736
+ simulated: z.ZodLiteral<true>;
2737
+ preview: z.ZodObject<{
2738
+ from: z.ZodObject<{
2739
+ name: z.ZodString;
2740
+ address: z.ZodEmail;
2741
+ }, z.core.$strict>;
2742
+ replyTo: z.ZodOptional<z.ZodEmail>;
2743
+ to: z.ZodArray<z.ZodObject<{
2744
+ kind: z.ZodEnum<{
2745
+ address: "address";
2746
+ person: "person";
2747
+ }>;
2748
+ label: z.ZodString;
2749
+ }, z.core.$strict>>;
2750
+ cc: z.ZodArray<z.ZodObject<{
2751
+ kind: z.ZodEnum<{
2752
+ address: "address";
2753
+ person: "person";
2754
+ }>;
2755
+ label: z.ZodString;
2756
+ }, z.core.$strict>>;
2757
+ bcc: z.ZodArray<z.ZodObject<{
2758
+ kind: z.ZodEnum<{
2759
+ address: "address";
2760
+ person: "person";
2761
+ }>;
2762
+ label: z.ZodString;
2763
+ }, z.core.$strict>>;
2764
+ skipped: z.ZodNumber;
2765
+ subject: z.ZodString;
2766
+ html: z.ZodString;
2767
+ text: z.ZodString;
2768
+ }, z.core.$strict>;
2769
+ }, z.core.$strict>;
2770
+ readonly effect: "changing";
2771
+ readonly changeClass: "outward";
2772
+ readonly right: "mail_sender.use";
2773
+ readonly resourceKind: "mail_sender";
2774
+ readonly events: {
2775
+ readonly after: "mail.sent";
2776
+ readonly refused: "mail.refused";
2777
+ };
2778
+ readonly errorCodes: {
2779
+ readonly recipientNotAllowed: "recipient_not_allowed";
2780
+ readonly noRecipient: "no_recipient";
2781
+ readonly mailRejected: "mail_rejected";
2782
+ readonly workspaceNotAllowed: "workspace_not_allowed";
2783
+ };
2784
+ };
2785
+
2786
+ /** One instance's data separation dimension. SCOPE-1 serves one dimension. */
2787
+ declare const dataScopeNameSchema: z.ZodString;
2788
+ declare const dataScopesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
2789
+ label: z.ZodString;
2790
+ valueType: z.ZodLiteral<"text">;
2791
+ }, z.core.$strict>>;
2792
+ type DataScopes = z.infer<typeof dataScopesSchema>;
2793
+ declare const scopeAssignmentInputSchema: z.ZodObject<{
2794
+ dimension: z.ZodString;
2795
+ holderKind: z.ZodEnum<{
2796
+ user: "user";
2797
+ service_principal: "service_principal";
2798
+ group: "group";
2799
+ }>;
2800
+ holderId: z.ZodString;
2801
+ effect: z.ZodEnum<{
2802
+ allow: "allow";
2803
+ deny: "deny";
2804
+ }>;
2805
+ values: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
2806
+ }, z.core.$strict>;
2807
+ type ScopeAssignmentInput = z.infer<typeof scopeAssignmentInputSchema>;
2808
+ declare const scopedTablesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
2809
+ scope: z.ZodRecord<z.ZodString, z.ZodString>;
2810
+ }, z.core.$strict>>;
2811
+ type ScopedTables = z.infer<typeof scopedTablesSchema>;
2812
+
2813
+ /** The longest comment. */
2814
+ declare const FEEDBACK_TEXT_MAX_LENGTH = 4000;
2815
+ /** The longest machine-written summary and category a workflow stores on a comment. */
2816
+ declare const FEEDBACK_SUMMARY_MAX_LENGTH = 1000;
2817
+ declare const FEEDBACK_CATEGORY_MAX_LENGTH = 60;
2818
+ /** The longest note a reviewer leaves when marking a comment handled. */
2819
+ declare const FEEDBACK_NOTE_MAX_LENGTH = 2000;
2820
+ /**
2821
+ * What a comment is about. `message` in the first version; an App and a Workflow run follow
2822
+ * (LU-6), each with a reference of its own.
2823
+ */
2824
+ declare const FEEDBACK_SUBJECT_KINDS: readonly ["message"];
2825
+ type FeedbackSubjectKind = (typeof FEEDBACK_SUBJECT_KINDS)[number];
2826
+ declare const FEEDBACK_STATES: readonly ["new", "handled"];
2827
+ type FeedbackState = (typeof FEEDBACK_STATES)[number];
2828
+
2829
+ /** The source of an operation. A source the caller may not read is told by its kind alone. */
2830
+ declare const operationSourceSchema: z.ZodObject<{
2831
+ kind: z.ZodEnum<{
2832
+ workflow: "workflow";
2833
+ other: "other";
2834
+ connection: "connection";
2835
+ data_store: "data_store";
2836
+ knowledge_base: "knowledge_base";
2837
+ }>;
2838
+ title: z.ZodOptional<z.ZodString>;
2839
+ service: z.ZodOptional<z.ZodString>;
2840
+ }, z.core.$strip>;
2841
+ type OperationSourceView = z.infer<typeof operationSourceSchema>;
2842
+ declare const callableOperationSchema: z.ZodObject<{
2843
+ name: z.ZodString;
2844
+ effect: z.ZodEnum<{
2845
+ reading: "reading";
2846
+ changing: "changing";
2847
+ }>;
2848
+ title: z.ZodString;
2849
+ description: z.ZodOptional<z.ZodString>;
2850
+ source: z.ZodObject<{
2851
+ kind: z.ZodEnum<{
2852
+ workflow: "workflow";
2853
+ other: "other";
2854
+ connection: "connection";
2855
+ data_store: "data_store";
2856
+ knowledge_base: "knowledge_base";
2857
+ }>;
2858
+ title: z.ZodOptional<z.ZodString>;
2859
+ service: z.ZodOptional<z.ZodString>;
2860
+ }, z.core.$strip>;
2861
+ available: z.ZodBoolean;
2862
+ inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2863
+ outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2864
+ }, z.core.$strip>;
2865
+ type CallableOperationView = z.infer<typeof callableOperationSchema>;
2866
+ /** One page of callable operations. */
2867
+ declare const callableOperationsPageSchema: z.ZodObject<{
2868
+ operations: z.ZodArray<z.ZodObject<{
2869
+ name: z.ZodString;
2870
+ effect: z.ZodEnum<{
2871
+ reading: "reading";
2872
+ changing: "changing";
2873
+ }>;
2874
+ title: z.ZodString;
2875
+ description: z.ZodOptional<z.ZodString>;
2876
+ source: z.ZodObject<{
2877
+ kind: z.ZodEnum<{
2878
+ workflow: "workflow";
2879
+ other: "other";
2880
+ connection: "connection";
2881
+ data_store: "data_store";
2882
+ knowledge_base: "knowledge_base";
2883
+ }>;
2884
+ title: z.ZodOptional<z.ZodString>;
2885
+ service: z.ZodOptional<z.ZodString>;
2886
+ }, z.core.$strip>;
2887
+ available: z.ZodBoolean;
2888
+ inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2889
+ outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2890
+ }, z.core.$strip>>;
2891
+ nextCursor: z.ZodOptional<z.ZodString>;
2892
+ truncated: z.ZodBoolean;
2893
+ }, z.core.$strip>;
2894
+ type CallableOperationsPage = z.infer<typeof callableOperationsPageSchema>;
2895
+
2896
+ export { ACCESS_SOURCES, ACTIONS, ACTIVE_AGENT_RUN_STATUSES, ADMINISTERED_USER_STATUSES, AGENT_AVAILABILITY_MODES, AGENT_EDITABLE_FIELDS, AGENT_PREVIEW_SOURCES, AGENT_RUN_FAILURE_CATEGORIES, AGENT_RUN_STATUSES, AGENT_STARTERS_MAX, AGENT_USE_SETTINGS, API_CREDENTIAL_SCOPES, APPROVAL_CHECK_FAILURE_OUTCOMES, APPROVAL_CHECK_STATUSES, APPROVAL_EXECUTIONS, APPROVAL_REQUEST_STATUSES, APP_ACTION_CALL_STATUSES, APP_AUDIENCES, APP_ERROR_CODES, APP_ERROR_STATUS_CODES, APP_MODES, ARTIFACT_PREVIEW_IMAGE_FORMATS, ARTIFACT_PREVIEW_IMAGE_MIME_TYPES, ARTIFACT_PREVIEW_STATUSES, ASSET_ACCESS_VERBS, ASSET_LIFECYCLES, ASSET_NAME_REFUSAL_REASONS, ASSET_OWNER_KINDS, ASSET_REPO_BUNDLE_KINDS, ASSET_REPRESENTATIONS, ASSET_SYNC_CHANGE_TYPES, ATTACHMENT_CREATE_OUTCOMES, AUDIT_ACTOR_KINDS, AUDIT_EVENT_STATUSES, AUDIT_OUTCOMES, AUDIT_TIERS, AUTH_PRINCIPAL_KINDS, AUTH_SCOPE_WILDCARD, type AccessSource, type ActiveAgentRunStatus, type AdministeredUserStatus, type AgentAvailabilityMode, type AgentConfig, type AgentEditableField, type AgentInitialPromptConfig, type AgentRunFailureCategory, type AgentRunStatus, type AgentUse, type ApiCredentialScope, type AppActionCallStatus, type AppErrorCode, type AppMode, type ApprovalCheckFailureOutcome, type ApprovalCheckStatus, type ApprovalExecution, type ApprovalRequestStatus, type ArtifactPreviewImageFormat, type ArtifactPreviewImageMimeType, type ArtifactPreviewStatus, type AssetLifecycle, type AssetNameRefusalReason, type AssetOwnerKind, type AssetRepoBundleKind, type AssetRepresentation, type AssetSyncChangeType, type AttachmentCreateOutcome, type AuditActorKind, type AuditEventStatus, type AuditOutcome, type AuditTier, type AuthPrincipalKind, CATALOGUE_CATEGORIES, CATALOGUE_PARTS, CHAT_MESSAGE_ROLES, CHAT_SESSION_AUTH_SCOPES, COLLABORATION_WORKSPACE_KINDS, CONFIG_ASSET_CHANGE_OPERATIONS, CONFIG_ASSET_KINDS, CONNECTION_BINDING_STATES, CONNECTION_CREDENTIAL_MODES, CONNECTION_EXPOSURES, CONNECTION_HEALTH_STATES, CONNECTION_NAME_MAX_LENGTH, CONNECTION_NAME_PATTERN, CONNECTION_NETWORKS, CONNECTION_OAUTH_REGISTRATIONS, CONNECTION_OPERATION_POLICIES, CONNECTION_OPERATION_STATUSES, CONNECTION_ORIGINS, CONNECTION_PROPOSAL_BINDING_STATES, CONNECTION_PROPOSAL_STATES, CONNECTION_PROVIDER_REVOCATIONS, CONNECTION_SECRET_STATES, CONNECTION_SIGN_IN_NEEDS, CONNECTOR_TEST_STATUSES, CONVERSATION_ATTACHMENT_STATUSES, CONVERSATION_KINDS, CONVERSATION_VISIBILITIES, type CallableOperationView, type CallableOperationsPage, type CatalogueCategory, type CataloguePart, type ChatMessageRole, type ChatSessionAuthScope, type CollaborationWorkspaceKind, type ConfigAssetChangeOperation, type ConfigAssetKind, type ConnectionBindingState, type ConnectionCredentialMode, type ConnectionExposure, type ConnectionHealth, type ConnectionNetwork, type ConnectionOAuthRegistration, type ConnectionOperationPolicy, type ConnectionOperationStatus, type ConnectionOrigin, type ConnectionProposalBindingState, type ConnectionProposalState, type ConnectionProviderRevocation, type ConnectionSecretState, type ConnectionSignInNeed, type ConnectorTestStatus, type ConversationAttachmentStatus, type ConversationKind, type ConversationVisibility, DATABASE_RELATION_TYPES, DATA_STORE_CONDITIONS, DATA_STORE_INSERT_CONFLICT_MODES, DATA_STORE_LOAD_CONFLICT_MODES, DATA_STORE_MIGRATION_OUTCOMES, DATA_STORE_SCALAR_TYPES, DATA_STORE_STATUSES, DECIDED_APPROVAL_REQUEST_STATUSES, DELETION_STATES, type DataScopes, type DataStoreCondition, type DataStoreInsertConflictMode, type DataStoreLoadConflictMode, type DataStoreMigrationOutcome, type DataStoreRecordField, type DataStoreRecordProposalItem, type DataStoreRecordsDecideInput, type DataStoreRecordsDecideOutput, type DataStoreRecordsFlaggedInput, type DataStoreRecordsFlaggedOutput, type DataStoreRecordsProposeInput, type DataStoreRecordsRule, type DataStoreScalarType, type DataStoreStatus, type DatabaseRelationType, type DecidedApprovalRequestStatus, type DeletionState, ENDED_AGENT_RUN_STATUSES, ENDED_APPROVAL_EXECUTIONS, type EndedAgentRunStatus, type EndedApprovalExecution, FAILED_JOB_STATUSES, FEEDBACK_CATEGORY_MAX_LENGTH, FEEDBACK_NOTE_MAX_LENGTH, FEEDBACK_STATES, FEEDBACK_SUBJECT_KINDS, FEEDBACK_SUMMARY_MAX_LENGTH, FEEDBACK_TEXT_MAX_LENGTH, FIRST_PARTY_AUTH_SCOPES, FOLLOW_UP_MODES, FOLLOW_UP_STATUSES, type FailedJobStatus, type FeedbackState, type FeedbackSubjectKind, type FirstPartyAuthScope, GRANT_EFFECTS, GRANT_HOLDER_KINDS, GRANT_SCOPE_KINDS, GUARDRAIL_HIT_OUTCOMES, GUARDRAIL_NAME_MAX_LENGTH, GUARDRAIL_NAME_PATTERN, GUARDRAIL_OUTCOMES, type GrantEffect, type GrantHolderKind, type GrantScopeKind, type GuardrailHitOutcome, type GuardrailOutcome, IDEMPOTENCY_KEY_MAX_LENGTH, INFRASTRUCTURE_SECRET_STATES, INFRASTRUCTURE_WITHHELD_FIELDS, type InfrastructureSecretState, type InfrastructureWithheldField, JOB_STATUSES, type JobStatus, KNOWLEDGE_BASE_STATUSES, KNOWLEDGE_CHECK_STATUSES, KNOWLEDGE_DOCUMENT_FAILURE_CODES, KNOWLEDGE_DOCUMENT_STATES, KNOWLEDGE_DOCUMENT_WAIT_CODES, KNOWLEDGE_EMBEDDING_STATES, KNOWLEDGE_FILE_MAX_BYTES, KNOWLEDGE_SEARCH_SIGNALS, KNOWLEDGE_SOURCE_FAILURE_CODES, KNOWLEDGE_SOURCE_ITEM_FAILURE_CODES, KNOWLEDGE_SOURCE_ITEM_SHOWN_STATES, KNOWLEDGE_SOURCE_ITEM_STATES, KNOWLEDGE_SYNC_COUNTS, KNOWLEDGE_SYNC_MODES, KNOWLEDGE_SYNC_RUN_STATES, type KnowledgeBaseStatus, type KnowledgeCheckStatus, type KnowledgeDocumentFailureCode, type KnowledgeDocumentState, type KnowledgeDocumentWaitCode, type KnowledgeExtractFieldsInput, type KnowledgeExtractFieldsOutput, type KnowledgeFirstPassConfirmation, type KnowledgeIngestFetch, type KnowledgeIngestInput, type KnowledgeIngestItem, type KnowledgeIngestOutput, type KnowledgeLocateInput, type KnowledgeLocateOutput, type KnowledgePendingInput, type KnowledgePendingOutput, type KnowledgePendingRow, type KnowledgeProcessorOutput, type KnowledgePutProcessedInput, type KnowledgeRetryInput, type KnowledgeRetryOutput, type KnowledgeSearchSignal, type KnowledgeSourceFailureCode, type KnowledgeSourceItemFailureCode, type KnowledgeSourceItemShownState, type KnowledgeSourceItemState, type KnowledgeSourceItemsInput, type KnowledgeSourceItemsOutput, type KnowledgeSourcesOutput, type KnowledgeSyncCount, type KnowledgeSyncInput, type KnowledgeSyncMode, type KnowledgeSyncResult, type KnowledgeSyncRunState, type KnowledgeWithdrawInput, type KnowledgeWithdrawOutput, type KnowledgeWorkflowSource, type KnowledgeWorkflowSourcesOutput, LISTED_DATA_STORE_STATUSES, LIVE_JOB_STATUSES, type ListedDataStoreStatus, type LiveJobStatus, type LocaleCode, type LocalizedStringConfig, MAIL_ADDRESS_MAX_LENGTH, MAIL_ATTACHMENTS_MAX_BYTES, MAIL_ATTACHMENTS_MAX_FILES, MAIL_AUDIT_MAX_DOMAINS, MAIL_BODY_MAX_BYTES, MAIL_OUTBOUND_DEFAULT_LIMITS, MAIL_OUTBOUND_FOOTER_MAX_LENGTH, MAIL_RECIPIENT_DOMAINS_ANY, MAIL_RECIPIENT_DOMAIN_PATTERN, MAIL_RECIPIENT_ID_PATTERN, MAIL_SENDER_CONNECTION_PREFIX, MAIL_SENDER_NAME_MAX_LENGTH, MAIL_SENDER_RESOURCE_KIND, MAIL_SENDER_SYSTEM, MAIL_SENDER_SYSTEM_ICON, MAIL_SENDER_USE_ACTION, MAIL_SEND_ERROR_CODES, MAIL_SEND_MAX_ADDRESSES, MAIL_SEND_OPERATION, MAIL_SEND_REFUSAL_REASONS, MAIL_SUBJECT_MAX_LENGTH, MAIL_WORKFLOW_MESSAGE_TEMPLATE, MANAGED_FILE_STATUSES, MESSAGE_FINISH_STATUSES, MODEL_PROVIDER_AUTH_MODES, MODEL_USAGE_EVENT_STATUSES, MODEL_USAGE_LIMIT_METRICS, MODEL_USAGE_LIMIT_PERIODS, MODEL_USAGE_LIMIT_SCOPES, MODEL_USAGE_SOURCES, MODEL_USAGE_TIERS, type MailPreviewRecipient, type MailSendErrorCode, type MailSendInput, type MailSendInputFields, type MailSendOutput, type MailSendPreview, type MailSendRecipient, type MailSendRecipientList, type MailSendRefusalDetails, type MailSendSimulatedOutput, type MailSenderId, type MessageFinishStatus, type ModelProviderAuthMode, type ModelUsageEventStatus, type ModelUsageRefusal, type ModelUsageSource, type ModelUsageTier, NOTIFY_CHANNELS, type NotifyChannel, OPENAI_COMPATIBLE_APIS, OPERATIONS_AUDIENCES, OPERATION_CHANGE_CLASSES, OPERATION_CONFIRMATION_DECISIONS, OPERATION_DENIAL_REASONS, OPERATION_EFFECTS, OPERATION_ORIGIN_KINDS, OPERATION_RUN_DECISION_MODES, OPERATION_RUN_DECISION_REASONS, OPERATION_RUN_STATUSES, OPERATION_SOURCE_KINDS, OPERATION_TARGETS, type OpenaiCompatibleApi, type OperationBatchFailure, type OperationBatchResult, type OperationDenialReason, type OperationEffect, type OperationOriginKind, type OperationPaging, type OperationRunDecisionMode, type OperationRunDecisionReason, type OperationRunStatus, type OperationScope, type OperationSourceKind, type OperationSourceView, type OperationTarget, type OperationsAudience, PERSONAL_WORKSPACES_KEY, PERSON_POLICY_SETTINGS, POLICY_VALUES, PRINCIPAL_HOLDER_KINDS, PROVIDER_CHECK_ERROR_CLASSES, PROVIDER_PORTS, PROVIDER_REGIONS, PUBLISHED_DATA_CONSUMER_KINDS, type PlatformAction, type PolicyValue, type PrincipalHolderKind, type ProviderCheckErrorClass, type ProviderPort, type ProviderRegion, type PublishedDataConsumerKind, READING_POLICY_VALUES, REASONING_EFFORTS, RECORDS_FLAGGED_MAX_ITEMS_PER_PAGE, RECORDS_PROPOSE_MAX_FIELDS_PER_ITEM, RECORDS_PROPOSE_MAX_ITEMS_PER_CALL, RECORD_FIELD_FAILURE_CODES, RECORD_FIELD_STATES, RECORD_FLAG_REASONS, ROLE_GRANT_SCOPE_KINDS, ROLE_PENDING_CHANGES, ROLE_PENDING_DECISIONS, type ReadingPolicyValue, type ReasoningEffortConfig, type RecordColumn, type RecordEvidenceResult, type RoleGrantScopeKind, type RolePendingDecision, SCHEDULED_START_STATES, SERVICE_PRINCIPAL_PERMISSIONS, SERVICE_PRINCIPAL_STATUSES, SKILL_CHANGE_TYPES, SKILL_FRONTMATTER_FIELDS, SKILL_FRONTMATTER_MAX_BYTES, SKILL_FRONTMATTER_MAX_DEPTH, SKILL_NAME_PATTERN, SKILL_NAME_RULE, SKILL_ORIGINS, SKILL_PORTABLE_DESCRIPTION_MAX_CHARS, SKILL_PORTABLE_NAME_MAX_CHARS, SKILL_RESOURCE_MEDIA_TYPES, SKILL_STARTERS_MAX, SKILL_STARTER_LINE_MAX_LENGTH, SKILL_SUMMARY_MAX_LENGTH, STRUCTURED_DATA_REVIEW_REASONS, SUPPORTED_IMAGE_MIME_TYPES, type ScopeAssignmentInput, type ScopedTables, type ServicePrincipalPermission, type ServicePrincipalStatus, type SkillChangeType, type SkillConfig, type SkillFileEntry, type SkillFrontmatterRefusal, SkillMarkdownError, type SkillOrigin, type SkillResourceConfig, type SkillResourceMediaType, type SkillStarterConfig, type StructuredDataReviewReason, type SupportedImageMimeType, THEME_MODES, THEME_MODE_PREFERENCES, TOOL_CALL_STATES, TOOL_DECISION_MODES, TOOL_DECISION_OUTCOMES, TOOL_DISPLAY_MODES, TOOL_GROUPS, TOOL_INPUT_PARSE_ERROR_CODES, type ThemeMode, type ThemeModePreference, type ToolCallState, type ToolDisplayMode, type ToolGroup, type ToolInputParseErrorCode, USAGE_BREAKDOWN_DIMENSIONS, USAGE_COST_STATUSES, USAGE_ORIGINS, USAGE_SPEND_LIMIT_LEVELS, USER_STATUSES, type UsageCostStatus, type UserStatus, WAITING_OPERATION_RUN_STATUSES, WEB_SOURCE_PROVIDERS, WORKFLOW_DATASET_DOWNLOAD_FORMATS, WORKFLOW_DATASET_STATES, WORKFLOW_ENDED_STATUSES, WORKFLOW_EXECUTED_STEP_TYPES, WORKFLOW_KINDS, WORKFLOW_MARKDOWN_MAX_COLUMNS, WORKFLOW_MARKDOWN_MAX_ROWS, WORKFLOW_NAME_PATTERN, WORKFLOW_NAME_RULE, WORKFLOW_RESERVED_STEP_TYPES, WORKFLOW_RIGHTS_REVISIONS, WORKFLOW_RIGHT_NEEDED_FOR, WORKFLOW_RIGHT_REFUSALS, WORKFLOW_RUN_ACCOUNT_STATUSES, WORKFLOW_RUN_MODES, WORKFLOW_RUN_STATUSES, WORKFLOW_STEP_RUN_STATUSES, WORKFLOW_STEP_SOURCE_KINDS, WORKFLOW_STEP_TYPES, WORKFLOW_TEST_REVISIONS, WORKFLOW_TEXT_FORMAT_MARKDOWN, WORKFLOW_TEXT_MAX_PARTS, WORKFLOW_TRIGGER_KINDS, WORKSPACE_ACCENT_COLORS, WORKSPACE_ACCESS_STATES, WORKSPACE_COMMAND_STATUSES, WORKSPACE_FILE_KINDS, WORKSPACE_MEMBERSHIP_ROLES, WORKSPACE_SECTIONS, WORKSPACE_USE_ASSET_KINDS, WORKSPACE_VISIBILITIES, type WebSourceProvider, type WorkflowAssetConfig, type WorkflowDatasetDownloadFormat, type WorkflowDatasetState, type WorkflowEndedStatus, type WorkflowKind, type WorkflowMailSenderFact, type WorkflowMessageMailParams, type WorkflowReservedStepType, type WorkflowRunMode, type WorkflowRunStatus, type WorkflowStepRunStatus, type WorkflowStepSourceKind, type WorkflowStepType, type WorkflowTestRevision, type WorkflowTriggerKind, type WorkspaceAccentColor, type WorkspaceAccessState, type WorkspaceCommandStatus, type WorkspaceFileKind, type WorkspaceMembershipRole, type WorkspaceSection, type WorkspaceVisibility, YAML_DATA_MAX_VALUES, YamlDataError, type YamlDataIssue, type YamlDataIssueCode, type YamlDataOptions, type YamlDataResult, agentConfigSchema, callableOperationSchema, callableOperationsPageSchema, checkStorableTexts, dataScopeNameSchema, dataScopesSchema, dataStoreRecordFieldSchema, dataStoreRecordProposalItemSchema, dataStoreRecordsContracts, dataStoreRecordsDecideInputSchema, dataStoreRecordsDecideOutputSchema, dataStoreRecordsFlaggedInputSchema, dataStoreRecordsFlaggedOutputSchema, dataStoreRecordsProposeInputSchema, dataStoreRecordsRuleSchema, deriveSkillTitle, formatSkillMarkdown, isStorableText, knowledgeExtractFieldsInputSchema, knowledgeExtractFieldsOutputSchema, knowledgeFieldValueSchema, knowledgeFirstPassConfirmationSchema, knowledgeIngestFetchSchema, knowledgeIngestInputSchema, knowledgeIngestItemSchema, knowledgeIngestOutputSchema, knowledgeLocateInputSchema, knowledgeLocateOutputSchema, knowledgePendingInputSchema, knowledgePendingOutputSchema, knowledgePendingRowSchema, knowledgeProcessorOutputSchema, knowledgePutProcessedInputSchema, knowledgeRecordsRefusalSchema, knowledgeRetryInputSchema, knowledgeRetryOutputSchema, knowledgeSourceItemsInputSchema, knowledgeSourceItemsOutputSchema, knowledgeSourcesOutputSchema, knowledgeSyncInputSchema, knowledgeSyncResultSchema, knowledgeWithdrawInputSchema, knowledgeWithdrawOutputSchema, knowledgeWorkflowSourceSchema, knowledgeWorkflowSourcesOutputSchema, knowledgeWriteContracts, loadYamlData, localeCodes, localizedStringSchema, mailAddressSchema, mailBodySchema, mailCopyRecipientListSchema, mailPreviewRecipientSchema, mailRecipientDomainSchema, mailRecipientListSchema, mailRecipientSchema, mailReplyToSchema, mailSendContract, mailSendInputSchema, mailSendOutputSchema, mailSendPreviewSchema, mailSendRefusalDetailsSchema, mailSendSimulatedOutputSchema, mailSenderIdSchema, mailSenderNameSchema, mailSubjectSchema, operationBatchFailureSchema, operationBatchResultSchema, operationPagingSchema, operationSourceSchema, parseSkillMarkdown, providerRegionSchema, readYamlData, recordColumnTakes, recordEvidenceResultSchema, scopeAssignmentInputSchema, scopedTablesSchema, skillConfigSchema, skillFileEntrySchema, skillFileFrontmatterSchema, skillNameSchema, skillPortabilityIssues, skillResourceConfigSchema, skillResourceMediaTypeForPath, skillResourcePathSchema, skillStarterSchema, workflowConfigSchema, workflowDataFlowsSchema, workflowDatasetReferenceSchema, workflowMailSenderFactSchema, workflowMessageMailParamsSchema, yamlValueIssue, yamlValueIssueSentence };