@clawscarf/cli 0.1.0-alpha.1

package/services/connections/cloud/generated/types.gen.d.ts

@@ -0,0 +1,1044 @@
+export type ClientOptions = {
+    baseUrl: `${string}://services` | (string & {});
+};
+export type ConnectorList = {
+    items: Array<Connector>;
+    nextCursor: string | null;
+};
+export type Connector = {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    iconUrl: string;
+    auth: {
+        kind: 'managed';
+    } | {
+        kind: 'custom';
+        scheme: string;
+    };
+    catalogVersion: string;
+    actionCount: number;
+};
+export type Problem = {
+    type: string;
+    title: string;
+    status: number;
+    code: string;
+    requestId: string;
+    quota?: {
+        scope: 'account' | 'installation' | 'backend';
+        unit: 'executions' | 'requests' | 'installations';
+        limit: number;
+        resetsAt: string | null;
+    };
+    detail?: string;
+    retry?: RetryGuidance;
+};
+export type ConnectionList = {
+    items: Array<Connection>;
+    nextCursor: string | null;
+};
+/**
+ * Current authorized connection state for this server.
+ */
+export type Connection = {
+    id: Id;
+    connectorId: string;
+    name: string;
+    grant: ConnectorAgentGrant;
+    state: 'not_connected' | 'connected' | 'needs_attention' | 'disconnected';
+    generation: number;
+    revision: number;
+    setup: ConnectionSetup | null;
+    cleanup: 'none' | 'pending' | 'complete' | 'needs_attention';
+    failure: ConnectionFailure | null;
+    createdAt: string;
+    updatedAt: string;
+    serverId: Id;
+};
+/**
+ * Opaque identifier; clients must not infer identity or provider details from it.
+ */
+export type Id = string;
+/**
+ * All includes future native agents. Selected uses exact IDs; missing IDs never widen the grant.
+ */
+export type ConnectorAgentGrant = {
+    mode: 'all';
+} | {
+    mode: 'selected';
+    agentIds: Array<string>;
+};
+export type ConnectionSetup = {
+    id: Id;
+    connectionId: Id;
+    kind: 'initial' | 'reconnect';
+    state: 'creating' | 'pending' | 'verifying' | 'succeeded' | 'expired' | 'cancelled' | 'failed' | 'outcome_unknown';
+    createdAt: string;
+    expiresAt: string | null;
+    completedAt: string | null;
+    failure: ConnectionFailure | null;
+};
+export type ConnectionFailure = {
+    code: 'provider_unavailable' | 'provider_rejected' | 'provider_not_configured' | 'setup_expired' | 'setup_cancelled' | 'setup_outcome_unknown' | 'account_unavailable' | 'account_mismatch' | 'credential_revoked' | 'catalog_changed' | 'outcome_unknown' | 'result_unavailable';
+    detail: string;
+    retry: RetryGuidance;
+};
+/**
+ * Retry advice does not authorize replaying a mutation. Preserve idempotency keys and reconcile uncertain outcomes.
+ */
+export type RetryGuidance = {
+    /**
+     * never means no automatic replay; after_change requires a corrected
+     * request or changed prerequisite; reconcile means inspect the original
+     * command outcome before deciding whether another attempt is safe.
+     *
+     */
+    strategy: 'never' | 'after_delay' | 'after_change' | 'reconcile';
+    /**
+     * Only when a retry time is known; consistent with Retry-After when provided.
+     */
+    afterSeconds?: number;
+};
+export type CreateConnection = {
+    connectorId: string;
+    name: string;
+    grant: ConnectorAgentGrant;
+};
+export type UpdateConnection = {
+    name: string;
+    grant: ConnectorAgentGrant;
+};
+export type StartConnectionSetup = {
+    kind: 'initial' | 'reconnect';
+};
+/**
+ * Only the initiating user with current native-administrator admission may obtain the unexpired setup URL. URLs contain provider capabilities and must not be logged or included in ordinary list responses.
+ */
+export type ConnectionSetupContinuation = {
+    setup: ConnectionSetup;
+    url: string | null;
+};
+/**
+ * Current authorized connection state for this server.
+ */
+export type ConnectionReturnDestination = {
+    connectionId: string;
+    serverId: string;
+};
+export type ConnectionProblem = {
+    type: 'about:blank';
+    title: string;
+    status: number;
+    /**
+     * Stable machine-readable code; clients tolerate additional codes.
+     */
+    code: string;
+    /**
+     * Safe explanation without raw provider diagnostics or secrets.
+     */
+    detail: string;
+    /**
+     * Request correlation ID for operator diagnostics.
+     */
+    requestId?: string;
+    retry?: RetryGuidance;
+    quota?: {
+        scope: 'account' | 'installation' | 'backend';
+        unit: 'executions' | 'requests' | 'installations';
+        limit: number;
+        resetsAt: string | null;
+    };
+};
+export type ConnectionUsage = {
+    unit: 'executions';
+    resetsAt: string;
+    limits: Array<{
+        scope: 'account' | 'installation' | 'backend';
+        backend: string | null;
+        installation: boolean;
+        limit: number;
+        used: number;
+    }>;
+};
+export type ConnectorId = string;
+/**
+ * Stable for one logical request; scoped by server, actor and operation kind.
+ */
+export type IdempotencyKey = string;
+export type ConnectionId = Id;
+/**
+ * Quoted current connection revision, for example "3". Applies to the connection record, not the installation or provider configuration.
+ */
+export type ConnectionRevision = string;
+export type ConnectionSetupId = Id;
+export type ListConnectorsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        limit?: number;
+        cursor?: string;
+        query?: string;
+        category?: string;
+    };
+    url: '/_clawscarf/connections/v1/connectors';
+};
+export type ListConnectorsErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type ListConnectorsError = ListConnectorsErrors[keyof ListConnectorsErrors];
+export type ListConnectorsResponses = {
+    /**
+     * Current resource.
+     */
+    200: ConnectorList;
+};
+export type ListConnectorsResponse = ListConnectorsResponses[keyof ListConnectorsResponses];
+export type GetConnectorData = {
+    body?: never;
+    path: {
+        connectorId: string;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connectors/{connectorId}';
+};
+export type GetConnectorErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type GetConnectorError = GetConnectorErrors[keyof GetConnectorErrors];
+export type GetConnectorResponses = {
+    /**
+     * Current resource.
+     */
+    200: Connector;
+};
+export type GetConnectorResponse = GetConnectorResponses[keyof GetConnectorResponses];
+export type ListConnectionsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        limit?: number;
+        cursor?: string;
+        includeDisconnected?: boolean;
+    };
+    url: '/_clawscarf/connections/v1/connections';
+};
+export type ListConnectionsErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type ListConnectionsError = ListConnectionsErrors[keyof ListConnectionsErrors];
+export type ListConnectionsResponses = {
+    /**
+     * Current resource.
+     */
+    200: ConnectionList;
+};
+export type ListConnectionsResponse = ListConnectionsResponses[keyof ListConnectionsResponses];
+export type CreateConnectionData = {
+    body: CreateConnection;
+    headers: {
+        /**
+         * Stable for one logical request; scoped by server, actor and operation kind.
+         */
+        'idempotency-key': string;
+        'x-csrf-token': string;
+    };
+    path?: never;
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections';
+};
+export type CreateConnectionErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type CreateConnectionError = CreateConnectionErrors[keyof CreateConnectionErrors];
+export type CreateConnectionResponses = {
+    /**
+     * Current resource.
+     */
+    201: Connection;
+};
+export type CreateConnectionResponse = CreateConnectionResponses[keyof CreateConnectionResponses];
+export type DisconnectConnectionData = {
+    body?: never;
+    headers: {
+        /**
+         * Quoted current connection revision, for example "3". Applies to the connection record, not the installation or provider configuration.
+         */
+        'if-match': string;
+        /**
+         * Stable for one logical request; scoped by server, actor and operation kind.
+         */
+        'idempotency-key': string;
+        'x-csrf-token': string;
+    };
+    path: {
+        connectionId: Id;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections/{connectionId}';
+};
+export type DisconnectConnectionErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type DisconnectConnectionError = DisconnectConnectionErrors[keyof DisconnectConnectionErrors];
+export type DisconnectConnectionResponses = {
+    /**
+     * Current resource.
+     */
+    202: Connection;
+};
+export type DisconnectConnectionResponse = DisconnectConnectionResponses[keyof DisconnectConnectionResponses];
+export type GetConnectionData = {
+    body?: never;
+    path: {
+        connectionId: Id;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections/{connectionId}';
+};
+export type GetConnectionErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type GetConnectionError = GetConnectionErrors[keyof GetConnectionErrors];
+export type GetConnectionResponses = {
+    /**
+     * Current resource.
+     */
+    200: Connection;
+};
+export type GetConnectionResponse = GetConnectionResponses[keyof GetConnectionResponses];
+export type UpdateConnectionData = {
+    body: UpdateConnection;
+    headers: {
+        /**
+         * Quoted current connection revision, for example "3". Applies to the connection record, not the installation or provider configuration.
+         */
+        'if-match': string;
+        /**
+         * Stable for one logical request; scoped by server, actor and operation kind.
+         */
+        'idempotency-key': string;
+        'x-csrf-token': string;
+    };
+    path: {
+        connectionId: Id;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections/{connectionId}';
+};
+export type UpdateConnectionErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type UpdateConnectionError = UpdateConnectionErrors[keyof UpdateConnectionErrors];
+export type UpdateConnectionResponses = {
+    /**
+     * Current resource.
+     */
+    200: Connection;
+};
+export type UpdateConnectionResponse = UpdateConnectionResponses[keyof UpdateConnectionResponses];
+export type StartConnectionSetupData = {
+    body: StartConnectionSetup;
+    headers: {
+        /**
+         * Quoted current connection revision, for example "3". Applies to the connection record, not the installation or provider configuration.
+         */
+        'if-match': string;
+        /**
+         * Stable for one logical request; scoped by server, actor and operation kind.
+         */
+        'idempotency-key': string;
+        'x-csrf-token': string;
+    };
+    path: {
+        connectionId: Id;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/setups';
+};
+export type StartConnectionSetupErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type StartConnectionSetupError = StartConnectionSetupErrors[keyof StartConnectionSetupErrors];
+export type StartConnectionSetupResponses = {
+    /**
+     * Current resource.
+     */
+    202: ConnectionSetupContinuation;
+};
+export type StartConnectionSetupResponse = StartConnectionSetupResponses[keyof StartConnectionSetupResponses];
+export type CancelConnectionSetupData = {
+    body?: never;
+    headers: {
+        /**
+         * Quoted current connection revision, for example "3". Applies to the connection record, not the installation or provider configuration.
+         */
+        'if-match': string;
+        /**
+         * Stable for one logical request; scoped by server, actor and operation kind.
+         */
+        'idempotency-key': string;
+        'x-csrf-token': string;
+    };
+    path: {
+        connectionId: Id;
+        setupId: Id;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/setups/{setupId}';
+};
+export type CancelConnectionSetupErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type CancelConnectionSetupError = CancelConnectionSetupErrors[keyof CancelConnectionSetupErrors];
+export type CancelConnectionSetupResponses = {
+    /**
+     * Current resource.
+     */
+    200: ConnectionSetup;
+};
+export type CancelConnectionSetupResponse = CancelConnectionSetupResponses[keyof CancelConnectionSetupResponses];
+export type GetConnectionSetupData = {
+    body?: never;
+    path: {
+        connectionId: Id;
+        setupId: Id;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/setups/{setupId}';
+};
+export type GetConnectionSetupErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type GetConnectionSetupError = GetConnectionSetupErrors[keyof GetConnectionSetupErrors];
+export type GetConnectionSetupResponses = {
+    /**
+     * Current resource.
+     */
+    200: ConnectionSetupContinuation;
+};
+export type GetConnectionSetupResponse = GetConnectionSetupResponses[keyof GetConnectionSetupResponses];
+export type RefreshConnectionData = {
+    body?: never;
+    headers: {
+        /**
+         * Quoted current connection revision, for example "3". Applies to the connection record, not the installation or provider configuration.
+         */
+        'if-match': string;
+        /**
+         * Stable for one logical request; scoped by server, actor and operation kind.
+         */
+        'idempotency-key': string;
+    };
+    path: {
+        connectionId: Id;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/refresh';
+};
+export type RefreshConnectionErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type RefreshConnectionError = RefreshConnectionErrors[keyof RefreshConnectionErrors];
+export type RefreshConnectionResponses = {
+    /**
+     * Current resource.
+     */
+    200: Connection;
+};
+export type RefreshConnectionResponse = RefreshConnectionResponses[keyof RefreshConnectionResponses];
+export type CompleteConnectionSetupData = {
+    body: {
+        sessionUri: string;
+    };
+    headers: {
+        'x-csrf-token': string;
+    };
+    path: {
+        connectionId: Id;
+        setupId: Id;
+    };
+    query?: never;
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/setups/{setupId}/complete';
+};
+export type CompleteConnectionSetupErrors = {
+    /**
+     * Request failed
+     */
+    default: ConnectionProblem;
+};
+export type CompleteConnectionSetupError = CompleteConnectionSetupErrors[keyof CompleteConnectionSetupErrors];
+export type CompleteConnectionSetupResponses = {
+    /**
+     * The authorized connection destination, including a recovered completion.
+     */
+    200: ConnectionReturnDestination;
+};
+export type CompleteConnectionSetupResponse = CompleteConnectionSetupResponses[keyof CompleteConnectionSetupResponses];
+export type GetConnectionUsageData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/_clawscarf/connections/v1/usage';
+};
+export type GetConnectionUsageErrors = {
+    /**
+     * Invalid JSON, field or request shape; code invalid_request.
+     */
+    400: Problem;
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Resource absent or not accessible in the server; code not_found.
+     */
+    404: Problem;
+    /**
+     * The command conflicts with current state or a previous idempotent request.
+     */
+    409: Problem;
+    /**
+     * The observed resource revision is stale; code revision_conflict.
+     */
+    412: Problem;
+    /**
+     * Request exceeds this route's configured body limit; code request_too_large.
+     */
+    413: Problem;
+    /**
+     * Request body must use application/json; code unsupported_media_type.
+     */
+    415: Problem;
+    /**
+     * Request limit reached; code rate_limited.
+     */
+    429: Problem;
+    /**
+     * Safe failure response; no provider payload, stack trace or credential is exposed.
+     */
+    500: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type GetConnectionUsageError = GetConnectionUsageErrors[keyof GetConnectionUsageErrors];
+export type GetConnectionUsageResponses = {
+    /**
+     * Current resource.
+     */
+    200: ConnectionUsage;
+};
+export type GetConnectionUsageResponse = GetConnectionUsageResponses[keyof GetConnectionUsageResponses];
+export type ListConnectionAgentsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/_clawscarf/connections/v1/connection-agents';
+};
+export type ListConnectionAgentsErrors = {
+    /**
+     * Missing or invalid session or runtime credential; code unauthenticated.
+     */
+    401: Problem;
+    /**
+     * Authenticated caller lacks the required current authority; code forbidden.
+     */
+    403: Problem;
+    /**
+     * Required service unavailable; code dependency_unavailable.
+     */
+    503: Problem;
+};
+export type ListConnectionAgentsError = ListConnectionAgentsErrors[keyof ListConnectionAgentsErrors];
+export type ListConnectionAgentsResponses = {
+    /**
+     * Current native agent inventory
+     */
+    200: {
+        agents: Array<{
+            id: string;
+            name: string | null;
+        }>;
+    };
+};
+export type ListConnectionAgentsResponse = ListConnectionAgentsResponses[keyof ListConnectionAgentsResponses];