@work-shape/catalyst-asset-schemas 0.8.0-rc.7 → 0.8.0-rc.9

package/dist/index.d.ts

@@ -154,7 +154,7 @@ type OperationScope = Exclude<FirstPartyAuthScope, "*">;
  * Every right of the platform, one file per domain under `contract-values/`. The order is kept:
  * `GRANTABLE_ACTIONS` filters it, and the rights dialog lists rights in it.
  */
-declare const ACTIONS: readonly ["agent.read", "agent.write", "agent.publish", "agent.delete", "skill.read", "skill.write", "skill.delete", "skill.approve", "connection.read", "connection.use", "connection.write", "connection.delete", "connection.approve", "app.read", "app.write", "app.publish", "app.approve", "app.delete", "app.use", "workflow.read", "workflow.write", "workflow.publish", "workflow.approve", "workflow.delete", "workflow.use", "workflow.read_run_data", "data_store.read", "data_store.write", "data_store.publish", "data_store.delete", "data_store.insert", "data_store.execute", "data_store.records", "knowledge_base.read", "knowledge_base.write", "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", "usage.view", "audit.view", "api_access.manage", "service_principals.manage", "agent_models.manage", "roles.edit_built_in", "assets.release", "builder", "publisher"];
+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.publish", "knowledge_base.delete", "knowledge_base.use", "mail_sender.use", "guardrail.read", "guardrail.write", "guardrail.publish", "guardrail.delete", "operations.approve", "feedback.review", "users.manage", "usage.view", "audit.view", "api_access.manage", "service_principals.manage", "agent_models.manage", "roles.edit_built_in", "assets.release", "builder", "publisher"];
 type PlatformAction = (typeof ACTIONS)[number];
 type AppErrorCode = (typeof APP_ERROR_CODES)[number];
 /** The HTTP status every error code answers with. */
@@ -169,11 +169,11 @@ declare const IDEMPOTENCY_KEY_MAX_LENGTH = 255;
 declare const PROVIDER_PORTS: readonly ["models", "mail", "objectStorage", "sandbox", "secrets"];
 type ProviderPort = (typeof PROVIDER_PORTS)[number];
 /**
- * Where a provider processes the data an instance sends it. Product-owned and closed: a vendor's
- * own region name is a separate field of its adapter, such as `bucketRegion`.
+ * Where a provider processes the data an instance sends it. Only `eu` admits personal
+ * Connections; other short strings describe routes outside that boundary.
  */
 declare const PROVIDER_REGIONS: readonly ["eu", "global"];
-type ProviderRegion = (typeof PROVIDER_REGIONS)[number];
+type ProviderRegion = string;
 /**
  * Why a check failed. Product-owned and closed: it is all of a failure that reaches a log, the
  * API or a page, so a provider's own error text, which can repeat a key or an address, cannot.
@@ -248,6 +248,12 @@ declare const API_CREDENTIAL_SCOPES: readonly ["config_assets:read", "config_ass
 type ApiCredentialScope = (typeof API_CREDENTIAL_SCOPES)[number];
 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"];
 declare const OPERATION_EFFECTS: readonly ["reading", "changing"];
+/** The parts a catalogue entry can bring: tools agents call, or a Knowledge Base source. */
+declare const CATALOGUE_PARTS: readonly ["tools", "source"];
+type CataloguePart = (typeof CATALOGUE_PARTS)[number];
+/** The categories a catalogue entry's card is filed under. */
+declare const CATALOGUE_CATEGORIES: readonly ["mail", "files", "accounting", "databases", "other"];
+type CatalogueCategory = (typeof CATALOGUE_CATEGORIES)[number];
 declare const OPERATION_TARGETS: readonly ["live", "test", "dry_run"];
 type OperationTarget = (typeof OPERATION_TARGETS)[number];
 declare const OPERATION_RUN_STATUSES: readonly ["running", "pending_confirmation", "pending_approval", "done", "failed", "denied", "expired"];
@@ -286,6 +292,12 @@ declare const CONFIG_ASSET_CHANGE_OPERATIONS: readonly ["create", "update", "del
 type ConfigAssetChangeOperation = (typeof CONFIG_ASSET_CHANGE_OPERATIONS)[number];
 declare const AGENT_AVAILABILITY_MODES: readonly ["all", "selected"];
 type AgentAvailabilityMode = (typeof AGENT_AVAILABILITY_MODES)[number];
+/**
+ * Who uses an agent where it is available (AGENT-USE-1): everyone who may work there, or only
+ * those `agent.use` allows on it. Every agent starts at `everyone`.
+ */
+declare const AGENT_USE_SETTINGS: readonly ["everyone", "granted"];
+type AgentUse = (typeof AGENT_USE_SETTINGS)[number];
 declare const AGENT_EDITABLE_FIELDS: readonly ["displayName", "description", "welcomeMessage", "welcomeSubtitle", "instructions", "modelBindingId", "reasoningEffort", "maxSteps", "toolNames", "skillNames", "knowledgeBases", "initialPrompts"];
 type AgentEditableField = (typeof AGENT_EDITABLE_FIELDS)[number];
 declare const ASSET_REPO_BUNDLE_KINDS: readonly ["full", "incremental"];
@@ -347,6 +359,10 @@ declare const TOOL_INPUT_PARSE_ERROR_CODES: readonly ["invalid_json", "invalid_t
 type ToolInputParseErrorCode = (typeof TOOL_INPUT_PARSE_ERROR_CODES)[number];
 declare const WAITING_OPERATION_RUN_STATUSES: readonly ["pending_confirmation", "pending_approval"];
 declare const OPERATION_CONFIRMATION_DECISIONS: readonly ["confirm", "decline"];
+/** A person's own value for an operation (OP-6): Always allow, Ask me, Never. */
+declare const PERSON_POLICY_SETTINGS: readonly ["always_allow", "ask", "never"];
+/** How far a changing operation reaches. One that declares none counts as `irreversible`. */
+declare const OPERATION_CHANGE_CLASSES: readonly ["reversible", "irreversible", "outward"];
 declare const TOOL_DECISION_MODES: readonly ["confirm", "approval"];
 declare const TOOL_DECISION_OUTCOMES: readonly ["confirmed", "declined", "expired", "cancelled"];
 declare const TOOL_CALL_STATES: readonly ["input_available", "waiting_for_decision", "output_available", "output_error"];
@@ -381,6 +397,9 @@ declare const CONNECTION_SECRET_STATES: readonly ["set", "not_set", "unreadable"
 type ConnectionSecretState = (typeof CONNECTION_SECRET_STATES)[number];
 declare const CONNECTOR_TEST_STATUSES: readonly ["ready", "unauthorized", "network_denied", "unavailable", "oauth_required"];
 type ConnectorTestStatus = (typeof CONNECTOR_TEST_STATUSES)[number];
+/** Shared account, or the acting person's own account. */
+declare const CONNECTION_CREDENTIAL_MODES: readonly ["shared", "user"];
+type ConnectionCredentialMode = (typeof CONNECTION_CREDENTIAL_MODES)[number];
 /**
  * The state of a Connection's sign-in. `connected`: calls use it. `needs_reconnect`: the
  * outside system refused it and a new sign-in is needed. `revoked`: someone disconnected it,
@@ -388,6 +407,14 @@ type ConnectorTestStatus = (typeof CONNECTOR_TEST_STATUSES)[number];
  */
 declare const CONNECTION_BINDING_STATES: readonly ["connected", "needs_reconnect", "revoked"];
 type ConnectionBindingState = (typeof CONNECTION_BINDING_STATES)[number];
+/** What a chat Connection proposal's card needs to start setup or sign-in. */
+declare const CONNECTION_PROPOSAL_STATES: readonly ["ready", "needs_setup"];
+type ConnectionProposalState = (typeof CONNECTION_PROPOSAL_STATES)[number];
+declare const CONNECTION_PROPOSAL_BINDING_STATES: readonly ["connected", "needs_reconnect", "not_connected"];
+type ConnectionProposalBindingState = (typeof CONNECTION_PROPOSAL_BINDING_STATES)[number];
+/** What a refused call of a personal Connection needs of its person: a first or a new sign-in. */
+declare const CONNECTION_SIGN_IN_NEEDS: readonly ["not_connected", "needs_reconnect"];
+type ConnectionSignInNeed = (typeof CONNECTION_SIGN_IN_NEEDS)[number];
 /**
  * How a Connection that signs in with OAuth has its client: registered by the platform
  * (Dynamic Client Registration) or issued by the provider and named in the settings.
@@ -488,6 +515,12 @@ declare const WORKFLOW_RUN_STATUSES: readonly ["continued", "queued", "running",
 type WorkflowRunStatus = (typeof WORKFLOW_RUN_STATUSES)[number];
 declare const WORKFLOW_STEP_TYPES: readonly ["trigger", "operation", "loop", "code", "output", "agent", "notify", "workflow"];
 type WorkflowStepType = (typeof WORKFLOW_STEP_TYPES)[number];
+/**
+ * The step types this release executes. The engine accepts no definition that names another,
+ * and the interface offers no other in its palette (workflow-canvas 9.6). A list of its own, so
+ * it can be narrower than `WORKFLOW_STEP_TYPES` while a known type is not run yet.
+ */
+declare const WORKFLOW_EXECUTED_STEP_TYPES: readonly ["trigger", "operation", "loop", "code", "output", "agent", "notify", "workflow"];
 declare const WORKFLOW_RESERVED_STEP_TYPES: readonly ["condition", "parallel"];
 type WorkflowReservedStepType = (typeof WORKFLOW_RESERVED_STEP_TYPES)[number];
 declare const WORKFLOW_TRIGGER_KINDS: readonly ["manual", "schedule", "parent"];
@@ -500,6 +533,12 @@ declare const NOTIFY_CHANNELS: readonly ["inbox", "mail"];
  */
 declare const WORKFLOW_STEP_SOURCE_KINDS: readonly ["connection", "data_store", "knowledge_base", "workflow", "mail_sender", "other"];
 type WorkflowStepSourceKind = (typeof WORKFLOW_STEP_SOURCE_KINDS)[number];
+/**
+ * What an operation a step may call belongs to (`operations.list_callable`, WF-EDIT-3). `other`
+ * is an operation of the release.
+ */
+declare const OPERATION_SOURCE_KINDS: readonly ["connection", "data_store", "knowledge_base", "workflow", "other"];
+type OperationSourceKind = (typeof OPERATION_SOURCE_KINDS)[number];
 type NotifyChannel = (typeof NOTIFY_CHANNELS)[number];
 declare const PRINCIPAL_HOLDER_KINDS: readonly ["user", "service_principal"];
 type PrincipalHolderKind = (typeof PRINCIPAL_HOLDER_KINDS)[number];
@@ -511,6 +550,12 @@ declare const CONNECTION_OPERATION_POLICIES: readonly ["deny", "approval"];
 type ConnectionOperationPolicy = (typeof CONNECTION_OPERATION_POLICIES)[number];
 declare const WORKFLOW_RUN_MODES: readonly ["live", "test"];
 type WorkflowRunMode = (typeof WORKFLOW_RUN_MODES)[number];
+/**
+ * Which revision of a Workflow a test run an App's draft started ran (DP-1): its draft, for a
+ * tester who may write it, or its published revision.
+ */
+declare const WORKFLOW_TEST_REVISIONS: readonly ["draft", "published"];
+type WorkflowTestRevision = (typeof WORKFLOW_TEST_REVISIONS)[number];
 declare const APP_ACTION_CALL_STATUSES: readonly ["done", "pending_approval"];
 type AppActionCallStatus = (typeof APP_ACTION_CALL_STATUSES)[number];
 declare const OPERATIONS_AUDIENCES: readonly ["workflow", "app"];
@@ -567,6 +612,8 @@ declare const SCHEDULED_START_STATES: readonly ["active", "paused"];
 /** Which revision answered an agent preview turn. */
 declare const AGENT_PREVIEW_SOURCES: readonly ["draft", "live"];
 
+/** A short operator declaration of where a provider processes data. */
+declare const providerRegionSchema: z.ZodString;
 declare const localizedStringSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
     en: z.ZodOptional<z.ZodString>;
     de: z.ZodOptional<z.ZodString>;
@@ -2617,4 +2664,71 @@ type FeedbackSubjectKind = (typeof FEEDBACK_SUBJECT_KINDS)[number];
 declare const FEEDBACK_STATES: readonly ["new", "handled"];
 type FeedbackState = (typeof FEEDBACK_STATES)[number];
 
-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, 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 ApiCredentialScope, type AppActionCallStatus, type AppErrorCode, type AppMode, type ApprovalCheckFailureOutcome, type ApprovalCheckStatus, type ApprovalExecution, type ApprovalRequestStatus, type ArtifactPreviewImageFormat, type ArtifactPreviewImageMimeType, type ArtifactPreviewStatus, type AssetLifecycle, type AssetNameRefusalReason, type AssetOwnerKind, type AssetRepoBundleKind, type AssetRepresentation, type AssetSyncChangeType, type AttachmentCreateOutcome, type AuditActorKind, type AuditEventStatus, type AuditOutcome, type AuditTier, type AuthPrincipalKind, CHAT_MESSAGE_ROLES, CHAT_SESSION_AUTH_SCOPES, COLLABORATION_WORKSPACE_KINDS, CONFIG_ASSET_CHANGE_OPERATIONS, CONFIG_ASSET_KINDS, CONNECTION_BINDING_STATES, 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_PROVIDER_REVOCATIONS, CONNECTION_SECRET_STATES, CONNECTOR_TEST_STATUSES, CONVERSATION_ATTACHMENT_STATUSES, CONVERSATION_KINDS, CONVERSATION_VISIBILITIES, type ChatMessageRole, type ChatSessionAuthScope, type CollaborationWorkspaceKind, type ConfigAssetChangeOperation, type ConfigAssetKind, type ConnectionBindingState, type ConnectionExposure, type ConnectionHealth, type ConnectionNetwork, type ConnectionOAuthRegistration, type ConnectionOperationPolicy, type ConnectionOperationStatus, type ConnectionOrigin, type ConnectionProviderRevocation, type ConnectionSecretState, 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_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 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, 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_CONFIRMATION_DECISIONS, OPERATION_DENIAL_REASONS, OPERATION_EFFECTS, OPERATION_ORIGIN_KINDS, OPERATION_RUN_DECISION_MODES, OPERATION_RUN_DECISION_REASONS, OPERATION_RUN_STATUSES, OPERATION_TARGETS, type OpenaiCompatibleApi, type OperationBatchFailure, type OperationBatchResult, type OperationDenialReason, type OperationEffect, type OperationOriginKind, type OperationPaging, type OperationRunDecisionMode, type OperationRunDecisionReason, type OperationRunStatus, type OperationScope, type OperationTarget, type OperationsAudience, POLICY_VALUES, PRINCIPAL_HOLDER_KINDS, PROVIDER_CHECK_ERROR_CLASSES, PROVIDER_PORTS, PROVIDER_REGIONS, 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, 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_COST_STATUSES, USER_STATUSES, type UsageCostStatus, type UserStatus, WAITING_OPERATION_RUN_STATUSES, WEB_SOURCE_PROVIDERS, WORKFLOW_DATASET_DOWNLOAD_FORMATS, WORKFLOW_DATASET_STATES, WORKFLOW_ENDED_STATUSES, 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_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 WorkflowTriggerKind, type WorkspaceAccentColor, type WorkspaceAccessState, type WorkspaceCommandStatus, type WorkspaceFileKind, type WorkspaceMembershipRole, type WorkspaceSection, type WorkspaceVisibility, YAML_DATA_MAX_VALUES, YamlDataError, type YamlDataIssue, type YamlDataIssueCode, type YamlDataOptions, type YamlDataResult, agentConfigSchema, checkStorableTexts, dataScopeNameSchema, dataScopesSchema, dataStoreRecordFieldSchema, dataStoreRecordProposalItemSchema, dataStoreRecordsContracts, dataStoreRecordsDecideInputSchema, dataStoreRecordsDecideOutputSchema, dataStoreRecordsFlaggedInputSchema, dataStoreRecordsFlaggedOutputSchema, dataStoreRecordsProposeInputSchema, dataStoreRecordsRuleSchema, deriveSkillTitle, formatSkillMarkdown, isStorableText, knowledgeExtractFieldsInputSchema, knowledgeExtractFieldsOutputSchema, knowledgeFieldValueSchema, knowledgeIngestFetchSchema, knowledgeIngestInputSchema, knowledgeIngestItemSchema, knowledgeIngestOutputSchema, knowledgeLocateInputSchema, knowledgeLocateOutputSchema, knowledgePendingInputSchema, knowledgePendingOutputSchema, knowledgePendingRowSchema, knowledgeProcessorOutputSchema, knowledgePutProcessedInputSchema, knowledgeRecordsRefusalSchema, knowledgeRetryInputSchema, knowledgeRetryOutputSchema, knowledgeSourceItemsInputSchema, knowledgeSourceItemsOutputSchema, knowledgeSourcesOutputSchema, knowledgeSyncInputSchema, knowledgeSyncResultSchema, knowledgeWithdrawInputSchema, knowledgeWithdrawOutputSchema, knowledgeWorkflowSourceSchema, knowledgeWriteContracts, loadYamlData, localeCodes, localizedStringSchema, mailAddressSchema, mailBodySchema, mailCopyRecipientListSchema, mailPreviewRecipientSchema, mailRecipientDomainSchema, mailRecipientListSchema, mailRecipientSchema, mailReplyToSchema, mailSendContract, mailSendInputSchema, mailSendOutputSchema, mailSendPreviewSchema, mailSendRefusalDetailsSchema, mailSendSimulatedOutputSchema, mailSenderIdSchema, mailSenderNameSchema, mailSubjectSchema, operationBatchFailureSchema, operationBatchResultSchema, operationPagingSchema, parseSkillMarkdown, readYamlData, recordEvidenceResultSchema, scopeAssignmentInputSchema, scopedTablesSchema, skillConfigSchema, skillFileEntrySchema, skillFileFrontmatterSchema, skillNameSchema, skillPortabilityIssues, skillResourceConfigSchema, skillResourceMediaTypeForPath, skillResourcePathSchema, skillStarterSchema, workflowConfigSchema, workflowDataFlowsSchema, workflowDatasetReferenceSchema, workflowMailSenderFactSchema, workflowMessageMailParamsSchema, yamlValueIssue, yamlValueIssueSentence };
+/** The source of an operation. A source the caller may not read is told by its kind alone. */
+declare const operationSourceSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        workflow: "workflow";
+        other: "other";
+        connection: "connection";
+        data_store: "data_store";
+        knowledge_base: "knowledge_base";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    service: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type OperationSourceView = z.infer<typeof operationSourceSchema>;
+declare const callableOperationSchema: z.ZodObject<{
+    name: z.ZodString;
+    effect: z.ZodEnum<{
+        reading: "reading";
+        changing: "changing";
+    }>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    source: z.ZodObject<{
+        kind: z.ZodEnum<{
+            workflow: "workflow";
+            other: "other";
+            connection: "connection";
+            data_store: "data_store";
+            knowledge_base: "knowledge_base";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        service: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    available: z.ZodBoolean;
+    inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type CallableOperationView = z.infer<typeof callableOperationSchema>;
+/** One page of callable operations. */
+declare const callableOperationsPageSchema: z.ZodObject<{
+    operations: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        effect: z.ZodEnum<{
+            reading: "reading";
+            changing: "changing";
+        }>;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        source: z.ZodObject<{
+            kind: z.ZodEnum<{
+                workflow: "workflow";
+                other: "other";
+                connection: "connection";
+                data_store: "data_store";
+                knowledge_base: "knowledge_base";
+            }>;
+            title: z.ZodOptional<z.ZodString>;
+            service: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        available: z.ZodBoolean;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+type CallableOperationsPage = z.infer<typeof callableOperationsPageSchema>;
+
+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_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 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, 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, 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, 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_COST_STATUSES, 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, knowledgeIngestFetchSchema, knowledgeIngestInputSchema, knowledgeIngestItemSchema, knowledgeIngestOutputSchema, knowledgeLocateInputSchema, knowledgeLocateOutputSchema, knowledgePendingInputSchema, knowledgePendingOutputSchema, knowledgePendingRowSchema, knowledgeProcessorOutputSchema, knowledgePutProcessedInputSchema, knowledgeRecordsRefusalSchema, knowledgeRetryInputSchema, knowledgeRetryOutputSchema, knowledgeSourceItemsInputSchema, knowledgeSourceItemsOutputSchema, knowledgeSourcesOutputSchema, knowledgeSyncInputSchema, knowledgeSyncResultSchema, knowledgeWithdrawInputSchema, knowledgeWithdrawOutputSchema, knowledgeWorkflowSourceSchema, 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, recordEvidenceResultSchema, scopeAssignmentInputSchema, scopedTablesSchema, skillConfigSchema, skillFileEntrySchema, skillFileFrontmatterSchema, skillNameSchema, skillPortabilityIssues, skillResourceConfigSchema, skillResourceMediaTypeForPath, skillResourcePathSchema, skillStarterSchema, workflowConfigSchema, workflowDataFlowsSchema, workflowDatasetReferenceSchema, workflowMailSenderFactSchema, workflowMessageMailParamsSchema, yamlValueIssue, yamlValueIssueSentence };

package/dist/index.js

@@ -20,7 +20,11 @@ var AGENT_ACTIONS = [
   "agent.read",
   "agent.write",
   "agent.publish",
-  "agent.delete"
+  // Decides a held publish of an agent a workspace owns (WS-PUB-1b).
+  "agent.approve",
+  "agent.delete",
+  // Converse with the agent where it is available (AGENT-USE-1).
+  "agent.use"
 ];
 
 // src/contract-values/skill.ts
@@ -281,6 +285,8 @@ var APP_ERROR_CODES = [
   "INTERNAL"
 ];
 var OPERATION_EFFECTS = ["reading", "changing"];
+var CATALOGUE_PARTS = ["tools", "source"];
+var CATALOGUE_CATEGORIES = ["mail", "files", "accounting", "databases", "other"];
 var OPERATION_TARGETS = ["live", "test", "dry_run"];
 var OPERATION_RUN_STATUSES = [
   "running",
@@ -351,6 +357,7 @@ var ASSET_REPRESENTATIONS = ["config", "files"];
 var CONFIG_ASSET_KINDS = ["agent", "skill"];
 var CONFIG_ASSET_CHANGE_OPERATIONS = ["create", "update", "delete", "revert"];
 var AGENT_AVAILABILITY_MODES = ["all", "selected"];
+var AGENT_USE_SETTINGS = ["everyone", "granted"];
 var AGENT_EDITABLE_FIELDS = [
   "displayName",
   "description",
@@ -461,6 +468,8 @@ var WAITING_OPERATION_RUN_STATUSES = [
   "pending_approval"
 ];
 var OPERATION_CONFIRMATION_DECISIONS = ["confirm", "decline"];
+var PERSON_POLICY_SETTINGS = ["always_allow", "ask", "never"];
+var OPERATION_CHANGE_CLASSES = ["reversible", "irreversible", "outward"];
 var TOOL_DECISION_MODES = ["confirm", "approval"];
 var TOOL_DECISION_OUTCOMES = ["confirmed", "declined", "expired", "cancelled"];
 var TOOL_CALL_STATES = [
@@ -519,7 +528,15 @@ var CONNECTOR_TEST_STATUSES = [
   /** The server asks for an OAuth sign-in, or the Connection signs in and nobody has. */
   "oauth_required"
 ];
+var CONNECTION_CREDENTIAL_MODES = ["shared", "user"];
 var CONNECTION_BINDING_STATES = ["connected", "needs_reconnect", "revoked"];
+var CONNECTION_PROPOSAL_STATES = ["ready", "needs_setup"];
+var CONNECTION_PROPOSAL_BINDING_STATES = [
+  "connected",
+  "needs_reconnect",
+  "not_connected"
+];
+var CONNECTION_SIGN_IN_NEEDS = ["not_connected", "needs_reconnect"];
 var CONNECTION_OAUTH_REGISTRATIONS = ["dcr", "preregistered"];
 var CONNECTION_PROVIDER_REVOCATIONS = ["confirmed", "failed", "not_offered"];
 var CONNECTION_ORIGINS = ["release", "runtime"];
@@ -641,6 +658,7 @@ var WORKFLOW_STEP_TYPES = [
   /** Starts another Workflow as a child run and waits for it. */
   "workflow"
 ];
+var WORKFLOW_EXECUTED_STEP_TYPES = [...WORKFLOW_STEP_TYPES];
 var WORKFLOW_RESERVED_STEP_TYPES = [
   /** Reserved in the contract: drawn, and run by no engine yet. */
   "condition",
@@ -656,6 +674,13 @@ var WORKFLOW_STEP_SOURCE_KINDS = [
   "mail_sender",
   "other"
 ];
+var OPERATION_SOURCE_KINDS = [
+  "connection",
+  "data_store",
+  "knowledge_base",
+  "workflow",
+  "other"
+];
 var PRINCIPAL_HOLDER_KINDS = [
   "user",
   "service_principal"
@@ -670,6 +695,7 @@ var CONNECTION_OPERATION_POLICIES = [
   "approval"
 ];
 var WORKFLOW_RUN_MODES = ["live", "test"];
+var WORKFLOW_TEST_REVISIONS = ["draft", "published"];
 var APP_ACTION_CALL_STATUSES = [
   "done",
   "pending_approval"
@@ -792,6 +818,7 @@ function yamlValueIssueSentence(issue, maxDepth) {
 }
 
 // src/schemas.ts
+var providerRegionSchema = z.string().trim().min(1).max(32);
 var localizedStringMapSchema = z.object({
   en: z.string().min(1).optional(),
   de: z.string().min(1).optional()
@@ -2020,6 +2047,36 @@ var FEEDBACK_CATEGORY_MAX_LENGTH = 60;
 var FEEDBACK_NOTE_MAX_LENGTH = 2e3;
 var FEEDBACK_SUBJECT_KINDS = ["message"];
 var FEEDBACK_STATES = ["new", "handled"];
+
+// src/callable-operations.ts
+import { z as z10 } from "zod";
+var operationSourceSchema = z10.object({
+  kind: z10.enum(OPERATION_SOURCE_KINDS),
+  title: z10.string().optional(),
+  /** The Connection's `service`, for its icon. */
+  service: z10.string().optional()
+});
+var jsonSchemaObject = z10.record(z10.string(), z10.unknown());
+var callableOperationSchema = z10.object({
+  /** What a step writes under `operation`. */
+  name: z10.string(),
+  effect: z10.enum(OPERATION_EFFECTS),
+  title: z10.string(),
+  /** The operation's own description, where its source gives one. */
+  description: z10.string().optional(),
+  source: operationSourceSchema,
+  /** False where a call cannot reach its source now, such as a Connection that is off. */
+  available: z10.boolean(),
+  inputSchema: jsonSchemaObject.optional(),
+  outputSchema: jsonSchemaObject.optional()
+});
+var callableOperationsPageSchema = z10.object({
+  operations: z10.array(callableOperationSchema),
+  /** Passed back as `cursor`, with the same filters, until it is absent. */
+  nextCursor: z10.string().optional(),
+  /** A source left operations out: a missing name proves no absence. */
+  truncated: z10.boolean()
+});
 export {
   ACCESS_SOURCES,
   ACTIONS,
@@ -2031,6 +2088,7 @@ export {
   AGENT_RUN_FAILURE_CATEGORIES,
   AGENT_RUN_STATUSES,
   AGENT_STARTERS_MAX,
+  AGENT_USE_SETTINGS,
   API_CREDENTIAL_SCOPES,
   APPROVAL_CHECK_FAILURE_OUTCOMES,
   APPROVAL_CHECK_STATUSES,
@@ -2058,12 +2116,15 @@ export {
   AUDIT_TIERS,
   AUTH_PRINCIPAL_KINDS,
   AUTH_SCOPE_WILDCARD,
+  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,
@@ -2073,8 +2134,11 @@ export {
   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,
@@ -2161,6 +2225,7 @@ export {
   NOTIFY_CHANNELS,
   OPENAI_COMPATIBLE_APIS,
   OPERATIONS_AUDIENCES,
+  OPERATION_CHANGE_CLASSES,
   OPERATION_CONFIRMATION_DECISIONS,
   OPERATION_DENIAL_REASONS,
   OPERATION_EFFECTS,
@@ -2168,7 +2233,9 @@ export {
   OPERATION_RUN_DECISION_MODES,
   OPERATION_RUN_DECISION_REASONS,
   OPERATION_RUN_STATUSES,
+  OPERATION_SOURCE_KINDS,
   OPERATION_TARGETS,
+  PERSON_POLICY_SETTINGS,
   POLICY_VALUES,
   PRINCIPAL_HOLDER_KINDS,
   PROVIDER_CHECK_ERROR_CLASSES,
@@ -2219,6 +2286,7 @@ export {
   WORKFLOW_DATASET_DOWNLOAD_FORMATS,
   WORKFLOW_DATASET_STATES,
   WORKFLOW_ENDED_STATUSES,
+  WORKFLOW_EXECUTED_STEP_TYPES,
   WORKFLOW_KINDS,
   WORKFLOW_MARKDOWN_MAX_COLUMNS,
   WORKFLOW_MARKDOWN_MAX_ROWS,
@@ -2234,6 +2302,7 @@ export {
   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,
@@ -2248,6 +2317,8 @@ export {
   YAML_DATA_MAX_VALUES,
   YamlDataError,
   agentConfigSchema,
+  callableOperationSchema,
+  callableOperationsPageSchema,
   checkStorableTexts,
   dataScopeNameSchema,
   dataScopesSchema,
@@ -2312,7 +2383,9 @@ export {
   operationBatchFailureSchema,
   operationBatchResultSchema,
   operationPagingSchema,
+  operationSourceSchema,
   parseSkillMarkdown,
+  providerRegionSchema,
   readYamlData,
   recordEvidenceResultSchema,
   scopeAssignmentInputSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@work-shape/catalyst-asset-schemas",
-  "version": "0.8.0-rc.7",
+  "version": "0.8.0-rc.9",
   "license": "MIT",
   "repository": {
     "type": "git",