telnyx 7.23.0 → 7.25.0

package/resources/llm-token-gateway/usage.d.ts

@@ -0,0 +1,260 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Manage and report AI Gateway traffic.
+ */
+export declare class Usage extends APIResource {
+    /**
+     * Return complete usage totals, UTC daily and model breakdowns, and guardrail
+     * event counts for one token group owned by the authenticated account. Requires
+     * the llm_token_gateway.usage.read permission; spend and guardrail read
+     * permissions do not grant this combined report. All sections share one database
+     * snapshot and include the latest usage corrections. Dates use an inclusive start
+     * and exclusive end spanning 1 to 31 days. Only token_group_id, start_date and
+     * end_date are accepted; pagination, group_by and other filters are rejected.
+     * Spend is reference/enforcement USD, not invoice truth or BYOK provider charges.
+     * Unknown cost is excluded from spend and reported through unknown_requests and
+     * reserved_spend. Daily rows include zero-activity days. Model rows are ordered by
+     * request count descending, then model name, and are limited to 1,000. Guardrail
+     * counts count events, not distinct requests; recent_events contains at most 20
+     * newest events. A report that exceeds model or query limits returns 503 rather
+     * than a truncated success.
+     */
+    retrieveSummary(query: UsageRetrieveSummaryParams, options?: RequestOptions): APIPromise<UsageRetrieveSummaryResponse>;
+}
+export interface UsageRetrieveSummaryResponse {
+    data: UsageRetrieveSummaryResponse.Data;
+    meta: UsageRetrieveSummaryResponse.Meta;
+}
+export declare namespace UsageRetrieveSummaryResponse {
+    interface Data {
+        /**
+         * One row per UTC day, including zero-activity days.
+         */
+        by_day: Array<Data.ByDay>;
+        /**
+         * One row per model, ordered by request count descending then model name.
+         */
+        by_model: Array<Data.ByModel>;
+        /**
+         * Complete guardrail event counts and bounded recent findings for the same group
+         * and range.
+         */
+        guardrails: Data.Guardrails;
+        /**
+         * Metrics for all matching requests.
+         */
+        totals: Data.Totals;
+    }
+    namespace Data {
+        interface ByDay {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * UTC day.
+             */
+            date: string;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+        interface ByModel {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Model identifier.
+             */
+            model: string;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+        /**
+         * Complete guardrail event counts and bounded recent findings for the same group
+         * and range.
+         */
+        interface Guardrails {
+            /**
+             * Total blocked guardrail events, not distinct requests.
+             */
+            blocked_events: number;
+            /**
+             * Total flagged guardrail events, not distinct requests.
+             */
+            flagged_events: number;
+            /**
+             * Up to 20 newest privacy-safe guardrail events, ordered by creation time
+             * descending and event ID.
+             */
+            recent_events: Array<Guardrails.RecentEvent>;
+        }
+        namespace Guardrails {
+            interface RecentEvent {
+                id: string;
+                created_at: string;
+                end_user_id: string | null;
+                evaluation_input_tokens: number | null;
+                evaluation_output_tokens: number | null;
+                findings: Array<RecentEvent.Finding>;
+                /**
+                 * Model identifier.
+                 */
+                model: string;
+                outcome: 'evaluated' | 'flagged' | 'blocked' | 'unevaluated';
+                record_type: 'guardrail_event';
+                request_id: string;
+                stage: 'prompt' | 'response';
+                token_group_id: string;
+                token_key_id: string;
+                token_user_id: string | null;
+            }
+            namespace RecentEvent {
+                interface Finding {
+                    action: 'flag' | 'block';
+                    code: string;
+                    count: number;
+                    detector: 'secrets' | 'dlp' | 'safety';
+                }
+            }
+        }
+        /**
+         * Metrics for all matching requests.
+         */
+        interface Totals {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+    }
+    interface Meta {
+        end_date: string;
+        start_date: string;
+        token_group_id: string;
+    }
+}
+export interface UsageRetrieveSummaryParams {
+    /**
+     * Exclusive UTC date in YYYY-MM-DD format. Must follow start_date by 1 to 31 days.
+     */
+    end_date: string;
+    /**
+     * Inclusive UTC date in YYYY-MM-DD format. Must precede end_date by 1 to 31 days.
+     */
+    start_date: string;
+    /**
+     * ID of a token group owned by the authenticated account.
+     */
+    token_group_id: string;
+}
+export declare namespace Usage {
+    export { type UsageRetrieveSummaryResponse as UsageRetrieveSummaryResponse, type UsageRetrieveSummaryParams as UsageRetrieveSummaryParams, };
+}
+//# sourceMappingURL=usage.d.ts.map

package/resources/llm-token-gateway/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/usage.ts"],"names":[],"mappings":"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"}

package/resources/llm-token-gateway/usage.js

@@ -0,0 +1,31 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Usage = void 0;
+const resource_1 = require("../../core/resource.js");
+/**
+ * Manage and report AI Gateway traffic.
+ */
+class Usage extends resource_1.APIResource {
+    /**
+     * Return complete usage totals, UTC daily and model breakdowns, and guardrail
+     * event counts for one token group owned by the authenticated account. Requires
+     * the llm_token_gateway.usage.read permission; spend and guardrail read
+     * permissions do not grant this combined report. All sections share one database
+     * snapshot and include the latest usage corrections. Dates use an inclusive start
+     * and exclusive end spanning 1 to 31 days. Only token_group_id, start_date and
+     * end_date are accepted; pagination, group_by and other filters are rejected.
+     * Spend is reference/enforcement USD, not invoice truth or BYOK provider charges.
+     * Unknown cost is excluded from spend and reported through unknown_requests and
+     * reserved_spend. Daily rows include zero-activity days. Model rows are ordered by
+     * request count descending, then model name, and are limited to 1,000. Guardrail
+     * counts count events, not distinct requests; recent_events contains at most 20
+     * newest events. A report that exceeds model or query limits returns 503 rather
+     * than a truncated success.
+     */
+    retrieveSummary(query, options) {
+        return this._client.get('/llm_token_gateway/usage/summary', { query, ...options });
+    }
+}
+exports.Usage = Usage;
+//# sourceMappingURL=usage.js.map

package/resources/llm-token-gateway/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/usage.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CACb,KAAiC,EACjC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;CACF;AAvBD,sBAuBC"}

package/resources/llm-token-gateway/usage.mjs

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+/**
+ * Manage and report AI Gateway traffic.
+ */
+export class Usage extends APIResource {
+    /**
+     * Return complete usage totals, UTC daily and model breakdowns, and guardrail
+     * event counts for one token group owned by the authenticated account. Requires
+     * the llm_token_gateway.usage.read permission; spend and guardrail read
+     * permissions do not grant this combined report. All sections share one database
+     * snapshot and include the latest usage corrections. Dates use an inclusive start
+     * and exclusive end spanning 1 to 31 days. Only token_group_id, start_date and
+     * end_date are accepted; pagination, group_by and other filters are rejected.
+     * Spend is reference/enforcement USD, not invoice truth or BYOK provider charges.
+     * Unknown cost is excluded from spend and reported through unknown_requests and
+     * reserved_spend. Daily rows include zero-activity days. Model rows are ordered by
+     * request count descending, then model name, and are limited to 1,000. Guardrail
+     * counts count events, not distinct requests; recent_events contains at most 20
+     * newest events. A report that exceeds model or query limits returns 503 rather
+     * than a truncated success.
+     */
+    retrieveSummary(query, options) {
+        return this._client.get('/llm_token_gateway/usage/summary', { query, ...options });
+    }
+}
+//# sourceMappingURL=usage.mjs.map

package/resources/llm-token-gateway/usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.mjs","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/usage.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CACb,KAAiC,EACjC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}

package/resources/llm-token-gateway.d.mts

@@ -0,0 +1,2 @@
+export * from "./llm-token-gateway/index.mjs";
+//# sourceMappingURL=llm-token-gateway.d.mts.map

package/resources/llm-token-gateway.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.d.mts","sourceRoot":"","sources":["../src/resources/llm-token-gateway.ts"],"names":[],"mappings":"AAEA,8CAA0C"}

package/resources/llm-token-gateway.d.ts

@@ -0,0 +1,2 @@
+export * from "./llm-token-gateway/index.js";
+//# sourceMappingURL=llm-token-gateway.d.ts.map

package/resources/llm-token-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.d.ts","sourceRoot":"","sources":["../src/resources/llm-token-gateway.ts"],"names":[],"mappings":"AAEA,6CAA0C"}

package/resources/llm-token-gateway.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./llm-token-gateway/index.js"), exports);
+//# sourceMappingURL=llm-token-gateway.js.map

package/resources/llm-token-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.js","sourceRoot":"","sources":["../src/resources/llm-token-gateway.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,uEAA0C"}

package/resources/llm-token-gateway.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./llm-token-gateway/index.mjs";
+//# sourceMappingURL=llm-token-gateway.mjs.map

package/resources/llm-token-gateway.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.mjs","sourceRoot":"","sources":["../src/resources/llm-token-gateway.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,8CAA0C"}

package/resources/meeting-sessions/actions.d.mts

@@ -19,7 +19,13 @@ export declare class Actions extends APIResource {
      */
     sendChat(id: string, body: ActionSendChatParams, options?: RequestOptions): APIPromise<ActionAcceptedResponse>;
     /**
-     * Sends audio / text-to-speech into a meeting session.
+     * Sends audio / text-to-speech into a meeting session. With a Telnyx AI Assistant
+     * (or avatar) attached, the bot is a webpage-output bot: the speak audio routes
+     * through the assistant's output page rather than the bot mic and plays once the
+     * assistant is connected -- it is not refused. If that page cannot be reached,
+     * delivery fails with the 502 below, which may arrive without an error envelope,
+     * so branch on the status code before parsing a body. The assistant is designed to
+     * own the conversation, so prefer letting it speak or use `send_chat`.
      *
      * @example
      * ```ts

package/resources/meeting-sessions/actions.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.mts","sourceRoot":"","sources":["../../src/resources/meeting-sessions/actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;IAIrC;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;IAIxG;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGvF;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;CACnC;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,IAAI;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}
+{"version":3,"file":"actions.d.mts","sourceRoot":"","sources":["../../src/resources/meeting-sessions/actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;IAIrC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;IAIxG;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGvF;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;CACnC;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,IAAI;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}

package/resources/meeting-sessions/actions.d.ts

@@ -19,7 +19,13 @@ export declare class Actions extends APIResource {
      */
     sendChat(id: string, body: ActionSendChatParams, options?: RequestOptions): APIPromise<ActionAcceptedResponse>;
     /**
-     * Sends audio / text-to-speech into a meeting session.
+     * Sends audio / text-to-speech into a meeting session. With a Telnyx AI Assistant
+     * (or avatar) attached, the bot is a webpage-output bot: the speak audio routes
+     * through the assistant's output page rather than the bot mic and plays once the
+     * assistant is connected -- it is not refused. If that page cannot be reached,
+     * delivery fails with the 502 below, which may arrive without an error envelope,
+     * so branch on the status code before parsing a body. The assistant is designed to
+     * own the conversation, so prefer letting it speak or use `send_chat`.
      *
      * @example
      * ```ts

package/resources/meeting-sessions/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/resources/meeting-sessions/actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;IAIrC;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;IAIxG;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGvF;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;CACnC;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,IAAI;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/resources/meeting-sessions/actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;IAIrC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;IAIxG;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGvF;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;CACnC;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,IAAI;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}

package/resources/meeting-sessions/actions.js

@@ -24,7 +24,13 @@ class Actions extends resource_1.APIResource {
         return this._client.post((0, path_1.path) `/meeting_sessions/${id}/actions/send_chat`, { body, ...options });
     }
     /**
-     * Sends audio / text-to-speech into a meeting session.
+     * Sends audio / text-to-speech into a meeting session. With a Telnyx AI Assistant
+     * (or avatar) attached, the bot is a webpage-output bot: the speak audio routes
+     * through the assistant's output page rather than the bot mic and plays once the
+     * assistant is connected -- it is not refused. If that page cannot be reached,
+     * delivery fails with the 502 below, which may arrive without an error envelope,
+     * so branch on the status code before parsing a body. The assistant is designed to
+     * own the conversation, so prefer letting it speak or use `send_chat`.
      *
      * @example
      * ```ts

package/resources/meeting-sessions/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/resources/meeting-sessions/actions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAU,EACV,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAU,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF;AArDD,0BAqDC"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/resources/meeting-sessions/actions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAU,EACV,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAU,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF;AA3DD,0BA2DC"}

package/resources/meeting-sessions/actions.mjs

@@ -21,7 +21,13 @@ export class Actions extends APIResource {
         return this._client.post(path `/meeting_sessions/${id}/actions/send_chat`, { body, ...options });
     }
     /**
-     * Sends audio / text-to-speech into a meeting session.
+     * Sends audio / text-to-speech into a meeting session. With a Telnyx AI Assistant
+     * (or avatar) attached, the bot is a webpage-output bot: the speak audio routes
+     * through the assistant's output page rather than the bot mic and plays once the
+     * assistant is connected -- it is not refused. If that page cannot be reached,
+     * delivery fails with the 502 below, which may arrive without an error envelope,
+     * so branch on the status code before parsing a body. The assistant is designed to
+     * own the conversation, so prefer letting it speak or use `send_chat`.
      *
      * @example
      * ```ts

package/resources/meeting-sessions/actions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"actions.mjs","sourceRoot":"","sources":["../../src/resources/meeting-sessions/actions.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAU,EACV,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAU,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF"}
+{"version":3,"file":"actions.mjs","sourceRoot":"","sources":["../../src/resources/meeting-sessions/actions.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAU,EACV,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAU,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF"}

package/resources/meeting-sessions/artifacts.d.mts

@@ -18,11 +18,17 @@ export declare class Artifacts extends APIResource {
      */
     list(id: string, options?: RequestOptions): APIPromise<ArtifactListResponse>;
     /**
-     * Requests asynchronous generation of one `summary` or `action_items` artifact.
-     * Each type requires its own request. Generation requires transcript content and
-     * configured inference and currently reads at most the first 10,000 segments, so
-     * exceptionally long transcripts may produce incomplete artifacts or fail model
-     * limits.
+     * Requests asynchronous generation of one artifact: `summary`, `action_items`,
+     * `decisions`, `topics`, `open_questions`, or `custom`. Each request produces one
+     * artifact. `custom` is answered from a `prompt` you supply, which is required for
+     * `custom` and rejected on the five named types. Generation requires transcript
+     * content and configured inference and currently reads at most the first 10,000
+     * segments, so exceptionally long transcripts may produce incomplete artifacts or
+     * fail model limits. **Not idempotent, and every call is billed**: each request is
+     * a separate inference run, so a retry or a duplicate POST produces a second
+     * artifact and a second charge. Guard the call rather than relying on the service
+     * to collapse it. The automatic `summarize_on_end` attempt is billed on the same
+     * basis.
      *
      * @example
      * ```ts
@@ -54,9 +60,14 @@ export interface MeetingSessionArtifact {
     created_at: string;
     failure_reason: string | null;
     model_provenance: MeetingSessionArtifact.ModelProvenance | null;
+    /**
+     * The prompt that produced this artifact, or null for a named type. Non-null only
+     * when `type` is `custom`; the five named types always return `null`.
+     */
+    prompt: string | null;
     session_id: string;
     status: 'pending' | 'completed' | 'failed';
-    type: 'summary' | 'action_items';
+    type: 'summary' | 'action_items' | 'decisions' | 'topics' | 'open_questions' | 'custom';
     updated_at: string;
 }
 export declare namespace MeetingSessionArtifact {
@@ -74,11 +85,27 @@ export interface MeetingSessionArtifactResponse {
 export interface ArtifactListResponse {
     data: Array<MeetingSessionArtifact>;
 }
-export interface ArtifactCreateParams {
-    /**
-     * Type of artifact to generate from the session.
-     */
-    type: 'summary' | 'action_items';
+export type ArtifactCreateParams = ArtifactCreateParams.NamedArtifact | ArtifactCreateParams.CustomArtifact;
+export declare namespace ArtifactCreateParams {
+    interface NamedArtifact {
+        /**
+         * What to generate from the transcript. `custom` is answered from a `prompt` you
+         * supply; the five named types need none.
+         */
+        type: 'summary' | 'action_items' | 'decisions' | 'topics' | 'open_questions';
+    }
+    interface CustomArtifact {
+        /**
+         * An open-ended request answered from the transcript. Required when `type` is
+         * `custom`, and rejected with 400 on any named type. Trimmed before storage and
+         * echoed back in artifact responses and the `artifact.completed` webhook.
+         */
+        prompt: string;
+        /**
+         * Answered from the `prompt` below rather than a fixed question.
+         */
+        type: 'custom';
+    }
 }
 export interface ArtifactRetrieveParams {
     /**

package/resources/meeting-sessions/artifacts.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.mts","sourceRoot":"","sources":["../../src/resources/meeting-sessions/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAI5E;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;IAI7C;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAI9C;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,sBAAsB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE/C,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,gBAAgB,EAAE,sBAAsB,CAAC,eAAe,GAAG,IAAI,CAAC;IAEhE,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE3C,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;IAEjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,OAAO;QACtB,IAAI,EAAE,MAAM,CAAC;KACd;IAED,UAAiB,eAAe;QAC9B,KAAK,EAAE,MAAM,CAAC;QAEd,QAAQ,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
+{"version":3,"file":"artifacts.d.mts","sourceRoot":"","sources":["../../src/resources/meeting-sessions/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAI5E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;IAI7C;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAI9C;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,sBAAsB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE/C,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,gBAAgB,EAAE,sBAAsB,CAAC,eAAe,GAAG,IAAI,CAAC;IAEhE;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE3C,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,CAAC;IAExF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,OAAO;QACtB,IAAI,EAAE,MAAM,CAAC;KACd;IAED,UAAiB,eAAe;QAC9B,KAAK,EAAE,MAAM,CAAC;QAEd,QAAQ,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,aAAa,GAAG,oBAAoB,CAAC,cAAc,CAAC;AAE5G,MAAM,CAAC,OAAO,WAAW,oBAAoB,CAAC;IAC5C,UAAiB,aAAa;QAC5B;;;WAGG;QACH,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,gBAAgB,CAAC;KAC9E;IAED,UAAiB,cAAc;QAC7B;;;;WAIG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,IAAI,EAAE,QAAQ,CAAC;KAChB;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/meeting-sessions/artifacts.d.ts

@@ -18,11 +18,17 @@ export declare class Artifacts extends APIResource {
      */
     list(id: string, options?: RequestOptions): APIPromise<ArtifactListResponse>;
     /**
-     * Requests asynchronous generation of one `summary` or `action_items` artifact.
-     * Each type requires its own request. Generation requires transcript content and
-     * configured inference and currently reads at most the first 10,000 segments, so
-     * exceptionally long transcripts may produce incomplete artifacts or fail model
-     * limits.
+     * Requests asynchronous generation of one artifact: `summary`, `action_items`,
+     * `decisions`, `topics`, `open_questions`, or `custom`. Each request produces one
+     * artifact. `custom` is answered from a `prompt` you supply, which is required for
+     * `custom` and rejected on the five named types. Generation requires transcript
+     * content and configured inference and currently reads at most the first 10,000
+     * segments, so exceptionally long transcripts may produce incomplete artifacts or
+     * fail model limits. **Not idempotent, and every call is billed**: each request is
+     * a separate inference run, so a retry or a duplicate POST produces a second
+     * artifact and a second charge. Guard the call rather than relying on the service
+     * to collapse it. The automatic `summarize_on_end` attempt is billed on the same
+     * basis.
      *
      * @example
      * ```ts
@@ -54,9 +60,14 @@ export interface MeetingSessionArtifact {
     created_at: string;
     failure_reason: string | null;
     model_provenance: MeetingSessionArtifact.ModelProvenance | null;
+    /**
+     * The prompt that produced this artifact, or null for a named type. Non-null only
+     * when `type` is `custom`; the five named types always return `null`.
+     */
+    prompt: string | null;
     session_id: string;
     status: 'pending' | 'completed' | 'failed';
-    type: 'summary' | 'action_items';
+    type: 'summary' | 'action_items' | 'decisions' | 'topics' | 'open_questions' | 'custom';
     updated_at: string;
 }
 export declare namespace MeetingSessionArtifact {
@@ -74,11 +85,27 @@ export interface MeetingSessionArtifactResponse {
 export interface ArtifactListResponse {
     data: Array<MeetingSessionArtifact>;
 }
-export interface ArtifactCreateParams {
-    /**
-     * Type of artifact to generate from the session.
-     */
-    type: 'summary' | 'action_items';
+export type ArtifactCreateParams = ArtifactCreateParams.NamedArtifact | ArtifactCreateParams.CustomArtifact;
+export declare namespace ArtifactCreateParams {
+    interface NamedArtifact {
+        /**
+         * What to generate from the transcript. `custom` is answered from a `prompt` you
+         * supply; the five named types need none.
+         */
+        type: 'summary' | 'action_items' | 'decisions' | 'topics' | 'open_questions';
+    }
+    interface CustomArtifact {
+        /**
+         * An open-ended request answered from the transcript. Required when `type` is
+         * `custom`, and rejected with 400 on any named type. Trimmed before storage and
+         * echoed back in artifact responses and the `artifact.completed` webhook.
+         */
+        prompt: string;
+        /**
+         * Answered from the `prompt` below rather than a fixed question.
+         */
+        type: 'custom';
+    }
 }
 export interface ArtifactRetrieveParams {
     /**

package/resources/meeting-sessions/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/resources/meeting-sessions/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAI5E;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;IAI7C;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAI9C;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,sBAAsB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE/C,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,gBAAgB,EAAE,sBAAsB,CAAC,eAAe,GAAG,IAAI,CAAC;IAEhE,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE3C,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;IAEjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,OAAO;QACtB,IAAI,EAAE,MAAM,CAAC;KACd;IAED,UAAiB,eAAe;QAC9B,KAAK,EAAE,MAAM,CAAC;QAEd,QAAQ,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/resources/meeting-sessions/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAI5E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;IAI7C;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAI9C;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,sBAAsB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE/C,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,gBAAgB,EAAE,sBAAsB,CAAC,eAAe,GAAG,IAAI,CAAC;IAEhE;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE3C,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,CAAC;IAExF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,OAAO;QACtB,IAAI,EAAE,MAAM,CAAC;KACd;IAED,UAAiB,eAAe;QAC9B,KAAK,EAAE,MAAM,CAAC;QAEd,QAAQ,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,aAAa,GAAG,oBAAoB,CAAC,cAAc,CAAC;AAE5G,MAAM,CAAC,OAAO,WAAW,oBAAoB,CAAC;IAC5C,UAAiB,aAAa;QAC5B;;;WAGG;QACH,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,gBAAgB,CAAC;KAC9E;IAED,UAAiB,cAAc;QAC7B;;;;WAIG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,IAAI,EAAE,QAAQ,CAAC;KAChB;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}