@lunnoa/client 0.0.0-development → 1.0.0

package/dist/react.d.ts

@@ -297,6 +297,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 +340,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 +393,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 +413,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 +435,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 +483,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 +570,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 +592,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 +656,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 +708,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 +800,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,233 +967,515 @@ 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: {
-                [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;
-            }[];
-        };
-        ObjectTypeUserSummaryDto: {
-            /** @description User ID. */
-            id: string;
-            /** @description Email address of the user. */
-            email: string;
-            /** @description Display name of the user. */
-            name: string;
-        };
-        ObjectTypeCreatedByDto: {
-            /** @description Workspace user ID. */
-            id: string;
-            user: components["schemas"]["ObjectTypeUserSummaryDto"];
-        };
-        ObjectTypeCountDto: {
-            /** @description Number of non-deleted entities of this type. */
-            objects: number;
-        };
-        ObjectTypeResponseDto: {
-            /** @description Entity type ID. */
+        AgentResponseDto: {
+            /**
+             * @description Agent ID (UUID)
+             * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
+             */
             id: string;
-            /** @description Singular display name of the entity type. */
+            /**
+             * @description Agent name
+             * @example Invoice Triage Agent
+             */
             name: string;
-            /** @description Plural display name of the entity type. */
-            namePlural: string;
-            /** @description URL-safe slug, unique within the workspace. */
-            slug: string;
-            /** @description Icon identifier for the entity type. */
-            icon: string;
-            /** @description Hex colour of the entity type. */
-            color: string;
-            /** @description Whether the entity type is enabled. */
-            isEnabled: boolean;
-            /** @description Description of the entity type. Included when `expansion=description` is requested. */
+            /** @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 Field definitions grouped into sections. Included when `expansion=attributeSchema` is requested. */
-            attributeSchema?: {
-                [key: string]: unknown;
-            };
-            /** @description State machine definition. Included when `expansion=stateSchema` is requested. */
-            stateSchema?: {
-                [key: string]: unknown;
-            } | null;
+            /** @description Public URL of the agent profile image. Included when `expansion=profileImageUrl` is requested. */
+            profileImageUrl?: string | null;
             /**
              * Format: date-time
-             * @description Included when `expansion=createdAt` is requested.
+             * @description Creation timestamp. Included when `expansion=createdAt` is requested.
              */
             createdAt?: string;
             /**
              * Format: date-time
-             * @description Included when `expansion=updatedAt` is requested.
+             * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
              */
             updatedAt?: string;
-            /** @description Workspace member who created the entity type. Included when `expansion=createdBy` is requested. */
-            createdBy?: components["schemas"]["ObjectTypeCreatedByDto"];
-            /** @description Included when `expansion=countObjects` is requested. */
-            _count?: components["schemas"]["ObjectTypeCountDto"];
-        };
-        CreateObjectDto: {
-            /** @description Display name of the entity. */
-            name: string;
+            /** @description System instructions authored for the agent. Included when `expansion=instructions` is requested. */
+            instructions?: string | null;
             /**
-             * Format: uuid
-             * @description ID of the entity type to create the entity under.
+             * @description Model temperature. Included when `expansion=temperature` is requested.
+             * @example 1
              */
-            objectTypeId: string;
-            /** @description Initial state ID. Must exist in the entity type state schema. Defaults to the schema initial state when omitted. */
-            state?: string;
-            /** @description Dynamic attribute values keyed by field ID. */
-            attributes?: {
-                [key: string]: unknown;
-            };
+            temperature?: number;
+            /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
+            maxOutputTokens?: number | null;
             /**
-             * Format: uuid
-             * @description Workspace user ID of the entity owner.
+             * @description Top-p sampling. Included when `expansion=topP` is requested.
+             * @example 1
              */
-            ownerId?: string;
-        };
-        ObjectTypeSummaryDto: {
-            /** @description Entity type ID. */
-            id: string;
-            /** @description Singular display name of the entity type. */
-            name: string;
-            /** @description URL-safe slug of the entity type. */
-            slug: string;
-            /** @description Icon identifier for the entity type. */
-            icon: string;
-            /** @description Hex colour of the entity type. */
-            color: string;
-            /** @description Plural display name. Included when `expansion=objectType` is requested. */
-            namePlural?: string;
-            /** @description Field definitions grouped into sections. Included when `expansion=objectType` is requested on single-entity reads. */
-            attributeSchema?: {
-                [key: string]: unknown;
-            };
-            /** @description State machine definition. Included when `expansion=objectType` is requested. */
-            stateSchema?: {
-                [key: string]: unknown;
-            } | null;
-        };
-        ObjectUserSummaryDto: {
-            /** @description User ID. */
-            id: string;
-            /** @description Email address of the user. */
-            email: string;
-            /** @description Display name of the user. */
-            name: string;
-        };
-        ObjectWorkspaceUserSummaryDto: {
-            /** @description Workspace user ID. */
-            id: string;
-            user: components["schemas"]["ObjectUserSummaryDto"];
-        };
-        ObjectStateHistoryUserSummaryDto: {
-            /** @description User ID. */
-            id: string;
-            /** @description Display name of the user. */
-            name: string;
-        };
-        ObjectStateHistoryChangedByDto: {
-            /** @description Workspace user ID. */
-            id: string;
-            user: components["schemas"]["ObjectStateHistoryUserSummaryDto"];
-        };
-        ObjectStateHistoryItemDto: {
-            /** @description State history entry ID. */
-            id: string;
-            /** @description State the entity moved from. Null for the initial state. */
-            fromState: string | null;
-            /** @description State the entity moved to. */
-            toState: string;
-            /** @description Reason recorded for the state change, if any. */
-            reason: string | null;
+            topP?: number;
             /**
-             * Format: date-time
-             * @description When the state change occurred.
+             * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
+             * @example 0
              */
-            createdAt: string;
-            /** @description Workspace member who made the change, if recorded. */
-            changedBy: components["schemas"]["ObjectStateHistoryChangedByDto"] | null;
-        };
-        ObjectResponseDto: {
-            /** @description Entity ID. */
-            id: string;
-            /** @description Display name of the entity. */
-            name: string;
-            /** @description Current state of the entity, if the type defines states. */
-            state: string | null;
-            /** @description Dynamic attribute values keyed by field ID. */
-            attributes: {
-                [key: string]: unknown;
-            };
+            frequencyPenalty?: number;
             /**
-             * Format: date-time
-             * @description Included when `expansion=createdAt` is requested.
+             * @description Presence penalty. Included when `expansion=presencePenalty` is requested.
+             * @example 0
              */
-            createdAt?: string;
+            presencePenalty?: number;
             /**
-             * Format: date-time
-             * @description Included by default on list responses, otherwise when `expansion=updatedAt` is requested.
+             * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
+             * @example 0
              */
-            updatedAt?: string;
-            /** @description Included by default on list responses with a minimal shape, otherwise when `expansion=objectType` is requested. */
-            objectType?: components["schemas"]["ObjectTypeSummaryDto"];
-            /** @description Included when `expansion=owner` is requested. */
-            owner?: components["schemas"]["ObjectWorkspaceUserSummaryDto"] | null;
-            /** @description Included when `expansion=createdBy` is requested. */
-            createdBy?: components["schemas"]["ObjectWorkspaceUserSummaryDto"] | null;
-            /** @description Most recent state changes (up to 50, newest first). Included when `expansion=stateHistory` is requested. */
-            stateHistory?: components["schemas"]["ObjectStateHistoryItemDto"][];
-        };
-        ObjectPaginationDto: {
-            /** @description Current page number (1-based). */
-            page: number;
-            /** @description Number of items per page (maximum 100). */
-            pageSize: number;
-            /** @description Total number of matching entities. */
-            totalCount: number;
-            /** @description Total number of pages. */
-            totalPages: number;
-        };
-        PaginatedObjectsResponseDto: {
-            data: components["schemas"]["ObjectResponseDto"][];
-            pagination: components["schemas"]["ObjectPaginationDto"];
-        };
-        UpdateObjectDto: {
-            /** @description New display name of the entity. */
-            name?: string;
-            /** @description Attribute values keyed by field ID. Merged into the existing attributes; fields not supplied are left unchanged. */
-            attributes?: {
-                [key: string]: unknown;
-            };
-            /** @description Workspace user ID of the new entity owner. */
-            ownerId?: string;
-        };
-        ChangeObjectStateDto: {
-            /** @description ID of the target state. Must be a valid transition from the current state when the entity type defines transitions. */
-            newState: string;
-            /** @description Reason for the state change. Required when the transition is configured with requiresReason. */
-            reason?: string;
+            maxRetries?: number;
+            /** @description Fixed sampling seed. Included when `expansion=seed` is requested. */
+            seed?: number | null;
+            /**
+             * @description Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
+             * @example 5
+             */
+            maxToolRoundtrips?: number;
+            /**
+             * @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 Memory partitioning scope. Included when `expansion=memoryScope` is requested.
+             * @enum {string}
+             */
+            memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
+            /**
+             * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
+             * @example 90
+             */
+            memoryRetentionDays?: number;
+            /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
+            suggestedPrompts?: string[];
+            /**
+             * Format: date-time
+             * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
+             */
+            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;
+        };
+        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: {
+                [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;
+            }[];
+        };
+        ObjectTypeUserSummaryDto: {
+            /** @description User ID. */
+            id: string;
+            /** @description Email address of the user. */
+            email: string;
+            /** @description Display name of the user. */
+            name: string;
+        };
+        ObjectTypeCreatedByDto: {
+            /** @description Workspace user ID. */
+            id: string;
+            user: components["schemas"]["ObjectTypeUserSummaryDto"];
+        };
+        ObjectTypeCountDto: {
+            /** @description Number of non-deleted entities of this type. */
+            objects: number;
+        };
+        ObjectTypeResponseDto: {
+            /** @description Entity type ID. */
+            id: string;
+            /** @description Singular display name of the entity type. */
+            name: string;
+            /** @description Plural display name of the entity type. */
+            namePlural: string;
+            /** @description URL-safe slug, unique within the workspace. */
+            slug: string;
+            /** @description Icon identifier for the entity type. */
+            icon: string;
+            /** @description Hex colour of the entity type. */
+            color: string;
+            /** @description Whether the entity type is enabled. */
+            isEnabled: boolean;
+            /** @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. */
+            attributeSchema?: {
+                [key: string]: unknown;
+            };
+            /** @description State machine definition. Included when `expansion=stateSchema` is requested. */
+            stateSchema?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Format: date-time
+             * @description Included when `expansion=createdAt` is requested.
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description Included when `expansion=updatedAt` is requested.
+             */
+            updatedAt?: string;
+            /** @description Workspace member who created the entity type. Included when `expansion=createdBy` is requested. */
+            createdBy?: components["schemas"]["ObjectTypeCreatedByDto"];
+            /** @description Included when `expansion=countObjects` is requested. */
+            _count?: components["schemas"]["ObjectTypeCountDto"];
+        };
+        CreateObjectDto: {
+            /** @description Display name of the entity. */
+            name: string;
+            /**
+             * Format: uuid
+             * @description ID of the entity type to create the entity under.
+             */
+            objectTypeId: string;
+            /** @description Initial state ID. Must exist in the entity type state schema. Defaults to the schema initial state when omitted. */
+            state?: string;
+            /** @description Dynamic attribute values keyed by field ID. */
+            attributes?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Format: uuid
+             * @description Workspace user ID of the entity owner.
+             */
+            ownerId?: string;
+        };
+        ObjectTypeSummaryDto: {
+            /** @description Entity type ID. */
+            id: string;
+            /** @description Singular display name of the entity type. */
+            name: string;
+            /** @description URL-safe slug of the entity type. */
+            slug: string;
+            /** @description Icon identifier for the entity type. */
+            icon: string;
+            /** @description Hex colour of the entity type. */
+            color: string;
+            /** @description Plural display name. Included when `expansion=objectType` is requested. */
+            namePlural?: string;
+            /** @description Field definitions grouped into sections. Included when `expansion=objectType` is requested on single-entity reads. */
+            attributeSchema?: {
+                [key: string]: unknown;
+            };
+            /** @description State machine definition. Included when `expansion=objectType` is requested. */
+            stateSchema?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        ObjectUserSummaryDto: {
+            /** @description User ID. */
+            id: string;
+            /** @description Email address of the user. */
+            email: string;
+            /** @description Display name of the user. */
+            name: string;
+        };
+        ObjectWorkspaceUserSummaryDto: {
+            /** @description Workspace user ID. */
+            id: string;
+            user: components["schemas"]["ObjectUserSummaryDto"];
+        };
+        ObjectStateHistoryUserSummaryDto: {
+            /** @description User ID. */
+            id: string;
+            /** @description Display name of the user. */
+            name: string;
+        };
+        ObjectStateHistoryChangedByDto: {
+            /** @description Workspace user ID. */
+            id: string;
+            user: components["schemas"]["ObjectStateHistoryUserSummaryDto"];
+        };
+        ObjectStateHistoryItemDto: {
+            /** @description State history entry ID. */
+            id: string;
+            /** @description State the entity moved from. Null for the initial state. */
+            fromState: string | null;
+            /** @description State the entity moved to. */
+            toState: string;
+            /** @description Reason recorded for the state change, if any. */
+            reason: string | null;
+            /**
+             * Format: date-time
+             * @description When the state change occurred.
+             */
+            createdAt: string;
+            /** @description Workspace member who made the change, if recorded. */
+            changedBy: components["schemas"]["ObjectStateHistoryChangedByDto"] | null;
+        };
+        ObjectResponseDto: {
+            /** @description Entity ID. */
+            id: string;
+            /** @description Display name of the entity. */
+            name: string;
+            /** @description Current state of the entity, if the type defines states. */
+            state: string | null;
+            /** @description Dynamic attribute values keyed by field ID. */
+            attributes: {
+                [key: string]: unknown;
+            };
+            /**
+             * Format: date-time
+             * @description Included when `expansion=createdAt` is requested.
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description Included by default on list responses, otherwise when `expansion=updatedAt` is requested.
+             */
+            updatedAt?: string;
+            /** @description Included by default on list responses with a minimal shape, otherwise when `expansion=objectType` is requested. */
+            objectType?: components["schemas"]["ObjectTypeSummaryDto"];
+            /** @description Included when `expansion=owner` is requested. */
+            owner?: components["schemas"]["ObjectWorkspaceUserSummaryDto"] | null;
+            /** @description Included when `expansion=createdBy` is requested. */
+            createdBy?: components["schemas"]["ObjectWorkspaceUserSummaryDto"] | null;
+            /** @description Most recent state changes (up to 50, newest first). Included when `expansion=stateHistory` is requested. */
+            stateHistory?: components["schemas"]["ObjectStateHistoryItemDto"][];
+        };
+        ObjectPaginationDto: {
+            /** @description Current page number (1-based). */
+            page: number;
+            /** @description Number of items per page (maximum 100). */
+            pageSize: number;
+            /** @description Total number of matching entities. */
+            totalCount: number;
+            /** @description Total number of pages. */
+            totalPages: number;
+        };
+        PaginatedObjectsResponseDto: {
+            data: components["schemas"]["ObjectResponseDto"][];
+            pagination: components["schemas"]["ObjectPaginationDto"];
+        };
+        UpdateObjectDto: {
+            /** @description New display name of the entity. */
+            name?: string;
+            /** @description Attribute values keyed by field ID. Merged into the existing attributes; fields not supplied are left unchanged. */
+            attributes?: {
+                [key: string]: unknown;
+            };
+            /** @description Workspace user ID of the new entity owner. */
+            ownerId?: string;
+        };
+        ChangeObjectStateDto: {
+            /** @description ID of the target state. Must be a valid transition from the current state when the entity type defines transitions. */
+            newState: string;
+            /** @description Reason for the state change. Required when the transition is configured with requiresReason. */
+            reason?: string;
         };
         ChangeObjectStateResponseDto: {
             /** @description Entity ID. */
@@ -1495,288 +1823,35 @@ interface components {
             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;
-            /**
-             * Format: date-time
-             * @description Timestamp when the execution started. Always returned by GET /executions/{executionId}; included in list responses when `expansion=startedAt` is requested.
-             */
-            startedAt?: string;
-            /**
-             * Format: date-time
-             * @description Timestamp when the execution stopped. Included when `expansion=stoppedAt` is requested.
-             */
-            stoppedAt?: 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 | 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;
-            /**
-             * 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}
-             */
-            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 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}
-             */
-            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;
-            /**
-             * @description Final execution status after the single action step.
-             * @enum {string}
-             */
-            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;
-        };
-        CreateVariableDto: {
-            /** @description Name of the variable. */
-            name: string;
-            /** @description Description of the variable. */
-            description?: string;
-            /**
-             * @description Scope of the variable (system, workspace or project).
-             * @enum {string}
-             */
-            type: "system" | "workspace" | "project";
-            /**
-             * @description Data type of the variable value.
-             * @enum {string}
-             */
-            dataType: "string" | "number" | "boolean" | "date" | "json";
-            /** @description Project ID to scope the variable to. Must belong to the current workspace. */
-            projectId?: string;
-            /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
-            value: string;
-        };
-        VariableWorkspaceDto: {
-            /** @description Workspace ID. */
-            id: string;
-            /** @description Workspace name. */
-            name: string;
-        };
-        VariableProjectDto: {
-            /** @description Project ID. */
-            id: string;
-            /** @description Project name. */
-            name: string;
-        };
-        VariableResponseDto: {
-            /** @description Variable ID. */
-            id: string;
-            /** @description Variable name. */
-            name: string;
-            /**
-             * @description Data type of the variable value.
-             * @enum {string}
-             */
-            dataType: "string" | "number" | "boolean" | "date" | "json";
-            /**
-             * @description Scope of the variable (system, workspace or project).
-             * @enum {string}
-             */
-            type: "system" | "workspace" | "project";
-            /** @description Variable value. Included when `expansion=value` is requested. */
-            value?: Record<string, never>;
-            /** @description Variable description. Included when `expansion=description` is requested. */
-            description?: string;
-            /**
-             * 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 Owning workspace. Included when `expansion=workspace` is requested. */
-            workspace?: components["schemas"]["VariableWorkspaceDto"];
-            /** @description Owning project for project-scoped variables. Included when `expansion=project` is requested. */
-            project?: components["schemas"]["VariableProjectDto"];
-        };
-        UpdateVariableDto: {
-            /** @description Name of the variable. */
-            name?: string;
-            /** @description Description of the variable. */
-            description?: string;
-            /**
-             * @description Scope of the variable (system, workspace or project).
-             * @enum {string}
-             */
-            type?: "system" | "workspace" | "project";
-            /**
-             * @description Data type of the variable value.
-             * @enum {string}
-             */
-            dataType?: "string" | "number" | "boolean" | "date" | "json";
-            /** @description Project ID to scope the variable to. Must belong to the current workspace. */
-            projectId?: string;
-            /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
-            value?: string;
-        };
-        ConnectionWorkspaceDto: {
-            /** @description Workspace ID. */
-            id: string;
-            /** @description Workspace name. */
-            name: string;
+                label?: string;
+                value?: string;
+            }[];
         };
-        ConnectionResponseDto: {
-            /** @description Connection ID. */
+        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 Connection name. */
-            name: string;
             /**
              * Format: date-time
-             * @description Creation timestamp. Included when `expansion=createdAt` is requested.
+             * @description Timestamp when the execution started. Always returned by GET /executions/{executionId}; included in list responses when `expansion=startedAt` is requested.
              */
-            createdAt?: string;
+            startedAt?: string;
             /**
              * Format: date-time
-             * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
-             */
-            updatedAt?: string;
-            /** @description App connection type ID (e.g. the OAuth2 or API key connection definition of the app). Included when `expansion=connectionId` is requested. */
-            connectionId?: string;
-            /** @description ID of the workflow app this connection belongs to. Included when `expansion=workflowAppId` or `expansion=workflowApp` is requested. */
-            workflowAppId?: string;
-            /** @description Full workflow app definition for this connection. Included when `expansion=workflowApp` is requested on the list endpoint. */
-            workflowApp?: {
-                [key: string]: unknown;
-            };
-            /** @description Owning workspace. Included when `expansion=workspace` is requested. */
-            workspace?: components["schemas"]["ConnectionWorkspaceDto"];
-        };
-        AgentResponseDto: {
-            /**
-             * @description Agent ID (UUID)
-             * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
-             */
-            id: string;
-            /**
-             * @description Agent name
-             * @example Invoice Triage Agent
+             * @description Timestamp when the execution stopped. Included when `expansion=stoppedAt` is requested.
              */
-            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;
+            stoppedAt?: string | null;
             /**
              * Format: date-time
              * @description Creation timestamp. Included when `expansion=createdAt` is requested.
@@ -1784,259 +1859,230 @@ interface components {
             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;
-            /**
-             * @description Model temperature. Included when `expansion=temperature` is requested.
-             * @example 1
-             */
-            temperature?: number;
-            /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
-            maxOutputTokens?: number | null;
-            /**
-             * @description Top-p sampling. Included when `expansion=topP` is requested.
-             * @example 1
-             */
-            topP?: number;
-            /**
-             * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
-             * @example 0
-             */
-            frequencyPenalty?: number;
-            /**
-             * @description Presence penalty. Included when `expansion=presencePenalty` is requested.
-             * @example 0
-             */
-            presencePenalty?: number;
-            /**
-             * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
-             * @example 0
-             */
-            maxRetries?: number;
-            /** @description Fixed sampling seed. Included when `expansion=seed` is requested. */
-            seed?: number | null;
-            /**
-             * @description Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
-             * @example 5
-             */
-            maxToolRoundtrips?: number;
-            /**
-             * @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 Memory partitioning scope. Included when `expansion=memoryScope` is requested.
-             * @enum {string}
-             */
-            memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
-            /**
-             * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
-             * @example 90
-             */
-            memoryRetentionDays?: number;
-            /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
-            suggestedPrompts?: string[];
-            /**
-             * Format: date-time
-             * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
-             */
-            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 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 Web access configuration. Included when `expansion=webAccess` is requested. */
-            agentWebAccess?: {
-                service?: string;
-                webSearchEnabled?: boolean;
-                websiteAccessEnabled?: boolean;
+            /** @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;
-            /** @description Phone access configuration. Included when `expansion=phoneAccess` is requested. */
-            agentPhoneAccess?: {
-                service?: string;
-                outboundCallsEnabled?: boolean;
-                inboundCallsEnabled?: boolean;
+            /**
+             * 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}
+             */
+            workflowOrientation?: "HORIZONTAL" | "VERTICAL";
+            /** @description Variables captured during the execution (JSON). Included when `expansion=executionVariables` is requested. */
+            executionVariables?: {
+                [key: string]: unknown;
             } | null;
-            /** @description Project the agent belongs to. Included when `expansion=project` is requested. */
-            project?: {
-                id?: string;
-                name?: string;
-            };
+            /** @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 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}
+             */
+            source?: "WORKFLOW" | "SDK";
+            /** @description Optional display name (set for ad-hoc SDK runs). Included when `expansion=name` is requested. */
+            name?: string | null;
         };
-        UpsertAgentToolDto: {
-            /** @description Workflow app id (catalogue slug). */
+        RunActionDto: {
+            /** @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 (`actions[].id` / `inputConfig`). */
             actionId: string;
-            /** @description Connection instance UUID pre-bound on the tool. */
+            /** @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 Tool display name for the model. */
+            /** @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;
-            /** @description Tool description shown to the model. */
-            description?: string;
-            /** @description Pre-filled tool config (fields left empty are filled by the model). */
+        };
+        RunActionResponseDto: {
+            /** @description ID of the ad-hoc Execution. Use GET /executions/{executionId} (with expansion=executionPath) to re-read progress. */
+            id: string;
+            /**
+             * @description Final execution status after the single action step.
+             * @enum {string}
+             */
+            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;
         };
-        UpsertAgentBySlugDto: {
+        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;
+        };
+        CreateVariableDto: {
+            /** @description Name of the variable. */
+            name: string;
+            /** @description Description of the variable. */
+            description?: string;
             /**
-             * @description Stable project-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
-             * @example support-triage
+             * @description Scope of the variable (system, workspace or project).
+             * @enum {string}
              */
-            slug: string;
-            /** @description Display name. Defaults to the slug when omitted. */
+            type: "system" | "workspace" | "project";
+            /**
+             * @description Data type of the variable value.
+             * @enum {string}
+             */
+            dataType: "string" | "number" | "boolean" | "date" | "json";
+            /** @description Project ID to scope the variable to. Must belong to the current workspace. */
+            projectId?: string;
+            /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
+            value: string;
+        };
+        VariableWorkspaceDto: {
+            /** @description Workspace ID. */
+            id: string;
+            /** @description Workspace name. */
+            name: string;
+        };
+        VariableProjectDto: {
+            /** @description Project ID. */
+            id: string;
+            /** @description Project name. */
+            name: string;
+        };
+        VariableResponseDto: {
+            /** @description Variable ID. */
+            id: string;
+            /** @description Variable name. */
+            name: string;
+            /**
+             * @description Data type of the variable value.
+             * @enum {string}
+             */
+            dataType: "string" | "number" | "boolean" | "date" | "json";
+            /**
+             * @description Scope of the variable (system, workspace or project).
+             * @enum {string}
+             */
+            type: "system" | "workspace" | "project";
+            /** @description Variable value. Included when `expansion=value` is requested. */
+            value?: Record<string, never>;
+            /** @description Variable description. Included when `expansion=description` is requested. */
+            description?: string;
+            /**
+             * 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 Owning workspace. Included when `expansion=workspace` is requested. */
+            workspace?: components["schemas"]["VariableWorkspaceDto"];
+            /** @description Owning project for project-scoped variables. Included when `expansion=project` is requested. */
+            project?: components["schemas"]["VariableProjectDto"];
+        };
+        UpdateVariableDto: {
+            /** @description Name of the variable. */
             name?: string;
+            /** @description Description of the variable. */
             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;
+            /**
+             * @description Scope of the variable (system, workspace or project).
+             * @enum {string}
+             */
+            type?: "system" | "workspace" | "project";
+            /**
+             * @description Data type of the variable value.
+             * @enum {string}
+             */
+            dataType?: "string" | "number" | "boolean" | "date" | "json";
+            /** @description Project ID to scope the variable to. Must belong to the current workspace. */
+            projectId?: string;
+            /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
+            value?: string;
+        };
+        ConnectionWorkspaceDto: {
+            /** @description Workspace ID. */
+            id: string;
+            /** @description Workspace name. */
+            name: string;
+        };
+        ConnectionResponseDto: {
+            /** @description Connection ID. */
+            id: string;
+            /** @description Connection name. */
+            name: string;
+            /**
+             * 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 App connection type ID (e.g. the OAuth2 or API key connection definition of the app). Included when `expansion=connectionId` is requested. */
+            connectionId?: string;
+            /** @description ID of the workflow app this connection belongs to. Included when `expansion=workflowAppId` or `expansion=workflowApp` is requested. */
+            workflowAppId?: string;
+            /** @description Full workflow app definition for this connection. Included when `expansion=workflowApp` is requested on the list endpoint. */
+            workflowApp?: {
+                [key: string]: unknown;
+            };
+            /** @description Owning workspace. Included when `expansion=workspace` is requested. */
+            workspace?: components["schemas"]["ConnectionWorkspaceDto"];
         };
         TaskListItemResponseDto: {
             /**
@@ -2319,6 +2365,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'];
@@ -3042,8 +3089,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 +3107,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. */