@work-shape/catalyst-asset-schemas 0.8.0-rc.6 → 0.8.0-rc.8

package/dist/index.d.ts

@@ -51,6 +51,11 @@ interface AgentConfig {
      */
     knowledgeBases?: string[];
     initialPrompts: AgentInitialPromptConfig[];
+    /**
+     * An agent that ships with the platform: its fields as the release shipped them last. Only
+     * the release seed writes it; every other write keeps it as stored.
+     */
+    shipped?: Record<string, unknown>;
 }
 interface SkillConfig {
     name: string;
@@ -145,7 +150,11 @@ declare const FIRST_PARTY_AUTH_SCOPES: readonly ["*", "me:read", "me:delete", "c
 type ChatSessionAuthScope = (typeof CHAT_SESSION_AUTH_SCOPES)[number];
 type FirstPartyAuthScope = (typeof FIRST_PARTY_AUTH_SCOPES)[number];
 type OperationScope = Exclude<FirstPartyAuthScope, "*">;
-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", "assets.release", "builder", "publisher"];
+/**
+ * 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", "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. */
@@ -200,9 +209,9 @@ type GrantScopeKind = (typeof GRANT_SCOPE_KINDS)[number];
 /** Where a role's grant lies: the whole instance, one workspace or one asset. */
 declare const ROLE_GRANT_SCOPE_KINDS: readonly ["instance", "workspace", "asset"];
 type RoleGrantScopeKind = (typeof ROLE_GRANT_SCOPE_KINDS)[number];
-/** What a release did to an action of a built-in role's default that waits for a superadmin. */
+/** What a release did to an action of a built-in role's default that waits for a decision. */
 declare const ROLE_PENDING_CHANGES: readonly ["added", "removed"];
-/** A superadmin's decision on a pending action: apply what the release did, or dismiss it. */
+/** The decision on a pending action: apply what the release did, or dismiss it. */
 declare const ROLE_PENDING_DECISIONS: readonly ["apply", "dismiss"];
 type RolePendingDecision = (typeof ROLE_PENDING_DECISIONS)[number];
 declare const GRANT_EFFECTS: readonly ["allow", "deny"];
@@ -239,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"];
@@ -277,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"];
@@ -326,8 +347,10 @@ declare const ATTACHMENT_CREATE_OUTCOMES: readonly ["created", "already_availabl
 type AttachmentCreateOutcome = (typeof ATTACHMENT_CREATE_OUTCOMES)[number];
 declare const STRUCTURED_DATA_REVIEW_REASONS: readonly ["uncertain", "conflicting"];
 type StructuredDataReviewReason = (typeof STRUCTURED_DATA_REVIEW_REASONS)[number];
-declare const FOLLOW_UP_MODES: readonly ["queue"];
-declare const FOLLOW_UP_STATUSES: readonly ["pending", "dispatched", "cancelled"];
+/** Queued: sent as the next turn. Steer: taken in by the author's own running turn (FU-2). */
+declare const FOLLOW_UP_MODES: readonly ["queue", "steer"];
+/** `consumed`: a steer the running turn took in; `dispatched`: started as a turn of its own. */
+declare const FOLLOW_UP_STATUSES: readonly ["pending", "dispatched", "consumed", "cancelled"];
 declare const AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_for_decision", "waiting_for_subagents", "cancelling", "completed", "cancelled", "failed"];
 type AgentRunStatus = (typeof AGENT_RUN_STATUSES)[number];
 declare const AGENT_RUN_FAILURE_CATEGORIES: readonly ["app_error", "internal_error", "runtime_interrupted", "abort_error", "unknown_error"];
@@ -477,6 +500,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"];
@@ -489,6 +518,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];
@@ -500,6 +535,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"];
@@ -749,6 +790,7 @@ declare const agentConfigSchema: z.ZodObject<{
             de: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>]>;
     }, z.core.$strip>>>;
+    shipped: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 /** The id of a Workflow, which is the name of its asset: part of `workflow.<id>.start`. */
 declare const WORKFLOW_NAME_PATTERN: RegExp;
@@ -2605,4 +2647,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_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 CallableOperationView, type CallableOperationsPage, type CatalogueCategory, type CataloguePart, 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_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, 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, readYamlData, recordEvidenceResultSchema, scopeAssignmentInputSchema, scopedTablesSchema, skillConfigSchema, skillFileEntrySchema, skillFileFrontmatterSchema, skillNameSchema, skillPortabilityIssues, skillResourceConfigSchema, skillResourceMediaTypeForPath, skillResourcePathSchema, skillStarterSchema, workflowConfigSchema, workflowDataFlowsSchema, workflowDatasetReferenceSchema, workflowMailSenderFactSchema, workflowMessageMailParamsSchema, yamlValueIssue, yamlValueIssueSentence };

package/dist/index.js

@@ -15,93 +15,101 @@ var SKILL_RESOURCE_MEDIA_TYPES = [
 ];
 var APP_AUDIENCES = ["self", "workspace", "instance"];
 
-// src/contract-values.ts
-var AUTH_SCOPE_WILDCARD = "*";
-var CHAT_SESSION_AUTH_SCOPES = [
-  "me:read",
-  "me:delete",
-  "config:read",
-  "conversation:read",
-  "conversation:write",
-  "run:start",
-  "run:observe",
-  "run:cancel",
-  "run:command"
-];
-var FIRST_PARTY_AUTH_SCOPES = [
-  AUTH_SCOPE_WILDCARD,
-  ...CHAT_SESSION_AUTH_SCOPES,
-  "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",
-  // Moving the published pointer of an asset. A credential that writes drafts with
-  // `config_assets:write` publishes none of them without this one.
-  "config_assets:publish",
-  "config_assets:release",
-  // The rows of a Data Store: reading them, and adding or loading them. The definition of a
-  // store and its migrations stay under `config_assets:*`. A scope caps what a key may be
-  // used for; whether its holder may do it is decided by the grants.
-  "data_store_rows:read",
-  "data_store_rows:write"
-];
-var ACTIONS = [
+// src/contract-values/agent.ts
+var AGENT_ACTIONS = [
   "agent.read",
   "agent.write",
   "agent.publish",
   "agent.delete",
+  // Converse with the agent where it is available (AGENT-USE-1).
+  "agent.use"
+];
+
+// src/contract-values/skill.ts
+var SKILL_ACTIONS = [
   "skill.read",
   "skill.write",
   "skill.delete",
-  "skill.approve",
+  "skill.approve"
+];
+
+// src/contract-values/connection.ts
+var CONNECTION_ACTIONS = [
   "connection.read",
   "connection.use",
   "connection.write",
   "connection.delete",
-  "connection.approve",
+  "connection.approve"
+];
+
+// src/contract-values/app.ts
+var APP_ACTIONS = [
   "app.read",
   "app.write",
   "app.publish",
   "app.approve",
   "app.delete",
-  "app.use",
+  "app.use"
+];
+
+// src/contract-values/workflow.ts
+var WORKFLOW_ACTIONS = [
   "workflow.read",
   "workflow.write",
   "workflow.publish",
   "workflow.approve",
   "workflow.delete",
   "workflow.use",
-  "workflow.read_run_data",
+  "workflow.read_run_data"
+];
+
+// src/contract-values/data-store.ts
+var DATA_STORE_ACTIONS = [
   "data_store.read",
   "data_store.write",
   "data_store.publish",
   "data_store.delete",
   "data_store.insert",
   "data_store.execute",
-  "data_store.records",
+  "data_store.records"
+];
+
+// src/contract-values/knowledge-base.ts
+var KNOWLEDGE_BASE_ACTIONS = [
   "knowledge_base.read",
   "knowledge_base.write",
   "knowledge_base.publish",
   "knowledge_base.delete",
-  "knowledge_base.use",
+  "knowledge_base.use"
+];
+
+// src/contract-values/mail-sender.ts
+var MAIL_SENDER_ACTIONS = [
   // Sending e-mail as one sender of the instance (`mail.send`). The `admin` role holds it on
   // the sender `system`; a member only by a grant.
-  "mail_sender.use",
+  "mail_sender.use"
+];
+
+// src/contract-values/guardrail.ts
+var GUARDRAIL_ACTIONS = [
   "guardrail.read",
   "guardrail.write",
   "guardrail.publish",
-  "guardrail.delete",
-  "operations.approve",
+  "guardrail.delete"
+];
+
+// src/contract-values/operations.ts
+var OPERATIONS_ACTIONS = ["operations.approve"];
+
+// src/contract-values/feedback.ts
+var FEEDBACK_ACTIONS = [
   // Reading the written feedback on agent messages and marking it handled (LU-4): on the
   // instance, or on one workspace for the agents it owns. No bundle carries it.
-  "feedback.review",
+  "feedback.review"
+];
+
+// src/contract-values/administration.ts
+var ADMINISTRATION_ACTIONS = [
   "users.manage",
   "usage.view",
   "audit.view",
@@ -110,11 +118,71 @@ var ACTIONS = [
   // Their keys stay with `api_access.manage`.
   "service_principals.manage",
   "agent_models.manage",
-  "assets.release",
+  // Editing and resetting the built-in roles `user` and `admin`, and deciding their pending
+  // actions (Felix, 2026-10-21). Its default sits with `superadmin` alone.
+  "roles.edit_built_in",
+  "assets.release"
+];
+
+// src/contract-values/workspace.ts
+var WORKSPACE_ACTIONS = [
   // The two bundles of a workspace: one row each, expanded by the evaluator (`bundleCarries`).
   "builder",
   "publisher"
 ];
+
+// src/contract-values.ts
+var AUTH_SCOPE_WILDCARD = "*";
+var CHAT_SESSION_AUTH_SCOPES = [
+  "me:read",
+  "me:delete",
+  "config:read",
+  "conversation:read",
+  "conversation:write",
+  "run:start",
+  "run:observe",
+  "run:cancel",
+  "run:command"
+];
+var FIRST_PARTY_AUTH_SCOPES = [
+  AUTH_SCOPE_WILDCARD,
+  ...CHAT_SESSION_AUTH_SCOPES,
+  "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",
+  // Moving the published pointer of an asset. A credential that writes drafts with
+  // `config_assets:write` publishes none of them without this one.
+  "config_assets:publish",
+  "config_assets:release",
+  // The rows of a Data Store: reading them, and adding or loading them. The definition of a
+  // store and its migrations stay under `config_assets:*`. A scope caps what a key may be
+  // used for; whether its holder may do it is decided by the grants.
+  "data_store_rows:read",
+  "data_store_rows:write"
+];
+var ACTIONS = [
+  ...AGENT_ACTIONS,
+  ...SKILL_ACTIONS,
+  ...CONNECTION_ACTIONS,
+  ...APP_ACTIONS,
+  ...WORKFLOW_ACTIONS,
+  ...DATA_STORE_ACTIONS,
+  ...KNOWLEDGE_BASE_ACTIONS,
+  ...MAIL_SENDER_ACTIONS,
+  ...GUARDRAIL_ACTIONS,
+  ...OPERATIONS_ACTIONS,
+  ...FEEDBACK_ACTIONS,
+  ...ADMINISTRATION_ACTIONS,
+  ...WORKSPACE_ACTIONS
+];
 var APP_ERROR_STATUS_CODES = {
   BAD_REQUEST: 400,
   UNAUTHENTICATED: 401,
@@ -215,6 +283,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",
@@ -285,6 +355,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",
@@ -370,8 +441,8 @@ var CONVERSATION_ATTACHMENT_STATUSES = [
 ];
 var ATTACHMENT_CREATE_OUTCOMES = ["created", "already_available"];
 var STRUCTURED_DATA_REVIEW_REASONS = ["uncertain", "conflicting"];
-var FOLLOW_UP_MODES = ["queue"];
-var FOLLOW_UP_STATUSES = ["pending", "dispatched", "cancelled"];
+var FOLLOW_UP_MODES = ["queue", "steer"];
+var FOLLOW_UP_STATUSES = ["pending", "dispatched", "consumed", "cancelled"];
 var AGENT_RUN_STATUSES = [
   "queued",
   "running",
@@ -575,6 +646,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",
@@ -590,6 +662,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"
@@ -604,6 +683,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"
@@ -932,7 +1012,14 @@ var agentConfigSchema = z.object({
       title: localizedStringSchema,
       prompt: localizedStringSchema
     })
-  ).default([])
+  ).default([]),
+  /**
+   * An agent that ships with the platform, such as Workshaper: the fields as the release
+   * shipped them last. Only the release seed writes it, and every other write keeps it as
+   * stored. A field the instance left as shipped takes what the next release ships; one it
+   * changed stays the instance's.
+   */
+  shipped: z.record(z.string(), z.unknown()).optional()
 });
 var WORKFLOW_NAME_PATTERN = /^[a-z][a-z0-9_-]{0,62}$/u;
 var WORKFLOW_NAME_RULE = "A Workflow id starts with a lowercase letter and holds lowercase letters, digits, '_' and '-', at most 63 characters";
@@ -1947,6 +2034,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,
@@ -1958,6 +2075,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,
@@ -1985,6 +2103,8 @@ export {
   AUDIT_TIERS,
   AUTH_PRINCIPAL_KINDS,
   AUTH_SCOPE_WILDCARD,
+  CATALOGUE_CATEGORIES,
+  CATALOGUE_PARTS,
   CHAT_MESSAGE_ROLES,
   CHAT_SESSION_AUTH_SCOPES,
   COLLABORATION_WORKSPACE_KINDS,
@@ -2095,6 +2215,7 @@ export {
   OPERATION_RUN_DECISION_MODES,
   OPERATION_RUN_DECISION_REASONS,
   OPERATION_RUN_STATUSES,
+  OPERATION_SOURCE_KINDS,
   OPERATION_TARGETS,
   POLICY_VALUES,
   PRINCIPAL_HOLDER_KINDS,
@@ -2146,6 +2267,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,
@@ -2161,6 +2283,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,
@@ -2175,6 +2298,8 @@ export {
   YAML_DATA_MAX_VALUES,
   YamlDataError,
   agentConfigSchema,
+  callableOperationSchema,
+  callableOperationsPageSchema,
   checkStorableTexts,
   dataScopeNameSchema,
   dataScopesSchema,
@@ -2239,6 +2364,7 @@ export {
   operationBatchFailureSchema,
   operationBatchResultSchema,
   operationPagingSchema,
+  operationSourceSchema,
   parseSkillMarkdown,
   readYamlData,
   recordEvidenceResultSchema,

package/package.json

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