casedev 0.68.0 → 0.69.0

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

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as SessionsAPI from './sessions';
+import {
+  SessionCancelParams,
+  SessionCreateParams,
+  SessionIngestEventsParams,
+  SessionRetrieveEventsParams,
+  SessionRetrieveMessagesParams,
+  SessionSendRpcParams,
+  Sessions,
+} from './sessions';
+
+export class V1 extends APIResource {
+  sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
+}
+
+V1.Sessions = Sessions;
+
+export declare namespace V1 {
+  export {
+    Sessions as Sessions,
+    type SessionCreateParams as SessionCreateParams,
+    type SessionCancelParams as SessionCancelParams,
+    type SessionIngestEventsParams as SessionIngestEventsParams,
+    type SessionRetrieveEventsParams as SessionRetrieveEventsParams,
+    type SessionRetrieveMessagesParams as SessionRetrieveMessagesParams,
+    type SessionSendRpcParams as SessionSendRpcParams,
+  };
+}

package/src/resources/{mail.ts → linc.ts}

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './mail/index';
+export * from './linc/index';

package/src/resources/llm/v1/chat.ts

@@ -90,8 +90,9 @@ export interface ChatCreateCompletionParams {
   messages: Array<ChatCreateCompletionParams.Message>;
 
   /**
-   * CaseMark-only: when true, allows reasoning fields in responses. Defaults to
-   * false (reasoning is suppressed).
+   * CaseMark-only: controls whether reasoning fields appear in responses. Defaults
+   * to false (suppressed) for most CaseMark models; defaults to true for
+   * casemark/core-potassium.
    */
   casemark_show_reasoning?: boolean;
 

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

@@ -21,5 +21,4 @@ export {
   type WorkItemUpdateParams,
   type WorkItemListParams,
   type WorkItemDecideParams,
-  type WorkItemListExecutionsParams,
 } from './work-items';

package/src/resources/matters/v1/v1.ts

@@ -17,7 +17,6 @@ import * as WorkItemsAPI from './work-items';
 import {
   WorkItemCreateParams,
   WorkItemDecideParams,
-  WorkItemListExecutionsParams,
   WorkItemListParams,
   WorkItemRetrieveParams,
   WorkItemUpdateParams,
@@ -239,6 +238,5 @@ export declare namespace V1 {
     type WorkItemUpdateParams as WorkItemUpdateParams,
     type WorkItemListParams as WorkItemListParams,
     type WorkItemDecideParams as WorkItemDecideParams,
-    type WorkItemListExecutionsParams as WorkItemListExecutionsParams,
   };
 }

package/src/resources/matters/v1/work-items.ts

@@ -60,8 +60,7 @@ export class WorkItems extends APIResource {
   }
 
   /**
-   * Approve, revise, block, or reassign a work item. Used by humans or agents to
-   * move work items through their lifecycle.
+   * Approve or block a work item.
    */
   decide(workItemID: string, params: WorkItemDecideParams, options?: RequestOptions): APIPromise<void> {
     const { id, ...body } = params;
@@ -71,21 +70,6 @@ export class WorkItems extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
-
-  /**
-   * List execution attempts for a work item, including agent and run linkage.
-   */
-  listExecutions(
-    workItemID: string,
-    params: WorkItemListExecutionsParams,
-    options?: RequestOptions,
-  ): APIPromise<void> {
-    const { id } = params;
-    return this._client.get(path`/matters/v1/${id}/work-items/${workItemID}/executions`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
 }
 
 export interface WorkItemCreateParams {
@@ -220,12 +204,7 @@ export interface WorkItemDecideParams {
   /**
    * Body param
    */
-  decision: 'approve' | 'revise' | 'block' | 'reassign';
-
-  /**
-   * Body param
-   */
-  agent_type_id?: string | null;
+  decision: 'approve' | 'block';
 
   /**
    * Body param
@@ -238,10 +217,6 @@ export interface WorkItemDecideParams {
   reason?: string | null;
 }
 
-export interface WorkItemListExecutionsParams {
-  id: string;
-}
-
 export declare namespace WorkItems {
   export {
     type WorkItemCreateParams as WorkItemCreateParams,
@@ -249,6 +224,5 @@ export declare namespace WorkItems {
     type WorkItemUpdateParams as WorkItemUpdateParams,
     type WorkItemListParams as WorkItemListParams,
     type WorkItemDecideParams as WorkItemDecideParams,
-    type WorkItemListExecutionsParams as WorkItemListExecutionsParams,
   };
 }

package/src/resources/media/v1/clips.ts

@@ -6,6 +6,9 @@ import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
+/**
+ * Transcript retrieval and captioned media clip generation
+ */
 export class Clips extends APIResource {
   /**
    * Create a captioned media clip

package/src/resources/media/v1/transcripts/index.ts

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export { Retrieve, type RetrieveCreateResponse, type RetrieveCreateParams } from './retrieve';
 export { Search } from './search';
 export { Transcripts } from './transcripts';

package/src/resources/media/v1/transcripts/retrieve.ts

@@ -0,0 +1,94 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../core/resource';
+import { APIPromise } from '../../../../core/api-promise';
+import { RequestOptions } from '../../../../internal/request-options';
+
+/**
+ * Transcript retrieval and captioned media clip generation
+ */
+export class Retrieve extends APIResource {
+  /**
+   * Retrieves the full transcript text for a vault transcript object or an
+   * audio/video source object with a completed transcription job. When object_id is
+   * a source media object, access to that source object grants access to its
+   * generated transcript artifact.
+   */
+  create(body: RetrieveCreateParams, options?: RequestOptions): APIPromise<RetrieveCreateResponse> {
+    return this._client.post('/media/v1/transcripts/retrieve', { body, ...options });
+  }
+}
+
+export interface RetrieveCreateResponse {
+  /**
+   * Requested object ID.
+   */
+  object_id: string;
+
+  status: 'completed';
+
+  /**
+   * Full transcript text.
+   */
+  text: string;
+
+  vault_id: string;
+
+  audio_duration?: number;
+
+  confidence?: number;
+
+  filename?: string;
+
+  /**
+   * Source media object ID when known.
+   */
+  source_object_id?: string;
+
+  /**
+   * Transcript object ID when known.
+   */
+  transcript_object_id?: string;
+
+  /**
+   * Transcription job ID when known.
+   */
+  transcription_job_id?: string;
+
+  word_count?: number;
+}
+
+export interface RetrieveCreateParams {
+  /**
+   * Object ID for either the source audio/video file or transcript artifact.
+   */
+  object_id: string;
+
+  /**
+   * Vault ID containing the source media or transcript object.
+   */
+  vault_id: string;
+
+  /**
+   * Alternative nested transcript object reference.
+   */
+  transcript?: RetrieveCreateParams.Transcript;
+}
+
+export namespace RetrieveCreateParams {
+  /**
+   * Alternative nested transcript object reference.
+   */
+  export interface Transcript {
+    object_id?: string;
+
+    vault_id?: string;
+  }
+}
+
+export declare namespace Retrieve {
+  export {
+    type RetrieveCreateResponse as RetrieveCreateResponse,
+    type RetrieveCreateParams as RetrieveCreateParams,
+  };
+}

package/src/resources/media/v1/transcripts/search.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../../../../core/api-promise';
 import { buildHeaders } from '../../../../internal/headers';
 import { RequestOptions } from '../../../../internal/request-options';
 
+/**
+ * Transcript retrieval and captioned media clip generation
+ */
 export class Search extends APIResource {
   /**
    * Search transcript words

package/src/resources/media/v1/transcripts/transcripts.ts

@@ -1,15 +1,25 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../../core/resource';
+import * as RetrieveAPI from './retrieve';
+import { Retrieve, RetrieveCreateParams, RetrieveCreateResponse } from './retrieve';
 import * as SearchAPI from './search';
 import { Search } from './search';
 
 export class Transcripts extends APIResource {
   search: SearchAPI.Search = new SearchAPI.Search(this._client);
+  retrieve: RetrieveAPI.Retrieve = new RetrieveAPI.Retrieve(this._client);
 }
 
 Transcripts.Search = Search;
+Transcripts.Retrieve = Retrieve;
 
 export declare namespace Transcripts {
   export { Search as Search };
+
+  export {
+    Retrieve as Retrieve,
+    type RetrieveCreateResponse as RetrieveCreateResponse,
+    type RetrieveCreateParams as RetrieveCreateParams,
+  };
 }

package/src/resources/ocr/v1.ts

@@ -11,8 +11,8 @@ import { path } from '../../internal/utils/path';
  */
 export class V1 extends APIResource {
   /**
-   * Retrieve the status and results of an OCR job. Returns job progress, extracted
-   * text, and metadata when processing is complete.
+   * Retrieve the status and results of an OCR job. Returns job progress and
+   * metadata; full extracted text is included only when include_text=true.
    *
    * @example
    * ```ts
@@ -103,7 +103,7 @@ export interface V1RetrieveResponse {
   page_count?: number;
 
   /**
-   * Extracted text content (when completed)
+   * Extracted text content when completed and include_text=true
    */
   text?: string;
 }
@@ -147,7 +147,7 @@ export interface V1ProcessResponse {
 
 export interface V1RetrieveParams {
   /**
-   * Include full OCR text in completed responses (default: true)
+   * Include full OCR text in completed responses (default: false)
    */
   include_text?: 'true' | 'false';
 }

package/src/resources/search/index.ts

@@ -5,14 +5,10 @@ export {
   V1,
   type V1AnswerResponse,
   type V1ContentsResponse,
-  type V1ResearchResponse,
-  type V1RetrieveResearchResponse,
   type V1SearchResponse,
   type V1SimilarResponse,
   type V1AnswerParams,
   type V1ContentsParams,
-  type V1ResearchParams,
-  type V1RetrieveResearchParams,
   type V1SearchParams,
   type V1SimilarParams,
 } from './v1';

package/src/resources/search/search.ts

@@ -8,10 +8,6 @@ import {
   V1AnswerResponse,
   V1ContentsParams,
   V1ContentsResponse,
-  V1ResearchParams,
-  V1ResearchResponse,
-  V1RetrieveResearchParams,
-  V1RetrieveResearchResponse,
   V1SearchParams,
   V1SearchResponse,
   V1SimilarParams,
@@ -29,14 +25,10 @@ export declare namespace Search {
     V1 as V1,
     type V1AnswerResponse as V1AnswerResponse,
     type V1ContentsResponse as V1ContentsResponse,
-    type V1ResearchResponse as V1ResearchResponse,
-    type V1RetrieveResearchResponse as V1RetrieveResearchResponse,
     type V1SearchResponse as V1SearchResponse,
     type V1SimilarResponse as V1SimilarResponse,
     type V1AnswerParams as V1AnswerParams,
     type V1ContentsParams as V1ContentsParams,
-    type V1ResearchParams as V1ResearchParams,
-    type V1RetrieveResearchParams as V1RetrieveResearchParams,
     type V1SearchParams as V1SearchParams,
     type V1SimilarParams as V1SimilarParams,
   };

package/src/resources/search/v1.ts

@@ -3,10 +3,9 @@
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
-import { path } from '../../internal/utils/path';
 
 /**
- * Web search, AI answers, and deep research
+ * Web search and AI answers
  */
 export class V1 extends APIResource {
   /**
@@ -28,29 +27,6 @@ export class V1 extends APIResource {
     return this._client.post('/search/v1/contents', { body, ...options });
   }
 
-  /**
-   * Performs deep research by conducting multi-step analysis, gathering information
-   * from multiple sources, and providing comprehensive insights. Ideal for legal
-   * research, case analysis, and due diligence investigations.
-   */
-  research(body: V1ResearchParams, options?: RequestOptions): APIPromise<V1ResearchResponse> {
-    return this._client.post('/search/v1/research', { body, ...options });
-  }
-
-  /**
-   * Retrieve the status and results of a deep research task by ID. Supports both
-   * standard JSON responses and streaming for real-time updates as the research
-   * progresses. Research tasks analyze topics comprehensively using web search and
-   * AI synthesis.
-   */
-  retrieveResearch(
-    id: string,
-    query: V1RetrieveResearchParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<V1RetrieveResearchResponse> {
-    return this._client.get(path`/search/v1/research/${id}`, { query, ...options });
-  }
-
   /**
    * Executes intelligent web search queries with advanced filtering and
    * customization options. Ideal for legal research, case law discovery, and
@@ -144,115 +120,6 @@ export namespace V1ContentsResponse {
   }
 }
 
-export interface V1ResearchResponse {
-  /**
-   * Model used for research
-   */
-  model?: string;
-
-  /**
-   * Unique identifier for this research
-   */
-  researchId?: string;
-
-  /**
-   * Research findings and analysis
-   */
-  results?: unknown;
-}
-
-export interface V1RetrieveResearchResponse {
-  /**
-   * Research task ID
-   */
-  id?: string;
-
-  /**
-   * Task completion timestamp
-   */
-  completedAt?: string;
-
-  /**
-   * Task creation timestamp
-   */
-  createdAt?: string;
-
-  /**
-   * Research model used
-   */
-  model?: 'fast' | 'normal' | 'pro';
-
-  /**
-   * Completion percentage (0-100)
-   */
-  progress?: number;
-
-  /**
-   * Original research query
-   */
-  query?: string;
-
-  /**
-   * Research findings and analysis
-   */
-  results?: V1RetrieveResearchResponse.Results;
-
-  /**
-   * Current status of the research task
-   */
-  status?: 'pending' | 'running' | 'completed' | 'failed';
-}
-
-export namespace V1RetrieveResearchResponse {
-  /**
-   * Research findings and analysis
-   */
-  export interface Results {
-    /**
-     * Detailed research sections
-     */
-    sections?: Array<Results.Section>;
-
-    /**
-     * All sources referenced in research
-     */
-    sources?: Array<Results.Source>;
-
-    /**
-     * Executive summary of research findings
-     */
-    summary?: string;
-  }
-
-  export namespace Results {
-    export interface Section {
-      content?: string;
-
-      sources?: Array<Section.Source>;
-
-      title?: string;
-    }
-
-    export namespace Section {
-      export interface Source {
-        snippet?: string;
-
-        title?: string;
-
-        url?: string;
-      }
-    }
-
-    export interface Source {
-      snippet?: string;
-
-      title?: string;
-
-      url?: string;
-    }
-  }
-}
-
 export interface V1SearchResponse {
   /**
    * Original search query
@@ -434,40 +301,6 @@ export interface V1ContentsParams {
   text?: boolean;
 }
 
-export interface V1ResearchParams {
-  /**
-   * Research instructions or query
-   */
-  instructions: string;
-
-  /**
-   * Research quality level - fast (quick), normal (balanced), pro (comprehensive)
-   */
-  model?: 'fast' | 'normal' | 'pro';
-
-  /**
-   * Optional JSON schema to structure the research output
-   */
-  outputSchema?: unknown;
-
-  /**
-   * Alias for instructions (for convenience)
-   */
-  query?: string;
-}
-
-export interface V1RetrieveResearchParams {
-  /**
-   * Filter specific event types for streaming
-   */
-  events?: string;
-
-  /**
-   * Enable streaming for real-time updates
-   */
-  stream?: boolean;
-}
-
 export interface V1SearchParams {
   /**
    * Primary search query
@@ -596,14 +429,10 @@ export declare namespace V1 {
   export {
     type V1AnswerResponse as V1AnswerResponse,
     type V1ContentsResponse as V1ContentsResponse,
-    type V1ResearchResponse as V1ResearchResponse,
-    type V1RetrieveResearchResponse as V1RetrieveResearchResponse,
     type V1SearchResponse as V1SearchResponse,
     type V1SimilarResponse as V1SimilarResponse,
     type V1AnswerParams as V1AnswerParams,
     type V1ContentsParams as V1ContentsParams,
-    type V1ResearchParams as V1ResearchParams,
-    type V1RetrieveResearchParams as V1RetrieveResearchParams,
     type V1SearchParams as V1SearchParams,
     type V1SimilarParams as V1SimilarParams,
   };

package/src/resources/translate/index.ts

@@ -9,4 +9,5 @@ export {
   type V1DetectParams,
   type V1ListLanguagesParams,
   type V1TranslateParams,
+  type V1TranslateDocumentParams,
 } from './v1';

package/src/resources/translate/translate.ts

@@ -8,6 +8,7 @@ import {
   V1DetectResponse,
   V1ListLanguagesParams,
   V1ListLanguagesResponse,
+  V1TranslateDocumentParams,
   V1TranslateParams,
   V1TranslateResponse,
 } from './v1';
@@ -27,5 +28,6 @@ export declare namespace Translate {
     type V1DetectParams as V1DetectParams,
     type V1ListLanguagesParams as V1ListLanguagesParams,
     type V1TranslateParams as V1TranslateParams,
+    type V1TranslateDocumentParams as V1TranslateDocumentParams,
   };
 }

package/src/resources/translate/v1.ts

@@ -2,8 +2,14 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { type Uploadable } from '../../core/uploads';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
+import { multipartFormRequestOptions } from '../../internal/uploads';
 
+/**
+ * Language detection and translation for multilingual legal workflows
+ */
 export class V1 extends APIResource {
   /**
    * Detect the language of text. Returns the most likely language code and
@@ -52,6 +58,38 @@ export class V1 extends APIResource {
   translate(body: V1TranslateParams, options?: RequestOptions): APIPromise<V1TranslateResponse> {
     return this._client.post('/translate/v1/translate', { body, ...options });
   }
+
+  /**
+   * Translate one TXT, DOCX, or searchable PDF document. DOCX and PDF translations
+   * preserve the source document format and retain as much layout and formatting as
+   * possible.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.translate.v1.translateDocument({
+   *     file: fs.createReadStream('path/to/file'),
+   *     target: 'es',
+   *   });
+   *
+   * const content = await response.blob();
+   * console.log(content);
+   * ```
+   */
+  translateDocument(body: V1TranslateDocumentParams, options?: RequestOptions): APIPromise<Response> {
+    return this._client.post(
+      '/translate/v1/document',
+      multipartFormRequestOptions(
+        {
+          body,
+          ...options,
+          headers: buildHeaders([{ Accept: 'application/octet-stream' }, options?.headers]),
+          __binaryResponse: true,
+        },
+        this._client,
+      ),
+    );
+  }
 }
 
 export interface V1DetectResponse {
@@ -185,6 +223,23 @@ export interface V1TranslateParams {
   source?: string;
 }
 
+export interface V1TranslateDocumentParams {
+  /**
+   * TXT, DOCX, or searchable PDF document (max 20MB)
+   */
+  file: Uploadable;
+
+  /**
+   * Target BCP-47 language code
+   */
+  target: string;
+
+  /**
+   * Optional source BCP-47 language code. Auto-detected when omitted.
+   */
+  source?: string;
+}
+
 export declare namespace V1 {
   export {
     type V1DetectResponse as V1DetectResponse,
@@ -193,5 +248,6 @@ export declare namespace V1 {
     type V1DetectParams as V1DetectParams,
     type V1ListLanguagesParams as V1ListLanguagesParams,
     type V1TranslateParams as V1TranslateParams,
+    type V1TranslateDocumentParams as V1TranslateDocumentParams,
   };
 }

package/src/resources/usage/v1/v1.ts

@@ -39,6 +39,18 @@ export interface V1RetrieveParams {
    */
   granularity?: 'summary' | 'daily';
 
+  /**
+   * Optionally include usage groups keyed by native Linc session id. Only
+   * Linc-session-attributable usage is grouped.
+   */
+  groupBy?: 'lincSessionId';
+
+  /**
+   * Restrict usage to a native Linc session. The session must belong to the
+   * authenticated organization.
+   */
+  lincSessionId?: string;
+
   /**
    * Period end date. Defaults to now.
    */