casedev 0.23.0 → 0.25.0

package/src/resources/legal/v1.ts

@@ -10,7 +10,7 @@ import { RequestOptions } from '../../internal/request-options';
 export class V1 extends APIResource {
   /**
    * Search federal court dockets or retrieve a specific docket with optional filing
-   * entries via CourtListener RECAP data.
+   * entries. Use legal.listCourts() to resolve court slugs for filtering.
    */
   docket(body: V1DocketParams, options?: RequestOptions): APIPromise<V1DocketResponse> {
     return this._client.post('/legal/v1/docket', { body, ...options });
@@ -65,8 +65,8 @@ export class V1 extends APIResource {
   }
 
   /**
-   * Returns CourtListener court IDs and names for docket filtering. Use these IDs in
-   * legal.docket() as the court parameter.
+   * Returns court IDs (slugs) and names for use with the docket search endpoint. Use
+   * the returned court ID as the `court` parameter in legal.docket().
    */
   listCourts(
     body: V1ListCourtsParams | null | undefined = {},
@@ -234,6 +234,16 @@ export interface V1DocketResponse {
    */
   includeEntries?: boolean;
 
+  /**
+   * Whether this was a live PACER fetch (lookup mode only)
+   */
+  live?: boolean;
+
+  /**
+   * PACER fee information (present when live: true)
+   */
+  pacerFees?: V1DocketResponse.PacerFees | null;
+
   /**
    * Pagination info for entry list (lookup mode with includeEntries)
    */
@@ -276,6 +286,28 @@ export namespace V1DocketResponse {
     }
   }
 
+  /**
+   * PACER fee information (present when live: true)
+   */
+  export interface PacerFees {
+    currency?: 'USD';
+
+    /**
+     * Time taken for PACER fetch in milliseconds
+     */
+    fetchDurationMs?: number;
+
+    /**
+     * Maximum PACER charge per docket in USD
+     */
+    maxPacerCost?: number;
+
+    /**
+     * CaseMark service fee in USD
+     */
+    serviceFee?: number;
+  }
+
   /**
    * Pagination info for entry list (lookup mode with includeEntries)
    */
@@ -582,7 +614,7 @@ export interface V1ListCourtsResponse {
 export namespace V1ListCourtsResponse {
   export interface Court {
     /**
-     * CourtListener court slug
+     * Court slug (use as the court parameter in legal.docket())
      */
     id?: string;
 
@@ -1044,7 +1076,14 @@ export interface V1DocketParams {
   type: 'search' | 'lookup';
 
   /**
-   * Optional CourtListener court slug (e.g. "nysd", "ca9", "cafc")
+   * Required when live: true. Acknowledges that PACER fees (up to $3.00 per docket)
+   * plus a $0.05 service fee will be charged to your account.
+   */
+  acknowledgePacerFees?: boolean;
+
+  /**
+   * Optional court slug for filtering (e.g. "nysd", "ca9", "cafc"). Use
+   * legal.listCourts() to find slugs.
    */
   court?: string;
 
@@ -1059,12 +1098,13 @@ export interface V1DocketParams {
   dateFiledBefore?: string;
 
   /**
-   * CourtListener docket ID (required for lookup)
+   * Docket ID (required for lookup)
    */
   docketId?: string;
 
   /**
-   * Include docket entries/filings in lookup responses
+   * Include docket entries/filings in lookup responses. Coming soon — currently
+   * returns 501. The parameter is accepted for forward compatibility.
    */
   includeEntries?: boolean;
 
@@ -1075,8 +1115,9 @@ export interface V1DocketParams {
   limit?: number;
 
   /**
-   * Reserved for future PACER live fetch support. Setting true currently
-   * returns 400.
+   * Trigger a live PACER fetch for dockets not yet in the RECAP archive. Requires
+   * acknowledgePacerFees: true. PACER charges up to $3.00 per docket sheet plus a
+   * $0.05 service fee. Only valid with type: "lookup".
    */
   live?: boolean;
 
@@ -1156,6 +1197,9 @@ export namespace V1DraftParams {
      */
     target?: number;
 
+    /**
+     * Whether the target length is measured in words or pages
+     */
     unit?: 'words' | 'pages';
   }
 }
@@ -1217,17 +1261,24 @@ export interface V1GetFullTextParams {
 
 export interface V1ListCourtsParams {
   /**
-   * Only return courts currently in use by CourtListener
+   * Only return courts with available docket data
    */
   inUseOnly?: boolean;
 
   /**
-   * Optional CourtListener jurisdiction code filter (e.g. FD, F, S)
+   * Optional jurisdiction code filter (e.g. FD for Federal District, F for all
+   * Federal, S for State)
    */
   jurisdiction?: string;
 
+  /**
+   * Maximum number of courts to return
+   */
   limit?: number;
 
+  /**
+   * Number of courts to skip before returning results
+   */
   offset?: number;
 
   /**

package/src/resources/vault/events/subscriptions.ts

@@ -115,12 +115,25 @@ export class Subscriptions extends APIResource {
 }
 
 export interface SubscriptionCreateParams {
+  /**
+   * Webhook endpoint URL that will receive vault event deliveries
+   */
   callbackUrl: string;
 
+  /**
+   * Vault event types to deliver. Omit to receive the default supported set.
+   */
   eventTypes?: Array<string>;
 
+  /**
+   * Vault object IDs to limit notifications to. Omit to receive events for all
+   * objects in the vault.
+   */
   objectIds?: Array<string>;
 
+  /**
+   * Optional secret used to sign outbound webhook deliveries
+   */
   signingSecret?: string;
 }
 
@@ -131,32 +144,33 @@ export interface SubscriptionUpdateParams {
   id: string;
 
   /**
-   * Body param
+   * Body param: Updated webhook endpoint URL for deliveries
    */
   callbackUrl?: string;
 
   /**
-   * Body param
+   * Body param: Whether to remove the existing signing secret
    */
   clearSigningSecret?: boolean;
 
   /**
-   * Body param
+   * Body param: Updated event types to deliver for this subscription
    */
   eventTypes?: Array<string>;
 
   /**
-   * Body param
+   * Body param: Whether the subscription should continue delivering events
    */
   isActive?: boolean;
 
   /**
-   * Body param
+   * Body param: Updated vault object IDs to limit notifications to. Pass an empty
+   * array to remove the filter.
    */
   objectIds?: Array<string>;
 
   /**
-   * Body param
+   * Body param: Replacement secret used to sign webhook deliveries
    */
   signingSecret?: string;
 }

package/src/resources/vault/groups.ts

@@ -11,37 +11,42 @@ import { path } from '../../internal/utils/path';
  */
 export class Groups extends APIResource {
   /**
-   * Create vault group
+   * Creates a vault group for organizing vaults and applying group-scoped access
+   * controls. Group-scoped API keys cannot create or manage vault groups.
    *
    * @example
    * ```ts
-   * await client.vault.groups.create();
+   * await client.vault.groups.create({ name: 'name' });
    * ```
    */
-  create(options?: RequestOptions): APIPromise<void> {
+  create(body: GroupCreateParams, options?: RequestOptions): APIPromise<void> {
     return this._client.post('/vault/groups', {
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
   /**
-   * Update vault group
+   * Updates a vault group for the authenticated organization. Only provided fields
+   * are changed, and setting description to null removes the current description.
    *
    * @example
    * ```ts
    * await client.vault.groups.update('groupId');
    * ```
    */
-  update(groupID: string, options?: RequestOptions): APIPromise<void> {
+  update(groupID: string, body: GroupUpdateParams, options?: RequestOptions): APIPromise<void> {
     return this._client.patch(path`/vault/groups/${groupID}`, {
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
   /**
-   * List vault groups
+   * Lists vault groups visible to the authenticated organization. Group-scoped API
+   * keys only receive groups within their allowed scope.
    *
    * @example
    * ```ts
@@ -56,7 +61,8 @@ export class Groups extends APIResource {
   }
 
   /**
-   * Delete vault group
+   * Soft-deletes a vault group that no longer has any active vaults assigned. This
+   * operation is blocked when the group still contains vaults.
    *
    * @example
    * ```ts
@@ -70,3 +76,31 @@ export class Groups extends APIResource {
     });
   }
 }
+
+export interface GroupCreateParams {
+  /**
+   * Human-readable name for the vault group
+   */
+  name: string;
+
+  /**
+   * Optional description of the vault group purpose
+   */
+  description?: string;
+}
+
+export interface GroupUpdateParams {
+  /**
+   * Updated vault group description. Pass null to remove the current description.
+   */
+  description?: string | null;
+
+  /**
+   * New human-readable name for the vault group
+   */
+  name?: string;
+}
+
+export declare namespace Groups {
+  export { type GroupCreateParams as GroupCreateParams, type GroupUpdateParams as GroupUpdateParams };
+}

package/src/resources/vault/index.ts

@@ -8,7 +8,7 @@ export {
   type GraphragProcessObjectResponse,
   type GraphragProcessObjectParams,
 } from './graphrag';
-export { Groups } from './groups';
+export { Groups, type GroupCreateParams, type GroupUpdateParams } from './groups';
 export {
   Multipart,
   type MultipartGetPartURLsResponse,

package/src/resources/vault/multipart.ts

@@ -66,21 +66,39 @@ export namespace MultipartGetPartURLsResponse {
 }
 
 export interface MultipartAbortParams {
+  /**
+   * Vault object ID associated with the multipart upload
+   */
   objectId: string;
 
+  /**
+   * Multipart upload ID returned when the upload was initialized
+   */
   uploadId: string;
 }
 
 export interface MultipartGetPartURLsParams {
+  /**
+   * Vault object ID associated with the multipart upload
+   */
   objectId: string;
 
+  /**
+   * Multipart parts that need presigned upload URLs
+   */
   parts: Array<MultipartGetPartURLsParams.Part>;
 
+  /**
+   * Multipart upload ID returned when the upload was initialized
+   */
   uploadId: string;
 }
 
 export namespace MultipartGetPartURLsParams {
   export interface Part {
+    /**
+     * 1-based multipart part number
+     */
     partNumber: number;
 
     /**

package/src/resources/vault/vault.ts

@@ -10,7 +10,7 @@ import {
   GraphragProcessObjectResponse,
 } from './graphrag';
 import * as GroupsAPI from './groups';
-import { Groups } from './groups';
+import { GroupCreateParams, GroupUpdateParams, Groups } from './groups';
 import * as MultipartAPI from './multipart';
 import {
   Multipart,
@@ -963,7 +963,11 @@ export declare namespace Vault {
     type GraphragProcessObjectParams as GraphragProcessObjectParams,
   };
 
-  export { Groups as Groups };
+  export {
+    Groups as Groups,
+    type GroupCreateParams as GroupCreateParams,
+    type GroupUpdateParams as GroupUpdateParams,
+  };
 
   export {
     Multipart as Multipart,

package/src/resources/voice/boost-list.ts

@@ -0,0 +1,119 @@
+// 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';
+
+/**
+ * Audio transcription and text-to-speech
+ */
+export class BoostList extends APIResource {
+  /**
+   * Extracts a categorized word boost list from vault documents or raw text using
+   * LLM entity extraction. The resulting list can be passed as `word_boost` to the
+   * transcription endpoint for improved accuracy.
+   *
+   * @example
+   * ```ts
+   * const response = await client.voice.boostList.extract();
+   * ```
+   */
+  extract(body: BoostListExtractParams, options?: RequestOptions): APIPromise<BoostListExtractResponse> {
+    return this._client.post('/voice/boost-list/extract', { body, ...options });
+  }
+
+  /**
+   * Generates a categorized word boost list from a completed transcription job.
+   * Extracts entities from the pass-1 transcript for use as `word_boost` in a second
+   * transcription pass.
+   *
+   * @example
+   * ```ts
+   * const response = await client.voice.boostList.generate({
+   *   transcription_job_id: 'transcription_job_id',
+   * });
+   * ```
+   */
+  generate(body: BoostListGenerateParams, options?: RequestOptions): APIPromise<BoostListGenerateResponse> {
+    return this._client.post('/voice/boost-list/generate', { body, ...options });
+  }
+}
+
+export interface BoostListExtractResponse {
+  items?: Array<BoostListExtractResponse.Item>;
+
+  source?: 'document' | 'text';
+
+  source_ids?: Array<string>;
+}
+
+export namespace BoostListExtractResponse {
+  export interface Item {
+    boost_param?: 'low' | 'default' | 'high';
+
+    category?: string;
+
+    word?: string;
+  }
+}
+
+export interface BoostListGenerateResponse {
+  items?: Array<BoostListGenerateResponse.Item>;
+
+  source?: 'transcript';
+
+  source_ids?: Array<string>;
+}
+
+export namespace BoostListGenerateResponse {
+  export interface Item {
+    boost_param?: 'low' | 'default' | 'high';
+
+    category?: string;
+
+    word?: string;
+  }
+}
+
+export interface BoostListExtractParams {
+  /**
+   * Optional filter for entity categories to extract
+   */
+  categories?: Array<'person' | 'organization' | 'legal_term' | 'medical' | 'citation' | 'email'>;
+
+  /**
+   * Object IDs of documents to extract entities from (PDFs, text files)
+   */
+  object_ids?: Array<string>;
+
+  /**
+   * Raw text input for entity extraction (alternative to vault documents)
+   */
+  text?: string;
+
+  /**
+   * Vault ID containing the source documents (use with object_ids)
+   */
+  vault_id?: string;
+}
+
+export interface BoostListGenerateParams {
+  /**
+   * Completed pass-1 transcription job ID (tr\_...)
+   */
+  transcription_job_id: string;
+
+  /**
+   * Optional filter for entity categories to extract
+   */
+  categories?: Array<'person' | 'organization' | 'legal_term' | 'medical' | 'citation' | 'email'>;
+}
+
+export declare namespace BoostList {
+  export {
+    type BoostListExtractResponse as BoostListExtractResponse,
+    type BoostListGenerateResponse as BoostListGenerateResponse,
+    type BoostListExtractParams as BoostListExtractParams,
+    type BoostListGenerateParams as BoostListGenerateParams,
+  };
+}

package/src/resources/voice/index.ts

@@ -1,5 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  BoostList,
+  type BoostListExtractResponse,
+  type BoostListGenerateResponse,
+  type BoostListExtractParams,
+  type BoostListGenerateParams,
+} from './boost-list';
 export { Streaming, type StreamingGetURLResponse } from './streaming';
 export {
   Transcription,

package/src/resources/voice/voice.ts

@@ -1,6 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as BoostListAPI from './boost-list';
+import {
+  BoostList,
+  BoostListExtractParams,
+  BoostListExtractResponse,
+  BoostListGenerateParams,
+  BoostListGenerateResponse,
+} from './boost-list';
 import * as StreamingAPI from './streaming';
 import { Streaming, StreamingGetURLResponse } from './streaming';
 import * as TranscriptionAPI from './transcription';
@@ -15,17 +23,27 @@ import { V1, V1ListVoicesParams, V1ListVoicesResponse } from './v1/v1';
 
 export class Voice extends APIResource {
   streaming: StreamingAPI.Streaming = new StreamingAPI.Streaming(this._client);
+  boostList: BoostListAPI.BoostList = new BoostListAPI.BoostList(this._client);
   transcription: TranscriptionAPI.Transcription = new TranscriptionAPI.Transcription(this._client);
   v1: V1API.V1 = new V1API.V1(this._client);
 }
 
 Voice.Streaming = Streaming;
+Voice.BoostList = BoostList;
 Voice.Transcription = Transcription;
 Voice.V1 = V1;
 
 export declare namespace Voice {
   export { Streaming as Streaming, type StreamingGetURLResponse as StreamingGetURLResponse };
 
+  export {
+    BoostList as BoostList,
+    type BoostListExtractResponse as BoostListExtractResponse,
+    type BoostListGenerateResponse as BoostListGenerateResponse,
+    type BoostListExtractParams as BoostListExtractParams,
+    type BoostListGenerateParams as BoostListGenerateParams,
+  };
+
   export {
     Transcription as Transcription,
     type TranscriptionCreateResponse as TranscriptionCreateResponse,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.23.0'; // x-release-please-version
+export const VERSION = '0.25.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.23.0";
+export declare const VERSION = "0.25.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.23.0";
+export declare const VERSION = "0.25.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.23.0'; // x-release-please-version
+exports.VERSION = '0.25.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.23.0'; // x-release-please-version
+export const VERSION = '0.25.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map