@work-shape/catalyst-asset-schemas 0.0.0-stage → 0.8.0-rc.2

package/dist/index.d.ts

@@ -0,0 +1,759 @@
+import { z } from 'zod';
+
+/**
+ * The shape of an agent and of a skill as a file holds it. These are the public half of the
+ * asset model: a working copy, the command line tool and the instance read the same types.
+ */
+declare const localeCodes: readonly ["en", "de"];
+type LocaleCode = (typeof localeCodes)[number];
+type LocalizedStringConfig = string | {
+    en?: string;
+    de?: string;
+};
+declare const REASONING_EFFORTS: readonly ["none", "low", "medium", "high", "xhigh", "max"];
+type ReasoningEffortConfig = (typeof REASONING_EFFORTS)[number];
+interface AgentInitialPromptConfig {
+    title: LocalizedStringConfig;
+    prompt: LocalizedStringConfig;
+}
+interface AgentConfig {
+    name: string;
+    displayName: LocalizedStringConfig;
+    description?: LocalizedStringConfig;
+    welcomeMessage?: LocalizedStringConfig;
+    welcomeSubtitle?: LocalizedStringConfig;
+    instructions: string;
+    modelProviderId?: string;
+    modelBindingId?: string;
+    reasoningEffort?: ReasoningEffortConfig;
+    fastMode?: boolean;
+    /** Bindings users may pick for this agent in the chat, besides its own `modelBindingId`. */
+    userSelectableModelBindingIds?: string[];
+    /**
+     * Reasoning effort per user-selectable binding. `reasoningEffort` stays the effort of the
+     * agent's own model and is not applied to a model a user picked instead.
+     */
+    modelReasoningEfforts?: Record<string, ReasoningEffortConfig>;
+    maxSteps?: number;
+    toolNames: string[];
+    skillNames: string[];
+    /**
+     * The Knowledge Bases the agent answers from, by id. However many it lists, the agent has one
+     * tool over all of them, `knowledge.query`. Missing means none.
+     */
+    knowledgeBases?: string[];
+    initialPrompts: AgentInitialPromptConfig[];
+}
+interface SkillConfig {
+    name: string;
+    title: string;
+    /** For the agent: when to use the skill. */
+    description: string;
+    /**
+     * For people: one sentence on one line that says what an agent with the skill knows how to
+     * do. Lists and choosers show it under the title.
+     */
+    summary?: string;
+    /** Up to `SKILL_STARTERS_MAX` first requests the empty chat offers for an agent with the skill. */
+    starters?: SkillStarterConfig[];
+    content: string;
+    resources?: SkillResourceConfig[];
+    /**
+     * The files of the skill's folder that the config does not hold itself: everything beside
+     * `SKILL.md` and the text resources, such as a script, a PDF or an image. An index and no
+     * content. The platform writes it with the files; what a caller sends here is not read.
+     */
+    files?: SkillFileEntry[];
+    /**
+     * The keys of the frontmatter of `SKILL.md` that are not fields of the skill
+     * (`SKILL_FRONTMATTER_FIELDS`), such as `license`, `metadata` and `allowed-tools` of the
+     * public skill convention, as JSON values. They are kept and returned and never read by the
+     * platform.
+     */
+    frontmatter?: Record<string, unknown>;
+    /**
+     * `release` on a skill that ships with the platform. Only the release seed writes it: every
+     * other write of a skill that carries it is refused, and a stored one is read-only.
+     */
+    origin?: "release";
+    /** The key of the interface's icon registry. Only a skill that ships with the platform has one. */
+    icon?: string;
+}
+/** One file of a skill's folder as its index names it. */
+interface SkillFileEntry {
+    /** Relative to the folder of the skill, with `/` between segments. */
+    path: string;
+    /** Lower-case hex. */
+    sha256: string;
+    bytes: number;
+    mediaType: string;
+}
+/** How many starters one skill carries at most. */
+declare const SKILL_STARTERS_MAX = 2;
+/** How many starters the empty chat shows for one agent at most. */
+declare const AGENT_STARTERS_MAX = 4;
+/** The most characters a starter's `title` and its `hint` hold, in each language. */
+declare const SKILL_STARTER_LINE_MAX_LENGTH = 60;
+/** One first request a skill offers on the empty chat. Choosing it fills the composer. */
+interface SkillStarterConfig {
+    title: LocalizedStringConfig;
+    /** One short line under the title. */
+    hint?: LocalizedStringConfig;
+    /** The text that fills the composer. */
+    prompt: LocalizedStringConfig;
+    /**
+     * The tools the request needs. The starter shows only for an agent that holds every one of
+     * them, so it never offers what the agent cannot do.
+     */
+    tools?: string[];
+}
+/** The most characters a skill's `summary` holds. */
+declare const SKILL_SUMMARY_MAX_LENGTH = 120;
+/**
+ * Who ships a skill, as a list says it: `instance` for a skill of the instance's own, `release`
+ * for one that ships with the platform, which the release seed alone writes.
+ */
+declare const SKILL_ORIGINS: readonly ["instance", "release"];
+type SkillOrigin = (typeof SKILL_ORIGINS)[number];
+declare const SKILL_RESOURCE_MEDIA_TYPES: readonly ["text/markdown", "text/plain", "application/json", "application/yaml"];
+type SkillResourceMediaType = (typeof SKILL_RESOURCE_MEDIA_TYPES)[number];
+interface SkillResourceConfig {
+    path: string;
+    mediaType: SkillResourceMediaType;
+    content: string;
+}
+
+/**
+ * The values the HTTP contract of an instance is written with: scopes, actions, error codes
+ * and the limits a request is checked against. They hold no behaviour. The private packages
+ * of the platform read them from here, so that the contract and what enforces it cannot
+ * drift apart.
+ */
+declare const AUTH_SCOPE_WILDCARD: "*";
+declare const CHAT_SESSION_AUTH_SCOPES: readonly ["me:read", "me:delete", "config:read", "conversation:read", "conversation:write", "run:start", "run:observe", "run:cancel", "run:command"];
+declare const FIRST_PARTY_AUTH_SCOPES: readonly ["*", "me:read", "me:delete", "config:read", "conversation:read", "conversation:write", "run:start", "run:observe", "run:cancel", "run:command", "collaboration_workspace:read", "collaboration_workspace:manage", "me:write", "governance:read", "governance:write", "user_admin:read", "user_admin:write", "api_access:read", "api_access:write", "config_assets:read", "config_assets:write", "config_assets:publish", "config_assets:release", "data_store_rows:read", "data_store_rows:write"];
+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.delete", "skill.read", "skill.write", "skill.delete", "skill.approve", "connection.read", "connection.use", "connection.write", "connection.delete", "connection.approve", "app.read", "app.write", "app.publish", "app.approve", "app.delete", "app.use", "workflow.read", "workflow.write", "workflow.publish", "workflow.approve", "workflow.delete", "workflow.use", "workflow.read_run_data", "data_store.read", "data_store.write", "data_store.publish", "data_store.delete", "data_store.insert", "data_store.execute", "knowledge_base.read", "knowledge_base.write", "knowledge_base.publish", "knowledge_base.delete", "knowledge_base.use", "guardrail.read", "guardrail.write", "guardrail.publish", "guardrail.delete", "operations.approve", "users.manage", "usage.view", "audit.view", "api_access.manage", "service_principals.manage", "agent_models.manage", "assets.release"];
+type PlatformAction = (typeof ACTIONS)[number];
+/** A Namespace prefix: lowercase words joined by single hyphens, ending in one hyphen. */
+declare const NAMESPACE_PREFIX_PATTERN: RegExp;
+declare const NAMESPACE_PREFIX_MIN_LENGTH = 2;
+declare const NAMESPACE_PREFIX_MAX_LENGTH = 32;
+type AppErrorCode = (typeof APP_ERROR_CODES)[number];
+/** The HTTP status every error code answers with. */
+declare const APP_ERROR_STATUS_CODES: Record<AppErrorCode, number>;
+type OperationEffect = (typeof OPERATION_EFFECTS)[number];
+/**
+ * The longest `Idempotency-Key` a caller may send, in characters. It protects the index the
+ * key is looked up in. A longer key is refused with VALIDATION_FAILED naming this limit.
+ */
+declare const IDEMPOTENCY_KEY_MAX_LENGTH = 255;
+/** What an instance takes from outside its own processes. A closed list. */
+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`.
+ */
+declare const PROVIDER_REGIONS: readonly ["eu", "global"];
+type ProviderRegion = (typeof PROVIDER_REGIONS)[number];
+/**
+ * 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.
+ */
+declare const PROVIDER_CHECK_ERROR_CLASSES: readonly ["unreachable", "timeout", "access_denied", "not_found", "bucket_missing", "rejected", "failed"];
+type ProviderCheckErrorClass = (typeof PROVIDER_CHECK_ERROR_CLASSES)[number];
+/**
+ * The immutable machine name. It is part of every operation name of the Connection
+ * (`connection.<name>.<operation>`), so it holds no dot. A Namespace prefix fits in front.
+ */
+declare const CONNECTION_NAME_PATTERN: RegExp;
+declare const CONNECTION_NAME_MAX_LENGTH = 64;
+/**
+ * The immutable machine name of a Guardrail. An approval request keeps it as the id of the
+ * check that answered, and its hits are kept under it.
+ */
+declare const GUARDRAIL_NAME_PATTERN: RegExp;
+declare const GUARDRAIL_NAME_MAX_LENGTH = 64;
+/**
+ * Who may call an accepted operation. An operation exposed to nobody is callable by nobody.
+ * `outside` admits the CLI and the platform MCP server, a caller with an API credential whose
+ * results leave the instance; no operation has it unless an admin turns it on.
+ */
+declare const CONNECTION_EXPOSURES: readonly ["agent", "bridge", "workflow", "outside"];
+type ConnectionExposure = (typeof CONNECTION_EXPOSURES)[number];
+/** The health of a Connection as its page and its list show it. */
+declare const CONNECTION_HEALTH_STATES: readonly ["unknown", "ok", "failed", "needs_configuration", "secret_unreadable"];
+type ConnectionHealth = (typeof CONNECTION_HEALTH_STATES)[number];
+declare const GRANT_HOLDER_KINDS: readonly ["user", "service_principal", "role", "group"];
+type GrantHolderKind = (typeof GRANT_HOLDER_KINDS)[number];
+declare const GRANT_SCOPE_KINDS: readonly ["instance", "workspace", "namespace", "asset"];
+type GrantScopeKind = (typeof GRANT_SCOPE_KINDS)[number];
+declare const GRANT_EFFECTS: readonly ["allow", "deny"];
+type GrantEffect = (typeof GRANT_EFFECTS)[number];
+declare const ACCESS_SOURCES: readonly ["role", "legacy_ref", "grant", "membership"];
+type AccessSource = (typeof ACCESS_SOURCES)[number];
+declare const POLICY_VALUES: readonly ["allow", "confirm", "approval", "deny"];
+type PolicyValue = (typeof POLICY_VALUES)[number];
+declare const AUTH_PRINCIPAL_KINDS: readonly ["user", "service"];
+type AuthPrincipalKind = (typeof AUTH_PRINCIPAL_KINDS)[number];
+declare const ADMINISTERED_USER_STATUSES: readonly ["active", "disabled", "deleting"];
+type AdministeredUserStatus = (typeof ADMINISTERED_USER_STATUSES)[number];
+declare const SERVICE_PRINCIPAL_STATUSES: readonly ["active", "disabled"];
+type ServicePrincipalStatus = (typeof SERVICE_PRINCIPAL_STATUSES)[number];
+declare const SERVICE_PRINCIPAL_PERMISSIONS: readonly ["config_assets.read", "config_assets.release"];
+type ServicePrincipalPermission = (typeof SERVICE_PRINCIPAL_PERMISSIONS)[number];
+declare const API_CREDENTIAL_SCOPES: readonly ["config_assets:read", "config_assets:release"];
+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"];
+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"];
+type OperationRunStatus = (typeof OPERATION_RUN_STATUSES)[number];
+declare const OPERATION_ORIGIN_KINDS: readonly ["agent", "user", "cli", "mcp", "app", "workflow", "schedule"];
+type OperationOriginKind = (typeof OPERATION_ORIGIN_KINDS)[number];
+declare const OPERATION_RUN_DECISION_MODES: readonly ["direct", "confirmed", "approved", "declined"];
+type OperationRunDecisionMode = (typeof OPERATION_RUN_DECISION_MODES)[number];
+declare const OPERATION_RUN_DECISION_REASONS: readonly ["inherited_approval_not_applied", "workflow_publish", "approved_by_caller"];
+type OperationRunDecisionReason = (typeof OPERATION_RUN_DECISION_REASONS)[number];
+declare const OPERATION_DENIAL_REASONS: readonly ["no_grant", "denied", "unknown_action", "holder_inactive", "holder_not_administrable", "user_only", "outside_key_scope"];
+type OperationDenialReason = (typeof OPERATION_DENIAL_REASONS)[number];
+declare const APPROVAL_REQUEST_STATUSES: readonly ["pending", "approved", "rejected", "changes_requested", "superseded", "withdrawn", "reverted"];
+type ApprovalRequestStatus = (typeof APPROVAL_REQUEST_STATUSES)[number];
+declare const APPROVAL_CHECK_STATUSES: readonly ["passed", "warned", "blocked"];
+type ApprovalCheckStatus = (typeof APPROVAL_CHECK_STATUSES)[number];
+declare const APPROVAL_EXECUTIONS: readonly ["queued", "done", "failed", "interrupted", "refused", "expired"];
+type ApprovalExecution = (typeof APPROVAL_EXECUTIONS)[number];
+declare const SKILL_CHANGE_TYPES: readonly ["replace", "add", "new_resource"];
+type SkillChangeType = (typeof SKILL_CHANGE_TYPES)[number];
+declare const GUARDRAIL_OUTCOMES: readonly ["allow", "warn", "require_approval", "block"];
+type GuardrailOutcome = (typeof GUARDRAIL_OUTCOMES)[number];
+declare const APP_MODES: readonly ["published", "draft"];
+type AppMode = (typeof APP_MODES)[number];
+declare const ASSET_NAME_REFUSAL_REASONS: readonly ["name_invalid", "name_taken"];
+type AssetNameRefusalReason = (typeof ASSET_NAME_REFUSAL_REASONS)[number];
+declare const ASSET_SYNC_CHANGE_TYPES: readonly ["put", "delete"];
+type AssetSyncChangeType = (typeof ASSET_SYNC_CHANGE_TYPES)[number];
+declare const ASSET_LIFECYCLES: readonly ["active", "draft_published"];
+type AssetLifecycle = (typeof ASSET_LIFECYCLES)[number];
+declare const ASSET_REPRESENTATIONS: readonly ["config", "files"];
+type AssetRepresentation = (typeof ASSET_REPRESENTATIONS)[number];
+declare const CONFIG_ASSET_KINDS: readonly ["agent", "skill"];
+type ConfigAssetKind = (typeof CONFIG_ASSET_KINDS)[number];
+declare const CONFIG_ASSET_CHANGE_OPERATIONS: readonly ["create", "update", "delete", "revert"];
+type ConfigAssetChangeOperation = (typeof CONFIG_ASSET_CHANGE_OPERATIONS)[number];
+declare const AGENT_AVAILABILITY_MODES: readonly ["all", "selected"];
+type AgentAvailabilityMode = (typeof AGENT_AVAILABILITY_MODES)[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"];
+type AssetRepoBundleKind = (typeof ASSET_REPO_BUNDLE_KINDS)[number];
+declare const WORKSPACE_FILE_KINDS: readonly ["page", "upload", "generated_file"];
+type WorkspaceFileKind = (typeof WORKSPACE_FILE_KINDS)[number];
+declare const WORKSPACE_VISIBILITIES: readonly ["discoverable", "private"];
+type WorkspaceVisibility = (typeof WORKSPACE_VISIBILITIES)[number];
+declare const WORKSPACE_MEMBERSHIP_ROLES: readonly ["owner", "admin", "member"];
+type WorkspaceMembershipRole = (typeof WORKSPACE_MEMBERSHIP_ROLES)[number];
+declare const WORKSPACE_ACCENT_COLORS: readonly ["garnet", "ruby", "mahogany", "copper", "amber", "olive", "jade", "emerald", "teal", "turquoise", "azure", "sapphire", "indigo", "violet", "magenta", "rose", "stone", "slate"];
+type WorkspaceAccentColor = (typeof WORKSPACE_ACCENT_COLORS)[number];
+declare const COLLABORATION_WORKSPACE_KINDS: readonly ["personal", "shared"];
+type CollaborationWorkspaceKind = (typeof COLLABORATION_WORKSPACE_KINDS)[number];
+declare const WORKSPACE_ACCESS_STATES: readonly ["member", "request_pending", "can_request"];
+type WorkspaceAccessState = (typeof WORKSPACE_ACCESS_STATES)[number];
+declare const DELETION_STATES: readonly ["deleting", "deleted"];
+type DeletionState = (typeof DELETION_STATES)[number];
+declare const WORKSPACE_SECTIONS: readonly ["agents", "apps"];
+type WorkspaceSection = (typeof WORKSPACE_SECTIONS)[number];
+declare const MODEL_USAGE_TIERS: readonly ["very_low", "low", "moderate", "elevated", "high", "very_high"];
+type ModelUsageTier = (typeof MODEL_USAGE_TIERS)[number];
+declare const THEME_MODE_PREFERENCES: readonly ["light", "dark", "system"];
+type ThemeModePreference = (typeof THEME_MODE_PREFERENCES)[number];
+declare const TOOL_GROUPS: readonly ["documents", "web", "files", "results", "skills", "platform", "instance"];
+type ToolGroup = (typeof TOOL_GROUPS)[number];
+declare const INFRASTRUCTURE_SECRET_STATES: readonly ["set", "missing"];
+type InfrastructureSecretState = (typeof INFRASTRUCTURE_SECRET_STATES)[number];
+declare const INFRASTRUCTURE_WITHHELD_FIELDS: readonly ["endpointHost", "bucket"];
+type InfrastructureWithheldField = (typeof INFRASTRUCTURE_WITHHELD_FIELDS)[number];
+declare const OPENAI_COMPATIBLE_APIS: readonly ["chat_completions", "responses"];
+type OpenaiCompatibleApi = (typeof OPENAI_COMPATIBLE_APIS)[number];
+declare const MODEL_PROVIDER_AUTH_MODES: readonly ["bearer", "api-key"];
+type ModelProviderAuthMode = (typeof MODEL_PROVIDER_AUTH_MODES)[number];
+declare const CONVERSATION_VISIBILITIES: readonly ["workspace", "private"];
+type ConversationVisibility = (typeof CONVERSATION_VISIBILITIES)[number];
+declare const WEB_SOURCE_PROVIDERS: readonly ["openai-native", "serper", "tavily", "firecrawl", "browserbase", "direct"];
+type WebSourceProvider = (typeof WEB_SOURCE_PROVIDERS)[number];
+declare const CHAT_MESSAGE_ROLES: readonly ["user", "assistant", "system", "tool"];
+type ChatMessageRole = (typeof CHAT_MESSAGE_ROLES)[number];
+declare const CONVERSATION_ATTACHMENT_STATUSES: readonly ["queued", "preprocessing", "ready", "failed", "unsupported", "deleted"];
+type ConversationAttachmentStatus = (typeof CONVERSATION_ATTACHMENT_STATUSES)[number];
+declare const ATTACHMENT_CREATE_OUTCOMES: readonly ["created", "already_available"];
+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 AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_for_decision", "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"];
+type AgentRunFailureCategory = (typeof AGENT_RUN_FAILURE_CATEGORIES)[number];
+declare const TOOL_INPUT_PARSE_ERROR_CODES: readonly ["invalid_json", "invalid_text"];
+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"];
+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"];
+type ToolCallState = (typeof TOOL_CALL_STATES)[number];
+declare const SUPPORTED_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/webp", "image/gif"];
+type SupportedImageMimeType = (typeof SUPPORTED_IMAGE_MIME_TYPES)[number];
+declare const ARTIFACT_PREVIEW_IMAGE_FORMATS: readonly ["png", "webp", "jpeg"];
+type ArtifactPreviewImageFormat = (typeof ARTIFACT_PREVIEW_IMAGE_FORMATS)[number];
+declare const ARTIFACT_PREVIEW_STATUSES: readonly ["ready", "pending", "failed", "unsupported"];
+type ArtifactPreviewStatus = (typeof ARTIFACT_PREVIEW_STATUSES)[number];
+declare const WORKSPACE_COMMAND_STATUSES: readonly ["queued", "running", "cancelling", "completed", "failed", "cancelled"];
+type WorkspaceCommandStatus = (typeof WORKSPACE_COMMAND_STATUSES)[number];
+declare const TOOL_DISPLAY_MODES: readonly ["inline", "side_panel", "fullscreen"];
+type ToolDisplayMode = (typeof TOOL_DISPLAY_MODES)[number];
+declare const JOB_STATUSES: readonly ["queued", "running", "succeeded", "failed", "dead", "cancelled"];
+type JobStatus = (typeof JOB_STATUSES)[number];
+declare const AUDIT_ACTOR_KINDS: readonly ["user", "assistant", "service", "system"];
+type AuditActorKind = (typeof AUDIT_ACTOR_KINDS)[number];
+declare const AUDIT_TIERS: readonly ["governance", "workflow", "runtime", "telemetry"];
+type AuditTier = (typeof AUDIT_TIERS)[number];
+declare const AUDIT_OUTCOMES: readonly ["success", "failed", "denied", "warning"];
+type AuditOutcome = (typeof AUDIT_OUTCOMES)[number];
+declare const MODEL_USAGE_EVENT_STATUSES: readonly ["pending", "settled", "failed", "abandoned"];
+type ModelUsageEventStatus = (typeof MODEL_USAGE_EVENT_STATUSES)[number];
+declare const MODEL_USAGE_SOURCES: readonly ["provider_reported", "not_reported", "estimated"];
+type ModelUsageSource = (typeof MODEL_USAGE_SOURCES)[number];
+declare const USAGE_COST_STATUSES: readonly ["settled", "incomplete", "unpriced"];
+type UsageCostStatus = (typeof USAGE_COST_STATUSES)[number];
+declare const CONNECTION_OPERATION_STATUSES: readonly ["ready", "awaiting_discovery", "needs_review", "unknown", "disabled"];
+type ConnectionOperationStatus = (typeof CONNECTION_OPERATION_STATUSES)[number];
+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"];
+type ConnectorTestStatus = (typeof CONNECTOR_TEST_STATUSES)[number];
+declare const CONNECTION_ORIGINS: readonly ["release", "runtime"];
+type ConnectionOrigin = (typeof CONNECTION_ORIGINS)[number];
+declare const CONNECTION_NETWORKS: readonly ["public", "private"];
+type ConnectionNetwork = (typeof CONNECTION_NETWORKS)[number];
+declare const DATA_STORE_SCALAR_TYPES: readonly ["text", "integer", "number", "boolean", "date", "timestamp"];
+type DataStoreScalarType = (typeof DATA_STORE_SCALAR_TYPES)[number];
+declare const DATA_STORE_LOAD_CONFLICT_MODES: readonly ["fail", "skip", "update"];
+type DataStoreLoadConflictMode = (typeof DATA_STORE_LOAD_CONFLICT_MODES)[number];
+declare const DATA_STORE_INSERT_CONFLICT_MODES: readonly ["fail", "skip"];
+type DataStoreInsertConflictMode = (typeof DATA_STORE_INSERT_CONFLICT_MODES)[number];
+declare const DATA_STORE_CONDITIONS: readonly ["server_databases_open", "sessions_open", "temp_files_unbounded"];
+type DataStoreCondition = (typeof DATA_STORE_CONDITIONS)[number];
+declare const DATA_STORE_STATUSES: readonly ["provisioning", "ready", "retired"];
+type DataStoreStatus = (typeof DATA_STORE_STATUSES)[number];
+declare const DATA_STORE_MIGRATION_OUTCOMES: readonly ["none", "pending", "applied", "failed"];
+type DataStoreMigrationOutcome = (typeof DATA_STORE_MIGRATION_OUTCOMES)[number];
+declare const KNOWLEDGE_BASE_STATUSES: readonly ["unchecked", "ok", "needs_attention"];
+type KnowledgeBaseStatus = (typeof KNOWLEDGE_BASE_STATUSES)[number];
+declare const DATABASE_RELATION_TYPES: readonly ["table", "view", "materialized_view", "foreign_table"];
+type DatabaseRelationType = (typeof DATABASE_RELATION_TYPES)[number];
+declare const WORKFLOW_RUN_STATUSES: readonly ["queued", "running", "waiting", "done", "failed", "cancelled", "limit_reached"];
+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];
+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"];
+type WorkflowTriggerKind = (typeof WORKFLOW_TRIGGER_KINDS)[number];
+declare const NOTIFY_CHANNELS: readonly ["inbox", "mail"];
+type NotifyChannel = (typeof NOTIFY_CHANNELS)[number];
+declare const PRINCIPAL_HOLDER_KINDS: readonly ["user", "service_principal"];
+type PrincipalHolderKind = (typeof PRINCIPAL_HOLDER_KINDS)[number];
+declare const ASSET_OWNER_KINDS: readonly ["instance", "workspace"];
+type AssetOwnerKind = (typeof ASSET_OWNER_KINDS)[number];
+declare const READING_POLICY_VALUES: readonly ["allow", "deny"];
+type ReadingPolicyValue = (typeof READING_POLICY_VALUES)[number];
+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];
+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"];
+type OperationsAudience = (typeof OPERATIONS_AUDIENCES)[number];
+declare const DECIDED_APPROVAL_REQUEST_STATUSES: readonly ["approved", "rejected", "changes_requested", "superseded", "withdrawn", "reverted"];
+type DecidedApprovalRequestStatus = (typeof DECIDED_APPROVAL_REQUEST_STATUSES)[number];
+declare const ENDED_APPROVAL_EXECUTIONS: readonly ["done", "failed", "interrupted", "refused", "expired"];
+type EndedApprovalExecution = (typeof ENDED_APPROVAL_EXECUTIONS)[number];
+declare const GUARDRAIL_HIT_OUTCOMES: readonly ["warn", "require_approval", "block"];
+type GuardrailHitOutcome = (typeof GUARDRAIL_HIT_OUTCOMES)[number];
+declare const APPROVAL_CHECK_FAILURE_OUTCOMES: readonly ["warn", "block"];
+type ApprovalCheckFailureOutcome = (typeof APPROVAL_CHECK_FAILURE_OUTCOMES)[number];
+declare const THEME_MODES: readonly ["light", "dark"];
+type ThemeMode = (typeof THEME_MODES)[number];
+declare const USER_STATUSES: readonly ["active", "disabled"];
+type UserStatus = (typeof USER_STATUSES)[number];
+declare const MESSAGE_FINISH_STATUSES: readonly ["completed", "cancelled"];
+type MessageFinishStatus = (typeof MESSAGE_FINISH_STATUSES)[number];
+declare const ENDED_AGENT_RUN_STATUSES: readonly ["completed", "cancelled", "failed"];
+type EndedAgentRunStatus = (typeof ENDED_AGENT_RUN_STATUSES)[number];
+declare const ACTIVE_AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_for_decision", "cancelling"];
+type ActiveAgentRunStatus = (typeof ACTIVE_AGENT_RUN_STATUSES)[number];
+declare const ARTIFACT_PREVIEW_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/webp"];
+type ArtifactPreviewImageMimeType = (typeof ARTIFACT_PREVIEW_IMAGE_MIME_TYPES)[number];
+declare const LIVE_JOB_STATUSES: readonly ["queued", "running"];
+type LiveJobStatus = (typeof LIVE_JOB_STATUSES)[number];
+declare const FAILED_JOB_STATUSES: readonly ["failed", "dead"];
+type FailedJobStatus = (typeof FAILED_JOB_STATUSES)[number];
+declare const AUDIT_EVENT_STATUSES: readonly ["success", "failed", "denied"];
+type AuditEventStatus = (typeof AUDIT_EVENT_STATUSES)[number];
+declare const LISTED_DATA_STORE_STATUSES: readonly ["provisioning", "ready"];
+type ListedDataStoreStatus = (typeof LISTED_DATA_STORE_STATUSES)[number];
+declare const KNOWLEDGE_CHECK_STATUSES: readonly ["ok", "needs_attention"];
+type KnowledgeCheckStatus = (typeof KNOWLEDGE_CHECK_STATUSES)[number];
+declare const WORKFLOW_STEP_RUN_STATUSES: readonly ["queued", "running", "waiting", "done", "failed", "cancelled"];
+type WorkflowStepRunStatus = (typeof WORKFLOW_STEP_RUN_STATUSES)[number];
+declare const WORKFLOW_ENDED_STATUSES: readonly ["done", "failed", "cancelled", "limit_reached"];
+type WorkflowEndedStatus = (typeof WORKFLOW_ENDED_STATUSES)[number];
+
+declare const localizedStringSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    en: z.ZodOptional<z.ZodString>;
+    de: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+declare const SKILL_NAME_PATTERN: RegExp;
+declare const SKILL_NAME_RULE = "Skill name must start with a letter or a number and contain only letters, numbers, dots, underscores, or hyphens";
+/** How long a name of the public skill convention is at most, in characters. */
+declare const SKILL_PORTABLE_NAME_MAX_CHARS = 64;
+/** How long a description of the public skill convention is at most, in characters. */
+declare const SKILL_PORTABLE_DESCRIPTION_MAX_CHARS = 1024;
+/**
+ * What keeps a skill from being taken as it is into a tool that reads the public skill
+ * convention: a name that is not lowercase letters, digits and single hyphens or is longer
+ * than 64 characters, and a description longer than 1,024. Each is a warning with a code and
+ * refuses nothing: such a skill works here.
+ */
+declare function skillPortabilityIssues(skill: {
+    name?: unknown;
+    description?: unknown;
+}): {
+    code: string;
+    message: string;
+}[];
+declare const skillNameSchema: z.ZodString;
+declare const skillResourcePathSchema: z.ZodString;
+declare function skillResourceMediaTypeForPath(path: string): SkillResourceMediaType | undefined;
+declare const skillResourceConfigSchema: z.ZodObject<{
+    path: z.ZodString;
+    mediaType: z.ZodEnum<{
+        "text/markdown": "text/markdown";
+        "text/plain": "text/plain";
+        "application/json": "application/json";
+        "application/yaml": "application/yaml";
+    }>;
+    content: z.ZodString;
+}, z.core.$strip>;
+declare const skillStarterSchema: z.ZodObject<{
+    title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        en: z.ZodOptional<z.ZodString>;
+        de: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+    hint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        en: z.ZodOptional<z.ZodString>;
+        de: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        en: z.ZodOptional<z.ZodString>;
+        de: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * How much frontmatter a `SKILL.md` holds beside the keys the platform reads, as JSON, in
+ * characters. The keys of the public skill convention are a few lines.
+ */
+declare const SKILL_FRONTMATTER_MAX_BYTES = 8192;
+/** How deep the frontmatter of a `SKILL.md` nests at most. */
+declare const SKILL_FRONTMATTER_MAX_DEPTH = 8;
+/**
+ * The keys of the frontmatter of a `SKILL.md` that are fields of the skill. Every other key is
+ * kept apart as its further `frontmatter`.
+ */
+declare const SKILL_FRONTMATTER_FIELDS: readonly ["name", "title", "description", "summary", "starters"];
+/** One file of a skill's folder as its index names it: no content. */
+declare const skillFileEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    sha256: z.ZodString;
+    bytes: z.ZodNumber;
+    mediaType: z.ZodString;
+}, z.core.$strip>;
+declare const skillConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    starters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            en: z.ZodOptional<z.ZodString>;
+            de: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>;
+        hint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            en: z.ZodOptional<z.ZodString>;
+            de: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>;
+        prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            en: z.ZodOptional<z.ZodString>;
+            de: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    content: z.ZodString;
+    resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        mediaType: z.ZodEnum<{
+            "text/markdown": "text/markdown";
+            "text/plain": "text/plain";
+            "application/json": "application/json";
+            "application/yaml": "application/yaml";
+        }>;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+        mediaType: z.ZodString;
+    }, z.core.$strip>>>;
+    frontmatter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    origin: z.ZodOptional<z.ZodLiteral<"release">>;
+    icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The frontmatter of a `SKILL.md`. `description` is required. `name` may be left to the folder
+ * and `title` to the content; `summary` and `starters` are read as the config holds them.
+ * Every other key is kept as it is and never refused: the public skill convention has keys of
+ * its own, such as `license` and `metadata`, and a library may add more. A skill file is the
+ * instance's own: what only a shipped skill carries, `origin` and `icon`, is no field of it.
+ */
+declare const skillFileFrontmatterSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    starters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            en: z.ZodOptional<z.ZodString>;
+            de: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>;
+        hint: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            en: z.ZodOptional<z.ZodString>;
+            de: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>;
+        prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            en: z.ZodOptional<z.ZodString>;
+            de: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$loose>;
+declare const agentConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        en: z.ZodOptional<z.ZodString>;
+        de: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+    description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        en: z.ZodOptional<z.ZodString>;
+        de: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    welcomeMessage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        en: z.ZodOptional<z.ZodString>;
+        de: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    welcomeSubtitle: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        en: z.ZodOptional<z.ZodString>;
+        de: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    instructions: z.ZodString;
+    modelProviderId: z.ZodOptional<z.ZodString>;
+    modelBindingId: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+    fastMode: z.ZodOptional<z.ZodBoolean>;
+    userSelectableModelBindingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    modelReasoningEfforts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        none: "none";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>>;
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+    toolNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    skillNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    knowledgeBases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    initialPrompts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            en: z.ZodOptional<z.ZodString>;
+            de: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>;
+        prompt: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            en: z.ZodOptional<z.ZodString>;
+            de: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>;
+    }, z.core.$strip>>>;
+}, 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;
+declare const WORKFLOW_NAME_RULE = "A Workflow id starts with a lowercase letter and holds lowercase letters, digits, '_' and '-', at most 63 characters";
+/**
+ * What a revision of a Workflow holds as its config: the id the asset is addressed by,
+ * `workflow.yaml` as an object under `manifest`, and the files of its `steps/` folder under
+ * `files`, each with its path in the Workflow's folder and its text. This is the shape alone,
+ * which every stored revision keeps whatever a later engine accepts. Whether the engine of the
+ * instance runs the manifest and takes the files is asked of the engine when a revision is
+ * saved and when one is published.
+ */
+declare const workflowConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    manifest: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+type WorkflowAssetConfig = z.infer<typeof workflowConfigSchema>;
+
+/**
+ * Why a frontmatter is refused before its fields are read: for an alias, for its depth, or
+ * for the size of what it holds beside the name, the title and the description.
+ */
+type SkillFrontmatterRefusal = "skill_frontmatter_alias" | "skill_frontmatter_too_deep" | "skill_frontmatter_too_large";
+/**
+ * One thing that is wrong in a skill file: an invalid field by its path, or the place of the
+ * file, by line and column, where its frontmatter stops being YAML.
+ */
+interface SkillMarkdownIssue {
+    message: string;
+    path: PropertyKey[];
+    line?: number;
+    column?: number;
+}
+/**
+ * A skill file that cannot be read as a skill. `details.issues` names each invalid field, and
+ * `reason` what refused the frontmatter as a whole.
+ */
+declare class SkillMarkdownError extends Error {
+    readonly details?: {
+        issues: SkillMarkdownIssue[];
+    };
+    readonly reason?: SkillFrontmatterRefusal;
+    constructor(message: string, details?: {
+        issues: SkillMarkdownIssue[];
+    }, reason?: SkillFrontmatterRefusal);
+}
+/**
+ * Reads a `SKILL.md`: YAML frontmatter with title and description, then the content. A file
+ * without a name takes it from its folder, or from its own file name. `skillPath` separates
+ * its segments with `/`. This module runs in a browser too, so it reads the path as text.
+ */
+declare function parseSkillMarkdown(contents: string, skillFile: string, skillPath: string): unknown;
+/**
+ * The title a skill is shown under where its `SKILL.md` names none, as the public skill
+ * convention does not: the first Markdown heading of its content, or else its name with
+ * spaces for hyphens and underscores and a capital first letter.
+ */
+declare function deriveSkillTitle(name: string, content: string): string;
+/**
+ * A `SKILL.md` of a skill's config: what `parseSkillMarkdown` reads back as the same name,
+ * title, description, summary, starters, content and further frontmatter. A title the content
+ * or the name gives anyway is left out, as a file of the public skill convention has none. It
+ * is what a skill that was written as its config has for a file.
+ */
+declare function formatSkillMarkdown(skill: {
+    name: string;
+    title: string;
+    description: string;
+    summary?: string;
+    starters?: SkillStarterConfig[];
+    content: string;
+    frontmatter?: Record<string, unknown>;
+}): string;
+
+/**
+ * Why a value read from YAML is not taken, or nothing where it is. `alias`: an object or a
+ * list is in it more than once, which only an anchor with an alias or a merge makes; no file
+ * the platform reads needs one, so none is taken, and no count of them has to be right.
+ * `depth`: it nests deeper than `maxDepth`, where its reader names one; a file whose own
+ * rules say how deep it nests, as a Workflow's blocks do, names none. The walk is linear in
+ * what the file holds: it visits each object once and ends at the first one it meets twice.
+ */
+declare function yamlValueIssue(value: unknown, maxDepth?: number): "alias" | "depth" | undefined;
+/** The sentence a reader of a YAML file answers for an issue of its value. */
+declare function yamlValueIssueSentence(issue: "alias" | "depth", maxDepth?: number): string;
+
+/**
+ * How many values a YAML file holds once every alias is followed. It stops a file of a few
+ * hundred bytes whose aliases expand to a billion values ("billion laughs"), which hung the
+ * server on its first walk. The largest honest manifest holds a few thousand.
+ */
+declare const YAML_DATA_MAX_VALUES = 100000;
+type YamlDataIssueCode = "yaml_invalid" | "yaml_alias" | "yaml_too_deep" | "yaml_too_large" | "text_invalid";
+interface YamlDataIssue {
+    code: YamlDataIssueCode;
+    /** One sentence that names the file. */
+    message: string;
+    /** The line of the file, from 1, where the reader stopped. */
+    line?: number;
+    /** The column of that line, from 1. */
+    column?: number;
+}
+interface YamlDataOptions {
+    /**
+     * Refuses an anchor with an alias or a merge key, before anything walks the value. The
+     * readers of an asset's own files ask for it: none of those files needs one.
+     */
+    refuseAliases?: boolean;
+}
+type YamlDataResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    issue: YamlDataIssue;
+};
+/**
+ * Whether Postgres can store a text, in a `text` column or in `jsonb`: it holds neither a NUL
+ * character nor half of a surrogate pair. With the `u` flag a whole pair is one code point, so
+ * only half of one matches `\p{Surrogate}`.
+ */
+declare function isStorableText(text: string): boolean;
+/**
+ * Whether every text and key of a JSON-like value can be stored. It walks at most `maxValues`
+ * values, a value reached twice counted twice, and answers `too_large` beyond that. It walks
+ * without recursion, so no nesting ends it.
+ */
+declare function checkStorableTexts(value: unknown, maxValues: number): "storable" | "unstorable" | "too_large";
+/**
+ * Reads YAML that an author or an agent wrote as data: the schema knows JSON types alone and
+ * builds nothing else. A file that does not parse, nests too deep, expands too far through its
+ * aliases or holds text that cannot be stored is answered as an issue, never thrown.
+ */
+declare function readYamlData(text: string, file: string, options?: YamlDataOptions): YamlDataResult;
+/** A YAML file `loadYamlData` refused. `issue` says why. */
+declare class YamlDataError extends Error {
+    readonly issue: YamlDataIssue;
+    constructor(issue: YamlDataIssue);
+}
+/** `readYamlData` for a caller that reports a refused file as an error: it throws `YamlDataError`. */
+declare function loadYamlData(text: string, file: string): unknown;
+
+export { ACCESS_SOURCES, ACTIONS, ACTIVE_AGENT_RUN_STATUSES, ADMINISTERED_USER_STATUSES, AGENT_AVAILABILITY_MODES, AGENT_EDITABLE_FIELDS, AGENT_RUN_FAILURE_CATEGORIES, AGENT_RUN_STATUSES, AGENT_STARTERS_MAX, API_CREDENTIAL_SCOPES, APPROVAL_CHECK_FAILURE_OUTCOMES, APPROVAL_CHECK_STATUSES, APPROVAL_EXECUTIONS, APPROVAL_REQUEST_STATUSES, APP_ACTION_CALL_STATUSES, APP_ERROR_CODES, APP_ERROR_STATUS_CODES, APP_MODES, ARTIFACT_PREVIEW_IMAGE_FORMATS, ARTIFACT_PREVIEW_IMAGE_MIME_TYPES, ARTIFACT_PREVIEW_STATUSES, ASSET_LIFECYCLES, ASSET_NAME_REFUSAL_REASONS, ASSET_OWNER_KINDS, ASSET_REPO_BUNDLE_KINDS, ASSET_REPRESENTATIONS, ASSET_SYNC_CHANGE_TYPES, ATTACHMENT_CREATE_OUTCOMES, AUDIT_ACTOR_KINDS, AUDIT_EVENT_STATUSES, AUDIT_OUTCOMES, AUDIT_TIERS, AUTH_PRINCIPAL_KINDS, AUTH_SCOPE_WILDCARD, type AccessSource, type ActiveAgentRunStatus, type AdministeredUserStatus, type AgentAvailabilityMode, type AgentConfig, type AgentEditableField, type AgentInitialPromptConfig, type AgentRunFailureCategory, type AgentRunStatus, type ApiCredentialScope, type AppActionCallStatus, type AppErrorCode, type AppMode, type ApprovalCheckFailureOutcome, type ApprovalCheckStatus, type ApprovalExecution, type ApprovalRequestStatus, type ArtifactPreviewImageFormat, type ArtifactPreviewImageMimeType, type ArtifactPreviewStatus, type AssetLifecycle, type AssetNameRefusalReason, type AssetOwnerKind, type AssetRepoBundleKind, type AssetRepresentation, type AssetSyncChangeType, type AttachmentCreateOutcome, type AuditActorKind, type AuditEventStatus, type AuditOutcome, type AuditTier, type AuthPrincipalKind, CHAT_MESSAGE_ROLES, CHAT_SESSION_AUTH_SCOPES, COLLABORATION_WORKSPACE_KINDS, CONFIG_ASSET_CHANGE_OPERATIONS, CONFIG_ASSET_KINDS, CONNECTION_EXPOSURES, CONNECTION_HEALTH_STATES, CONNECTION_NAME_MAX_LENGTH, CONNECTION_NAME_PATTERN, CONNECTION_NETWORKS, CONNECTION_OPERATION_POLICIES, CONNECTION_OPERATION_STATUSES, CONNECTION_ORIGINS, CONNECTION_SECRET_STATES, CONNECTOR_TEST_STATUSES, CONVERSATION_ATTACHMENT_STATUSES, CONVERSATION_VISIBILITIES, type ChatMessageRole, type ChatSessionAuthScope, type CollaborationWorkspaceKind, type ConfigAssetChangeOperation, type ConfigAssetKind, type ConnectionExposure, type ConnectionHealth, type ConnectionNetwork, type ConnectionOperationPolicy, type ConnectionOperationStatus, type ConnectionOrigin, type ConnectionSecretState, type ConnectorTestStatus, type ConversationAttachmentStatus, type ConversationVisibility, DATABASE_RELATION_TYPES, DATA_STORE_CONDITIONS, DATA_STORE_INSERT_CONFLICT_MODES, DATA_STORE_LOAD_CONFLICT_MODES, DATA_STORE_MIGRATION_OUTCOMES, DATA_STORE_SCALAR_TYPES, DATA_STORE_STATUSES, DECIDED_APPROVAL_REQUEST_STATUSES, DELETION_STATES, type DataStoreCondition, type DataStoreInsertConflictMode, type DataStoreLoadConflictMode, type DataStoreMigrationOutcome, type DataStoreScalarType, type DataStoreStatus, type DatabaseRelationType, type DecidedApprovalRequestStatus, type DeletionState, ENDED_AGENT_RUN_STATUSES, ENDED_APPROVAL_EXECUTIONS, type EndedAgentRunStatus, type EndedApprovalExecution, FAILED_JOB_STATUSES, FIRST_PARTY_AUTH_SCOPES, type FailedJobStatus, type FirstPartyAuthScope, GRANT_EFFECTS, GRANT_HOLDER_KINDS, GRANT_SCOPE_KINDS, GUARDRAIL_HIT_OUTCOMES, GUARDRAIL_NAME_MAX_LENGTH, GUARDRAIL_NAME_PATTERN, GUARDRAIL_OUTCOMES, type GrantEffect, type GrantHolderKind, type GrantScopeKind, type GuardrailHitOutcome, type GuardrailOutcome, IDEMPOTENCY_KEY_MAX_LENGTH, INFRASTRUCTURE_SECRET_STATES, INFRASTRUCTURE_WITHHELD_FIELDS, type InfrastructureSecretState, type InfrastructureWithheldField, JOB_STATUSES, type JobStatus, KNOWLEDGE_BASE_STATUSES, KNOWLEDGE_CHECK_STATUSES, type KnowledgeBaseStatus, type KnowledgeCheckStatus, LISTED_DATA_STORE_STATUSES, LIVE_JOB_STATUSES, type ListedDataStoreStatus, type LiveJobStatus, type LocaleCode, type LocalizedStringConfig, MESSAGE_FINISH_STATUSES, MODEL_PROVIDER_AUTH_MODES, MODEL_USAGE_EVENT_STATUSES, MODEL_USAGE_SOURCES, MODEL_USAGE_TIERS, type MessageFinishStatus, type ModelProviderAuthMode, type ModelUsageEventStatus, type ModelUsageSource, type ModelUsageTier, NAMESPACE_PREFIX_MAX_LENGTH, NAMESPACE_PREFIX_MIN_LENGTH, NAMESPACE_PREFIX_PATTERN, NOTIFY_CHANNELS, type NotifyChannel, OPENAI_COMPATIBLE_APIS, OPERATIONS_AUDIENCES, OPERATION_CONFIRMATION_DECISIONS, OPERATION_DENIAL_REASONS, OPERATION_EFFECTS, OPERATION_ORIGIN_KINDS, OPERATION_RUN_DECISION_MODES, OPERATION_RUN_DECISION_REASONS, OPERATION_RUN_STATUSES, OPERATION_TARGETS, type OpenaiCompatibleApi, type OperationDenialReason, type OperationEffect, type OperationOriginKind, type OperationRunDecisionMode, type OperationRunDecisionReason, type OperationRunStatus, type OperationScope, type OperationTarget, type OperationsAudience, POLICY_VALUES, PRINCIPAL_HOLDER_KINDS, PROVIDER_CHECK_ERROR_CLASSES, PROVIDER_PORTS, PROVIDER_REGIONS, type PlatformAction, type PolicyValue, type PrincipalHolderKind, type ProviderCheckErrorClass, type ProviderPort, type ProviderRegion, READING_POLICY_VALUES, REASONING_EFFORTS, type ReadingPolicyValue, type ReasoningEffortConfig, SERVICE_PRINCIPAL_PERMISSIONS, SERVICE_PRINCIPAL_STATUSES, SKILL_CHANGE_TYPES, SKILL_FRONTMATTER_FIELDS, SKILL_FRONTMATTER_MAX_BYTES, SKILL_FRONTMATTER_MAX_DEPTH, SKILL_NAME_PATTERN, SKILL_NAME_RULE, SKILL_ORIGINS, SKILL_PORTABLE_DESCRIPTION_MAX_CHARS, SKILL_PORTABLE_NAME_MAX_CHARS, SKILL_RESOURCE_MEDIA_TYPES, SKILL_STARTERS_MAX, SKILL_STARTER_LINE_MAX_LENGTH, SKILL_SUMMARY_MAX_LENGTH, STRUCTURED_DATA_REVIEW_REASONS, SUPPORTED_IMAGE_MIME_TYPES, type ServicePrincipalPermission, type ServicePrincipalStatus, type SkillChangeType, type SkillConfig, type SkillFileEntry, type SkillFrontmatterRefusal, SkillMarkdownError, type SkillOrigin, type SkillResourceConfig, type SkillResourceMediaType, type SkillStarterConfig, type StructuredDataReviewReason, type SupportedImageMimeType, THEME_MODES, THEME_MODE_PREFERENCES, TOOL_CALL_STATES, TOOL_DECISION_MODES, TOOL_DECISION_OUTCOMES, TOOL_DISPLAY_MODES, TOOL_GROUPS, TOOL_INPUT_PARSE_ERROR_CODES, type ThemeMode, type ThemeModePreference, type ToolCallState, type ToolDisplayMode, type ToolGroup, type ToolInputParseErrorCode, USAGE_COST_STATUSES, USER_STATUSES, type UsageCostStatus, type UserStatus, WAITING_OPERATION_RUN_STATUSES, WEB_SOURCE_PROVIDERS, WORKFLOW_ENDED_STATUSES, WORKFLOW_NAME_PATTERN, WORKFLOW_NAME_RULE, WORKFLOW_RESERVED_STEP_TYPES, WORKFLOW_RUN_MODES, WORKFLOW_RUN_STATUSES, WORKFLOW_STEP_RUN_STATUSES, WORKFLOW_STEP_TYPES, WORKFLOW_TRIGGER_KINDS, WORKSPACE_ACCENT_COLORS, WORKSPACE_ACCESS_STATES, WORKSPACE_COMMAND_STATUSES, WORKSPACE_FILE_KINDS, WORKSPACE_MEMBERSHIP_ROLES, WORKSPACE_SECTIONS, WORKSPACE_VISIBILITIES, type WebSourceProvider, type WorkflowAssetConfig, type WorkflowEndedStatus, type WorkflowReservedStepType, type WorkflowRunMode, type WorkflowRunStatus, type WorkflowStepRunStatus, type WorkflowStepType, type WorkflowTriggerKind, type WorkspaceAccentColor, type WorkspaceAccessState, type WorkspaceCommandStatus, type WorkspaceFileKind, type WorkspaceMembershipRole, type WorkspaceSection, type WorkspaceVisibility, YAML_DATA_MAX_VALUES, YamlDataError, type YamlDataIssue, type YamlDataIssueCode, type YamlDataOptions, type YamlDataResult, agentConfigSchema, checkStorableTexts, deriveSkillTitle, formatSkillMarkdown, isStorableText, loadYamlData, localeCodes, localizedStringSchema, parseSkillMarkdown, readYamlData, skillConfigSchema, skillFileEntrySchema, skillFileFrontmatterSchema, skillNameSchema, skillPortabilityIssues, skillResourceConfigSchema, skillResourceMediaTypeForPath, skillResourcePathSchema, skillStarterSchema, workflowConfigSchema, yamlValueIssue, yamlValueIssueSentence };