@coval/sdk 0.3.1 → 0.4.1

package/dist/retry.js

@@ -17,15 +17,24 @@ export function createRetryingFetch(options = {}, deps = {}) {
     const retryableMethods = options.retryableMethods ?? RETRYABLE_METHODS;
     const innerFetch = deps.fetch ?? globalThis.fetch;
     const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const stats = deps.stats;
+    const debug = deps.onDebug;
     return async function retryingFetch(input, init) {
         let lastError;
         const method = (init?.method ?? 'GET').toUpperCase();
         const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+        if (stats)
+            stats.calls += 1;
         if (!retryableMethods.has(method)) {
             try {
+                if (stats)
+                    stats.requests += 1;
                 return await innerFetch(input, init);
             }
             catch (err) {
+                if (stats)
+                    stats.networkErrors += 1;
+                debug?.(`coval-sdk: ${method} ${url} failed in transit (not retried): ${stringifyError(err)}`);
                 throw new CovalNetworkError({
                     message: `Coval API request failed: ${stringifyError(err)}`,
                     url,
@@ -37,16 +46,24 @@ export function createRetryingFetch(options = {}, deps = {}) {
         }
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
             try {
+                if (stats)
+                    stats.requests += 1;
                 const response = await innerFetch(input, init);
                 if (!retryable.has(response.status) || attempt === maxAttempts) {
                     return response;
                 }
                 const wait = computeDelay({ attempt, baseDelay, maxDelay, jitter, response });
+                if (stats)
+                    stats.retries += 1;
+                debug?.(`coval-sdk: ${method} ${url} returned ${response.status}, retrying in ${wait}ms (attempt ${attempt}/${maxAttempts})`);
                 await sleep(wait);
             }
             catch (err) {
                 lastError = err;
+                if (stats)
+                    stats.networkErrors += 1;
                 if (attempt === maxAttempts) {
+                    debug?.(`coval-sdk: ${method} ${url} failed in transit after ${attempt} attempts: ${stringifyError(err)}`);
                     throw new CovalNetworkError({
                         message: `Coval API request failed after ${attempt} attempt${attempt > 1 ? 's' : ''}: ${stringifyError(err)}`,
                         url,
@@ -56,6 +73,9 @@ export function createRetryingFetch(options = {}, deps = {}) {
                     });
                 }
                 const wait = computeDelay({ attempt, baseDelay, maxDelay, jitter });
+                if (stats)
+                    stats.retries += 1;
+                debug?.(`coval-sdk: ${method} ${url} failed in transit (${stringifyError(err)}), retrying in ${wait}ms (attempt ${attempt}/${maxAttempts})`);
                 await sleep(wait);
             }
         }

package/dist/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"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"}

package/dist/stats.d.ts

@@ -0,0 +1,13 @@
+export interface CovalTransportStats {
+    /** Logical API calls started. */
+    calls: number;
+    /** fetch invocations, including retries — exceeds `calls` when retries fire. */
+    requests: number;
+    /** Retry attempts beyond the initial request. */
+    retries: number;
+    /** fetch rejections: DNS failure, reset, abort, or a stranded pooled socket. */
+    networkErrors: number;
+}
+export declare function createTransportStats(): CovalTransportStats;
+export declare function formatTransportStats(stats: CovalTransportStats): string;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,IAAI,mBAAmB,CAE1D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAEvE"}

package/dist/stats.js

@@ -0,0 +1,13 @@
+// Transport counters for diagnosing intermittent failures.
+//
+// A request that dies in transit never reaches the API, so there is no
+// server-side trace of it. These counters are often the only evidence available
+// when a caller reports sporadic timeouts. Mirrors `connection_stats` in the
+// Python SDK.
+export function createTransportStats() {
+    return { calls: 0, requests: 0, retries: 0, networkErrors: 0 };
+}
+export function formatTransportStats(stats) {
+    return `CovalTransportStats(calls=${stats.calls}, requests=${stats.requests}, retries=${stats.retries}, networkErrors=${stats.networkErrors})`;
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,uEAAuE;AACvE,gFAAgF;AAChF,6EAA6E;AAC7E,cAAc;AAad,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAA0B;IAC7D,OAAO,6BAA6B,KAAK,CAAC,KAAK,cAAc,KAAK,CAAC,QAAQ,aAAa,KAAK,CAAC,OAAO,mBAAmB,KAAK,CAAC,aAAa,GAAG,CAAC;AACjJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coval/sdk",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Typed TypeScript client for the Coval evaluation platform API.",
   "license": "MIT",
   "author": "Coval <support@coval.dev>",

package/src/CovalClient.ts

@@ -13,6 +13,7 @@
 import { apiKeyAuthMiddleware } from './auth.js';
 import { CovalApiError, parseErrorResponse } from './errors.js';
 import { createRetryingFetch, type RetryOptions } from './retry.js';
+import { createTransportStats, type CovalTransportStats } from './stats.js';
 import {
   AgentsApi,
   APIKeysApi,
@@ -21,6 +22,7 @@ import {
   ConversationsApi,
   DashboardsApi,
   type FetchAPI,
+  IntegrationsApi,
   type Middleware,
   MetricOutputsApi,
   MetricsApi,
@@ -55,6 +57,11 @@ export interface CovalClientOptions {
   middleware?: Middleware[];
   /** Override the global fetch (e.g., for tests, undici-with-keepalive, etc). */
   fetch?: FetchAPI;
+  /**
+   * Called with a diagnostic line on each retry and each in-transit failure.
+   * Pass `console.debug` when investigating intermittent timeouts.
+   */
+  onDebug?: (message: string) => void;
 }
 
 const DEFAULT_BASE_URL = 'https://api.coval.dev/v1';
@@ -65,6 +72,7 @@ export class CovalClient {
   readonly audio: AudioApi;
   readonly conversations: ConversationsApi;
   readonly dashboards: DashboardsApi;
+  readonly integrations: IntegrationsApi;
   readonly metrics: MetricsApi;
   readonly metricOutputs: MetricOutputsApi;
   readonly monitors: MonitorsApi;
@@ -88,16 +96,29 @@ export class CovalClient {
 
   readonly configuration: Configuration;
 
+  /**
+   * Live transport counters. A request that dies in transit leaves no
+   * server-side trace, so these are often the only evidence when diagnosing
+   * intermittent failures. Include them when reporting one.
+   */
+  readonly stats: CovalTransportStats;
+
   constructor(options: CovalClientOptions) {
     if (!options.apiKey) {
       throw new Error('CovalClient: apiKey is required');
     }
 
+    this.stats = createTransportStats();
+
     const innerFetch: FetchAPI = options.fetch ?? (globalThis.fetch as FetchAPI);
     const fetchApi: FetchAPI =
       options.retry === false
         ? innerFetch
-        : createRetryingFetch(options.retry ?? {}, { fetch: innerFetch });
+        : createRetryingFetch(options.retry ?? {}, {
+            fetch: innerFetch,
+            stats: this.stats,
+            onDebug: options.onDebug,
+          });
 
     const middleware: Middleware[] = [
       apiKeyAuthMiddleware({ apiKey: options.apiKey }),
@@ -116,6 +137,7 @@ export class CovalClient {
     this.audio = new AudioApi(this.configuration);
     this.conversations = new ConversationsApi(this.configuration);
     this.dashboards = new DashboardsApi(this.configuration);
+    this.integrations = new IntegrationsApi(this.configuration);
     this.metrics = new MetricsApi(this.configuration);
     this.metricOutputs = new MetricOutputsApi(this.configuration);
     this.monitors = new MonitorsApi(this.configuration);

package/src/generated/apis/ConversationsApi.ts

@@ -223,11 +223,11 @@ export interface ConversationsApiInterface {
      * Creates request options for listConversations without sending the request
      * @param {number} [pageSize] Maximum number of conversations to return (1-250)
      * @param {string} [pageToken] Token for retrieving next page (from previous response)
-     * @param {string} [filter] Filter expression syntax.  **Operators:** `=`, `!=`, `>`, `<`, `>=`, `<=`, `AND`, `OR`  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Fields:** - `status` - PENDING, IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, DELETED - `external_conversation_id` - Your system\'s conversation ID - `create_time` - ISO 8601 timestamp - `occurred_at` - ISO 8601 timestamp - `metadata.{key}` - Custom metadata fields  **Examples:** - `status=COMPLETED` - `create_time>\"2025-11-01T00:00:00Z\"` - `status=COMPLETED AND occurred_at>=\"2025-11-01T00:00:00Z\"` - `external_conversation_id=external-call-abc` 
+     * @param {string} [filter] Filter expression syntax.  **Operators:** `=`, `!=`, `>`, `<`, `>=`, `<=`, `AND`, `OR`  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Fields:** - `status` - PENDING, IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, DELETED - `external_conversation_id` - Your system\'s conversation ID - `create_time` - ISO 8601 timestamp - `occurred_at` - ISO 8601 timestamp - `metadata.{key}` - Custom metadata fields - `metric.{metric_id}` - Filter by a metric\'s value (score filtering)  **Metric-value filtering:** a `metric.{metric_id}` predicate (e.g. `metric.29Blkepvvx<\"0.9\"`; `>`/`<`/`>=`/`<=`/`=`/`!=` for float metrics, `=`/`!=` for string metrics) returns only conversations whose metric matches, with every metric\'s value embedded inline (`metric_values`). The metric type is inferred from the literal — a numeric literal is compared as a float metric. When a metric predicate is present the request is served with keyset pagination, ordered newest-first by creation time, and supports only `AND` alongside `create_time` (inclusive bounds), `agent_id`, and `metadata.{key}`; other filter fields (including `occurred_at`) and any non-default `order_by` are rejected with 400, and `page_size` is capped at 100.  **Examples:** - `status=COMPLETED` - `create_time>\"2025-11-01T00:00:00Z\"` - `status=COMPLETED AND occurred_at>=\"2025-11-01T00:00:00Z\"` - `external_conversation_id=external-call-abc` - `metric.29BlkepvvX19ebbLDB0y6Q<\"0.5\"` 
      * @param {string} [orderBy] Sort field with optional `-` prefix for descending order.  **Fields:** `create_time`, `occurred_at`, `status`  **Examples:** - `create_time` (ascending) - `-create_time` (descending, most recent first) - `-occurred_at` (most recent conversations first) 
      * @param {'metric_breakdown'} [view] Set to `metric_breakdown` to return an aggregate of one metric\'s scores grouped by a `customer_metadata` key (e.g. vendor), computed over the whole scored monitoring corpus, instead of the conversation list. Requires `metric_id` and `group_by_metadata`; the response is a metric-breakdown object (`{view, metric_id, group_by_metadata, aggregation, breakdown:[{metadata_value, value, count}], total_count}`). 
      * @param {string} [metricId] Metric to aggregate when `view=metric_breakdown`, or the metric whose full outputs should be embedded when `include=metric_outputs`. 
-     * @param {'metric_outputs'} [include] Set to `metric_outputs` to embed full outputs for `metric_id` on every conversation in the returned page. Omitted by default to keep list payloads small. 
+     * @param {'metric_outputs' | 'metric_values'} [include] Set to `metric_outputs` to embed full outputs for `metric_id` on every conversation in the returned page, or `metric_values` to embed every metric\'s value inline on each conversation (keyset-paginated; `page_size` capped at 100). Omitted by default to keep list payloads small. 
      * @param {string} [groupByMetadata] Required when `view=metric_breakdown`: the customer_metadata key to group by (e.g. nlp_provider).
      * @param {'success' | 'avg'} [aggregation] Aggregation for `view=metric_breakdown`. Defaults to `success` (a YES/NO success rate) for binary/string metrics and `avg` (numeric mean) for float metrics. 
      * @param {Date} [startDate] Optional ISO-8601 lower bound (occurred_at) for `view=metric_breakdown`.
@@ -242,11 +242,11 @@ export interface ConversationsApiInterface {
      * @summary List conversations
      * @param {number} [pageSize] Maximum number of conversations to return (1-250)
      * @param {string} [pageToken] Token for retrieving next page (from previous response)
-     * @param {string} [filter] Filter expression syntax.  **Operators:** `=`, `!=`, `>`, `<`, `>=`, `<=`, `AND`, `OR`  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Fields:** - `status` - PENDING, IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, DELETED - `external_conversation_id` - Your system\'s conversation ID - `create_time` - ISO 8601 timestamp - `occurred_at` - ISO 8601 timestamp - `metadata.{key}` - Custom metadata fields  **Examples:** - `status=COMPLETED` - `create_time>\"2025-11-01T00:00:00Z\"` - `status=COMPLETED AND occurred_at>=\"2025-11-01T00:00:00Z\"` - `external_conversation_id=external-call-abc` 
+     * @param {string} [filter] Filter expression syntax.  **Operators:** `=`, `!=`, `>`, `<`, `>=`, `<=`, `AND`, `OR`  Values may be unquoted or double-quoted. Values containing spaces must be quoted.  **Fields:** - `status` - PENDING, IN_QUEUE, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, DELETED - `external_conversation_id` - Your system\'s conversation ID - `create_time` - ISO 8601 timestamp - `occurred_at` - ISO 8601 timestamp - `metadata.{key}` - Custom metadata fields - `metric.{metric_id}` - Filter by a metric\'s value (score filtering)  **Metric-value filtering:** a `metric.{metric_id}` predicate (e.g. `metric.29Blkepvvx<\"0.9\"`; `>`/`<`/`>=`/`<=`/`=`/`!=` for float metrics, `=`/`!=` for string metrics) returns only conversations whose metric matches, with every metric\'s value embedded inline (`metric_values`). The metric type is inferred from the literal — a numeric literal is compared as a float metric. When a metric predicate is present the request is served with keyset pagination, ordered newest-first by creation time, and supports only `AND` alongside `create_time` (inclusive bounds), `agent_id`, and `metadata.{key}`; other filter fields (including `occurred_at`) and any non-default `order_by` are rejected with 400, and `page_size` is capped at 100.  **Examples:** - `status=COMPLETED` - `create_time>\"2025-11-01T00:00:00Z\"` - `status=COMPLETED AND occurred_at>=\"2025-11-01T00:00:00Z\"` - `external_conversation_id=external-call-abc` - `metric.29BlkepvvX19ebbLDB0y6Q<\"0.5\"` 
      * @param {string} [orderBy] Sort field with optional `-` prefix for descending order.  **Fields:** `create_time`, `occurred_at`, `status`  **Examples:** - `create_time` (ascending) - `-create_time` (descending, most recent first) - `-occurred_at` (most recent conversations first) 
      * @param {'metric_breakdown'} [view] Set to `metric_breakdown` to return an aggregate of one metric\'s scores grouped by a `customer_metadata` key (e.g. vendor), computed over the whole scored monitoring corpus, instead of the conversation list. Requires `metric_id` and `group_by_metadata`; the response is a metric-breakdown object (`{view, metric_id, group_by_metadata, aggregation, breakdown:[{metadata_value, value, count}], total_count}`). 
      * @param {string} [metricId] Metric to aggregate when `view=metric_breakdown`, or the metric whose full outputs should be embedded when `include=metric_outputs`. 
-     * @param {'metric_outputs'} [include] Set to `metric_outputs` to embed full outputs for `metric_id` on every conversation in the returned page. Omitted by default to keep list payloads small. 
+     * @param {'metric_outputs' | 'metric_values'} [include] Set to `metric_outputs` to embed full outputs for `metric_id` on every conversation in the returned page, or `metric_values` to embed every metric\'s value inline on each conversation (keyset-paginated; `page_size` capped at 100). Omitted by default to keep list payloads small. 
      * @param {string} [groupByMetadata] Required when `view=metric_breakdown`: the customer_metadata key to group by (e.g. nlp_provider).
      * @param {'success' | 'avg'} [aggregation] Aggregation for `view=metric_breakdown`. Defaults to `success` (a YES/NO success rate) for binary/string metrics and `avg` (numeric mean) for float metrics. 
      * @param {Date} [startDate] Optional ISO-8601 lower bound (occurred_at) for `view=metric_breakdown`.
@@ -766,7 +766,8 @@ export type ListConversationsViewEnum = typeof ListConversationsViewEnum[keyof t
  * @export
  */
 export const ListConversationsIncludeEnum = {
-    MetricOutputs: 'metric_outputs'
+    MetricOutputs: 'metric_outputs',
+    MetricValues: 'metric_values'
 } as const;
 export type ListConversationsIncludeEnum = typeof ListConversationsIncludeEnum[keyof typeof ListConversationsIncludeEnum];
 /**

package/src/generated/apis/IntegrationsApi.ts

@@ -0,0 +1,267 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Coval Agents API
+ *  Manage configurations for simulations and evaluations. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@coval.dev
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime.js';
+import {
+    type CovalSlackIntegrationAPIConnectSlackRequest,
+    CovalSlackIntegrationAPIConnectSlackRequestFromJSON,
+    CovalSlackIntegrationAPIConnectSlackRequestToJSON,
+} from '../models/CovalSlackIntegrationAPIConnectSlackRequest.js';
+import {
+    type CovalSlackIntegrationAPIConnectSlackResponse,
+    CovalSlackIntegrationAPIConnectSlackResponseFromJSON,
+    CovalSlackIntegrationAPIConnectSlackResponseToJSON,
+} from '../models/CovalSlackIntegrationAPIConnectSlackResponse.js';
+import {
+    type CovalSlackIntegrationAPIDisconnectSlackResponse,
+    CovalSlackIntegrationAPIDisconnectSlackResponseFromJSON,
+    CovalSlackIntegrationAPIDisconnectSlackResponseToJSON,
+} from '../models/CovalSlackIntegrationAPIDisconnectSlackResponse.js';
+import {
+    type CovalSlackIntegrationAPIErrorResponse,
+    CovalSlackIntegrationAPIErrorResponseFromJSON,
+    CovalSlackIntegrationAPIErrorResponseToJSON,
+} from '../models/CovalSlackIntegrationAPIErrorResponse.js';
+import {
+    type CovalSlackIntegrationAPISlackStatusResponse,
+    CovalSlackIntegrationAPISlackStatusResponseFromJSON,
+    CovalSlackIntegrationAPISlackStatusResponseToJSON,
+} from '../models/CovalSlackIntegrationAPISlackStatusResponse.js';
+
+export interface ConnectSlackRequest {
+    covalSlackIntegrationAPIConnectSlackRequest: CovalSlackIntegrationAPIConnectSlackRequest;
+}
+
+/**
+ * IntegrationsApi - interface
+ * 
+ * @export
+ * @interface IntegrationsApiInterface
+ */
+export interface IntegrationsApiInterface {
+    /**
+     * Creates request options for connectSlack without sending the request
+     * @param {CovalSlackIntegrationAPIConnectSlackRequest} covalSlackIntegrationAPIConnectSlackRequest 
+     * @throws {RequiredError}
+     * @memberof IntegrationsApiInterface
+     */
+    connectSlackRequestOpts(requestParameters: ConnectSlackRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Exchange a Slack OAuth authorization code for a workspace connection. Obtain the code via Slack\'s OAuth flow using your registered redirect URI.
+     * @summary Connect a Slack workspace
+     * @param {CovalSlackIntegrationAPIConnectSlackRequest} covalSlackIntegrationAPIConnectSlackRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof IntegrationsApiInterface
+     */
+    connectSlackRaw(requestParameters: ConnectSlackRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalSlackIntegrationAPIConnectSlackResponse>>;
+
+    /**
+     * Exchange a Slack OAuth authorization code for a workspace connection. Obtain the code via Slack\'s OAuth flow using your registered redirect URI.
+     * Connect a Slack workspace
+     */
+    connectSlack(requestParameters: ConnectSlackRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSlackIntegrationAPIConnectSlackResponse>;
+
+    /**
+     * Creates request options for disconnectSlack without sending the request
+     * @throws {RequiredError}
+     * @memberof IntegrationsApiInterface
+     */
+    disconnectSlackRequestOpts(): Promise<runtime.RequestOpts>;
+
+    /**
+     * Disconnect the Slack workspace from your organization. Revokes the token (best-effort) and clears the stored integration data.
+     * @summary Disconnect Slack integration
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof IntegrationsApiInterface
+     */
+    disconnectSlackRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalSlackIntegrationAPIDisconnectSlackResponse>>;
+
+    /**
+     * Disconnect the Slack workspace from your organization. Revokes the token (best-effort) and clears the stored integration data.
+     * Disconnect Slack integration
+     */
+    disconnectSlack(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSlackIntegrationAPIDisconnectSlackResponse>;
+
+    /**
+     * Creates request options for getSlackStatus without sending the request
+     * @throws {RequiredError}
+     * @memberof IntegrationsApiInterface
+     */
+    getSlackStatusRequestOpts(): Promise<runtime.RequestOpts>;
+
+    /**
+     * Returns whether a Slack workspace is connected for your organization, and the connected team name. No secrets are returned.
+     * @summary Get Slack integration status
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof IntegrationsApiInterface
+     */
+    getSlackStatusRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalSlackIntegrationAPISlackStatusResponse>>;
+
+    /**
+     * Returns whether a Slack workspace is connected for your organization, and the connected team name. No secrets are returned.
+     * Get Slack integration status
+     */
+    getSlackStatus(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSlackIntegrationAPISlackStatusResponse>;
+
+}
+
+/**
+ * 
+ */
+export class IntegrationsApi extends runtime.BaseAPI implements IntegrationsApiInterface {
+
+    /**
+     * Creates request options for connectSlack without sending the request
+     */
+    async connectSlackRequestOpts(requestParameters: ConnectSlackRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['covalSlackIntegrationAPIConnectSlackRequest'] == null) {
+            throw new runtime.RequiredError(
+                'covalSlackIntegrationAPIConnectSlackRequest',
+                'Required parameter "covalSlackIntegrationAPIConnectSlackRequest" was null or undefined when calling connectSlack().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Slack_Integration_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/integrations/slack/connect`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CovalSlackIntegrationAPIConnectSlackRequestToJSON(requestParameters['covalSlackIntegrationAPIConnectSlackRequest']),
+        };
+    }
+
+    /**
+     * Exchange a Slack OAuth authorization code for a workspace connection. Obtain the code via Slack\'s OAuth flow using your registered redirect URI.
+     * Connect a Slack workspace
+     */
+    async connectSlackRaw(requestParameters: ConnectSlackRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalSlackIntegrationAPIConnectSlackResponse>> {
+        const requestOptions = await this.connectSlackRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalSlackIntegrationAPIConnectSlackResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Exchange a Slack OAuth authorization code for a workspace connection. Obtain the code via Slack\'s OAuth flow using your registered redirect URI.
+     * Connect a Slack workspace
+     */
+    async connectSlack(requestParameters: ConnectSlackRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSlackIntegrationAPIConnectSlackResponse> {
+        const response = await this.connectSlackRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for disconnectSlack without sending the request
+     */
+    async disconnectSlackRequestOpts(): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Slack_Integration_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/integrations/slack`;
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Disconnect the Slack workspace from your organization. Revokes the token (best-effort) and clears the stored integration data.
+     * Disconnect Slack integration
+     */
+    async disconnectSlackRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalSlackIntegrationAPIDisconnectSlackResponse>> {
+        const requestOptions = await this.disconnectSlackRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalSlackIntegrationAPIDisconnectSlackResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Disconnect the Slack workspace from your organization. Revokes the token (best-effort) and clears the stored integration data.
+     * Disconnect Slack integration
+     */
+    async disconnectSlack(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSlackIntegrationAPIDisconnectSlackResponse> {
+        const response = await this.disconnectSlackRaw(initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getSlackStatus without sending the request
+     */
+    async getSlackStatusRequestOpts(): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // Coval_Slack_Integration_API_ApiKeyAuth authentication
+        }
+
+
+        let urlPath = `/integrations/slack`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns whether a Slack workspace is connected for your organization, and the connected team name. No secrets are returned.
+     * Get Slack integration status
+     */
+    async getSlackStatusRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CovalSlackIntegrationAPISlackStatusResponse>> {
+        const requestOptions = await this.getSlackStatusRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => CovalSlackIntegrationAPISlackStatusResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Returns whether a Slack workspace is connected for your organization, and the connected team name. No secrets are returned.
+     * Get Slack integration status
+     */
+    async getSlackStatus(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CovalSlackIntegrationAPISlackStatusResponse> {
+        const response = await this.getSlackStatusRaw(initOverrides);
+        return await response.value();
+    }
+
+}