@lunnoa/client 0.0.0-development → 1.1.0

package/dist/react.d.cts

@@ -227,6 +227,8 @@ interface components {
             SKILLS: boolean;
             /** @description Whether the hexagonal agent builder canvas UI is enabled. */
             AGENT_BUILDER_CANVAS: boolean;
+            /** @description Whether the Solution Designer UI is enabled. */
+            SOLUTION_DESIGNER: boolean;
             /** @description Whether isolated code execution for agents is enabled. */
             CODE_EXECUTION: boolean;
             /** @description Whether SSO (OIDC) login is enabled. Requires at least one enabled SSO provider. */
@@ -297,6 +299,8 @@ interface components {
         CreateQueueDto: {
             /** @description Human-readable name for the queue. */
             name: string;
+            /** @description ObjectType IDs this queue accepts for linked items. Empty/omitted = any ObjectType (and untyped items) allowed. */
+            allowedObjectTypeIds?: string[];
             /** @description Description of what the queue is used for. */
             description?: string;
             /** @description Maximum number of retry attempts per item. Defaults to 3. */
@@ -338,6 +342,14 @@ interface components {
             /** @description Number of items in the queue. */
             items: number;
         };
+        QueueAllowedObjectTypeDto: {
+            /** @description Object type ID. */
+            id: string;
+            /** @description Object type name. */
+            name: string;
+            /** @description Object type slug. */
+            slug: string;
+        };
         QueueResponseDto: {
             /** @description Queue ID. */
             id: string;
@@ -383,6 +395,8 @@ interface components {
             createdByWorkspaceUser?: components["schemas"]["QueueCreatedByWorkspaceUserDto"];
             /** @description Relation counts. Included when `expansion=itemCounts` is requested. */
             _count?: components["schemas"]["QueueItemCountsDto"];
+            /** @description ObjectTypes this queue accepts for linked items. Empty means any type is allowed. Included when `expansion=allowedObjectTypes` is requested. */
+            allowedObjectTypes?: components["schemas"]["QueueAllowedObjectTypeDto"][];
         };
         QueueStatsResponseDto: {
             /** @description Total number of items in the queue. */
@@ -401,6 +415,8 @@ interface components {
         UpdateQueueDto: {
             /** @description Human-readable name for the queue. */
             name?: string;
+            /** @description ObjectType IDs this queue accepts for linked items. Empty/omitted = any ObjectType (and untyped items) allowed. */
+            allowedObjectTypeIds?: string[];
             /** @description Description of what the queue is used for. */
             description?: string;
             /** @description Maximum number of retry attempts per item. Defaults to 3. */
@@ -421,6 +437,8 @@ interface components {
         CreateQueueItemDto: {
             /** @description External identifier used to deduplicate items within the queue. */
             externalId?: string;
+            /** @description Optional Object (entity) this work item is about. Must belong to the same workspace. If the queue has allowed ObjectTypes configured, the Object type must be one of them. */
+            objectId?: string;
             /** @description Arbitrary JSON payload for the item. Maximum size 64KB. */
             data?: {
                 [key: string]: unknown;
@@ -467,11 +485,31 @@ interface components {
             /** @description Workflow the execution belongs to. */
             workflow: components["schemas"]["QueueItemExecutionWorkflowDto"];
         };
+        QueueItemObjectTypeSummaryDto: {
+            /** @description Object type ID. */
+            id: string;
+            /** @description Object type name. */
+            name: string;
+            /** @description Object type slug. */
+            slug: string;
+        };
+        QueueItemObjectSummaryDto: {
+            /** @description Object ID. */
+            id: string;
+            /** @description Object display name. */
+            name: string;
+            /** @description Current object state ID. */
+            state: string | null;
+            /** @description Object type summary. */
+            objectType: components["schemas"]["QueueItemObjectTypeSummaryDto"];
+        };
         QueueItemCreateResponseDto: {
             /** @description Queue item ID. */
             id: string;
             /** @description External identifier used for deduplication. */
             externalId: string | null;
+            /** @description Linked Object (entity) ID this work item is about, if any. */
+            objectId: string | null;
             /** @description JSON payload for the item. */
             data: {
                 [key: string]: unknown;
@@ -534,6 +572,8 @@ interface components {
             queue?: components["schemas"]["QueueItemQueueSummaryDto"];
             /** @description Most recently linked workflow execution. Included when `expansion=lastExecution` is requested. */
             lastExecution?: components["schemas"]["QueueItemLastExecutionDto"] | null;
+            /** @description Linked Object summary. Included when `expansion=object` is requested. */
+            object?: components["schemas"]["QueueItemObjectSummaryDto"] | null;
             /** @description True when an existing item with the same externalId was returned instead of creating a new one. */
             isDuplicate: boolean;
         };
@@ -554,6 +594,8 @@ interface components {
             id: string;
             /** @description External identifier used for deduplication. */
             externalId: string | null;
+            /** @description Linked Object (entity) ID this work item is about, if any. */
+            objectId: string | null;
             /** @description JSON payload for the item. */
             data: {
                 [key: string]: unknown;
@@ -616,6 +658,8 @@ interface components {
             queue?: components["schemas"]["QueueItemQueueSummaryDto"];
             /** @description Most recently linked workflow execution. Included when `expansion=lastExecution` is requested. */
             lastExecution?: components["schemas"]["QueueItemLastExecutionDto"] | null;
+            /** @description Linked Object summary. Included when `expansion=object` is requested. */
+            object?: components["schemas"]["QueueItemObjectSummaryDto"] | null;
         };
         BulkCreateQueueItemsSummaryDto: {
             /** @description Number of items created. */
@@ -666,6 +710,8 @@ interface components {
             updatedAt: string;
             /** @description External identifier used for deduplication. */
             externalId: string | null;
+            /** @description Linked Object (entity) ID this work item is about, if any. */
+            FK_objectId: string | null;
             /** @description JSON payload for the item. */
             data: {
                 [key: string]: unknown;
@@ -756,6 +802,8 @@ interface components {
         UpdateQueueItemDto: {
             /** @description External identifier used to deduplicate items within the queue. */
             externalId?: string;
+            /** @description Optional Object (entity) this work item is about. Must belong to the same workspace. If the queue has allowed ObjectTypes configured, the Object type must be one of them. */
+            objectId?: string;
             /** @description Arbitrary JSON payload for the item. Maximum size 64KB. */
             data?: {
                 [key: string]: unknown;
@@ -921,33 +969,45 @@ interface components {
             /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
             managedByCode?: boolean;
         };
-        WorkflowAppResponseDto: {
-            /** @description App ID, e.g. `gmail`. Matches the appId used in workflow execution steps. */
-            id: string;
-            /** @description Human-readable app name. */
-            name: string;
-            /** @description App description. */
-            description: string;
-            /** @description URL of the app logo. */
-            logoUrl: string;
-            /** @description Whether the app is published and available for use. */
-            isPublished: boolean;
-            /** @description Whether the app requires a connection before its actions and triggers can run. */
-            needsConnection: boolean;
-            /** @description Whether the app can be used by agents. */
-            availableForAgent: boolean;
-            /** @description Action definitions, each with id, name, description, iconUrl, needsConnection, availableForAgent, viewOptions and the declarative inputConfig field metadata used to render action UIs. */
-            actions: {
-                [key: string]: unknown;
-            }[];
-            /** @description Trigger definitions, each with id, name, description, iconUrl, needsConnection and the declarative inputConfig field metadata used to render trigger UIs. */
-            triggers: {
+        UpsertObjectTypeBySlugDto: {
+            /** @description Stable workspace-scoped slug (lowercase, digits, hyphens). Used as the upsert key. */
+            slug: string;
+            /** @description Singular display name. */
+            name?: string;
+            /** @description Plural display name. */
+            namePlural?: string;
+            /** @description Description. */
+            description?: string;
+            /**
+             * @description Icon identifier.
+             * @default box
+             */
+            icon: string;
+            /**
+             * @description Hex colour.
+             * @default #3B82F6
+             */
+            color: string;
+            /** @description Field definitions grouped into sections. */
+            attributeSchema: {
                 [key: string]: unknown;
-            }[];
-            /** @description Connection type definitions supported by the app (e.g. oauth2, apiKey, basic), each with id, name, description, connectionType and any declarative inputConfig fields. */
-            connections: {
+            };
+            /** @description Optional state machine definition. */
+            stateSchema?: {
                 [key: string]: unknown;
-            }[];
+            } | null;
+            /** @description Whether the type is enabled. */
+            isEnabled?: boolean;
+            /**
+             * @description When false (default), reject unknown attribute keys on entity writes.
+             * @default false
+             */
+            allowUnknownAttributes: boolean;
+            /**
+             * @description Marks the type as code-managed. Defaults to true on upsert.
+             * @default true
+             */
+            managedByCode: boolean;
         };
         ObjectTypeUserSummaryDto: {
             /** @description User ID. */
@@ -981,6 +1041,12 @@ interface components {
             color: string;
             /** @description Whether the entity type is enabled. */
             isEnabled: boolean;
+            /** @description When false, entity create/update rejects attribute keys not declared on the type. Reserved key `extensions` is always allowed. */
+            allowUnknownAttributes: boolean;
+            /** @description True when last written by code (CLI / SDK upsert). */
+            managedByCode: boolean;
+            /** @description Incremented when attributeSchema, stateSchema, or allowUnknownAttributes changes. */
+            schemaRevision: number;
             /** @description Description of the entity type. Included when `expansion=description` is requested. */
             description?: string | null;
             /** @description Field definitions grouped into sections. Included when `expansion=attributeSchema` is requested. */
@@ -1258,49 +1324,55 @@ interface components {
                 [key: string]: string;
             };
         };
-        CreateKnowledgeDto: {
-            /** @description Name of the knowledge base. */
-            name: string;
-            /** @description Description of the knowledge base. */
-            description?: string;
-            /** @description Default chunk overlap in words. Must be provided together with chunkSize and cannot exceed 50% of it. */
-            chunkOverlap?: number;
-            /** @description Default chunk size in words (50 to 2000). Must be provided together with chunkOverlap. */
-            chunkSize?: number;
-            /** @description Embedding model to use. Defaults to the platform-configured embedding model. */
-            embeddingModel?: string;
-            /** @description Embedding provider to use. Defaults to the platform-configured embedding provider. */
-            embeddingProvider?: string;
-            /** @description Embedding vector dimensions. Defaults to the platform-configured dimensions. */
-            dimensions?: number;
-        };
-        KnowledgeCountDto: {
-            /** @description Number of vector references stored in this knowledge base. */
-            vectorRefs: number;
-        };
-        KnowledgeVectorRefSummaryDto: {
-            /** @description Vector reference ID. */
-            id: string;
-            /** @description ID of the knowledge base the vector reference belongs to. */
-            FK_knowledgeId: string;
-        };
-        KnowledgeUsageDto: {
-            /** @description Total prompt tokens consumed when embedding content into this knowledge base. */
-            promptTokens: number;
-        };
-        KnowledgeWorkspaceDto: {
-            /** @description Workspace ID. */
+        WorkflowAppResponseDto: {
+            /** @description App ID, e.g. `gmail`. Matches the appId used in workflow execution steps. */
             id: string;
-            /** @description Workspace name. */
+            /** @description Human-readable app name. */
             name: string;
+            /** @description App description. */
+            description: string;
+            /** @description URL of the app logo. */
+            logoUrl: string;
+            /** @description Whether the app is published and available for use. */
+            isPublished: boolean;
+            /** @description Whether the app requires a connection before its actions and triggers can run. */
+            needsConnection: boolean;
+            /** @description Whether the app can be used by agents. */
+            availableForAgent: boolean;
+            /** @description Action definitions, each with id, name, description, iconUrl, needsConnection, availableForAgent, viewOptions and the declarative inputConfig field metadata used to render action UIs. */
+            actions: {
+                [key: string]: unknown;
+            }[];
+            /** @description Trigger definitions, each with id, name, description, iconUrl, needsConnection and the declarative inputConfig field metadata used to render trigger UIs. */
+            triggers: {
+                [key: string]: unknown;
+            }[];
+            /** @description Connection type definitions supported by the app (e.g. oauth2, apiKey, basic), each with id, name, description, connectionType and any declarative inputConfig fields. */
+            connections: {
+                [key: string]: unknown;
+            }[];
         };
-        KnowledgeResponseDto: {
-            /** @description Knowledge base ID. */
+        AgentResponseDto: {
+            /**
+             * @description Agent ID (UUID)
+             * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
+             */
             id: string;
-            /** @description Knowledge base name. */
+            /**
+             * @description Agent name
+             * @example Invoice Triage Agent
+             */
             name: string;
-            /** @description Knowledge base description. Included when `expansion=description` is requested. */
-            description?: string;
+            /** @description Stable project-scoped slug for CLI / code deploy upserts. Included when `expansion=slug` is requested. */
+            slug?: string | null;
+            /** @description True when last written by code (CLI / SDK). Included when `expansion=managedByCode` is requested. */
+            managedByCode?: boolean;
+            /** @description ID of the AI provider connection assigned to the agent. Always included. Null when the agent falls back to the workspace default connection. */
+            FK_aiConnectionId: string | null;
+            /** @description Agent description. Included when `expansion=description` is requested. */
+            description?: string | null;
+            /** @description Public URL of the agent profile image. Included when `expansion=profileImageUrl` is requested. */
+            profileImageUrl?: string | null;
             /**
              * Format: date-time
              * @description Creation timestamp. Included when `expansion=createdAt` is requested.
@@ -1311,219 +1383,318 @@ interface components {
              * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
              */
             updatedAt?: string;
-            /** @description Name of the underlying vector index collection. Included when `expansion=indexName` is requested. */
-            indexName?: string;
-            /** @description Default chunk size in words used when uploading text. Included when `expansion=chunkSize` is requested. */
-            chunkSize?: number;
-            /** @description Default chunk overlap in words used when uploading text. Included when `expansion=chunkOverlap` is requested. */
-            chunkOverlap?: number;
-            /** @description Embedding model used for this knowledge base. Included when `expansion=embeddingModel` is requested. */
-            embeddingModel?: string;
-            /** @description Embedding provider used for this knowledge base. Included when `expansion=embeddingProvider` is requested. */
-            embeddingProvider?: string;
-            /** @description Embedding vector dimensions. Included when `expansion=dimensions` is requested. */
-            dimensions?: number;
-            /** @description Aggregate counts. Included when `expansion=countVectorRefs` is requested. */
-            _count?: components["schemas"]["KnowledgeCountDto"];
-            /** @description Vector references stored in this knowledge base. Included when `expansion=vectorRefs` is requested. */
-            vectorRefs?: components["schemas"]["KnowledgeVectorRefSummaryDto"][];
-            /** @description Embedding token usage. Included when `expansion=usage` is requested. */
-            usage?: components["schemas"]["KnowledgeUsageDto"];
-            /** @description Owning workspace. Included when `expansion=workspace` is requested. */
-            workspace?: components["schemas"]["KnowledgeWorkspaceDto"];
-        };
-        UpdateKnowledgeDto: {
-            /** @description Name of the knowledge base. */
-            name?: string;
-            /** @description Description of the knowledge base. */
-            description?: string;
-            /** @description Default chunk overlap in words. Must be provided together with chunkSize and cannot exceed 50% of it. */
-            chunkOverlap?: number;
-            /** @description Default chunk size in words (50 to 2000). Must be provided together with chunkOverlap. */
-            chunkSize?: number;
-            /** @description Embedding model to use. Defaults to the platform-configured embedding model. */
-            embeddingModel?: string;
-            /** @description Embedding provider to use. Defaults to the platform-configured embedding provider. */
-            embeddingProvider?: string;
-            /** @description Embedding vector dimensions. Defaults to the platform-configured dimensions. */
-            dimensions?: number;
-        };
-        SaveUploadedTextToKnowledgeDto: {
-            /** @description Name of the document. Multi-part uploads are suffixed with the part number. */
-            name: string;
-            /** @description Raw text content to embed into the knowledge base. */
-            text: string;
-            /** @description Chunk overlap in words. Roughly 10% of chunkSize is recommended. */
-            chunkOverlap: number;
-            /** @description Chunk size in words used to split the text before embedding. */
-            chunkSize: number;
-        };
-        KnowledgeDocumentResponseDto: {
-            /** @description Document ID. For `group` documents this is the vector reference group ID; for `standalone` documents it is the vector reference ID. */
-            id: string;
-            /** @description Document name. */
-            name: string;
+            /** @description System instructions authored for the agent. Included when `expansion=instructions` is requested. */
+            instructions?: string | null;
             /**
-             * Format: date-time
-             * @description Creation timestamp.
+             * @description Model temperature. Included when `expansion=temperature` is requested.
+             * @example 1
              */
-            createdAt: string;
-            /** @description Number of parts (chunks) the document was split into. */
-            partCount: number;
+            temperature?: number;
+            /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
+            maxOutputTokens?: number | null;
             /**
-             * @description Whether the document is a multi-part group or a standalone single-part upload.
-             * @enum {string}
+             * @description Top-p sampling. Included when `expansion=topP` is requested.
+             * @example 1
              */
-            type: "group" | "standalone";
-        };
-        KnowledgeDocumentGroupVectorRefDto: {
-            /** @description Vector reference ID. */
-            id: string;
-            /** @description Vector reference name, including the part suffix for multi-part uploads. */
-            name: string;
+            topP?: number;
             /**
-             * Format: date-time
-             * @description Creation timestamp.
+             * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
+             * @example 0
              */
-            createdAt: string;
-            /** @description Part number within the group, or null for single-part uploads. */
-            part: number | null;
-            /** @description Storage path of the raw text for this part. */
-            s3Link: string | null;
-        };
-        KnowledgeDocumentGroupResponseDto: {
-            /** @description Document group ID. */
-            id: string;
-            /** @description Document group name, or null for legacy groups without a stored name. */
-            name: string | null;
+            frequencyPenalty?: number;
             /**
-             * Format: date-time
-             * @description Creation timestamp.
+             * @description Presence penalty. Included when `expansion=presencePenalty` is requested.
+             * @example 0
              */
-            createdAt: string;
-            /** @description ID of the knowledge base the group belongs to, or null for legacy groups. */
-            FK_knowledgeId: string | null;
-            /** @description Vector references (parts) in the group, ordered by part number. */
-            vectorRefs: components["schemas"]["KnowledgeDocumentGroupVectorRefDto"][];
-        };
-        ManuallyRunWorkflowInputDataDto: {
+            presencePenalty?: number;
             /**
-             * @description Values for the custom input fields configured on the workflow "Manually Run" trigger, keyed by field ID. Pass an empty object when the trigger defines no custom input fields.
-             * @example {
-             *       "customerEmail": "jane@example.com",
-             *       "priority": "high"
-             *     }
+             * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
+             * @example 0
              */
-            inputData: {
-                [key: string]: unknown;
-            };
-        };
-        ExecuteWorkflowResponseDto: {
-            /** @description ID of the newly created execution. Poll GET /executions/{executionId} to track progress. */
-            id: string;
-        };
-        ExecutionWorkspaceSummaryDto: {
-            /** @description Workspace ID */
-            id: string;
-            /** @description Workspace name */
-            name: string;
-        };
-        ExecutionProjectSummaryDto: {
-            /** @description Project ID */
-            id: string;
-            /** @description Project name */
-            name: string;
-            /** @description The workspace the project belongs to. Included when `expansion=workspace` is requested alongside `workflow` and `project`. */
-            workspace?: components["schemas"]["ExecutionWorkspaceSummaryDto"];
-        };
-        ExecutionWorkflowSummaryDto: {
-            /** @description Workflow ID */
-            id: string;
-            /** @description Workflow name */
-            name: string;
-            /** @description The project the workflow belongs to. Included when `expansion=project` is requested alongside `workflow`. */
-            project?: components["schemas"]["ExecutionProjectSummaryDto"];
-        };
-        ExecutionPathStepDto: {
-            /** @description ID of the workflow node this step represents */
-            nodeId: string;
-            /** @description Human-friendly node name */
-            label: string;
-            /** @description ID of the app the node belongs to */
-            appId: string;
-            /** @description Action ID, present when the step is an action node */
-            actionId?: string;
-            /** @description Trigger ID, present when the step is the trigger node */
-            triggerId?: string;
+            maxRetries?: number;
+            /** @description Fixed sampling seed. Included when `expansion=seed` is requested. */
+            seed?: number | null;
             /**
-             * @description Step status. NEEDS_INPUT indicates the step is paused waiting for user input.
-             * @enum {string}
+             * @description Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
+             * @example 5
              */
-            status: "RUNNING" | "SUCCESS" | "FAILED" | "NEEDS_INPUT" | "SCHEDULED" | "RETRYING" | "WAITING";
-            /** @description Status detail message for the step */
-            statusMessage?: string;
-            /** @description Timestamp when the step started */
-            startTime?: string;
-            /** @description Timestamp when the step finished */
-            endTime?: string;
-            /** @description nodeId this step is an iteration of (set on loop child entries) */
-            iterationOf?: string;
-            /** @description Index of the loop iteration this step belongs to */
-            iterationIndex?: number;
-            /** @description On the collapsed loop parent entry: how many times the loop ran (or is planned to run) */
-            iterationCount?: number;
+            maxToolRoundtrips?: number;
             /**
-             * @description Approval status when this step is a Request Approval node awaiting or past a decision
+             * @description How many previous messages are sent to the model. Included when `expansion=messageLookbackLimit` is requested.
+             * @example 40
+             */
+            messageLookbackLimit?: number;
+            /** @description Configured tool nodes (app actions) for the agent. Included when `expansion=tools` is requested. */
+            tools?: {
+                [key: string]: unknown;
+            }[] | null;
+            /** @description Action IDs of the configured tools. Included when `expansion=toolIds` is requested. */
+            toolIds?: string[];
+            /** @description Instructions used when auto-naming new tasks. Included when `expansion=taskNamingInstructions` is requested. */
+            taskNamingInstructions?: string | null;
+            /** @description IDs of enabled provider built-in tools. Included when `expansion=enabledBuiltInTools` is requested. */
+            enabledBuiltInTools?: string[];
+            /** @description IDs of enabled platform tools. Included when `expansion=enabledPlatformTools` is requested. */
+            enabledPlatformTools?: string[];
+            /** @description Whether dynamic workflow-app action discovery is enabled. Included when `expansion=dynamicActionDiscoveryEnabled` is requested. */
+            dynamicActionDiscoveryEnabled?: boolean;
+            /** @description Whether dynamic MCP server discovery is enabled. Included when `expansion=dynamicMcpDiscoveryEnabled` is requested. */
+            dynamicMcpDiscoveryEnabled?: boolean;
+            /** @description Whether the agent maintains its own instructions. Included when `expansion=dynamicSelfInstructionsEnabled` is requested. */
+            dynamicSelfInstructionsEnabled?: boolean;
+            /** @description Whether long-term memory is enabled. Included when `expansion=memoryEnabled` is requested. */
+            memoryEnabled?: boolean;
+            /** @description Whether runtime planning tools are enabled. Included when `expansion=enablePlanning` is requested. */
+            enablePlanning?: boolean;
+            /** @description Whether oversized tool-result offload is enabled. Included when `expansion=enableToolResultOffload` is requested. */
+            enableToolResultOffload?: boolean;
+            /** @description Byte threshold for tool-result offload. Included when `expansion=toolResultOffloadThresholdBytes` is requested. */
+            toolResultOffloadThresholdBytes?: number;
+            /** @description Whether long-horizon mode is enabled. Included when `expansion=longHorizonMode` is requested. */
+            longHorizonMode?: boolean;
+            /** @description prepareStep safety-net policy ids. Included when `expansion=enabledToolPolicies` is requested. */
+            enabledToolPolicies?: string[];
+            /** @description Per-tool force overrides. Included when `expansion=forcedTools` is requested. */
+            forcedTools?: string[];
+            /** @description When true with planning, gate heavy tools until plan approval. Included when `expansion=requirePlanApproval` is requested. */
+            requirePlanApproval?: boolean;
+            /** @description Optional elevated max steps for long-horizon mode. Included when `expansion=longHorizonMaxSteps` is requested. */
+            longHorizonMaxSteps?: number | null;
+            /** @description Optional max tokens per run hint for long-horizon mode. Included when `expansion=longHorizonMaxTokensPerRun` is requested. */
+            longHorizonMaxTokensPerRun?: number | null;
+            /**
+             * @description Memory partitioning scope. Included when `expansion=memoryScope` is requested.
              * @enum {string}
              */
-            approvalStatus?: "pending" | "partially_approved" | "approved" | "rejected" | "expired";
-            /** @description Number of approve decisions received so far */
-            approvalsReceived?: number;
-            /** @description Number of approvals required for quorum / current stage */
-            approvalsRequired?: number;
-        };
-        PendingInputFieldDto: {
-            /** @description Field ID used as the key when submitting input */
-            id: string;
-            /** @description Human-readable field label */
-            label: string;
-            /** @description Field input type from the workflow builder (e.g. text, number, select) */
-            inputType: string;
-            /** @description Whether the field must be provided to resume */
-            required: boolean;
-            /** @description Optional helper text for the field */
-            description?: string;
-            /** @description Selectable options when the field is a select-like input */
-            options?: {
-                label?: string;
-                value?: string;
-            }[];
-        };
-        PendingInputDto: {
-            /** @description ID of the waiting workflow node */
-            nodeId: string;
-            /** @description Human-friendly node name */
-            label: string;
-            /** @description Action ID of the waiting node, when it is an action step */
-            actionId?: string;
-            /** @description Optional instructions configured on the waiting node */
-            instructions?: string;
-            /** @description Fields the custom UI should collect. Submit values keyed by field `id` to POST /api/webhooks/executions/{executionId}/nodes/{nodeId}/input. */
-            fields: components["schemas"]["PendingInputFieldDto"][];
-        };
-        ExecutionResponseDto: {
-            /** @description Execution ID */
-            id: string;
+            memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
             /**
-             * Format: date-time
-             * @description Timestamp when the execution started. Always returned by GET /executions/{executionId}; included in list responses when `expansion=startedAt` is requested.
+             * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
+             * @example 90
              */
-            startedAt?: string;
+            memoryRetentionDays?: number;
+            /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
+            suggestedPrompts?: string[];
             /**
              * Format: date-time
-             * @description Timestamp when the execution stopped. Included when `expansion=stoppedAt` is requested.
+             * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
              */
-            stoppedAt?: string | null;
+            builderSetupCompletedAt?: string | null;
+            /** @description Saved canvas node positions for the agent builder. Included when `expansion=builderCanvasPositions` is requested. */
+            builderCanvasPositions?: {
+                [key: string]: unknown;
+            } | null;
+            /** @description Selected model ID within the AI provider connection. Included when `expansion=selectedModelId` is requested. */
+            selectedModelId?: string | null;
+            /** @description Assigned AI provider connection. Included when `expansion=aiConnection` is requested. */
+            aiConnection?: {
+                id?: string;
+                name?: string;
+                providerConfig?: {
+                    id?: string;
+                    providerSlug?: string;
+                };
+            } | null;
+            /** @description Knowledge notebooks attached to the agent. Included when `expansion=knowledge` is requested. */
+            agentKnowledge?: {
+                id?: string;
+                knowledge?: {
+                    id?: string;
+                    name?: string;
+                };
+            }[];
+            /** @description Object types attached to the agent. Included when `expansion=objectTypes` is requested. */
+            agentObjectTypes?: {
+                id?: string;
+                scope?: string;
+                objectType?: {
+                    id?: string;
+                    name?: string;
+                    slug?: string;
+                    icon?: string | null;
+                    color?: string | null;
+                };
+            }[];
+            /** @description Objects attached to the agent. Included when `expansion=objects` is requested. */
+            agentObjects?: {
+                id?: string;
+                scope?: string;
+                object?: {
+                    id?: string;
+                    name?: string;
+                    state?: string;
+                    objectType?: {
+                        id?: string;
+                        name?: string;
+                        slug?: string;
+                        icon?: string | null;
+                        color?: string | null;
+                    };
+                };
+            }[];
+            /** @description App connections available to the agent. Included when `expansion=connections` is requested. */
+            connections?: {
+                id?: string;
+                name?: string;
+            }[];
+            /** @description Variables attached to the agent. Included when `expansion=variables` is requested. */
+            agentVariables?: {
+                id?: string;
+                variable?: {
+                    id?: string;
+                    name?: string;
+                };
+            }[];
+            /** @description Workflows the agent can trigger. Included when `expansion=workflows` is requested. */
+            agentWorkflows?: {
+                id?: string;
+                workflow?: {
+                    id?: string;
+                    name?: string;
+                };
+            }[];
+            /** @description Sub-agent links for the agent. Included when `expansion=subAgents` is requested. */
+            agentSubAgents?: {
+                id?: string;
+                subagent?: {
+                    id?: string;
+                    name?: string;
+                };
+                parentAgent?: {
+                    id?: string;
+                    name?: string;
+                };
+            }[];
+            /** @description MCP servers attached to the agent, with per-tool overrides. Included when `expansion=mcpServers` is requested. */
+            agentMcpServers?: {
+                id?: string;
+                mcpServer?: {
+                    id?: string;
+                    slug?: string;
+                    name?: string;
+                    provider?: string;
+                    logoUrl?: string | null;
+                    description?: string | null;
+                };
+                toolOverrides?: {
+                    id?: string;
+                    toolName?: string;
+                    enabled?: boolean;
+                    requireApproval?: boolean;
+                }[];
+            }[];
+            /** @description A2A (agent-to-agent) endpoints attached to the agent. Included when `expansion=a2aAgents` is requested. */
+            agentA2aAgents?: {
+                id?: string;
+                a2aAgent?: {
+                    id?: string;
+                    slug?: string;
+                    name?: string;
+                    logoUrl?: string | null;
+                    description?: string | null;
+                    authType?: string;
+                };
+            }[];
+            /** @description Web access configuration. Included when `expansion=webAccess` is requested. */
+            agentWebAccess?: {
+                service?: string;
+                webSearchEnabled?: boolean;
+                websiteAccessEnabled?: boolean;
+            } | null;
+            /** @description Phone access configuration. Included when `expansion=phoneAccess` is requested. */
+            agentPhoneAccess?: {
+                service?: string;
+                outboundCallsEnabled?: boolean;
+                inboundCallsEnabled?: boolean;
+            } | null;
+            /** @description Project the agent belongs to. Included when `expansion=project` is requested. */
+            project?: {
+                id?: string;
+                name?: string;
+            };
+        };
+        UpsertAgentToolDto: {
+            /** @description Workflow app id (catalogue slug). */
+            appId: string;
+            /** @description Catalogue action id. */
+            actionId: string;
+            /** @description Connection instance UUID pre-bound on the tool. */
+            connectionId?: string;
+            /** @description Tool display name for the model. */
+            name?: string;
+            /** @description Tool description shown to the model. */
+            description?: string;
+            /** @description Pre-filled tool config (fields left empty are filled by the model). */
+            input?: {
+                [key: string]: unknown;
+            };
+        };
+        UpsertAgentBySlugDto: {
+            /**
+             * @description Stable project-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
+             * @example support-triage
+             */
+            slug: string;
+            /** @description Display name. Defaults to the slug when omitted. */
+            name?: string;
+            description?: string;
+            /** @description System instructions / prompt for the agent. */
+            instructions: string;
+            /** @description Selected model id on the AI provider connection (e.g. `gpt-4o`). */
+            model: string;
+            /** @description AiProviderConnection UUID. When omitted, platform AI defaults apply. */
+            aiConnectionId?: string;
+            /** @description App Connection UUIDs the agent may use for tools. */
+            connectionIds?: string[];
+            /** @description Workflow UUIDs the agent may run (AgentWorkflow links). */
+            workflowIds?: string[];
+            /** @description Catalogue action tools (WorkflowNodeForRunner-shaped). */
+            tools?: components["schemas"]["UpsertAgentToolDto"][];
+            /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
+            managedByCode?: boolean;
+        };
+        CreateKnowledgeDto: {
+            /** @description Name of the knowledge base. */
+            name: string;
+            /** @description Description of the knowledge base. */
+            description?: string;
+            /** @description Default chunk overlap in words. Must be provided together with chunkSize and cannot exceed 50% of it. */
+            chunkOverlap?: number;
+            /** @description Default chunk size in words (50 to 2000). Must be provided together with chunkOverlap. */
+            chunkSize?: number;
+            /** @description Embedding model to use. Defaults to the platform-configured embedding model. */
+            embeddingModel?: string;
+            /** @description Embedding provider to use. Defaults to the platform-configured embedding provider. */
+            embeddingProvider?: string;
+            /** @description Embedding vector dimensions. Defaults to the platform-configured dimensions. */
+            dimensions?: number;
+        };
+        KnowledgeCountDto: {
+            /** @description Number of vector references stored in this knowledge base. */
+            vectorRefs: number;
+        };
+        KnowledgeVectorRefSummaryDto: {
+            /** @description Vector reference ID. */
+            id: string;
+            /** @description ID of the knowledge base the vector reference belongs to. */
+            FK_knowledgeId: string;
+        };
+        KnowledgeUsageDto: {
+            /** @description Total prompt tokens consumed when embedding content into this knowledge base. */
+            promptTokens: number;
+        };
+        KnowledgeWorkspaceDto: {
+            /** @description Workspace ID. */
+            id: string;
+            /** @description Workspace name. */
+            name: string;
+        };
+        KnowledgeResponseDto: {
+            /** @description Knowledge base ID. */
+            id: string;
+            /** @description Knowledge base name. */
+            name: string;
+            /** @description Knowledge base description. Included when `expansion=description` is requested. */
+            description?: string;
             /**
              * Format: date-time
              * @description Creation timestamp. Included when `expansion=createdAt` is requested.
@@ -1533,110 +1704,101 @@ interface components {
              * Format: date-time
              * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
              */
-            updatedAt?: string | null;
-            /** @description Sequential execution number within the workflow. Included when `expansion=executionNumber` is requested. */
-            executionNumber?: number;
-            /** @description Raw execution node state (JSON). Included when `expansion=nodes` is requested. Most integrations should prefer the `executionPath` expansion instead. */
-            nodes?: {
-                [key: string]: unknown;
-            }[];
-            /** @description Raw execution edge state (JSON). Included when `expansion=edges` is requested. */
-            edges?: {
-                [key: string]: unknown;
-            }[];
-            /**
-             * @description Overall execution status. Included when `expansion=status` is requested.
-             * @enum {string}
-             */
-            status?: "RUNNING" | "SUCCESS" | "FAILED" | "NEEDS_INPUT" | "SCHEDULED" | "CANCELLED" | "WAITING";
-            /** @description Human-readable status detail. Included when `expansion=statusMessage` is requested. */
-            statusMessage?: string | null;
-            /** @description Final output of the execution (JSON). Included when `expansion=output` is requested. */
-            output?: {
-                [key: string]: unknown;
-            } | null;
+            updatedAt?: string;
+            /** @description Name of the underlying vector index collection. Included when `expansion=indexName` is requested. */
+            indexName?: string;
+            /** @description Default chunk size in words used when uploading text. Included when `expansion=chunkSize` is requested. */
+            chunkSize?: number;
+            /** @description Default chunk overlap in words used when uploading text. Included when `expansion=chunkOverlap` is requested. */
+            chunkOverlap?: number;
+            /** @description Embedding model used for this knowledge base. Included when `expansion=embeddingModel` is requested. */
+            embeddingModel?: string;
+            /** @description Embedding provider used for this knowledge base. Included when `expansion=embeddingProvider` is requested. */
+            embeddingProvider?: string;
+            /** @description Embedding vector dimensions. Included when `expansion=dimensions` is requested. */
+            dimensions?: number;
+            /** @description Aggregate counts. Included when `expansion=countVectorRefs` is requested. */
+            _count?: components["schemas"]["KnowledgeCountDto"];
+            /** @description Vector references stored in this knowledge base. Included when `expansion=vectorRefs` is requested. */
+            vectorRefs?: components["schemas"]["KnowledgeVectorRefSummaryDto"][];
+            /** @description Embedding token usage. Included when `expansion=usage` is requested. */
+            usage?: components["schemas"]["KnowledgeUsageDto"];
+            /** @description Owning workspace. Included when `expansion=workspace` is requested. */
+            workspace?: components["schemas"]["KnowledgeWorkspaceDto"];
+        };
+        UpdateKnowledgeDto: {
+            /** @description Name of the knowledge base. */
+            name?: string;
+            /** @description Description of the knowledge base. */
+            description?: string;
+            /** @description Default chunk overlap in words. Must be provided together with chunkSize and cannot exceed 50% of it. */
+            chunkOverlap?: number;
+            /** @description Default chunk size in words (50 to 2000). Must be provided together with chunkOverlap. */
+            chunkSize?: number;
+            /** @description Embedding model to use. Defaults to the platform-configured embedding model. */
+            embeddingModel?: string;
+            /** @description Embedding provider to use. Defaults to the platform-configured embedding provider. */
+            embeddingProvider?: string;
+            /** @description Embedding vector dimensions. Defaults to the platform-configured dimensions. */
+            dimensions?: number;
+        };
+        SaveUploadedTextToKnowledgeDto: {
+            /** @description Name of the document. Multi-part uploads are suffixed with the part number. */
+            name: string;
+            /** @description Raw text content to embed into the knowledge base. */
+            text: string;
+            /** @description Chunk overlap in words. Roughly 10% of chunkSize is recommended. */
+            chunkOverlap: number;
+            /** @description Chunk size in words used to split the text before embedding. */
+            chunkSize: number;
+        };
+        KnowledgeDocumentResponseDto: {
+            /** @description Document ID. For `group` documents this is the vector reference group ID; for `standalone` documents it is the vector reference ID. */
+            id: string;
+            /** @description Document name. */
+            name: string;
             /**
              * Format: date-time
-             * @description Timestamp when a waiting execution is scheduled to continue. Included when `expansion=continueExecutionAt` is requested.
-             */
-            continueExecutionAt?: string | null;
-            /**
-             * @description Editor orientation of the workflow canvas at execution time. Included when `expansion=orientation` is requested.
-             * @enum {string}
+             * @description Creation timestamp.
              */
-            workflowOrientation?: "HORIZONTAL" | "VERTICAL";
-            /** @description Variables captured during the execution (JSON). Included when `expansion=executionVariables` is requested. */
-            executionVariables?: {
-                [key: string]: unknown;
-            } | null;
-            /** @description The workflow the execution belongs to. Included when `expansion=workflow` is requested. */
-            workflow?: components["schemas"]["ExecutionWorkflowSummaryDto"];
-            /** @description Business-readable, ordered representation of the executed (or queued) steps, derived from the raw node and edge state: step labels, per-step status (including NEEDS_INPUT for steps paused awaiting user input), start and end timings, and loop iteration metadata. Custom UIs render execution progress from this field. Included when `expansion=executionPath` is requested. Only returned by GET /executions/{executionId}. */
-            executionPath?: components["schemas"]["ExecutionPathStepDto"][];
-            /** @description Field schemas for steps currently paused in NEEDS_INPUT. Each entry includes the waiting nodeId, label, optional instructions, and the fields to collect. Submit values keyed by field id to POST /api/webhooks/executions/{executionId}/nodes/{nodeId}/input. Included when `expansion=pendingInput` is requested. Only returned by GET /executions/{executionId}. Null when no step is waiting for input. */
-            pendingInput?: components["schemas"]["PendingInputDto"][] | null;
+            createdAt: string;
+            /** @description Number of parts (chunks) the document was split into. */
+            partCount: number;
             /**
-             * @description How the execution was started. `WORKFLOW` for graph runs; `SDK` for ad-hoc single-action runs from the Public API / client SDK. Included when `expansion=source` is requested.
+             * @description Whether the document is a multi-part group or a standalone single-part upload.
              * @enum {string}
              */
-            source?: "WORKFLOW" | "SDK";
-            /** @description Optional display name (set for ad-hoc SDK runs). Included when `expansion=name` is requested. */
-            name?: string | null;
+            type: "group" | "standalone";
         };
-        RunActionDto: {
-            /** @description Workflow app id (catalogue slug), e.g. `http`, `gmail`. */
-            appId: string;
-            /** @description Action id within the app, e.g. `http_action_send-request`. Discover via GET /workflow-apps (`actions[].id` / `inputConfig`). */
-            actionId: string;
-            /** @description Connection instance UUID (`Connection.id`). Required when the action needs a connection and the workspace has more than one connection for the app with no single workspace default. When omitted: sole usable connection for the app is used; else the workspace default (`isDefault`); else 400 with candidates. Never silently picks among multiple non-default connections. */
-            connectionId?: string;
-            /** @description Project UUID used for variable/project scoping. When omitted and the workspace has exactly one project, that project is used; otherwise the request fails with 400. */
-            projectId?: string;
-            /** @description Action input fields (mirrors the action `inputConfig` keys). Combined with `connectionId` into the action configValue. */
-            input?: {
-                [key: string]: unknown;
-            };
-            /** @description Optional display name for the ad-hoc Execution. */
-            name?: string;
+        KnowledgeDocumentGroupVectorRefDto: {
+            /** @description Vector reference ID. */
+            id: string;
+            /** @description Vector reference name, including the part suffix for multi-part uploads. */
+            name: string;
+            /**
+             * Format: date-time
+             * @description Creation timestamp.
+             */
+            createdAt: string;
+            /** @description Part number within the group, or null for single-part uploads. */
+            part: number | null;
+            /** @description Storage path of the raw text for this part. */
+            s3Link: string | null;
         };
-        RunActionResponseDto: {
-            /** @description ID of the ad-hoc Execution. Use GET /executions/{executionId} (with expansion=executionPath) to re-read progress. */
+        KnowledgeDocumentGroupResponseDto: {
+            /** @description Document group ID. */
             id: string;
+            /** @description Document group name, or null for legacy groups without a stored name. */
+            name: string | null;
             /**
-             * @description Final execution status after the single action step.
-             * @enum {string}
+             * Format: date-time
+             * @description Creation timestamp.
              */
-            status: "RUNNING" | "SUCCESS" | "FAILED" | "NEEDS_INPUT" | "SCHEDULED" | "CANCELLED" | "WAITING";
-            /** @description Human-readable status detail. */
-            statusMessage?: string | null;
-            /** @description Action output on success (same shape as a workflow step output). Null on failure or when the run paused. */
-            output?: {
-                [key: string]: unknown;
-            } | null;
-            /** @description Single-step executionPath for the ad-hoc run (label, status, timings). */
-            executionPath?: components["schemas"]["ExecutionPathStepDto"][];
-        };
-        RunStepDto: {
-            /** @description Workflow app id (catalogue slug), e.g. `http`, `gmail`. */
-            appId: string;
-            /** @description Action id within the app, e.g. `http_action_send-request`. Discover via GET /workflow-apps. */
-            actionId: string;
-            /** @description Connection instance UUID. When omitted, the platform resolves: sole usable connection for the app, else the workspace default (`isDefault`), else 400 with candidates. */
-            connectionId?: string;
-            /** @description Action input fields (mirrors the action `inputConfig` keys). */
-            input?: {
-                [key: string]: unknown;
-            };
-            /** @description Optional display name for this step. */
-            name?: string;
-        };
-        StartRunDto: {
-            /** @description Linear catalogue-action steps. Executed as one multi-step Execution with `source: SDK` (not a soft batch / correlation id). */
-            steps: components["schemas"]["RunStepDto"][];
-            /** @description Project UUID for variable/project scoping. When omitted and the workspace has exactly one project, that project is used. */
-            projectId?: string;
-            /** @description Optional display name for the ad-hoc Execution. */
-            name?: string;
+            createdAt: string;
+            /** @description ID of the knowledge base the group belongs to, or null for legacy groups. */
+            FK_knowledgeId: string | null;
+            /** @description Vector references (parts) in the group, ordered by part number. */
+            vectorRefs: components["schemas"]["KnowledgeDocumentGroupVectorRefDto"][];
         };
         CreateVariableDto: {
             /** @description Name of the variable. */
@@ -1756,287 +1918,237 @@ interface components {
             /** @description Owning workspace. Included when `expansion=workspace` is requested. */
             workspace?: components["schemas"]["ConnectionWorkspaceDto"];
         };
-        AgentResponseDto: {
+        ManuallyRunWorkflowInputDataDto: {
             /**
-             * @description Agent ID (UUID)
-             * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
+             * @description Values for the custom input fields configured on the workflow "Manually Run" trigger, keyed by field ID. Pass an empty object when the trigger defines no custom input fields.
+             * @example {
+             *       "customerEmail": "jane@example.com",
+             *       "priority": "high"
+             *     }
              */
+            inputData: {
+                [key: string]: unknown;
+            };
+        };
+        ExecuteWorkflowResponseDto: {
+            /** @description ID of the newly created execution. Poll GET /executions/{executionId} to track progress. */
             id: string;
-            /**
-             * @description Agent name
-             * @example Invoice Triage Agent
-             */
+        };
+        ExecutionWorkspaceSummaryDto: {
+            /** @description Workspace ID */
+            id: string;
+            /** @description Workspace name */
             name: string;
-            /** @description Stable project-scoped slug for CLI / code deploy upserts. Included when `expansion=slug` is requested. */
-            slug?: string | null;
-            /** @description True when last written by code (CLI / SDK). Included when `expansion=managedByCode` is requested. */
-            managedByCode?: boolean;
-            /** @description ID of the AI provider connection assigned to the agent. Always included. Null when the agent falls back to the workspace default connection. */
-            FK_aiConnectionId: string | null;
-            /** @description Agent description. Included when `expansion=description` is requested. */
-            description?: string | null;
-            /** @description Public URL of the agent profile image. Included when `expansion=profileImageUrl` is requested. */
-            profileImageUrl?: string | null;
-            /**
-             * Format: date-time
-             * @description Creation timestamp. Included when `expansion=createdAt` is requested.
-             */
-            createdAt?: string;
-            /**
-             * Format: date-time
-             * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
-             */
-            updatedAt?: string;
-            /** @description System instructions authored for the agent. Included when `expansion=instructions` is requested. */
-            instructions?: string | null;
+        };
+        ExecutionProjectSummaryDto: {
+            /** @description Project ID */
+            id: string;
+            /** @description Project name */
+            name: string;
+            /** @description The workspace the project belongs to. Included when `expansion=workspace` is requested alongside `workflow` and `project`. */
+            workspace?: components["schemas"]["ExecutionWorkspaceSummaryDto"];
+        };
+        ExecutionWorkflowSummaryDto: {
+            /** @description Workflow ID */
+            id: string;
+            /** @description Workflow name */
+            name: string;
+            /** @description The project the workflow belongs to. Included when `expansion=project` is requested alongside `workflow`. */
+            project?: components["schemas"]["ExecutionProjectSummaryDto"];
+        };
+        ExecutionPathStepDto: {
+            /** @description ID of the workflow node this step represents */
+            nodeId: string;
+            /** @description Human-friendly node name */
+            label: string;
+            /** @description ID of the app the node belongs to */
+            appId: string;
+            /** @description Action ID, present when the step is an action node */
+            actionId?: string;
+            /** @description Trigger ID, present when the step is the trigger node */
+            triggerId?: string;
             /**
-             * @description Model temperature. Included when `expansion=temperature` is requested.
-             * @example 1
+             * @description Step status. NEEDS_INPUT indicates the step is paused waiting for user input.
+             * @enum {string}
              */
-            temperature?: number;
-            /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
-            maxOutputTokens?: number | null;
+            status: "RUNNING" | "SUCCESS" | "FAILED" | "NEEDS_INPUT" | "SCHEDULED" | "RETRYING" | "WAITING";
+            /** @description Status detail message for the step */
+            statusMessage?: string;
+            /** @description Timestamp when the step started */
+            startTime?: string;
+            /** @description Timestamp when the step finished */
+            endTime?: string;
+            /** @description nodeId this step is an iteration of (set on loop child entries) */
+            iterationOf?: string;
+            /** @description Index of the loop iteration this step belongs to */
+            iterationIndex?: number;
+            /** @description On the collapsed loop parent entry: how many times the loop ran (or is planned to run) */
+            iterationCount?: number;
             /**
-             * @description Top-p sampling. Included when `expansion=topP` is requested.
-             * @example 1
+             * @description Approval status when this step is a Request Approval node awaiting or past a decision
+             * @enum {string}
              */
-            topP?: number;
+            approvalStatus?: "pending" | "partially_approved" | "approved" | "rejected" | "expired";
+            /** @description Number of approve decisions received so far */
+            approvalsReceived?: number;
+            /** @description Number of approvals required for quorum / current stage */
+            approvalsRequired?: number;
+        };
+        PendingInputFieldDto: {
+            /** @description Field ID used as the key when submitting input */
+            id: string;
+            /** @description Human-readable field label */
+            label: string;
+            /** @description Field input type from the workflow builder (e.g. text, number, select) */
+            inputType: string;
+            /** @description Whether the field must be provided to resume */
+            required: boolean;
+            /** @description Optional helper text for the field */
+            description?: string;
+            /** @description Selectable options when the field is a select-like input */
+            options?: {
+                label?: string;
+                value?: string;
+            }[];
+        };
+        PendingInputDto: {
+            /** @description ID of the waiting workflow node */
+            nodeId: string;
+            /** @description Human-friendly node name */
+            label: string;
+            /** @description Action ID of the waiting node, when it is an action step */
+            actionId?: string;
+            /** @description Optional instructions configured on the waiting node */
+            instructions?: string;
+            /** @description Fields the custom UI should collect. Submit values keyed by field `id` to POST /api/webhooks/executions/{executionId}/nodes/{nodeId}/input. */
+            fields: components["schemas"]["PendingInputFieldDto"][];
+        };
+        ExecutionResponseDto: {
+            /** @description Execution ID */
+            id: string;
             /**
-             * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
-             * @example 0
+             * Format: date-time
+             * @description Timestamp when the execution started. Always returned by GET /executions/{executionId}; included in list responses when `expansion=startedAt` is requested.
              */
-            frequencyPenalty?: number;
+            startedAt?: string;
             /**
-             * @description Presence penalty. Included when `expansion=presencePenalty` is requested.
-             * @example 0
+             * Format: date-time
+             * @description Timestamp when the execution stopped. Included when `expansion=stoppedAt` is requested.
              */
-            presencePenalty?: number;
+            stoppedAt?: string | null;
             /**
-             * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
-             * @example 0
+             * Format: date-time
+             * @description Creation timestamp. Included when `expansion=createdAt` is requested.
              */
-            maxRetries?: number;
-            /** @description Fixed sampling seed. Included when `expansion=seed` is requested. */
-            seed?: number | null;
+            createdAt?: string;
             /**
-             * @description Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
-             * @example 5
+             * Format: date-time
+             * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
              */
-            maxToolRoundtrips?: number;
+            updatedAt?: string | null;
+            /** @description Sequential execution number within the workflow. Included when `expansion=executionNumber` is requested. */
+            executionNumber?: number;
+            /** @description Raw execution node state (JSON). Included when `expansion=nodes` is requested. Most integrations should prefer the `executionPath` expansion instead. */
+            nodes?: {
+                [key: string]: unknown;
+            }[];
+            /** @description Raw execution edge state (JSON). Included when `expansion=edges` is requested. */
+            edges?: {
+                [key: string]: unknown;
+            }[];
             /**
-             * @description How many previous messages are sent to the model. Included when `expansion=messageLookbackLimit` is requested.
-             * @example 40
+             * @description Overall execution status. Included when `expansion=status` is requested.
+             * @enum {string}
              */
-            messageLookbackLimit?: number;
-            /** @description Configured tool nodes (app actions) for the agent. Included when `expansion=tools` is requested. */
-            tools?: {
-                [key: string]: unknown;
-            }[] | null;
-            /** @description Action IDs of the configured tools. Included when `expansion=toolIds` is requested. */
-            toolIds?: string[];
-            /** @description Instructions used when auto-naming new tasks. Included when `expansion=taskNamingInstructions` is requested. */
-            taskNamingInstructions?: string | null;
-            /** @description IDs of enabled provider built-in tools. Included when `expansion=enabledBuiltInTools` is requested. */
-            enabledBuiltInTools?: string[];
-            /** @description IDs of enabled platform tools. Included when `expansion=enabledPlatformTools` is requested. */
-            enabledPlatformTools?: string[];
-            /** @description Whether dynamic workflow-app action discovery is enabled. Included when `expansion=dynamicActionDiscoveryEnabled` is requested. */
-            dynamicActionDiscoveryEnabled?: boolean;
-            /** @description Whether dynamic MCP server discovery is enabled. Included when `expansion=dynamicMcpDiscoveryEnabled` is requested. */
-            dynamicMcpDiscoveryEnabled?: boolean;
-            /** @description Whether the agent maintains its own instructions. Included when `expansion=dynamicSelfInstructionsEnabled` is requested. */
-            dynamicSelfInstructionsEnabled?: boolean;
-            /** @description Whether long-term memory is enabled. Included when `expansion=memoryEnabled` is requested. */
-            memoryEnabled?: boolean;
+            status?: "RUNNING" | "SUCCESS" | "FAILED" | "NEEDS_INPUT" | "SCHEDULED" | "CANCELLED" | "WAITING";
+            /** @description Human-readable status detail. Included when `expansion=statusMessage` is requested. */
+            statusMessage?: string | null;
+            /** @description Final output of the execution (JSON). Included when `expansion=output` is requested. */
+            output?: {
+                [key: string]: unknown;
+            } | null;
             /**
-             * @description Memory partitioning scope. Included when `expansion=memoryScope` is requested.
+             * Format: date-time
+             * @description Timestamp when a waiting execution is scheduled to continue. Included when `expansion=continueExecutionAt` is requested.
+             */
+            continueExecutionAt?: string | null;
+            /**
+             * @description Editor orientation of the workflow canvas at execution time. Included when `expansion=orientation` is requested.
              * @enum {string}
              */
-            memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
+            workflowOrientation?: "HORIZONTAL" | "VERTICAL";
+            /** @description Variables captured during the execution (JSON). Included when `expansion=executionVariables` is requested. */
+            executionVariables?: {
+                [key: string]: unknown;
+            } | null;
+            /** @description The workflow the execution belongs to. Included when `expansion=workflow` is requested. */
+            workflow?: components["schemas"]["ExecutionWorkflowSummaryDto"];
+            /** @description Business-readable, ordered representation of the executed (or queued) steps, derived from the raw node and edge state: step labels, per-step status (including NEEDS_INPUT for steps paused awaiting user input), start and end timings, and loop iteration metadata. Custom UIs render execution progress from this field. Included when `expansion=executionPath` is requested. Only returned by GET /executions/{executionId}. */
+            executionPath?: components["schemas"]["ExecutionPathStepDto"][];
+            /** @description Field schemas for steps currently paused in NEEDS_INPUT. Each entry includes the waiting nodeId, label, optional instructions, and the fields to collect. Submit values keyed by field id to POST /api/webhooks/executions/{executionId}/nodes/{nodeId}/input. Included when `expansion=pendingInput` is requested. Only returned by GET /executions/{executionId}. Null when no step is waiting for input. */
+            pendingInput?: components["schemas"]["PendingInputDto"][] | null;
             /**
-             * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
-             * @example 90
+             * @description How the execution was started. `WORKFLOW` for graph runs; `SDK` for ad-hoc single-action runs from the Public API / client SDK. Included when `expansion=source` is requested.
+             * @enum {string}
              */
-            memoryRetentionDays?: number;
-            /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
-            suggestedPrompts?: string[];
+            source?: "WORKFLOW" | "SDK";
+            /** @description Optional display name (set for ad-hoc SDK runs). Included when `expansion=name` is requested. */
+            name?: string | null;
+        };
+        RunActionDto: {
+            /** @description Workflow app id (catalogue slug), e.g. `http`, `gmail`. */
+            appId: string;
+            /** @description Action id within the app, e.g. `http_action_send-request`. Discover via GET /workflow-apps (`actions[].id` / `inputConfig`). */
+            actionId: string;
+            /** @description Connection instance UUID (`Connection.id`). Required when the action needs a connection and the workspace has more than one connection for the app with no single workspace default. When omitted: sole usable connection for the app is used; else the workspace default (`isDefault`); else 400 with candidates. Never silently picks among multiple non-default connections. */
+            connectionId?: string;
+            /** @description Project UUID used for variable/project scoping. When omitted and the workspace has exactly one project, that project is used; otherwise the request fails with 400. */
+            projectId?: string;
+            /** @description Action input fields (mirrors the action `inputConfig` keys). Combined with `connectionId` into the action configValue. */
+            input?: {
+                [key: string]: unknown;
+            };
+            /** @description Optional display name for the ad-hoc Execution. */
+            name?: string;
+        };
+        RunActionResponseDto: {
+            /** @description ID of the ad-hoc Execution. Use GET /executions/{executionId} (with expansion=executionPath) to re-read progress. */
+            id: string;
             /**
-             * Format: date-time
-             * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
+             * @description Final execution status after the single action step.
+             * @enum {string}
              */
-            builderSetupCompletedAt?: string | null;
-            /** @description Saved canvas node positions for the agent builder. Included when `expansion=builderCanvasPositions` is requested. */
-            builderCanvasPositions?: {
+            status: "RUNNING" | "SUCCESS" | "FAILED" | "NEEDS_INPUT" | "SCHEDULED" | "CANCELLED" | "WAITING";
+            /** @description Human-readable status detail. */
+            statusMessage?: string | null;
+            /** @description Action output on success (same shape as a workflow step output). Null on failure or when the run paused. */
+            output?: {
                 [key: string]: unknown;
             } | null;
-            /** @description Selected model ID within the AI provider connection. Included when `expansion=selectedModelId` is requested. */
-            selectedModelId?: string | null;
-            /** @description Assigned AI provider connection. Included when `expansion=aiConnection` is requested. */
-            aiConnection?: {
-                id?: string;
-                name?: string;
-                providerConfig?: {
-                    id?: string;
-                    providerSlug?: string;
-                };
-            } | null;
-            /** @description Knowledge notebooks attached to the agent. Included when `expansion=knowledge` is requested. */
-            agentKnowledge?: {
-                id?: string;
-                knowledge?: {
-                    id?: string;
-                    name?: string;
-                };
-            }[];
-            /** @description Object types attached to the agent. Included when `expansion=objectTypes` is requested. */
-            agentObjectTypes?: {
-                id?: string;
-                scope?: string;
-                objectType?: {
-                    id?: string;
-                    name?: string;
-                    slug?: string;
-                    icon?: string | null;
-                    color?: string | null;
-                };
-            }[];
-            /** @description Objects attached to the agent. Included when `expansion=objects` is requested. */
-            agentObjects?: {
-                id?: string;
-                scope?: string;
-                object?: {
-                    id?: string;
-                    name?: string;
-                    state?: string;
-                    objectType?: {
-                        id?: string;
-                        name?: string;
-                        slug?: string;
-                        icon?: string | null;
-                        color?: string | null;
-                    };
-                };
-            }[];
-            /** @description App connections available to the agent. Included when `expansion=connections` is requested. */
-            connections?: {
-                id?: string;
-                name?: string;
-            }[];
-            /** @description Variables attached to the agent. Included when `expansion=variables` is requested. */
-            agentVariables?: {
-                id?: string;
-                variable?: {
-                    id?: string;
-                    name?: string;
-                };
-            }[];
-            /** @description Workflows the agent can trigger. Included when `expansion=workflows` is requested. */
-            agentWorkflows?: {
-                id?: string;
-                workflow?: {
-                    id?: string;
-                    name?: string;
-                };
-            }[];
-            /** @description Sub-agent links for the agent. Included when `expansion=subAgents` is requested. */
-            agentSubAgents?: {
-                id?: string;
-                subagent?: {
-                    id?: string;
-                    name?: string;
-                };
-                parentAgent?: {
-                    id?: string;
-                    name?: string;
-                };
-            }[];
-            /** @description MCP servers attached to the agent, with per-tool overrides. Included when `expansion=mcpServers` is requested. */
-            agentMcpServers?: {
-                id?: string;
-                mcpServer?: {
-                    id?: string;
-                    slug?: string;
-                    name?: string;
-                    provider?: string;
-                    logoUrl?: string | null;
-                    description?: string | null;
-                };
-                toolOverrides?: {
-                    id?: string;
-                    toolName?: string;
-                    enabled?: boolean;
-                    requireApproval?: boolean;
-                }[];
-            }[];
-            /** @description A2A (agent-to-agent) endpoints attached to the agent. Included when `expansion=a2aAgents` is requested. */
-            agentA2aAgents?: {
-                id?: string;
-                a2aAgent?: {
-                    id?: string;
-                    slug?: string;
-                    name?: string;
-                    logoUrl?: string | null;
-                    description?: string | null;
-                    authType?: string;
-                };
-            }[];
-            /** @description Web access configuration. Included when `expansion=webAccess` is requested. */
-            agentWebAccess?: {
-                service?: string;
-                webSearchEnabled?: boolean;
-                websiteAccessEnabled?: boolean;
-            } | null;
-            /** @description Phone access configuration. Included when `expansion=phoneAccess` is requested. */
-            agentPhoneAccess?: {
-                service?: string;
-                outboundCallsEnabled?: boolean;
-                inboundCallsEnabled?: boolean;
-            } | null;
-            /** @description Project the agent belongs to. Included when `expansion=project` is requested. */
-            project?: {
-                id?: string;
-                name?: string;
-            };
+            /** @description Single-step executionPath for the ad-hoc run (label, status, timings). */
+            executionPath?: components["schemas"]["ExecutionPathStepDto"][];
         };
-        UpsertAgentToolDto: {
-            /** @description Workflow app id (catalogue slug). */
+        RunStepDto: {
+            /** @description Workflow app id (catalogue slug), e.g. `http`, `gmail`. */
             appId: string;
-            /** @description Catalogue action id. */
+            /** @description Action id within the app, e.g. `http_action_send-request`. Discover via GET /workflow-apps. */
             actionId: string;
-            /** @description Connection instance UUID pre-bound on the tool. */
+            /** @description Connection instance UUID. When omitted, the platform resolves: sole usable connection for the app, else the workspace default (`isDefault`), else 400 with candidates. */
             connectionId?: string;
-            /** @description Tool display name for the model. */
-            name?: string;
-            /** @description Tool description shown to the model. */
-            description?: string;
-            /** @description Pre-filled tool config (fields left empty are filled by the model). */
+            /** @description Action input fields (mirrors the action `inputConfig` keys). */
             input?: {
                 [key: string]: unknown;
             };
+            /** @description Optional display name for this step. */
+            name?: string;
         };
-        UpsertAgentBySlugDto: {
-            /**
-             * @description Stable project-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
-             * @example support-triage
-             */
-            slug: string;
-            /** @description Display name. Defaults to the slug when omitted. */
+        StartRunDto: {
+            /** @description Linear catalogue-action steps. Executed as one multi-step Execution with `source: SDK` (not a soft batch / correlation id). */
+            steps: components["schemas"]["RunStepDto"][];
+            /** @description Project UUID for variable/project scoping. When omitted and the workspace has exactly one project, that project is used. */
+            projectId?: string;
+            /** @description Optional display name for the ad-hoc Execution. */
             name?: string;
-            description?: string;
-            /** @description System instructions / prompt for the agent. */
-            instructions: string;
-            /** @description Selected model id on the AI provider connection (e.g. `gpt-4o`). */
-            model: string;
-            /** @description AiProviderConnection UUID. When omitted, platform AI defaults apply. */
-            aiConnectionId?: string;
-            /** @description App Connection UUIDs the agent may use for tools. */
-            connectionIds?: string[];
-            /** @description Workflow UUIDs the agent may run (AgentWorkflow links). */
-            workflowIds?: string[];
-            /** @description Catalogue action tools (WorkflowNodeForRunner-shaped). */
-            tools?: components["schemas"]["UpsertAgentToolDto"][];
-            /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
-            managedByCode?: boolean;
         };
         TaskListItemResponseDto: {
             /**
@@ -2183,6 +2295,8 @@ interface components {
              * @example Conversation covering the Q3 regional sales report
              */
             description?: string;
+            /** @description Approve (true) or clear (false) the current runtime plan for plan-before-execute gating. */
+            approvePlan?: boolean;
         };
         DeletedTaskResponseDto: {
             /**
@@ -2256,6 +2370,10 @@ interface components {
              *     }
              */
             data?: Record<string, never>;
+            /** @description Solution Designer handoff */
+            solutionId?: string;
+            planStepId?: string;
+            delegationId?: string;
         };
         StreamMessageStopDto: {
             /** @description Partial assistant message to persist when stopping a stream */
@@ -2319,6 +2437,7 @@ type UpdateQueueInput = Schemas['UpdateQueueDto'];
 type QueueStats = Schemas['QueueStatsResponseDto'];
 type QueueItem = Schemas['QueueItemResponseDto'];
 type QueueItemFull = Schemas['QueueItemFullResponseDto'];
+type QueueItemCreated = Schemas['QueueItemCreateResponseDto'];
 type CreateQueueItemInput = Schemas['CreateQueueItemDto'];
 type UpdateQueueItemInput = Schemas['UpdateQueueItemDto'];
 type QueueItemList = Schemas['QueueItemListResponseDto'];
@@ -2561,6 +2680,7 @@ declare const DEFINE_KINDS: {
     readonly action: "action";
     readonly workflow: "workflow";
     readonly agent: "agent";
+    readonly entityType: "entityType";
 };
 /** Ref to an existing app Connection (credentials stay on Lunnoa). */
 interface ConnectionDefinition {
@@ -2627,6 +2747,25 @@ interface AgentDefinition {
     /** Action and/or workflow tool refs. */
     tools?: AgentToolDefinition[];
 }
+interface EntityTypeDefinition {
+    kind: typeof DEFINE_KINDS.entityType;
+    /** Stable workspace-scoped slug (upsert key). */
+    slug: string;
+    name?: string;
+    namePlural?: string;
+    description?: string;
+    icon?: string;
+    color?: string;
+    /** Field definitions grouped into sections (same contract as Adminspace). */
+    attributeSchema: Record<string, unknown>;
+    stateSchema?: Record<string, unknown> | null;
+    isEnabled?: boolean;
+    /**
+     * When false (default), entity writes reject undeclared attribute keys.
+     * Reserved key `extensions` is always allowed as a JSON object.
+     */
+    allowUnknownAttributes?: boolean;
+}
 
 interface UpsertAgentToolInput {
     appId: string;
@@ -2920,6 +3059,20 @@ interface EntityTypeReadOptions {
     /** Fields to expand, e.g. `['attributeSchema', 'stateSchema', 'description']`. */
     expansion?: string | string[];
 }
+/** Payload for `POST /api/object-types/upsert`. */
+interface UpsertEntityTypeBySlugInput {
+    slug: string;
+    name?: string;
+    namePlural?: string;
+    description?: string;
+    icon?: string;
+    color?: string;
+    attributeSchema: Record<string, unknown>;
+    stateSchema?: Record<string, unknown> | null;
+    isEnabled?: boolean;
+    allowUnknownAttributes?: boolean;
+    managedByCode?: boolean;
+}
 declare class EntityTypesResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -2935,6 +3088,11 @@ declare class EntityTypesResource {
     get(id: string, options?: EntityTypeReadOptions): Promise<EntityType>;
     /** Returns a single entity type by its URL-safe slug. */
     getBySlug(slug: string, options?: EntityTypeReadOptions): Promise<EntityType>;
+    /**
+     * Creates or updates an entity type by workspace-scoped slug.
+     * Prefer the CLI (`npx @lunnoa/client entity-types deploy`) for happy-path deploy.
+     */
+    upsertBySlug(definition: EntityTypeDefinition | UpsertEntityTypeBySlugInput): Promise<EntityType>;
 }
 
 type EligibleApprover = {
@@ -3042,8 +3200,15 @@ interface ListQueueItemsOptions {
     limit?: number;
     offset?: number;
     expansion?: string | string[];
+    /** Supports keys including `status`, `externalId`, `objectId`, `priority`. */
     filterBy?: string | Record<string, string>;
 }
+interface ListQueueItemsByObjectOptions {
+    status?: string;
+    limit?: number;
+    offset?: number;
+    expansion?: string | string[];
+}
 declare class QueueItemsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -3053,8 +3218,15 @@ declare class QueueItemsResource {
     iterate(queueId: string, options?: Omit<ListQueueItemsOptions, 'offset'>): AsyncGenerator<QueueItem, void, undefined>;
     /** Returns a single queue item. */
     get(queueId: string, itemId: string): Promise<QueueItemFull>;
-    /** Adds an item to a queue. */
-    create(queueId: string, data: CreateQueueItemInput): Promise<QueueItem>;
+    /** Adds an item to a queue. Pass `objectId` to link the item to an entity. */
+    create(queueId: string, data: CreateQueueItemInput): Promise<QueueItemCreated>;
+    /**
+     * Lists queue items linked to an Object across all queues in the workspace.
+     * Use for Object detail "Work" panels.
+     */
+    listByObject(objectId: string, options?: ListQueueItemsByObjectOptions): Promise<QueueItemList>;
+    /** Async-iterates every queue item linked to an Object. */
+    iterateByObject(objectId: string, options?: Omit<ListQueueItemsByObjectOptions, 'offset'>): AsyncGenerator<QueueItem, void, undefined>;
     /** Adds many items to a queue in one call. */
     bulkCreate(queueId: string, data: BulkCreateQueueItemsInput): Promise<BulkCreateQueueItemsResult>;
     /** Updates a queue item. */