@engini/client 0.0.0 → 0.4.0

package/dist/index.d.cts

@@ -0,0 +1,4137 @@
+type AuthToken = string | undefined;
+interface Auth {
+    /**
+     * Which part of the request do we use to send the auth?
+     *
+     * @default 'header'
+     */
+    in?: 'header' | 'query' | 'cookie';
+    /**
+     * A unique identifier for the security scheme.
+     *
+     * Defined only when there are multiple security schemes whose `Auth`
+     * shape would otherwise be identical.
+     */
+    key?: string;
+    /**
+     * Header or query parameter name.
+     *
+     * @default 'Authorization'
+     */
+    name?: string;
+    scheme?: 'basic' | 'bearer';
+    type: 'apiKey' | 'http';
+}
+
+interface SerializerOptions<T> {
+    /**
+     * @default true
+     */
+    explode: boolean;
+    style: T;
+}
+type ArrayStyle = 'form' | 'spaceDelimited' | 'pipeDelimited';
+type ObjectStyle = 'form' | 'deepObject';
+
+type QuerySerializer = (query: Record<string, unknown>) => string;
+type BodySerializer = (body: unknown) => unknown;
+type QuerySerializerOptionsObject = {
+    allowReserved?: boolean;
+    array?: Partial<SerializerOptions<ArrayStyle>>;
+    object?: Partial<SerializerOptions<ObjectStyle>>;
+};
+type QuerySerializerOptions = QuerySerializerOptionsObject & {
+    /**
+     * Per-parameter serialization overrides. When provided, these settings
+     * override the global array/object settings for specific parameter names.
+     */
+    parameters?: Record<string, QuerySerializerOptionsObject>;
+};
+
+type HttpMethod = 'connect' | 'delete' | 'get' | 'head' | 'options' | 'patch' | 'post' | 'put' | 'trace';
+type Client$1<RequestFn = never, Config = unknown, MethodFn = never, BuildUrlFn = never, SseFn = never> = {
+    /**
+     * Returns the final request URL.
+     */
+    buildUrl: BuildUrlFn;
+    getConfig: () => Config;
+    request: RequestFn;
+    setConfig: (config: Config) => Config;
+} & {
+    [K in HttpMethod]: MethodFn;
+} & ([SseFn] extends [never] ? {
+    sse?: never;
+} : {
+    sse: {
+        [K in HttpMethod]: SseFn;
+    };
+});
+interface Config$1 {
+    /**
+     * Auth token or a function returning auth token. The resolved value will be
+     * added to the request payload as defined by its `security` array.
+     */
+    auth?: ((auth: Auth) => Promise<AuthToken> | AuthToken) | AuthToken;
+    /**
+     * A function for serializing request body parameter. By default,
+     * {@link JSON.stringify()} will be used.
+     */
+    bodySerializer?: BodySerializer | null;
+    /**
+     * An object containing any HTTP headers that you want to pre-populate your
+     * `Headers` object with.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/Headers/Headers#init See more}
+     */
+    headers?: RequestInit['headers'] | Record<string, string | number | boolean | (string | number | boolean)[] | null | undefined | unknown>;
+    /**
+     * The request method.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#method See more}
+     */
+    method?: Uppercase<HttpMethod>;
+    /**
+     * A function for serializing request query parameters. By default, arrays
+     * will be exploded in form style, objects will be exploded in deepObject
+     * style, and reserved characters are percent-encoded.
+     *
+     * This method will have no effect if the native `paramsSerializer()` Axios
+     * API function is used.
+     *
+     * {@link https://swagger.io/docs/specification/serialization/#query View examples}
+     */
+    querySerializer?: QuerySerializer | QuerySerializerOptions;
+    /**
+     * A function validating request data. This is useful if you want to ensure
+     * the request conforms to the desired shape, so it can be safely sent to
+     * the server.
+     */
+    requestValidator?: (data: unknown) => Promise<unknown>;
+    /**
+     * A function transforming response data before it's returned. This is useful
+     * for post-processing data, e.g., converting ISO strings into Date objects.
+     */
+    responseTransformer?: (data: unknown) => Promise<unknown>;
+    /**
+     * A function validating response data. This is useful if you want to ensure
+     * the response conforms to the desired shape, so it can be safely passed to
+     * the transformers and returned to the user.
+     */
+    responseValidator?: (data: unknown) => Promise<unknown>;
+}
+
+type ServerSentEventsOptions<TData = unknown> = Omit<RequestInit, 'method'> & Pick<Config$1, 'method' | 'responseTransformer' | 'responseValidator'> & {
+    /**
+     * Fetch API implementation. You can use this option to provide a custom
+     * fetch instance.
+     *
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Implementing clients can call request interceptors inside this hook.
+     */
+    onRequest?: (url: string, init: RequestInit) => Promise<Request>;
+    /**
+     * Callback invoked when a network or parsing error occurs during streaming.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @param error The error that occurred.
+     */
+    onSseError?: (error: unknown) => void;
+    /**
+     * Callback invoked when an event is streamed from the server.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @param event Event streamed from the server.
+     * @returns Nothing (void).
+     */
+    onSseEvent?: (event: StreamEvent<TData>) => void;
+    serializedBody?: RequestInit['body'];
+    /**
+     * Default retry delay in milliseconds.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @default 3000
+     */
+    sseDefaultRetryDelay?: number;
+    /**
+     * Maximum number of retry attempts before giving up.
+     */
+    sseMaxRetryAttempts?: number;
+    /**
+     * Maximum retry delay in milliseconds.
+     *
+     * Applies only when exponential backoff is used.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @default 30000
+     */
+    sseMaxRetryDelay?: number;
+    /**
+     * Optional sleep function for retry backoff.
+     *
+     * Defaults to using `setTimeout`.
+     */
+    sseSleepFn?: (ms: number) => Promise<void>;
+    url: string;
+};
+interface StreamEvent<TData = unknown> {
+    data: TData;
+    event?: string;
+    id?: string;
+    retry?: number;
+}
+type ServerSentEventsResult<TData = unknown, TReturn = void, TNext = unknown> = {
+    stream: AsyncGenerator<TData extends Record<string, unknown> ? TData[keyof TData] : TData, TReturn, TNext>;
+};
+
+type ErrInterceptor<Err, Res, Req, Options> = (error: Err, 
+/** response may be undefined due to a network error where no response object is produced */
+response: Res | undefined, 
+/** request may be undefined, because error may be from building the request object itself */
+request: Req | undefined, options: Options) => Err | Promise<Err>;
+type ReqInterceptor<Req, Options> = (request: Req, options: Options) => Req | Promise<Req>;
+type ResInterceptor<Res, Req, Options> = (response: Res, request: Req, options: Options) => Res | Promise<Res>;
+declare class Interceptors<Interceptor> {
+    fns: Array<Interceptor | null>;
+    clear(): void;
+    eject(id: number | Interceptor): void;
+    exists(id: number | Interceptor): boolean;
+    getInterceptorIndex(id: number | Interceptor): number;
+    update(id: number | Interceptor, fn: Interceptor): number | Interceptor | false;
+    use(fn: Interceptor): number;
+}
+interface Middleware<Req, Res, Err, Options> {
+    error: Interceptors<ErrInterceptor<Err, Res, Req, Options>>;
+    request: Interceptors<ReqInterceptor<Req, Options>>;
+    response: Interceptors<ResInterceptor<Res, Req, Options>>;
+}
+
+type ResponseStyle = 'data' | 'fields';
+interface Config<T extends ClientOptions$1 = ClientOptions$1> extends Omit<RequestInit, 'body' | 'headers' | 'method'>, Config$1 {
+    /**
+     * Base URL for all requests made by this client.
+     */
+    baseUrl?: T['baseUrl'];
+    /**
+     * Fetch API implementation. You can use this option to provide a custom
+     * fetch instance.
+     *
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Please don't use the Fetch client for Next.js applications. The `next`
+     * options won't have any effect.
+     *
+     * Install {@link https://www.npmjs.com/package/@hey-api/client-next `@hey-api/client-next`} instead.
+     */
+    next?: never;
+    /**
+     * Return the response data parsed in a specified format. By default, `auto`
+     * will infer the appropriate method from the `Content-Type` response header.
+     * You can override this behavior with any of the {@link Body} methods.
+     * Select `stream` if you don't want to parse response data at all.
+     *
+     * @default 'auto'
+     */
+    parseAs?: 'arrayBuffer' | 'auto' | 'blob' | 'formData' | 'json' | 'stream' | 'text';
+    /**
+     * Should we return only data or multiple fields (data, error, response, etc.)?
+     *
+     * @default 'fields'
+     */
+    responseStyle?: ResponseStyle;
+    /**
+     * Throw an error instead of returning it in the response?
+     *
+     * @default false
+     */
+    throwOnError?: T['throwOnError'];
+}
+interface RequestOptions<TData = unknown, TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends Config<{
+    responseStyle: TResponseStyle;
+    throwOnError: ThrowOnError;
+}>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+    /**
+     * Any body that you want to add to your request.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#body}
+     */
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    /**
+     * Security mechanism(s) to use for the request.
+     */
+    security?: ReadonlyArray<Auth>;
+    url: Url;
+}
+interface ResolvedRequestOptions<TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends RequestOptions<unknown, TResponseStyle, ThrowOnError, Url> {
+    headers: Headers;
+    serializedBody?: string;
+}
+type RequestResult<TData = unknown, TError = unknown, ThrowOnError extends boolean = boolean, TResponseStyle extends ResponseStyle = 'fields'> = ThrowOnError extends true ? Promise<TResponseStyle extends 'data' ? TData extends Record<string, unknown> ? TData[keyof TData] : TData : {
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    request: Request;
+    response: Response;
+}> : Promise<TResponseStyle extends 'data' ? (TData extends Record<string, unknown> ? TData[keyof TData] : TData) | undefined : ({
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    error: undefined;
+} | {
+    data: undefined;
+    error: TError extends Record<string, unknown> ? TError[keyof TError] : TError;
+}) & {
+    /** request may be undefined, because error may be from building the request object itself */
+    request?: Request;
+    /** response may be undefined, because error may be from building the request object itself or from a network error */
+    response?: Response;
+}>;
+interface ClientOptions$1 {
+    baseUrl?: string;
+    responseStyle?: ResponseStyle;
+    throwOnError?: boolean;
+}
+type MethodFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type SseFn = <TData = unknown, _TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<never, TResponseStyle, ThrowOnError>, 'method'>) => Promise<ServerSentEventsResult<TData>>;
+type RequestFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'> & Pick<Required<RequestOptions<TData, TResponseStyle, ThrowOnError>>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type BuildUrlFn = <TData extends {
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    url: string;
+}>(options: TData & Options$1<TData>) => string;
+type Client = Client$1<RequestFn, Config, MethodFn, BuildUrlFn, SseFn> & {
+    interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
+};
+interface TDataShape {
+    body?: unknown;
+    headers?: unknown;
+    path?: unknown;
+    query?: unknown;
+    url: string;
+}
+type OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;
+type Options$1<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
+
+type ClientOptions = {
+    baseUrl: 'https://feat-public-api.staging.engini.io/api' | (string & {});
+};
+/**
+ * Identity of the principal a Developer API request is authenticated as, returned by
+ * GET /api/DeveloperAPI/v1/auth/whoami. For x-api-key requests the identity is the
+ * token's owner (the key acts as the owner) and UserType is "apiuser".
+ */
+type WhoAmIResponse = {
+    /**
+     * The acting user's full name.
+     */
+    fullName?: string | null;
+    /**
+     * The acting user's email address.
+     */
+    email?: string | null;
+    /**
+     * Display name of the account/company the request is scoped to.
+     */
+    currentCompany?: string | null;
+    /**
+     * Role within the current company (e.g. "Admin", "Member").
+     */
+    role?: string | null;
+    /**
+     * Caller type: "apiuser" (x-api-key), "anonymous" (deleted profile), or "user".
+     */
+    userType: string;
+};
+/**
+ * Unified error envelope for every non-200 response from /api/DeveloperAPI/v1*.
+ * See applications-tools-spec.md §"Error envelope".
+ */
+type ErrorResponse = {
+    /**
+     * Machine-readable error code identifying the failure.
+     */
+    errorCode: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Identifier of the request, for support/correlation.
+     */
+    requestId: string;
+    /**
+     * Timestamp when the error occurred (ISO 8601).
+     */
+    timestamp: string;
+    /**
+     * Request path that produced the error.
+     */
+    path: string;
+    /**
+     * Per-field validation details, when applicable.
+     */
+    details?: Array<ErrorDetail> | null;
+};
+/**
+ * A single field-level error detail within an ErrorResponse.
+ */
+type ErrorDetail = {
+    /**
+     * Name of the field the issue relates to.
+     */
+    field: string;
+    /**
+     * Description of the issue with the field.
+     */
+    issue: string;
+};
+type SolutionAdminWriteResponse = {
+    /**
+     * The created or updated solution detail.
+     */
+    solution: SolutionDetailResponse;
+    /**
+     * Warnings produced while building the manifest.
+     */
+    warnings: Array<string>;
+};
+type SolutionDetailResponse = {
+    /**
+     * Identifier of the solution.
+     */
+    solutionId: number;
+    /**
+     * Unique slug of the solution.
+     */
+    slug: string;
+    /**
+     * Display name of the solution.
+     */
+    name: string;
+    /**
+     * Description of the solution.
+     */
+    description?: string | null;
+    /**
+     * URL of the solution's icon.
+     */
+    iconUrl?: string | null;
+    /**
+     * Current status of the solution.
+     */
+    status: string;
+    /**
+     * Current manifest version of the solution.
+     */
+    manifestVersion: number;
+    /**
+     * Number of times the solution has been installed.
+     */
+    installCount: number;
+    /**
+     * When the solution was created.
+     */
+    createdDate: string;
+    /**
+     * When the solution was last updated; null if never updated.
+     */
+    updatedDate?: string | null;
+    /**
+     * The serialized solution manifest JSON.
+     */
+    manifest: string;
+};
+type CreateSolutionRequest = {
+    /**
+     * Unique slug identifying the new solution.
+     */
+    slug: string;
+    /**
+     * Display name of the solution.
+     */
+    name: string;
+    /**
+     * Optional description of the solution.
+     */
+    description?: string | null;
+    /**
+     * Optional URL of the solution's icon.
+     */
+    iconUrl?: string | null;
+    /**
+     * Build inputs used to generate the solution manifest.
+     */
+    buildManifest: SolutionManifestBuildSpec;
+};
+type SolutionManifestBuildSpec = {
+    /**
+     * Workflows to include in the built manifest.
+     */
+    workflows: Array<BuildManifestWorkflow>;
+    /**
+     * Tables to include in the built manifest.
+     */
+    tables: Array<BuildManifestTable>;
+    /**
+     * Connections to include in the built manifest.
+     */
+    connections: Array<ManifestConnection>;
+    /**
+     * Optional manifest version; defaults when null.
+     */
+    version?: string | null;
+};
+type BuildManifestWorkflow = {
+    /**
+     * Identifier of the workflow to include.
+     */
+    workflowId: number;
+    /**
+     * Manifest-local key to assign the workflow.
+     */
+    key: string;
+    /**
+     * Optional display name for the workflow.
+     */
+    name?: string | null;
+    /**
+     * Whether the workflow is triggered by an incoming webhook.
+     */
+    isWebhookEntrypoint: boolean;
+};
+type BuildManifestTable = {
+    /**
+     * Identifier of the table to include.
+     */
+    tableId: string;
+    /**
+     * Manifest-local key to assign the table.
+     */
+    key: string;
+};
+/**
+ * A connection requirement declared by a solution manifest.
+ */
+type ManifestConnection = {
+    /**
+     * Manifest-local key used to reference this connection from workflows.
+     */
+    key: string;
+    /**
+     * Identifier of the application this connection is for.
+     */
+    applicationId: number;
+    /**
+     * Display label for the connection during install.
+     */
+    label?: string | null;
+    /**
+     * Whether the connection must be supplied to install the solution.
+     */
+    required: boolean;
+    /**
+     * Whether the connection requires a per-user token.
+     */
+    requiresUserToken: boolean;
+    /**
+     * Default configuration to seed the connection with.
+     */
+    defaultConfig?: ManifestConnectionDefaults | null;
+};
+/**
+ * Default configuration values for a manifest connection.
+ */
+type ManifestConnectionDefaults = {
+    /**
+     * Default base URL for the connection.
+     */
+    baseUrl?: string | null;
+};
+type UpdateSolutionRequest = {
+    /**
+     * New display name; null leaves it unchanged.
+     */
+    name?: string | null;
+    /**
+     * New description; null leaves it unchanged.
+     */
+    description?: string | null;
+    /**
+     * New icon URL; null leaves it unchanged.
+     */
+    iconUrl?: string | null;
+    /**
+     * New build inputs to rebuild the manifest; null leaves it unchanged.
+     */
+    buildManifest?: SolutionManifestBuildSpec | null;
+};
+type BuildManifestResponse = {
+    /**
+     * The built solution manifest.
+     */
+    manifest: SolutionManifest;
+    /**
+     * Warnings produced while building the manifest.
+     */
+    warnings: Array<string>;
+    /**
+     * Updated solution detail, populated only when a slug was supplied and the update succeeded.
+     */
+    solution?: SolutionDetailResponse | null;
+};
+/**
+ * The manifest describing the connections, tables, and workflows that make up a solution.
+ */
+type SolutionManifest = {
+    /**
+     * Manifest schema version.
+     */
+    version: string;
+    /**
+     * Connections the solution requires.
+     */
+    connections?: Array<ManifestConnection> | null;
+    /**
+     * Tables the solution provisions.
+     */
+    tables?: Array<ManifestTable> | null;
+    /**
+     * Workflows the solution provisions.
+     */
+    workflows?: Array<ManifestWorkflow> | null;
+};
+/**
+ * A table provisioned by a solution manifest.
+ */
+type ManifestTable = {
+    /**
+     * Manifest-local key used to reference this table.
+     */
+    key: string;
+    /**
+     * Definition of the table to provision.
+     */
+    definition: TableDefinitionDto;
+};
+/**
+ * Cross-service DTO describing a table to provision. Consumed by WorkappBackend's
+ * POST /api/v1/tables/provision endpoint when installing a solution.
+ */
+type TableDefinitionDto = {
+    /**
+     * Name of the table to provision.
+     */
+    name: string;
+    /**
+     * Description of the table.
+     */
+    description?: string | null;
+    /**
+     * Fields (columns) that make up the table.
+     */
+    fields: Array<TableFieldDto>;
+};
+/**
+ * Definition of a single field (column) within a TableDefinitionDto.
+ */
+type TableFieldDto = {
+    /**
+     * Logical name of the field.
+     */
+    fieldName: string;
+    /**
+     * Matches Engini.Models.WorkappModels.DbModels.FieldTypeEnum
+     * (String=2, Bool=3, DateTime=5, Integer=6, Numeric=7, Dropdown=10, ...).
+     */
+    fieldTypeId: number;
+    /**
+     * Display name shown for the field.
+     */
+    displayName?: string | null;
+    /**
+     * Default value for the field.
+     */
+    defaultValue?: string | null;
+    /**
+     * Ordinal position of the field within the table.
+     */
+    fieldOrder: number;
+    /**
+     * Whether the field is the table's primary key.
+     */
+    isPrimaryKey: boolean;
+    /**
+     * Whether the field is required.
+     */
+    isMandatory: boolean;
+    /**
+     * Whether the field is hidden from default views.
+     */
+    isHidden: boolean;
+    /**
+     * Whether the field allows selecting multiple values.
+     */
+    isMultiSelect: boolean;
+    /**
+     * JSON-serialized picklist values for Dropdown/Status/Labels field types.
+     * Shape matches TableFieldPicklist.
+     */
+    picklistJson?: string | null;
+    /**
+     * Physical column name in storage. When omitted on provisioning, falls back to FieldName.
+     */
+    databaseFieldName?: string | null;
+    /**
+     * Physical storage table name when the field is stored outside the default per-table layout.
+     */
+    databaseFieldLocationTable?: string | null;
+};
+/**
+ * A workflow provisioned by a solution manifest.
+ */
+type ManifestWorkflow = {
+    /**
+     * Manifest-local key used to reference this workflow.
+     */
+    key: string;
+    /**
+     * Display name of the workflow.
+     */
+    name?: string | null;
+    /**
+     * The serialized workflow definition as an opaque JSON object. The internal shape is the
+     * engine's workflow graph and is not part of the public contract, so it is left untyped
+     * (api-spec-feedback.md C3) — treat it as an opaque blob to round-trip during install.
+     */
+    definition?: unknown;
+    /**
+     * Maps the workflow's connection references to manifest connection keys.
+     */
+    connectionMapping?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * Whether this workflow is triggered by an incoming webhook.
+     */
+    isWebhookEntrypoint: boolean;
+};
+type BuildManifestRequest = {
+    /**
+     * Workflows to include in the built manifest.
+     */
+    workflows: Array<BuildManifestWorkflow>;
+    /**
+     * Tables to include in the built manifest.
+     */
+    tables: Array<BuildManifestTable>;
+    /**
+     * Connections to include in the built manifest.
+     */
+    connections: Array<ManifestConnection>;
+    /**
+     * Optional manifest version; defaults when null.
+     */
+    version?: string | null;
+    /**
+     * When set, updates the existing solution with this slug after building the manifest; omit to build only.
+     */
+    slug?: string | null;
+};
+/**
+ * Offset-based paginated wrapper for a list of items.
+ */
+type PaginatedResponseOfSolutionResponse = {
+    /**
+     * The items in the current page.
+     */
+    items: Array<SolutionResponse>;
+    /**
+     * Total number of items available across all pages.
+     */
+    totalCount: number;
+    /**
+     * Number of items skipped before this page (the requested offset).
+     */
+    offset: number;
+    /**
+     * Maximum number of items requested for this page.
+     */
+    top: number;
+};
+type SolutionResponse = {
+    /**
+     * Identifier of the solution.
+     */
+    solutionId: number;
+    /**
+     * Unique slug of the solution.
+     */
+    slug: string;
+    /**
+     * Display name of the solution.
+     */
+    name: string;
+    /**
+     * Description of the solution.
+     */
+    description?: string | null;
+    /**
+     * URL of the solution's icon.
+     */
+    iconUrl?: string | null;
+    /**
+     * Current status of the solution.
+     */
+    status: string;
+    /**
+     * Current manifest version of the solution.
+     */
+    manifestVersion: number;
+    /**
+     * Number of times the solution has been installed.
+     */
+    installCount: number;
+    /**
+     * When the solution was created.
+     */
+    createdDate: string;
+    /**
+     * When the solution was last updated; null if never updated.
+     */
+    updatedDate?: string | null;
+};
+type SolutionInstallationResponse = {
+    /**
+     * Identifier of the installation.
+     */
+    solutionInstallationId: number;
+    /**
+     * Identifier of the installed solution.
+     */
+    solutionId: number;
+    /**
+     * Display name of the installed solution.
+     */
+    solutionName?: string | null;
+    /**
+     * Slug of the installed solution.
+     */
+    slug?: string | null;
+    /**
+     * Workspace the solution is installed in.
+     */
+    workspaceId: string;
+    /**
+     * Environment the solution is installed in.
+     */
+    environmentId: string;
+    /**
+     * Manifest version that is currently installed.
+     */
+    installedManifestVersion: number;
+    /**
+     * Whether the installation auto-updates to new versions.
+     */
+    autoUpdate: boolean;
+    /**
+     * Whether a newer manifest version is available.
+     */
+    updateAvailable: boolean;
+    /**
+     * Current status of the installation.
+     */
+    status: string;
+    /**
+     * When the solution was installed.
+     */
+    installedDate: string;
+};
+type InstallationDetailResponse = {
+    /**
+     * Identifier of the installation.
+     */
+    solutionInstallationId: number;
+    /**
+     * Identifier of the installed solution.
+     */
+    solutionId: number;
+    /**
+     * Display name of the installed solution.
+     */
+    solutionName?: string | null;
+    /**
+     * Slug of the installed solution.
+     */
+    slug?: string | null;
+    /**
+     * Workspace the solution is installed in.
+     */
+    workspaceId: string;
+    /**
+     * Environment the solution is installed in.
+     */
+    environmentId: string;
+    /**
+     * Manifest version that is currently installed.
+     */
+    installedManifestVersion: number;
+    /**
+     * Whether the installation auto-updates to new versions.
+     */
+    autoUpdate: boolean;
+    /**
+     * Whether a newer manifest version is available.
+     */
+    updateAvailable: boolean;
+    /**
+     * Current status of the installation.
+     */
+    status: string;
+    /**
+     * When the solution was installed.
+     */
+    installedDate: string;
+    /**
+     * Resources provisioned by this installation.
+     */
+    installedResources: Array<InstalledResourceResponse>;
+};
+type InstalledResourceResponse = {
+    /**
+     * Identifier of the installed resource record.
+     */
+    installedResourceId: number;
+    /**
+     * Type of the provisioned resource (e.g. connection, table, workflow).
+     */
+    resourceType: string;
+    /**
+     * Manifest-local key of the resource.
+     */
+    resourceKey: string;
+    /**
+     * Identifier of the provisioned resource in the target system.
+     */
+    resourceId: string;
+    /**
+     * Optional metadata about the resource.
+     */
+    metadata?: string | null;
+    /**
+     * Webhook URL for the resource, when applicable.
+     */
+    webhookUrl?: string | null;
+};
+type InstallSolutionResponse = {
+    /**
+     * Identifier of the created installation.
+     */
+    installationId: number;
+    /**
+     * Resources provisioned during installation.
+     */
+    resources: Array<ProvisionedResourceInfo>;
+};
+type ProvisionedResourceInfo = {
+    /**
+     * Type of the provisioned resource (e.g. connection, table, workflow).
+     */
+    resourceType: string;
+    /**
+     * Manifest-local key of the resource.
+     */
+    resourceKey: string;
+    /**
+     * Identifier of the provisioned resource in the target system.
+     */
+    resourceId: string;
+    /**
+     * Webhook URL for the resource, when applicable.
+     */
+    webhookUrl?: string | null;
+    /**
+     * Webhook token for the resource, when applicable.
+     */
+    webhookToken?: string | null;
+};
+type InstallSolutionRequest = {
+    /**
+     * Workspace to install the solution into.
+     */
+    workspaceId: string;
+    /**
+     * Environment to install the solution into.
+     */
+    environmentId: string;
+    /**
+     * Maps manifest connection keys to existing connection IDs to reuse.
+     */
+    existingConnections?: {
+        [key: string]: number;
+    } | null;
+    /**
+     * Maps manifest connection keys to new connection inputs to create.
+     */
+    connectionMapping?: {
+        [key: string]: ConnectionInput;
+    } | null;
+    /**
+     * Whether the installation should auto-update to new versions.
+     */
+    autoUpdate: boolean;
+    /**
+     * Optional external context passed through to provisioning.
+     */
+    externalContext?: string | null;
+};
+type ConnectionInput = {
+    /**
+     * API key credential for the connection.
+     */
+    apiKey?: string | null;
+    /**
+     * Base URL for the connection.
+     */
+    baseUrl?: string | null;
+    /**
+     * Additional custom credential/config values, keyed by name.
+     */
+    customKeys?: {
+        [key: string]: string;
+    } | null;
+};
+type UpdateInstallationResponse = {
+    /**
+     * Identifier of the updated installation.
+     */
+    installationId: number;
+    /**
+     * Manifest version before the update.
+     */
+    fromVersion: number;
+    /**
+     * Manifest version after the update.
+     */
+    toVersion: number;
+    /**
+     * Resources provisioned or updated during the update.
+     */
+    resources: Array<ProvisionedResourceInfo>;
+    /**
+     * Webhook URLs that were invalidated by the update.
+     */
+    brokenWebhookUrls: Array<string>;
+};
+type UpdateBlockedResponse = {
+    /**
+     * The blockers preventing the update.
+     */
+    blockers: Array<UpdateBlocker>;
+};
+type UpdateBlocker = {
+    /**
+     * Type of resource that blocks the update.
+     */
+    type: string;
+    /**
+     * Manifest-local key of the blocking resource.
+     */
+    key: string;
+    /**
+     * Reason the resource blocks the update.
+     */
+    reason: string;
+};
+type UpdateInstallationRequest = {
+    /**
+     * Whether to proceed with the update despite blockers/local modifications.
+     */
+    forceModify: boolean;
+};
+type UninstallSolutionRequest = {
+    /**
+     * Identifier of the installation to uninstall.
+     */
+    installationId: number;
+    /**
+     * Whether to also delete connections provisioned by the installation.
+     */
+    deleteConnections: boolean;
+    /**
+     * Whether to also delete workflows provisioned by the installation.
+     */
+    deleteWorkflows: boolean;
+    /**
+     * Whether to also delete tables provisioned by the installation.
+     */
+    deleteTables: boolean;
+};
+/**
+ * Offset-based paginated wrapper for a list of items.
+ */
+type PaginatedResponseOfApplicationDto = {
+    /**
+     * The items in the current page.
+     */
+    items: Array<ApplicationDto>;
+    /**
+     * Total number of items available across all pages.
+     */
+    totalCount: number;
+    /**
+     * Number of items skipped before this page (the requested offset).
+     */
+    offset: number;
+    /**
+     * Maximum number of items requested for this page.
+     */
+    top: number;
+};
+/**
+ * Public Developer API v1 representation of an Application.
+ * Returned by GET /api/DeveloperAPI/v1/applications.
+ */
+type ApplicationDto = {
+    /**
+     * Stable public slug identifying the application.
+     */
+    slug: string;
+    /**
+     * Human-readable display name of the application.
+     */
+    applicationName?: string | null;
+    /**
+     * Description of what the application does.
+     */
+    description: string;
+    /**
+     * URL of the application's logo image.
+     */
+    applicationLogo?: string | null;
+    /**
+     * Whether and how a connection is required to use this application.
+     */
+    connectionRequirement: string;
+    /**
+     * Categories the application belongs to.
+     */
+    categories: Array<string>;
+    /**
+     * Number of tools (activities) the application exposes.
+     */
+    toolsCount: number;
+    /**
+     * Number of triggers the application exposes.
+     */
+    triggersCount: number;
+};
+type ApplicationDetailDto = ApplicationDto & {
+    /**
+     * Whether the application supports selecting specific objects for a connection.
+     */
+    supportsObjectSelection?: boolean;
+    /**
+     * URL of help/documentation for the application.
+     */
+    helpUrl?: string | null;
+    /**
+     * Authentication methods supported by the application.
+     */
+    authenticationMethods?: Array<ApplicationAuthMethod>;
+};
+type ApplicationAuthMethod = {
+    authenticationId: number;
+    authenticationType: string;
+    authenticationName: string;
+    description?: string | null;
+    connectionFields: Array<ApplicationConnectionField>;
+    requiresOAuthSignIn: boolean;
+    oAuthProvider?: string | null;
+};
+type ApplicationConnectionField = {
+    fieldName: string;
+    fieldDescription?: string | null;
+    isRequired: boolean;
+    isRequiredOnSignin: boolean;
+    isHidden: boolean;
+    isPassword: boolean;
+    inputType: AppConnectionFieldInputType;
+    defaultValue?: string | null;
+    tooltip?: string | null;
+    placeholder?: string | null;
+    listValues?: string | null;
+    /**
+     * When true, callers can supply this field's value per-execution via the
+     * `customConnectionData` array on POST /tools/{toolSlug}/execute. Mirrors
+     * AppConnectionField.AllowOverride.
+     */
+    allowOverride: boolean;
+};
+type AppConnectionFieldInputType = 0 | 1 | 2 | 3;
+/**
+ * Offset-based paginated wrapper for a list of items.
+ */
+type PaginatedResponseOfConnectionPublicListItem = {
+    /**
+     * The items in the current page.
+     */
+    items: Array<ConnectionPublicListItem>;
+    /**
+     * Total number of items available across all pages.
+     */
+    totalCount: number;
+    /**
+     * Number of items skipped before this page (the requested offset).
+     */
+    offset: number;
+    /**
+     * Maximum number of items requested for this page.
+     */
+    top: number;
+};
+/**
+ * Public-shape list item for /api/DeveloperAPI/v1/Connections.
+ * Applications are identified by slug only (no ApplicationId in the wire response).
+ * Internal queries continue to use ConnectionList which carries both.
+ */
+type ConnectionPublicListItem = {
+    /**
+     * Identifier of the connection.
+     */
+    connectionId: number;
+    /**
+     * Display name of the connection.
+     */
+    connectionName: string;
+    /**
+     * Description of the connection.
+     */
+    description?: string | null;
+    /**
+     * Slug of the connection's application.
+     */
+    applicationSlug: string;
+    /**
+     * Display name of the connection's application.
+     */
+    applicationName?: string | null;
+    /**
+     * URL of the application's logo image.
+     */
+    applicationLogo?: string | null;
+    /**
+     * Whether the connection is shared/public.
+     */
+    isPublic: boolean;
+    /**
+     * Identifier of the user who created the connection.
+     */
+    createdBy: string;
+    /**
+     * When the connection was created.
+     */
+    createdDate: string;
+    /**
+     * Identifier of the user who last updated the connection; null if never updated.
+     */
+    updatedBy?: string | null;
+    /**
+     * When the connection was last updated; null if never updated.
+     */
+    updatedDate?: string | null;
+};
+type ConnectionPublicDetail = ConnectionPublicListItem & {
+    /**
+     * Identifier of the authentication method used by the connection.
+     */
+    authenticationId?: number;
+    /**
+     * Name of the authentication type used by the connection.
+     */
+    authenticationType?: string;
+    /**
+     * Connection field values, keyed by field name (sensitive values may be masked).
+     */
+    fields?: {
+        [key: string]: string | null;
+    };
+    /**
+     * Whether the connection uses selected database objects.
+     */
+    useSelectDBObjects?: boolean;
+    /**
+     * Last connection error message, if any.
+     */
+    connectionError?: string | null;
+    /**
+     * Whether the connection is currently healthy/reachable.
+     */
+    isAlive?: boolean;
+    /**
+     * Additional connection metadata, keyed by name.
+     */
+    metadata?: {
+        [key: string]: string;
+    } | null;
+};
+/**
+ * Request body for creating a connection.
+ */
+type CreateConnectionRequest = {
+    /**
+     * Slug of the application to connect to.
+     */
+    applicationSlug: string;
+    /**
+     * Display name for the new connection.
+     */
+    connectionName: string;
+    /**
+     * Optional description of the connection.
+     */
+    description?: string | null;
+    /**
+     * Identifier of the authentication method to use.
+     */
+    authenticationId: number;
+    /**
+     * Connection field values, keyed by field name.
+     */
+    fields: {
+        [key: string]: string;
+    };
+    /**
+     * Optional additional connection metadata, keyed by name.
+     */
+    metadata?: {
+        [key: string]: string;
+    } | null;
+};
+/**
+ * Request body for updating a connection; null members are left unchanged.
+ */
+type UpdateConnectionRequest = {
+    /**
+     * New display name; null leaves it unchanged.
+     */
+    connectionName?: string | null;
+    /**
+     * New description; null leaves it unchanged.
+     */
+    description?: string | null;
+    /**
+     * Connection field values to update, keyed by field name; null leaves them unchanged.
+     */
+    fields?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * Metadata to update, keyed by name; null leaves it unchanged.
+     */
+    metadata?: {
+        [key: string]: string;
+    } | null;
+};
+/**
+ * Response listing the caller's default connection per application.
+ */
+type DefaultConnectionsResponse = {
+    /**
+     * The default-connection entries, one per application.
+     */
+    items: Array<DefaultConnectionDto>;
+};
+/**
+ * Per-(account-user, application) default-connection responses for the
+ * /connections/defaults endpoints. See toolsets-and-connections-spec.md.
+ */
+type DefaultConnectionDto = {
+    /**
+     * Slug of the application this default applies to.
+     */
+    applicationSlug: string;
+    /**
+     * Display name of the application.
+     */
+    applicationName?: string | null;
+    /**
+     * Identifier of the default connection (Connector ID).
+     */
+    connectionId: number;
+    /**
+     * Display name of the default connection.
+     */
+    connectionName?: string | null;
+};
+/**
+ * Response confirming a connection was set as the default for an application.
+ */
+type SetDefaultConnectionResponse = {
+    /**
+     * Slug of the application the default was set for.
+     */
+    applicationSlug: string;
+    /**
+     * Identifier of the connection set as default.
+     */
+    connectionId: number;
+    /**
+     * Whether the connection is now the default (always true).
+     */
+    isDefault: boolean;
+};
+/**
+ * Request body for replacing a connection used by a workflow.
+ */
+type ReplaceConnectionRequest = {
+    /**
+     * Identifier of the workflow whose connection is being replaced.
+     */
+    workflowId: number;
+    /**
+     * Identifier of the connection currently used by the workflow.
+     */
+    originalConnectionId: number;
+    /**
+     * Identifier of the connection to use instead.
+     */
+    newConnectionId: number;
+};
+/**
+ * Status of a connection's most recent metadata/object refresh.
+ */
+type RefreshStatusResponse = {
+    /**
+     * Current refresh status.
+     */
+    status: RefreshStatus;
+    /**
+     * Human-readable description of the current status.
+     */
+    statusDescription?: string | null;
+    /**
+     * Error message from the last failed refresh, if any.
+     */
+    error?: string | null;
+    /**
+     * When the last error occurred, if any.
+     */
+    errorDate?: string | null;
+    /**
+     * When the connection was last refreshed successfully.
+     */
+    lastRefreshDate?: string | null;
+};
+/**
+ * Possible states of a connection refresh.
+ */
+type RefreshStatus = 0 | 1 | 2;
+/**
+ * Request body for selecting which objects a connection exposes.
+ */
+type SelectObjectsRequest = {
+    /**
+     * Identifiers of the objects to select for the connection.
+     */
+    objectIds: Array<number>;
+};
+/**
+ * Offset-based paginated wrapper for a list of items.
+ */
+type PaginatedResponseOfConnectionObject = {
+    /**
+     * The items in the current page.
+     */
+    items: Array<ConnectionObject>;
+    /**
+     * Total number of items available across all pages.
+     */
+    totalCount: number;
+    /**
+     * Number of items skipped before this page (the requested offset).
+     */
+    offset: number;
+    /**
+     * Maximum number of items requested for this page.
+     */
+    top: number;
+};
+type ConnectionObject = {
+    objectId: number;
+    name: string;
+    type: string;
+    isSelected: boolean;
+};
+/**
+ * Response containing a generated OAuth sign-in URL.
+ */
+type SignInUrlResponse = {
+    /**
+     * The URL the user should visit to authenticate.
+     */
+    signInUrl: string;
+    /**
+     * Opaque state value tying the sign-in flow back to the request.
+     */
+    state: string;
+};
+/**
+ * Request body for generating an OAuth sign-in URL.
+ */
+type SignInUrlRequest = {
+    /**
+     * Slug of the application to authenticate against.
+     */
+    applicationSlug: string;
+    /**
+     * Identifier of the authentication method to use.
+     */
+    authenticationId: number;
+    /**
+     * Optional environment to target for sign-in.
+     */
+    environment?: string | null;
+    /**
+     * Optional field values required to build the sign-in URL, keyed by field name.
+     */
+    fields?: {
+        [key: string]: string;
+    } | null;
+};
+type AccessTokenResponse = {
+    status: string;
+    error_message?: string | null;
+    tokenData: {
+        [key: string]: unknown;
+    };
+    connectionData: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Offset-based paginated wrapper for a list of items.
+ */
+type PaginatedResponseOfToolDto = {
+    /**
+     * The items in the current page.
+     */
+    items: Array<ToolDto>;
+    /**
+     * Total number of items available across all pages.
+     */
+    totalCount: number;
+    /**
+     * Number of items skipped before this page (the requested offset).
+     */
+    offset: number;
+    /**
+     * Maximum number of items requested for this page.
+     */
+    top: number;
+};
+/**
+ * Public Developer API v1 representation of a tool (Activity).
+ * Returned by GET /api/DeveloperAPI/v1/tools.
+ */
+type ToolDto = {
+    /**
+     * Public identifier, sourced from Activity.McpToolName.
+     */
+    toolSlug: string;
+    /**
+     * Human-readable display name of the tool.
+     */
+    toolName?: string | null;
+    /**
+     * Description of what the tool does.
+     */
+    description?: string | null;
+    /**
+     * Category the tool belongs to.
+     */
+    category: string;
+    /**
+     * Slug of the application this tool belongs to.
+     */
+    applicationSlug: string;
+    /**
+     * Display name of the application this tool belongs to.
+     */
+    applicationName?: string | null;
+    /**
+     * Version of the tool.
+     */
+    version?: string | null;
+    /**
+     * Whether the tool is deprecated.
+     */
+    isDeprecated: boolean;
+};
+type ToolDetailDto = ToolDto & {
+    /**
+     * JSON Schema describing the tool's input fields.
+     */
+    inputSchema?: unknown;
+    /**
+     * JSON Schema describing the tool's output shape.
+     */
+    outputSchema?: unknown;
+    /**
+     * Whether the tool supports filter conditions on execution.
+     */
+    supportsFilters?: boolean;
+    /**
+     * Whether the tool supports sort ordering on execution.
+     */
+    supportsSort?: boolean;
+    /**
+     * Whether the tool supports top/offset pagination on execution.
+     */
+    supportsTopOffset?: boolean;
+    /**
+     * Maximum number of filter conditions allowed per execution.
+     */
+    maxFilters?: number;
+    /**
+     * Maximum number of sort clauses allowed per execution.
+     */
+    maxSorts?: number;
+};
+/**
+ * 200 response shape for POST /api/DeveloperAPI/v1/tools/{toolSlug}/execute.
+ * Tool-runtime failures (downstream API errors) return 200 + IsSuccess=false
+ * + ErrorMessage — not the standard error envelope. All non-200 responses use
+ * the standard ErrorResponse envelope, not this type.
+ * See applications-tools-spec.md §"Response 200".
+ */
+type ToolExecuteResponse = {
+    /**
+     * Whether the tool executed successfully. When false, see ErrorMessage.
+     */
+    isSuccess: boolean;
+    /**
+     * Human-readable failure reason when IsSuccess is false; otherwise null.
+     */
+    errorMessage?: string | null;
+    /**
+     * Metadata about the execution (HTTP status, headers, timing, payload size).
+     */
+    executionInfo?: ExecutionInfo | null;
+    /**
+     * The tool's result payload. Intentionally free-form (any JSON): its shape is defined by the
+     * individual tool's output schema, not by this envelope (api-spec-feedback.md C3).
+     */
+    output?: unknown;
+    /**
+     * Identifier of the workflow-history record for this execution, when one was created.
+     */
+    historyId?: number | null;
+};
+/**
+ * Metadata about a tool execution (downstream HTTP status, headers, timing, payload size).
+ */
+type ExecutionInfo = {
+    /**
+     * HTTP status code returned by the downstream call.
+     */
+    statusCode?: number | null;
+    /**
+     * Response headers from the downstream call, keyed by header name.
+     */
+    headers?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * Execution time in milliseconds.
+     */
+    executionTime?: number | null;
+    /**
+     * Size of the response payload in bytes.
+     */
+    dataSize?: number | null;
+};
+/**
+ * Body shape for POST /api/DeveloperAPI/v1/tools/{toolSlug}/execute.
+ * activityName is intentionally absent — the activity is resolved from the
+ * path slug (+ optional ?applicationSlug=). Connection is resolved implicitly
+ * from the caller's account-user, the tool's parent application, and the
+ * optional ?toolsetId= query param. See applications-tools-spec.md §"POST
+ * /api/DeveloperAPI/v1/tools/{toolSlug}/execute".
+ */
+type ToolExecuteRequest = {
+    /**
+     * Input field values for the tool, keyed by field name.
+     */
+    fields?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Optional context value passed to the tool.
+     */
+    contextValue?: string | null;
+    /**
+     * Filter conditions to apply to the tool's results.
+     */
+    filters?: Array<ActivityCondition> | null;
+    /**
+     * Sort clauses to apply to the tool's results.
+     */
+    sort?: Array<ActivitySort> | null;
+    /**
+     * Number of leading results to skip (pagination offset).
+     */
+    offset?: number | null;
+    /**
+     * Maximum number of results to return.
+     */
+    top?: number | null;
+    /**
+     * Sub-item input values for the tool, keyed by name.
+     */
+    subItems?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Per-call overrides for the resolved connection's fields; only fields marked overridable are accepted.
+     */
+    customConnectionData?: Array<CustomConnectionDataItem> | null;
+};
+type ActivityCondition = {
+    fieldName: string;
+    operator: string;
+    value: string;
+};
+type ActivitySort = {
+    fieldName: string;
+    orderDirection: OrderDirection;
+};
+type OrderDirection = 1 | -1;
+/**
+ * A single per-call override of a connection field value.
+ */
+type CustomConnectionDataItem = {
+    /**
+     * Name of the connection field to override.
+     */
+    fieldName: string;
+    /**
+     * Override value for the field.
+     */
+    value: string;
+};
+/**
+ * Offset-based paginated wrapper for a list of items.
+ */
+type PaginatedResponseOfToolsetDto = {
+    /**
+     * The items in the current page.
+     */
+    items: Array<ToolsetDto>;
+    /**
+     * Total number of items available across all pages.
+     */
+    totalCount: number;
+    /**
+     * Number of items skipped before this page (the requested offset).
+     */
+    offset: number;
+    /**
+     * Maximum number of items requested for this page.
+     */
+    top: number;
+};
+/**
+ * Public-shape DTO for a toolset (per-account-user, named scope bundling specific
+ * connections + an allowed tool set). See toolsets-and-connections-spec.md.
+ */
+type ToolsetDto = {
+    /**
+     * Unique identifier of the toolset (the MCPServer token GUID).
+     */
+    toolsetId: string;
+    /**
+     * Display name of the toolset.
+     */
+    name: string;
+    /**
+     * Connections included in this toolset and their permitted tools.
+     */
+    connections: Array<ToolsetConnectionDto>;
+    /**
+     * Workflow token GUIDs included in this toolset.
+     */
+    workflows: Array<string>;
+    /**
+     * When the toolset was created.
+     */
+    createdDate: string;
+    /**
+     * When the toolset was last updated; null if never updated.
+     */
+    updatedDate?: string | null;
+    /**
+     * Account-user ID that created the toolset.
+     */
+    createdByAccountUserId?: number | null;
+    /**
+     * Account-user ID that last updated the toolset; null/0 until first updated.
+     */
+    updatedByAccountUserId?: number | null;
+};
+/**
+ * A connection within a toolset, scoped to a set of permitted tools.
+ */
+type ToolsetConnectionDto = {
+    /**
+     * Identifier of the connection (Connector ID).
+     */
+    connectionId: number;
+    /**
+     * Slug of the connection's application.
+     */
+    applicationSlug: string;
+    /**
+     * Display name of the connection's application.
+     */
+    applicationName?: string | null;
+    /**
+     * Tool slugs permitted for this connection; empty means all tools of the app are permitted.
+     */
+    toolSlugs: Array<string>;
+};
+/**
+ * Request body for creating a toolset.
+ */
+type CreateToolsetRequest = {
+    /**
+     * Display name for the new toolset.
+     */
+    name: string;
+    /**
+     * Connections to include in the toolset and their permitted tools.
+     */
+    connections: Array<ToolsetConnectionRequest>;
+    /**
+     * Workflow token GUIDs to include in the toolset.
+     */
+    workflows?: Array<string> | null;
+};
+/**
+ * A connection entry in a create/update toolset request.
+ */
+type ToolsetConnectionRequest = {
+    /**
+     * Optional connection identifier (Connector ID). Omit it to let the backend pick the
+     * caller's default connection for the application of the listed tools (resolved and
+     * stored as a concrete id at save time); when omitted, ToolSlugs must list
+     * at least one tool so the application can be determined.
+     */
+    connectionId?: number | null;
+    /**
+     * Optional application slug. When ConnectionId is omitted, supply this to
+     * scope the entry to a whole application (all its tools) using the caller's default
+     * connection for that app — resolved and stored as a concrete connectionId at save time.
+     * An alternative to listing tool slugs; if both are supplied, applicationSlug is
+     * authoritative for the application.
+     */
+    applicationSlug?: string | null;
+    /**
+     * Tool slugs to permit for this connection; omit/empty to permit all tools of the app. When ConnectionId is omitted, supply either applicationSlug or at least one tool slug.
+     */
+    toolSlugs?: Array<string> | null;
+};
+/**
+ * Request body for updating a toolset; null members are left unchanged.
+ */
+type UpdateToolsetRequest = {
+    /**
+     * New display name; null leaves it unchanged.
+     */
+    name?: string | null;
+    /**
+     * Replacement connection set; null leaves it unchanged.
+     */
+    connections?: Array<ToolsetConnectionRequest> | null;
+    /**
+     * Replacement workflow set; null leaves it unchanged.
+     */
+    workflows?: Array<string> | null;
+};
+type AuthWhoAmIData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/auth/whoami';
+};
+type AuthWhoAmIErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type AuthWhoAmIError = AuthWhoAmIErrors[keyof AuthWhoAmIErrors];
+type AuthWhoAmIResponses = {
+    /**
+     * The acting principal's identity.
+     */
+    200: WhoAmIResponse;
+};
+type AuthWhoAmIResponse = AuthWhoAmIResponses[keyof AuthWhoAmIResponses];
+type SolutionsCreateSolutionData = {
+    /**
+     * The solution metadata and build manifest used to create the solution.
+     */
+    body: CreateSolutionRequest;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/solutions/admin';
+};
+type SolutionsCreateSolutionErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsCreateSolutionError = SolutionsCreateSolutionErrors[keyof SolutionsCreateSolutionErrors];
+type SolutionsCreateSolutionResponses = {
+    /**
+     * The newly created solution along with any manifest build warnings.
+     */
+    200: SolutionAdminWriteResponse;
+};
+type SolutionsCreateSolutionResponse = SolutionsCreateSolutionResponses[keyof SolutionsCreateSolutionResponses];
+type SolutionsArchiveSolutionData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the solution to archive.
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/v1/solutions/admin/{slug}';
+};
+type SolutionsArchiveSolutionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsArchiveSolutionError = SolutionsArchiveSolutionErrors[keyof SolutionsArchiveSolutionErrors];
+type SolutionsArchiveSolutionResponses = {
+    /**
+     * No content on success.
+     */
+    204: void;
+};
+type SolutionsArchiveSolutionResponse = SolutionsArchiveSolutionResponses[keyof SolutionsArchiveSolutionResponses];
+type SolutionsUpdateSolutionData = {
+    /**
+     * The updated solution metadata and optional build manifest.
+     */
+    body: UpdateSolutionRequest;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the solution to update.
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/v1/solutions/admin/{slug}';
+};
+type SolutionsUpdateSolutionErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsUpdateSolutionError = SolutionsUpdateSolutionErrors[keyof SolutionsUpdateSolutionErrors];
+type SolutionsUpdateSolutionResponses = {
+    /**
+     * The updated solution along with any manifest build warnings.
+     */
+    200: SolutionAdminWriteResponse;
+};
+type SolutionsUpdateSolutionResponse = SolutionsUpdateSolutionResponses[keyof SolutionsUpdateSolutionResponses];
+type SolutionsPublishSolutionData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the solution to publish.
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/v1/solutions/admin/{slug}/publish';
+};
+type SolutionsPublishSolutionErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsPublishSolutionError = SolutionsPublishSolutionErrors[keyof SolutionsPublishSolutionErrors];
+type SolutionsPublishSolutionResponses = {
+    /**
+     * The published solution detail.
+     */
+    200: SolutionDetailResponse;
+};
+type SolutionsPublishSolutionResponse = SolutionsPublishSolutionResponses[keyof SolutionsPublishSolutionResponses];
+type SolutionsBuildManifestData = {
+    /**
+     * The manifest build inputs and an optional slug of an existing solution to update.
+     */
+    body: BuildManifestRequest;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/solutions/admin/build-manifest';
+};
+type SolutionsBuildManifestErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsBuildManifestError = SolutionsBuildManifestErrors[keyof SolutionsBuildManifestErrors];
+type SolutionsBuildManifestResponses = {
+    /**
+     * The built manifest with any warnings, plus the updated solution when a slug was supplied.
+     */
+    200: BuildManifestResponse;
+};
+type SolutionsBuildManifestResponse = SolutionsBuildManifestResponses[keyof SolutionsBuildManifestResponses];
+type SolutionsGetPublishedSolutionsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: {
+        /**
+         * Optional search term to filter solutions by.
+         */
+        Search?: string | null;
+        /**
+         * Number of items to skip (pagination offset).
+         */
+        Offset?: number;
+        /**
+         * Maximum number of items to return.
+         */
+        Top?: number;
+    };
+    url: '/v1/solutions';
+};
+type SolutionsGetPublishedSolutionsErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsGetPublishedSolutionsError = SolutionsGetPublishedSolutionsErrors[keyof SolutionsGetPublishedSolutionsErrors];
+type SolutionsGetPublishedSolutionsResponses = {
+    /**
+     * A paginated collection of published solutions.
+     */
+    200: PaginatedResponseOfSolutionResponse;
+};
+type SolutionsGetPublishedSolutionsResponse = SolutionsGetPublishedSolutionsResponses[keyof SolutionsGetPublishedSolutionsResponses];
+type SolutionsGetSolutionBySlugData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the solution to retrieve.
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/v1/solutions/{slug}';
+};
+type SolutionsGetSolutionBySlugErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsGetSolutionBySlugError = SolutionsGetSolutionBySlugErrors[keyof SolutionsGetSolutionBySlugErrors];
+type SolutionsGetSolutionBySlugResponses = {
+    /**
+     * The solution detail.
+     */
+    200: SolutionDetailResponse;
+};
+type SolutionsGetSolutionBySlugResponse = SolutionsGetSolutionBySlugResponses[keyof SolutionsGetSolutionBySlugResponses];
+type SolutionsGetInstallationsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: {
+        /**
+         * Optional solution slug to filter the installations.
+         */
+        slug?: string | null;
+        /**
+         * Optional installation status name to filter by; must be a valid InstallationStatus value.
+         */
+        status?: string | null;
+    };
+    url: '/v1/solutions/installations';
+};
+type SolutionsGetInstallationsErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsGetInstallationsError = SolutionsGetInstallationsErrors[keyof SolutionsGetInstallationsErrors];
+type SolutionsGetInstallationsResponses = {
+    /**
+     * The matching installations for the account.
+     */
+    200: Array<SolutionInstallationResponse>;
+};
+type SolutionsGetInstallationsResponse = SolutionsGetInstallationsResponses[keyof SolutionsGetInstallationsResponses];
+type SolutionsGetInstallationDetailData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the installation to retrieve.
+         */
+        id: number;
+    };
+    query?: never;
+    url: '/v1/solutions/installations/{id}';
+};
+type SolutionsGetInstallationDetailErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsGetInstallationDetailError = SolutionsGetInstallationDetailErrors[keyof SolutionsGetInstallationDetailErrors];
+type SolutionsGetInstallationDetailResponses = {
+    /**
+     * The installation detail.
+     */
+    200: InstallationDetailResponse;
+};
+type SolutionsGetInstallationDetailResponse = SolutionsGetInstallationDetailResponses[keyof SolutionsGetInstallationDetailResponses];
+type SolutionsGetInstallationResourcesData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the installation whose resources are requested.
+         */
+        id: number;
+    };
+    query?: {
+        /**
+         * Optional resource key to filter the resources.
+         */
+        resourceKey?: string | null;
+        /**
+         * Optional resource type name to filter by; must be a valid ResourceType value.
+         */
+        resourceType?: string | null;
+    };
+    url: '/v1/solutions/installations/{id}/resources';
+};
+type SolutionsGetInstallationResourcesErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsGetInstallationResourcesError = SolutionsGetInstallationResourcesErrors[keyof SolutionsGetInstallationResourcesErrors];
+type SolutionsGetInstallationResourcesResponses = {
+    /**
+     * The matching installed resources.
+     */
+    200: Array<InstalledResourceResponse>;
+};
+type SolutionsGetInstallationResourcesResponse = SolutionsGetInstallationResourcesResponses[keyof SolutionsGetInstallationResourcesResponses];
+type SolutionsInstallSolutionData = {
+    /**
+     * The installation options and provisioning inputs.
+     */
+    body: InstallSolutionRequest;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the solution to install.
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/v1/solutions/{slug}/install';
+};
+type SolutionsInstallSolutionErrors = {
+    400: ErrorResponse;
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    404: ErrorResponse;
+    409: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsInstallSolutionError = SolutionsInstallSolutionErrors[keyof SolutionsInstallSolutionErrors];
+type SolutionsInstallSolutionResponses = {
+    /**
+     * The result of the installation, including the created installation and provisioned resources.
+     */
+    200: InstallSolutionResponse;
+};
+type SolutionsInstallSolutionResponse = SolutionsInstallSolutionResponses[keyof SolutionsInstallSolutionResponses];
+type SolutionsUpdateInstallationData = {
+    /**
+     * Optional update options, including whether to force the update past blockers.
+     */
+    body?: UpdateInstallationRequest;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the installation to update.
+         */
+        id: number;
+    };
+    query?: never;
+    url: '/v1/solutions/installations/{id}/update';
+};
+type SolutionsUpdateInstallationErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    404: ErrorResponse;
+    409: UpdateBlockedResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsUpdateInstallationError = SolutionsUpdateInstallationErrors[keyof SolutionsUpdateInstallationErrors];
+type SolutionsUpdateInstallationResponses = {
+    /**
+     * The result of the installation update.
+     */
+    200: UpdateInstallationResponse;
+};
+type SolutionsUpdateInstallationResponse = SolutionsUpdateInstallationResponses[keyof SolutionsUpdateInstallationResponses];
+type SolutionsUninstallSolutionData = {
+    /**
+     * The uninstall options, including the installation identifier and which resource types to delete.
+     */
+    body: UninstallSolutionRequest;
+    headers?: {
+        /**
+         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the solution to uninstall.
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/v1/solutions/{slug}/uninstall';
+};
+type SolutionsUninstallSolutionErrors = {
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type SolutionsUninstallSolutionError = SolutionsUninstallSolutionErrors[keyof SolutionsUninstallSolutionErrors];
+type SolutionsUninstallSolutionResponses = {
+    /**
+     * No content on success.
+     */
+    204: void;
+};
+type SolutionsUninstallSolutionResponse = SolutionsUninstallSolutionResponses[keyof SolutionsUninstallSolutionResponses];
+type ApplicationsListApplicationsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: {
+        /**
+         * Optional free-text search applied across application fields.
+         */
+        search?: string | null;
+        /**
+         * Optional exact-name filter.
+         */
+        name?: string | null;
+        /**
+         * Optional filter on the application's connection requirement.
+         */
+        connectionRequirement?: string | null;
+        /**
+         * Optional list of categories to filter by.
+         */
+        category?: Array<string> | null;
+        /**
+         * When true, returns only applications the caller can currently use. Defaults to false.
+         */
+        available?: boolean;
+        /**
+         * Zero-based index of the first item to return. Defaults to 0.
+         */
+        offset?: number;
+        /**
+         * Maximum number of items to return. Defaults to 100.
+         */
+        top?: number;
+    };
+    url: '/v1/applications';
+};
+type ApplicationsListApplicationsErrors = {
+    400: ErrorResponse;
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ApplicationsListApplicationsError = ApplicationsListApplicationsErrors[keyof ApplicationsListApplicationsErrors];
+type ApplicationsListApplicationsResponses = {
+    /**
+     * A paginated list of applications.
+     */
+    200: PaginatedResponseOfApplicationDto;
+};
+type ApplicationsListApplicationsResponse = ApplicationsListApplicationsResponses[keyof ApplicationsListApplicationsResponses];
+type ApplicationsGetApplicationData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the application to retrieve.
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/v1/applications/{slug}';
+};
+type ApplicationsGetApplicationErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ApplicationsGetApplicationError = ApplicationsGetApplicationErrors[keyof ApplicationsGetApplicationErrors];
+type ApplicationsGetApplicationResponses = {
+    /**
+     * The detailed representation of the application.
+     */
+    200: ApplicationDetailDto;
+};
+type ApplicationsGetApplicationResponse = ApplicationsGetApplicationResponses[keyof ApplicationsGetApplicationResponses];
+type ConnectionsGetConnectionsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: {
+        /**
+         * Optional filter limiting results to connections of a specific application.
+         */
+        applicationSlug?: string | null;
+        /**
+         * Optional name filter.
+         */
+        name?: string | null;
+        /**
+         * Zero-based index of the first item to return. Defaults to 0.
+         */
+        offset?: number;
+        /**
+         * Maximum number of items to return (capped at 100). Defaults to 25.
+         */
+        top?: number;
+        /**
+         * Optional metadata key/value pairs to filter connections by.
+         */
+        metadata?: {
+            [key: string]: string;
+        } | null;
+    };
+    url: '/v1/connections';
+};
+type ConnectionsGetConnectionsErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsGetConnectionsError = ConnectionsGetConnectionsErrors[keyof ConnectionsGetConnectionsErrors];
+type ConnectionsGetConnectionsResponses = {
+    /**
+     * A paginated list of connections.
+     */
+    200: PaginatedResponseOfConnectionPublicListItem;
+};
+type ConnectionsGetConnectionsResponse = ConnectionsGetConnectionsResponses[keyof ConnectionsGetConnectionsResponses];
+type ConnectionsCreateConnectionData = {
+    /**
+     * The connection creation payload, including the connection name and application slug.
+     */
+    body: CreateConnectionRequest;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/connections';
+};
+type ConnectionsCreateConnectionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsCreateConnectionError = ConnectionsCreateConnectionErrors[keyof ConnectionsCreateConnectionErrors];
+type ConnectionsCreateConnectionResponses = {
+    /**
+     * The newly created connection.
+     */
+    200: ConnectionPublicDetail;
+};
+type ConnectionsCreateConnectionResponse = ConnectionsCreateConnectionResponses[keyof ConnectionsCreateConnectionResponses];
+type ConnectionsDeleteConnectionData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection to delete.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}';
+};
+type ConnectionsDeleteConnectionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsDeleteConnectionError = ConnectionsDeleteConnectionErrors[keyof ConnectionsDeleteConnectionErrors];
+type ConnectionsDeleteConnectionResponses = {
+    /**
+     * An empty success response when the connection is deleted.
+     */
+    200: Blob | File;
+};
+type ConnectionsDeleteConnectionResponse = ConnectionsDeleteConnectionResponses[keyof ConnectionsDeleteConnectionResponses];
+type ConnectionsGetConnectionData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection to retrieve.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}';
+};
+type ConnectionsGetConnectionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsGetConnectionError = ConnectionsGetConnectionErrors[keyof ConnectionsGetConnectionErrors];
+type ConnectionsGetConnectionResponses = {
+    /**
+     * The detailed representation of the connection.
+     */
+    200: ConnectionPublicDetail;
+};
+type ConnectionsGetConnectionResponse = ConnectionsGetConnectionResponses[keyof ConnectionsGetConnectionResponses];
+type ConnectionsUpdateConnectionData = {
+    /**
+     * The fields to update on the connection.
+     */
+    body: UpdateConnectionRequest;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection to update.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}';
+};
+type ConnectionsUpdateConnectionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsUpdateConnectionError = ConnectionsUpdateConnectionErrors[keyof ConnectionsUpdateConnectionErrors];
+type ConnectionsUpdateConnectionResponses = {
+    /**
+     * The updated connection.
+     */
+    200: ConnectionPublicDetail;
+};
+type ConnectionsUpdateConnectionResponse = ConnectionsUpdateConnectionResponses[keyof ConnectionsUpdateConnectionResponses];
+type ConnectionsGetDefaultConnectionsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/connections/Defaults';
+};
+type ConnectionsGetDefaultConnectionsErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsGetDefaultConnectionsError = ConnectionsGetDefaultConnectionsErrors[keyof ConnectionsGetDefaultConnectionsErrors];
+type ConnectionsGetDefaultConnectionsResponses = {
+    /**
+     * The caller's default connections.
+     */
+    200: DefaultConnectionsResponse;
+};
+type ConnectionsGetDefaultConnectionsResponse = ConnectionsGetDefaultConnectionsResponses[keyof ConnectionsGetDefaultConnectionsResponses];
+type ConnectionsClearDefaultConnectionData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection to clear as default.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}/Default';
+};
+type ConnectionsClearDefaultConnectionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsClearDefaultConnectionError = ConnectionsClearDefaultConnectionErrors[keyof ConnectionsClearDefaultConnectionErrors];
+type ConnectionsClearDefaultConnectionResponses = {
+    /**
+     * No content when the default is cleared successfully.
+     */
+    200: Blob | File;
+};
+type ConnectionsClearDefaultConnectionResponse = ConnectionsClearDefaultConnectionResponses[keyof ConnectionsClearDefaultConnectionResponses];
+type ConnectionsSetDefaultConnectionData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection to mark as default.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}/Default';
+};
+type ConnectionsSetDefaultConnectionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsSetDefaultConnectionError = ConnectionsSetDefaultConnectionErrors[keyof ConnectionsSetDefaultConnectionErrors];
+type ConnectionsSetDefaultConnectionResponses = {
+    /**
+     * The result of setting the default connection.
+     */
+    200: SetDefaultConnectionResponse;
+};
+type ConnectionsSetDefaultConnectionResponse = ConnectionsSetDefaultConnectionResponses[keyof ConnectionsSetDefaultConnectionResponses];
+type ConnectionsReplaceConnectionData = {
+    /**
+     * The replacement payload identifying the source and target connections.
+     */
+    body: ReplaceConnectionRequest;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/connections/Replace';
+};
+type ConnectionsReplaceConnectionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsReplaceConnectionError = ConnectionsReplaceConnectionErrors[keyof ConnectionsReplaceConnectionErrors];
+type ConnectionsReplaceConnectionResponses = {
+    /**
+     * An empty success response when the replacement completes.
+     */
+    200: Blob | File;
+};
+type ConnectionsReplaceConnectionResponse = ConnectionsReplaceConnectionResponses[keyof ConnectionsReplaceConnectionResponses];
+type ConnectionsRefreshObjectsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection whose objects should be refreshed.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}/RefreshObjects';
+};
+type ConnectionsRefreshObjectsErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsRefreshObjectsError = ConnectionsRefreshObjectsErrors[keyof ConnectionsRefreshObjectsErrors];
+type ConnectionsRefreshObjectsResponses = {
+    /**
+     * An empty success response when the refresh is initiated.
+     */
+    200: Blob | File;
+};
+type ConnectionsRefreshObjectsResponse = ConnectionsRefreshObjectsResponses[keyof ConnectionsRefreshObjectsResponses];
+type ConnectionsGetRefreshStatusData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection whose refresh status is requested.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}/RefreshStatus';
+};
+type ConnectionsGetRefreshStatusErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsGetRefreshStatusError = ConnectionsGetRefreshStatusErrors[keyof ConnectionsGetRefreshStatusErrors];
+type ConnectionsGetRefreshStatusResponses = {
+    /**
+     * The current refresh status for the connection.
+     */
+    200: RefreshStatusResponse;
+};
+type ConnectionsGetRefreshStatusResponse = ConnectionsGetRefreshStatusResponses[keyof ConnectionsGetRefreshStatusResponses];
+type ConnectionsSelectObjectsData = {
+    /**
+     * The request containing the identifiers of the objects to select.
+     */
+    body: SelectObjectsRequest;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection whose objects are being selected.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}/SelectObjects';
+};
+type ConnectionsSelectObjectsErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsSelectObjectsError = ConnectionsSelectObjectsErrors[keyof ConnectionsSelectObjectsErrors];
+type ConnectionsSelectObjectsResponses = {
+    /**
+     * An empty success response when the selection is saved.
+     */
+    200: Blob | File;
+};
+type ConnectionsSelectObjectsResponse = ConnectionsSelectObjectsResponses[keyof ConnectionsSelectObjectsResponses];
+type ConnectionsGetConnectionObjectsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection whose objects are listed.
+         */
+        connectionId: number;
+    };
+    query?: {
+        /**
+         * Optional name filter applied to the objects.
+         */
+        name?: string | null;
+        /**
+         * Optional sort expression for ordering the objects.
+         */
+        sort?: string | null;
+        /**
+         * Zero-based index of the first item to return. Defaults to 0.
+         */
+        offset?: number;
+        /**
+         * Maximum number of items to return (capped at 1000). Defaults to 100.
+         */
+        top?: number;
+    };
+    url: '/v1/connections/{connectionId}/Objects';
+};
+type ConnectionsGetConnectionObjectsErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsGetConnectionObjectsError = ConnectionsGetConnectionObjectsErrors[keyof ConnectionsGetConnectionObjectsErrors];
+type ConnectionsGetConnectionObjectsResponses = {
+    /**
+     * A paginated list of connection objects.
+     */
+    200: PaginatedResponseOfConnectionObject;
+};
+type ConnectionsGetConnectionObjectsResponse = ConnectionsGetConnectionObjectsResponses[keyof ConnectionsGetConnectionObjectsResponses];
+type ConnectionsCheckConnectionData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the connection to check.
+         */
+        connectionId: number;
+    };
+    query?: never;
+    url: '/v1/connections/{connectionId}/Check';
+};
+type ConnectionsCheckConnectionErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsCheckConnectionError = ConnectionsCheckConnectionErrors[keyof ConnectionsCheckConnectionErrors];
+type ConnectionsCheckConnectionResponses = {
+    /**
+     * An empty success response when the connection is healthy.
+     */
+    200: Blob | File;
+};
+type ConnectionsCheckConnectionResponse = ConnectionsCheckConnectionResponses[keyof ConnectionsCheckConnectionResponses];
+type ConnectionsGetSignInUrlData = {
+    /**
+     * The request describing the application, authentication method, and any provider fields.
+     */
+    body: SignInUrlRequest;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/connections/GetSignInUrl';
+};
+type ConnectionsGetSignInUrlErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsGetSignInUrlError = ConnectionsGetSignInUrlErrors[keyof ConnectionsGetSignInUrlErrors];
+type ConnectionsGetSignInUrlResponses = {
+    /**
+     * The sign-in URL together with the generated state value used to correlate the callback.
+     */
+    200: SignInUrlResponse;
+};
+type ConnectionsGetSignInUrlResponse = ConnectionsGetSignInUrlResponses[keyof ConnectionsGetSignInUrlResponses];
+type ConnectionsGetAccessTokenData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The state value returned when the sign-in URL was generated.
+         */
+        state: string;
+    };
+    query?: never;
+    url: '/v1/connections/AccessToken/{state}';
+};
+type ConnectionsGetAccessTokenErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ConnectionsGetAccessTokenError = ConnectionsGetAccessTokenErrors[keyof ConnectionsGetAccessTokenErrors];
+type ConnectionsGetAccessTokenResponses = {
+    /**
+     * The access token data for the state, or null if no token has been captured yet.
+     */
+    200: AccessTokenResponse;
+};
+type ConnectionsGetAccessTokenResponse = ConnectionsGetAccessTokenResponses[keyof ConnectionsGetAccessTokenResponses];
+type ToolsListToolsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: {
+        /**
+         * Optional free-text search applied across tool fields.
+         */
+        search?: string | null;
+        /**
+         * Optional exact-name filter.
+         */
+        name?: string | null;
+        /**
+         * Optional filter limiting results to tools of a specific application.
+         */
+        applicationSlug?: string | null;
+        /**
+         * Optional category filter.
+         */
+        category?: string | null;
+        /**
+         * When true, returns only tools the caller can currently execute. Defaults to false.
+         */
+        available?: boolean;
+        /**
+         * When true, includes deprecated tools in the results. Defaults to false.
+         */
+        includeDeprecated?: boolean;
+        /**
+         * Zero-based index of the first item to return. Defaults to 0.
+         */
+        offset?: number;
+        /**
+         * Maximum number of items to return. Defaults to 100.
+         */
+        top?: number;
+        /**
+         * Optional toolset id; when supplied, the caller's workflow tools in that toolset are included alongside activity tools.
+         */
+        toolsetId?: string | null;
+    };
+    url: '/v1/tools';
+};
+type ToolsListToolsErrors = {
+    400: ErrorResponse;
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ToolsListToolsError = ToolsListToolsErrors[keyof ToolsListToolsErrors];
+type ToolsListToolsResponses = {
+    /**
+     * A paginated list of tools.
+     */
+    200: PaginatedResponseOfToolDto;
+};
+type ToolsListToolsResponse = ToolsListToolsResponses[keyof ToolsListToolsResponses];
+type ToolsGetToolData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the tool to retrieve.
+         */
+        toolSlug: string;
+    };
+    query?: {
+        /**
+         * Optional parent-application slug used to disambiguate when the same tool slug exists across applications.
+         */
+        applicationSlug?: string | null;
+        /**
+         * Optional toolset id; when supplied, a slug naming one of the caller's workflows in that toolset resolves to the workflow-tool detail.
+         */
+        toolsetId?: string | null;
+    };
+    url: '/v1/tools/{toolSlug}';
+};
+type ToolsGetToolErrors = {
+    400: ErrorResponse;
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ToolsGetToolError = ToolsGetToolErrors[keyof ToolsGetToolErrors];
+type ToolsGetToolResponses = {
+    /**
+     * The detailed representation of the tool.
+     */
+    200: ToolDetailDto;
+};
+type ToolsGetToolResponse = ToolsGetToolResponses[keyof ToolsGetToolResponses];
+type ToolsExecuteToolData = {
+    /**
+     * The execution request containing the tool's input arguments.
+     */
+    body: ToolExecuteRequest;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The slug identifying the tool to execute.
+         */
+        toolSlug: string;
+    };
+    query?: {
+        /**
+         * Optional toolset identifier used to scope connection resolution.
+         */
+        toolsetId?: string | null;
+        /**
+         * Optional explicit connection identifier to use instead of the implicitly resolved connection.
+         */
+        connectionId?: number | null;
+    };
+    url: '/v1/tools/{toolSlug}/execute';
+};
+type ToolsExecuteToolErrors = {
+    400: ErrorResponse;
+    401: ErrorResponse;
+    403: ErrorResponse;
+    404: ErrorResponse;
+    409: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ToolsExecuteToolError = ToolsExecuteToolErrors[keyof ToolsExecuteToolErrors];
+type ToolsExecuteToolResponses = {
+    /**
+     * The tool execution result, including success status and any output.
+     */
+    200: ToolExecuteResponse;
+};
+type ToolsExecuteToolResponse = ToolsExecuteToolResponses[keyof ToolsExecuteToolResponses];
+type ToolsetsListToolsetsData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: {
+        /**
+         * Zero-based index of the first item to return. Defaults to 0.
+         */
+        offset?: number;
+        /**
+         * Maximum number of items to return (capped at 100). Defaults to 100.
+         */
+        top?: number;
+    };
+    url: '/v1/toolsets';
+};
+type ToolsetsListToolsetsErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ToolsetsListToolsetsError = ToolsetsListToolsetsErrors[keyof ToolsetsListToolsetsErrors];
+type ToolsetsListToolsetsResponses = {
+    /**
+     * A paginated list of toolsets.
+     */
+    200: PaginatedResponseOfToolsetDto;
+};
+type ToolsetsListToolsetsResponse = ToolsetsListToolsetsResponses[keyof ToolsetsListToolsetsResponses];
+type ToolsetsCreateToolsetData = {
+    /**
+     * The toolset creation payload.
+     */
+    body: CreateToolsetRequest;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/toolsets';
+};
+type ToolsetsCreateToolsetErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ToolsetsCreateToolsetError = ToolsetsCreateToolsetErrors[keyof ToolsetsCreateToolsetErrors];
+type ToolsetsCreateToolsetResponses = {
+    /**
+     * The newly created toolset.
+     */
+    200: ToolsetDto;
+};
+type ToolsetsCreateToolsetResponse = ToolsetsCreateToolsetResponses[keyof ToolsetsCreateToolsetResponses];
+type ToolsetsDeleteToolsetData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the toolset to delete.
+         */
+        toolsetId: string;
+    };
+    query?: never;
+    url: '/v1/toolsets/{toolsetId}';
+};
+type ToolsetsDeleteToolsetErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ToolsetsDeleteToolsetError = ToolsetsDeleteToolsetErrors[keyof ToolsetsDeleteToolsetErrors];
+type ToolsetsDeleteToolsetResponses = {
+    /**
+     * No content when the toolset is deleted successfully.
+     */
+    200: Blob | File;
+};
+type ToolsetsDeleteToolsetResponse = ToolsetsDeleteToolsetResponses[keyof ToolsetsDeleteToolsetResponses];
+type ToolsetsGetToolsetData = {
+    body?: never;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the toolset to retrieve.
+         */
+        toolsetId: string;
+    };
+    query?: never;
+    url: '/v1/toolsets/{toolsetId}';
+};
+type ToolsetsGetToolsetErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ToolsetsGetToolsetError = ToolsetsGetToolsetErrors[keyof ToolsetsGetToolsetErrors];
+type ToolsetsGetToolsetResponses = {
+    /**
+     * The requested toolset.
+     */
+    200: ToolsetDto;
+};
+type ToolsetsGetToolsetResponse = ToolsetsGetToolsetResponses[keyof ToolsetsGetToolsetResponses];
+type ToolsetsUpdateToolsetData = {
+    /**
+     * The fields to update on the toolset.
+     */
+    body: UpdateToolsetRequest;
+    headers?: {
+        /**
+         * Account token. Optional — alternatively send the AccountToken JWT claim.
+         */
+        companytoken?: string;
+    };
+    path: {
+        /**
+         * The identifier of the toolset to update.
+         */
+        toolsetId: string;
+    };
+    query?: never;
+    url: '/v1/toolsets/{toolsetId}';
+};
+type ToolsetsUpdateToolsetErrors = {
+    /**
+     * Bad request — malformed body or invalid parameters.
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized — missing or invalid bearer token.
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden — the caller lacks access to the resource.
+     */
+    403: ErrorResponse;
+    /**
+     * Not found — the resource does not exist.
+     */
+    404: ErrorResponse;
+    /**
+     * Too many requests — rate limit exceeded.
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error — an unexpected error occurred.
+     */
+    500: ErrorResponse;
+};
+type ToolsetsUpdateToolsetError = ToolsetsUpdateToolsetErrors[keyof ToolsetsUpdateToolsetErrors];
+type ToolsetsUpdateToolsetResponses = {
+    /**
+     * The updated toolset.
+     */
+    200: ToolsetDto;
+};
+type ToolsetsUpdateToolsetResponse = ToolsetsUpdateToolsetResponses[keyof ToolsetsUpdateToolsetResponses];
+
+type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options$1<TData, ThrowOnError, TResponse> & {
+    /**
+     * You can provide a client instance returned by `createClient()` instead of
+     * individual options. This might be also useful if you want to implement a
+     * custom client.
+     */
+    client?: Client;
+    /**
+     * You can pass arbitrary values through the `meta` object. This can be
+     * used to access values that aren't defined as part of the SDK function.
+     */
+    meta?: Record<string, unknown>;
+};
+/**
+ * Returns the identity of the principal the request is authenticated as: full name, email,
+ * current company, role, and caller type. For x-api-key requests the identity is the
+ * token's owner (the key acts as the owner) and the type is reported as apiuser.
+ */
+declare const authWhoAmI: <ThrowOnError extends boolean = false>(options?: Options<AuthWhoAmIData, ThrowOnError>) => RequestResult<AuthWhoAmIResponses, AuthWhoAmIErrors, ThrowOnError>;
+/**
+ * Creates a new solution (Engini admin only). The request's build manifest is compiled into a
+ * stored manifest, and the resulting solution is returned together with any build warnings.
+ */
+declare const solutionsCreateSolution: <ThrowOnError extends boolean = false>(options: Options<SolutionsCreateSolutionData, ThrowOnError>) => RequestResult<SolutionsCreateSolutionResponses, SolutionsCreateSolutionErrors, ThrowOnError>;
+/**
+ * Archives the solution identified by its slug (Engini admin only), removing it from the published catalog.
+ */
+declare const solutionsArchiveSolution: <ThrowOnError extends boolean = false>(options: Options<SolutionsArchiveSolutionData, ThrowOnError>) => RequestResult<SolutionsArchiveSolutionResponses, SolutionsArchiveSolutionErrors, ThrowOnError>;
+/**
+ * Updates an existing solution identified by its slug (Engini admin only). When a build manifest
+ * is supplied, the manifest is rebuilt and persisted; otherwise only the solution metadata is updated.
+ */
+declare const solutionsUpdateSolution: <ThrowOnError extends boolean = false>(options: Options<SolutionsUpdateSolutionData, ThrowOnError>) => RequestResult<SolutionsUpdateSolutionResponses, SolutionsUpdateSolutionErrors, ThrowOnError>;
+/**
+ * Publishes the solution identified by its slug (Engini admin only), making it available in the public catalog.
+ */
+declare const solutionsPublishSolution: <ThrowOnError extends boolean = false>(options: Options<SolutionsPublishSolutionData, ThrowOnError>) => RequestResult<SolutionsPublishSolutionResponses, SolutionsPublishSolutionErrors, ThrowOnError>;
+/**
+ * Builds a solution manifest from the supplied workflows, tables, and connections (Engini admin only).
+ * When a slug is provided, the freshly built manifest is also persisted onto the existing solution,
+ * bumping its manifest version and notifying installations.
+ */
+declare const solutionsBuildManifest: <ThrowOnError extends boolean = false>(options: Options<SolutionsBuildManifestData, ThrowOnError>) => RequestResult<SolutionsBuildManifestResponses, SolutionsBuildManifestErrors, ThrowOnError>;
+/**
+ * Returns a paginated list of published solutions from the public catalog.
+ */
+declare const solutionsGetPublishedSolutions: <ThrowOnError extends boolean = false>(options?: Options<SolutionsGetPublishedSolutionsData, ThrowOnError>) => RequestResult<SolutionsGetPublishedSolutionsResponses, SolutionsGetPublishedSolutionsErrors, ThrowOnError>;
+/**
+ * Returns the detail of a single published solution identified by its slug.
+ */
+declare const solutionsGetSolutionBySlug: <ThrowOnError extends boolean = false>(options: Options<SolutionsGetSolutionBySlugData, ThrowOnError>) => RequestResult<SolutionsGetSolutionBySlugResponses, SolutionsGetSolutionBySlugErrors, ThrowOnError>;
+/**
+ * Returns the solution installations belonging to the calling account, optionally filtered by
+ * solution slug and installation status.
+ */
+declare const solutionsGetInstallations: <ThrowOnError extends boolean = false>(options?: Options<SolutionsGetInstallationsData, ThrowOnError>) => RequestResult<SolutionsGetInstallationsResponses, SolutionsGetInstallationsErrors, ThrowOnError>;
+/**
+ * Returns the detail of a single installation belonging to the calling account.
+ */
+declare const solutionsGetInstallationDetail: <ThrowOnError extends boolean = false>(options: Options<SolutionsGetInstallationDetailData, ThrowOnError>) => RequestResult<SolutionsGetInstallationDetailResponses, SolutionsGetInstallationDetailErrors, ThrowOnError>;
+/**
+ * Returns the provisioned resources for a given installation belonging to the calling account,
+ * optionally filtered by resource key and resource type.
+ */
+declare const solutionsGetInstallationResources: <ThrowOnError extends boolean = false>(options: Options<SolutionsGetInstallationResourcesData, ThrowOnError>) => RequestResult<SolutionsGetInstallationResourcesResponses, SolutionsGetInstallationResourcesErrors, ThrowOnError>;
+/**
+ * Installs the solution identified by its slug into the calling account's workspace, provisioning
+ * the solution's resources. This endpoint is rate limited.
+ */
+declare const solutionsInstallSolution: <ThrowOnError extends boolean = false>(options: Options<SolutionsInstallSolutionData, ThrowOnError>) => RequestResult<SolutionsInstallSolutionResponses, SolutionsInstallSolutionErrors, ThrowOnError>;
+/**
+ * Updates an existing installation to the latest solution manifest version, re-provisioning resources
+ * as needed. Returns a 409 with the blocking conditions when the update is blocked and not forced.
+ * This endpoint is rate limited.
+ */
+declare const solutionsUpdateInstallation: <ThrowOnError extends boolean = false>(options: Options<SolutionsUpdateInstallationData, ThrowOnError>) => RequestResult<SolutionsUpdateInstallationResponses, SolutionsUpdateInstallationErrors, ThrowOnError>;
+/**
+ * Uninstalls a solution installation from the calling account's workspace, optionally deleting the
+ * associated connections, workflows, and tables. This endpoint is rate limited.
+ */
+declare const solutionsUninstallSolution: <ThrowOnError extends boolean = false>(options: Options<SolutionsUninstallSolutionData, ThrowOnError>) => RequestResult<SolutionsUninstallSolutionResponses, SolutionsUninstallSolutionErrors, ThrowOnError>;
+/**
+ * List the applications available to the caller, with optional filtering and pagination.
+ */
+declare const applicationsListApplications: <ThrowOnError extends boolean = false>(options?: Options<ApplicationsListApplicationsData, ThrowOnError>) => RequestResult<ApplicationsListApplicationsResponses, ApplicationsListApplicationsErrors, ThrowOnError>;
+/**
+ * Get the full details of a single application identified by its slug.
+ */
+declare const applicationsGetApplication: <ThrowOnError extends boolean = false>(options: Options<ApplicationsGetApplicationData, ThrowOnError>) => RequestResult<ApplicationsGetApplicationResponses, ApplicationsGetApplicationErrors, ThrowOnError>;
+/**
+ * List the connections available to the caller, with optional filtering and pagination.
+ */
+declare const connectionsGetConnections: <ThrowOnError extends boolean = false>(options?: Options<ConnectionsGetConnectionsData, ThrowOnError>) => RequestResult<ConnectionsGetConnectionsResponses, ConnectionsGetConnectionsErrors, ThrowOnError>;
+/**
+ * Create a new connection for the caller.
+ */
+declare const connectionsCreateConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsCreateConnectionData, ThrowOnError>) => RequestResult<ConnectionsCreateConnectionResponses, ConnectionsCreateConnectionErrors, ThrowOnError>;
+/**
+ * Delete a connection owned by the caller.
+ */
+declare const connectionsDeleteConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsDeleteConnectionData, ThrowOnError>) => RequestResult<ConnectionsDeleteConnectionResponses, ConnectionsDeleteConnectionErrors, ThrowOnError>;
+/**
+ * Get the full details of a single connection identified by its id.
+ */
+declare const connectionsGetConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetConnectionData, ThrowOnError>) => RequestResult<ConnectionsGetConnectionResponses, ConnectionsGetConnectionErrors, ThrowOnError>;
+/**
+ * Update an existing connection owned by the caller.
+ */
+declare const connectionsUpdateConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsUpdateConnectionData, ThrowOnError>) => RequestResult<ConnectionsUpdateConnectionResponses, ConnectionsUpdateConnectionErrors, ThrowOnError>;
+/**
+ * List the caller's default connections, one per application where a default is set.
+ */
+declare const connectionsGetDefaultConnections: <ThrowOnError extends boolean = false>(options?: Options<ConnectionsGetDefaultConnectionsData, ThrowOnError>) => RequestResult<ConnectionsGetDefaultConnectionsResponses, ConnectionsGetDefaultConnectionsErrors, ThrowOnError>;
+/**
+ * Clear the default designation for the given connection.
+ */
+declare const connectionsClearDefaultConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsClearDefaultConnectionData, ThrowOnError>) => RequestResult<ConnectionsClearDefaultConnectionResponses, ConnectionsClearDefaultConnectionErrors, ThrowOnError>;
+/**
+ * Set the given connection as the caller's default for its application.
+ */
+declare const connectionsSetDefaultConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsSetDefaultConnectionData, ThrowOnError>) => RequestResult<ConnectionsSetDefaultConnectionResponses, ConnectionsSetDefaultConnectionErrors, ThrowOnError>;
+/**
+ * Replace one connection with another across the caller's usages.
+ */
+declare const connectionsReplaceConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsReplaceConnectionData, ThrowOnError>) => RequestResult<ConnectionsReplaceConnectionResponses, ConnectionsReplaceConnectionErrors, ThrowOnError>;
+/**
+ * Trigger a refresh of the objects available through the given connection.
+ */
+declare const connectionsRefreshObjects: <ThrowOnError extends boolean = false>(options: Options<ConnectionsRefreshObjectsData, ThrowOnError>) => RequestResult<ConnectionsRefreshObjectsResponses, ConnectionsRefreshObjectsErrors, ThrowOnError>;
+/**
+ * Get the status of the most recent object refresh for the given connection.
+ */
+declare const connectionsGetRefreshStatus: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetRefreshStatusData, ThrowOnError>) => RequestResult<ConnectionsGetRefreshStatusResponses, ConnectionsGetRefreshStatusErrors, ThrowOnError>;
+/**
+ * Select which objects from the given connection are active for the caller.
+ */
+declare const connectionsSelectObjects: <ThrowOnError extends boolean = false>(options: Options<ConnectionsSelectObjectsData, ThrowOnError>) => RequestResult<ConnectionsSelectObjectsResponses, ConnectionsSelectObjectsErrors, ThrowOnError>;
+/**
+ * List the objects available through the given connection, with optional filtering, sorting, and pagination.
+ */
+declare const connectionsGetConnectionObjects: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetConnectionObjectsData, ThrowOnError>) => RequestResult<ConnectionsGetConnectionObjectsResponses, ConnectionsGetConnectionObjectsErrors, ThrowOnError>;
+/**
+ * Verify that the given connection is valid and currently usable.
+ */
+declare const connectionsCheckConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsCheckConnectionData, ThrowOnError>) => RequestResult<ConnectionsCheckConnectionResponses, ConnectionsCheckConnectionErrors, ThrowOnError>;
+/**
+ * Build an OAuth sign-in URL for an application so the caller can authorize a new connection.
+ */
+declare const connectionsGetSignInUrl: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetSignInUrlData, ThrowOnError>) => RequestResult<ConnectionsGetSignInUrlResponses, ConnectionsGetSignInUrlErrors, ThrowOnError>;
+/**
+ * Retrieve the access token captured for a previously issued sign-in URL, identified by its state value.
+ */
+declare const connectionsGetAccessToken: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetAccessTokenData, ThrowOnError>) => RequestResult<ConnectionsGetAccessTokenResponses, ConnectionsGetAccessTokenErrors, ThrowOnError>;
+/**
+ * List the tools available to the caller, with optional filtering and pagination.
+ */
+declare const toolsListTools: <ThrowOnError extends boolean = false>(options?: Options<ToolsListToolsData, ThrowOnError>) => RequestResult<ToolsListToolsResponses, ToolsListToolsErrors, ThrowOnError>;
+/**
+ * Get the full details of a single tool identified by its slug.
+ */
+declare const toolsGetTool: <ThrowOnError extends boolean = false>(options: Options<ToolsGetToolData, ThrowOnError>) => RequestResult<ToolsGetToolResponses, ToolsGetToolErrors, ThrowOnError>;
+/**
+ * Execute a tool. Connection is resolved implicitly from the caller's
+ * account-user, the tool's parent application, and optional toolsetId.
+ * Tool-runtime failures return 200 with isSuccess=false; all other failures
+ * use the standard error envelope.
+ */
+declare const toolsExecuteTool: <ThrowOnError extends boolean = false>(options: Options<ToolsExecuteToolData, ThrowOnError>) => RequestResult<ToolsExecuteToolResponses, ToolsExecuteToolErrors, ThrowOnError>;
+/**
+ * List the toolsets belonging to the caller, with pagination.
+ */
+declare const toolsetsListToolsets: <ThrowOnError extends boolean = false>(options?: Options<ToolsetsListToolsetsData, ThrowOnError>) => RequestResult<ToolsetsListToolsetsResponses, ToolsetsListToolsetsErrors, ThrowOnError>;
+/**
+ * Create a new toolset for the caller.
+ */
+declare const toolsetsCreateToolset: <ThrowOnError extends boolean = false>(options: Options<ToolsetsCreateToolsetData, ThrowOnError>) => RequestResult<ToolsetsCreateToolsetResponses, ToolsetsCreateToolsetErrors, ThrowOnError>;
+/**
+ * Delete a toolset owned by the caller.
+ */
+declare const toolsetsDeleteToolset: <ThrowOnError extends boolean = false>(options: Options<ToolsetsDeleteToolsetData, ThrowOnError>) => RequestResult<ToolsetsDeleteToolsetResponses, ToolsetsDeleteToolsetErrors, ThrowOnError>;
+/**
+ * Get a single toolset owned by the caller, identified by its id.
+ */
+declare const toolsetsGetToolset: <ThrowOnError extends boolean = false>(options: Options<ToolsetsGetToolsetData, ThrowOnError>) => RequestResult<ToolsetsGetToolsetResponses, ToolsetsGetToolsetErrors, ThrowOnError>;
+/**
+ * Update an existing toolset owned by the caller.
+ */
+declare const toolsetsUpdateToolset: <ThrowOnError extends boolean = false>(options: Options<ToolsetsUpdateToolsetData, ThrowOnError>) => RequestResult<ToolsetsUpdateToolsetResponses, ToolsetsUpdateToolsetErrors, ThrowOnError>;
+
+/**
+ * @engini/client — TypeScript REST client for the Engini Public API.
+ *
+ * The code under ./generated is produced by @hey-api/openapi-ts and committed.
+ * DO NOT edit it by hand — regenerate via scripts/regen.sh. This file is the one
+ * hand-written module in the package: it re-exports the generated SDK + types and
+ * adds the Engini-named client factory.
+ */
+
+interface EnginiClientOptions {
+    /** API base URL. Requests append `/v1/...`. */
+    baseUrl: string;
+    /** Optional JWT. When set, bearer-secured operations send `Authorization: Bearer <token>`. */
+    token?: string;
+}
+/**
+ * Create a configured Engini API client to pass to the generated operation
+ * functions, e.g. `await connectionsGetConnections({ client })`.
+ */
+declare function createEnginiClient(options: EnginiClientOptions): Client;
+
+export { type AccessTokenResponse, type ActivityCondition, type ActivitySort, type AppConnectionFieldInputType, type ApplicationAuthMethod, type ApplicationConnectionField, type ApplicationDetailDto, type ApplicationDto, type ApplicationsGetApplicationData, type ApplicationsGetApplicationError, type ApplicationsGetApplicationErrors, type ApplicationsGetApplicationResponse, type ApplicationsGetApplicationResponses, type ApplicationsListApplicationsData, type ApplicationsListApplicationsError, type ApplicationsListApplicationsErrors, type ApplicationsListApplicationsResponse, type ApplicationsListApplicationsResponses, type AuthWhoAmIData, type AuthWhoAmIError, type AuthWhoAmIErrors, type AuthWhoAmIResponse, type AuthWhoAmIResponses, type BuildManifestRequest, type BuildManifestResponse, type BuildManifestTable, type BuildManifestWorkflow, type ClientOptions, type ConnectionInput, type ConnectionObject, type ConnectionPublicDetail, type ConnectionPublicListItem, type ConnectionsCheckConnectionData, type ConnectionsCheckConnectionError, type ConnectionsCheckConnectionErrors, type ConnectionsCheckConnectionResponse, type ConnectionsCheckConnectionResponses, type ConnectionsClearDefaultConnectionData, type ConnectionsClearDefaultConnectionError, type ConnectionsClearDefaultConnectionErrors, type ConnectionsClearDefaultConnectionResponse, type ConnectionsClearDefaultConnectionResponses, type ConnectionsCreateConnectionData, type ConnectionsCreateConnectionError, type ConnectionsCreateConnectionErrors, type ConnectionsCreateConnectionResponse, type ConnectionsCreateConnectionResponses, type ConnectionsDeleteConnectionData, type ConnectionsDeleteConnectionError, type ConnectionsDeleteConnectionErrors, type ConnectionsDeleteConnectionResponse, type ConnectionsDeleteConnectionResponses, type ConnectionsGetAccessTokenData, type ConnectionsGetAccessTokenError, type ConnectionsGetAccessTokenErrors, type ConnectionsGetAccessTokenResponse, type ConnectionsGetAccessTokenResponses, type ConnectionsGetConnectionData, type ConnectionsGetConnectionError, type ConnectionsGetConnectionErrors, type ConnectionsGetConnectionObjectsData, type ConnectionsGetConnectionObjectsError, type ConnectionsGetConnectionObjectsErrors, type ConnectionsGetConnectionObjectsResponse, type ConnectionsGetConnectionObjectsResponses, type ConnectionsGetConnectionResponse, type ConnectionsGetConnectionResponses, type ConnectionsGetConnectionsData, type ConnectionsGetConnectionsError, type ConnectionsGetConnectionsErrors, type ConnectionsGetConnectionsResponse, type ConnectionsGetConnectionsResponses, type ConnectionsGetDefaultConnectionsData, type ConnectionsGetDefaultConnectionsError, type ConnectionsGetDefaultConnectionsErrors, type ConnectionsGetDefaultConnectionsResponse, type ConnectionsGetDefaultConnectionsResponses, type ConnectionsGetRefreshStatusData, type ConnectionsGetRefreshStatusError, type ConnectionsGetRefreshStatusErrors, type ConnectionsGetRefreshStatusResponse, type ConnectionsGetRefreshStatusResponses, type ConnectionsGetSignInUrlData, type ConnectionsGetSignInUrlError, type ConnectionsGetSignInUrlErrors, type ConnectionsGetSignInUrlResponse, type ConnectionsGetSignInUrlResponses, type ConnectionsRefreshObjectsData, type ConnectionsRefreshObjectsError, type ConnectionsRefreshObjectsErrors, type ConnectionsRefreshObjectsResponse, type ConnectionsRefreshObjectsResponses, type ConnectionsReplaceConnectionData, type ConnectionsReplaceConnectionError, type ConnectionsReplaceConnectionErrors, type ConnectionsReplaceConnectionResponse, type ConnectionsReplaceConnectionResponses, type ConnectionsSelectObjectsData, type ConnectionsSelectObjectsError, type ConnectionsSelectObjectsErrors, type ConnectionsSelectObjectsResponse, type ConnectionsSelectObjectsResponses, type ConnectionsSetDefaultConnectionData, type ConnectionsSetDefaultConnectionError, type ConnectionsSetDefaultConnectionErrors, type ConnectionsSetDefaultConnectionResponse, type ConnectionsSetDefaultConnectionResponses, type ConnectionsUpdateConnectionData, type ConnectionsUpdateConnectionError, type ConnectionsUpdateConnectionErrors, type ConnectionsUpdateConnectionResponse, type ConnectionsUpdateConnectionResponses, type CreateConnectionRequest, type CreateSolutionRequest, type CreateToolsetRequest, type CustomConnectionDataItem, type DefaultConnectionDto, type DefaultConnectionsResponse, type EnginiClientOptions, type ErrorDetail, type ErrorResponse, type ExecutionInfo, type InstallSolutionRequest, type InstallSolutionResponse, type InstallationDetailResponse, type InstalledResourceResponse, type ManifestConnection, type ManifestConnectionDefaults, type ManifestTable, type ManifestWorkflow, type Options, type OrderDirection, type PaginatedResponseOfApplicationDto, type PaginatedResponseOfConnectionObject, type PaginatedResponseOfConnectionPublicListItem, type PaginatedResponseOfSolutionResponse, type PaginatedResponseOfToolDto, type PaginatedResponseOfToolsetDto, type ProvisionedResourceInfo, type RefreshStatus, type RefreshStatusResponse, type ReplaceConnectionRequest, type SelectObjectsRequest, type SetDefaultConnectionResponse, type SignInUrlRequest, type SignInUrlResponse, type SolutionAdminWriteResponse, type SolutionDetailResponse, type SolutionInstallationResponse, type SolutionManifest, type SolutionManifestBuildSpec, type SolutionResponse, type SolutionsArchiveSolutionData, type SolutionsArchiveSolutionError, type SolutionsArchiveSolutionErrors, type SolutionsArchiveSolutionResponse, type SolutionsArchiveSolutionResponses, type SolutionsBuildManifestData, type SolutionsBuildManifestError, type SolutionsBuildManifestErrors, type SolutionsBuildManifestResponse, type SolutionsBuildManifestResponses, type SolutionsCreateSolutionData, type SolutionsCreateSolutionError, type SolutionsCreateSolutionErrors, type SolutionsCreateSolutionResponse, type SolutionsCreateSolutionResponses, type SolutionsGetInstallationDetailData, type SolutionsGetInstallationDetailError, type SolutionsGetInstallationDetailErrors, type SolutionsGetInstallationDetailResponse, type SolutionsGetInstallationDetailResponses, type SolutionsGetInstallationResourcesData, type SolutionsGetInstallationResourcesError, type SolutionsGetInstallationResourcesErrors, type SolutionsGetInstallationResourcesResponse, type SolutionsGetInstallationResourcesResponses, type SolutionsGetInstallationsData, type SolutionsGetInstallationsError, type SolutionsGetInstallationsErrors, type SolutionsGetInstallationsResponse, type SolutionsGetInstallationsResponses, type SolutionsGetPublishedSolutionsData, type SolutionsGetPublishedSolutionsError, type SolutionsGetPublishedSolutionsErrors, type SolutionsGetPublishedSolutionsResponse, type SolutionsGetPublishedSolutionsResponses, type SolutionsGetSolutionBySlugData, type SolutionsGetSolutionBySlugError, type SolutionsGetSolutionBySlugErrors, type SolutionsGetSolutionBySlugResponse, type SolutionsGetSolutionBySlugResponses, type SolutionsInstallSolutionData, type SolutionsInstallSolutionError, type SolutionsInstallSolutionErrors, type SolutionsInstallSolutionResponse, type SolutionsInstallSolutionResponses, type SolutionsPublishSolutionData, type SolutionsPublishSolutionError, type SolutionsPublishSolutionErrors, type SolutionsPublishSolutionResponse, type SolutionsPublishSolutionResponses, type SolutionsUninstallSolutionData, type SolutionsUninstallSolutionError, type SolutionsUninstallSolutionErrors, type SolutionsUninstallSolutionResponse, type SolutionsUninstallSolutionResponses, type SolutionsUpdateInstallationData, type SolutionsUpdateInstallationError, type SolutionsUpdateInstallationErrors, type SolutionsUpdateInstallationResponse, type SolutionsUpdateInstallationResponses, type SolutionsUpdateSolutionData, type SolutionsUpdateSolutionError, type SolutionsUpdateSolutionErrors, type SolutionsUpdateSolutionResponse, type SolutionsUpdateSolutionResponses, type TableDefinitionDto, type TableFieldDto, type ToolDetailDto, type ToolDto, type ToolExecuteRequest, type ToolExecuteResponse, type ToolsExecuteToolData, type ToolsExecuteToolError, type ToolsExecuteToolErrors, type ToolsExecuteToolResponse, type ToolsExecuteToolResponses, type ToolsGetToolData, type ToolsGetToolError, type ToolsGetToolErrors, type ToolsGetToolResponse, type ToolsGetToolResponses, type ToolsListToolsData, type ToolsListToolsError, type ToolsListToolsErrors, type ToolsListToolsResponse, type ToolsListToolsResponses, type ToolsetConnectionDto, type ToolsetConnectionRequest, type ToolsetDto, type ToolsetsCreateToolsetData, type ToolsetsCreateToolsetError, type ToolsetsCreateToolsetErrors, type ToolsetsCreateToolsetResponse, type ToolsetsCreateToolsetResponses, type ToolsetsDeleteToolsetData, type ToolsetsDeleteToolsetError, type ToolsetsDeleteToolsetErrors, type ToolsetsDeleteToolsetResponse, type ToolsetsDeleteToolsetResponses, type ToolsetsGetToolsetData, type ToolsetsGetToolsetError, type ToolsetsGetToolsetErrors, type ToolsetsGetToolsetResponse, type ToolsetsGetToolsetResponses, type ToolsetsListToolsetsData, type ToolsetsListToolsetsError, type ToolsetsListToolsetsErrors, type ToolsetsListToolsetsResponse, type ToolsetsListToolsetsResponses, type ToolsetsUpdateToolsetData, type ToolsetsUpdateToolsetError, type ToolsetsUpdateToolsetErrors, type ToolsetsUpdateToolsetResponse, type ToolsetsUpdateToolsetResponses, type UninstallSolutionRequest, type UpdateBlockedResponse, type UpdateBlocker, type UpdateConnectionRequest, type UpdateInstallationRequest, type UpdateInstallationResponse, type UpdateSolutionRequest, type UpdateToolsetRequest, type WhoAmIResponse, applicationsGetApplication, applicationsListApplications, authWhoAmI, connectionsCheckConnection, connectionsClearDefaultConnection, connectionsCreateConnection, connectionsDeleteConnection, connectionsGetAccessToken, connectionsGetConnection, connectionsGetConnectionObjects, connectionsGetConnections, connectionsGetDefaultConnections, connectionsGetRefreshStatus, connectionsGetSignInUrl, connectionsRefreshObjects, connectionsReplaceConnection, connectionsSelectObjects, connectionsSetDefaultConnection, connectionsUpdateConnection, createEnginiClient, solutionsArchiveSolution, solutionsBuildManifest, solutionsCreateSolution, solutionsGetInstallationDetail, solutionsGetInstallationResources, solutionsGetInstallations, solutionsGetPublishedSolutions, solutionsGetSolutionBySlug, solutionsInstallSolution, solutionsPublishSolution, solutionsUninstallSolution, solutionsUpdateInstallation, solutionsUpdateSolution, toolsExecuteTool, toolsGetTool, toolsListTools, toolsetsCreateToolset, toolsetsDeleteToolset, toolsetsGetToolset, toolsetsListToolsets, toolsetsUpdateToolset };