@revoengine/sdk 1.6.6 → 1.6.8

package/README.md

@@ -8,13 +8,19 @@ Requirements: Node.js 22 or newer.
 
 Development and GitLab CI use Node.js 24.21.0. Run `nvm use` to select the checked-in `.nvmrc`.
 
-## SDK 1.6.6 compatibility
+## SDK 1.6.8 compatibility
 
 This release synchronizes the complete public SDK contract with the current
 platform low-code declarations. Remote calls require a platform runtime that admits
 the bundled contract revision; publishing the SDK alone does not deploy that runtime.
 Use the SDK version supported by the target platform deployment until its contract is upgraded.
 
+Storage declarations include physical-line reads, quote-disabled CSV dialects,
+per-record byte limits, and the opt-in `onError: 'skipRow'` read policy. That policy
+skips records with the wrong source column count and returns bounded locations in
+`csvReport`; syntax and record-size errors still abort. The report describes the
+whole source and must not be summed across pages.
+
 HTTP Storage requests/responses now use `requestType: 'storage'` and
 `responseType: 'storage'`, with flat Storage-only `source` / `target` objects.
 Legacy HTTP Files references and the old Storage `stream` mode are rejected.
@@ -30,7 +36,7 @@ Legacy SFTP helpers and the removed thread-goal methods are not exposed by the
 current SDK contract. Refer to the [transfer guide](https://docs.revoengine.com/low-code/sftp)
 for Secret formats and file-transfer examples.
 
-SDK 1.6.6 retains portable Component digest declarations and one readable-relation
+This release retains portable Component digest declarations and one readable-relation
 contract for Databases, live Views, and Materialized Views. Use `api.exportDatabase()`
 for all three relation types. `api.getDatabaseViewData()` remains a deprecated
 read alias; `api.exportDatabaseView()` and separate REST View export operations
@@ -50,6 +56,14 @@ Remote MCP server configurations in this contract use public HTTPS destinations.
 Private-network access is not an accepted SDK setting; review the server URL,
 provider consent, Vault binding, and tool permissions before enabling a plugin.
 
+SDK 1.6.8 adds `agents.createResponse()` and the saved Assistant conversation
+contract: `instructions`, `contextMode` and text or validated JSON `responseFormat`.
+The typed answer is in `output.text` or `output.json`; retain the returned thread
+for an ordinary `agents.sendMessage()` continuation. Provider refusal, incomplete
+output and invalid JSON do not become a successful parsed answer.
+Native Assistant SSE handles and `watchMessage()` remain local to managed V8
+Components and are excluded from the remote SDK contract.
+
 ## Choose your runtime
 
 | Environment | How to start | Authentication |
@@ -81,7 +95,7 @@ RevoEngine pins that version again in the deployment package and injects the
 runtime into the component entrypoint. Component code does not construct a
 `RevoClient`.
 
-The platform chooses the hosted package version; publishing SDK 1.6.6 does not
+The platform chooses the hosted package version; publishing a new SDK does not
 upgrade existing hosted deployments or their generated package pins.
 
 Hosted user code receives neither a tenant API key nor the private runtime

package/dist/{errors-wZ8wrU3c.d.cts → errors-DAkcmPyN.d.cts}

@@ -1,9 +1,9 @@
 import * as node_worker_threads from 'node:worker_threads';
 import { Buffer as Buffer$1 } from 'node:buffer';
 
-declare const SDK_VERSION: "1.6.6";
+declare const SDK_VERSION: "1.6.8";
 declare const PROTOCOL_VERSION: 1;
-declare const CONTRACT_REVISION: "d2b7e94d335d87dd070d2a97a043704b61b8c8d5c28435c20aceeda9581b70e4";
+declare const CONTRACT_REVISION: "cda216e308d857954aa46b31185a8b653015dd1e3d84996bdf3a93745e72bd43";
 type RuntimeSurfaceName = 'api' | 'storage' | 'transport' | 'vault' | 'serviceAccount' | 'agents' | 'lowCode';
 
 // AUTO-GENERATED FILE. DO NOT EDIT DIRECTLY.
@@ -44,7 +44,7 @@ interface SwaggerAgentCheapTurnPolicyDto {
 }
 interface SwaggerAgentConfigDto {
     /** Supported assistant model used when the agent starts a thread. */
-    "model"?: "gpt-6.1-sol" | "gpt-6-luna";
+    "model"?: "gpt-6.1-sol" | "gpt-6.1-terra" | "gpt-6-luna";
     /** Reasoning effort passed to assistant threads. */
     "reasoningEffort"?: "none" | "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. */
@@ -57,6 +57,10 @@ interface SwaggerAgentConfigDto {
     "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;
+    /** Context profile for new Agent threads. platform preserves the normal Agent context; minimal reduces automatic context while retaining mandatory policy and configured Agent instructions. Existing Agent tool and plugin admission is unchanged. Existing threads retain their saved profile on continuation and Resume. */
+    "contextMode"?: "platform" | "minimal";
+    /** Validated final-answer format for new Agent threads. Defaults to text. JSON may use the shared strict response schema contract. Existing threads retain their saved format on continuation and Resume; this field never replaces systemInstructions. */
+    "responseFormat"?: SwaggerAssistantResponseFormatDto;
     /** One persistent Agent memory shared by Memory settings and runtime memory tools, included in instructions on every turn. Limited to 20,000 assistant tokens. */
     "memory"?: string;
     /** Structured operator-owned Agent identity loaded on every autonomous turn. Learned memory cannot mutate this definition. */
@@ -400,6 +404,42 @@ interface SwaggerAgentReleaseRolloutPolicyDto {
     /** Optional admitted snapshot to roll back to when the current rollout is revoked. */
     "rollbackToSnapshotId"?: string;
 }
+interface SwaggerAssistantOutputDto {
+    /** Validated final-answer format. */
+    "type": "text" | "json";
+    /** Complete validated answer text. This value is independent of bounded operator summaries. */
+    "text": string;
+    /** Complete parsed object for a validated JSON answer; absent for text answers. */
+    "json"?: Record<string, unknown>;
+}
+interface SwaggerAssistantResponseFormatDto {
+    /** Final answer format. JSON without a schema requires a JSON object; with a schema it uses strict Structured Outputs. Defaults to text. */
+    "type": "text" | "json";
+    /** Optional strict JSON Schema for a JSON object response. All object properties must be required and additionalProperties must be false. Only local schema references are allowed. Maximum 32 KiB. */
+    "schema"?: Record<string, unknown>;
+    /** Schema responses are always strict. Defaults to true when schema is supplied; false and strict without a schema are rejected. */
+    "strict"?: true;
+}
+interface SwaggerAssistantThreadlessResponseContextDto {
+    /** Current Revo UI component hint included in the response context. It does not automatically select tools or skills. */
+    "componentContext"?: "PREFERENCES" | "USERS" | "SERVICE_ACCOUNTS" | "GROUPS" | "ROLE_GROUPS" | "SECRETS" | "REVISIONS" | "DATABASES" | "DATABASE_OPERATIONS" | "DATABASE_VIEWS" | "DATA" | "DATA_ITEMS" | "ENDPOINTS" | "TEMPLATES" | "SCHEDULE" | "SCHEDULE_HISTORY" | "EVENTS" | "JOBS" | "AGENTS" | "AGENT_RUNS" | "AGENT_INBOX" | "AGENT_PLUGINS" | "AGENT_TERMINALS" | "WEBHOOKS" | "COMPONENTS" | "COMPONENT_ELEMENTS" | "EVENTS_HISTORY" | "USER_KEYS" | "FILES" | "STORAGE" | "REALTIME" | "LOGS" | "MONITORING" | "THREAD" | "SECURITY_SETTINGS" | "ME_SETTINGS" | "ME_KEYS" | "USER_DETAILS" | "PLAYGROUND" | "WEB_IDE";
+    /** UI-level intent hint for the lightweight response. */
+    "kind"?: "suggestion" | "code_refactor" | "code_explain" | "completion" | "generic";
+    /** Additional UI instruction for this lightweight response. */
+    "instruction"?: string;
+    /** Programming or content language hint, for example typescript. */
+    "language"?: string;
+    /** Optional file/component path currently shown in the UI. */
+    "filePath"?: string;
+    /** Current selected text/code from the UI. */
+    "selectedText"?: string;
+    /** Nearby text/code around the current selection. */
+    "surroundingText"?: string;
+    /** Optional exact platform refs already known by the UI. */
+    "resourceRefs"?: Array<string>;
+    /** Compatibility context tags. Currently do not affect response context or tool selection. */
+    "requestContext"?: Array<string>;
+}
 interface SwaggerDatabaseDefinition {
     /** Column id, required only for update. */
     "databaseDefinitionId"?: string;
@@ -466,19 +506,19 @@ interface SwaggerDatabaseIndexExpressionDto {
     "fn"?: string;
     "args"?: Array<SwaggerDatabaseIndexExpressionDto>;
     "cast"?: string;
-    "literal"?: Record<string, unknown>;
+    "literal"?: string | number | boolean | null;
 }
 interface SwaggerDatabaseIndexPredicateDto {
     /** Logical AND. */
-    "and"?: Array<string>;
+    "and"?: Array<SwaggerDatabaseIndexPredicateDto>;
     /** Logical OR. */
-    "or"?: Array<string>;
+    "or"?: Array<SwaggerDatabaseIndexPredicateDto>;
     /** Logical NOT. */
     "not"?: SwaggerDatabaseIndexPredicateDto;
     "column"?: string;
     "op"?: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "like" | "ilike" | "in" | "between" | "isnull" | "notnull";
-    "value"?: Record<string, unknown>;
-    "values"?: Array<string>;
+    "value"?: string | number | boolean | null;
+    "values"?: Array<string | number | boolean | null>;
 }
 interface SwaggerDatabaseOptionsDto {
     "indexes"?: Array<SwaggerDatabaseIndexDefinitionDto>;
@@ -587,6 +627,8 @@ interface SwaggerStorageCellInputDto {
     "style"?: Record<string, unknown>;
 }
 interface SwaggerStorageCsvOptionsDto {
+    /** CSV read/index policy. abort rejects invalid records; skipRow skips only source field-count mismatches and reports their count and locations. Syntax and oversized-record errors always abort. */
+    "onError"?: "abort" | "skipRow";
     /** Output character encoding. Input encoding is detected when omitted. */
     "encoding"?: string;
     /** Emit a byte order mark at the start of the file. */
@@ -595,9 +637,11 @@ interface SwaggerStorageCsvOptionsDto {
     "delimiter"?: string;
     /** Record delimiter. */
     "recordDelimiter"?: "\n" | "\r" | "\r\n";
-    /** Quote character. */
-    "quote"?: string;
-    /** Quote escape character. */
+    /** Quote character, default double quote. Set false to disable CSV quoting; quotes and backslashes then remain literal and escape is ignored. */
+    "quote"?: string | false;
+    /** Maximum source bytes in one logical CSV record, including multiline quoted fields. Defaults to 64 MiB; independent of callback/read batch size. Larger records reject indexing with STORAGE_CSV_INVALID and a RecordTooLarge diagnostic. */
+    "maxRecordBytes"?: number;
+    /** Quote escape character. Ignored when quote is false. */
     "escape"?: string;
     /** Prefix spreadsheet formula-like values to prevent CSV formula injection. */
     "escapeFormulae"?: boolean;
@@ -654,7 +698,7 @@ interface SwaggerStorageSheetTableDto {
 interface SwaggerStorageTabularSchemaPolicyDto {
     /** How missing sheets or columns and invalid declared values are handled. fallback retains imperfect data with diagnostics; strict fails structured indexing. Defaults to fallback. */
     "profile"?: "fallback" | "strict";
-    /** How undeclared source columns are handled. allow retains them, strip omits them from structured rows, and reject fails indexing. Defaults to allow for fallback and reject for strict. The raw file is preserved. */
+    /** How undeclared source columns are handled. allow retains them, strip omits them from structured rows, and reject fails indexing. Defaults to allow for fallback and reject for strict. Already committed files retain their raw bytes; synchronous validation failures before publication do not create a readable entry. */
     "additionalProperties"?: "allow" | "strip" | "reject";
 }
 interface SwaggerUpdateServiceAccountAccessDto {
@@ -703,6 +747,42 @@ interface SwaggerWebhookRequestPatchDto {
     /** Explicit replacement of the whole body. Omitted body reuses the saved body. */
     "body"?: Record<string, unknown> | Array<unknown>;
 }
+interface SwaggerAgentRunResultDto {
+    /** Complete validated terminal answer, independent of the bounded human-readable summary. */
+    "output"?: SwaggerAssistantOutputDto;
+    /** Bounded human-readable terminal summary. Use output.text or output.json for the complete answer. */
+    "summary"?: string;
+}
+interface AssistantThreadQuery {
+    /** Number of rows to skip before pagination starts. Parsed from a query-string integer. */
+    "skip"?: number;
+    /** Maximum number of rows to return. Parsed from a query-string integer. Most list endpoints default to 100 when omitted. */
+    "take"?: number;
+    /** Include the total count in the response envelope only when explicitly true. Omitted or false skips the count query. */
+    "count"?: boolean;
+    /** Filter tree as a JSON string or bracket-style query object. Supports and/or/not groups and field predicates with ops such as 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, and false. Field names are allowed logical fields; relation fields use dot paths such as groups.groupId when exposed by the endpoint. */
+    "filter"?: string;
+    /** Sort definition as a JSON string, indexed array query object, array, or legacy CSV. JSON object values should be ASC or DESC. CSV supports descending fields with a leading dash, for example name,-lastUpdateAt. */
+    "sort"?: string;
+    /** Optional DISTINCT ON logical fields as a JSON array string, indexed array query object, array, or legacy CSV. Selected distinct fields are included in the projection. */
+    "distinct"?: string;
+    /** Optional field projection as a JSON array string, indexed array query object, array, or legacy CSV. String fields must be allowlisted logical fields. Advanced select items may use field, fn, raw, cast, coalesce, or case expressions when the endpoint enables dynamic projection. */
+    "fields"?: string;
+    /** Optional join definitions as a JSON string or bracket-style query object. This is only honored by endpoints that explicitly enable dynamic joins, such as dynamic database data reads. Each join has table, alias, type (left or inner), and an on condition. */
+    "joins"?: string;
+    /** Optional groupBy logical fields as a JSON array string, indexed array query object, array, or legacy CSV. Only honored when the endpoint enables dynamic grouping or already has grouped defaults. */
+    "groupBy"?: string;
+    /** Optional cast mapping as a JSON string or bracket-style query object. Keys are selected aliases or logical fields; values are database definition types such as TEXT, INTEGER, BIGINT, NUMERIC, BOOLEAN, DATE, TIMESTAMP, TIMESTAMPTZ, JSON, JSONB, or UUID where supported. */
+    "cast"?: string;
+    /** Optional CTE definitions as a JSON string or bracket-style query object. Only honored by endpoints that explicitly enable dynamic CTEs. */
+    "with"?: string;
+    /** Enable debug output for the request, including compiled SQL, bound params, and bounded EXPLAIN plans when the endpoint supports it. */
+    "debug"?: boolean;
+    /** Include technical response threads alongside conversations. Independent of deleted visibility. */
+    "includeResponses"?: boolean;
+    /** Include deleted owned threads. Independent of technical response visibility. */
+    "includeDeleted"?: boolean;
+}
 interface AgentRunCancelInput {
     /** Optional cancellation reason for audit traces. */
     "reason"?: string;
@@ -808,14 +888,30 @@ interface ServiceAccountKeyCreateInput {
     "expireAt"?: string;
 }
 interface AssistantMessageInput {
+    /** Instructions persisted on this thread across follow-up messages, Resume, same-owner forks and compaction. Maximum 16 KiB UTF-8 and 16 KiB after safe instruction rendering. Supplements mandatory runtime and instance-global instructions; never grants tool permissions. Immutable after creation. */
+    "instructions"?: string;
+    /** Persisted context profile. platform preserves the normal Revo Assistant. minimal keeps instance-global and account standing instructions and safety, omits automatic memory and plugin discovery/preload, and admits only explicitly selected tools/plugins. Defaults to platform. Immutable after creation. */
+    "contextMode"?: "platform" | "minimal";
+    /** Persisted final-answer format, also enforced on browser follow-ups and Resume. Defaults to text. Immutable after creation. */
+    "responseFormat"?: SwaggerAssistantResponseFormatDto;
+    /** 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<"ref_search" | "ref_describe" | "ref_apply" | "snapshot_get" | "snapshot_history" | "snapshot_diff" | "storage" | "skill_search" | "skill_load" | "memory_search" | "memory_load" | "memory_save" | "plan_update" | "code_search" | "code_read" | "code_exec" | "ops_investigate" | "platform_api_find_operation" | "dependency_graph" | "web_search" | "web_load" | "web_rich_lookup" | "wait" | "conversation_search" | "conversation_load" | "attachment_load" | "send_message" | "agent_handoff" | "agent_delegate" | "plugin_search" | "plugin_load" | "plugin_call" | "request_clarification" | "code_describe" | "generate_widget" | "terminal_exec" | "terminal" | "studio" | "tool_exec" | "tool_wait" | "tool_status" | "tool_cancel">;
+    /** Optional registry plugin ids attached to this assistant turn. */
+    "pluginIds"?: Array<string>;
+    /** Optional Studio session to work on in this conversation. Requires an enabled Studio feature and live editing membership. The binding persists across follow-up turns and does not share private conversation history. */
+    "studioSessionId"?: string;
     /** Finalized Storage files to link to this message. File access is checked on send and every read. */
     "storageEntryIds"?: Array<string>;
     /** 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-6 Luna is the default; GPT-6.1 Sol and GPT-6 Luna are supported. */
-    "model"?: "gpt-6.1-sol" | "gpt-6-luna";
+    /** Optional assistant execution-model override. GPT-6 Luna is the default; GPT-6.1 Sol, GPT-6.1 Terra and GPT-6 Luna are supported. */
+    "model"?: "gpt-6.1-sol" | "gpt-6.1-terra" | "gpt-6-luna";
     /** Optional GPT-6 Luna Fast mode. Defaults to false and remains opt-in per thread. */
     "fastMode"?: boolean;
     /** Optional assistant reasoning effort override: none, low, medium, high, or xhigh. Defaults to medium. */
@@ -834,14 +930,6 @@ interface AssistantMessageInput {
     "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;
 }
@@ -933,6 +1021,58 @@ interface StorageUploadSessionInput {
     /** Explicit allowed user ids for the finalized entry. */
     "users"?: Array<string>;
 }
+interface AssistantResponseInput {
+    /** Instructions persisted on this thread across follow-up messages, Resume, same-owner forks and compaction. Maximum 16 KiB UTF-8 and 16 KiB after safe instruction rendering. Supplements mandatory runtime and instance-global instructions; never grants tool permissions. Immutable after creation. */
+    "instructions"?: string;
+    /** Persisted context profile. platform preserves the normal Revo Assistant. minimal keeps instance-global and account standing instructions and safety, omits automatic memory and plugin discovery/preload, and admits only explicitly selected tools/plugins. Defaults to platform. Immutable after creation. */
+    "contextMode"?: "platform" | "minimal";
+    /** Persisted final-answer format, also enforced on browser follow-ups and Resume. Defaults to text. Immutable after creation. */
+    "responseFormat"?: SwaggerAssistantResponseFormatDto;
+    /** 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<"ref_search" | "ref_describe" | "ref_apply" | "snapshot_get" | "snapshot_history" | "snapshot_diff" | "storage" | "skill_search" | "skill_load" | "memory_search" | "memory_load" | "memory_save" | "plan_update" | "code_search" | "code_read" | "code_exec" | "ops_investigate" | "platform_api_find_operation" | "dependency_graph" | "web_search" | "web_load" | "web_rich_lookup" | "wait" | "conversation_search" | "conversation_load" | "attachment_load" | "send_message" | "agent_handoff" | "agent_delegate" | "plugin_search" | "plugin_load" | "plugin_call" | "request_clarification" | "code_describe" | "generate_widget" | "terminal_exec" | "terminal" | "studio" | "tool_exec" | "tool_wait" | "tool_status" | "tool_cancel">;
+    /** Optional registry plugin ids attached to this assistant turn. */
+    "pluginIds"?: Array<string>;
+    /** Optional Studio session to work on in this conversation. Requires an enabled Studio feature and live editing membership. The binding persists across follow-up turns and does not share private conversation history. */
+    "studioSessionId"?: string;
+    /** Finalized Storage files to link to this message. File access is checked on send and every read. */
+    "storageEntryIds"?: Array<string>;
+    /** 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-6 Luna is the default; GPT-6.1 Sol, GPT-6.1 Terra and GPT-6 Luna are supported. */
+    "model"?: "gpt-6.1-sol" | "gpt-6.1-terra" | "gpt-6-luna";
+    /** Optional GPT-6 Luna Fast mode. Defaults to false and remains opt-in per thread. */
+    "fastMode"?: boolean;
+    /** Optional assistant reasoning effort override: none, low, medium, high, or xhigh. Defaults to medium. */
+    "reasoningEffort"?: "none" | "low" | "medium" | "high" | "xhigh";
+    /** Alias for reasoningEffort used by assistant preferences. Prefer reasoningEffort for new clients. */
+    "reasoning"?: "none" | "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";
+    /** 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;
+    /** Optional assistant runtime selector. v2 routes the request through agent-gateway. v1 is expired and rejected. */
+    "version"?: "v1" | "v2";
+    /** Structured UI context for lightweight, threadless assistant responses. */
+    "context"?: SwaggerAssistantThreadlessResponseContextDto;
+    /** Create an ordinary visible conversation when true. Otherwise retain a technical response thread excluded from default list/search results; includeResponses opts into reading it. Neither mode automatically deletes the thread or its evidence. Defaults to false. */
+    "persistThread"?: boolean;
+}
 interface DatabaseOperationInput {
     /** Database ID/name, or view ID when viewAction is provided. */
     "databaseName": string;
@@ -973,6 +1113,8 @@ interface AssistantForkMessageInput {
     "version"?: "v1" | "v2";
     /** Optional explicit title for the forked thread. When omitted, orchestration will generate the new thread title. */
     "title"?: string;
+    /** Bind an owned conversation fork to an OPEN Studio workspace under fresh editing access. A Studio-bound source requires a child whose parentSessionId is the original workspace. The source conversation and its private history remain unchanged. */
+    "studioSessionId"?: string;
 }
 interface JobsBulkInput {
     /** Existing platform filter tree. Exactly one of filter and resource IDs is required. */
@@ -1073,7 +1215,7 @@ interface AssistantActionResolutionInput {
     /** 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-6.1-sol" | "gpt-6-luna";
+    "model"?: "gpt-6.1-sol" | "gpt-6.1-terra" | "gpt-6-luna";
     /** Optional Fast-mode override for the resumed turn. Available only on GPT-6 Luna. */
     "fastMode"?: boolean;
     /** Optional assistant reasoning effort override for the resumed turn: none, low, medium, high, or xhigh. */
@@ -1085,7 +1227,7 @@ interface AssistantActionResolutionInput {
     /** 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>;
+    "toolNames"?: Array<"ref_search" | "ref_describe" | "ref_apply" | "snapshot_get" | "snapshot_history" | "snapshot_diff" | "storage" | "skill_search" | "skill_load" | "memory_search" | "memory_load" | "memory_save" | "plan_update" | "code_search" | "code_read" | "code_exec" | "ops_investigate" | "platform_api_find_operation" | "dependency_graph" | "web_search" | "web_load" | "web_rich_lookup" | "wait" | "conversation_search" | "conversation_load" | "attachment_load" | "send_message" | "agent_handoff" | "agent_delegate" | "plugin_search" | "plugin_load" | "plugin_call" | "request_clarification" | "code_describe" | "generate_widget" | "terminal_exec" | "terminal" | "studio" | "tool_exec" | "tool_wait" | "tool_status" | "tool_cancel">;
     /** Optional additional registry plugin ids attached to the resumed turn. */
     "pluginIds"?: Array<string>;
 }
@@ -1288,11 +1430,6 @@ interface AutomationOperation {
     skipped: number;
     failed: number;
 }
-/**
- * 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.
- */
 /** Ordered, literal-safe updates. Repeated columns run top to bottom (maximum 100 operations).
  * NULL is preserved unless nulls: 'empty' is selected for text/array/JSON transforms.
  * insert.position is 1-based Unicode character position. replace replaces all exact matches.
@@ -1939,6 +2076,10 @@ interface StorageEntryView extends StorageEntry {
     breadcrumbs: StorageBreadcrumb[];
 }
 interface StorageExploreRequest {
+    /** Disable implicit parent-folder scoping; ACL and namespace checks still apply. */
+    flat?: boolean;
+    filter?: SelectFilterNode;
+    sort?: string[] | Record<string, SortDir>;
     parentStorageEntryId?: string;
     storageProviderConfigId?: string | null;
     term?: string;
@@ -2055,7 +2196,27 @@ interface StorageDocument {
     totalLines?: number;
     truncated?: boolean;
 }
+/** Whole-source CSV mismatch report. Repeated on pages; do not sum page reports. No raw values. */
+interface StorageCsvReadReport {
+    skippedRows: number;
+    diagnostics: Array<{
+        code: string;
+        recordNumber: number;
+        lineStart: number;
+        lineEnd: number;
+        startByte: number;
+        expectedFieldCount?: number;
+        actualFieldCount?: number;
+        message: string;
+    }>;
+    diagnosticsTruncated: boolean;
+}
 interface StorageFileReadOptions {
+    /** CSV only. Default abort. skipRow drops wrong-width source records; syntax/size errors still abort. */
+    onError?: 'abort' | 'skipRow';
+    /** Physical lines include headers and the trailing empty line. Defaults to records. */
+    mode?: 'records' | 'lines';
+    separator?: string;
     batchNumber?: number;
     buffer?: boolean;
     start?: number;
@@ -2070,7 +2231,11 @@ interface StorageFileReadOptions {
     encoding?: string;
     delimiter?: string;
     recordDelimiter?: '\n' | '\r' | '\r\n';
-    quote?: string;
+    /** One quote character (default double quote), or false for literal quotes/backslashes. */
+    quote?: string | false;
+    /** Maximum bytes in one logical CSV record; positive integer, default 64 MiB. Independent of read/callback size. */
+    maxRecordBytes?: number;
+    /** Quote escape character; ignored when quote is false. */
     escape?: string;
     /** XML record path such as `Orders/Order`; required for XML row reads. */
     recordPath?: string;
@@ -2086,11 +2251,18 @@ interface StorageFileReadOptions {
     }>;
 }
 interface StorageFileStatsOptions {
+    /** CSV only. Default abort. skipRow drops wrong-width source records; syntax/size errors still abort. */
+    onError?: 'abort' | 'skipRow';
+    mode?: 'records' | 'lines';
     separator?: string;
     encoding?: string;
     delimiter?: string;
     recordDelimiter?: '\n' | '\r' | '\r\n';
-    quote?: string;
+    /** One quote character (default double quote), or false for literal quotes/backslashes. */
+    quote?: string | false;
+    /** Maximum bytes in one logical CSV record; positive integer, default 64 MiB. Independent of read/callback size. */
+    maxRecordBytes?: number;
+    /** Quote escape character; ignored when quote is false. */
     escape?: string;
     headerRow?: number | null;
     reloadStats?: boolean;
@@ -2122,7 +2294,16 @@ interface StorageTabularSchemaResult {
     issues: StorageTabularSchemaIssue[];
 }
 interface StorageFileStats {
+    /** Present for CSV indexed with onError: skipRow; describes the entire source. */
+    csvReport?: StorageCsvReadReport;
+    /** Legacy physical-window count, including the terminal empty window after a delimiter. */
     lineCount?: number;
+    /** Actual physical lines, including headers, blanks and multiline CSV field lines; no terminal synthetic empty line. */
+    physicalLineCount?: number;
+    /** Empty physical lines, excluding the synthetic terminal empty line. */
+    blankLineCount?: number;
+    /** Whether the source ends in its detected or explicit record delimiter. */
+    endsWithRecordDelimiter?: boolean;
     map?: LooseObject<number>;
     separator?: string;
     batches?: number;
@@ -2133,7 +2314,11 @@ interface StorageFileStats {
     bom?: boolean;
     delimiter?: string;
     recordDelimiter?: string;
-    quote?: string;
+    /** One quote character (default double quote), or false for literal quotes/backslashes. */
+    quote?: string | false;
+    /** Maximum bytes in one logical CSV record; positive integer, default 64 MiB. Independent of read/callback size. */
+    maxRecordBytes?: number;
+    /** Quote escape character; ignored when quote is false. */
     escape?: string;
     rowCount?: number;
     headers?: StorageTabularColumn[];
@@ -2148,6 +2333,7 @@ interface StorageFileStats {
     }>;
 }
 interface StorageStructuredFileDataPage {
+    csvReport?: StorageCsvReadReport;
     format: 'csv' | 'xlsx' | 'ndjson' | 'json-array' | 'xml';
     sheet: string | null;
     headers: StorageTabularColumn[];
@@ -2416,7 +2602,9 @@ interface ComponentExecuteRequest {
      */
     componentId: string;
     /**
-     * Optional exact component version. Omit to run the latest active version.
+     * Optional exact component version. Omit to use the execution's active release.
+     * A pinned Studio release rejects versions newer than its component binding.
+     * Studio tests accept an explicit version only when it matches their captured source.
      */
     componentVersion?: number;
     /**
@@ -2691,6 +2879,10 @@ interface AgentConfig {
     workMode?: AgentWorkMode;
     persona?: AgentPersona;
     systemInstructions?: string;
+    /** Profile for new Agent threads; defaults to platform. Mandatory Agent instructions and existing tool/plugin admission remain authoritative. */
+    contextMode?: 'platform' | 'minimal';
+    /** Final-answer contract for new Agent threads; defaults to text. Existing threads keep their saved contract on continuation and Resume. */
+    responseFormat?: SwaggerAssistantResponseFormatDto;
     /** Persistent Agent Memory shared with memory tools and included in every instruction packet; at most 20,000 o200k_base tokens. */
     memory?: string;
     memoryPolicy?: AgentMemoryPolicy;
@@ -2800,7 +2992,8 @@ interface AgentRun {
     lastHeartbeatAt?: Date | string | null;
     checkpointSummary?: string | null;
     state?: Record<string, any>;
-    result?: Record<string, any> | null;
+    /** Complete validated answer is in output; summary is bounded. Additional runtime result fields remain available. */
+    result?: (Record<string, any> & SwaggerAgentRunResultDto) | null;
     error?: Record<string, any> | null;
     createdBy?: string;
     createdAt?: Date | string;
@@ -2936,6 +3129,12 @@ interface AssistantActionRequired {
     planningTransition?: AssistantPlanningTransition | null;
 }
 interface AssistantThread {
+    /** conversation for ordinary chats; response for retained technical results hidden from the default conversation list. */
+    kind?: 'conversation' | 'response';
+    /** Immutable creation-time task contract, preserved by continuation, Resume and same-owner fork. */
+    instructions?: string;
+    contextMode?: 'platform' | 'minimal';
+    responseFormat?: SwaggerAssistantResponseFormatDto;
     assistantThreadId: string;
     title: string;
     status: string;
@@ -3006,6 +3205,8 @@ interface AssistantSharedThreadResponse {
 }
 interface AssistantThreadResponse {
     thread: AssistantThread;
+    /** Validated terminal answer for explicitly configured thread contracts. Absent while approval/clarification is required. */
+    output?: SwaggerAssistantOutputDto;
     message?: AssistantMessage | null;
     assistantMessage?: AssistantMessage | null;
     noticeMessages?: AssistantMessage[];
@@ -3296,7 +3497,9 @@ interface RevoApi {
     currentUser(): LoggedUser;
     isDebug(): boolean;
     getCache(key: string): any;
-    setCache(key: string, value: any): void;
+    setCache(key: string, value: any, options?: {
+        reference?: boolean;
+    }): void;
     getContext(): Context;
     getErrors(): ProcessLog[];
     getExecutionId(): string;
@@ -3330,10 +3533,10 @@ interface RevoApi {
     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>;
+    concurrencyLimit(key: string, limit: number, ttl: number, leaseOwnerId?: string): Promise<boolean>;
     rateLimit(key: string, limit: number, ttl: number): Promise<boolean>;
     releaseRateLimit(key: string): Promise<void>;
-    releaseConcurrencyLimit(key: string): Promise<void>;
+    releaseConcurrencyLimit(key: string, leaseOwnerId?: string): Promise<void>;
     triggerEvent(name: string, message: any, options?: TriggerEventOptions): Promise<string>;
     triggerTarget(targetType: ExecutionTargetType, targetId: string, input?: Record<string, JsonValue>, options?: AutomationScheduleOptions): Promise<string>;
     triggerJob(templateIdOrName: string, templateInputs?: Record<string, JsonValue>, options?: AutomationScheduleOptions): Promise<string>;
@@ -3362,12 +3565,12 @@ interface RevoApi {
         responseType: 'storage';
         target: HttpStorageTargetRef;
         timeout?: number;
-        proxy?: false;
+        proxy?: boolean;
     }): Promise<{
         status: number;
         statusText: string;
         time: number;
-        headers: LooseObject<string>;
+        headers: LooseObject<string | string[]>;
         revo?: HttpRevoResponseScope;
         request: {
             config: HttpRequestInterface;
@@ -3390,7 +3593,7 @@ interface RevoApi {
         status: number;
         statusText: string;
         time: number;
-        headers: LooseObject<string>;
+        headers: LooseObject<string | string[]>;
         revo?: HttpRevoResponseScope;
         data: any;
         storage?: {
@@ -3463,8 +3666,8 @@ interface RevoStorage {
     restoreEntry(namespace: string, storageEntryId: string, data: StorageRestoreInput): Promise<StorageEntryView>;
     deleteEntry(storageEntryId: string, data: StorageVersionInput): Promise<StorageEntryView>;
     deleteEntry(namespace: string, storageEntryId: string, data: StorageVersionInput): Promise<StorageEntryView>;
-    getDownload(storageEntryId: string, preview?: boolean): Promise<StorageDownload>;
-    getDownload(namespace: string, storageEntryId: string, preview?: boolean): Promise<StorageDownload>;
+    getDownload(storageEntryId: string, preview?: boolean, ttlSeconds?: number): Promise<StorageDownload>;
+    getDownload(namespace: string, storageEntryId: string, preview?: boolean, ttlSeconds?: number): Promise<StorageDownload>;
     getDocument(storageEntryId: string, options?: StorageDocumentReadOptions): Promise<StorageDocument>;
     getDocument(namespace: string, storageEntryId: string, options?: StorageDocumentReadOptions): Promise<StorageDocument>;
 }
@@ -3498,7 +3701,7 @@ interface RevoAgents {
     tickRun(agentRunId: string): Promise<AgentRun>;
     cancelRun(agentRunId: string, data?: AgentRunCancelInput): Promise<AgentRun>;
     reconcileRuns(): Promise<any>;
-    listThreads(query?: Record<string, any>): Promise<CollectionResult<AssistantThread>>;
+    listThreads(query?: AssistantThreadQuery): Promise<CollectionResult<AssistantThread>>;
     getThread(assistantThreadId: string, options?: {
         hideDeleted?: boolean;
     }): Promise<AssistantThread>;
@@ -3512,6 +3715,7 @@ interface RevoAgents {
     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>;
+    createResponse(data: AssistantResponseInput): Promise<AssistantThreadResponse>;
     deleteThread(assistantThreadId: string): Promise<void>;
     restoreThread(assistantThreadId: string): Promise<void>;
     listThreadMessages(assistantThreadId: string, query?: Record<string, any>): Promise<CollectionResult<AssistantMessage>>;