casedev 0.69.0 → 0.70.0

package/src/resources/connectors/v1/links.ts

@@ -7,17 +7,30 @@ import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
 /**
- * Import and export between provider folders (Google Drive) and vaults
+ * Import and export between provider folders and vaults
  */
 export class Links extends APIResource {
   /**
    * Retrieve one link: state, counts, and embedded active_run/last_run. Poll this
    * after POST /transfer.
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<void> {
+  retrieve(
+    id: string,
+    params: LinkRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'x-case-connector-subject': xCaseConnectorSubject } = params ?? {};
     return this._client.get(path`/connectors/v1/links/${id}`, {
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xCaseConnectorSubject != null ?
+            { 'x-case-connector-subject': xCaseConnectorSubject }
+          : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
@@ -25,11 +38,20 @@ export class Links extends APIResource {
    * Pause/resume a link (state "paused" | "ready"), change its mode (synced -> once
    * is the sync downgrade), or edit its policy in place.
    */
-  update(id: string, body: LinkUpdateParams, options?: RequestOptions): APIPromise<void> {
+  update(id: string, params: LinkUpdateParams, options?: RequestOptions): APIPromise<void> {
+    const { 'x-case-connector-subject': xCaseConnectorSubject, ...body } = params;
     return this._client.patch(path`/connectors/v1/links/${id}`, {
       body,
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xCaseConnectorSubject != null ?
+            { 'x-case-connector-subject': xCaseConnectorSubject }
+          : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
@@ -37,11 +59,20 @@ export class Links extends APIResource {
    * List transfer links, filterable by vault, connection, direction, mode, and
    * state.
    */
-  list(query: LinkListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+  list(params: LinkListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    const { 'x-case-connector-subject': xCaseConnectorSubject, ...query } = params ?? {};
     return this._client.get('/connectors/v1/links', {
       query,
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xCaseConnectorSubject != null ?
+            { 'x-case-connector-subject': xCaseConnectorSubject }
+          : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
@@ -54,11 +85,19 @@ export class Links extends APIResource {
     params: LinkDeleteParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<void> {
-    const { vault_docs } = params ?? {};
+    const { vault_docs, 'x-case-connector-subject': xCaseConnectorSubject } = params ?? {};
     return this._client.delete(path`/connectors/v1/links/${id}`, {
       query: { vault_docs },
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xCaseConnectorSubject != null ?
+            { 'x-case-connector-subject': xCaseConnectorSubject }
+          : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
@@ -68,51 +107,141 @@ export class Links extends APIResource {
    */
   listObjects(
     id: string,
-    query: LinkListObjectsParams | null | undefined = {},
+    params: LinkListObjectsParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<void> {
+    const { 'x-case-connector-subject': xCaseConnectorSubject, ...query } = params ?? {};
     return this._client.get(path`/connectors/v1/links/${id}/objects`, {
       query,
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xCaseConnectorSubject != null ?
+            { 'x-case-connector-subject': xCaseConnectorSubject }
+          : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 }
 
+export interface LinkRetrieveParams {
+  /**
+   * Trusted server-to-server application-user assertion. Derive it from the
+   * authenticated application session, never browser input. Omit only for the legacy
+   * organization-scoped namespace.
+   */
+  'x-case-connector-subject'?: string;
+}
+
 export interface LinkUpdateParams {
+  /**
+   * Body param
+   */
   mode?: 'once' | 'synced';
 
+  /**
+   * Body param: Replaces the entire stored policy; omitted fields return to
+   * defaults. Repeat deletes, collisions and filters that should be retained.
+   * Folder/file exclusions require deletes: preserve (the default).
+   */
   policy?: unknown;
 
+  /**
+   * Body param
+   */
   state?: 'paused' | 'ready';
+
+  /**
+   * Header param: Trusted server-to-server application-user assertion. Derive it
+   * from the authenticated application session, never browser input. Omit only for
+   * the legacy organization-scoped namespace.
+   */
+  'x-case-connector-subject'?: string;
 }
 
 export interface LinkListParams {
+  /**
+   * Query param
+   */
   connection_id?: string;
 
+  /**
+   * Query param: Opaque cursor from the previous page.
+   */
+  cursor?: string;
+
+  /**
+   * Query param
+   */
   direction?: 'import' | 'export';
 
+  /**
+   * Query param
+   */
   mode?: 'once' | 'synced';
 
+  /**
+   * Query param
+   */
   pair_id?: string;
 
+  /**
+   * Query param
+   */
   state?: 'ready' | 'running' | 'active' | 'paused' | 'orphaned' | 'error';
 
+  /**
+   * Query param
+   */
   vault_id?: string;
+
+  /**
+   * Header param: Trusted server-to-server application-user assertion. Derive it
+   * from the authenticated application session, never browser input. Omit only for
+   * the legacy organization-scoped namespace.
+   */
+  'x-case-connector-subject'?: string;
 }
 
 export interface LinkDeleteParams {
+  /**
+   * Query param
+   */
   vault_docs?: 'keep' | 'delete';
+
+  /**
+   * Header param: Trusted server-to-server application-user assertion. Derive it
+   * from the authenticated application session, never browser input. Omit only for
+   * the legacy organization-scoped namespace.
+   */
+  'x-case-connector-subject'?: string;
 }
 
 export interface LinkListObjectsParams {
+  /**
+   * Query param
+   */
   cursor?: string;
 
+  /**
+   * Query param
+   */
   state?: 'pending' | 'transferring' | 'ingesting' | 'synced' | 'skipped' | 'failed' | 'tombstoned';
+
+  /**
+   * Header param: Trusted server-to-server application-user assertion. Derive it
+   * from the authenticated application session, never browser input. Omit only for
+   * the legacy organization-scoped namespace.
+   */
+  'x-case-connector-subject'?: string;
 }
 
 export declare namespace Links {
   export {
+    type LinkRetrieveParams as LinkRetrieveParams,
     type LinkUpdateParams as LinkUpdateParams,
     type LinkListParams as LinkListParams,
     type LinkDeleteParams as LinkDeleteParams,

package/src/resources/connectors/v1/v1.ts

@@ -10,69 +10,202 @@ import {
   ConnectionDeleteParams,
   ConnectionListParams,
   ConnectionListResponse,
+  ConnectionRetrieveParams,
+  ConnectionUpdateAllParams,
   Connections,
 } from './connections';
 import * as LinksAPI from './links';
-import { LinkDeleteParams, LinkListObjectsParams, LinkListParams, LinkUpdateParams, Links } from './links';
+import {
+  LinkDeleteParams,
+  LinkListObjectsParams,
+  LinkListParams,
+  LinkRetrieveParams,
+  LinkUpdateParams,
+  Links,
+} from './links';
+import * as ApplicationsAPI from './applications/applications';
+import { Applications } from './applications/applications';
 import * as InstallationsAPI from './installations/installations';
 import {
   InstallationEnsureParams,
   InstallationListParams,
+  InstallationListResponse,
   Installations,
 } from './installations/installations';
 import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 
 /**
- * Import and export between provider folders (Google Drive) and vaults
+ * Import and export between provider folders and vaults
  */
 export class V1 extends APIResource {
+  applications: ApplicationsAPI.Applications = new ApplicationsAPI.Applications(this._client);
   installations: InstallationsAPI.Installations = new InstallationsAPI.Installations(this._client);
   connections: ConnectionsAPI.Connections = new ConnectionsAPI.Connections(this._client);
   links: LinksAPI.Links = new LinksAPI.Links(this._client);
 
   /**
    * Standing promise: backfill now, then stay current (the sync sweeper re-runs
-   * synced links on a schedule). Same body as /transfer minus run_mode. Upserts the
-   * link identified by (connection_id, direction, remote, vault_id); an existing
-   * once-link is upgraded in place with its ledger and cursor preserved. Downgrade
-   * or pause via PATCH /links/{id}.
+   * synced links on a schedule). Direction both creates paired import/export links
+   * and defaults export to a CaseMark Output subfolder. Same body as /transfer minus
+   * run_mode. Upserts links by (connection_id, direction, remote, vault_id);
+   * existing once-links are upgraded in place with their ledger and cursor
+   * preserved. Downgrade or pause via PATCH /links/{id}.
    */
-  syncLink(body: V1SyncLinkParams, options?: RequestOptions): APIPromise<V1SyncLinkResponse> {
-    return this._client.post('/connectors/v1/sync-link', { body, ...options });
+  syncLink(params: V1SyncLinkParams, options?: RequestOptions): APIPromise<V1SyncLinkResponse> {
+    const { 'x-case-connector-subject': xCaseConnectorSubject, ...body } = params;
+    return this._client.post('/connectors/v1/sync-link', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xCaseConnectorSubject != null ?
+            { 'x-case-connector-subject': xCaseConnectorSubject }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 
   /**
-   * One-shot import (provider folder → vault) or export (vault → provider folder).
-   * Upserts the link identified by (connection_id, direction, remote, vault_id):
-   * first call backfills, later calls move only new/changed files via the ledger.
-   * Poll GET /links/{id} → active_run for progress.
+   * One-shot import (provider folder → vault), export (vault → provider folder), or
+   * both. Direction both creates paired import/export links and defaults export to a
+   * CaseMark Output subfolder. Upserts links by (connection_id, direction, remote,
+   * vault_id): first call backfills, later calls move only new/changed files via the
+   * ledger. Poll GET /links/{id} → active_run for progress.
    */
-  transfer(body: V1TransferParams, options?: RequestOptions): APIPromise<V1TransferResponse> {
-    return this._client.post('/connectors/v1/transfer', { body, ...options });
+  transfer(params: V1TransferParams, options?: RequestOptions): APIPromise<V1TransferResponse> {
+    const { 'x-case-connector-subject': xCaseConnectorSubject, ...body } = params;
+    return this._client.post('/connectors/v1/transfer', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xCaseConnectorSubject != null ?
+            { 'x-case-connector-subject': xCaseConnectorSubject }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 }
 
+export interface SyncLinkLinkRun {
+  link_id: string;
+
+  started: boolean;
+
+  backlog?: number;
+
+  reason?: 'stale_run_recovery' | 'already_running' | 'ingestion_backlog';
+}
+
+/**
+ * Whether a provider scan started or was deferred.
+ */
+export interface SyncLinkRun {
+  started: boolean;
+
+  backlog?: number;
+
+  reason?: 'stale_run_recovery' | 'already_running' | 'ingestion_backlog';
+}
+
+export interface TransferLinkRun {
+  link_id: string;
+
+  started: boolean;
+
+  backlog?: number;
+
+  reason?: 'stale_run_recovery' | 'already_running' | 'ingestion_backlog';
+}
+
+/**
+ * Whether a provider scan started or was deferred.
+ */
+export interface TransferRun {
+  started: boolean;
+
+  backlog?: number;
+
+  reason?: 'stale_run_recovery' | 'already_running' | 'ingestion_backlog';
+}
+
 export interface V1SyncLinkResponse {
   links?: Array<unknown>;
+
+  /**
+   * Whether a provider scan started or was deferred.
+   */
+  run?: SyncLinkRun;
+
+  /**
+   * Start result for each link when direction is both.
+   */
+  runs?: Array<SyncLinkLinkRun>;
 }
 
 export interface V1TransferResponse {
   links?: Array<unknown>;
+
+  /**
+   * Whether a provider scan started or was deferred.
+   */
+  run?: TransferRun;
+
+  /**
+   * Start result for each link when direction is both.
+   */
+  runs?: Array<TransferLinkRun>;
 }
 
 export interface V1SyncLinkParams {
+  /**
+   * Body param
+   */
   connection_id: string;
 
-  direction: 'import' | 'export';
+  /**
+   * Body param
+   */
+  direction: 'import' | 'export' | 'both';
 
+  /**
+   * Body param
+   */
   remote: V1SyncLinkParams.Remote;
 
+  /**
+   * Body param
+   */
   vault_id: string;
 
+  /**
+   * Body param: Optional destination for direction both. Defaults to CaseMark Output
+   * under remote.
+   */
+  export_destination?: V1SyncLinkParams.ExportDestination;
+
+  /**
+   * Body param
+   */
   matter_id?: string | null;
 
+  /**
+   * Body param
+   */
   policy?: V1SyncLinkParams.Policy;
+
+  /**
+   * Header param: Trusted server-to-server application-user assertion. Derive it
+   * from the authenticated application session, never browser input. Omit only for
+   * the legacy organization-scoped namespace.
+   */
+  'x-case-connector-subject'?: string;
 }
 
 export namespace V1SyncLinkParams {
@@ -83,6 +216,22 @@ export namespace V1SyncLinkParams {
 
     path?: string;
 
+    resource_type?: string;
+
+    site_id?: string;
+  }
+
+  /**
+   * Optional destination for direction both. Defaults to CaseMark Output under
+   * remote.
+   */
+  export interface ExportDestination {
+    folder_id: string;
+
+    container_id?: string;
+
+    path?: string;
+
     site_id?: string;
   }
 
@@ -96,6 +245,16 @@ export namespace V1SyncLinkParams {
 
   export namespace Policy {
     export interface Filters {
+      /**
+       * Skip these stable document ids before download, including future versions.
+       */
+      exclude_file_ids?: Array<string>;
+
+      /**
+       * Skip these folders and all descendants during document imports.
+       */
+      exclude_folder_ids?: Array<string>;
+
       exclude_mime?: Array<string>;
 
       max_size_bytes?: number;
@@ -104,19 +263,53 @@ export namespace V1SyncLinkParams {
 }
 
 export interface V1TransferParams {
+  /**
+   * Body param
+   */
   connection_id: string;
 
-  direction: 'import' | 'export';
+  /**
+   * Body param
+   */
+  direction: 'import' | 'export' | 'both';
 
+  /**
+   * Body param
+   */
   remote: V1TransferParams.Remote;
 
+  /**
+   * Body param
+   */
   vault_id: string;
 
+  /**
+   * Body param: Optional destination for direction both. Defaults to CaseMark Output
+   * under remote.
+   */
+  export_destination?: V1TransferParams.ExportDestination;
+
+  /**
+   * Body param
+   */
   matter_id?: string | null;
 
+  /**
+   * Body param
+   */
   policy?: V1TransferParams.Policy;
 
+  /**
+   * Body param
+   */
   run_mode?: 'auto' | 'full_reconcile';
+
+  /**
+   * Header param: Trusted server-to-server application-user assertion. Derive it
+   * from the authenticated application session, never browser input. Omit only for
+   * the legacy organization-scoped namespace.
+   */
+  'x-case-connector-subject'?: string;
 }
 
 export namespace V1TransferParams {
@@ -127,6 +320,22 @@ export namespace V1TransferParams {
 
     path?: string;
 
+    resource_type?: string;
+
+    site_id?: string;
+  }
+
+  /**
+   * Optional destination for direction both. Defaults to CaseMark Output under
+   * remote.
+   */
+  export interface ExportDestination {
+    folder_id: string;
+
+    container_id?: string;
+
+    path?: string;
+
     site_id?: string;
   }
 
@@ -140,6 +349,16 @@ export namespace V1TransferParams {
 
   export namespace Policy {
     export interface Filters {
+      /**
+       * Skip these stable document ids before download, including future versions.
+       */
+      exclude_file_ids?: Array<string>;
+
+      /**
+       * Skip these folders and all descendants during document imports.
+       */
+      exclude_folder_ids?: Array<string>;
+
       exclude_mime?: Array<string>;
 
       max_size_bytes?: number;
@@ -147,20 +366,28 @@ export namespace V1TransferParams {
   }
 }
 
+V1.Applications = Applications;
 V1.Installations = Installations;
 V1.Connections = Connections;
 V1.Links = Links;
 
 export declare namespace V1 {
   export {
+    type SyncLinkLinkRun as SyncLinkLinkRun,
+    type SyncLinkRun as SyncLinkRun,
+    type TransferLinkRun as TransferLinkRun,
+    type TransferRun as TransferRun,
     type V1SyncLinkResponse as V1SyncLinkResponse,
     type V1TransferResponse as V1TransferResponse,
     type V1SyncLinkParams as V1SyncLinkParams,
     type V1TransferParams as V1TransferParams,
   };
 
+  export { Applications as Applications };
+
   export {
     Installations as Installations,
+    type InstallationListResponse as InstallationListResponse,
     type InstallationListParams as InstallationListParams,
     type InstallationEnsureParams as InstallationEnsureParams,
   };
@@ -171,13 +398,16 @@ export declare namespace V1 {
     type ConnectionListResponse as ConnectionListResponse,
     type ConnectionBrowseResponse as ConnectionBrowseResponse,
     type ConnectionCreateParams as ConnectionCreateParams,
+    type ConnectionRetrieveParams as ConnectionRetrieveParams,
     type ConnectionListParams as ConnectionListParams,
     type ConnectionDeleteParams as ConnectionDeleteParams,
     type ConnectionBrowseParams as ConnectionBrowseParams,
+    type ConnectionUpdateAllParams as ConnectionUpdateAllParams,
   };
 
   export {
     Links as Links,
+    type LinkRetrieveParams as LinkRetrieveParams,
     type LinkUpdateParams as LinkUpdateParams,
     type LinkListParams as LinkListParams,
     type LinkDeleteParams as LinkDeleteParams,

package/src/resources/index.ts

@@ -18,11 +18,13 @@ export {
   type SkillCreateResponse,
   type SkillUpdateResponse,
   type SkillDeleteResponse,
+  type SkillCatalogResponse,
   type SkillExportResponse,
   type SkillReadResponse,
   type SkillResolveResponse,
   type SkillCreateParams,
   type SkillUpdateParams,
+  type SkillCatalogParams,
   type SkillExportParams,
   type SkillResolveParams,
 } from './skills/skills';
@@ -42,6 +44,7 @@ export {
   type VaultUploadResponse,
   type VaultCreateParams,
   type VaultUpdateParams,
+  type VaultListParams,
   type VaultDeleteParams,
   type VaultConfirmUploadParams,
   type VaultIngestParams,

package/src/resources/linc/v1/index.ts

@@ -3,8 +3,10 @@
 export {
   Sessions,
   type SessionCreateParams,
+  type SessionDeleteParams,
   type SessionCancelParams,
   type SessionIngestEventsParams,
+  type SessionReplaceScopeParams,
   type SessionRetrieveEventsParams,
   type SessionRetrieveMessagesParams,
   type SessionSendRpcParams,