@clawscarf/cli 0.1.0-alpha.1

package/services/cloud/generated/types.gen.js

@@ -0,0 +1,2 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export {};

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

@@ -0,0 +1,12 @@
+import { type Client, type ClientOptions, type Config } from '../../../../generated/http/client/index.js';
+import type { ClientOptions as ClientOptions2 } from './types.gen.js';
+/**
+ * The `createClientConfig()` function will be called on client initialization
+ * and the returned object will become the client's initial configuration.
+ *
+ * You may want to initialize your client this way instead of calling
+ * `setConfig()`. This is useful for example if you're using Next.js
+ * to ensure your client always has the correct values.
+ */
+export type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
+export declare const client: Client;

package/services/connections/cloud/generated/client.gen.js

@@ -0,0 +1,3 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { createClient, createConfig } from '../../../../generated/http/client/index.js';
+export const client = createClient(createConfig({ baseUrl: 'services' }));

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

@@ -0,0 +1,68 @@
+import type { RouteHandler } from 'fastify';
+import type { CancelConnectionSetupData, CancelConnectionSetupErrors, CancelConnectionSetupResponses, CompleteConnectionSetupData, CompleteConnectionSetupResponses, CreateConnectionData, CreateConnectionErrors, CreateConnectionResponses, DisconnectConnectionData, DisconnectConnectionErrors, DisconnectConnectionResponses, GetConnectionData, GetConnectionErrors, GetConnectionResponses, GetConnectionSetupData, GetConnectionSetupErrors, GetConnectionSetupResponses, GetConnectionUsageErrors, GetConnectionUsageResponses, GetConnectorData, GetConnectorErrors, GetConnectorResponses, ListConnectionAgentsErrors, ListConnectionAgentsResponses, ListConnectionsData, ListConnectionsErrors, ListConnectionsResponses, ListConnectorsData, ListConnectorsErrors, ListConnectorsResponses, RefreshConnectionData, RefreshConnectionErrors, RefreshConnectionResponses, StartConnectionSetupData, StartConnectionSetupErrors, StartConnectionSetupResponses, UpdateConnectionData, UpdateConnectionErrors, UpdateConnectionResponses } from './types.gen.js';
+export type RouteHandlers = {
+    listConnectors: RouteHandler<{
+        Querystring?: ListConnectorsData['query'];
+        Reply: ListConnectorsErrors & ListConnectorsResponses;
+    }>;
+    getConnector: RouteHandler<{
+        Params: GetConnectorData['path'];
+        Reply: GetConnectorErrors & GetConnectorResponses;
+    }>;
+    listConnections: RouteHandler<{
+        Querystring?: ListConnectionsData['query'];
+        Reply: ListConnectionsErrors & ListConnectionsResponses;
+    }>;
+    createConnection: RouteHandler<{
+        Body: CreateConnectionData['body'];
+        Headers: CreateConnectionData['headers'];
+        Reply: CreateConnectionErrors & CreateConnectionResponses;
+    }>;
+    disconnectConnection: RouteHandler<{
+        Headers: DisconnectConnectionData['headers'];
+        Params: DisconnectConnectionData['path'];
+        Reply: DisconnectConnectionErrors & DisconnectConnectionResponses;
+    }>;
+    getConnection: RouteHandler<{
+        Params: GetConnectionData['path'];
+        Reply: GetConnectionErrors & GetConnectionResponses;
+    }>;
+    updateConnection: RouteHandler<{
+        Body: UpdateConnectionData['body'];
+        Headers: UpdateConnectionData['headers'];
+        Params: UpdateConnectionData['path'];
+        Reply: UpdateConnectionErrors & UpdateConnectionResponses;
+    }>;
+    startConnectionSetup: RouteHandler<{
+        Body: StartConnectionSetupData['body'];
+        Headers: StartConnectionSetupData['headers'];
+        Params: StartConnectionSetupData['path'];
+        Reply: StartConnectionSetupErrors & StartConnectionSetupResponses;
+    }>;
+    cancelConnectionSetup: RouteHandler<{
+        Headers: CancelConnectionSetupData['headers'];
+        Params: CancelConnectionSetupData['path'];
+        Reply: CancelConnectionSetupErrors & CancelConnectionSetupResponses;
+    }>;
+    getConnectionSetup: RouteHandler<{
+        Params: GetConnectionSetupData['path'];
+        Reply: GetConnectionSetupErrors & GetConnectionSetupResponses;
+    }>;
+    refreshConnection: RouteHandler<{
+        Headers: RefreshConnectionData['headers'];
+        Params: RefreshConnectionData['path'];
+        Reply: RefreshConnectionErrors & RefreshConnectionResponses;
+    }>;
+    completeConnectionSetup: RouteHandler<{
+        Body: CompleteConnectionSetupData['body'];
+        Headers: CompleteConnectionSetupData['headers'];
+        Params: CompleteConnectionSetupData['path'];
+        Reply: CompleteConnectionSetupResponses;
+    }>;
+    getConnectionUsage: RouteHandler<{
+        Reply: GetConnectionUsageErrors & GetConnectionUsageResponses;
+    }>;
+    listConnectionAgents: RouteHandler<{
+        Reply: ListConnectionAgentsErrors & ListConnectionAgentsResponses;
+    }>;
+};

package/services/connections/cloud/generated/fastify.gen.js

@@ -0,0 +1,2 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export {};

package/services/connections/cloud/generated/index.d.ts

@@ -0,0 +1,2 @@
+export { cancelConnectionSetup, completeConnectionSetup, createConnection, disconnectConnection, getConnection, getConnectionSetup, getConnectionUsage, getConnector, listConnectionAgents, listConnections, listConnectors, type Options, refreshConnection, startConnectionSetup, updateConnection } from './sdk.gen.js';
+export type { CancelConnectionSetupData, CancelConnectionSetupError, CancelConnectionSetupErrors, CancelConnectionSetupResponse, CancelConnectionSetupResponses, ClientOptions, CompleteConnectionSetupData, CompleteConnectionSetupError, CompleteConnectionSetupErrors, CompleteConnectionSetupResponse, CompleteConnectionSetupResponses, Connection, ConnectionFailure, ConnectionId, ConnectionList, ConnectionProblem, ConnectionReturnDestination, ConnectionRevision, ConnectionSetup, ConnectionSetupContinuation, ConnectionSetupId, ConnectionUsage, Connector, ConnectorAgentGrant, ConnectorId, ConnectorList, CreateConnection, CreateConnectionData, CreateConnectionError, CreateConnectionErrors, CreateConnectionResponse, CreateConnectionResponses, DisconnectConnectionData, DisconnectConnectionError, DisconnectConnectionErrors, DisconnectConnectionResponse, DisconnectConnectionResponses, GetConnectionData, GetConnectionError, GetConnectionErrors, GetConnectionResponse, GetConnectionResponses, GetConnectionSetupData, GetConnectionSetupError, GetConnectionSetupErrors, GetConnectionSetupResponse, GetConnectionSetupResponses, GetConnectionUsageData, GetConnectionUsageError, GetConnectionUsageErrors, GetConnectionUsageResponse, GetConnectionUsageResponses, GetConnectorData, GetConnectorError, GetConnectorErrors, GetConnectorResponse, GetConnectorResponses, Id, IdempotencyKey, ListConnectionAgentsData, ListConnectionAgentsError, ListConnectionAgentsErrors, ListConnectionAgentsResponse, ListConnectionAgentsResponses, ListConnectionsData, ListConnectionsError, ListConnectionsErrors, ListConnectionsResponse, ListConnectionsResponses, ListConnectorsData, ListConnectorsError, ListConnectorsErrors, ListConnectorsResponse, ListConnectorsResponses, Problem, RefreshConnectionData, RefreshConnectionError, RefreshConnectionErrors, RefreshConnectionResponse, RefreshConnectionResponses, RetryGuidance, StartConnectionSetup, StartConnectionSetupData, StartConnectionSetupError, StartConnectionSetupErrors, StartConnectionSetupResponse, StartConnectionSetupResponses, UpdateConnection, UpdateConnectionData, UpdateConnectionError, UpdateConnectionErrors, UpdateConnectionResponse, UpdateConnectionResponses } from './types.gen.js';

package/services/connections/cloud/generated/index.js

@@ -0,0 +1,2 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export { cancelConnectionSetup, completeConnectionSetup, createConnection, disconnectConnection, getConnection, getConnectionSetup, getConnectionUsage, getConnector, listConnectionAgents, listConnections, listConnectors, refreshConnection, startConnectionSetup, updateConnection } from './sdk.gen.js';

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

@@ -0,0 +1,95 @@
+import type { Client, ClientMeta, Options as Options2, RequestResult, TDataShape } from '../../../../generated/http/client/index.js';
+import type { CancelConnectionSetupData, CancelConnectionSetupErrors, CancelConnectionSetupResponses, CompleteConnectionSetupData, CompleteConnectionSetupErrors, CompleteConnectionSetupResponses, CreateConnectionData, CreateConnectionErrors, CreateConnectionResponses, DisconnectConnectionData, DisconnectConnectionErrors, DisconnectConnectionResponses, GetConnectionData, GetConnectionErrors, GetConnectionResponses, GetConnectionSetupData, GetConnectionSetupErrors, GetConnectionSetupResponses, GetConnectionUsageData, GetConnectionUsageErrors, GetConnectionUsageResponses, GetConnectorData, GetConnectorErrors, GetConnectorResponses, ListConnectionAgentsData, ListConnectionAgentsErrors, ListConnectionAgentsResponses, ListConnectionsData, ListConnectionsErrors, ListConnectionsResponses, ListConnectorsData, ListConnectorsErrors, ListConnectorsResponses, RefreshConnectionData, RefreshConnectionErrors, RefreshConnectionResponses, StartConnectionSetupData, StartConnectionSetupErrors, StartConnectionSetupResponses, UpdateConnectionData, UpdateConnectionErrors, UpdateConnectionResponses } from './types.gen.js';
+export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<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?: keyof ClientMeta extends never ? Record<string, unknown> : ClientMeta;
+};
+/**
+ * Browse available connectors
+ *
+ * Selected connector contract. Unavailable until the complete service and customer journey are wired and qualified.
+ */
+export declare const listConnectors: <ThrowOnError extends boolean = false>(options?: Options<ListConnectorsData, ThrowOnError>) => RequestResult<ListConnectorsResponses, ListConnectorsErrors, ThrowOnError>;
+/**
+ * Read connector metadata
+ *
+ * Selected connector contract. Unavailable until the complete service and customer journey are wired and qualified.
+ */
+export declare const getConnector: <ThrowOnError extends boolean = false>(options: Options<GetConnectorData, ThrowOnError>) => RequestResult<GetConnectorResponses, GetConnectorErrors, ThrowOnError>;
+/**
+ * List server connections
+ *
+ * Return connection metadata and setup status after verifying current native administrator authority. Credentials and setup continuation URLs are excluded. A failed read never establishes an empty collection.
+ */
+export declare const listConnections: <ThrowOnError extends boolean = false>(options?: Options<ListConnectionsData, ThrowOnError>) => RequestResult<ListConnectionsResponses, ListConnectionsErrors, ThrowOnError>;
+/**
+ * Create a named connection
+ *
+ * Create a named server-owned connection after verifying current native administrator authority. This neither authorizes a provider account nor starts external authentication. Agent grants are checked before activation. Identical authorized retries return the same record.
+ */
+export declare const createConnection: <ThrowOnError extends boolean = false>(options: Options<CreateConnectionData, ThrowOnError>) => RequestResult<CreateConnectionResponses, CreateConnectionErrors, ThrowOnError>;
+/**
+ * Disconnect an account
+ *
+ * Revoke local use immediately and cancel pending setup. Provider cleanup is durable and may complete later. Never continue granting local use because provider deletion failed. Retain receipts and exact cleanup references.
+ */
+export declare const disconnectConnection: <ThrowOnError extends boolean = false>(options: Options<DisconnectConnectionData, ThrowOnError>) => RequestResult<DisconnectConnectionResponses, DisconnectConnectionErrors, ThrowOnError>;
+/**
+ * Read a connection
+ *
+ * Read a named connection's agent grant, state, revision, setup and cleanup status, and safe failure summary. Recheck effective native administrator authority before reading. Credentials and setup continuation URLs are never included.
+ */
+export declare const getConnection: <ThrowOnError extends boolean = false>(options: Options<GetConnectionData, ThrowOnError>) => RequestResult<GetConnectionResponses, GetConnectionErrors, ThrowOnError>;
+/**
+ * Replace connection name and agent grant
+ *
+ * Replace both editable fields against the quoted current connection revision. Revocation and selected-agent changes take effect at the next broker boundary, including already pending operations.
+ */
+export declare const updateConnection: <ThrowOnError extends boolean = false>(options: Options<UpdateConnectionData, ThrowOnError>) => RequestResult<UpdateConnectionResponses, UpdateConnectionErrors, ThrowOnError>;
+/**
+ * Start connection or reconnection
+ *
+ * Persist one setup attempt before requesting its hosted authentication link. Admission and permission checks use ClawScarf state; setup performs no native management. Clients poll the returned setup and navigate to its continuation URL as soon as available. Account use remains disabled until callback identity, effective native administrator authority and selected agents are verified. Only its initiating user may continue. Reconnection keeps the current active account until the exact replacement is verified. A changed retry payload conflicts; uncertain setup creation is not blindly replayed. New attempts and provider preparation/allocation require the current published catalog. Authentication preparation has its own durable receipt; an uncertain preparation or allocation blocks replacement until resolved.
+ */
+export declare const startConnectionSetup: <ThrowOnError extends boolean = false>(options: Options<StartConnectionSetupData, ThrowOnError>) => RequestResult<StartConnectionSetupResponses, StartConnectionSetupErrors, ThrowOnError>;
+/**
+ * Cancel a setup attempt
+ *
+ * Idempotently cancel this exact setup attempt and schedule provider cleanup. A late callback cannot activate it. Completed setup cannot be cancelled; disconnect the connection explicitly.
+ */
+export declare const cancelConnectionSetup: <ThrowOnError extends boolean = false>(options: Options<CancelConnectionSetupData, ThrowOnError>) => RequestResult<CancelConnectionSetupResponses, CancelConnectionSetupErrors, ThrowOnError>;
+/**
+ * Read or continue a setup attempt
+ *
+ * Return current setup and its unexpired continuation URL only to the initiating user with current native administrator authority. This read never redeems a callback, creates an account or restarts expired setup.
+ */
+export declare const getConnectionSetup: <ThrowOnError extends boolean = false>(options: Options<GetConnectionSetupData, ThrowOnError>) => RequestResult<GetConnectionSetupResponses, GetConnectionSetupErrors, ThrowOnError>;
+/**
+ * Refresh connection status
+ *
+ * Observe the exact bound provider account after verifying native administrator authority and current revision. The initiator may finish an unexpired setup from a durably recorded identity receipt. Never redeem the callback again or infer identity from account status alone.
+ */
+export declare const refreshConnection: <ThrowOnError extends boolean = false>(options: Options<RefreshConnectionData, ThrowOnError>) => RequestResult<RefreshConnectionResponses, RefreshConnectionErrors, ThrowOnError>;
+/**
+ * Submit the receipt from the returning browser after checking its current installation identity and native authority. Polling a setup cannot activate it.
+ */
+export declare const completeConnectionSetup: <ThrowOnError extends boolean = false>(options: Options<CompleteConnectionSetupData, ThrowOnError>) => RequestResult<CompleteConnectionSetupResponses, CompleteConnectionSetupErrors, ThrowOnError>;
+/**
+ * Read current execution allowance
+ *
+ * Current account and installation allowance for this installation. Shared provider budgets are private.
+ */
+export declare const getConnectionUsage: <ThrowOnError extends boolean = false>(options?: Options<GetConnectionUsageData, ThrowOnError>) => RequestResult<GetConnectionUsageResponses, GetConnectionUsageErrors, ThrowOnError>;
+/**
+ * Discover agents for connection grants
+ */
+export declare const listConnectionAgents: <ThrowOnError extends boolean = false>(options?: Options<ListConnectionAgentsData, ThrowOnError>) => RequestResult<ListConnectionAgentsResponses, ListConnectionAgentsErrors, ThrowOnError>;

package/services/connections/cloud/generated/sdk.gen.js

@@ -0,0 +1,210 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { client } from './client.gen.js';
+/**
+ * Browse available connectors
+ *
+ * Selected connector contract. Unavailable until the complete service and customer journey are wired and qualified.
+ */
+export const listConnectors = (options) => (options?.client ?? client).get({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connectors',
+    ...options
+});
+/**
+ * Read connector metadata
+ *
+ * Selected connector contract. Unavailable until the complete service and customer journey are wired and qualified.
+ */
+export const getConnector = (options) => (options.client ?? client).get({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connectors/{connectorId}',
+    ...options
+});
+/**
+ * List server connections
+ *
+ * Return connection metadata and setup status after verifying current native administrator authority. Credentials and setup continuation URLs are excluded. A failed read never establishes an empty collection.
+ */
+export const listConnections = (options) => (options?.client ?? client).get({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections',
+    ...options
+});
+/**
+ * Create a named connection
+ *
+ * Create a named server-owned connection after verifying current native administrator authority. This neither authorizes a provider account nor starts external authentication. Agent grants are checked before activation. Identical authorized retries return the same record.
+ */
+export const createConnection = (options) => (options.client ?? client).post({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Disconnect an account
+ *
+ * Revoke local use immediately and cancel pending setup. Provider cleanup is durable and may complete later. Never continue granting local use because provider deletion failed. Retain receipts and exact cleanup references.
+ */
+export const disconnectConnection = (options) => (options.client ?? client).delete({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections/{connectionId}',
+    ...options
+});
+/**
+ * Read a connection
+ *
+ * Read a named connection's agent grant, state, revision, setup and cleanup status, and safe failure summary. Recheck effective native administrator authority before reading. Credentials and setup continuation URLs are never included.
+ */
+export const getConnection = (options) => (options.client ?? client).get({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections/{connectionId}',
+    ...options
+});
+/**
+ * Replace connection name and agent grant
+ *
+ * Replace both editable fields against the quoted current connection revision. Revocation and selected-agent changes take effect at the next broker boundary, including already pending operations.
+ */
+export const updateConnection = (options) => (options.client ?? client).patch({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections/{connectionId}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Start connection or reconnection
+ *
+ * Persist one setup attempt before requesting its hosted authentication link. Admission and permission checks use ClawScarf state; setup performs no native management. Clients poll the returned setup and navigate to its continuation URL as soon as available. Account use remains disabled until callback identity, effective native administrator authority and selected agents are verified. Only its initiating user may continue. Reconnection keeps the current active account until the exact replacement is verified. A changed retry payload conflicts; uncertain setup creation is not blindly replayed. New attempts and provider preparation/allocation require the current published catalog. Authentication preparation has its own durable receipt; an uncertain preparation or allocation blocks replacement until resolved.
+ */
+export const startConnectionSetup = (options) => (options.client ?? client).post({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/setups',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Cancel a setup attempt
+ *
+ * Idempotently cancel this exact setup attempt and schedule provider cleanup. A late callback cannot activate it. Completed setup cannot be cancelled; disconnect the connection explicitly.
+ */
+export const cancelConnectionSetup = (options) => (options.client ?? client).delete({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/setups/{setupId}',
+    ...options
+});
+/**
+ * Read or continue a setup attempt
+ *
+ * Return current setup and its unexpired continuation URL only to the initiating user with current native administrator authority. This read never redeems a callback, creates an account or restarts expired setup.
+ */
+export const getConnectionSetup = (options) => (options.client ?? client).get({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/setups/{setupId}',
+    ...options
+});
+/**
+ * Refresh connection status
+ *
+ * Observe the exact bound provider account after verifying native administrator authority and current revision. The initiator may finish an unexpired setup from a durably recorded identity receipt. Never redeem the callback again or infer identity from account status alone.
+ */
+export const refreshConnection = (options) => (options.client ?? client).post({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/refresh',
+    ...options
+});
+/**
+ * Submit the receipt from the returning browser after checking its current installation identity and native authority. Polling a setup cannot activate it.
+ */
+export const completeConnectionSetup = (options) => (options.client ?? client).post({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connections/{connectionId}/setups/{setupId}/complete',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Read current execution allowance
+ *
+ * Current account and installation allowance for this installation. Shared provider budgets are private.
+ */
+export const getConnectionUsage = (options) => (options?.client ?? client).get({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/usage',
+    ...options
+});
+/**
+ * Discover agents for connection grants
+ */
+export const listConnectionAgents = (options) => (options?.client ?? client).get({
+    security: [{
+            in: 'cookie',
+            name: 'clawscarf_session',
+            type: 'apiKey'
+        }],
+    url: '/_clawscarf/connections/v1/connection-agents',
+    ...options
+});