@lunnoa/client 1.3.0 → 1.5.0

package/dist/react.d.ts

@@ -856,7 +856,9 @@ interface components {
             /** @description Error message to record against the queue item. */
             error: string;
             /** @description Additional structured error details, supplied as a JSON string. */
-            errorDetails?: string;
+            errorDetails?: {
+                [key: string]: unknown;
+            };
         };
         BulkDeleteItemsDto: {
             /** @description IDs of the queue items to delete. */
@@ -905,6 +907,14 @@ interface components {
             isActive?: boolean;
             /** @description Whether the workflow is internal (hidden from default listings). Included when `expansion=isInternal` is requested. */
             isInternal?: boolean;
+            /** @description Object type whose records list this workflow's runs. Included when `expansion=objectLink` is requested. */
+            objectTypeId?: string | null;
+            /** @description Dot path on the trigger payload. A Lunnoa id when the type has no unique key, otherwise that key's value. Included when `expansion=objectLink` is requested. */
+            objectIdPath?: string | null;
+            /** @description Create a record when the unique key value is not found, then file the run on it. Included when `expansion=objectLink` is requested. */
+            createObjectIfMissing?: boolean;
+            /** @description Unique key on the linked object type (`name` or `attribute:<field>`). Included when `expansion=objectLink` is requested. */
+            uniqueKeyField?: string | null;
             /** @description Workflow node definitions (JSON). Included when `expansion=nodes` is requested. */
             nodes?: {
                 [key: string]: unknown;
@@ -974,437 +984,61 @@ interface components {
             /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
             managedByCode?: boolean;
         };
-        UpsertObjectTypeBySlugDto: {
-            /** @description Stable workspace-scoped slug (lowercase, digits, hyphens). Used as the upsert key. */
-            slug: string;
-            /** @description Singular display name. */
-            name?: string;
-            /** @description Plural display name. */
-            namePlural?: string;
-            /** @description Description. */
-            description?: string;
-            /**
-             * @description Icon identifier.
-             * @default box
-             */
-            icon: string;
-            /**
-             * @description Hex colour.
-             * @default #3B82F6
-             */
-            color: string;
-            /** @description Field definitions grouped into sections. */
-            attributeSchema: {
-                [key: string]: unknown;
-            };
-            /** @description Optional state machine definition. */
-            stateSchema?: {
-                [key: string]: unknown;
-            } | null;
-            /** @description Whether the type is enabled. */
-            isEnabled?: boolean;
+        AgentResponseDto: {
             /**
-             * @description When false (default), reject unknown attribute keys on entity writes.
-             * @default false
+             * @description Agent ID (UUID)
+             * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
              */
-            allowUnknownAttributes: boolean;
+            id: string;
             /**
-             * @description Marks the type as code-managed. Defaults to true on upsert.
-             * @default true
+             * @description Agent name
+             * @example Invoice Triage Agent
              */
-            managedByCode: boolean;
-        };
-        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 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 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;
-            };
-        };
-        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;
+            temperature?: number;
+            /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
+            maxOutputTokens?: number | null;
             /**
-             * Format: date-time
-             * @description When the state change occurred.
+             * @description Top-p sampling. Included when `expansion=topP` is requested.
+             * @example 1
              */
-            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;
-            };
+            topP?: number;
             /**
-             * Format: date-time
-             * @description Included when `expansion=createdAt` is requested.
+             * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
+             * @example 0
              */
-            createdAt?: string;
+            frequencyPenalty?: number;
             /**
-             * Format: date-time
-             * @description Included by default on list responses, otherwise when `expansion=updatedAt` is requested.
+             * @description Presence penalty. Included when `expansion=presencePenalty` 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;
-            };
-        };
-        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. */
-            name: string;
-            /** @description Colour associated with the state. */
-            color?: string;
-            /** @description Icon associated with the state. */
-            icon?: string;
-            /** @description Whether the state is a final state. */
-            isFinal: boolean;
-        };
-        ObjectStateTransitionDto: {
-            /** @description Transition ID from the state schema. */
-            transitionId: string;
-            /** @description ID of the target state. */
-            toStateId: string;
-            /** @description Display name of the target state. */
-            toStateName: string;
-            /** @description Colour of the target state. */
-            toStateColor?: string;
-            /** @description Icon of the target state. */
-            toStateIcon?: string;
-            /** @description Whether a reason must be supplied for this transition. */
-            requiresReason: boolean;
-            /** @description Confirmation message to show before applying the transition. */
-            confirmationMessage?: string;
-        };
-        ObjectStateTransitionsResponseDto: {
-            /** @description Current state of the entity. Null when the entity has no state or the type defines no state schema. */
-            currentState: components["schemas"]["ObjectStateInfoDto"] | null;
-            /** @description Transitions allowed from the current state. */
-            validTransitions: components["schemas"]["ObjectStateTransitionDto"][];
-            /** @description All states defined by the entity type, for cases where no transitions are defined. */
-            allStates: components["schemas"]["ObjectStateInfoDto"][];
-        };
-        ImportRowErrorDto: {
-            /** @description Row number the error relates to (1-based). */
-            row: number;
-            /** @description Field ID the error relates to, when applicable. */
-            field?: string;
-            /** @description Human-readable error message. */
-            message: string;
-        };
-        ImportEntitiesResponseDto: {
-            /** @description Total number of rows processed. */
-            totalRows: number;
-            /** @description Number of rows imported successfully. */
-            successCount: number;
-            /** @description Number of rows that failed to import. */
-            errorCount: number;
-            /** @description Per-row errors encountered during the import. */
-            errors: components["schemas"]["ImportRowErrorDto"][];
-            /** @description IDs of entities created by the import. */
-            createdIds: string[];
-            /** @description IDs of existing entities updated by the import. */
-            updatedIds: string[];
-        };
-        ImportTemplateResponseDto: {
-            /** @description Column headers for the import file. Always starts with "name". */
-            columns: string[];
-            /** @description Sample row with an example value for each column. */
-            sampleRow: {
-                [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;
+            presencePenalty?: number;
             /**
              * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
              * @example 0
@@ -1650,51 +1284,432 @@ interface components {
             /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
             managedByCode?: boolean;
         };
-        CreateKnowledgeDto: {
-            /** @description Name of the knowledge base. */
-            name: string;
-            /** @description Description of the knowledge base. */
-            description?: string;
-            /** @description Default chunk overlap in words. Must be provided together with chunkSize and cannot exceed 50% of it. */
-            chunkOverlap?: number;
-            /** @description Default chunk size in words (50 to 2000). Must be provided together with chunkOverlap. */
-            chunkSize?: number;
-            /** @description Embedding model to use. Defaults to the platform-configured embedding model. */
-            embeddingModel?: string;
-            /** @description Embedding provider to use. Defaults to the platform-configured embedding provider. */
-            embeddingProvider?: string;
-            /** @description Embedding vector dimensions. Defaults to the platform-configured dimensions. */
-            dimensions?: number;
-        };
-        KnowledgeCountDto: {
-            /** @description Number of vector references stored in this knowledge base. */
-            vectorRefs: number;
-        };
-        KnowledgeVectorRefSummaryDto: {
-            /** @description Vector reference ID. */
-            id: string;
-            /** @description ID of the knowledge base the vector reference belongs to. */
-            FK_knowledgeId: string;
-        };
-        KnowledgeUsageDto: {
-            /** @description Total prompt tokens consumed when embedding content into this knowledge base. */
-            promptTokens: number;
-        };
-        KnowledgeWorkspaceDto: {
-            /** @description Workspace ID. */
+        WorkflowAppResponseDto: {
+            /** @description App ID, e.g. `gmail`. Matches the appId used in workflow execution steps. */
             id: string;
-            /** @description Workspace name. */
+            /** @description Human-readable app name. */
             name: string;
+            /** @description App description. */
+            description: string;
+            /** @description URL of the app logo. */
+            logoUrl: string;
+            /** @description Whether the app is published and available for use. */
+            isPublished: boolean;
+            /** @description Whether the app requires a connection before its actions and triggers can run. */
+            needsConnection: boolean;
+            /** @description Whether the app can be used by agents. */
+            availableForAgent: boolean;
+            /** @description Action definitions, each with id, name, description, iconUrl, needsConnection, availableForAgent, viewOptions and the declarative inputConfig field metadata used to render action UIs. */
+            actions: {
+                [key: string]: unknown;
+            }[];
+            /** @description Trigger definitions, each with id, name, description, iconUrl, needsConnection and the declarative inputConfig field metadata used to render trigger UIs. */
+            triggers: {
+                [key: string]: unknown;
+            }[];
+            /** @description Connection type definitions supported by the app (e.g. oauth2, apiKey, basic), each with id, name, description, connectionType and any declarative inputConfig fields. */
+            connections: {
+                [key: string]: unknown;
+            }[];
         };
-        KnowledgeResponseDto: {
-            /** @description Knowledge base ID. */
-            id: string;
-            /** @description Knowledge base name. */
-            name: string;
-            /** @description Knowledge base description. Included when `expansion=description` is requested. */
+        UpsertObjectTypeBySlugDto: {
+            /** @description Stable deployment-wide slug (lowercase, digits, hyphens). Used as the upsert key. Granted to the caller workspace when new. */
+            slug: string;
+            /** @description Singular display name. */
+            name?: string;
+            /** @description Plural display name. */
+            namePlural?: string;
+            /** @description Description. */
             description?: string;
             /**
-             * Format: date-time
+             * @description Icon identifier.
+             * @default box
+             */
+            icon: string;
+            /**
+             * @description Hex colour.
+             * @default #3B82F6
+             */
+            color: string;
+            /** @description Field definitions grouped into sections. */
+            attributeSchema: {
+                [key: string]: unknown;
+            };
+            /** @description 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;
+        };
+        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 across the deployment. */
+            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 Field that identifies a record besides the Lunnoa id. `name`, or `attribute:<field name>`. */
+            uniqueKeyField?: string | null;
+            /** @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 Platform admin only. Workspace the record is created in. Builders always use their active workspace.
+             */
+            workspaceId?: 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 Attribute values keyed by field ID. Unknown keys are rejected unless the entity type has allowUnknownAttributes=true. Reserved key `extensions` (JSON object) is always allowed. */
+            attributes?: {
+                [key: string]: unknown;
+            };
+        };
+        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=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 existing attributes. Unknown keys are rejected unless the entity type has allowUnknownAttributes=true. Reserved key `extensions` is always allowed. */
+            attributes?: {
+                [key: string]: unknown;
+            };
+        };
+        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. */
+            name: string;
+            /** @description Colour associated with the state. */
+            color?: string;
+            /** @description Icon associated with the state. */
+            icon?: string;
+            /** @description Whether the state is a final state. */
+            isFinal: boolean;
+        };
+        ObjectStateTransitionDto: {
+            /** @description Transition ID from the state schema. */
+            transitionId: string;
+            /** @description ID of the target state. */
+            toStateId: string;
+            /** @description Display name of the target state. */
+            toStateName: string;
+            /** @description Colour of the target state. */
+            toStateColor?: string;
+            /** @description Icon of the target state. */
+            toStateIcon?: string;
+            /** @description Whether a reason must be supplied for this transition. */
+            requiresReason: boolean;
+            /** @description Confirmation message to show before applying the transition. */
+            confirmationMessage?: string;
+        };
+        ObjectStateTransitionsResponseDto: {
+            /** @description Current state of the entity. Null when the entity has no state or the type defines no state schema. */
+            currentState: components["schemas"]["ObjectStateInfoDto"] | null;
+            /** @description Transitions allowed from the current state. */
+            validTransitions: components["schemas"]["ObjectStateTransitionDto"][];
+            /** @description All states defined by the entity type, for cases where no transitions are defined. */
+            allStates: components["schemas"]["ObjectStateInfoDto"][];
+        };
+        ImportRowErrorDto: {
+            /** @description Row number the error relates to (1-based). */
+            row: number;
+            /** @description Field ID the error relates to, when applicable. */
+            field?: string;
+            /** @description Human-readable error message. */
+            message: string;
+        };
+        ImportEntitiesResponseDto: {
+            /** @description Total number of rows processed. */
+            totalRows: number;
+            /** @description Number of rows imported successfully. */
+            successCount: number;
+            /** @description Number of rows that failed to import. */
+            errorCount: number;
+            /** @description Per-row errors encountered during the import. */
+            errors: components["schemas"]["ImportRowErrorDto"][];
+            /** @description IDs of entities created by the import. */
+            createdIds: string[];
+            /** @description IDs of existing entities updated by the import. */
+            updatedIds: string[];
+        };
+        ImportTemplateResponseDto: {
+            /** @description Column headers for the import file. Always starts with "name". */
+            columns: string[];
+            /** @description Sample row with an example value for each column. */
+            sampleRow: {
+                [key: string]: string;
+            };
+        };
+        CreateKnowledgeDto: {
+            /** @description Name of the knowledge base. */
+            name: string;
+            /** @description Description of the knowledge base. */
+            description?: string;
+            /** @description Default chunk overlap in words. Must be provided together with chunkSize and cannot exceed 50% of it. */
+            chunkOverlap?: number;
+            /** @description Default chunk size in words (50 to 2000). Must be provided together with chunkOverlap. */
+            chunkSize?: number;
+            /** @description Embedding model to use. Defaults to the platform-configured embedding model. */
+            embeddingModel?: string;
+            /** @description Embedding provider to use. Defaults to the platform-configured embedding provider. */
+            embeddingProvider?: string;
+            /** @description Embedding vector dimensions. Defaults to the platform-configured dimensions. */
+            dimensions?: number;
+        };
+        KnowledgeCountDto: {
+            /** @description Number of vector references stored in this knowledge base. */
+            vectorRefs: number;
+        };
+        KnowledgeVectorRefSummaryDto: {
+            /** @description Vector reference ID. */
+            id: string;
+            /** @description ID of the knowledge base the vector reference belongs to. */
+            FK_knowledgeId: string;
+        };
+        KnowledgeUsageDto: {
+            /** @description Total prompt tokens consumed when embedding content into this knowledge base. */
+            promptTokens: number;
+        };
+        KnowledgeWorkspaceDto: {
+            /** @description Workspace ID. */
+            id: string;
+            /** @description Workspace name. */
+            name: string;
+        };
+        KnowledgeResponseDto: {
+            /** @description Knowledge base ID. */
+            id: string;
+            /** @description Knowledge base name. */
+            name: string;
+            /** @description Knowledge base description. Included when `expansion=description` is requested. */
+            description?: string;
+            /**
+             * Format: date-time
              * @description Creation timestamp. Included when `expansion=createdAt` is requested.
              */
             createdAt?: string;
@@ -1743,178 +1758,60 @@ interface components {
         SaveUploadedTextToKnowledgeDto: {
             /** @description Name of the document. Multi-part uploads are suffixed with the part number. */
             name: string;
-            /** @description Raw text content to embed into the knowledge base. */
-            text: string;
-            /** @description Chunk overlap in words. Roughly 10% of chunkSize is recommended. */
-            chunkOverlap: number;
-            /** @description Chunk size in words used to split the text before embedding. */
-            chunkSize: number;
-        };
-        KnowledgeDocumentResponseDto: {
-            /** @description Document ID. For `group` documents this is the vector reference group ID; for `standalone` documents it is the vector reference ID. */
-            id: string;
-            /** @description Document name. */
-            name: string;
-            /**
-             * Format: date-time
-             * @description Creation timestamp.
-             */
-            createdAt: string;
-            /** @description Number of parts (chunks) the document was split into. */
-            partCount: number;
-            /**
-             * @description Whether the document is a multi-part group or a standalone single-part upload.
-             * @enum {string}
-             */
-            type: "group" | "standalone";
-        };
-        KnowledgeDocumentGroupVectorRefDto: {
-            /** @description Vector reference ID. */
-            id: string;
-            /** @description Vector reference name, including the part suffix for multi-part uploads. */
-            name: string;
-            /**
-             * Format: date-time
-             * @description Creation timestamp.
-             */
-            createdAt: string;
-            /** @description Part number within the group, or null for single-part uploads. */
-            part: number | null;
-            /** @description Storage path of the raw text for this part. */
-            s3Link: string | null;
-        };
-        KnowledgeDocumentGroupResponseDto: {
-            /** @description Document group ID. */
-            id: string;
-            /** @description Document group name, or null for legacy groups without a stored name. */
-            name: string | null;
-            /**
-             * Format: date-time
-             * @description Creation timestamp.
-             */
-            createdAt: string;
-            /** @description ID of the knowledge base the group belongs to, or null for legacy groups. */
-            FK_knowledgeId: string | null;
-            /** @description Vector references (parts) in the group, ordered by part number. */
-            vectorRefs: components["schemas"]["KnowledgeDocumentGroupVectorRefDto"][];
-        };
-        CreateVariableDto: {
-            /** @description Name of the variable. */
-            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;
+            /** @description Raw text content to embed into the knowledge base. */
+            text: string;
+            /** @description Chunk overlap in words. Roughly 10% of chunkSize is recommended. */
+            chunkOverlap: number;
+            /** @description Chunk size in words used to split the text before embedding. */
+            chunkSize: number;
         };
-        VariableResponseDto: {
-            /** @description Variable ID. */
+        KnowledgeDocumentResponseDto: {
+            /** @description Document ID. For `group` documents this is the vector reference group ID; for `standalone` documents it is the vector reference ID. */
             id: string;
-            /** @description Variable name. */
+            /** @description Document 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}
+             * @description Creation timestamp.
              */
-            type?: "system" | "workspace" | "project";
+            createdAt: string;
+            /** @description Number of parts (chunks) the document was split into. */
+            partCount: number;
             /**
-             * @description Data type of the variable value.
+             * @description Whether the document is a multi-part group or a standalone single-part upload.
              * @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;
+            type: "group" | "standalone";
         };
-        ConnectionResponseDto: {
-            /** @description Connection ID. */
+        KnowledgeDocumentGroupVectorRefDto: {
+            /** @description Vector reference ID. */
             id: string;
-            /** @description Connection name. */
+            /** @description Vector reference name, including the part suffix for multi-part uploads. */
             name: string;
             /**
              * Format: date-time
-             * @description Creation timestamp. Included when `expansion=createdAt` is requested.
+             * @description Creation timestamp.
              */
-            createdAt?: string;
+            createdAt: string;
+            /** @description Part number within the group, or null for single-part uploads. */
+            part: number | null;
+            /** @description Storage path of the raw text for this part. */
+            s3Link: string | null;
+        };
+        KnowledgeDocumentGroupResponseDto: {
+            /** @description Document group ID. */
+            id: string;
+            /** @description Document group name, or null for legacy groups without a stored name. */
+            name: string | null;
             /**
              * Format: date-time
-             * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
+             * @description Creation timestamp.
              */
-            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"];
+            createdAt: string;
+            /** @description ID of the knowledge base the group belongs to, or null for legacy groups. */
+            FK_knowledgeId: string | null;
+            /** @description Vector references (parts) in the group, ordered by part number. */
+            vectorRefs: components["schemas"]["KnowledgeDocumentGroupVectorRefDto"][];
         };
         ManuallyRunWorkflowInputDataDto: {
             /**
@@ -2148,6 +2045,179 @@ 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;
+        };
+        UpsertTableBySlugDto: {
+            /** @description Display name of the table. */
+            name?: string;
+            /** @description What the table contains. Agents use this to choose a table. */
+            description?: string;
+            /** @description Project ID to scope the table to. Omit for a workspace-wide table. */
+            projectId?: string;
+            /** @description Column names: [{ key }]. */
+            columns?: {
+                [key: string]: unknown;
+            }[];
+            /** @description Rows as objects keyed by column name. */
+            rows?: {
+                [key: string]: unknown;
+            }[];
+            /** @description Stable workspace-unique key. Used as the upsert key. */
+            slug: string;
+            /** @description Marks the table as code-managed. Defaults to true on upsert. */
+            managedByCode?: boolean;
+        };
+        TableProjectDto: {
+            id: string;
+            name: string;
+        };
+        TableColumnDto: {
+            /** @description Column key used in rows. */
+            key: string;
+            /** @description Display label. */
+            label: string;
+        };
+        TableResponseDto: {
+            /** @description Table ID. */
+            id: string;
+            /** @description Display name. */
+            name: string;
+            /** @description Stable key, unique within the workspace. */
+            slug: string;
+            /** @description What the table contains. */
+            description?: string | null;
+            /** @description Whether the table is managed by code (CLI / API upsert). */
+            managedByCode: boolean;
+            /** @description Project the table is scoped to, or null for workspace-wide. */
+            FK_projectId?: string | null;
+            project?: components["schemas"]["TableProjectDto"] | null;
+            /** @description Columns. Returned by get and upsert, not by list. */
+            columns?: components["schemas"]["TableColumnDto"][];
+            /** @description Rows keyed by column key. Returned by get and upsert, not by list. */
+            rows?: {
+                [key: string]: unknown;
+            }[];
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: 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)
@@ -2367,12 +2437,9 @@ interface components {
              *       "imageUrl": "https://example.com/image.png"
              *     }
              */
-            data?: {
-                /** @description URL of an image attached to the message. */
-                imageUrl?: string;
-            };
+            data?: Record<string, never>;
             /**
-             * @description Answer to an ask-before-sending personal-data prompt. Applies to this message only.
+             * @description Answer to an "ask before sending" personal-data prompt. Applies to this message only.
              * @enum {string}
              */
             piiResolution?: "anonymize" | "fallback";
@@ -2427,6 +2494,8 @@ type EntityStateTransitions = Schemas['ObjectStateTransitionsResponseDto'];
 type ImportEntitiesResult = Schemas['ImportEntitiesResponseDto'];
 type ImportTemplate = Schemas['ImportTemplateResponseDto'];
 type EntityType = Schemas['ObjectTypeResponseDto'];
+type Table = Schemas['TableResponseDto'];
+type UpsertTableBySlugInput = Schemas['UpsertTableBySlugDto'];
 type Knowledge = Schemas['KnowledgeResponseDto'];
 type CreateKnowledgeInput = Schemas['CreateKnowledgeDto'];
 type UpdateKnowledgeInput = Schemas['UpdateKnowledgeDto'];
@@ -2751,7 +2820,7 @@ interface AgentDefinition {
 }
 interface EntityTypeDefinition {
     kind: typeof DEFINE_KINDS.entityType;
-    /** Stable workspace-scoped slug (upsert key). */
+    /** Stable deployment-wide slug (upsert key). Granted to the deployer's workspace when new. */
     slug: string;
     name?: string;
     namePlural?: string;
@@ -3076,7 +3145,7 @@ declare class EntityTypesResource {
     private readonly http;
     constructor(http: HttpClient);
     /**
-     * Lists entity types in the workspace. Request
+     * Lists entity types granted to the API key's workspace. Request
      * `expansion: ['attributeSchema', 'stateSchema']` for the field and state
      * machine definitions the codegen CLI builds types from.
      */
@@ -3088,12 +3157,32 @@ declare class EntityTypesResource {
     /** 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.
+     * Creates or updates an entity type by deployment-wide slug.
+     * A new slug is granted to the API key's workspace. A slug already shared
+     * with another workspace is rejected unless the key belongs to a platform admin.
      * Prefer the CLI (`npx @lunnoa/client entity-types deploy`) for happy-path deploy.
      */
     upsertBySlug(definition: EntityTypeDefinition | UpsertEntityTypeBySlugInput): Promise<EntityType>;
 }
 
+declare class TablesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Lists tables in the API key's workspace (without columns and rows). */
+    list(options?: {
+        projectId?: string;
+    }): Promise<Table[]>;
+    /** Returns a single table by ID, including columns and rows. */
+    get(id: string): Promise<Table>;
+    /** Returns a single table by its workspace slug, including columns and rows. */
+    getBySlug(slug: string): Promise<Table>;
+    /**
+     * Creates or updates a table by workspace slug. Omitted columns or rows
+     * keep their current value. Marks `managedByCode` by default.
+     */
+    upsertBySlug(input: UpsertTableBySlugInput): Promise<Table>;
+}
+
 type EligibleApprover = {
     workspaceUserId: string;
     email: string;
@@ -3545,6 +3634,8 @@ declare class LunnoaClient {
     readonly approvals: ApprovalsResource;
     readonly entities: EntitiesResource;
     readonly entityTypes: EntityTypesResource;
+    /** Small reference / lookup tables (rows stored inline; use entities for transactional data). */
+    readonly tables: TablesResource;
     readonly knowledge: KnowledgeResource;
     readonly queues: QueuesResource;
     readonly queueItems: QueueItemsResource;
@@ -3723,7 +3814,7 @@ interface UseAgentChatResult {
 /**
  * Thin AI SDK wrapper for Lunnoa agent chat.
  *
- * Requires optional peer `@ai-sdk/react` (and the `ai` package already shipped
+ * Uses `@ai-sdk/react` (and the `ai` package already shipped
  * with `@lunnoa/client`). Points `DefaultChatTransport` at the Automate
  * stream-message endpoint with a Bearer token from the auth provider.
  *