@work-shape/catalyst-asset-schemas 0.0.0-stage → 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.
@@ -0,0 +1,2896 @@
1
+ import { z } from 'zod';
2
+
3
+ /**
4
+ * The shape of an agent and of a skill as a file holds it. These are the public half of the
5
+ * asset model: a working copy, the command line tool and the instance read the same types.
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"];
9
+ declare const localeCodes: readonly ["en", "de"];
10
+ type LocaleCode = (typeof localeCodes)[number];
11
+ type LocalizedStringConfig = string | {
12
+ en?: string;
13
+ de?: string;
14
+ };
15
+ declare const REASONING_EFFORTS: readonly ["none", "low", "medium", "high", "xhigh", "max"];
16
+ type ReasoningEffortConfig = (typeof REASONING_EFFORTS)[number];
17
+ interface AgentInitialPromptConfig {
18
+ title: LocalizedStringConfig;
19
+ prompt: LocalizedStringConfig;
20
+ }
21
+ interface AgentConfig {
22
+ name: string;
23
+ displayName: LocalizedStringConfig;
24
+ description?: LocalizedStringConfig;
25
+ welcomeMessage?: LocalizedStringConfig;
26
+ welcomeSubtitle?: LocalizedStringConfig;
27
+ instructions: string;
28
+ modelProviderId?: string;
29
+ modelBindingId?: string;
30
+ reasoningEffort?: ReasoningEffortConfig;
31
+ fastMode?: boolean;
32
+ /** Bindings users may pick for this agent in the chat, besides its own `modelBindingId`. */
33
+ userSelectableModelBindingIds?: string[];
34
+ /**
35
+ * Reasoning effort per user-selectable binding. `reasoningEffort` stays the effort of the
36
+ * agent's own model and is not applied to a model a user picked instead.
37
+ */
38
+ modelReasoningEfforts?: Record<string, ReasoningEffortConfig>;
39
+ maxSteps?: number;
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[];
46
+ skillNames: string[];
47
+ /**
48
+ * The Knowledge Bases the agent answers from, by id. However many it lists, the agent has one
49
+ * tool over those of tables, `knowledge.query`, and one over those of documents,
50
+ * `knowledge.search`. Missing means none.
51
+ */
52
+ knowledgeBases?: string[];
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>;
59
+ }
60
+ interface SkillConfig {
61
+ name: string;
62
+ title: string;
63
+ /** For the agent: when to use the skill. */
64
+ description: string;
65
+ /**
66
+ * For people: one sentence on one line that says what an agent with the skill knows how to
67
+ * do. Lists and choosers show it under the title.
68
+ */
69
+ summary?: string;
70
+ /** Up to `SKILL_STARTERS_MAX` first requests the empty chat offers for an agent with the skill. */
71
+ starters?: SkillStarterConfig[];
72
+ content: string;
73
+ resources?: SkillResourceConfig[];
74
+ /**
75
+ * The files of the skill's folder that the config does not hold itself: everything beside
76
+ * `SKILL.md` and the text resources, such as a script, a PDF or an image. An index and no
77
+ * content. The platform writes it with the files; what a caller sends here is not read.
78
+ */
79
+ files?: SkillFileEntry[];
80
+ /**
81
+ * The keys of the frontmatter of `SKILL.md` that are not fields of the skill
82
+ * (`SKILL_FRONTMATTER_FIELDS`), such as `license`, `metadata` and `allowed-tools` of the
83
+ * public skill convention, as JSON values. They are kept and returned and never read by the
84
+ * platform.
85
+ */
86
+ frontmatter?: Record<string, unknown>;
87
+ /**
88
+ * `release` on a skill that ships with the platform. Only the release seed writes it: every
89
+ * other write of a skill that carries it is refused, and a stored one is read-only.
90
+ */
91
+ origin?: "release";
92
+ /** The key of the interface's icon registry. Only a skill that ships with the platform has one. */
93
+ icon?: string;
94
+ }
95
+ /** One file of a skill's folder as its index names it. */
96
+ interface SkillFileEntry {
97
+ /** Relative to the folder of the skill, with `/` between segments. */
98
+ path: string;
99
+ /** Lower-case hex. */
100
+ sha256: string;
101
+ bytes: number;
102
+ mediaType: string;
103
+ }
104
+ /** How many starters one skill carries at most. */
105
+ declare const SKILL_STARTERS_MAX = 2;
106
+ /** How many starters the empty chat shows for one agent at most. */
107
+ declare const AGENT_STARTERS_MAX = 4;
108
+ /** The most characters a starter's `title` and its `hint` hold, in each language. */
109
+ declare const SKILL_STARTER_LINE_MAX_LENGTH = 60;
110
+ /** One first request a skill offers on the empty chat. Choosing it fills the composer. */
111
+ interface SkillStarterConfig {
112
+ title: LocalizedStringConfig;
113
+ /** One short line under the title. */
114
+ hint?: LocalizedStringConfig;
115
+ /** The text that fills the composer. */
116
+ prompt: LocalizedStringConfig;
117
+ /**
118
+ * The tools the request needs. The starter shows only for an agent that holds every one of
119
+ * them, so it never offers what the agent cannot do.
120
+ */
121
+ tools?: string[];
122
+ }
123
+ /** The most characters a skill's `summary` holds. */
124
+ declare const SKILL_SUMMARY_MAX_LENGTH = 120;
125
+ /**
126
+ * Who ships a skill, as a list says it: `instance` for a skill of the instance's own, `release`
127
+ * for one that ships with the platform, which the release seed alone writes.
128
+ */
129
+ declare const SKILL_ORIGINS: readonly ["instance", "release"];
130
+ type SkillOrigin = (typeof SKILL_ORIGINS)[number];
131
+ declare const SKILL_RESOURCE_MEDIA_TYPES: readonly ["text/markdown", "text/plain", "application/json", "application/yaml"];
132
+ type SkillResourceMediaType = (typeof SKILL_RESOURCE_MEDIA_TYPES)[number];
133
+ interface SkillResourceConfig {
134
+ path: string;
135
+ mediaType: SkillResourceMediaType;
136
+ content: string;
137
+ }
138
+ /** Ordered from the narrowest App audience to the widest. */
139
+ declare const APP_AUDIENCES: readonly ["self", "workspace", "instance"];
140
+
141
+ /**
142
+ * The values the HTTP contract of an instance is written with: scopes, actions, error codes
143
+ * and the limits a request is checked against. They hold no behaviour. The private packages
144
+ * of the platform read them from here, so that the contract and what enforces it cannot
145
+ * drift apart.
146
+ */
147
+ declare const AUTH_SCOPE_WILDCARD: "*";
148
+ declare const CHAT_SESSION_AUTH_SCOPES: readonly ["me:read", "me:delete", "config:read", "conversation:read", "conversation:write", "run:start", "run:observe", "run:cancel", "run:command"];
149
+ declare const FIRST_PARTY_AUTH_SCOPES: readonly ["*", "me:read", "me:delete", "config:read", "conversation:read", "conversation:write", "run:start", "run:observe", "run:cancel", "run:command", "collaboration_workspace:read", "collaboration_workspace:manage", "me:write", "governance:read", "governance:write", "user_admin:read", "user_admin:write", "api_access:read", "api_access:write", "config_assets:read", "config_assets:write", "config_assets:publish", "config_assets:release", "data_store_rows:read", "data_store_rows:write"];
150
+ type ChatSessionAuthScope = (typeof CHAT_SESSION_AUTH_SCOPES)[number];
151
+ type FirstPartyAuthScope = (typeof FIRST_PARTY_AUTH_SCOPES)[number];
152
+ type OperationScope = Exclude<FirstPartyAuthScope, "*">;
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"];
158
+ type PlatformAction = (typeof ACTIONS)[number];
159
+ type AppErrorCode = (typeof APP_ERROR_CODES)[number];
160
+ /** The HTTP status every error code answers with. */
161
+ declare const APP_ERROR_STATUS_CODES: Record<AppErrorCode, number>;
162
+ type OperationEffect = (typeof OPERATION_EFFECTS)[number];
163
+ /**
164
+ * The longest `Idempotency-Key` a caller may send, in characters. It protects the index the
165
+ * key is looked up in. A longer key is refused with VALIDATION_FAILED naming this limit.
166
+ */
167
+ declare const IDEMPOTENCY_KEY_MAX_LENGTH = 255;
168
+ /** What an instance takes from outside its own processes. A closed list. */
169
+ declare const PROVIDER_PORTS: readonly ["models", "mail", "objectStorage", "sandbox", "secrets"];
170
+ type ProviderPort = (typeof PROVIDER_PORTS)[number];
171
+ /**
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.
174
+ */
175
+ declare const PROVIDER_REGIONS: readonly ["eu", "global"];
176
+ type ProviderRegion = string;
177
+ /**
178
+ * Why a check failed. Product-owned and closed: it is all of a failure that reaches a log, the
179
+ * API or a page, so a provider's own error text, which can repeat a key or an address, cannot.
180
+ */
181
+ declare const PROVIDER_CHECK_ERROR_CLASSES: readonly ["unreachable", "timeout", "access_denied", "not_found", "bucket_missing", "rejected", "failed"];
182
+ type ProviderCheckErrorClass = (typeof PROVIDER_CHECK_ERROR_CLASSES)[number];
183
+ /**
184
+ * The immutable machine name. It is part of every operation name of the Connection
185
+ * (`connection.<name>.<operation>`), so it holds no dot.
186
+ */
187
+ declare const CONNECTION_NAME_PATTERN: RegExp;
188
+ declare const CONNECTION_NAME_MAX_LENGTH = 64;
189
+ /**
190
+ * The immutable machine name of a Guardrail. An approval request keeps it as the id of the
191
+ * check that answered, and its hits are kept under it.
192
+ */
193
+ declare const GUARDRAIL_NAME_PATTERN: RegExp;
194
+ declare const GUARDRAIL_NAME_MAX_LENGTH = 64;
195
+ /**
196
+ * Who may call an accepted operation. An operation exposed to nobody is callable by nobody.
197
+ * `outside` admits the CLI and the platform MCP server, a caller with an API credential whose
198
+ * results leave the instance; no operation has it unless an admin turns it on.
199
+ */
200
+ declare const CONNECTION_EXPOSURES: readonly ["agent", "bridge", "workflow", "outside"];
201
+ type ConnectionExposure = (typeof CONNECTION_EXPOSURES)[number];
202
+ /** The health of a Connection as its page and its list show it. */
203
+ declare const CONNECTION_HEALTH_STATES: readonly ["unknown", "ok", "failed", "needs_configuration", "secret_unreadable"];
204
+ type ConnectionHealth = (typeof CONNECTION_HEALTH_STATES)[number];
205
+ declare const GRANT_HOLDER_KINDS: readonly ["user", "service_principal", "role", "group"];
206
+ type GrantHolderKind = (typeof GRANT_HOLDER_KINDS)[number];
207
+ declare const GRANT_SCOPE_KINDS: readonly ["instance", "workspace", "asset"];
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];
217
+ declare const GRANT_EFFECTS: readonly ["allow", "deny"];
218
+ type GrantEffect = (typeof GRANT_EFFECTS)[number];
219
+ declare const ACCESS_SOURCES: readonly ["role", "legacy_ref", "grant", "membership"];
220
+ type AccessSource = (typeof ACCESS_SOURCES)[number];
221
+ declare const POLICY_VALUES: readonly ["allow", "confirm", "approval", "deny"];
222
+ type PolicyValue = (typeof POLICY_VALUES)[number];
223
+ declare const AUTH_PRINCIPAL_KINDS: readonly ["user", "service"];
224
+ type AuthPrincipalKind = (typeof AUTH_PRINCIPAL_KINDS)[number];
225
+ declare const ADMINISTERED_USER_STATUSES: readonly ["active", "disabled", "deleting"];
226
+ type AdministeredUserStatus = (typeof ADMINISTERED_USER_STATUSES)[number];
227
+ declare const SERVICE_PRINCIPAL_STATUSES: readonly ["active", "disabled"];
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"];
245
+ declare const SERVICE_PRINCIPAL_PERMISSIONS: readonly ["config_assets.read", "config_assets.release"];
246
+ type ServicePrincipalPermission = (typeof SERVICE_PRINCIPAL_PERMISSIONS)[number];
247
+ declare const API_CREDENTIAL_SCOPES: readonly ["config_assets:read", "config_assets:release"];
248
+ type ApiCredentialScope = (typeof API_CREDENTIAL_SCOPES)[number];
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"];
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];
257
+ declare const OPERATION_TARGETS: readonly ["live", "test", "dry_run"];
258
+ type OperationTarget = (typeof OPERATION_TARGETS)[number];
259
+ declare const OPERATION_RUN_STATUSES: readonly ["running", "pending_confirmation", "pending_approval", "done", "failed", "denied", "expired"];
260
+ type OperationRunStatus = (typeof OPERATION_RUN_STATUSES)[number];
261
+ declare const OPERATION_ORIGIN_KINDS: readonly ["agent", "user", "cli", "mcp", "app", "workflow", "schedule"];
262
+ type OperationOriginKind = (typeof OPERATION_ORIGIN_KINDS)[number];
263
+ declare const OPERATION_RUN_DECISION_MODES: readonly ["direct", "confirmed", "approved", "declined"];
264
+ type OperationRunDecisionMode = (typeof OPERATION_RUN_DECISION_MODES)[number];
265
+ declare const OPERATION_RUN_DECISION_REASONS: readonly ["inherited_approval_not_applied", "workflow_publish", "approved_by_caller"];
266
+ type OperationRunDecisionReason = (typeof OPERATION_RUN_DECISION_REASONS)[number];
267
+ declare const OPERATION_DENIAL_REASONS: readonly ["no_grant", "denied", "unknown_action", "holder_inactive", "holder_not_administrable", "user_only", "outside_key_scope"];
268
+ type OperationDenialReason = (typeof OPERATION_DENIAL_REASONS)[number];
269
+ declare const APPROVAL_REQUEST_STATUSES: readonly ["pending", "approved", "rejected", "changes_requested", "superseded", "withdrawn", "reverted"];
270
+ type ApprovalRequestStatus = (typeof APPROVAL_REQUEST_STATUSES)[number];
271
+ declare const APPROVAL_CHECK_STATUSES: readonly ["passed", "warned", "blocked"];
272
+ type ApprovalCheckStatus = (typeof APPROVAL_CHECK_STATUSES)[number];
273
+ declare const APPROVAL_EXECUTIONS: readonly ["queued", "done", "failed", "interrupted", "refused", "expired", "held"];
274
+ type ApprovalExecution = (typeof APPROVAL_EXECUTIONS)[number];
275
+ declare const SKILL_CHANGE_TYPES: readonly ["replace", "add", "new_resource"];
276
+ type SkillChangeType = (typeof SKILL_CHANGE_TYPES)[number];
277
+ declare const GUARDRAIL_OUTCOMES: readonly ["allow", "warn", "require_approval", "block"];
278
+ type GuardrailOutcome = (typeof GUARDRAIL_OUTCOMES)[number];
279
+ declare const APP_MODES: readonly ["published", "draft"];
280
+ type AppMode = (typeof APP_MODES)[number];
281
+ declare const ASSET_NAME_REFUSAL_REASONS: readonly ["name_invalid", "name_taken"];
282
+ type AssetNameRefusalReason = (typeof ASSET_NAME_REFUSAL_REASONS)[number];
283
+ declare const ASSET_SYNC_CHANGE_TYPES: readonly ["put", "delete"];
284
+ type AssetSyncChangeType = (typeof ASSET_SYNC_CHANGE_TYPES)[number];
285
+ declare const ASSET_LIFECYCLES: readonly ["active", "draft_published"];
286
+ type AssetLifecycle = (typeof ASSET_LIFECYCLES)[number];
287
+ declare const ASSET_REPRESENTATIONS: readonly ["config", "files"];
288
+ type AssetRepresentation = (typeof ASSET_REPRESENTATIONS)[number];
289
+ declare const CONFIG_ASSET_KINDS: readonly ["agent", "skill"];
290
+ type ConfigAssetKind = (typeof CONFIG_ASSET_KINDS)[number];
291
+ declare const CONFIG_ASSET_CHANGE_OPERATIONS: readonly ["create", "update", "delete", "revert"];
292
+ type ConfigAssetChangeOperation = (typeof CONFIG_ASSET_CHANGE_OPERATIONS)[number];
293
+ declare const AGENT_AVAILABILITY_MODES: readonly ["all", "selected"];
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];
301
+ declare const AGENT_EDITABLE_FIELDS: readonly ["displayName", "description", "welcomeMessage", "welcomeSubtitle", "instructions", "modelBindingId", "reasoningEffort", "maxSteps", "toolNames", "skillNames", "knowledgeBases", "initialPrompts"];
302
+ type AgentEditableField = (typeof AGENT_EDITABLE_FIELDS)[number];
303
+ declare const ASSET_REPO_BUNDLE_KINDS: readonly ["full", "incremental"];
304
+ type AssetRepoBundleKind = (typeof ASSET_REPO_BUNDLE_KINDS)[number];
305
+ declare const WORKSPACE_FILE_KINDS: readonly ["page", "upload", "generated_file"];
306
+ type WorkspaceFileKind = (typeof WORKSPACE_FILE_KINDS)[number];
307
+ declare const WORKSPACE_VISIBILITIES: readonly ["discoverable", "private"];
308
+ type WorkspaceVisibility = (typeof WORKSPACE_VISIBILITIES)[number];
309
+ declare const WORKSPACE_MEMBERSHIP_ROLES: readonly ["owner", "admin", "member"];
310
+ type WorkspaceMembershipRole = (typeof WORKSPACE_MEMBERSHIP_ROLES)[number];
311
+ declare const WORKSPACE_ACCENT_COLORS: readonly ["garnet", "ruby", "mahogany", "copper", "amber", "olive", "jade", "emerald", "teal", "turquoise", "azure", "sapphire", "indigo", "violet", "magenta", "rose", "stone", "slate"];
312
+ type WorkspaceAccentColor = (typeof WORKSPACE_ACCENT_COLORS)[number];
313
+ declare const COLLABORATION_WORKSPACE_KINDS: readonly ["personal", "shared"];
314
+ type CollaborationWorkspaceKind = (typeof COLLABORATION_WORKSPACE_KINDS)[number];
315
+ declare const WORKSPACE_ACCESS_STATES: readonly ["member", "request_pending", "can_request"];
316
+ type WorkspaceAccessState = (typeof WORKSPACE_ACCESS_STATES)[number];
317
+ declare const DELETION_STATES: readonly ["deleting", "deleted"];
318
+ type DeletionState = (typeof DELETION_STATES)[number];
319
+ declare const WORKSPACE_SECTIONS: readonly ["agents", "apps"];
320
+ type WorkspaceSection = (typeof WORKSPACE_SECTIONS)[number];
321
+ declare const MODEL_USAGE_TIERS: readonly ["very_low", "low", "moderate", "elevated", "high", "very_high"];
322
+ type ModelUsageTier = (typeof MODEL_USAGE_TIERS)[number];
323
+ declare const THEME_MODE_PREFERENCES: readonly ["light", "dark", "system"];
324
+ type ThemeModePreference = (typeof THEME_MODE_PREFERENCES)[number];
325
+ declare const TOOL_GROUPS: readonly ["documents", "web", "files", "results", "skills", "platform", "instance"];
326
+ type ToolGroup = (typeof TOOL_GROUPS)[number];
327
+ declare const INFRASTRUCTURE_SECRET_STATES: readonly ["set", "missing"];
328
+ type InfrastructureSecretState = (typeof INFRASTRUCTURE_SECRET_STATES)[number];
329
+ declare const INFRASTRUCTURE_WITHHELD_FIELDS: readonly ["endpointHost", "bucket"];
330
+ type InfrastructureWithheldField = (typeof INFRASTRUCTURE_WITHHELD_FIELDS)[number];
331
+ declare const OPENAI_COMPATIBLE_APIS: readonly ["chat_completions", "responses"];
332
+ type OpenaiCompatibleApi = (typeof OPENAI_COMPATIBLE_APIS)[number];
333
+ declare const MODEL_PROVIDER_AUTH_MODES: readonly ["bearer", "api-key"];
334
+ type ModelProviderAuthMode = (typeof MODEL_PROVIDER_AUTH_MODES)[number];
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];
339
+ type ConversationVisibility = (typeof CONVERSATION_VISIBILITIES)[number];
340
+ declare const WEB_SOURCE_PROVIDERS: readonly ["openai-native", "serper", "tavily", "firecrawl", "browserbase", "direct"];
341
+ type WebSourceProvider = (typeof WEB_SOURCE_PROVIDERS)[number];
342
+ declare const CHAT_MESSAGE_ROLES: readonly ["user", "assistant", "system", "tool"];
343
+ type ChatMessageRole = (typeof CHAT_MESSAGE_ROLES)[number];
344
+ declare const CONVERSATION_ATTACHMENT_STATUSES: readonly ["queued", "preprocessing", "ready", "failed", "unsupported", "deleted"];
345
+ type ConversationAttachmentStatus = (typeof CONVERSATION_ATTACHMENT_STATUSES)[number];
346
+ declare const ATTACHMENT_CREATE_OUTCOMES: readonly ["created", "already_available"];
347
+ type AttachmentCreateOutcome = (typeof ATTACHMENT_CREATE_OUTCOMES)[number];
348
+ declare const STRUCTURED_DATA_REVIEW_REASONS: readonly ["uncertain", "conflicting"];
349
+ type StructuredDataReviewReason = (typeof STRUCTURED_DATA_REVIEW_REASONS)[number];
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"];
355
+ type AgentRunStatus = (typeof AGENT_RUN_STATUSES)[number];
356
+ declare const AGENT_RUN_FAILURE_CATEGORIES: readonly ["app_error", "internal_error", "runtime_interrupted", "abort_error", "unknown_error"];
357
+ type AgentRunFailureCategory = (typeof AGENT_RUN_FAILURE_CATEGORIES)[number];
358
+ declare const TOOL_INPUT_PARSE_ERROR_CODES: readonly ["invalid_json", "invalid_text"];
359
+ type ToolInputParseErrorCode = (typeof TOOL_INPUT_PARSE_ERROR_CODES)[number];
360
+ declare const WAITING_OPERATION_RUN_STATUSES: readonly ["pending_confirmation", "pending_approval"];
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"];
366
+ declare const TOOL_DECISION_MODES: readonly ["confirm", "approval"];
367
+ declare const TOOL_DECISION_OUTCOMES: readonly ["confirmed", "declined", "expired", "cancelled"];
368
+ declare const TOOL_CALL_STATES: readonly ["input_available", "waiting_for_decision", "output_available", "output_error"];
369
+ type ToolCallState = (typeof TOOL_CALL_STATES)[number];
370
+ declare const SUPPORTED_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/webp", "image/gif"];
371
+ type SupportedImageMimeType = (typeof SUPPORTED_IMAGE_MIME_TYPES)[number];
372
+ declare const ARTIFACT_PREVIEW_IMAGE_FORMATS: readonly ["png", "webp", "jpeg"];
373
+ type ArtifactPreviewImageFormat = (typeof ARTIFACT_PREVIEW_IMAGE_FORMATS)[number];
374
+ declare const ARTIFACT_PREVIEW_STATUSES: readonly ["ready", "pending", "failed", "unsupported"];
375
+ type ArtifactPreviewStatus = (typeof ARTIFACT_PREVIEW_STATUSES)[number];
376
+ declare const WORKSPACE_COMMAND_STATUSES: readonly ["queued", "running", "cancelling", "completed", "failed", "cancelled"];
377
+ type WorkspaceCommandStatus = (typeof WORKSPACE_COMMAND_STATUSES)[number];
378
+ declare const TOOL_DISPLAY_MODES: readonly ["inline", "side_panel", "fullscreen"];
379
+ type ToolDisplayMode = (typeof TOOL_DISPLAY_MODES)[number];
380
+ declare const JOB_STATUSES: readonly ["queued", "running", "succeeded", "failed", "dead", "cancelled"];
381
+ type JobStatus = (typeof JOB_STATUSES)[number];
382
+ declare const AUDIT_ACTOR_KINDS: readonly ["user", "assistant", "service", "system"];
383
+ type AuditActorKind = (typeof AUDIT_ACTOR_KINDS)[number];
384
+ declare const AUDIT_TIERS: readonly ["governance", "workflow", "runtime", "telemetry"];
385
+ type AuditTier = (typeof AUDIT_TIERS)[number];
386
+ declare const AUDIT_OUTCOMES: readonly ["success", "failed", "denied", "warning"];
387
+ type AuditOutcome = (typeof AUDIT_OUTCOMES)[number];
388
+ declare const MODEL_USAGE_EVENT_STATUSES: readonly ["pending", "settled", "failed", "abandoned"];
389
+ type ModelUsageEventStatus = (typeof MODEL_USAGE_EVENT_STATUSES)[number];
390
+ declare const MODEL_USAGE_SOURCES: readonly ["provider_reported", "not_reported", "estimated"];
391
+ type ModelUsageSource = (typeof MODEL_USAGE_SOURCES)[number];
392
+ declare const USAGE_COST_STATUSES: readonly ["settled", "incomplete", "unpriced"];
393
+ type UsageCostStatus = (typeof USAGE_COST_STATUSES)[number];
394
+ declare const CONNECTION_OPERATION_STATUSES: readonly ["ready", "awaiting_discovery", "needs_review", "unknown", "disabled"];
395
+ type ConnectionOperationStatus = (typeof CONNECTION_OPERATION_STATUSES)[number];
396
+ declare const CONNECTION_SECRET_STATES: readonly ["set", "not_set", "unreadable"];
397
+ type ConnectionSecretState = (typeof CONNECTION_SECRET_STATES)[number];
398
+ declare const CONNECTOR_TEST_STATUSES: readonly ["ready", "unauthorized", "network_denied", "unavailable", "oauth_required"];
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];
431
+ declare const CONNECTION_ORIGINS: readonly ["release", "runtime"];
432
+ type ConnectionOrigin = (typeof CONNECTION_ORIGINS)[number];
433
+ declare const CONNECTION_NETWORKS: readonly ["public", "private"];
434
+ type ConnectionNetwork = (typeof CONNECTION_NETWORKS)[number];
435
+ declare const DATA_STORE_SCALAR_TYPES: readonly ["text", "integer", "number", "boolean", "date", "timestamp"];
436
+ type DataStoreScalarType = (typeof DATA_STORE_SCALAR_TYPES)[number];
437
+ declare const DATA_STORE_LOAD_CONFLICT_MODES: readonly ["fail", "skip", "update"];
438
+ type DataStoreLoadConflictMode = (typeof DATA_STORE_LOAD_CONFLICT_MODES)[number];
439
+ declare const DATA_STORE_INSERT_CONFLICT_MODES: readonly ["fail", "skip"];
440
+ type DataStoreInsertConflictMode = (typeof DATA_STORE_INSERT_CONFLICT_MODES)[number];
441
+ declare const DATA_STORE_CONDITIONS: readonly ["server_databases_open", "sessions_open", "temp_files_unbounded"];
442
+ type DataStoreCondition = (typeof DATA_STORE_CONDITIONS)[number];
443
+ declare const DATA_STORE_STATUSES: readonly ["provisioning", "ready", "retired"];
444
+ type DataStoreStatus = (typeof DATA_STORE_STATUSES)[number];
445
+ declare const DATA_STORE_MIGRATION_OUTCOMES: readonly ["none", "pending", "applied", "failed"];
446
+ type DataStoreMigrationOutcome = (typeof DATA_STORE_MIGRATION_OUTCOMES)[number];
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"];
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];
522
+ declare const DATABASE_RELATION_TYPES: readonly ["table", "view", "materialized_view", "foreign_table"];
523
+ type DatabaseRelationType = (typeof DATABASE_RELATION_TYPES)[number];
524
+ declare const WORKFLOW_RUN_STATUSES: readonly ["continued", "queued", "running", "waiting", "done", "failed", "cancelled", "limit_reached"];
525
+ type WorkflowRunStatus = (typeof WORKFLOW_RUN_STATUSES)[number];
526
+ declare const WORKFLOW_STEP_TYPES: readonly ["trigger", "operation", "loop", "code", "output", "agent", "notify", "workflow"];
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"];
534
+ declare const WORKFLOW_RESERVED_STEP_TYPES: readonly ["condition", "parallel"];
535
+ type WorkflowReservedStepType = (typeof WORKFLOW_RESERVED_STEP_TYPES)[number];
536
+ declare const WORKFLOW_TRIGGER_KINDS: readonly ["manual", "schedule", "parent"];
537
+ type WorkflowTriggerKind = (typeof WORKFLOW_TRIGGER_KINDS)[number];
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];
552
+ type NotifyChannel = (typeof NOTIFY_CHANNELS)[number];
553
+ declare const PRINCIPAL_HOLDER_KINDS: readonly ["user", "service_principal"];
554
+ type PrincipalHolderKind = (typeof PRINCIPAL_HOLDER_KINDS)[number];
555
+ declare const ASSET_OWNER_KINDS: readonly ["instance", "workspace"];
556
+ type AssetOwnerKind = (typeof ASSET_OWNER_KINDS)[number];
557
+ declare const READING_POLICY_VALUES: readonly ["allow", "deny"];
558
+ type ReadingPolicyValue = (typeof READING_POLICY_VALUES)[number];
559
+ declare const CONNECTION_OPERATION_POLICIES: readonly ["deny", "approval"];
560
+ type ConnectionOperationPolicy = (typeof CONNECTION_OPERATION_POLICIES)[number];
561
+ declare const WORKFLOW_RUN_MODES: readonly ["live", "test"];
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];
569
+ declare const APP_ACTION_CALL_STATUSES: readonly ["done", "pending_approval"];
570
+ type AppActionCallStatus = (typeof APP_ACTION_CALL_STATUSES)[number];
571
+ declare const OPERATIONS_AUDIENCES: readonly ["workflow", "app"];
572
+ type OperationsAudience = (typeof OPERATIONS_AUDIENCES)[number];
573
+ declare const DECIDED_APPROVAL_REQUEST_STATUSES: readonly ["approved", "rejected", "changes_requested", "superseded", "withdrawn", "reverted"];
574
+ type DecidedApprovalRequestStatus = (typeof DECIDED_APPROVAL_REQUEST_STATUSES)[number];
575
+ declare const ENDED_APPROVAL_EXECUTIONS: readonly ["done", "failed", "interrupted", "refused", "expired", "held"];
576
+ type EndedApprovalExecution = (typeof ENDED_APPROVAL_EXECUTIONS)[number];
577
+ declare const GUARDRAIL_HIT_OUTCOMES: readonly ["warn", "require_approval", "block"];
578
+ type GuardrailHitOutcome = (typeof GUARDRAIL_HIT_OUTCOMES)[number];
579
+ declare const APPROVAL_CHECK_FAILURE_OUTCOMES: readonly ["warn", "block"];
580
+ type ApprovalCheckFailureOutcome = (typeof APPROVAL_CHECK_FAILURE_OUTCOMES)[number];
581
+ declare const THEME_MODES: readonly ["light", "dark"];
582
+ type ThemeMode = (typeof THEME_MODES)[number];
583
+ declare const USER_STATUSES: readonly ["active", "disabled"];
584
+ type UserStatus = (typeof USER_STATUSES)[number];
585
+ declare const MESSAGE_FINISH_STATUSES: readonly ["completed", "cancelled"];
586
+ type MessageFinishStatus = (typeof MESSAGE_FINISH_STATUSES)[number];
587
+ declare const ENDED_AGENT_RUN_STATUSES: readonly ["completed", "cancelled", "failed"];
588
+ type EndedAgentRunStatus = (typeof ENDED_AGENT_RUN_STATUSES)[number];
589
+ declare const ACTIVE_AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_for_decision", "waiting_for_subagents", "cancelling"];
590
+ type ActiveAgentRunStatus = (typeof ACTIVE_AGENT_RUN_STATUSES)[number];
591
+ declare const ARTIFACT_PREVIEW_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/webp"];
592
+ type ArtifactPreviewImageMimeType = (typeof ARTIFACT_PREVIEW_IMAGE_MIME_TYPES)[number];
593
+ declare const LIVE_JOB_STATUSES: readonly ["queued", "running"];
594
+ type LiveJobStatus = (typeof LIVE_JOB_STATUSES)[number];
595
+ declare const FAILED_JOB_STATUSES: readonly ["failed", "dead"];
596
+ type FailedJobStatus = (typeof FAILED_JOB_STATUSES)[number];
597
+ declare const AUDIT_EVENT_STATUSES: readonly ["success", "failed", "denied"];
598
+ type AuditEventStatus = (typeof AUDIT_EVENT_STATUSES)[number];
599
+ declare const LISTED_DATA_STORE_STATUSES: readonly ["provisioning", "ready"];
600
+ type ListedDataStoreStatus = (typeof LISTED_DATA_STORE_STATUSES)[number];
601
+ declare const KNOWLEDGE_CHECK_STATUSES: readonly ["preparing", "ok", "needs_attention"];
602
+ type KnowledgeCheckStatus = (typeof KNOWLEDGE_CHECK_STATUSES)[number];
603
+ declare const WORKFLOW_STEP_RUN_STATUSES: readonly ["queued", "running", "waiting", "done", "failed", "cancelled"];
604
+ type WorkflowStepRunStatus = (typeof WORKFLOW_STEP_RUN_STATUSES)[number];
605
+ declare const WORKFLOW_ENDED_STATUSES: readonly ["continued", "done", "failed", "cancelled", "limit_reached"];
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"];
624
+
625
+ /** A short operator declaration of where a provider processes data. */
626
+ declare const providerRegionSchema: z.ZodString;
627
+ declare const localizedStringSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
628
+ en: z.ZodOptional<z.ZodString>;
629
+ de: z.ZodOptional<z.ZodString>;
630
+ }, z.core.$strict>]>;
631
+ declare const SKILL_NAME_PATTERN: RegExp;
632
+ declare const SKILL_NAME_RULE = "Skill name must start with a letter or a number and contain only letters, numbers, dots, underscores, or hyphens";
633
+ /** How long a name of the public skill convention is at most, in characters. */
634
+ declare const SKILL_PORTABLE_NAME_MAX_CHARS = 64;
635
+ /** How long a description of the public skill convention is at most, in characters. */
636
+ declare const SKILL_PORTABLE_DESCRIPTION_MAX_CHARS = 1024;
637
+ /**
638
+ * What keeps a skill from being taken as it is into a tool that reads the public skill
639
+ * convention: a name that is not lowercase letters, digits and single hyphens or is longer
640
+ * than 64 characters, and a description longer than 1,024. Each is a warning with a code and
641
+ * refuses nothing: such a skill works here.
642
+ */
643
+ declare function skillPortabilityIssues(skill: {
644
+ name?: unknown;
645
+ description?: unknown;
646
+ }): {
647
+ code: string;
648
+ message: string;
649
+ }[];
650
+ declare const skillNameSchema: z.ZodString;
651
+ declare const skillResourcePathSchema: z.ZodString;
652
+ declare function skillResourceMediaTypeForPath(path: string): SkillResourceMediaType | undefined;
653
+ declare const skillResourceConfigSchema: z.ZodObject<{
654
+ path: z.ZodString;
655
+ mediaType: z.ZodEnum<{
656
+ "text/markdown": "text/markdown";
657
+ "text/plain": "text/plain";
658
+ "application/json": "application/json";
659
+ "application/yaml": "application/yaml";
660
+ }>;
661
+ content: z.ZodString;
662
+ }, z.core.$strip>;
663
+ declare const skillStarterSchema: z.ZodObject<{
664
+ title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
665
+ en: z.ZodOptional<z.ZodString>;
666
+ de: z.ZodOptional<z.ZodString>;
667
+ }, z.core.$strict>]>;
668
+ hint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
669
+ en: z.ZodOptional<z.ZodString>;
670
+ de: z.ZodOptional<z.ZodString>;
671
+ }, z.core.$strict>]>>;
672
+ prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
673
+ en: z.ZodOptional<z.ZodString>;
674
+ de: z.ZodOptional<z.ZodString>;
675
+ }, z.core.$strict>]>;
676
+ tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
677
+ }, z.core.$strict>;
678
+ /**
679
+ * How much frontmatter a `SKILL.md` holds beside the keys the platform reads, as JSON, in
680
+ * characters. The keys of the public skill convention are a few lines.
681
+ */
682
+ declare const SKILL_FRONTMATTER_MAX_BYTES = 8192;
683
+ /** How deep the frontmatter of a `SKILL.md` nests at most. */
684
+ declare const SKILL_FRONTMATTER_MAX_DEPTH = 8;
685
+ /**
686
+ * The keys of the frontmatter of a `SKILL.md` that are fields of the skill. Every other key is
687
+ * kept apart as its further `frontmatter`.
688
+ */
689
+ declare const SKILL_FRONTMATTER_FIELDS: readonly ["name", "title", "description", "summary", "starters"];
690
+ /** One file of a skill's folder as its index names it: no content. */
691
+ declare const skillFileEntrySchema: z.ZodObject<{
692
+ path: z.ZodString;
693
+ sha256: z.ZodString;
694
+ bytes: z.ZodNumber;
695
+ mediaType: z.ZodString;
696
+ }, z.core.$strip>;
697
+ declare const skillConfigSchema: z.ZodObject<{
698
+ name: z.ZodString;
699
+ title: z.ZodString;
700
+ description: z.ZodString;
701
+ summary: z.ZodOptional<z.ZodString>;
702
+ starters: z.ZodOptional<z.ZodArray<z.ZodObject<{
703
+ title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
704
+ en: z.ZodOptional<z.ZodString>;
705
+ de: z.ZodOptional<z.ZodString>;
706
+ }, z.core.$strict>]>;
707
+ hint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
708
+ en: z.ZodOptional<z.ZodString>;
709
+ de: z.ZodOptional<z.ZodString>;
710
+ }, z.core.$strict>]>>;
711
+ prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
712
+ en: z.ZodOptional<z.ZodString>;
713
+ de: z.ZodOptional<z.ZodString>;
714
+ }, z.core.$strict>]>;
715
+ tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
716
+ }, z.core.$strict>>>;
717
+ content: z.ZodString;
718
+ resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
719
+ path: z.ZodString;
720
+ mediaType: z.ZodEnum<{
721
+ "text/markdown": "text/markdown";
722
+ "text/plain": "text/plain";
723
+ "application/json": "application/json";
724
+ "application/yaml": "application/yaml";
725
+ }>;
726
+ content: z.ZodString;
727
+ }, z.core.$strip>>>;
728
+ files: z.ZodOptional<z.ZodArray<z.ZodObject<{
729
+ path: z.ZodString;
730
+ sha256: z.ZodString;
731
+ bytes: z.ZodNumber;
732
+ mediaType: z.ZodString;
733
+ }, z.core.$strip>>>;
734
+ frontmatter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
735
+ origin: z.ZodOptional<z.ZodLiteral<"release">>;
736
+ icon: z.ZodOptional<z.ZodString>;
737
+ }, z.core.$strip>;
738
+ /**
739
+ * The frontmatter of a `SKILL.md`. `description` is required. `name` may be left to the folder
740
+ * and `title` to the content; `summary` and `starters` are read as the config holds them.
741
+ * Every other key is kept as it is and never refused: the public skill convention has keys of
742
+ * its own, such as `license` and `metadata`, and a library may add more. A skill file is the
743
+ * instance's own: what only a shipped skill carries, `origin` and `icon`, is no field of it.
744
+ */
745
+ declare const skillFileFrontmatterSchema: z.ZodObject<{
746
+ name: z.ZodOptional<z.ZodString>;
747
+ title: z.ZodOptional<z.ZodString>;
748
+ description: z.ZodString;
749
+ summary: z.ZodOptional<z.ZodString>;
750
+ starters: z.ZodOptional<z.ZodArray<z.ZodObject<{
751
+ title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
752
+ en: z.ZodOptional<z.ZodString>;
753
+ de: z.ZodOptional<z.ZodString>;
754
+ }, z.core.$strict>]>;
755
+ hint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
756
+ en: z.ZodOptional<z.ZodString>;
757
+ de: z.ZodOptional<z.ZodString>;
758
+ }, z.core.$strict>]>>;
759
+ prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
760
+ en: z.ZodOptional<z.ZodString>;
761
+ de: z.ZodOptional<z.ZodString>;
762
+ }, z.core.$strict>]>;
763
+ tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
764
+ }, z.core.$strict>>>;
765
+ }, z.core.$loose>;
766
+ declare const agentConfigSchema: z.ZodObject<{
767
+ name: z.ZodString;
768
+ displayName: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
769
+ en: z.ZodOptional<z.ZodString>;
770
+ de: z.ZodOptional<z.ZodString>;
771
+ }, z.core.$strict>]>;
772
+ description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
773
+ en: z.ZodOptional<z.ZodString>;
774
+ de: z.ZodOptional<z.ZodString>;
775
+ }, z.core.$strict>]>>;
776
+ welcomeMessage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
777
+ en: z.ZodOptional<z.ZodString>;
778
+ de: z.ZodOptional<z.ZodString>;
779
+ }, z.core.$strict>]>>;
780
+ welcomeSubtitle: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
781
+ en: z.ZodOptional<z.ZodString>;
782
+ de: z.ZodOptional<z.ZodString>;
783
+ }, z.core.$strict>]>>;
784
+ instructions: z.ZodString;
785
+ modelProviderId: z.ZodOptional<z.ZodString>;
786
+ modelBindingId: z.ZodOptional<z.ZodString>;
787
+ reasoningEffort: z.ZodOptional<z.ZodEnum<{
788
+ none: "none";
789
+ low: "low";
790
+ medium: "medium";
791
+ high: "high";
792
+ xhigh: "xhigh";
793
+ max: "max";
794
+ }>>;
795
+ fastMode: z.ZodOptional<z.ZodBoolean>;
796
+ userSelectableModelBindingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
797
+ modelReasoningEfforts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
798
+ none: "none";
799
+ low: "low";
800
+ medium: "medium";
801
+ high: "high";
802
+ xhigh: "xhigh";
803
+ max: "max";
804
+ }>>>;
805
+ maxSteps: z.ZodOptional<z.ZodNumber>;
806
+ toolNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
807
+ subagentNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
808
+ skillNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
809
+ knowledgeBases: z.ZodOptional<z.ZodArray<z.ZodString>>;
810
+ initialPrompts: z.ZodDefault<z.ZodArray<z.ZodObject<{
811
+ title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
812
+ en: z.ZodOptional<z.ZodString>;
813
+ de: z.ZodOptional<z.ZodString>;
814
+ }, z.core.$strict>]>;
815
+ prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
816
+ en: z.ZodOptional<z.ZodString>;
817
+ de: z.ZodOptional<z.ZodString>;
818
+ }, z.core.$strict>]>;
819
+ }, z.core.$strip>>>;
820
+ shipped: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
821
+ }, z.core.$strip>;
822
+ /** The id of a Workflow, which is the name of its asset: part of `workflow.<id>.start`. */
823
+ declare const WORKFLOW_NAME_PATTERN: RegExp;
824
+ declare const WORKFLOW_NAME_RULE = "A Workflow id starts with a lowercase letter and holds lowercase letters, digits, '_' and '-', at most 63 characters";
825
+ /**
826
+ * What a revision of a Workflow holds as its config: the id the asset is addressed by,
827
+ * `workflow.yaml` as an object under `manifest`, and the files of its `steps/` folder under
828
+ * `files`, each with its path in the Workflow's folder and its text. This is the shape alone,
829
+ * which every stored revision keeps whatever a later engine accepts. Whether the engine of the
830
+ * instance runs the manifest and takes the files is asked of the engine when a revision is
831
+ * saved and when one is published.
832
+ */
833
+ declare const workflowConfigSchema: z.ZodObject<{
834
+ name: z.ZodString;
835
+ manifest: z.ZodObject<{
836
+ id: z.ZodString;
837
+ name: z.ZodString;
838
+ description: z.ZodOptional<z.ZodString>;
839
+ }, z.core.$loose>;
840
+ files: z.ZodOptional<z.ZodArray<z.ZodObject<{
841
+ path: z.ZodString;
842
+ content: z.ZodString;
843
+ }, z.core.$strict>>>;
844
+ }, z.core.$strict>;
845
+ type WorkflowAssetConfig = z.infer<typeof workflowConfigSchema>;
846
+
847
+ /**
848
+ * Why a frontmatter is refused before its fields are read: for an alias, for its depth, or
849
+ * for the size of what it holds beside the name, the title and the description.
850
+ */
851
+ type SkillFrontmatterRefusal = "skill_frontmatter_alias" | "skill_frontmatter_too_deep" | "skill_frontmatter_too_large";
852
+ /**
853
+ * One thing that is wrong in a skill file: an invalid field by its path, or the place of the
854
+ * file, by line and column, where its frontmatter stops being YAML.
855
+ */
856
+ interface SkillMarkdownIssue {
857
+ message: string;
858
+ path: PropertyKey[];
859
+ line?: number;
860
+ column?: number;
861
+ }
862
+ /**
863
+ * A skill file that cannot be read as a skill. `details.issues` names each invalid field, and
864
+ * `reason` what refused the frontmatter as a whole.
865
+ */
866
+ declare class SkillMarkdownError extends Error {
867
+ readonly details?: {
868
+ issues: SkillMarkdownIssue[];
869
+ };
870
+ readonly reason?: SkillFrontmatterRefusal;
871
+ constructor(message: string, details?: {
872
+ issues: SkillMarkdownIssue[];
873
+ }, reason?: SkillFrontmatterRefusal);
874
+ }
875
+ /**
876
+ * Reads a `SKILL.md`: YAML frontmatter with title and description, then the content. A file
877
+ * without a name takes it from its folder, or from its own file name. `skillPath` separates
878
+ * its segments with `/`. This module runs in a browser too, so it reads the path as text.
879
+ */
880
+ declare function parseSkillMarkdown(contents: string, skillFile: string, skillPath: string): unknown;
881
+ /**
882
+ * The title a skill is shown under where its `SKILL.md` names none, as the public skill
883
+ * convention does not: the first Markdown heading of its content, or else its name with
884
+ * spaces for hyphens and underscores and a capital first letter.
885
+ */
886
+ declare function deriveSkillTitle(name: string, content: string): string;
887
+ /**
888
+ * A `SKILL.md` of a skill's config: what `parseSkillMarkdown` reads back as the same name,
889
+ * title, description, summary, starters, content and further frontmatter. A title the content
890
+ * or the name gives anyway is left out, as a file of the public skill convention has none. It
891
+ * is what a skill that was written as its config has for a file.
892
+ */
893
+ declare function formatSkillMarkdown(skill: {
894
+ name: string;
895
+ title: string;
896
+ description: string;
897
+ summary?: string;
898
+ starters?: SkillStarterConfig[];
899
+ content: string;
900
+ frontmatter?: Record<string, unknown>;
901
+ }): string;
902
+
903
+ /**
904
+ * Why a value read from YAML is not taken, or nothing where it is. `alias`: an object or a
905
+ * list is in it more than once, which only an anchor with an alias or a merge makes; no file
906
+ * the platform reads needs one, so none is taken, and no count of them has to be right.
907
+ * `depth`: it nests deeper than `maxDepth`, where its reader names one; a file whose own
908
+ * rules say how deep it nests, as a Workflow's blocks do, names none. The walk is linear in
909
+ * what the file holds: it visits each object once and ends at the first one it meets twice.
910
+ */
911
+ declare function yamlValueIssue(value: unknown, maxDepth?: number): "alias" | "depth" | undefined;
912
+ /** The sentence a reader of a YAML file answers for an issue of its value. */
913
+ declare function yamlValueIssueSentence(issue: "alias" | "depth", maxDepth?: number): string;
914
+
915
+ /**
916
+ * How many values a YAML file holds once every alias is followed. It stops a file of a few
917
+ * hundred bytes whose aliases expand to a billion values ("billion laughs"), which hung the
918
+ * server on its first walk. The largest honest manifest holds a few thousand.
919
+ */
920
+ declare const YAML_DATA_MAX_VALUES = 100000;
921
+ type YamlDataIssueCode = "yaml_invalid" | "yaml_alias" | "yaml_too_deep" | "yaml_too_large" | "text_invalid";
922
+ interface YamlDataIssue {
923
+ code: YamlDataIssueCode;
924
+ /** One sentence that names the file. */
925
+ message: string;
926
+ /** The line of the file, from 1, where the reader stopped. */
927
+ line?: number;
928
+ /** The column of that line, from 1. */
929
+ column?: number;
930
+ }
931
+ interface YamlDataOptions {
932
+ /**
933
+ * Refuses an anchor with an alias or a merge key, before anything walks the value. The
934
+ * readers of an asset's own files ask for it: none of those files needs one.
935
+ */
936
+ refuseAliases?: boolean;
937
+ }
938
+ type YamlDataResult = {
939
+ ok: true;
940
+ value: unknown;
941
+ } | {
942
+ ok: false;
943
+ issue: YamlDataIssue;
944
+ };
945
+ /**
946
+ * Whether Postgres can store a text, in a `text` column or in `jsonb`: it holds neither a NUL
947
+ * character nor half of a surrogate pair. With the `u` flag a whole pair is one code point, so
948
+ * only half of one matches `\p{Surrogate}`.
949
+ */
950
+ declare function isStorableText(text: string): boolean;
951
+ /**
952
+ * Whether every text and key of a JSON-like value can be stored. It walks at most `maxValues`
953
+ * values, a value reached twice counted twice, and answers `too_large` beyond that. It walks
954
+ * without recursion, so no nesting ends it.
955
+ */
956
+ declare function checkStorableTexts(value: unknown, maxValues: number): "storable" | "unstorable" | "too_large";
957
+ /**
958
+ * Reads YAML that an author or an agent wrote as data: the schema knows JSON types alone and
959
+ * builds nothing else. A file that does not parse, nests too deep, expands too far through its
960
+ * aliases or holds text that cannot be stored is answered as an issue, never thrown.
961
+ */
962
+ declare function readYamlData(text: string, file: string, options?: YamlDataOptions): YamlDataResult;
963
+ /** A YAML file `loadYamlData` refused. `issue` says why. */
964
+ declare class YamlDataError extends Error {
965
+ readonly issue: YamlDataIssue;
966
+ constructor(issue: YamlDataIssue);
967
+ }
968
+ /** `readYamlData` for a caller that reports a refused file as an error: it throws `YamlDataError`. */
969
+ declare function loadYamlData(text: string, file: string): unknown;
970
+
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 };