casedev 0.23.0 → 0.24.0

package/resources/voice/boost-list.d.mts

@@ -0,0 +1,88 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Audio transcription and text-to-speech
+ */
+export declare 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>;
+    /**
+     * 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>;
+}
+export interface BoostListExtractResponse {
+    items?: Array<BoostListExtractResponse.Item>;
+    source?: 'document' | 'text';
+    source_ids?: Array<string>;
+}
+export declare namespace BoostListExtractResponse {
+    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 declare namespace BoostListGenerateResponse {
+    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, };
+}
+//# sourceMappingURL=boost-list.d.mts.map

package/resources/voice/boost-list.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boost-list.d.mts","sourceRoot":"","sources":["../../src/resources/voice/boost-list.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,wBAAwB,CAAC;IAIrG;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,yBAAyB,CAAC;CAGzG;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAE7B,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,yBAAiB,wBAAwB,CAAC;IACxC,UAAiB,IAAI;QACnB,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;QAEzC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAE9C,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,yBAAiB,yBAAyB,CAAC;IACzC,UAAiB,IAAI;QACnB,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;QAEzC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC;IAEhG;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC;CACjG;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

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

@@ -0,0 +1,88 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Audio transcription and text-to-speech
+ */
+export declare 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>;
+    /**
+     * 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>;
+}
+export interface BoostListExtractResponse {
+    items?: Array<BoostListExtractResponse.Item>;
+    source?: 'document' | 'text';
+    source_ids?: Array<string>;
+}
+export declare namespace BoostListExtractResponse {
+    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 declare namespace BoostListGenerateResponse {
+    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, };
+}
+//# sourceMappingURL=boost-list.d.ts.map

package/resources/voice/boost-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boost-list.d.ts","sourceRoot":"","sources":["../../src/resources/voice/boost-list.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,wBAAwB,CAAC;IAIrG;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,yBAAyB,CAAC;CAGzG;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAE7B,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,yBAAiB,wBAAwB,CAAC;IACxC,UAAiB,IAAI;QACnB,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;QAEzC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAE9C,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,yBAAiB,yBAAyB,CAAC;IACzC,UAAiB,IAAI;QACnB,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;QAEzC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC;IAEhG;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC;CACjG;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

package/resources/voice/boost-list.js

@@ -0,0 +1,40 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoostList = void 0;
+const resource_1 = require("../../core/resource.js");
+/**
+ * Audio transcription and text-to-speech
+ */
+class BoostList extends resource_1.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, options) {
+        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, options) {
+        return this._client.post('/voice/boost-list/generate', { body, ...options });
+    }
+}
+exports.BoostList = BoostList;
+//# sourceMappingURL=boost-list.js.map

package/resources/voice/boost-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boost-list.js","sourceRoot":"","sources":["../../src/resources/voice/boost-list.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD;;GAEG;AACH,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;;;;;;;OASG;IACH,OAAO,CAAC,IAA4B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAA6B,EAAE,OAAwB;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AA9BD,8BA8BC"}

package/resources/voice/boost-list.mjs

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+/**
+ * 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, options) {
+        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, options) {
+        return this._client.post('/voice/boost-list/generate', { body, ...options });
+    }
+}
+//# sourceMappingURL=boost-list.mjs.map

package/resources/voice/boost-list.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"boost-list.mjs","sourceRoot":"","sources":["../../src/resources/voice/boost-list.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;OASG;IACH,OAAO,CAAC,IAA4B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAA6B,EAAE,OAAwB;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/resources/voice/index.d.mts

@@ -1,3 +1,4 @@
+export { BoostList, type BoostListExtractResponse, type BoostListGenerateResponse, type BoostListExtractParams, type BoostListGenerateParams, } from "./boost-list.mjs";
 export { Streaming, type StreamingGetURLResponse } from "./streaming.mjs";
 export { Transcription, type TranscriptionCreateResponse, type TranscriptionRetrieveResponse, type TranscriptionCreateParams, } from "./transcription.mjs";
 export { V1, type V1ListVoicesResponse, type V1ListVoicesParams } from "./v1/index.mjs";

package/resources/voice/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/voice/index.ts"],"names":[],"mappings":"OAEO,EAAE,SAAS,EAAE,KAAK,uBAAuB,EAAE;OAC3C,EACL,aAAa,EACb,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,GAC/B;OACM,EAAE,EAAE,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE;OAC1D,EAAE,KAAK,EAAE"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/voice/index.ts"],"names":[],"mappings":"OAEO,EACL,SAAS,EACT,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B;OACM,EAAE,SAAS,EAAE,KAAK,uBAAuB,EAAE;OAC3C,EACL,aAAa,EACb,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,GAC/B;OACM,EAAE,EAAE,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE;OAC1D,EAAE,KAAK,EAAE"}

package/resources/voice/index.d.ts

@@ -1,3 +1,4 @@
+export { BoostList, type BoostListExtractResponse, type BoostListGenerateResponse, type BoostListExtractParams, type BoostListGenerateParams, } from "./boost-list.js";
 export { Streaming, type StreamingGetURLResponse } from "./streaming.js";
 export { Transcription, type TranscriptionCreateResponse, type TranscriptionRetrieveResponse, type TranscriptionCreateParams, } from "./transcription.js";
 export { V1, type V1ListVoicesResponse, type V1ListVoicesParams } from "./v1/index.js";

package/resources/voice/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/voice/index.ts"],"names":[],"mappings":"OAEO,EAAE,SAAS,EAAE,KAAK,uBAAuB,EAAE;OAC3C,EACL,aAAa,EACb,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,GAC/B;OACM,EAAE,EAAE,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE;OAC1D,EAAE,KAAK,EAAE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/voice/index.ts"],"names":[],"mappings":"OAEO,EACL,SAAS,EACT,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B;OACM,EAAE,SAAS,EAAE,KAAK,uBAAuB,EAAE;OAC3C,EACL,aAAa,EACb,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,GAC/B;OACM,EAAE,EAAE,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE;OAC1D,EAAE,KAAK,EAAE"}

package/resources/voice/index.js

@@ -1,7 +1,9 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Voice = exports.V1 = exports.Transcription = exports.Streaming = void 0;
+exports.Voice = exports.V1 = exports.Transcription = exports.Streaming = exports.BoostList = void 0;
+var boost_list_1 = require("./boost-list.js");
+Object.defineProperty(exports, "BoostList", { enumerable: true, get: function () { return boost_list_1.BoostList; } });
 var streaming_1 = require("./streaming.js");
 Object.defineProperty(exports, "Streaming", { enumerable: true, get: function () { return streaming_1.Streaming; } });
 var transcription_1 = require("./transcription.js");

package/resources/voice/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/voice/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,4CAAsE;AAA7D,sGAAA,SAAS,OAAA;AAClB,oDAKyB;AAJvB,8GAAA,aAAa,OAAA;AAKf,uCAAoF;AAA3E,2FAAA,EAAE,OAAA;AACX,oCAAgC;AAAvB,8FAAA,KAAK,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/voice/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8CAMsB;AALpB,uGAAA,SAAS,OAAA;AAMX,4CAAsE;AAA7D,sGAAA,SAAS,OAAA;AAClB,oDAKyB;AAJvB,8GAAA,aAAa,OAAA;AAKf,uCAAoF;AAA3E,2FAAA,EAAE,OAAA;AACX,oCAAgC;AAAvB,8FAAA,KAAK,OAAA"}

package/resources/voice/index.mjs

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { BoostList, } from "./boost-list.mjs";
 export { Streaming } from "./streaming.mjs";
 export { Transcription, } from "./transcription.mjs";
 export { V1 } from "./v1/index.mjs";

package/resources/voice/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/voice/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,SAAS,EAAgC;OAC3C,EACL,aAAa,GAId;OACM,EAAE,EAAE,EAAsD;OAC1D,EAAE,KAAK,EAAE"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/voice/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,SAAS,GAKV;OACM,EAAE,SAAS,EAAgC;OAC3C,EACL,aAAa,GAId;OACM,EAAE,EAAE,EAAsD;OAC1D,EAAE,KAAK,EAAE"}

package/resources/voice/voice.d.mts

@@ -1,4 +1,6 @@
 import { APIResource } from "../../core/resource.mjs";
+import * as BoostListAPI from "./boost-list.mjs";
+import { BoostList, BoostListExtractParams, BoostListExtractResponse, BoostListGenerateParams, BoostListGenerateResponse } from "./boost-list.mjs";
 import * as StreamingAPI from "./streaming.mjs";
 import { Streaming, StreamingGetURLResponse } from "./streaming.mjs";
 import * as TranscriptionAPI from "./transcription.mjs";
@@ -7,11 +9,13 @@ import * as V1API from "./v1/v1.mjs";
 import { V1, V1ListVoicesParams, V1ListVoicesResponse } from "./v1/v1.mjs";
 export declare class Voice extends APIResource {
     streaming: StreamingAPI.Streaming;
+    boostList: BoostListAPI.BoostList;
     transcription: TranscriptionAPI.Transcription;
     v1: V1API.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, type TranscriptionRetrieveResponse as TranscriptionRetrieveResponse, type TranscriptionCreateParams as TranscriptionCreateParams, };
     export { V1 as V1, type V1ListVoicesResponse as V1ListVoicesResponse, type V1ListVoicesParams as V1ListVoicesParams, };
 }

package/resources/voice/voice.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"voice.d.mts","sourceRoot":"","sources":["../../src/resources/voice/voice.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EAAE,SAAS,EAAE,uBAAuB,EAAE;OACtC,KAAK,gBAAgB;OACrB,EACL,aAAa,EACb,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC9B;OACM,KAAK,KAAK;OACV,EAAE,EAAE,EAAE,kBAAkB,EAAE,oBAAoB,EAAE;AAEvD,qBAAa,KAAM,SAAQ,WAAW;IACpC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;IACjG,EAAE,EAAE,KAAK,CAAC,EAAE,CAA8B;CAC3C;AAMD,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,KAAK,uBAAuB,IAAI,uBAAuB,EAAE,CAAC;IAE3F,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;IAEF,OAAO,EACL,EAAE,IAAI,EAAE,EACR,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}
+{"version":3,"file":"voice.d.mts","sourceRoot":"","sources":["../../src/resources/voice/voice.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EACL,SAAS,EACT,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EAC1B;OACM,KAAK,YAAY;OACjB,EAAE,SAAS,EAAE,uBAAuB,EAAE;OACtC,KAAK,gBAAgB;OACrB,EACL,aAAa,EACb,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC9B;OACM,KAAK,KAAK;OACV,EAAE,EAAE,EAAE,kBAAkB,EAAE,oBAAoB,EAAE;AAEvD,qBAAa,KAAM,SAAQ,WAAW;IACpC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;IACjG,EAAE,EAAE,KAAK,CAAC,EAAE,CAA8B;CAC3C;AAOD,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,KAAK,uBAAuB,IAAI,uBAAuB,EAAE,CAAC;IAE3F,OAAO,EACL,SAAS,IAAI,SAAS,EACtB,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;IAEF,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;IAEF,OAAO,EACL,EAAE,IAAI,EAAE,EACR,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/voice/voice.d.ts

@@ -1,4 +1,6 @@
 import { APIResource } from "../../core/resource.js";
+import * as BoostListAPI from "./boost-list.js";
+import { BoostList, BoostListExtractParams, BoostListExtractResponse, BoostListGenerateParams, BoostListGenerateResponse } from "./boost-list.js";
 import * as StreamingAPI from "./streaming.js";
 import { Streaming, StreamingGetURLResponse } from "./streaming.js";
 import * as TranscriptionAPI from "./transcription.js";
@@ -7,11 +9,13 @@ import * as V1API from "./v1/v1.js";
 import { V1, V1ListVoicesParams, V1ListVoicesResponse } from "./v1/v1.js";
 export declare class Voice extends APIResource {
     streaming: StreamingAPI.Streaming;
+    boostList: BoostListAPI.BoostList;
     transcription: TranscriptionAPI.Transcription;
     v1: V1API.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, type TranscriptionRetrieveResponse as TranscriptionRetrieveResponse, type TranscriptionCreateParams as TranscriptionCreateParams, };
     export { V1 as V1, type V1ListVoicesResponse as V1ListVoicesResponse, type V1ListVoicesParams as V1ListVoicesParams, };
 }

package/resources/voice/voice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/resources/voice/voice.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EAAE,SAAS,EAAE,uBAAuB,EAAE;OACtC,KAAK,gBAAgB;OACrB,EACL,aAAa,EACb,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC9B;OACM,KAAK,KAAK;OACV,EAAE,EAAE,EAAE,kBAAkB,EAAE,oBAAoB,EAAE;AAEvD,qBAAa,KAAM,SAAQ,WAAW;IACpC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;IACjG,EAAE,EAAE,KAAK,CAAC,EAAE,CAA8B;CAC3C;AAMD,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,KAAK,uBAAuB,IAAI,uBAAuB,EAAE,CAAC;IAE3F,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;IAEF,OAAO,EACL,EAAE,IAAI,EAAE,EACR,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/resources/voice/voice.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EACL,SAAS,EACT,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EAC1B;OACM,KAAK,YAAY;OACjB,EAAE,SAAS,EAAE,uBAAuB,EAAE;OACtC,KAAK,gBAAgB;OACrB,EACL,aAAa,EACb,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC9B;OACM,KAAK,KAAK;OACV,EAAE,EAAE,EAAE,kBAAkB,EAAE,oBAAoB,EAAE;AAEvD,qBAAa,KAAM,SAAQ,WAAW;IACpC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;IACjG,EAAE,EAAE,KAAK,CAAC,EAAE,CAA8B;CAC3C;AAOD,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,KAAK,uBAAuB,IAAI,uBAAuB,EAAE,CAAC;IAE3F,OAAO,EACL,SAAS,IAAI,SAAS,EACtB,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;IAEF,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,yBAAyB,IAAI,yBAAyB,GAC5D,CAAC;IAEF,OAAO,EACL,EAAE,IAAI,EAAE,EACR,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/voice/voice.js

@@ -4,6 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Voice = void 0;
 const tslib_1 = require("../../internal/tslib.js");
 const resource_1 = require("../../core/resource.js");
+const BoostListAPI = tslib_1.__importStar(require("./boost-list.js"));
+const boost_list_1 = require("./boost-list.js");
 const StreamingAPI = tslib_1.__importStar(require("./streaming.js"));
 const streaming_1 = require("./streaming.js");
 const TranscriptionAPI = tslib_1.__importStar(require("./transcription.js"));
@@ -14,12 +16,14 @@ class Voice extends resource_1.APIResource {
     constructor() {
         super(...arguments);
         this.streaming = new StreamingAPI.Streaming(this._client);
+        this.boostList = new BoostListAPI.BoostList(this._client);
         this.transcription = new TranscriptionAPI.Transcription(this._client);
         this.v1 = new V1API.V1(this._client);
     }
 }
 exports.Voice = Voice;
 Voice.Streaming = streaming_1.Streaming;
+Voice.BoostList = boost_list_1.BoostList;
 Voice.Transcription = transcription_1.Transcription;
 Voice.V1 = v1_1.V1;
 //# sourceMappingURL=voice.js.map

package/resources/voice/voice.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/resources/voice/voice.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,qEAA4C;AAC5C,8CAAiE;AACjE,6EAAoD;AACpD,sDAKyB;AACzB,0DAAiC;AACjC,mCAAuE;AAEvE,MAAa,KAAM,SAAQ,sBAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,OAAE,GAAa,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;CAAA;AAJD,sBAIC;AAED,KAAK,CAAC,SAAS,GAAG,qBAAS,CAAC;AAC5B,KAAK,CAAC,aAAa,GAAG,6BAAa,CAAC;AACpC,KAAK,CAAC,EAAE,GAAG,OAAE,CAAC"}
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/resources/voice/voice.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,sEAA6C;AAC7C,gDAMsB;AACtB,qEAA4C;AAC5C,8CAAiE;AACjE,6EAAoD;AACpD,sDAKyB;AACzB,0DAAiC;AACjC,mCAAuE;AAEvE,MAAa,KAAM,SAAQ,sBAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,OAAE,GAAa,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;CAAA;AALD,sBAKC;AAED,KAAK,CAAC,SAAS,GAAG,qBAAS,CAAC;AAC5B,KAAK,CAAC,SAAS,GAAG,sBAAS,CAAC;AAC5B,KAAK,CAAC,aAAa,GAAG,6BAAa,CAAC;AACpC,KAAK,CAAC,EAAE,GAAG,OAAE,CAAC"}

package/resources/voice/voice.mjs

@@ -1,5 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../core/resource.mjs";
+import * as BoostListAPI from "./boost-list.mjs";
+import { BoostList, } from "./boost-list.mjs";
 import * as StreamingAPI from "./streaming.mjs";
 import { Streaming } from "./streaming.mjs";
 import * as TranscriptionAPI from "./transcription.mjs";
@@ -10,11 +12,13 @@ export class Voice extends APIResource {
     constructor() {
         super(...arguments);
         this.streaming = new StreamingAPI.Streaming(this._client);
+        this.boostList = new BoostListAPI.BoostList(this._client);
         this.transcription = new TranscriptionAPI.Transcription(this._client);
         this.v1 = new V1API.V1(this._client);
     }
 }
 Voice.Streaming = Streaming;
+Voice.BoostList = BoostList;
 Voice.Transcription = Transcription;
 Voice.V1 = V1;
 //# sourceMappingURL=voice.mjs.map

package/resources/voice/voice.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"voice.mjs","sourceRoot":"","sources":["../../src/resources/voice/voice.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EAAE,SAAS,EAA2B;OACtC,KAAK,gBAAgB;OACrB,EACL,aAAa,GAId;OACM,KAAK,KAAK;OACV,EAAE,EAAE,EAA4C;AAEvD,MAAM,OAAO,KAAM,SAAQ,WAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,OAAE,GAAa,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;CAAA;AAED,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAC5B,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;AACpC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC"}
+{"version":3,"file":"voice.mjs","sourceRoot":"","sources":["../../src/resources/voice/voice.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EACL,SAAS,GAKV;OACM,KAAK,YAAY;OACjB,EAAE,SAAS,EAA2B;OACtC,KAAK,gBAAgB;OACrB,EACL,aAAa,GAId;OACM,KAAK,KAAK;OACV,EAAE,EAAE,EAA4C;AAEvD,MAAM,OAAO,KAAM,SAAQ,WAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,OAAE,GAAa,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;CAAA;AAED,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAC5B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAC5B,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;AACpC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC"}

package/src/resources/agent/v1/agents.ts

@@ -230,7 +230,10 @@ export namespace AgentCreateParams {
 }
 
 export interface AgentUpdateParams {
-  description?: string;
+  /**
+   * Updated agent description. Pass null to clear if supported by the client.
+   */
+  description?: string | null;
 
   /**
    * Denylist of tools the agent cannot use. Mutually exclusive with enabledTools —
@@ -244,16 +247,34 @@ export interface AgentUpdateParams {
    */
   enabledTools?: Array<string> | null;
 
+  /**
+   * Updated system instructions that guide agent behavior
+   */
   instructions?: string;
 
+  /**
+   * Model identifier the agent should use for future runs
+   */
   model?: string;
 
+  /**
+   * Updated agent display name
+   */
   name?: string;
 
+  /**
+   * Sandbox configuration override for future agent runs. Pass null to clear.
+   */
   sandbox?: unknown | null;
 
+  /**
+   * Vault group IDs the agent can access. Pass null to clear.
+   */
   vaultGroups?: Array<string> | null;
 
+  /**
+   * Vault IDs the agent can access directly. Pass null to clear.
+   */
   vaultIds?: Array<string> | null;
 }
 

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

@@ -183,7 +183,7 @@ export interface ChatReplyToQuestionParams {
   id: string;
 
   /**
-   * Body param
+   * Body param: Answer selections for each prompt element in the pending question
    */
   answers: Array<Array<string>>;
 }

package/src/resources/applications/v1/deployments.ts

@@ -11,7 +11,9 @@ import { path } from '../../../internal/utils/path';
  */
 export class Deployments extends APIResource {
   /**
-   * Trigger a new deployment for a project
+   * Creates a deployment for an existing project by fetching repository files from
+   * GitHub and uploading them to the hosting provider. Use ref to deploy a branch,
+   * tag, or commit other than the project default branch.
    */
   create(body: DeploymentCreateParams, options?: RequestOptions): APIPromise<void> {
     return this._client.post('/applications/v1/deployments', {
@@ -22,7 +24,8 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * Get details of a specific deployment including build logs
+   * Returns deployment details for one project in the authenticated organization.
+   * Set includeLogs=true to include recent build output in the response.
    */
   retrieve(id: string, query: DeploymentRetrieveParams, options?: RequestOptions): APIPromise<void> {
     return this._client.get(path`/applications/v1/deployments/${id}`, {
@@ -33,7 +36,8 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * List deployments for a project
+   * Lists recent deployments for one project in the authenticated organization. Use
+   * the optional filters to narrow results by target or deployment state.
    */
   list(query: DeploymentListParams, options?: RequestOptions): APIPromise<void> {
     return this._client.get('/applications/v1/deployments', {
@@ -44,7 +48,9 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * Cancel a running deployment
+   * Cancels a running deployment after verifying that the referenced project belongs
+   * to the authenticated organization. Use this when a build is stuck,
+   * misconfigured, or no longer needed.
    */
   cancel(id: string, body: DeploymentCancelParams, options?: RequestOptions): APIPromise<void> {
     return this._client.post(path`/applications/v1/deployments/${id}/cancel`, {
@@ -65,7 +71,9 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * Get build logs for a specific deployment
+   * Returns build and runtime log events for a deployment after verifying access to
+   * the owning project. Use this when you need detailed output for a failed or
+   * in-progress build.
    */
   getLogs(id: string, query: DeploymentGetLogsParams, options?: RequestOptions): APIPromise<void> {
     return this._client.get(path`/applications/v1/deployments/${id}/logs`, {
@@ -76,7 +84,9 @@ export class Deployments extends APIResource {
   }
 
   /**
-   * Get the current status of a deployment
+   * Returns the current status of a deployment without fetching full build logs. Use
+   * this endpoint for lightweight polling while a deployment is building or waiting
+   * to become ready.
    */
   getStatus(id: string, options?: RequestOptions): APIPromise<void> {
     return this._client.get(path`/applications/v1/deployments/${id}/status`, {
@@ -99,36 +109,36 @@ export class Deployments extends APIResource {
 
 export interface DeploymentCreateParams {
   /**
-   * Project ID
+   * Project ID to deploy
    */
   projectId: string;
 
   /**
-   * Git ref (branch, tag, or commit) to deploy
+   * Git branch, tag, or commit to deploy. Defaults to the project branch.
    */
   ref?: string;
 
   /**
-   * Deployment target
+   * Deployment target environment
    */
   target?: 'production' | 'preview';
 }
 
 export interface DeploymentRetrieveParams {
   /**
-   * Project ID (for authorization)
+   * Project ID used to verify access to the deployment
    */
   projectId: string;
 
   /**
-   * Include build logs
+   * Whether to include build logs in the response
    */
   includeLogs?: boolean;
 }
 
 export interface DeploymentListParams {
   /**
-   * Project ID
+   * Project ID to list deployments for
    */
   projectId: string;
 
@@ -138,26 +148,26 @@ export interface DeploymentListParams {
   limit?: number;
 
   /**
-   * Filter by deployment state
+   * Deployment state to filter by
    */
   state?: string;
 
   /**
-   * Filter by deployment target
+   * Deployment target to filter by
    */
   target?: 'production' | 'staging';
 }
 
 export interface DeploymentCancelParams {
   /**
-   * Project ID (for authorization)
+   * Project ID used to verify access to the deployment
    */
   projectId: string;
 }
 
 export interface DeploymentGetLogsParams {
   /**
-   * Project ID (for authorization)
+   * Project ID used to verify access to the deployment
    */
   projectId: string;
 }