@lunnoa/client 1.0.0 → 1.1.0

package/dist/react.d.ts

@@ -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. */
@@ -967,563 +969,299 @@ interface components {
             /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
             managedByCode?: boolean;
         };
-        AgentResponseDto: {
+        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 Agent ID (UUID)
-             * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
+             * @description Icon identifier.
+             * @default box
              */
-            id: string;
+            icon: string;
             /**
-             * @description Agent name
-             * @example Invoice Triage Agent
+             * @description Hex colour.
+             * @default #3B82F6
+             */
+            color: string;
+            /** @description Field definitions grouped into sections. */
+            attributeSchema: {
+                [key: string]: unknown;
+            };
+            /** @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. */
+            id: string;
+            /** @description Email address of the user. */
+            email: string;
+            /** @description Display name of the user. */
             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. */
+        };
+        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 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 Public URL of the agent profile image. Included when `expansion=profileImageUrl` is requested. */
-            profileImageUrl?: 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 Creation timestamp. Included when `expansion=createdAt` is requested.
+             * @description Included when `expansion=createdAt` is requested.
              */
             createdAt?: string;
             /**
              * Format: date-time
-             * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
+             * @description 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 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 Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
-             * @example 5
+             * Format: uuid
+             * @description ID of the entity type to create the entity under.
              */
-            maxToolRoundtrips?: number;
+            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;
+            };
             /**
-             * @description How many previous messages are sent to the model. Included when `expansion=messageLookbackLimit` is requested.
-             * @example 40
+             * Format: uuid
+             * @description Workspace user ID of the entity owner.
              */
-            messageLookbackLimit?: number;
-            /** @description Configured tool nodes (app actions) for the agent. Included when `expansion=tools` is requested. */
-            tools?: {
+            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;
-            }[] | 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 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;
             /**
-             * @description Memory partitioning scope. Included when `expansion=memoryScope` is requested.
-             * @enum {string}
+             * Format: date-time
+             * @description When the state change occurred.
              */
-            memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
+            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;
+            };
             /**
-             * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
-             * @example 90
+             * Format: date-time
+             * @description Included when `expansion=createdAt` is requested.
              */
-            memoryRetentionDays?: number;
-            /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
-            suggestedPrompts?: string[];
+            createdAt?: string;
             /**
              * Format: date-time
-             * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
+             * @description Included by default on list responses, otherwise when `expansion=updatedAt` 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;
-            };
+            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"][];
         };
-        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. */
+        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 Tool description shown to the model. */
-            description?: string;
-            /** @description Pre-filled tool config (fields left empty are filled by the model). */
-            input?: {
+            /** @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;
         };
-        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;
+        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;
         };
-        WorkflowAppResponseDto: {
-            /** @description App ID, e.g. `gmail`. Matches the appId used in workflow execution steps. */
+        ChangeObjectStateResponseDto: {
+            /** @description Entity ID. */
             id: string;
-            /** @description Human-readable app name. */
+            /** @description Display name of the entity. */
             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;
-            }[];
+            /** @description State of the entity after the change. */
+            state: string | null;
+            /**
+             * Format: date-time
+             * @description When the entity was last updated.
+             */
+            updatedAt: string;
         };
-        ObjectTypeUserSummaryDto: {
+        StateHistoryUserSummaryDto: {
             /** @description User ID. */
             id: string;
-            /** @description Email address of the user. */
-            email: string;
             /** @description Display name of the user. */
             name: string;
+            /** @description Email address of the user. */
+            email: string;
         };
-        ObjectTypeCreatedByDto: {
+        StateHistoryChangedByDto: {
             /** @description Workspace user ID. */
             id: string;
-            user: components["schemas"]["ObjectTypeUserSummaryDto"];
+            user: components["schemas"]["StateHistoryUserSummaryDto"];
         };
-        ObjectTypeCountDto: {
-            /** @description Number of non-deleted entities of this type. */
-            objects: number;
+        ObjectStateHistoryEntryResponseDto: {
+            /** @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"]["StateHistoryChangedByDto"] | null;
         };
-        ObjectTypeResponseDto: {
-            /** @description Entity type ID. */
+        ObjectStateInfoDto: {
+            /** @description State 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. */
-            id: string;
-            /** @description Display name of the entity. */
-            name: string;
-            /** @description State of the entity after the change. */
-            state: string | null;
-            /**
-             * Format: date-time
-             * @description When the entity was last updated.
-             */
-            updatedAt: string;
-        };
-        StateHistoryUserSummaryDto: {
-            /** @description User ID. */
-            id: string;
-            /** @description Display name of the user. */
-            name: string;
-            /** @description Email address of the user. */
-            email: string;
-        };
-        StateHistoryChangedByDto: {
-            /** @description Workspace user ID. */
-            id: string;
-            user: components["schemas"]["StateHistoryUserSummaryDto"];
-        };
-        ObjectStateHistoryEntryResponseDto: {
-            /** @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"]["StateHistoryChangedByDto"] | null;
-        };
-        ObjectStateInfoDto: {
-            /** @description State ID. */
-            id: string;
-            /** @description Display name of the state. */
+            /** @description Display name of the state. */
             name: string;
             /** @description Colour associated with the state. */
             color?: string;
@@ -1586,6 +1324,334 @@ interface components {
                 [key: string]: string;
             };
         };
+        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;
+            }[];
+        };
+        AgentResponseDto: {
+            /**
+             * @description Agent ID (UUID)
+             * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
+             */
+            id: string;
+            /**
+             * @description Agent name
+             * @example Invoice Triage Agent
+             */
+            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;
+            /**
+             * @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 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}
+             */
+            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;
+        };
         CreateKnowledgeDto: {
             /** @description Name of the knowledge base. */
             name: string;
@@ -1734,6 +1800,124 @@ interface components {
             /** @description Vector references (parts) in the group, ordered by part number. */
             vectorRefs: components["schemas"]["KnowledgeDocumentGroupVectorRefDto"][];
         };
+        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;
+        };
+        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"];
+        };
         ManuallyRunWorkflowInputDataDto: {
             /**
              * @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.
@@ -1966,124 +2150,6 @@ interface components {
             /** @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;
-        };
-        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: {
             /**
              * @description Task ID (UUID)
@@ -2229,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: {
             /**
@@ -2302,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 */
@@ -2608,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 {
@@ -2674,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;
@@ -2967,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);
@@ -2982,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 = {