@revoengine/sdk 1.0.0

package/dist/errors-ieF9jeMP.d.cts

@@ -0,0 +1,2760 @@
+import * as node_worker_threads from 'node:worker_threads';
+
+declare const SDK_VERSION: "1.0.0";
+declare const PROTOCOL_VERSION: 1;
+declare const CONTRACT_REVISION: "a88e3ddff38d91762aa4c771955343e986039cebb04e4347fd257bd96f65bf5c";
+type RuntimeSurfaceName = 'api' | 'storage' | 'agents';
+
+// AUTO-GENERATED FILE. DO NOT EDIT DIRECTLY.
+// Sources: api.swagger-contracts.generated.d.ts, api.public.d.ts
+// AUTO-GENERATED FROM packages/platform-openapi/generated/api.openapi.json. DO NOT EDIT.
+// These input contracts are the Swagger DTO surface used by low-code lifecycle methods.
+interface SwaggerAgentAutomationApprovalRoutingDto {
+    /** How non-interactive automation should behave when a later phase adds approval delegation. */
+    "mode"?: "block" | "delegate" | "notify";
+    /** Users who should receive delegated approval or escalation when automation cannot continue autonomously. */
+    "delegateUserIds"?: Array<string>;
+    /** Users who should be notified when automation reaches an approval gate or escalation path. */
+    "notifyUserIds"?: Array<string>;
+}
+interface SwaggerAgentAutomationNotificationPolicyDto {
+    /** Suggested dedupe window for downstream delivery or inbox fan-out keyed by one automation trigger. */
+    "dedupeWindowSeconds"?: number;
+    /** Suggested maximum delivery attempts for downstream notification or future chat delivery workers. */
+    "maxAttempts"?: number;
+    /** Whether automation-triggered delivery should retain an audit trail inside durable trigger state and future delivery workers. */
+    "auditTrail"?: boolean;
+}
+interface SwaggerAgentAutomationPolicyConfigDto {
+    /** Default trigger delivery mode for automation when the caller does not override it explicitly. */
+    "defaultDeliveryMode"?: "INBOX" | "DIRECT_RUN";
+    /** Approval-routing metadata reserved for enterprise automation escalation and operator delegation. */
+    "approvalRouting"?: SwaggerAgentAutomationApprovalRoutingDto;
+    /** Notification and delivery policy reserved for idempotent inbox fan-out and future chat delivery surfaces. */
+    "notificationPolicy"?: SwaggerAgentAutomationNotificationPolicyDto;
+}
+interface SwaggerAgentCheapTurnPolicyDto {
+    /** Whether cheap lookup turns should still receive persona guidance. */
+    "includePersona"?: boolean;
+    /** Whether cheap lookup turns should still receive custom agent system instructions. */
+    "includeSystemInstructions"?: boolean;
+    /** Whether cheap lookup turns should still receive recalled cross-run memory. */
+    "includeMemory"?: boolean;
+}
+interface SwaggerAgentConfigDto {
+    /** Supported assistant model used when the agent starts a thread. */
+    "model"?: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.4-nano";
+    /** Reasoning effort passed to assistant threads. */
+    "reasoningEffort"?: "low" | "medium" | "high" | "xhigh";
+    /** Durable execution-mode default used for agent-loop turns. Per-turn fast-path routing and prompt-tier selection are derived by runtime, not configured here. */
+    "executionMode"?: "interactive" | "execute" | "background" | "automation";
+    /** Durable planning policy default used for agent-loop turns. standard executes normally; review_required creates a reviewed plan before interactive execution. */
+    "planningPolicy"?: "standard" | "review_required";
+    /** Operating mode used to tune the agent toward the selected kind of work. */
+    "workMode"?: "balanced" | "coding" | "business" | "analyst" | "operator" | "creative";
+    /** Response persona applied beneath runtime policy and explicit agent instructions. */
+    "persona"?: "friendly" | "pragmatic" | "professional" | "concise" | "calm" | "mentor" | "assertive";
+    /** Additional per-agent system instructions persisted with the definition. Runtime policy still has higher priority. */
+    "systemInstructions"?: string;
+    /** Durable cross-run memory defaults such as recall budget, retained summary size, and retention horizon. */
+    "memoryPolicy"?: SwaggerAgentMemoryPolicyDto;
+    /** Release metadata and rollout controls for governed agent capabilities. */
+    "release"?: SwaggerAgentReleaseConfigDto;
+    /** Enterprise automation defaults such as delivery mode, approval routing, and future delivery settings. */
+    "automation"?: SwaggerAgentAutomationPolicyConfigDto;
+    /** Cheap-turn cost controls for persona, agent instructions, and memory recall on read-only fast paths. */
+    "cheapTurn"?: SwaggerAgentCheapTurnPolicyDto;
+    /** Additional registered tool names associated with this agent. The runtime still exposes the complete callable tool registry. */
+    "toolNames"?: Array<string>;
+    /** Default registry plugin ids attached to this agent. These are the agent-owned baseline attachments applied to every run unless additional runtime plugin ids are supplied. */
+    "pluginIds"?: Array<string>;
+    /** Primary plugin contract surface. Plugins are provider-governed and define the executable agent-plugin surface. */
+    "plugins"?: Array<SwaggerAgentPluginConfigDto>;
+    /** Maximum number of concurrently admitted root runs for this agent. Additional root runs remain queued until capacity is released. */
+    "maxActiveRootRuns"?: number;
+    /** Maximum number of delegated child runs the parent may spawn per execution plan. */
+    "maxChildRuns"?: number;
+    /** Maximum number of delegated child runs that one parent may start concurrently. Remaining delegated steps wait for a later parent tick. */
+    "maxConcurrentChildRuns"?: number;
+    /** Maximum number of ticks allowed for one run. */
+    "maxTicks"?: number;
+    /** How the parent reacts when one delegated child fails. */
+    "childFailureMode"?: "fail_parent" | "merge_partial";
+}
+interface SwaggerAgentMemoryPolicyDto {
+    /** Whether the runtime may load and persist durable cross-run memory for this agent. */
+    "enabled"?: boolean;
+    /** Maximum number of memory records the runtime should recall into one run. */
+    "maxRecallEntries"?: number;
+    /** Total character budget reserved for compact recalled memory summaries across one run. */
+    "maxRecallChars"?: number;
+}
+interface SwaggerAgentPluginApprovalConfigDto {
+    /** How plugin execution approval is enforced before the provider call is made. */
+    "mode"?: "none" | "always" | "conditional";
+    /** Safety tier enforced for approval and mutation governance. */
+    "safetyTier"?: "read" | "write" | "destructive" | "external" | "execute";
+}
+interface SwaggerAgentPluginComponentToolConfigDto {
+    /** Whether this component-backed tool is enabled for runtime selection and execution. */
+    "enabled"?: boolean;
+    /** Whether this component-backed tool is deferred behind discovery instead of eagerly exposed. */
+    "deferLoading"?: boolean;
+    /** Explicit local tool alias exposed to the runtime when set. */
+    "alias"?: string;
+    /** Operator-facing title for this component-backed tool. */
+    "title"?: string;
+    /** Tool-specific description exposed to the assistant runtime. */
+    "description"?: string;
+    /** Stable implementation entrypoint passed to the component in api.input().agentTool.entrypoint. Defaults to the tool key. */
+    "entrypoint"?: string;
+    /** Static runtime inputs passed to the component under api.input().agentTool.inputs. */
+    "inputs"?: Record<string, unknown>;
+    /** Named component result to return when the component executor supports result popping. */
+    "popResult"?: string;
+    /** Strict structured input schema exposed for this tool. The component receives matching arguments under api.input().agentTool.args. Must be an object schema with additionalProperties=false and descriptions on every declared property. */
+    "inputSchema"?: Record<string, unknown>;
+    /** Structured output schema expected from this tool. */
+    "outputSchema"?: Record<string, unknown>;
+    /** Per-tool approval contract enforced before execution. */
+    "approvalPolicy"?: SwaggerAgentPluginApprovalConfigDto;
+    /** Declared mutation intent for this component-backed tool. */
+    "mutationIntent"?: "read" | "write" | "destructive" | "external";
+    /** Declared reversibility for this component-backed tool. */
+    "reversibility"?: "reversible" | "operator_reversible" | "irreversible" | "unknown";
+    /** Primary runtime scope impacted by this component-backed tool. */
+    "targetScope"?: "assistant_thread" | "agent" | "tenant" | "external";
+    /** Concise side-effect declaration recorded for this tool. */
+    "sideEffectSummary"?: string;
+    /** Normalized side-effect categories used for rollout and operator review. */
+    "sideEffectCategories"?: Array<string>;
+    /** Optional rollout policy applied to this tool. */
+    "rollout"?: SwaggerAgentReleaseRolloutPolicyDto;
+}
+interface SwaggerAgentPluginComponentToolsetDto {
+    /** Default governance and loading policy for component-backed tools. */
+    "defaultConfig"?: SwaggerAgentPluginComponentToolConfigDto;
+    /** Component-backed tools keyed by stable capability name. */
+    "tools"?: Record<string, unknown>;
+}
+interface SwaggerAgentPluginConfigDto {
+    /** Plugin contract version for the governed runtime surface. */
+    "contractVersion"?: number;
+    /** Stable plugin id used by the agent runtime. */
+    "id"?: string;
+    /** Plugin execution provider kind. */
+    "kind"?: "tools" | "mcp_server" | "skill" | "package";
+    /** Operator-facing plugin name. */
+    "name"?: string;
+    /** Optional plugin description. */
+    "description"?: string;
+    /** Canonical English routing metadata used for planner and fallback matching. Operator-facing name and description may remain localized. */
+    "routing"?: SwaggerAgentPluginRoutingConfigDto;
+    /** Execution mode expected for the plugin provider. */
+    "executionMode"?: "sync" | "background";
+    /** Component id executed when this plugin runs. */
+    "componentId"?: string;
+    /** Optional fixed component version. */
+    "componentVersion"?: number;
+    /** Multiple governed tool contracts backed by the same component implementation. */
+    "componentToolset"?: SwaggerAgentPluginComponentToolsetDto;
+    /** Remote MCP server configuration used when `kind` is `mcp_server`. */
+    "mcpServer"?: SwaggerAgentPluginMcpConfigDto;
+    /** Per-tool MCP governance and loading configuration used when `kind` is `mcp_server`. */
+    "mcpToolset"?: SwaggerAgentPluginMcpToolsetDto;
+    /** Markdown skill configuration used when `kind` is `skill`. */
+    "skill"?: SwaggerAgentPluginSkillConfigDto;
+    /** Markdown package manifest and dependency ids used when `kind` is `package`. */
+    "package"?: SwaggerAgentPluginPackageConfigDto;
+    /** Strict structured input schema exposed to discovery and runtime validation. Must be an object schema with additionalProperties=false and descriptions on every declared property. */
+    "inputSchema"?: Record<string, unknown>;
+    /** Structured output schema expected from the plugin provider. */
+    "outputSchema"?: Record<string, unknown>;
+    /** Approval contract enforced before execution. */
+    "approvalPolicy"?: SwaggerAgentPluginApprovalConfigDto;
+    /** Declared mutation intent for governance and planner safety. */
+    "mutationIntent"?: "read" | "write" | "destructive" | "external";
+    /** Declared reversibility of the plugin side effects. */
+    "reversibility"?: "reversible" | "operator_reversible" | "irreversible" | "unknown";
+    /** Primary runtime scope impacted when the plugin executes. */
+    "targetScope"?: "assistant_thread" | "agent" | "tenant" | "external";
+    /** Concise side-effect declaration recorded in approval, evidence, and audit surfaces. */
+    "sideEffectSummary"?: string;
+    /** Normalized side-effect categories used for rollout and operator review. */
+    "sideEffectCategories"?: Array<string>;
+    /** Maximum runtime in milliseconds. */
+    "timeoutMs"?: number;
+    /** Maximum serialized result size in bytes. */
+    "resultMaxBytes"?: number;
+    /** Whether the plugin should be surfaced as summary-only discovery context before explicit attachment. */
+    "autoDiscovery"?: boolean;
+    /** Whether the plugin is enabled for execution. */
+    "enabled"?: boolean;
+}
+interface SwaggerAgentPluginMcpConfigDto {
+    /** Remote MCP transport supported by the SaaS runtime. */
+    "transport"?: "streamable_http" | "sse";
+    /** Absolute HTTPS endpoint for the remote MCP server. */
+    "url"?: string;
+    /** Manifest cache time-to-live in milliseconds. */
+    "manifestTtlMs"?: number;
+    /** Connection and handshake timeout in milliseconds. */
+    "connectTimeoutMs"?: number;
+    /** Prefix used to derive local MCP tool names from remote tool names. */
+    "toolNamePrefix"?: string;
+    /** Auth mode used when calling the remote MCP server. */
+    "authMode"?: "none" | "bearer" | "basic" | "header";
+    /** Secret id containing the bearer token. */
+    "bearerSecretId"?: string;
+    /** Optional secret data revision id for the bearer token binding. */
+    "bearerSecretDataId"?: string;
+    /** Optional username for basic auth. */
+    "basicUsername"?: string;
+    /** Secret id containing the basic auth password. */
+    "basicPasswordSecretId"?: string;
+    /** Optional secret data revision id for the basic auth password binding. */
+    "basicPasswordSecretDataId"?: string;
+    /** Additional header bindings resolved from tenant secrets before calling the MCP server. */
+    "headers"?: Array<SwaggerAgentPluginMcpHeaderBindingDto>;
+}
+interface SwaggerAgentPluginMcpHeaderBindingDto {
+    /** Header name sent to the remote MCP server. */
+    "name"?: string;
+    /** Secret id containing the header value. */
+    "secretId"?: string;
+    /** Optional secret data revision id when the binding should pin a specific secret revision. */
+    "secretDataId"?: string;
+    /** Optional static header value used when the binding does not read from a secret. */
+    "value"?: string;
+    /** Optional static prefix added before the resolved secret value, for example `Bearer `. */
+    "prefix"?: string;
+}
+interface SwaggerAgentPluginMcpToolConfigDto {
+    /** Whether the tool is enabled for runtime selection and execution. */
+    "enabled"?: boolean;
+    /** Whether the tool is deferred behind discovery instead of eagerly exposed. */
+    "deferLoading"?: boolean;
+    /** Explicit local tool alias exposed to the runtime when set. */
+    "alias"?: string;
+    /** Per-tool approval contract enforced before execution. */
+    "approvalPolicy"?: SwaggerAgentPluginApprovalConfigDto;
+    /** Declared mutation intent for this remote tool override. */
+    "mutationIntent"?: "read" | "write" | "destructive" | "external";
+    /** Declared reversibility for this remote tool override. */
+    "reversibility"?: "reversible" | "operator_reversible" | "irreversible" | "unknown";
+    /** Primary runtime scope impacted by this remote tool override. */
+    "targetScope"?: "assistant_thread" | "agent" | "tenant" | "external";
+    /** Concise side-effect declaration recorded for this remote tool override. */
+    "sideEffectSummary"?: string;
+    /** Optional rollout policy applied to this remote tool override. */
+    "rollout"?: SwaggerAgentReleaseRolloutPolicyDto;
+}
+interface SwaggerAgentPluginMcpToolsetDto {
+    /** Default governance and loading policy for tools discovered from this MCP server. */
+    "defaultConfig"?: SwaggerAgentPluginMcpToolConfigDto;
+    /** Per-remote-tool overrides keyed by remote tool name. */
+    "configs"?: Record<string, unknown>;
+}
+interface SwaggerAgentPluginPackageConfigDto {
+    /** Stable package identity used across internal catalogs and future community marketplace publishing. */
+    "externalId": string;
+    /** Package content format. Markdown is the only supported v1 format. */
+    "format"?: "markdown";
+    /** Markdown instruction content loaded into the assistant runtime when the package is attached. */
+    "content"?: string;
+    /** Registry plugin ids declared as package dependencies. */
+    "pluginIds"?: Array<string>;
+    /** Disabled marketplace-facing package metadata reserved for catalog publishing. */
+    "metadata"?: SwaggerAgentPluginPackageMetadataDto;
+    /** Maximum number of package content characters allowed into one prompt. */
+    "maxPromptChars"?: number;
+}
+interface SwaggerAgentPluginPackageMetadataDto {
+    /** Package avatar or icon URL shown in package catalogs. */
+    "avatarUrl"?: string;
+    /** Package website URL. */
+    "websiteUrl"?: string;
+    /** Package documentation URL. */
+    "documentationUrl"?: string;
+    /** Package terms of service URL. */
+    "termsOfServiceUrl"?: string;
+    /** Package privacy policy URL. */
+    "privacyPolicyUrl"?: string;
+    /** Package support URL. */
+    "supportUrl"?: string;
+    /** Publisher display name. */
+    "publisherName"?: string;
+    /** Publisher website URL. */
+    "publisherUrl"?: string;
+    /** Package license label. */
+    "license"?: string;
+    /** Package catalog categories. */
+    "categories"?: Array<string>;
+    /** Package search tags. */
+    "tags"?: Array<string>;
+}
+interface SwaggerAgentPluginRoutingConfigDto {
+    /** Canonical English routing title used for planner and fallback matching. Display names may remain localized. */
+    "title"?: string;
+    /** Canonical English routing summary used for planner and fallback matching. Display descriptions may remain localized. */
+    "summary"?: string;
+}
+interface SwaggerAgentPluginSkillConfigDto {
+    /** Skill content format. Markdown is the only supported v1 format. */
+    "format"?: "markdown";
+    /** Markdown instruction content loaded into the assistant runtime when the plugin is attached. */
+    "content"?: string;
+    /** Registry plugin ids declared as one-level skill dependencies. */
+    "pluginIds"?: Array<string>;
+    /** Maximum number of skill content characters allowed into one prompt. */
+    "maxPromptChars"?: number;
+}
+interface SwaggerAgentPolicyDto {
+    /** Default approval mode applied to agent tool calls when no per-tool override exists. */
+    "defaultToolPermission"?: "default" | "auto_review" | "full";
+    /** Per-tool approval mode overrides keyed by the runtime tool name. */
+    "toolPermissions"?: Record<string, "default" | "auto_review" | "full">;
+    /** Additional policy-managed tool names. Tool permissions govern operations without truncating the callable registry. */
+    "toolNames"?: Array<string>;
+    /** Policy-enforced registry plugin ids attached to this agent. These are governance-managed attachments and are merged in regardless of run-level plugin selection. */
+    "pluginIds"?: Array<string>;
+    /** Policy-managed plugins merged with config plugins before execution-time routing narrows the active surface. */
+    "plugins"?: Array<SwaggerAgentPluginConfigDto>;
+    /** Policy-enforced maximum number of concurrently admitted root runs for this agent. */
+    "maxActiveRootRuns"?: number;
+    /** Maximum number of delegated child runs allowed by policy. */
+    "maxChildRuns"?: number;
+    /** Policy-enforced maximum number of delegated child runs that one parent may start concurrently. */
+    "maxConcurrentChildRuns"?: number;
+    /** Maximum number of ticks allowed by policy. */
+    "maxTicks"?: number;
+    /** How the parent reacts when one delegated child fails. */
+    "childFailureMode"?: "fail_parent" | "merge_partial";
+}
+interface SwaggerAgentReleaseConfigDto {
+    /** Operator-facing release label such as 2026.04.10 or canary-1. */
+    "versionLabel"?: string;
+    /** Short operator-facing rollout or change summary for the current definition. */
+    "changeSummary"?: string;
+    /** Routing rollout policy used for shadow, canary, enable, disable, and rollback decisions. */
+    "routingRollout"?: SwaggerAgentReleaseRolloutPolicyDto;
+    /** Delegated worker rollout policy used for staged worker enablement and rollback planning. */
+    "workerRollout"?: SwaggerAgentReleaseRolloutPolicyDto;
+    /** Plugin rollout policy used for staged plugin execution and rollback planning. */
+    "pluginRollout"?: SwaggerAgentReleaseRolloutPolicyDto;
+}
+interface SwaggerAgentReleaseRolloutPolicyDto {
+    /** Current rollout mode for the governed feature or plugin surface. */
+    "mode"?: "disabled" | "shadow" | "canary" | "enabled";
+    /** Canary percentage used when mode=canary. */
+    "canaryPercent"?: number;
+    /** Shadow sampling percentage used when mode=shadow. */
+    "shadowSamplePercent"?: number;
+    /** Required deterministic eval suite name for this rollout policy. */
+    "requiredEvalSuite"?: string;
+    /** Telemetry scorecards that operators must watch during rollout. */
+    "requiredTelemetryScorecards"?: Array<string>;
+    /** Optional admitted snapshot to roll back to when the current rollout is revoked. */
+    "rollbackToSnapshotId"?: string;
+}
+interface SwaggerDatabaseDefinition {
+    /** Column id, required only for update. */
+    "databaseDefinitionId"?: string;
+    /** Name. */
+    "name": string;
+    /** Description. */
+    "desc"?: string | null;
+    /** You need to specify type [SMALLINT,INTEGER,BIGINT,REAL,DOUBLE PRECISION,NUMERIC,JSON,JSONB,TEXT,UUID,DATE,TIME,TIMETZ,TIMESTAMP,TIMESTAMPTZ,BOOLEAN]. */
+    "type": "SMALLINT" | "INTEGER" | "BIGINT" | "REAL" | "DOUBLE PRECISION" | "NUMERIC" | "JSON" | "JSONB" | "TEXT" | "UUID" | "DATE" | "TIME" | "TIMETZ" | "TIMESTAMP" | "TIMESTAMPTZ" | "BOOLEAN";
+    /** Provide if this column is primary key. */
+    "isPrimaryKey": boolean;
+    /** Provide if this column is array of provided type, primary keys cannot be arrays. */
+    "isArray": boolean;
+    /** Provide if this column should contain only unique values for entire table. */
+    "isUnique": boolean;
+    /** Provide if this column should can contain NULL values or not. */
+    "isNullable": boolean;
+    /** Provide if this column should should be index. */
+    "isIndex": boolean;
+    /** Default: boolean, number, string */
+    "default"?: string | boolean | number | null;
+    /** Foreign references to other database definitions. */
+    "foreignReferences"?: Array<SwaggerDatabaseDefinitionForeignReferences> | null;
+}
+interface SwaggerDatabaseDefinitionForeignReference {
+    /** Column. */
+    "column": string;
+    /** Target database. */
+    "targetDatabase": string;
+    /** Target column. */
+    "targetColumn": string;
+}
+interface SwaggerDatabaseDefinitionForeignReferences {
+    /** You need to specify reference type [SMALLINT,INTEGER,BIGINT,REAL,DOUBLE PRECISION,NUMERIC,JSON,JSONB,TEXT,UUID,DATE,TIME,TIMETZ,TIMESTAMP,TIMESTAMPTZ,BOOLEAN]. */
+    "reference": Array<SwaggerDatabaseDefinitionForeignReference>;
+    /** You need to specify what happen on update of referenced table data, "none" will raise an error if there are records existing in this table that reference it. */
+    "onUpdate": "none" | "cascade" | "restrict";
+    /** You need to specify what happen on update of referenced table data, "none" will raise an error if there are records existing in this table that reference it. */
+    "onDelete": "none" | "cascade" | "restrict" | "default" | "null";
+}
+interface SwaggerPartitionDefinition {
+    /** Partition type. */
+    "type"?: "LIST" | "RANGE" | "HASH";
+    /** Column name to use as partition key. Must match one of the column names in definition. */
+    "key"?: string;
+    /** Mark if this partition is default. */
+    "isDefault"?: boolean;
+    /** For LIST partitioning: array of values. For RANGE partitioning: not used. */
+    "values"?: Array<string>;
+    /** For RANGE partitioning: starting value (use "MINVALUE" for unbounded start). */
+    "from"?: Record<string, unknown>;
+    /** For RANGE partitioning: ending value (use "MAXVALUE" for unbounded end). */
+    "to"?: Record<string, unknown>;
+    /**
+        The modulus value for a HASH partition.
+        Required only when the partition type is HASH.
+        It represents the total number of hash partitions.
+        The remainder value (0 to modulus - 1) determines which partition a row belongs to.
+       */
+    "modulus"?: number;
+    /**
+        The remainder value for a HASH partition.
+        Required only when the partition type is HASH.
+        This value must be between 0 and (modulus - 1).
+        Determines which partition a row will belong to within the hash partitions.
+       */
+    "remainder"?: number;
+}
+interface SwaggerStorageRetentionDto {
+    /** Positive lifetime in seconds. The lifetime starts when the file is finalized. */
+    "ttlSeconds"?: number;
+    /** Absolute future expiration timestamp in ISO 8601 format. */
+    "expiresAt"?: string;
+}
+interface SwaggerWebhookRequestDetailsDto {
+    "url": string;
+    "method": "POST" | "GET" | "HEAD" | "PUT" | "DELETE" | "PATCH" | "OPTIONS";
+    /** Body. */
+    "body"?: Record<string, unknown>;
+    /** Headers. */
+    "headers"?: Record<string, unknown>;
+}
+interface AgentRunCancelInput {
+    /** Optional cancellation reason for audit traces. */
+    "reason"?: string;
+}
+interface DatabaseCloneInput {
+    /** Optional audit override. Defaults to the source logical table setting. */
+    "audit"?: boolean;
+    /** Optional target root database name. Defaults to the source database name with "_Clone" suffix. */
+    "name"?: string;
+    /** Suffix used for automatically generated clone names. Defaults to "Clone". */
+    "suffix"?: string;
+    /** Whether to copy existing rows/items into the clone. Defaults to false. */
+    "includeItems"?: boolean;
+    /** Alias for includeItems. Defaults to false. */
+    "includeData"?: boolean;
+    /** Whether to clone connected table partitions. Defaults to true. */
+    "includePartitions"?: boolean;
+    /** Optional cloned database category override. */
+    "category"?: string;
+    /** Optional cloned database description override. */
+    "desc"?: string;
+    /** Optional cloned database tags override. */
+    "tags"?: Array<string>;
+    /** Optional cloned database restricted flag override. */
+    "restricted"?: boolean;
+    /** Optional cloned database group access override. */
+    "groups"?: Array<string>;
+    /** Optional cloned database user access override. */
+    "users"?: Array<string>;
+}
+interface AgentCreateInput {
+    /** Stable display name of the agent. */
+    "name": string;
+    /** Optional operator-facing description. */
+    "desc"?: string;
+    /** User id of the service account used as the execution principal. */
+    "serviceAccountUserId": string;
+    /** Owning user or group id used for visibility and management. */
+    "ownerId"?: string;
+    /** Owner type, typically USER or GROUP. */
+    "ownerType"?: string;
+    /** Optional resource metadata. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Persisted agent identity and runtime defaults such as model, persona, custom system instructions, memory policy, planning mode, and loop limits. Per-turn prompt tier, fast-path eligibility, and route telemetry are derived by runtime and are not accepted here. */
+    "config"?: SwaggerAgentConfigDto;
+    /** Persisted policy constraints such as tool allowlists, agent plugins, and delegation ceilings. Runtime-only route metadata is not configured here. */
+    "policy"?: SwaggerAgentPolicyDto;
+}
+interface AgentInboxItemCreateInput {
+    /** Logical task type such as task, incident, sync, or concierge_message. */
+    "type"?: string;
+    /** Instruction that will be passed into the agent run when the item is claimed. */
+    "instruction": string;
+    /** Opaque task payload persisted with the inbox item and copied into the run state. */
+    "payload"?: Record<string, unknown>;
+    /** Queue priority. Higher values are claimed first. */
+    "priority"?: number;
+    /** Optional ISO timestamp after which the inbox item becomes claimable. */
+    "availableAt"?: string;
+    /** Optional de-duplication key unique per agent among non-terminal inbox items. */
+    "dedupeKey"?: string;
+}
+interface DatabaseCreateInput {
+    /** Capture future row inserts, updates, and deletes in database audit history. */
+    "audit"?: boolean;
+    /** Name. */
+    "name": string;
+    /** Category. */
+    "category"?: string;
+    /** Description. */
+    "desc"?: string;
+    /** Optional resource metadata. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Provide if access should be restricted. */
+    "restricted": boolean;
+    /** Provide which groups should have access to it, once restricted is true. */
+    "groups"?: Array<string>;
+    /** Provide which users should have access to it, once restricted is true. */
+    "users"?: Array<string>;
+    /** Database definitions. */
+    "definition"?: Array<SwaggerDatabaseDefinition>;
+    /** Name. */
+    "parent"?: string;
+    /** Partition configuration. */
+    "partition"?: SwaggerPartitionDefinition;
+}
+interface AssistantMessageInput {
+    /** Content of the message, validated up to 100000 tokens. */
+    "content": string;
+    /** Optional hidden draft user message id created before attachment uploads. When provided, the send operation finalizes that draft instead of creating a new user message. */
+    "preflightMessageId"?: string;
+    /** Optional assistant execution-model override. GPT-5.6 Luna is the default; Sol, Terra, Luna, and GPT-5.4 Nano are supported. */
+    "model"?: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.4-nano";
+    /** Optional assistant reasoning effort override: low, medium, high, or xhigh. Defaults to low. */
+    "reasoningEffort"?: "low" | "medium" | "high" | "xhigh";
+    /** Alias for reasoningEffort used by assistant preferences. Prefer reasoningEffort for new clients. */
+    "reasoning"?: "low" | "medium" | "high" | "xhigh";
+    /** Optional flag selecting deadline-bounded background provider recovery. On SSE routes it also allows the turn to continue after client disconnect. Defaults to false. */
+    "backgroundProcessing"?: boolean;
+    /** Optional flag for send-message endpoints. When true, an active streamed assistant turn for the thread is interrupted before appending this message. */
+    "interruptActive"?: boolean;
+    /** Internal steer flag set by steer endpoints. When true, the visible user message is preserved while the executor receives a wrapper telling it to apply the message as a correction or refinement to the interrupted task. */
+    "steeringMode"?: boolean;
+    /** Optional durable turn goal for non-plan execution. Agent runtime carries this goal across tool loops, compaction, and follow-up turns without forcing visible plan review. */
+    "goal"?: string;
+    /** Execution mode for the turn. Interactive may pause for approval or clarification. Background and automation should avoid user-blocking pauses. */
+    "executionMode"?: "interactive" | "execute" | "background" | "automation";
+    /** Planning policy for the turn. standard lets the assistant use internal planning and optionally expose progress; review_required always creates a user-reviewed plan before execution. */
+    "planningPolicy"?: "standard" | "review_required";
+    /** Per-turn approval policy. default requires approval for side-effecting tool calls, auto_review uses conditional safe auto-review, and full skips normal approval gates. */
+    "permissions"?: "default" | "auto_review" | "full";
+    /** Optional per-tool approval policy overrides. Runtime sanitizes keys and enum values before persisting them. */
+    "toolPermissions"?: Record<string, "default" | "auto_review" | "full">;
+    /** Optional allowlist of operational tool names for this turn. Omit to allow the gateway default surface; pass an empty array to admit no tools for direct-answer turns. */
+    "toolNames"?: Array<string>;
+    /** Optional registry plugin ids attached to this assistant turn. */
+    "pluginIds"?: Array<string>;
+    /** Optional per-turn backend performance debugger. When true, payload build timing traces are persisted into assistant report artifacts, and local/test runtimes may persist hidden model-call snapshots for this turn. */
+    "performanceDebugger"?: boolean;
+}
+interface StorageFolderInput {
+    /** Folder name. */
+    "name": string;
+    /** Parent folder id. Omit for root. */
+    "parentStorageEntryId"?: string;
+    /** Optional provider config id for root-level folders. Omit for the internal/default provider. Ignored when parentStorageEntryId is provided. */
+    "storageProviderConfigId"?: string;
+    /** Folder metadata. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Optional external reference id. */
+    "refId"?: string;
+    /** Optional external reference type. */
+    "refType"?: string;
+    /** Optional external reference version. */
+    "refVer"?: number;
+    /** Whether this folder is restricted to the provided users/groups. */
+    "restricted"?: boolean;
+    /** Explicit allowed group ids when restricted. */
+    "groups"?: Array<string>;
+    /** Explicit allowed user ids when restricted. */
+    "users"?: Array<string>;
+}
+interface StorageUploadSessionInput {
+    /** Retention for the finalized file. Duration starts at finalization; null means no expiration. */
+    "retention"?: SwaggerStorageRetentionDto | null;
+    /** Parent folder id. Required for create mode when uploading into a folder. */
+    "parentStorageEntryId"?: string;
+    /** Optional provider config id for root-level uploads. Omit for the internal/default provider. Ignored when parentStorageEntryId is provided or when replacing an existing file. */
+    "storageProviderConfigId"?: string;
+    /** Existing storage entry id to replace instead of creating a new file. */
+    "replaceStorageEntryId"?: string;
+    /** Expected current version of the file being replaced. The upload is rejected if the file changed after overwrite confirmation. */
+    "replaceExpectedVersion"?: number;
+    /** File name. Required for create mode. */
+    "name"?: string;
+    /** Expected content type. */
+    "contentTypeHint"?: string;
+    /** Expected size in bytes. */
+    "sizeHint"?: number;
+    /** Logical storage lifecycle tier. Select only when creating a new file or upload session; existing files keep their tier.
+  HOT: Active files used in live workflows, previews, and frequent downloads.
+  WARM: Completed or less-active business files that are still occasionally accessed.
+  COLD: Compliance snapshots, historic imports, and retained evidence that is rarely opened.
+  FROZEN: Deep archive or legal-hold data kept mainly for audit or recovery obligations. */
+    "tier"?: "HOT" | "WARM" | "COLD" | "FROZEN";
+    /** Upload mode. Use "direct" for provider resumable uploads, "chunked" for explicit numbered parts, and "incremental" for server-assigned part numbering by default. Incremental sessions can still re-upload a specific part number when repairing an upload. */
+    "uploadMode"?: "direct" | "chunked" | "incremental";
+    /** Default post-finalize compute mode for this upload session. */
+    "computeStats"?: "none" | "sync" | "async";
+    /** File metadata. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Optional external reference id. */
+    "refId"?: string;
+    /** Optional external reference type. */
+    "refType"?: string;
+    /** Optional external reference version. */
+    "refVer"?: number;
+    /** Whether the finalized entry should be restricted. */
+    "restricted"?: boolean;
+    /** Explicit allowed group ids for the finalized entry. */
+    "groups"?: Array<string>;
+    /** Explicit allowed user ids for the finalized entry. */
+    "users"?: Array<string>;
+}
+interface StorageUploadSessionFinalizeInput {
+    /** Optional metadata replacement at finalize time. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Optional post-finalize compute mode. */
+    "computeStats"?: "none" | "sync" | "async";
+}
+interface AssistantForkMessageInput {
+    /** Optional assistant runtime API version for the forked thread. v1 is expired and rejected. */
+    "version"?: "v1" | "v2";
+    /** Optional explicit title for the forked thread. When omitted, orchestration will generate the new thread title. */
+    "title"?: string;
+}
+interface StorageEntryMoveInput {
+    /** Destination parent folder id. Omit or pass null for root. */
+    "parentStorageEntryId"?: string;
+    /** Optional destination provider config id for root-level moves. Omit for the internal/default provider. Ignored when parentStorageEntryId is provided. */
+    "storageProviderConfigId"?: string;
+    /** Current entity version. */
+    "version"?: number;
+}
+interface StoragePutObjectInput {
+    /** File retention. Omit for the caller default, or set null for no expiration. */
+    "retention"?: SwaggerStorageRetentionDto | null;
+    /** Parent folder id. Omit for root. */
+    "parentStorageEntryId"?: string;
+    /** Optional provider config id for root-level writes. */
+    "storageProviderConfigId"?: string;
+    /** Existing file entry id to replace. */
+    "replaceStorageEntryId"?: string;
+    /** Object name. */
+    "name": string;
+    /** Object payload. For binary payloads send a base64 string and set dataEncoding to "base64". */
+    "data": string | Array<string>;
+    /** Payload encoding. */
+    "dataEncoding"?: "utf8" | "base64";
+    /** Mime type of the object. */
+    "mimeType"?: string;
+    /** Optional post-write compute mode. */
+    "computeStats"?: "none" | "sync" | "async";
+    /** Whether the finalized entry should be restricted. */
+    "restricted"?: boolean;
+    /** Explicit allowed group ids. */
+    "groups"?: Array<string>;
+    /** Explicit allowed user ids. */
+    "users"?: Array<string>;
+    /** Optional external reference id. */
+    "refId"?: string;
+    /** Optional external reference type. */
+    "refType"?: string;
+    /** Optional external reference version. */
+    "refVer"?: number;
+    /** Entry metadata. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Logical storage lifecycle tier. Select only when creating a new file or upload session; existing files keep their tier.
+  HOT: Active files used in live workflows, previews, and frequent downloads.
+  WARM: Completed or less-active business files that are still occasionally accessed.
+  COLD: Compliance snapshots, historic imports, and retained evidence that is rarely opened.
+  FROZEN: Deep archive or legal-hold data kept mainly for audit or recovery obligations. */
+    "tier"?: "HOT" | "WARM" | "COLD" | "FROZEN";
+}
+interface AssistantActionResolutionInput {
+    /** Resolution decision for the pending action. */
+    "decision": "approve" | "approve_all_for_turn" | "reject" | "submit";
+    /** Optional approval item id when resolving one item from a multi-approval action. */
+    "actionItemId"?: string;
+    /** Optional free-text response for clarification or correction context. */
+    "responseText"?: string;
+    /** Optional structured payload for clarification answers or action metadata. */
+    "responsePayload"?: Record<string, unknown>;
+    /** Optional flag selecting deadline-bounded background provider recovery. On the SSE route it also allows the resumed turn to continue after client disconnect. Streamed action resolution defaults this to true. */
+    "backgroundProcessing"?: boolean;
+    /** Optional assistant model override for the resumed turn after this action is resolved. */
+    "model"?: "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.4-nano";
+    /** Optional assistant reasoning effort override for the resumed turn: low, medium, high, or xhigh. */
+    "reasoningEffort"?: "low" | "medium" | "high" | "xhigh";
+    /** Alias for reasoningEffort used by assistant preferences. Prefer reasoningEffort for new clients. */
+    "reasoning"?: "low" | "medium" | "high" | "xhigh";
+    /** Execution mode override for the resumed turn after this action is resolved. */
+    "executionMode"?: "interactive" | "execute" | "background" | "automation";
+    /** Planning policy override for the resumed turn after this action is resolved. */
+    "planningPolicy"?: "standard" | "review_required";
+    /** Optional operational tool names admitted for the resumed turn. Omit to keep the current thread admission; pass an empty array to admit no tools for direct-answer continuation. */
+    "toolNames"?: Array<string>;
+    /** Optional additional registry plugin ids attached to the resumed turn. */
+    "pluginIds"?: Array<string>;
+}
+interface StorageRestoreInput {
+    /** Current entity version. */
+    "version": number;
+    /** Required for TTL-expired entries. Use null to restore without another expiration. */
+    "retention"?: SwaggerStorageRetentionDto | null;
+}
+interface AgentRunInput {
+    /** Instruction or mission passed to the root agent run. */
+    "instruction": string;
+    /** Optional trigger type such as REQUEST, EVENT, or SCHEDULE. */
+    "triggerType"?: string;
+    /** Optional external reference type for correlation. */
+    "triggerRefType"?: string;
+    /** Optional external reference id for correlation. */
+    "triggerRefId"?: string;
+    /** Optional delay before the first tick is scheduled. */
+    "delaySeconds"?: number;
+    /** Optional run-scoped state merged into the initial supervisor state. */
+    "state"?: Record<string, unknown>;
+    /** Optional registry plugin ids attached for this run. */
+    "pluginIds"?: Array<string>;
+}
+interface StorageVersionInput {
+    /** Current entity version. */
+    "version": number;
+}
+interface AgentUpdateInput {
+    /** Updated display name of the agent. */
+    "name"?: string;
+    /** Updated operator-facing description. */
+    "desc"?: string;
+    /** Optional status transition, for example ACTIVE or PAUSED. */
+    "status"?: "ACTIVE" | "PAUSED" | "DISABLED";
+    /** Replacement service-account execution principal. */
+    "serviceAccountUserId"?: string;
+    /** Updated owner id. */
+    "ownerId"?: string;
+    /** Updated owner type. */
+    "ownerType"?: string;
+    /** Replacement resource metadata. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Replacement persisted agent identity and runtime defaults. Fast-path routing, prompt tier, and per-turn telemetry stay runtime-derived. */
+    "config"?: SwaggerAgentConfigDto;
+    /** Replacement persisted policy constraints. Execution-time route metadata stays derived from the current turn. */
+    "policy"?: SwaggerAgentPolicyDto;
+    /** Optimistic locking version. */
+    "version"?: number;
+}
+interface AgentInboxItemUpdateInput {
+    /** Logical task type such as task, incident, sync, or concierge_message. */
+    "type"?: string;
+    /** Instruction that will be passed into the agent run when the item is claimed. */
+    "instruction"?: string;
+    /** Opaque task payload persisted with the inbox item and copied into the run state. */
+    "payload"?: Record<string, unknown>;
+    /** Queue priority. Higher values are claimed first. */
+    "priority"?: number;
+    /** Optional ISO timestamp after which the inbox item becomes claimable. */
+    "availableAt"?: string;
+    /** Optional de-duplication key unique per agent among non-terminal inbox items. */
+    "dedupeKey"?: string;
+}
+interface DatabaseUpdateInput {
+    /** Enable or disable future row audit capture for the logical table. */
+    "audit"?: boolean;
+    /** Name. */
+    "name"?: string;
+    /** Category. */
+    "category"?: string;
+    /** Description. */
+    "desc"?: string;
+    /** Replacement resource metadata. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Provide if access should be restricted. */
+    "restricted"?: boolean;
+    /** Provide which groups should have access to it, once restricted is true. */
+    "groups"?: Array<string>;
+    /** Provide which users should have access to it, once restricted is true. */
+    "users"?: Array<string>;
+    /** Database definitions. */
+    "definition"?: Array<SwaggerDatabaseDefinition>;
+    /** Provide current version. */
+    "version": number;
+}
+interface StorageEntryUpdateInput {
+    /** Replacement file retention. Omit to preserve, or set null to clear expiration. */
+    "retention"?: SwaggerStorageRetentionDto | null;
+    /** New display name. */
+    "name"?: string;
+    /** Metadata replacement. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+    /** Whether this entry is restricted to the provided users/groups. */
+    "restricted"?: boolean;
+    /** Explicit allowed group ids. */
+    "groups"?: Array<string>;
+    /** Explicit allowed user ids. */
+    "users"?: Array<string>;
+    /** Current entity version. */
+    "version"?: number;
+}
+interface AssistantThreadGoalInput {
+    /** Durable thread-level objective used to validate assistant completion across turns, tool loops, approval resumes, and compaction. */
+    "objective": string;
+    /** Optional concrete criteria the goal reviewer should require before marking the goal satisfied. */
+    "successCriteria"?: Array<string>;
+    /** Optional exclusions that should not be treated as required work for this goal. */
+    "nonGoals"?: Array<string>;
+    /** Optional evidence the reviewer should expect, such as tests, lint, screenshots, API results, or changed resources. */
+    "requiredEvidence"?: Array<string>;
+    /** Optional validation commands or checks relevant to this goal. */
+    "validationCommands"?: Array<string>;
+    /** Optional concise definition of done used by the reviewer when evaluating candidate completion. */
+    "doneDefinition"?: string;
+}
+interface AssistantThreadTitleInput {
+    /** New user-defined title for the thread. */
+    "title": string;
+}
+interface StorageUploadPartInput {
+    /** Part payload. Use base64 for binary payloads. */
+    "data": string | Array<string>;
+    /** Payload encoding. */
+    "dataEncoding"?: "utf8" | "base64";
+}
+interface WebhookInput {
+    /** Optional Id of webhook. */
+    "customId"?: string;
+    /** Creator of event will be set as System not requester. */
+    "system"?: boolean;
+    /** Mark if proxy should be used with static outbound IP. */
+    "proxy"?: boolean;
+    /** Save entire request. */
+    "saveDetails"?: boolean;
+    /** Max attempts. */
+    "maxAttempts"?: number;
+    /** Provide data */
+    "request"?: SwaggerWebhookRequestDetailsDto;
+    /** Mask request details. */
+    "maskDetails"?: Array<string>;
+    /** Override creator. */
+    "createdBy"?: string;
+    /** Optional key/value metadata for grouping and querying webhooks. Top-level keys starting with "__" are reserved for backend use. */
+    "metadata"?: Record<string, unknown>;
+}
+/**
+ * Canonical public low-code API declarations shared by Monaco and local editors.
+ * Lifecycle input DTOs are generated from Swagger in api.swagger-contracts.generated.d.ts.
+ * Edit this file for model guidance, then regenerate api.monaco.ts.
+ */
+/**
+ * Supported database column types used by schema metadata and casts.
+ */
+type DatabaseDefinitionType = 'SMALLINT' | 'INTEGER' | 'BIGINT' | 'REAL' | 'DOUBLE PRECISION' | 'NUMERIC' | 'JSON' | 'JSONB' | 'TEXT' | 'UUID' | 'DATE' | 'TIME' | 'TIMETZ' | 'TIMESTAMP' | 'TIMESTAMPTZ' | 'BOOLEAN';
+/**
+ * Logical filter value types used by operator validation.
+ */
+type ValueType = 'number' | 'text' | 'uuid' | 'date' | 'datetime' | 'time' | 'boolean' | 'json';
+/**
+ * Sort direction accepted by object-based sort definitions.
+ */
+type SortDir = 'ASC' | 'DESC' | 'asc' | 'desc';
+type JoinType = 'left' | 'inner';
+type ExecutionTargetType = 'JOB_TEMPLATE' | 'AGENT' | (string & {});
+/**
+ * Supported payload validator types for util.validate().
+ */
+type ValidatorType = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'date' | 'any';
+interface ValidatorProperty {
+    type: ValidatorType;
+    required?: boolean;
+    regex?: string;
+    min?: number;
+    max?: number;
+    objectSchema?: ValidatorObject[];
+    arraySchema?: ValidatorProperty;
+}
+interface ValidatorObject {
+    property: string;
+    schema: ValidatorProperty;
+}
+interface ValidatorSchemaInput {
+    whitelist?: boolean;
+    whitelistErrors?: boolean;
+    schema: ValidatorProperty;
+}
+interface ValidationResult<T = any> {
+    valid: boolean;
+    errors: string[];
+    value: T;
+}
+/**
+ * Allowed SQL functions for safe dynamic selects and expressions.
+ */
+type RawAllowedFn = 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'LOWER' | 'UPPER' | 'TRIM' | 'LENGTH' | 'COALESCE' | 'NULLIF' | 'ROUND' | 'ABS' | 'GREATEST' | 'LEAST' | 'JSONB_BUILD_OBJECT' | 'JSONB_AGG' | 'ARRAY_AGG' | 'NOW' | 'DATE_TRUNC';
+/**
+ * Canonical filter operators supported by the ORM.
+ */
+type FilterOp = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'notLike' | 'ilike' | 'notILike' | 'in' | 'notIn' | 'any' | 'isNull' | 'isNotNull' | 'between' | 'contains' | 'containedBy' | 'arrayHas' | 'arrayHasAny' | 'arrayHasAll' | 'arrayContainedBy' | 'jsonArrayHas' | 'jsonArrayHasAny' | 'jsonArrayHasAll' | 'startsWith' | 'endsWith' | 'true' | 'false';
+/**
+ * Primitive parameter values that can be safely bound to SQL placeholders.
+ */
+type SqlPrimitive = string | number | boolean | Date | null;
+/**
+ * Reusable SQL-safe expression building block.
+ * Used inside select items, function args, raw placeholders, joins, casts and case statements.
+ */
+type SelectExpr = string | {
+    field: string;
+    castAs?: DatabaseDefinitionType;
+} | {
+    value: SqlPrimitive | Record<string, any> | any[];
+} | {
+    fn: RawAllowedFn;
+    args?: SelectExpr[];
+    distinct?: boolean;
+} | {
+    cast: SelectExpr;
+    asType: DatabaseDefinitionType;
+} | {
+    coalesce: SelectExpr[];
+} | {
+    raw: string;
+    args?: SelectExpr[];
+} | {
+    case: {
+        when: {
+            if: SelectFilterNode | SelectFilterNode[];
+            then: SelectExpr;
+        }[];
+        else?: SelectExpr;
+    };
+};
+/**
+ * Leaf filter node.
+ * Use either op/value form or shorthand operator properties.
+ */
+interface SelectFieldFilter {
+    field: string;
+    op?: FilterOp;
+    value?: any;
+    values?: any[];
+    castAs?: DatabaseDefinitionType;
+    filterType?: ValueType;
+    path?: Array<string | number>;
+    eq?: any;
+    ne?: any;
+    gt?: any;
+    gte?: any;
+    lt?: any;
+    lte?: any;
+    like?: any;
+    notLike?: any;
+    ilike?: any;
+    notILike?: any;
+    in?: any[];
+    notIn?: any[];
+    any?: any[];
+    isNull?: boolean;
+    isNotNull?: boolean;
+    between?: [
+        any,
+        any
+    ];
+    contains?: any;
+    containedBy?: any;
+    arrayHas?: any;
+    arrayHasAny?: any[];
+    arrayHasAll?: any[];
+    arrayContainedBy?: any[];
+    jsonArrayHas?: any;
+    jsonArrayHasAny?: any[];
+    jsonArrayHasAll?: any[];
+    startsWith?: any;
+    endsWith?: any;
+    true?: boolean;
+    false?: boolean;
+}
+/**
+ * Boolean AND group.
+ */
+interface SelectFilterAnd {
+    and: SelectFilterNode[];
+}
+/**
+ * Boolean OR group.
+ */
+interface SelectFilterOr {
+    or: SelectFilterNode[];
+}
+/**
+ * Boolean NOT group.
+ */
+interface SelectFilterNot {
+    not: SelectFilterNode | SelectFilterNode[];
+}
+/**
+ * Recursive filter tree.
+ * Nest groups instead of writing SQL parentheses manually.
+ */
+type SelectFilterNode = SelectFieldFilter | SelectFilterAnd | SelectFilterOr | SelectFilterNot | SelectFilterNode[];
+/**
+ * Supported select item shapes.
+ * Use plain fields for direct columns and fn/raw/cast/coalesce/case for computed output fields.
+ */
+type SelectItem = string | {
+    field: string;
+    as?: string;
+    castAs?: DatabaseDefinitionType;
+    distinct?: boolean;
+    filterType?: ValueType;
+} | {
+    fn: RawAllowedFn;
+    args?: SelectExpr[];
+    distinct?: boolean;
+    as?: string;
+    filterType?: ValueType;
+} | {
+    raw: string;
+    args?: SelectExpr[];
+    as?: string;
+    filterType?: ValueType;
+} | {
+    cast: SelectExpr;
+    asType: DatabaseDefinitionType;
+    as?: string;
+    filterType?: ValueType;
+} | {
+    coalesce: SelectExpr[];
+    as?: string;
+    filterType?: ValueType;
+} | {
+    case: {
+        when: {
+            if: SelectFilterNode | SelectFilterNode[];
+            then: SelectExpr;
+        }[];
+        else?: SelectExpr;
+    };
+    as?: string;
+    filterType?: ValueType;
+};
+/**
+ * Join condition.
+ * Unqualified left operands are resolved against the root table first.
+ * Unqualified right operands are resolved against the join table first.
+ */
+interface SelectJoinOn {
+    left: string | SelectExpr;
+    op?: '=' | '<>' | '!=' | '>' | '>=' | '<' | '<=';
+    right: string | SelectExpr;
+}
+/**
+ * Join definition.
+ * If alias is omitted, the backend defaults it to the join table name.
+ */
+interface SelectJoin {
+    alias?: string;
+    table: string;
+    type?: JoinType;
+    on: SelectJoinOn[];
+}
+/**
+ * Public structured input accepted by api.getDatabaseData(name, options).
+ * The backend injects the source table schema automatically based on the name argument.
+ */
+interface SelectInput {
+    /**
+     * Selected output columns and computed fields.
+     * If omitted, the ORM selects all root-table columns by default.
+     */
+    fields?: SelectItem[];
+    /**
+     * Related tables to join.
+     * The backend resolves join definitions automatically.
+     */
+    joins?: SelectJoin[];
+    /**
+     * Recursive filter tree.
+     * Example:
+     * { and: [{ field: 'status', op: 'eq', value: 'active' }] }
+     */
+    filter?: SelectFilterNode;
+    /**
+     * Sort definition.
+     * Array form supports '-field' for descending order.
+     */
+    sort?: string[] | Record<string, SortDir>;
+    /**
+     * Fields to use in GROUP BY when aggregate fields are selected.
+     */
+    groupBy?: string[];
+    /**
+     * Optional global cast overrides by field path.
+     */
+    cast?: Record<string, DatabaseDefinitionType>;
+    /**
+     * Maximum number of rows to return.
+     * The backend fetches one extra row internally to determine next-page availability.
+     */
+    take?: number;
+    /**
+     * Number of rows to skip.
+     */
+    skip?: number;
+    /**
+     * Reserved count flag for extended query flows.
+     */
+    count?: boolean;
+}
+/**
+ * Advanced structured selector for bulk database mutations.
+ * Legacy field-key filters such as `{ status: { equals: 'NEW' } }` are not accepted.
+ */
+interface DatabaseMutationRequest {
+    filter: SelectFilterNode;
+    joins?: SelectJoin[];
+    take?: number;
+    skip?: number;
+}
+/**
+ * Normal data response returned by the ORM query execution layer.
+ */
+interface GetDatabaseDataResponse<T = any> {
+    data: T[];
+    results: number;
+    next: boolean;
+    total?: number;
+    cache?: any;
+}
+interface BufferConstructor {
+    new (arg: number | string | number[] | string[] | ArrayBuffer | Uint8Array | Record<string, unknown>, encoding?: 'utf-8' | 'utf8'): Buffer;
+    from(input: number | string | number[] | string[] | ArrayBuffer | Uint8Array | Record<string, unknown>, encodingOrOffset?: 'utf-8' | 'utf8' | number, length?: number): Buffer;
+    alloc(size: number): Buffer;
+    allocUnsafe(size: number): Buffer;
+    byteLength(input: string | number | boolean | null | undefined, encoding?: 'utf-8' | 'utf8'): number;
+}
+/**
+ * Minimal UTF-8 Buffer compatibility exposed by the isolated V8 runtime.
+ *
+ * This is not the full Node.js Buffer API. For base64, base64url, hex,
+ * hashing, signatures, or random bytes, prefer the matching util.* helper.
+ */
+interface Buffer extends Uint8Array {
+    toString(encoding?: 'utf-8' | 'utf8'): string;
+    inspect(): string;
+}
+declare var Buffer: BufferConstructor;
+interface LooseObject<T> {
+    [key: string]: T;
+}
+interface DatabaseDefinition {
+    databaseDefinitionId?: string;
+    name: string;
+    desc: string | null;
+    type: 'SMALLINT' | 'INTEGER' | 'BIGINT' | 'REAL' | 'DOUBLE PRECISION' | 'NUMERIC' | 'JSON' | 'JSONB' | 'TEXT' | 'TIME' | 'DATE' | 'TIMETZ' | 'TIMESTAMP' | 'TIMESTAMPTZ' | 'BOOLEAN';
+    isPrimaryKey: boolean;
+    isArray: boolean;
+    isUnique: boolean;
+    isNullable: boolean;
+    isIndex: boolean;
+    default: string | boolean | number | null;
+    foreignReferences?: SwaggerDatabaseDefinitionForeignReferences[] | null;
+}
+interface Database extends BaseProperties {
+    databaseId?: string;
+    name: string;
+    category: string | null;
+    desc: string | null;
+    restricted: boolean;
+    audit: boolean;
+    groups: string[];
+    users: string[];
+    type: string;
+    definition: DatabaseDefinition[];
+    size?: {
+        total: number;
+        table: number;
+        indexes: number;
+        relations: number;
+    };
+}
+type DatabaseAuditOperation = 'INSERT' | 'UPDATE' | 'DELETE';
+/**
+ * Newest-first audit-history query. The default response contains metadata and
+ * changedFields only. To return payload data, request explicit paths in fields:
+ * e.g. ['snapshot.manufacturer', 'changes.manufacturer']. A requested path enables
+ * its snapshot/changes root automatically; if that path is absent on a historical
+ * row, its returned value is null rather than an error.
+ *
+ * changed matches events where any supplied top-level field is present in
+ * changedFields. filter is a safe, parameterized tree restricted to snapshot.* and
+ * changes.* paths. Example: { field: 'snapshot.manufacturer', op: 'eq', value: 'TRW' }.
+ * Use snapshot.* or changes.* only when the complete payload is genuinely required.
+ */
+interface DatabaseAuditQuery {
+    take?: number;
+    cursor?: string;
+    operation?: DatabaseAuditOperation;
+    createdBy?: string;
+    operationId?: string;
+    from?: string;
+    to?: string;
+    rowKey?: Record<string, any>;
+    includeSnapshot?: boolean;
+    includeChanges?: boolean;
+    fields?: string[];
+    changed?: string[];
+    filter?: any;
+}
+interface DatabaseAuditChange {
+    type: 'added' | 'updated' | 'removed';
+    before?: any;
+    after?: any;
+}
+interface DatabaseAuditListItem {
+    databaseAuditId: string;
+    databaseId: string;
+    databaseVersion: number;
+    operation: DatabaseAuditOperation;
+    createdBy: string;
+    operationId: string;
+    createdAt: Date | string;
+    rowKey: Record<string, any>;
+    previousRowKey?: Record<string, any> | null;
+    changedFields: string[];
+    snapshot?: Record<string, any>;
+    changes?: Record<string, DatabaseAuditChange | Record<string, any>>;
+}
+interface DatabaseAuditResponse {
+    data: DatabaseAuditListItem[];
+    nextCursor: string | null;
+}
+interface Webhook {
+    webhookId: string;
+    status: string;
+    statusMessage: string;
+    attempts: number;
+    maxAttempts: number;
+    request: LooseObject<any>;
+    response: LooseObject<any>;
+    createdBy: string;
+    createdAt: Date;
+    deletedBy?: string;
+    deletedAt?: Date;
+}
+interface LogInterface {
+    message: string;
+    duration?: number;
+    args?: LooseObject<any>;
+}
+interface TemplateFormData {
+    key: string;
+    value?: string;
+    /** Storage entry to append as this multipart part. Use this instead of value for binary content. */
+    storageEntryId?: string;
+    /** Storage namespace for storageEntryId. Defaults to explorer. */
+    storageNamespace?: string;
+    options?: LooseObject<boolean | number | string>;
+}
+interface HttpStorageSourceRef {
+    /** Existing Storage file whose bytes become the outbound HTTP request body. */
+    storageEntryId: string;
+    namespace?: string;
+}
+type HttpStorageTargetRef =
+/** Creates a new Storage entry and writes the complete HTTP response into it. */
+(Omit<StorageUploadSessionInput, 'replaceStorageEntryId' | 'uploadMode'> & {
+    name: string;
+    namespace?: string;
+})
+/** Replaces an existing Storage entry after the complete HTTP response is received. */
+ | {
+    storageEntryId: string;
+    namespace?: string;
+    replace: true;
+    contentTypeHint?: string;
+    computeStats?: 'none' | 'sync' | 'async';
+    metadata?: LooseObject<any>;
+};
+interface HttpRequestOptionsInterface {
+    //@default: undefined
+    source?: HttpStorageSourceRef;
+    //@default: undefined
+    target?: HttpStorageTargetRef;
+    /**
+     * JSON handling is the default. `requestType: 'json'` and `responseType: 'json'` may be stated together
+     * when an integration should expose an explicit, self-documenting JSON contract.
+     */
+    //@default: 'json'
+    responseType?: 'json' | 'base64buffer' | 'document' | 'text' | 'stream';
+    //@default: 'json'
+    requestType?: 'json' | 'base64buffer' | 'form-data' | 'text' | 'stream';
+    //@default: false
+    currentCredentials?: boolean;
+}
+interface HttpRequestInterface {
+    url: string;
+    method: 'POST' | 'PUT' | 'DELETE' | 'GET' | 'PATCH' | 'OPTIONS' | 'HEAD' | 'PURGE' | 'LINK' | 'UNLINK';
+    timeout?: number;
+    headers?: LooseObject<string>;
+    params?: TemplateParameters[];
+    data?: any;
+    //@default: undefined
+    formData?: TemplateFormData[];
+}
+interface TemplateParameters {
+    key: string;
+    value: string | LooseObject<boolean | number | string>;
+}
+interface ProcessLog {
+    time: string;
+    type: string;
+    context?: string;
+    details: LooseObject<any>;
+}
+interface StorageBreadcrumb {
+    storageEntryId: string;
+    name: string;
+}
+type StorageRetentionInput = null | {
+    /** Positive duration starting when the file is finalized. */
+    ttlSeconds?: number;
+    /** Future ISO timestamp. Mutually exclusive with ttlSeconds. */
+    expiresAt?: string;
+};
+interface StorageEntry extends BaseProperties {
+    storageEntryId: string;
+    parentStorageEntryId: string | null;
+    kind: string;
+    status: string;
+    restricted: boolean;
+    restrictedByAncestor: boolean;
+    effectiveRestricted: boolean;
+    name: string;
+    storageProviderConfigId: string | null;
+    providerVersion: string | null;
+    mimeType: string | null;
+    extension: string | null;
+    size: number | null;
+    checksumMd5: string | null;
+    tier: string | null;
+    metadata: LooseObject<any>;
+    refId: string | null;
+    refType: string | null;
+    refVer: number | null;
+    lastAccessAt: Date | string | null;
+    expiresAt: Date | string | null;
+    archivedAt: Date | string | null;
+    archivedBy: string | null;
+    archiveReason: 'AGENT_DELETED' | 'MANUAL' | 'TTL_EXPIRED' | 'USER_DELETED' | null;
+    groups: string[];
+    users: string[];
+}
+interface StorageEntryView extends StorageEntry {
+    breadcrumbs: StorageBreadcrumb[];
+}
+interface StorageExploreRequest {
+    parentStorageEntryId?: string;
+    storageProviderConfigId?: string | null;
+    term?: string;
+    skip?: number;
+    take?: number;
+    includeArchived?: boolean;
+    includeDeleted?: boolean;
+    includeTotal?: boolean;
+}
+interface StorageExploreResult extends CollectionResult<StorageEntry> {
+    breadcrumbs: StorageBreadcrumb[];
+}
+interface StorageEnsureFolderPathOptions {
+    /** Provider config used only if the first path segment must be created at root. */
+    storageProviderConfigId?: string | null;
+    /** Applied to every newly created segment; existing folders are never mutated. */
+    restricted?: boolean;
+    /** Applied to every newly created segment; existing folders are never mutated. */
+    groups?: string[];
+    /** Applied to every newly created segment; existing folders are never mutated. */
+    users?: string[];
+}
+interface StorageUploadSession {
+    storageUploadSessionId: string;
+    parentStorageEntryId: string | null;
+    targetStorageEntryId: string | null;
+    replaceStorageEntryId: string | null;
+    mode: string;
+    uploadMode: 'direct' | 'chunked' | 'incremental';
+    status: string;
+    name: string;
+    mimeTypeHint: string | null;
+    sizeHint: number | null;
+    computeStats: 'none' | 'sync' | 'async' | null;
+    expiresAt: Date;
+    targetRetention?: StorageRetentionInput;
+    finalizedAt: Date | null;
+}
+interface StorageUploadSessionPart {
+    partNumber: number;
+    status: string | null;
+    size: number;
+    checksumMd5: string | null;
+    providerVersion: string | null;
+    startByte: number | null;
+    endByte: number | null;
+}
+interface StorageUploadPartResult {
+    storageUploadSessionId: string;
+    partNumber: number;
+    size: number;
+    checksumMd5: string | null;
+}
+interface StorageUploadSessionView {
+    session: StorageUploadSession;
+    partNumberRequired: boolean;
+    uploadedParts: number;
+    uploadedBytes: number;
+    nextPartNumber: number | null;
+    parts: StorageUploadSessionPart[];
+}
+interface StorageUploadTarget {
+    strategy: string;
+    uploadUrl?: string | null;
+    method: 'PUT' | 'POST';
+    headers?: LooseObject<string>;
+    providerUploadId?: string | null;
+    partNumberRequired?: boolean;
+}
+interface StorageDownload {
+    storageEntryId: string;
+    downloadUrl: string;
+    preview: boolean;
+}
+interface StorageTextReadOptions {
+    startLine?: number | null;
+    endLine?: number | null;
+    maxChars?: number | null;
+}
+interface StorageFileReadOptions {
+    batchNumber?: number;
+    buffer?: boolean;
+    start?: number;
+    end?: number;
+}
+interface StorageFileStatsOptions {
+    separator?: string;
+    reloadStats?: boolean;
+    batchSize?: number;
+}
+interface StorageFileStats {
+    lineCount?: number;
+    map?: LooseObject<number>;
+    separator?: string;
+    batches?: number;
+    batchSize?: number;
+    encoding?: string | null;
+}
+interface StorageTextContent {
+    storageEntryId: string;
+    name: string;
+    mimeType: string | null;
+    size: number | null;
+    content: string;
+    startLine: number;
+    endLine: number;
+    returnedLineCount: number;
+    totalLines: number;
+    truncated: boolean;
+}
+interface LoggedUser {
+    userId: string;
+    name: string;
+    surname: string;
+    serviceAccount: boolean;
+    ownerType: string;
+    ownerId: string;
+    mail: string;
+    phone: string;
+    groups: string[];
+    roles: string[];
+    metaData: LooseObject<any>;
+    advancedData: LooseObject<any>;
+    avatar: string;
+    platformAccess: boolean;
+}
+interface AgentToolInput {
+    /**
+     * Local tool name exposed to the assistant runtime, usually the componentToolset tool alias.
+     */
+    toolName?: string;
+    /**
+     * Component toolset key selected for this execution.
+     */
+    capabilityId?: string;
+    /**
+     * Component implementation entrypoint selected by componentToolset.tools.<tool>.entrypoint.
+     */
+    entrypoint?: string;
+    /**
+     * Model-provided arguments validated against componentToolset.tools.<tool>.inputSchema.
+     */
+    args?: LooseObject<any>;
+    /**
+     * Static runtime inputs from componentToolset.tools.<tool>.inputs.
+     */
+    inputs?: LooseObject<any>;
+    popResult?: string | null;
+    pluginId?: string | null;
+    registryPluginId?: string | null;
+    componentId?: string | null;
+    componentVersion?: number | null;
+}
+interface Input {
+    templateId: string;
+    templateInputs: LooseObject<any>;
+    /**
+     * Present when this component is executed as an agent plugin component tool.
+     */
+    agentTool?: AgentToolInput;
+    // Endpoints
+    body?: any;
+    query?: LooseObject<string>;
+    headers?: LooseObject<string>;
+    params?: string[];
+    path?: string;
+    method?: string;
+    // Events
+    type?: string;
+    message?: any;
+    // Execution context.
+    excludeLibs?: string[];
+    includeLibs?: string[];
+}
+interface InstanceDetails {
+    id: string;
+    organizationId: string;
+    name: string;
+    description: string;
+    status: string;
+    plan: string;
+    version: number;
+    versionComment: string;
+    endpoints: {
+        app: string;
+        api: string;
+        run: string;
+        auth: string;
+        sandbox: string;
+    };
+}
+interface BaseProperties {
+    createdBy: string;
+    createdAt: Date;
+    lastUpdateBy: string;
+    lastUpdateAt: Date;
+    version: number;
+    deletedBy?: string;
+    deletedAt?: Date;
+}
+interface ResourceItem extends BaseProperties {
+    itemId: string;
+    version: number;
+    [key: string]: any;
+}
+interface DatabaseDataActionResponse {
+    requested: number;
+    success: number;
+    elapsed: number;
+    data: any[];
+}
+interface TruncateDatabaseOptions {
+    /**
+     * Restart owned identity sequences after truncation.
+     * Defaults to false so generated keys remain stable and are not reused.
+     */
+    restartIdentity?: boolean;
+}
+interface CloneDatabaseAcceptedResponse {
+    accepted: true;
+    databaseId: string;
+    sourceDatabaseId: string;
+    cloneId: string;
+    name: string;
+    includeItems: boolean;
+    includePartitions: boolean;
+    audit: boolean;
+    message: string;
+}
+interface CloneDatabaseCompletedResponse {
+    accepted: false;
+    completed: true;
+    databaseId: string;
+    sourceDatabaseId: string;
+    cloneId: string;
+    name: string;
+    includeItems: boolean;
+    includePartitions: boolean;
+    audit: boolean;
+    clonedDatabaseIds: string[];
+    databases: Database[];
+    message: string;
+}
+type CloneDatabaseResponse = CloneDatabaseAcceptedResponse | CloneDatabaseCompletedResponse;
+type ExportDatabaseOptions = Omit<SelectInput, 'from'> & {
+    /**
+     * false waits for final storage persistence and returns the completed response.
+     * true starts a background export and returns the accepted response.
+     * Default is false.
+     */
+    async?: boolean;
+    /** Omit for private user storage, use ROOT, or provide an accessible explorer folder id. */
+    storageDestination?: 'ROOT' | string;
+    /** Dedicated output name. Omit for an automatic database-and-timestamp CSV name. */
+    fileName?: string;
+    /** Whether the output entry is restricted. Default is true. */
+    restricted?: boolean;
+    /** CSV delimiter. Default is a comma. */
+    delimiter?: string;
+    boolType?: 'emoji' | 'number' | 'boolean';
+    emptyNull?: boolean;
+    encodedJson?: boolean;
+    /** Omit for the destination default, null for no expiration. */
+    retention?: StorageRetentionInput;
+};
+interface ExportDatabaseAcceptedResponse {
+    accepted: true;
+    databaseId: string;
+    exportId: string;
+    storageNamespace: string;
+    parentStorageEntryId: string | null;
+    fileName: string;
+    restricted: boolean;
+    message: string;
+}
+interface ExportDatabaseCompletedResponse {
+    accepted: false;
+    completed: true;
+    databaseId: string;
+    exportId: string;
+    storageNamespace: string;
+    parentStorageEntryId: string | null;
+    fileName: string;
+    restricted: boolean;
+    storageEntryId: string;
+    storageEntry: StorageEntryView;
+    message: string;
+}
+type ExportDatabaseResponse = ExportDatabaseAcceptedResponse | ExportDatabaseCompletedResponse;
+interface Context {
+    requestId: string;
+    date: Date;
+    inputs?: any;
+    options?: LooseObject<any>;
+    isDebug?: boolean;
+    async?: boolean;
+    templateId?: string;
+    targetType?: ExecutionTargetType;
+    targetId?: string;
+}
+interface ComponentExecuteRequest {
+    /**
+     * Active executable component id to run in an isolated child execution.
+     */
+    componentId: string;
+    /**
+     * Optional exact component version. Omit to run the latest active version.
+     */
+    componentVersion?: number;
+    /**
+     * Input payload exposed to the child component through api.input().
+     */
+    inputs?: any;
+    /**
+     * Maximum child runtime in milliseconds. The runtime clamps this to the parent execution's remaining timeout budget.
+     */
+    timeoutMs?: number;
+    /**
+     * Optional child isolate memory limit in MB.
+     */
+    memory?: number;
+}
+interface ComponentExecuteResult<T = LooseObject<any>> {
+    trace: LooseObject<any>;
+    errors: ProcessLog[];
+    warnings: ProcessLog[];
+    logs: ProcessLog[];
+    results: T;
+    context?: Context;
+}
+interface InstanceDataFilter {
+    [field: string]: {
+        [type: string]: string | number | null | string[] | number[];
+    };
+}
+interface InstanceData {
+    filter?: InstanceDataFilter | InstanceDataFilter[];
+    sort?: string[];
+    fields?: string[];
+    distinct?: string;
+    skip?: number;
+    take?: number;
+    cache?: {
+        ttl?: number;
+        key?: string;
+    };
+    count?: boolean;
+    cast?: LooseObject<string>;
+    options?: {
+        id: string;
+    };
+}
+interface SFTPClient {
+    host: string;
+    port: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+}
+interface StorageFileTargetRequest extends Omit<StorageUploadSessionInput, 'replaceStorageEntryId' | 'uploadMode'> {
+    name: string;
+}
+type SFTPFileSourceRef = {
+    storageEntryId: string;
+};
+type SFTPFileTargetRef = {
+    storageEntryId: string;
+    replace?: true;
+} | {
+    storage: StorageFileTargetRequest;
+};
+interface JWTHeader {
+    alg: string | 'HS256' | 'HS384' | 'HS512' | 'RS256' | 'RS384' | 'RS512' | 'ES256' | 'ES384' | 'ES512' | 'PS256' | 'PS384' | 'PS512' | 'none';
+    typ?: string | undefined;
+    cty?: string | undefined;
+    crit?: Array<string | Exclude<keyof JWTHeader, 'crit'>> | undefined;
+    kid?: string | undefined;
+    jku?: string | undefined;
+    x5u?: string | string[] | undefined;
+    'x5t#S256'?: string | undefined;
+    x5t?: string | undefined;
+    x5c?: string | string[] | undefined;
+}
+interface Agent {
+    agentId?: string;
+    name: string;
+    status?: string;
+    desc?: string | null;
+    ownerId?: string | null;
+    ownerType?: string | null;
+    serviceAccountUserId: string;
+    rootStorageEntryId?: string | null;
+    config?: AgentConfig;
+    policy?: AgentPolicy;
+    metadata?: Record<string, any>;
+    createdBy?: string;
+    createdAt?: Date | string;
+    lastUpdateAt?: Date | string;
+    lastUpdateBy?: string;
+    deletedAt?: Date | string | null;
+    deletedBy?: string | null;
+    version?: number;
+}
+interface AgentPluginApprovalConfig {
+    mode?: 'none' | 'always' | 'conditional';
+    safetyTier?: 'read' | 'write' | 'destructive' | 'external' | 'execute';
+    requiredApprovals?: ('interactive_user' | 'change_review' | string)[];
+}
+interface AgentReleaseRolloutPolicy {
+    mode?: 'disabled' | 'shadow' | 'canary' | 'enabled';
+    canaryPercent?: number;
+    shadowSamplePercent?: number;
+    requiredEvalSuite?: string | null;
+    requiredTelemetryScorecards?: string[];
+    rollbackToSnapshotId?: string | null;
+}
+interface AgentPluginRoutingConfig {
+    title?: string;
+    summary?: string;
+    keywords?: string[];
+}
+interface AgentPluginMcpHeaderBinding {
+    name: string;
+    secretId?: string | null;
+    secretDataId?: string | null;
+    value?: string | null;
+    prefix?: string;
+}
+interface AgentPluginMcpConfig {
+    transport: 'streamable_http' | 'sse';
+    url: string;
+    authMode?: 'none' | 'bearer' | 'basic' | 'header';
+    bearerSecretId?: string | null;
+    bearerSecretDataId?: string | null;
+    basicUsername?: string | null;
+    basicPasswordSecretId?: string | null;
+    basicPasswordSecretDataId?: string | null;
+    headers?: AgentPluginMcpHeaderBinding[];
+    manifestTtlMs?: number;
+    connectTimeoutMs?: number;
+    toolNamePrefix?: string;
+}
+interface AgentPluginMcpToolConfig {
+    enabled?: boolean;
+    deferLoading?: boolean;
+    alias?: string | null;
+    approvalPolicy?: AgentPluginApprovalConfig;
+    mutationIntent?: 'read' | 'write' | 'destructive' | 'external';
+    reversibility?: 'reversible' | 'operator_reversible' | 'irreversible' | 'unknown';
+    targetScope?: 'assistant_thread' | 'agent' | 'tenant' | 'external';
+    sideEffectSummary?: string;
+    rollout?: AgentReleaseRolloutPolicy;
+}
+interface AgentPluginMcpToolset {
+    defaultConfig?: AgentPluginMcpToolConfig;
+    configs?: Record<string, AgentPluginMcpToolConfig>;
+}
+interface AgentPluginComponentToolConfig {
+    enabled?: boolean;
+    deferLoading?: boolean;
+    alias?: string | null;
+    title?: string;
+    description?: string;
+    entrypoint?: string | null;
+    inputs?: Record<string, any>;
+    popResult?: string | null;
+    inputSchema?: Record<string, any>;
+    outputSchema?: Record<string, any>;
+    approvalPolicy?: AgentPluginApprovalConfig;
+    mutationIntent?: 'read' | 'write' | 'destructive' | 'external';
+    reversibility?: 'reversible' | 'operator_reversible' | 'irreversible' | 'unknown';
+    targetScope?: 'assistant_thread' | 'agent' | 'tenant' | 'external';
+    sideEffectSummary?: string;
+    sideEffectCategories?: string[];
+    rollout?: AgentReleaseRolloutPolicy;
+}
+interface AgentPluginComponentToolset {
+    defaultConfig?: Omit<AgentPluginComponentToolConfig, 'alias' | 'title' | 'entrypoint'>;
+    tools?: Record<string, AgentPluginComponentToolConfig>;
+}
+interface AgentPluginSkillConfig {
+    format?: 'markdown';
+    content: string;
+    pluginIds?: string[];
+    maxPromptChars?: number;
+}
+interface AgentPluginPackageMetadata {
+    avatarUrl?: string | null;
+    websiteUrl?: string | null;
+    documentationUrl?: string | null;
+    termsOfServiceUrl?: string | null;
+    privacyPolicyUrl?: string | null;
+    supportUrl?: string | null;
+    publisherName?: string | null;
+    publisherUrl?: string | null;
+    license?: string | null;
+    categories?: string[];
+    tags?: string[];
+}
+interface AgentPluginPackageConfig {
+    externalId: string;
+    format?: 'markdown';
+    content: string;
+    pluginIds?: string[];
+    metadata?: AgentPluginPackageMetadata;
+    maxPromptChars?: number;
+}
+interface AgentPluginConfig {
+    contractVersion?: 1;
+    id: string;
+    kind?: 'tools' | 'mcp_server' | 'skill' | 'package';
+    name: string;
+    description?: string;
+    routing?: AgentPluginRoutingConfig;
+    executionMode?: 'sync' | 'background';
+    componentId?: string;
+    componentVersion?: number | null;
+    componentToolset?: AgentPluginComponentToolset;
+    mcpServer?: AgentPluginMcpConfig;
+    mcpToolset?: AgentPluginMcpToolset;
+    skill?: AgentPluginSkillConfig;
+    package?: AgentPluginPackageConfig;
+    providerSource?: 'tenant_plugin' | 'community_plugin';
+    version?: string;
+    inputSchema?: Record<string, any>;
+    outputSchema?: Record<string, any>;
+    approvalPolicy?: AgentPluginApprovalConfig;
+    mutationIntent?: 'read' | 'write' | 'destructive' | 'external';
+    reversibility?: 'reversible' | 'operator_reversible' | 'irreversible' | 'unknown';
+    targetScope?: 'assistant_thread' | 'agent' | 'tenant' | 'external';
+    sideEffectSummary?: string;
+    sideEffectCategories?: string[];
+    timeoutMs?: number;
+    resultMaxBytes?: number;
+    inputMode?: 'direct' | 'args_wrapper';
+    enabled?: boolean;
+    autoDiscovery?: boolean;
+}
+type AgentWorkMode = 'balanced' | 'coding' | 'business' | 'analyst' | 'operator' | 'creative';
+type AgentPersona = 'friendly' | 'pragmatic' | 'professional' | 'concise' | 'calm' | 'mentor' | 'assertive';
+interface AgentMemoryPolicy {
+    enabled?: boolean;
+    maxRecallEntries?: number;
+    maxRecallChars?: number;
+    retentionDays?: number;
+    defaultTtlDays?: number;
+    excludedContentPaths?: string[];
+    includeProvenance?: boolean;
+}
+interface AgentReleaseConfig {
+    versionLabel?: string;
+    changeSummary?: string;
+    routingRollout?: AgentReleaseRolloutPolicy;
+    workerRollout?: AgentReleaseRolloutPolicy;
+    pluginRollout?: AgentReleaseRolloutPolicy;
+}
+interface AgentAutomationApprovalRouting {
+    mode?: 'block' | 'delegate' | 'notify';
+    delegateUserIds?: string[];
+    notifyUserIds?: string[];
+}
+interface AgentAutomationNotificationPolicy {
+    dedupeWindowSeconds?: number;
+    maxAttempts?: number;
+    auditTrail?: boolean;
+}
+interface AgentAutomationPolicyConfig {
+    defaultDeliveryMode?: 'INBOX' | 'DIRECT_RUN';
+    approvalRouting?: AgentAutomationApprovalRouting;
+    notificationPolicy?: AgentAutomationNotificationPolicy;
+}
+interface AgentCheapTurnPolicy {
+    includePersona?: boolean;
+    includeSystemInstructions?: boolean;
+    includeMemory?: boolean;
+}
+interface AgentConfig {
+    model?: string;
+    reasoningEffort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
+    executionMode?: 'interactive' | 'background' | 'automation';
+    planningPolicy?: 'standard' | 'review_required';
+    workMode?: AgentWorkMode;
+    persona?: AgentPersona;
+    systemInstructions?: string;
+    memoryPolicy?: AgentMemoryPolicy;
+    release?: AgentReleaseConfig;
+    automation?: AgentAutomationPolicyConfig;
+    cheapTurn?: AgentCheapTurnPolicy;
+    toolNames?: string[];
+    pluginIds?: string[];
+    plugins?: AgentPluginConfig[];
+    maxActiveRootRuns?: number;
+    maxChildRuns?: number;
+    maxConcurrentChildRuns?: number;
+    maxTicks?: number;
+    childFailureMode?: 'fail_parent' | 'merge_partial';
+}
+interface AgentPolicy {
+    toolNames?: string[];
+    pluginIds?: string[];
+    plugins?: AgentPluginConfig[];
+    maxActiveRootRuns?: number;
+    maxChildRuns?: number;
+    maxConcurrentChildRuns?: number;
+    maxTicks?: number;
+    childFailureMode?: 'fail_parent' | 'merge_partial';
+}
+interface AgentPlugin {
+    contractVersion?: 1;
+    id: string;
+    kind?: 'tools' | 'mcp_server' | 'skill' | 'package';
+    name: string;
+    description?: string;
+    routing?: AgentPluginRoutingConfig;
+    executionMode?: 'sync' | 'background';
+    componentId?: string;
+    componentVersion?: number | null;
+    componentToolset?: AgentPluginComponentToolset;
+    mcpServer?: AgentPluginMcpConfig;
+    mcpToolset?: AgentPluginMcpToolset;
+    skill?: AgentPluginSkillConfig;
+    package?: AgentPluginPackageConfig;
+    providerSource?: 'tenant_plugin' | 'community_plugin';
+    version?: string;
+    inputSchema?: Record<string, any>;
+    outputSchema?: Record<string, any>;
+    approvalPolicy?: AgentPluginApprovalConfig;
+    mutationIntent?: 'read' | 'write' | 'destructive' | 'external';
+    reversibility?: 'reversible' | 'operator_reversible' | 'irreversible' | 'unknown';
+    targetScope?: 'assistant_thread' | 'agent' | 'tenant' | 'external';
+    sideEffectSummary?: string;
+    sideEffectCategories?: string[];
+    timeoutMs?: number;
+    resultMaxBytes?: number;
+    inputMode?: 'direct' | 'args_wrapper';
+    enabled?: boolean;
+    autoDiscovery?: boolean;
+    scope?: 'config' | 'policy';
+}
+interface AgentInboxItem {
+    agentInboxItemId?: string;
+    agentId: string;
+    status?: string;
+    type: string;
+    instruction: string;
+    payload?: Record<string, any>;
+    result?: Record<string, any> | null;
+    error?: Record<string, any> | null;
+    priority?: number;
+    availableAt?: Date | string;
+    claimedByRunId?: string | null;
+    leaseToken?: string | null;
+    leaseExpiresAt?: Date | string | null;
+    completedAt?: Date | string | null;
+    dedupeKey?: string | null;
+    createdBy?: string;
+    createdAt?: Date | string;
+    lastUpdateAt?: Date | string;
+    lastUpdateBy?: string;
+    version?: number;
+}
+interface AgentRun {
+    agentRunId?: string;
+    agentId: string;
+    rootRunId?: string | null;
+    parentRunId?: string | null;
+    status?: string;
+    waitReason?: string | null;
+    triggerType?: string | null;
+    triggerRefType?: string | null;
+    triggerRefId?: string | null;
+    ownerId?: string | null;
+    ownerType?: string | null;
+    serviceAccountUserId?: string;
+    rootAssistantThreadId?: string | null;
+    currentAssistantThreadId?: string | null;
+    lastAssistantMessageId?: string | null;
+    nextWakeAt?: Date | string | null;
+    scheduledTaskName?: string | null;
+    leaseToken?: string | null;
+    leaseExpiresAt?: Date | string | null;
+    tickSeq?: number;
+    tickCount?: number;
+    childCount?: number;
+    lastHeartbeatAt?: Date | string | null;
+    checkpointSummary?: string | null;
+    state?: Record<string, any>;
+    result?: Record<string, any> | null;
+    error?: Record<string, any> | null;
+    createdBy?: string;
+    createdAt?: Date | string;
+    lastUpdateAt?: Date | string;
+    lastUpdateBy?: string;
+    version?: number;
+}
+interface AgentRunEvent {
+    agentRunEventId?: string;
+    agentRunId: string;
+    rootRunId?: string | null;
+    agentId: string;
+    seq?: number;
+    kind?: string;
+    level?: string;
+    summary?: string;
+    payload?: Record<string, any>;
+    assistantThreadId?: string | null;
+    assistantMessageId?: string | null;
+    assistantExecutionPlanId?: string | null;
+    assistantActionRequiredId?: string | null;
+    childAgentRunId?: string | null;
+    storageEntryId?: string | null;
+    jobId?: string | null;
+    taskName?: string | null;
+    requestId?: string | null;
+    operationId?: string | null;
+    traceId?: string | null;
+    spanId?: string | null;
+    createdBy?: string;
+    createdAt?: Date | string;
+}
+interface AgentRunThread {
+    agentRunThreadId?: string;
+    agentRunId: string;
+    agentId: string;
+    assistantThreadId: string;
+    kind?: string;
+    purpose?: string | null;
+    parentAssistantThreadId?: string | null;
+    sourceAssistantMessageId?: string | null;
+    sourceAgentRunId?: string | null;
+    active?: boolean;
+    meta?: Record<string, any>;
+    createdBy?: string;
+    createdAt?: Date | string;
+    lastUpdateAt?: Date | string;
+    lastUpdateBy?: string;
+    version?: number;
+}
+interface CollectionResult<T = any> {
+    data: T[];
+    results: number;
+    next: boolean;
+    total?: number;
+    cache?: any;
+}
+interface AssistantExecutionPlanStep {
+    id?: string;
+    title: string;
+    description: string;
+    kind: string;
+    executor?: 'primary' | 'delegated_candidate' | string;
+    parallelGroup?: string | null;
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked' | 'failed' | 'skipped' | string;
+    userVisible?: boolean;
+    approvalHint?: 'none' | 'maybe' | 'required' | string;
+}
+interface AssistantExecutionPlan {
+    summary: string;
+    executionStrategy: 'serial' | 'parallel_candidates' | string;
+    steps: AssistantExecutionPlanStep[];
+}
+interface AssistantPlanningTransition {
+    currentMode: string;
+    requiresLaterTurn: boolean;
+    allowedNextModes: string[];
+    statusLabel: string;
+    handoffSummary: string;
+}
+interface AssistantWorkerProgress {
+    stepId: string;
+    stepTitle: string;
+    childExecutorType?: 'explore' | 'general' | string | null;
+    status: 'running' | 'blocked' | 'completed' | 'failed' | string;
+    statusLabel: string;
+    waitReason?: 'approval' | 'dependency' | 'unknown' | string | null;
+    currentToolName?: string | null;
+    currentToolTitle?: string | null;
+    childAgentRunId?: string | null;
+    startedAt?: Date | string | null;
+    updatedAt?: Date | string | null;
+    summary?: string | null;
+    artifactCount?: number | null;
+}
+interface AssistantPublicExecutionPlan {
+    assistantExecutionPlanId: string;
+    plan: AssistantExecutionPlan;
+    status: 'in_progress' | 'blocked' | 'completed' | 'failed' | 'cancelled' | string;
+    workerProgress?: AssistantWorkerProgress[] | null;
+}
+interface AssistantActionRequired {
+    assistantActionRequiredId: string;
+    actionExecutionId?: string | null;
+    assistantThreadId: string;
+    assistantMessageId: string;
+    kind: 'approval' | 'clarification' | 'plan' | string;
+    status?: string;
+    title: string;
+    summary: string;
+    payload: Record<string, any> | null;
+    expiresAt: Date | string | null;
+    toolName: string | null;
+    toolExecutionId?: string | null;
+    body?: {
+        prompt: string;
+        description: string | null;
+        inputType: string | null;
+        choices: any[] | null;
+        allowCustomResponse: boolean;
+        customResponseLabel: string | null;
+        customResponsePlaceholder: string | null;
+        selected: {
+            decision: string;
+            responseText: string | null;
+            responsePayload: Record<string, any> | null;
+            runtimeOptions?: Record<string, any> | null;
+        } | null;
+        arguments: Record<string, any> | null;
+        approval: Record<string, any> | null;
+        planningTransition?: AssistantPlanningTransition | null;
+    };
+    planningTransition?: AssistantPlanningTransition | null;
+}
+interface AssistantThread {
+    assistantThreadId: string;
+    title: string;
+    status: string;
+    model?: string;
+    reasoning?: string | null;
+    executionMode?: 'interactive' | 'background' | 'automation' | string;
+    planningPolicy?: 'standard' | 'review_required' | string;
+    visibleContextTokens?: number;
+    visibleInputTokens?: number;
+    visibleOutputTokens?: number;
+    visibleCachedInputTokens?: number;
+    visibleReasoningTokens?: number;
+    totalContextTokens?: number;
+    totalBilledTokens?: number;
+    forkedFromAssistantMessageId?: string | null;
+    forkedFromAssistantThreadId?: string | null;
+    contextWindowTokensUsed?: number;
+    contextWindowMaxTokens?: number;
+    contextWindowPercent?: number;
+    actionRequired?: AssistantActionRequired | null;
+    executionPlan?: AssistantPublicExecutionPlan | null;
+    workerProgress?: AssistantWorkerProgress[] | null;
+    goal?: AssistantThreadGoal | null;
+    share?: AssistantThreadShare | null;
+    createdBy?: string;
+    createdAt?: Date | string;
+    lastUpdateBy?: string;
+    lastUpdateAt?: Date | string;
+    deletedBy?: string | null;
+    deletedAt?: Date | string | null;
+    version?: number;
+}
+interface AssistantThreadGoal {
+    version: 1;
+    assistantThreadId: string;
+    revision: number;
+    status: 'active' | 'paused' | 'completed' | 'blocked' | 'cleared';
+    objective: string | null;
+    source: 'user' | 'api' | 'message' | 'system';
+    createdAt: string;
+    updatedAt: string;
+    updatedBy: string | null;
+    validation: {
+        status: 'satisfied' | 'unsatisfied' | 'partial' | 'skipped';
+        reviewedAt: string;
+        rationale: string | null;
+        evidenceRefs?: string[];
+    } | null;
+}
+interface AssistantMessage {
+    assistantMessageId: string;
+    assistantThreadId: string;
+    role: 'user' | 'assistant' | string;
+    kind: string;
+    message: string;
+    contentTokens?: number;
+    totalTokens?: number;
+    createdBy?: string;
+    createdAt?: Date | string;
+}
+interface AssistantThreadState {
+    thread: AssistantThread;
+    actionRequired: AssistantActionRequired | null;
+    executionPlan: AssistantPublicExecutionPlan | null;
+    workerProgress?: AssistantWorkerProgress[] | null;
+    goal?: AssistantThreadGoal | null;
+}
+interface AssistantThreadShare {
+    shareId: string;
+    assistantThreadId: string;
+    enabled: boolean;
+    createdBy?: string;
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+    revokedAt?: Date | string | null;
+    revokedBy?: string | null;
+}
+interface AssistantSharedThreadResponse {
+    share: AssistantThreadShare;
+    thread: AssistantThread;
+    permissions: {
+        readOnly: boolean;
+        canFork: boolean;
+        canContinue: boolean;
+        canManageShare: boolean;
+    };
+}
+interface AssistantThreadResponse {
+    thread: AssistantThread;
+    message?: AssistantMessage | null;
+    assistantMessage?: AssistantMessage | null;
+    noticeMessages?: AssistantMessage[];
+    actionRequired?: AssistantActionRequired | null;
+    assistantExecutionPlanId?: string | null;
+    executionPlan?: AssistantExecutionPlan | null;
+    workerProgress?: AssistantWorkerProgress[] | null;
+}
+interface AssistantThreadCompactionRequest {
+    version?: 'v1' | 'v2';
+    keepContext?: boolean;
+    content?: string;
+}
+interface RevoApi {
+    createDatabase(data: DatabaseCreateInput): Promise<Database>;
+    cloneDatabase<TAsync extends boolean = false>(databaseIdOrName: string, options?: DatabaseCloneInput & {
+        async?: TAsync;
+    }): Promise<TAsync extends true ? CloneDatabaseAcceptedResponse : TAsync extends false ? CloneDatabaseCompletedResponse : CloneDatabaseResponse>;
+    exportDatabase<TAsync extends boolean = false>(databaseIdOrName: string, options?: ExportDatabaseOptions & {
+        async?: TAsync;
+    }): Promise<TAsync extends true ? ExportDatabaseAcceptedResponse : TAsync extends false ? ExportDatabaseCompletedResponse : ExportDatabaseResponse>;
+    exportDatabaseView<TAsync extends boolean = false>(databaseViewIdOrName: string, options?: ExportDatabaseOptions & {
+        async?: TAsync;
+    }): Promise<TAsync extends true ? ExportDatabaseAcceptedResponse : TAsync extends false ? ExportDatabaseCompletedResponse : ExportDatabaseResponse>;
+    updateDatabase(databaseId: string, data: DatabaseUpdateInput): Promise<Database>;
+    deleteDatabase(databaseId: string): Promise<void>;
+    restoreDatabase(databaseId: string): Promise<void>;
+    truncateDatabase(databaseId: string, options?: TruncateDatabaseOptions): Promise<void>;
+    getDatabaseData<T = any>(name: string, request?: SelectInput): Promise<GetDatabaseDataResponse<T>>;
+    getDatabaseViewData<T = any>(name: string, request?: SelectInput): Promise<GetDatabaseDataResponse<T>>;
+    getDatabaseAudit(name: string, query?: DatabaseAuditQuery): Promise<DatabaseAuditResponse>;
+    insertDatabaseData(name: string, data: LooseObject<any>[]): Promise<DatabaseDataActionResponse>;
+    upsertDatabaseData(name: string, data: LooseObject<any>[]): Promise<DatabaseDataActionResponse>;
+    updateDatabaseData(name: string, oldObject: LooseObject<any>, newObject: LooseObject<any>): Promise<ResourceItem>;
+    deleteDatabaseData(name: string, data: ResourceItem[]): Promise<any>;
+    updateDatabaseDataRequest(name: string, request: DatabaseMutationRequest, payload: Record<string, any>, options?: {
+        return?: boolean;
+        onlyKeys?: boolean;
+    }): Promise<{
+        success: number;
+        elapsed: number;
+        data?: any;
+    }>;
+    deleteDatabaseDataRequest(name: string, request: DatabaseMutationRequest, options?: {
+        return?: boolean;
+        onlyKeys?: boolean;
+    }): Promise<{
+        success: number;
+        elapsed: number;
+        data?: any;
+    }>;
+    queryDatabase(query: string, params?: any[]): Promise<any>;
+    currentUser(): LoggedUser;
+    isDebug(): boolean;
+    disableDebug(): void;
+    enableDebug(): void;
+    getCache(key: string): any;
+    setCache(key: string, value: any): void;
+    getContext(): Context;
+    getErrors(): ProcessLog[];
+    getWarnings(): ProcessLog[];
+    getExecutionId(): string;
+    getLogs(): LooseObject<any>[];
+    getOperationId(): string;
+    executeComponent<T = LooseObject<any>>(request: ComponentExecuteRequest): Promise<ComponentExecuteResult<T>>;
+    input(name?: string): Input;
+    log(log: string | LogInterface, type?: 'ERROR' | 'WARN' | 'INFO' | 'DEBUG', duration?: number, time?: string): void;
+    exit(): void;
+    throw(code: number, body?: any): void;
+    getCurrentInstance(): string;
+    getInstanceData(dataSource: 'Users' | 'Groups' | 'RoleGroups' | 'Keys' | 'Secrets' | 'SecretsData' | 'Templates' | 'Events' | 'Schedule' | 'Jobs' | 'Webhooks' | 'Components' | 'Logs' | 'Files' | 'EventsHistory' | 'Endpoints' | 'Databases' | 'DatabaseData', request?: InstanceData): Promise<any>;
+    getInstanceDetails(): InstanceDetails;
+    getSecret(name: string): Promise<string>;
+    getSecrets(name: string[]): Promise<{
+        [key: string]: string;
+    }>;
+    publishMessage(channel: string, message: any): Promise<void>;
+    getInstanceCache(key: string): Promise<any>;
+    setInstanceCache(key: string, value: any, seconds?: number): Promise<void>;
+    setInstanceCacheIfNotExists(key: string, value: any, seconds?: number): Promise<boolean>;
+    getOrSetInstanceCache(key: string, value: any, seconds?: number): Promise<any>;
+    removeInstanceCache(key: string, wildcard?: boolean): Promise<void>;
+    existsInstanceCache(key: string): Promise<boolean>;
+    persistInstanceCache(key: string): Promise<void>;
+    expireInstanceCache(key: string, ttl: number): Promise<void>;
+    getExpireInstanceCache(key: string): Promise<number | null>;
+    listInstanceCache(key: string): Promise<string[]>;
+    incrementInstanceCache(key: string, by?: number, seconds?: number): Promise<number>;
+    decrementInstanceCache(key: string, by?: number, seconds?: number): Promise<number>;
+    compareAndSetInstanceCache(key: string, expected: any, value: any, seconds?: number): Promise<boolean>;
+    acquireIdempotencyKey(key: string, ttl: number, value?: any): Promise<boolean>;
+    getIdempotencyKey(key: string): Promise<any>;
+    releaseIdempotencyKey(key: string): Promise<void>;
+    concurrencyLimit(key: string, limit: number, ttl: number): Promise<boolean>;
+    rateLimit(key: string, limit: number, ttl: number): Promise<boolean>;
+    releaseRateLimit(key: string): Promise<void>;
+    releaseConcurrencyLimit(key: string): Promise<void>;
+    triggerEvent(name: string, message: any, scheduleDate?: Date): Promise<string>;
+    triggerTarget(targetType: ExecutionTargetType, targetId: string, input?: any, scheduleDate?: Date): Promise<string>;
+    triggerJob(templateId: string, input?: any, scheduleDate?: Date): Promise<string>;
+    triggerWebhook(webhook: WebhookInput, scheduleDate?: Date): Promise<Webhook>;
+    httpCall(config: HttpRequestInterface, options?: HttpRequestOptionsInterface & {
+        timeout?: number;
+        proxy?: boolean;
+    }): Promise<{
+        status: number;
+        statusText: string;
+        time: number;
+        headers: LooseObject<string>;
+        data: any;
+        storage?: {
+            session: StorageUploadSession;
+            entry: StorageEntryView;
+        };
+        request: {
+            config: HttpRequestInterface & {
+                timeout?: number;
+            };
+            options: HttpRequestOptionsInterface & {
+                timeout?: number;
+                proxy?: boolean;
+            };
+        };
+    }>;
+    sftpExec(commands: any[], config: SFTPClient): Promise<any>;
+    sftpPut(source: SFTPFileSourceRef, path: string, config: SFTPClient): Promise<void>;
+    sftpGet(target: SFTPFileTargetRef, path: string, config: SFTPClient): Promise<void | {
+        session: StorageUploadSession;
+        entry: StorageEntryView;
+    }>;
+}
+interface RevoStorage {
+    explore(query?: StorageExploreRequest): Promise<StorageExploreResult>;
+    resolveFolderPath(path: string): Promise<StorageEntryView>;
+    ensureFolderPath(path: string, options?: StorageEnsureFolderPathOptions): Promise<StorageEntryView>;
+    getFile(storageEntryId: string, includeDeleted?: boolean): Promise<StorageEntryView>;
+    getFileData(storageEntryId: string, options?: StorageFileReadOptions): Promise<any>;
+    getFileStats(storageEntryId: string, options?: StorageFileStatsOptions): Promise<StorageFileStats>;
+    getEntry(storageEntryId: string, includeDeleted?: boolean): Promise<StorageEntryView>;
+    createFolder(data: StorageFolderInput): Promise<StorageEntryView>;
+    putObject(data: StoragePutObjectInput): Promise<StorageEntryView>;
+    createUploadSession(data: StorageUploadSessionInput): Promise<{
+        session: StorageUploadSession;
+        upload: StorageUploadTarget;
+    }>;
+    extendUploadSession(storageUploadSessionId: string): Promise<StorageUploadSession>;
+    getUploadSession(storageUploadSessionId: string): Promise<StorageUploadSessionView>;
+    uploadPart(storageUploadSessionId: string, partNumber: number | StorageUploadPartInput, data?: StorageUploadPartInput): Promise<StorageUploadPartResult>;
+    finalizeUploadSession(storageUploadSessionId: string, data?: StorageUploadSessionFinalizeInput): Promise<{
+        session: StorageUploadSession;
+        entry: StorageEntryView;
+    }>;
+    abortUploadSession(storageUploadSessionId: string): Promise<StorageUploadSession>;
+    updateEntry(storageEntryId: string, data: StorageEntryUpdateInput): Promise<StorageEntryView>;
+    moveEntry(storageEntryId: string, data: StorageEntryMoveInput): Promise<StorageEntryView>;
+    archiveEntry(storageEntryId: string, data: StorageVersionInput): Promise<StorageEntryView>;
+    restoreEntry(storageEntryId: string, data: StorageRestoreInput): Promise<StorageEntryView>;
+    deleteEntry(storageEntryId: string, data: StorageVersionInput): Promise<StorageEntryView>;
+    getDownload(storageEntryId: string, preview?: boolean): Promise<StorageDownload>;
+    getText(storageEntryId: string, options?: StorageTextReadOptions): Promise<StorageTextContent>;
+}
+interface RevoAgents {
+    list(): Promise<Agent[]>;
+    get(agentId: string): Promise<Agent>;
+    create(data: AgentCreateInput): Promise<Agent>;
+    update(agentId: string, data: AgentUpdateInput): Promise<Agent>;
+    listInbox(agentId: string): Promise<AgentInboxItem[]>;
+    getInboxItem(agentId: string, agentInboxItemId: string): Promise<AgentInboxItem>;
+    pushInbox(agentId: string, data: AgentInboxItemCreateInput): Promise<AgentInboxItem>;
+    updateInboxItem(agentId: string, agentInboxItemId: string, data: AgentInboxItemUpdateInput): Promise<AgentInboxItem>;
+    removeInboxItem(agentId: string, agentInboxItemId: string): Promise<AgentInboxItem>;
+    listPlugins(agentId: string): Promise<AgentPlugin[]>;
+    getPlugin(agentId: string, toolId: string): Promise<AgentPlugin>;
+    listRuns(agentId: string): Promise<AgentRun[]>;
+    getRun(agentRunId: string): Promise<AgentRun>;
+    listRunEvents(agentRunId: string): Promise<AgentRunEvent[]>;
+    listRunThreads(agentRunId: string): Promise<AgentRunThread[]>;
+    startRun(agentId: string, data: AgentRunInput): Promise<AgentRun>;
+    resumeRun(agentRunId: string): Promise<AgentRun>;
+    retryRun(agentRunId: string): Promise<AgentRun>;
+    tickRun(agentRunId: string): Promise<AgentRun>;
+    cancelRun(agentRunId: string, data?: AgentRunCancelInput): Promise<AgentRun>;
+    reconcileRuns(): Promise<any>;
+    listThreads(query?: Record<string, any>): Promise<CollectionResult<AssistantThread>>;
+    getThread(assistantThreadId: string, options?: {
+        hideDeleted?: boolean;
+    }): Promise<AssistantThread>;
+    getThreadState(assistantThreadId: string): Promise<AssistantThreadState>;
+    getThreadGoal(assistantThreadId: string): Promise<AssistantThreadGoal | null>;
+    setThreadGoal(assistantThreadId: string, data: AssistantThreadGoalInput): Promise<AssistantThreadGoal>;
+    pauseThreadGoal(assistantThreadId: string): Promise<AssistantThreadGoal>;
+    resumeThreadGoal(assistantThreadId: string): Promise<AssistantThreadGoal>;
+    clearThreadGoal(assistantThreadId: string): Promise<AssistantThreadGoal>;
+    getThreadShare(assistantThreadId: string): Promise<AssistantThreadShare | null>;
+    enableThreadShare(assistantThreadId: string): Promise<AssistantThreadShare>;
+    disableThreadShare(assistantThreadId: string): Promise<AssistantThreadShare>;
+    getSharedThread(shareId: string): Promise<AssistantSharedThreadResponse>;
+    listSharedThreadMessages(shareId: string, query?: Record<string, any>): Promise<CollectionResult<AssistantMessage>>;
+    getSharedThreadMessageExecutionDetails(shareId: string, assistantMessageId: string): Promise<Record<string, any>>;
+    getSharedThreadMessageArtifact(shareId: string, assistantMessageId: string, artifactId: string): Promise<Record<string, any>>;
+    forkSharedThreadMessage(shareId: string, assistantMessageId: string, data?: AssistantForkMessageInput): Promise<AssistantThreadResponse>;
+    createThread(data: AssistantMessageInput): Promise<AssistantThreadResponse>;
+    deleteThread(assistantThreadId: string): Promise<void>;
+    restoreThread(assistantThreadId: string): Promise<void>;
+    listThreadMessages(assistantThreadId: string, query?: Record<string, any>): Promise<CollectionResult<AssistantMessage>>;
+    sendMessage(assistantThreadId: string, data: AssistantMessageInput): Promise<AssistantThreadResponse>;
+    retryMessage(assistantThreadId: string, assistantMessageId: string): Promise<AssistantThreadResponse>;
+    cancelThread(assistantThreadId: string, expectedVersion: number): Promise<void>;
+    forkMessage(assistantThreadId: string, assistantMessageId: string, data?: AssistantForkMessageInput): Promise<AssistantThreadResponse>;
+    renameThread(assistantThreadId: string, data: AssistantThreadTitleInput): Promise<AssistantThread>;
+    resolveAction(assistantThreadId: string, assistantActionRequiredId: string, data: AssistantActionResolutionInput): Promise<AssistantThreadResponse>;
+    approveAction(assistantThreadId: string, assistantActionRequiredId: string, options?: Omit<AssistantActionResolutionInput, 'decision'>): Promise<AssistantThreadResponse>;
+    rejectAction(assistantThreadId: string, assistantActionRequiredId: string, options?: Omit<AssistantActionResolutionInput, 'decision'>): Promise<AssistantThreadResponse>;
+    submitAction(assistantThreadId: string, assistantActionRequiredId: string, options?: Omit<AssistantActionResolutionInput, 'decision'>): Promise<AssistantThreadResponse>;
+    compactThread(assistantThreadId: string, options?: AssistantThreadCompactionRequest): Promise<AssistantThread>;
+}
+interface RevoUtils {
+    sleep(ms: number): Promise<void>;
+    aesDecrypt(encrypted: string, passphrase: string): string;
+    aesEncrypt(payload: string, passphrase: string): string;
+    compareHash(password: string | undefined, hash: string | undefined): Promise<boolean>;
+    isBase64(input: any): boolean;
+    decodeBase64(base64String: string): string;
+    encodeBase64(plainString: string): string;
+    generateHash(password: string | undefined, rounds?: number): Promise<string>;
+    isUUID(input: any): boolean;
+    randomUUID(): string;
+    getUUID(...args: [
+    ] | [
+        value: string,
+        namespace: string
+    ]): string;
+    hashObject(object: any): string;
+    sha1(payload: string): string;
+    sha256(payload: string): string;
+    md5(payload: string): string;
+    timingSafeEqual(a: string | Buffer, b: string | Buffer): boolean;
+    hmac(payload: Uint8Array | string, secret: string, algorithm?: 'sha1' | 'sha256' | 'sha512', encoding?: 'hex' | 'base64'): string;
+    verifyHmacSignature(payload: Uint8Array | string, signature: string, secret: string, algorithm?: 'sha1' | 'sha256' | 'sha512', encoding?: 'hex' | 'base64'): boolean;
+    base64UrlEncode(input: Uint8Array | string): string;
+    base64UrlDecode(input: string): Uint8Array;
+    randomBytes(size?: number, encoding?: 'hex' | 'base64'): string;
+    randomInt(min?: number, max?: number): number;
+    randomString(length?: number, alphabet?: string): string;
+    otp(length?: number): string;
+    validate(payload: any, schema: ValidatorSchemaInput): ValidationResult<any>;
+    jwtDecode(token: string, options?: {
+        complete?: boolean;
+        json?: boolean;
+    }): any;
+    jwtSign(payload: string | object, secret: string | {
+        key: string;
+        passphrase: string;
+    }, options?: {
+        algorithm?: 'HS256' | 'HS384' | 'HS512' | 'RS256' | 'RS384' | 'RS512' | 'ES256' | 'ES384' | 'ES512' | 'PS256' | 'PS384' | 'PS512' | 'none';
+        keyid?: string;
+        expiresIn?: string | number;
+        notBefore?: string | number;
+        audience?: string | string[];
+        subject?: string;
+        issuer?: string;
+        jwtid?: string;
+        mutatePayload?: boolean;
+        noTimestamp?: boolean;
+        header?: JWTHeader;
+        encoding?: string;
+        allowInsecureKeySizes?: boolean;
+        allowInvalidAsymmetricKeyTypes?: boolean;
+    }): string;
+    jwtVerify(token: string, secret: string | {
+        key: string;
+        passphrase: string;
+    }, options?: {
+        algorithms?: ('HS256' | 'HS384' | 'HS512' | 'RS256' | 'RS384' | 'RS512' | 'ES256' | 'ES384' | 'ES512' | 'PS256' | 'PS384' | 'PS512' | 'none')[];
+        audience?: string | RegExp | Array<string | RegExp>;
+        clockTimestamp?: number;
+        clockTolerance?: number;
+        complete?: boolean;
+        issuer?: string | string[];
+        ignoreExpiration?: boolean;
+        ignoreNotBefore?: boolean;
+        jwtid?: string;
+        nonce?: string;
+        subject?: string;
+        maxAge?: string | number;
+        allowInvalidAsymmetricKeyTypes?: boolean;
+    }): any;
+    rsaDecrypt(privateKey: string, payload: string, passphrase?: string): string;
+    rsaEncrypt(publicKey: string, payload: string): string;
+    rsaGeneratePair(config?: {
+        modulusLength?: number;
+        passphrase?: string;
+    }): {
+        publicKey: string;
+        privateKey: string;
+    };
+    rsaSign(privateKey: string, payload: string, passphrase?: string): string;
+    rsaVerify(publicKey: string, payload: string, signature: string): boolean;
+}
+
+type StandaloneProfileMethod = 'currentUser' | 'getCurrentInstance' | 'getInstanceDetails';
+type AsyncMethod<Method> = Method extends (...args: infer Args) => infer Result ? (...args: Args) => Promise<Awaited<Result>> : never;
+/**
+ * Standalone API surface. Profile methods perform lazy `/api/v1/me` discovery;
+ * hosted execution context methods keep the synchronous `RevoApi` contract.
+ */
+type RevoStandaloneApi = Omit<RevoApi, StandaloneProfileMethod> & {
+    [Method in StandaloneProfileMethod]: AsyncMethod<RevoApi[Method]>;
+};
+type BatchFailureMode = 'independent' | 'stop';
+interface RevoBatchOptions {
+    failureMode?: BatchFailureMode;
+    maxCalls?: number;
+    maxRequestBytes?: number;
+    maxInFlight?: number;
+    maxQueuedCalls?: number;
+}
+interface RevoClientOptions {
+    baseUrl?: string;
+    apiKey?: string;
+    fetch?: typeof fetch;
+    requestTimeoutMs?: number;
+    batch?: RevoBatchOptions;
+}
+interface RevoBatchLimits {
+    maxCalls: number;
+    maxRequestBytes: number;
+    maxResponseBytes?: number;
+    maxInFlight?: number;
+    maxQueuedCalls?: number;
+}
+interface SerializedRevoError {
+    code: string;
+    message: string;
+    statusCode?: number;
+    retryable?: boolean;
+    indeterminate?: boolean;
+    causeCallId?: string;
+    details?: unknown;
+}
+interface RuntimeCall {
+    callId: string;
+    surface: RuntimeSurfaceName;
+    method: string;
+    args: unknown[];
+    argsMeta?: unknown;
+}
+interface RuntimeBatchRequest {
+    protocolVersion: 1;
+    clientVersion: string;
+    contractRevision: string;
+    batchId: string;
+    failureMode: BatchFailureMode;
+    debug?: boolean;
+    calls: RuntimeCall[];
+}
+type RuntimeCallResult = {
+    callId: string;
+    status: 'fulfilled';
+    value: unknown;
+    valueMeta?: unknown;
+} | {
+    callId: string;
+    status: 'rejected';
+    error: SerializedRevoError;
+} | {
+    callId: string;
+    status: 'skipped';
+    error: SerializedRevoError;
+};
+interface RuntimeBatchResponse {
+    protocolVersion: 1;
+    contractRevision: string;
+    limits?: RevoBatchLimits;
+    results: RuntimeCallResult[];
+}
+interface RevoBatchController {
+    configure(options: RevoBatchOptions): void;
+}
+interface RevoRuntime {
+    readonly api: RevoApi;
+    readonly utils: RevoUtils;
+    readonly storage: RevoStorage;
+    readonly agents: RevoAgents;
+    readonly batch: RevoBatchController;
+}
+interface HostedRuntimeBootstrap {
+    bridgePort: node_worker_threads.MessagePort;
+    instanceId?: string;
+    currentUser?: unknown;
+    instanceDetails?: unknown;
+    input?: unknown;
+    context?: unknown;
+    debug?: boolean;
+    executionId?: string;
+    operationId?: string;
+    componentId?: string;
+    componentVersion?: number;
+    deadlineMs?: number;
+    legacyApi?: Readonly<Record<string, unknown>>;
+    batch?: RevoBatchOptions;
+}
+interface RevoRuntimeBridgeRequest {
+    type: 'revo-runtime-call';
+    requestId: string;
+    request: RuntimeBatchRequest;
+}
+interface RevoRuntimeBridgeTransportError {
+    code: string;
+    message: string;
+    retryable?: boolean;
+    indeterminate?: boolean;
+}
+interface RevoRuntimeBridgeResponse {
+    type: 'revo-runtime-response';
+    requestId: string;
+    status?: number;
+    body?: unknown;
+    transportError?: RevoRuntimeBridgeTransportError;
+}
+
+declare class RevoError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    readonly retryable: boolean;
+    readonly indeterminate: boolean;
+    readonly details?: unknown;
+    constructor(message: string, options?: {
+        code?: string;
+        statusCode?: number;
+        retryable?: boolean;
+        indeterminate?: boolean;
+        details?: unknown;
+        cause?: unknown;
+    });
+}
+declare class RevoConfigurationError extends RevoError {
+    constructor(message: string);
+}
+declare class RevoAuthenticationError extends RevoError {
+    constructor(message: string, statusCode?: number, details?: unknown);
+}
+declare class RevoPermissionDeniedError extends RevoError {
+    constructor(message: string, details?: unknown);
+}
+declare class RevoRuntimeContextUnavailableError extends RevoError {
+    constructor(method: string);
+}
+declare class RevoBatchConfigurationError extends RevoError {
+    constructor(message: string);
+}
+declare class RevoBatchLimitError extends RevoError {
+    constructor(message: string, details?: unknown);
+}
+declare class RevoProtocolError extends RevoError {
+    constructor(message: string, details?: unknown);
+}
+declare class RevoTransportError extends RevoError {
+    constructor(message: string, options?: {
+        statusCode?: number;
+        retryable?: boolean;
+        indeterminate?: boolean;
+        details?: unknown;
+        cause?: unknown;
+    });
+}
+declare class RevoRemoteError extends RevoError {
+    readonly causeCallId?: string;
+    constructor(error: SerializedRevoError);
+}
+declare class RevoExecutionExit extends RevoError {
+    constructor();
+}
+declare class RevoHttpResponseError extends RevoError {
+    readonly body: unknown;
+    constructor(statusCode: number, body?: unknown);
+}
+
+export { type RuntimeCall as A, type BatchFailureMode as B, CONTRACT_REVISION as C, type RuntimeCallResult as D, type SerializedRevoError as E, type HostedRuntimeBootstrap as H, PROTOCOL_VERSION as P, type RevoRuntime as R, SDK_VERSION as S, RevoExecutionExit as a, RevoHttpResponseError as b, type RevoRuntimeBridgeRequest as c, type RevoRuntimeBridgeResponse as d, type RevoRuntimeBridgeTransportError as e, type RevoStandaloneApi as f, type RevoUtils as g, type RevoStorage as h, type RevoAgents as i, type RevoBatchController as j, type RevoClientOptions as k, type RevoApi as l, RevoAuthenticationError as m, RevoBatchConfigurationError as n, RevoBatchLimitError as o, type RevoBatchLimits as p, type RevoBatchOptions as q, RevoConfigurationError as r, RevoError as s, RevoPermissionDeniedError as t, RevoProtocolError as u, RevoRemoteError as v, RevoRuntimeContextUnavailableError as w, RevoTransportError as x, type RuntimeBatchRequest as y, type RuntimeBatchResponse as z };