telnyx 7.22.0 → 7.24.0

package/resources/ai/typesafe/v1.d.mts

@@ -0,0 +1,285 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Beta API for evaluating shared context with typed questions and structured answers using Flash or Pro.
+ */
+export declare class V1 extends APIResource {
+    /**
+     * **Beta API.** Choose telnyx/decision-flash for the lowest cost and latency, or
+     * telnyx/decision-pro for decisions that require long context, including inputs
+     * beyond Jev’s 32k per-decision limit. Omitted model defaults to
+     * telnyx/decision-flash.
+     *
+     * Evaluate shared context using named choice, noul (yes/no), and score questions.
+     * Returns TypeSafe System One-compatible answer shapes, the selected public model
+     * alias, and token usage. See the
+     * [decision model guide](https://developers.telnyx.com/docs/inference/decision-models)
+     * for examples and compatibility limits.
+     *
+     * The supported request subset requires instructions for every question, string
+     * descriptions for criteria (or null for choice descriptions), 1–64 questions, and
+     * 2–64 options for choice and score questions. The model field accepts only
+     * telnyx/decision-flash or telnyx/decision-pro. Unsupported model values and
+     * unknown fields are rejected. The endpoint is synchronous and does not stream.
+     *
+     * Use the TypeSafe Python SDK with base_url set to
+     * https://api.telnyx.com/v2/ai/typesafe and a Telnyx API key. The SDK appends
+     * /v1/systemone; explicitly set model to a supported Telnyx alias because its own
+     * default model is not supported. Compatibility covers this operation and the
+     * documented request subset; it does not include TypeSafe model listing. Scores
+     * describe relative preference, not calibrated correctness.
+     *
+     * @example
+     * ```ts
+     * const response = await client.ai.typesafe.v1.systemone({
+     *   questions: {
+     *     team: {
+     *       type: 'choice',
+     *       instructions:
+     *         'Choose the team that should handle this incident.',
+     *       criteria: {
+     *         billing: 'Payments and refunds',
+     *         technical_support:
+     *           'Service faults and technical problems',
+     *         sales: 'New purchases',
+     *       },
+     *     },
+     *     production_incident: {
+     *       type: 'noul',
+     *       instructions:
+     *         'Does the message describe an active production incident?',
+     *     },
+     *     urgency: {
+     *       type: 'score',
+     *       instructions: 'Rate operational urgency.',
+     *       criteria: ['Low', 'Normal', 'High', 'Critical'],
+     *     },
+     *   },
+     *   state:
+     *     'Our production calls are failing. Every customer is affected.',
+     *   model: 'telnyx/decision-flash',
+     * });
+     * ```
+     */
+    systemone(body: V1SystemoneParams, options?: RequestOptions): APIPromise<V1SystemoneResponse>;
+}
+/**
+ * A complete synchronous evaluation. Answers are returned directly without a data
+ * wrapper.
+ */
+export interface V1SystemoneResponse {
+    /**
+     * Answers keyed by exactly the question IDs in the request. Each answer type
+     * matches its question.
+     */
+    answers: {
+        [key: string]: V1SystemoneResponse.DecisionModelChoiceAnswer | V1SystemoneResponse.DecisionModelNoulAnswer | V1SystemoneResponse.DecisionModelScoreAnswer;
+    };
+    /**
+     * Public model alias used to evaluate the request. Returns telnyx/decision-flash
+     * when model was omitted. The underlying model is managed by Telnyx.
+     */
+    model: 'telnyx/decision-flash' | 'telnyx/decision-pro';
+    /**
+     * Token usage for the completed evaluation.
+     */
+    usage: V1SystemoneResponse.Usage;
+}
+export declare namespace V1SystemoneResponse {
+    /**
+     * A selected option and the distribution across all supplied option keys.
+     */
+    interface DecisionModelChoiceAnswer {
+        /**
+         * The option key with the highest relative score. Ties favor the first option in
+         * request order.
+         */
+        choice: string;
+        /**
+         * Normalized entropy confidence: 1 - H(p) / ln(N), where H(p) = -sum(p \* ln(p))
+         * and N is the number of options. Zero indicates a uniform distribution; one
+         * indicates concentration on one option. This is neither the winning probability
+         * nor calibrated correctness.
+         */
+        confidence: number;
+        /**
+         * Relative scores normalized across the supplied options, summing approximately
+         * to 1. These are not calibrated probabilities of correctness.
+         */
+        probabilities: {
+            [key: string]: number;
+        };
+        /**
+         * Answer type.
+         */
+        type: 'choice';
+    }
+    /**
+     * A yes/no score with no separate confidence or probabilities fields.
+     */
+    interface DecisionModelNoulAnswer {
+        /**
+         * Score of the positive outcome. Values near 1 favor yes; values near 0 favor no.
+         * This is a number, not a Boolean, and is not calibrated correctness.
+         */
+        noul: number;
+        /**
+         * Answer type.
+         */
+        type: 'noul';
+    }
+    /**
+     * An expected rating over the ordered criteria.
+     */
+    interface DecisionModelScoreAnswer {
+        /**
+         * Normalized entropy confidence: 1 - H(p) / ln(N), where H(p) = -sum(p \* ln(p))
+         * and N is the number of options. Zero indicates a uniform distribution; one
+         * indicates concentration on one option. This is neither the winning probability
+         * nor calibrated correctness.
+         */
+        confidence: number;
+        /**
+         * Criterion descriptions keyed by stringified zero-based indices, such as "0",
+         * "1", and "2".
+         */
+        legend: {
+            [key: string]: string;
+        };
+        /**
+         * Relative scores keyed by the same stringified indices as legend.
+         */
+        probabilities: {
+            [key: string]: number;
+        };
+        /**
+         * Expected zero-based criterion index: sum(index \* probability). Ranges from 0 to
+         * N-1 for N criteria; fractional values are valid.
+         */
+        score: number;
+        /**
+         * Answer type.
+         */
+        type: 'score';
+    }
+    /**
+     * Token usage for the completed evaluation.
+     */
+    interface Usage {
+        /**
+         * Input tokens processed, including shared-context preparation and question
+         * evaluation. This can exceed the token count of the unique input text.
+         */
+        input_tokens: number;
+        /**
+         * Output tokens used for the evaluation, including shared-context preparation.
+         */
+        output_tokens: number;
+    }
+}
+export interface V1SystemoneParams {
+    /**
+     * Between 1 and 64 named questions. Each key identifies the corresponding answer.
+     */
+    questions: {
+        [key: string]: V1SystemoneParams.DecisionModelChoiceQuestion | V1SystemoneParams.DecisionModelNoulQuestion | V1SystemoneParams.DecisionModelScoreQuestion;
+    };
+    /**
+     * Shared context evaluated by every question.
+     */
+    state: string | {
+        [key: string]: unknown;
+    } | Array<unknown>;
+    /**
+     * Public model alias. telnyx/decision-flash offers the lowest cost and latency;
+     * telnyx/decision-pro supports decisions that require long context, including
+     * inputs beyond Jev’s 32k per-decision limit. Applies to every question in the
+     * request. Other values are rejected.
+     */
+    model?: 'telnyx/decision-flash' | 'telnyx/decision-pro';
+}
+export declare namespace V1SystemoneParams {
+    /**
+     * Select one of the supplied options.
+     */
+    interface DecisionModelChoiceQuestion {
+        /**
+         * Between 2 and 64 option keys mapped to description strings or null. A null
+         * description uses the option key as its text.
+         */
+        criteria: {
+            [key: string]: string | null;
+        };
+        /**
+         * Required instructions describing what to decide about the shared state.
+         */
+        instructions: string | {
+            [key: string]: unknown;
+        } | Array<unknown>;
+        /**
+         * Question type.
+         */
+        type: 'choice';
+    }
+    /**
+     * Evaluate a yes/no question. Omit criteria to use Yes and No descriptions.
+     */
+    interface DecisionModelNoulQuestion {
+        /**
+         * Required instructions describing what to decide about the shared state.
+         */
+        instructions: string | {
+            [key: string]: unknown;
+        } | Array<unknown>;
+        /**
+         * Question type.
+         */
+        type: 'noul';
+        /**
+         * Optional descriptions for the positive and negative outcomes. Descriptions must
+         * be strings.
+         */
+        criteria?: DecisionModelNoulQuestion.Criteria;
+    }
+    namespace DecisionModelNoulQuestion {
+        /**
+         * Optional descriptions for the positive and negative outcomes. Descriptions must
+         * be strings.
+         */
+        interface Criteria {
+            /**
+             * Description of the negative outcome.
+             */
+            false?: string;
+            /**
+             * Description of the positive outcome.
+             */
+            true?: string;
+        }
+    }
+    /**
+     * Rate the state against an ordered rubric.
+     */
+    interface DecisionModelScoreQuestion {
+        /**
+         * Between 2 and 64 description strings in ascending score order. Indices start at
+         * zero.
+         */
+        criteria: Array<string>;
+        /**
+         * Required instructions describing what to decide about the shared state.
+         */
+        instructions: string | {
+            [key: string]: unknown;
+        } | Array<unknown>;
+        /**
+         * Question type.
+         */
+        type: 'score';
+    }
+}
+export declare namespace V1 {
+    export { type V1SystemoneResponse as V1SystemoneResponse, type V1SystemoneParams as V1SystemoneParams };
+}
+//# sourceMappingURL=v1.d.mts.map

package/resources/ai/typesafe/v1.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.d.mts","sourceRoot":"","sources":["../../../src/resources/ai/typesafe/v1.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,sCAAkC;AACvD,OAAO,EAAE,cAAc,EAAE,8CAA0C;AAEnE;;GAEG;AACH,qBAAa,EAAG,SAAQ,WAAW;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,SAAS,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAG9F;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GACR,mBAAmB,CAAC,yBAAyB,GAC7C,mBAAmB,CAAC,uBAAuB,GAC3C,mBAAmB,CAAC,wBAAwB,CAAC;KAClD,CAAC;IAEF;;;OAGG;IACH,KAAK,EAAE,uBAAuB,GAAG,qBAAqB,CAAC;IAEvD;;OAEG;IACH,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC;CAClC;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,yBAAyB;QACxC;;;WAGG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;;;;WAKG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;;WAGG;QACH,aAAa,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAEzC;;WAEG;QACH,IAAI,EAAE,QAAQ,CAAC;KAChB;IAED;;OAEG;IACH,UAAiB,uBAAuB;QACtC;;;WAGG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd;IAED;;OAEG;IACH,UAAiB,wBAAwB;QACvC;;;;;WAKG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;;WAGG;QACH,MAAM,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAElC;;WAEG;QACH,aAAa,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAEzC;;;WAGG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,IAAI,EAAE,OAAO,CAAC;KACf;IAED;;OAEG;IACH,UAAiB,KAAK;QACpB;;;WAGG;QACH,YAAY,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,aAAa,EAAE,MAAM,CAAC;KACvB;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,EAAE;QACT,CAAC,GAAG,EAAE,MAAM,GACR,iBAAiB,CAAC,2BAA2B,GAC7C,iBAAiB,CAAC,yBAAyB,GAC3C,iBAAiB,CAAC,0BAA0B,CAAC;KAClD,CAAC;IAEF;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,uBAAuB,GAAG,qBAAqB,CAAC;CACzD;AAED,yBAAiB,iBAAiB,CAAC;IACjC;;OAEG;IACH,UAAiB,2BAA2B;QAC1C;;;WAGG;QACH,QAAQ,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QAE3C;;WAEG;QACH,YAAY,EAAE,MAAM,GAAG;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAEnE;;WAEG;QACH,IAAI,EAAE,QAAQ,CAAC;KAChB;IAED;;OAEG;IACH,UAAiB,yBAAyB;QACxC;;WAEG;QACH,YAAY,EAAE,MAAM,GAAG;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAEnE;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;;WAGG;QACH,QAAQ,CAAC,EAAE,yBAAyB,CAAC,QAAQ,CAAC;KAC/C;IAED,UAAiB,yBAAyB,CAAC;QACzC;;;WAGG;QACH,UAAiB,QAAQ;YACvB;;eAEG;YACH,KAAK,CAAC,EAAE,MAAM,CAAC;YAEf;;eAEG;YACH,IAAI,CAAC,EAAE,MAAM,CAAC;SACf;KACF;IAED;;OAEG;IACH,UAAiB,0BAA0B;QACzC;;;WAGG;QACH,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAExB;;WAEG;QACH,YAAY,EAAE,MAAM,GAAG;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAEnE;;WAEG;QACH,IAAI,EAAE,OAAO,CAAC;KACf;CACF;AAED,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC;IAC1B,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,KAAK,iBAAiB,IAAI,iBAAiB,EAAE,CAAC;CACzG"}

package/resources/ai/typesafe/v1.d.ts

@@ -0,0 +1,285 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Beta API for evaluating shared context with typed questions and structured answers using Flash or Pro.
+ */
+export declare class V1 extends APIResource {
+    /**
+     * **Beta API.** Choose telnyx/decision-flash for the lowest cost and latency, or
+     * telnyx/decision-pro for decisions that require long context, including inputs
+     * beyond Jev’s 32k per-decision limit. Omitted model defaults to
+     * telnyx/decision-flash.
+     *
+     * Evaluate shared context using named choice, noul (yes/no), and score questions.
+     * Returns TypeSafe System One-compatible answer shapes, the selected public model
+     * alias, and token usage. See the
+     * [decision model guide](https://developers.telnyx.com/docs/inference/decision-models)
+     * for examples and compatibility limits.
+     *
+     * The supported request subset requires instructions for every question, string
+     * descriptions for criteria (or null for choice descriptions), 1–64 questions, and
+     * 2–64 options for choice and score questions. The model field accepts only
+     * telnyx/decision-flash or telnyx/decision-pro. Unsupported model values and
+     * unknown fields are rejected. The endpoint is synchronous and does not stream.
+     *
+     * Use the TypeSafe Python SDK with base_url set to
+     * https://api.telnyx.com/v2/ai/typesafe and a Telnyx API key. The SDK appends
+     * /v1/systemone; explicitly set model to a supported Telnyx alias because its own
+     * default model is not supported. Compatibility covers this operation and the
+     * documented request subset; it does not include TypeSafe model listing. Scores
+     * describe relative preference, not calibrated correctness.
+     *
+     * @example
+     * ```ts
+     * const response = await client.ai.typesafe.v1.systemone({
+     *   questions: {
+     *     team: {
+     *       type: 'choice',
+     *       instructions:
+     *         'Choose the team that should handle this incident.',
+     *       criteria: {
+     *         billing: 'Payments and refunds',
+     *         technical_support:
+     *           'Service faults and technical problems',
+     *         sales: 'New purchases',
+     *       },
+     *     },
+     *     production_incident: {
+     *       type: 'noul',
+     *       instructions:
+     *         'Does the message describe an active production incident?',
+     *     },
+     *     urgency: {
+     *       type: 'score',
+     *       instructions: 'Rate operational urgency.',
+     *       criteria: ['Low', 'Normal', 'High', 'Critical'],
+     *     },
+     *   },
+     *   state:
+     *     'Our production calls are failing. Every customer is affected.',
+     *   model: 'telnyx/decision-flash',
+     * });
+     * ```
+     */
+    systemone(body: V1SystemoneParams, options?: RequestOptions): APIPromise<V1SystemoneResponse>;
+}
+/**
+ * A complete synchronous evaluation. Answers are returned directly without a data
+ * wrapper.
+ */
+export interface V1SystemoneResponse {
+    /**
+     * Answers keyed by exactly the question IDs in the request. Each answer type
+     * matches its question.
+     */
+    answers: {
+        [key: string]: V1SystemoneResponse.DecisionModelChoiceAnswer | V1SystemoneResponse.DecisionModelNoulAnswer | V1SystemoneResponse.DecisionModelScoreAnswer;
+    };
+    /**
+     * Public model alias used to evaluate the request. Returns telnyx/decision-flash
+     * when model was omitted. The underlying model is managed by Telnyx.
+     */
+    model: 'telnyx/decision-flash' | 'telnyx/decision-pro';
+    /**
+     * Token usage for the completed evaluation.
+     */
+    usage: V1SystemoneResponse.Usage;
+}
+export declare namespace V1SystemoneResponse {
+    /**
+     * A selected option and the distribution across all supplied option keys.
+     */
+    interface DecisionModelChoiceAnswer {
+        /**
+         * The option key with the highest relative score. Ties favor the first option in
+         * request order.
+         */
+        choice: string;
+        /**
+         * Normalized entropy confidence: 1 - H(p) / ln(N), where H(p) = -sum(p \* ln(p))
+         * and N is the number of options. Zero indicates a uniform distribution; one
+         * indicates concentration on one option. This is neither the winning probability
+         * nor calibrated correctness.
+         */
+        confidence: number;
+        /**
+         * Relative scores normalized across the supplied options, summing approximately
+         * to 1. These are not calibrated probabilities of correctness.
+         */
+        probabilities: {
+            [key: string]: number;
+        };
+        /**
+         * Answer type.
+         */
+        type: 'choice';
+    }
+    /**
+     * A yes/no score with no separate confidence or probabilities fields.
+     */
+    interface DecisionModelNoulAnswer {
+        /**
+         * Score of the positive outcome. Values near 1 favor yes; values near 0 favor no.
+         * This is a number, not a Boolean, and is not calibrated correctness.
+         */
+        noul: number;
+        /**
+         * Answer type.
+         */
+        type: 'noul';
+    }
+    /**
+     * An expected rating over the ordered criteria.
+     */
+    interface DecisionModelScoreAnswer {
+        /**
+         * Normalized entropy confidence: 1 - H(p) / ln(N), where H(p) = -sum(p \* ln(p))
+         * and N is the number of options. Zero indicates a uniform distribution; one
+         * indicates concentration on one option. This is neither the winning probability
+         * nor calibrated correctness.
+         */
+        confidence: number;
+        /**
+         * Criterion descriptions keyed by stringified zero-based indices, such as "0",
+         * "1", and "2".
+         */
+        legend: {
+            [key: string]: string;
+        };
+        /**
+         * Relative scores keyed by the same stringified indices as legend.
+         */
+        probabilities: {
+            [key: string]: number;
+        };
+        /**
+         * Expected zero-based criterion index: sum(index \* probability). Ranges from 0 to
+         * N-1 for N criteria; fractional values are valid.
+         */
+        score: number;
+        /**
+         * Answer type.
+         */
+        type: 'score';
+    }
+    /**
+     * Token usage for the completed evaluation.
+     */
+    interface Usage {
+        /**
+         * Input tokens processed, including shared-context preparation and question
+         * evaluation. This can exceed the token count of the unique input text.
+         */
+        input_tokens: number;
+        /**
+         * Output tokens used for the evaluation, including shared-context preparation.
+         */
+        output_tokens: number;
+    }
+}
+export interface V1SystemoneParams {
+    /**
+     * Between 1 and 64 named questions. Each key identifies the corresponding answer.
+     */
+    questions: {
+        [key: string]: V1SystemoneParams.DecisionModelChoiceQuestion | V1SystemoneParams.DecisionModelNoulQuestion | V1SystemoneParams.DecisionModelScoreQuestion;
+    };
+    /**
+     * Shared context evaluated by every question.
+     */
+    state: string | {
+        [key: string]: unknown;
+    } | Array<unknown>;
+    /**
+     * Public model alias. telnyx/decision-flash offers the lowest cost and latency;
+     * telnyx/decision-pro supports decisions that require long context, including
+     * inputs beyond Jev’s 32k per-decision limit. Applies to every question in the
+     * request. Other values are rejected.
+     */
+    model?: 'telnyx/decision-flash' | 'telnyx/decision-pro';
+}
+export declare namespace V1SystemoneParams {
+    /**
+     * Select one of the supplied options.
+     */
+    interface DecisionModelChoiceQuestion {
+        /**
+         * Between 2 and 64 option keys mapped to description strings or null. A null
+         * description uses the option key as its text.
+         */
+        criteria: {
+            [key: string]: string | null;
+        };
+        /**
+         * Required instructions describing what to decide about the shared state.
+         */
+        instructions: string | {
+            [key: string]: unknown;
+        } | Array<unknown>;
+        /**
+         * Question type.
+         */
+        type: 'choice';
+    }
+    /**
+     * Evaluate a yes/no question. Omit criteria to use Yes and No descriptions.
+     */
+    interface DecisionModelNoulQuestion {
+        /**
+         * Required instructions describing what to decide about the shared state.
+         */
+        instructions: string | {
+            [key: string]: unknown;
+        } | Array<unknown>;
+        /**
+         * Question type.
+         */
+        type: 'noul';
+        /**
+         * Optional descriptions for the positive and negative outcomes. Descriptions must
+         * be strings.
+         */
+        criteria?: DecisionModelNoulQuestion.Criteria;
+    }
+    namespace DecisionModelNoulQuestion {
+        /**
+         * Optional descriptions for the positive and negative outcomes. Descriptions must
+         * be strings.
+         */
+        interface Criteria {
+            /**
+             * Description of the negative outcome.
+             */
+            false?: string;
+            /**
+             * Description of the positive outcome.
+             */
+            true?: string;
+        }
+    }
+    /**
+     * Rate the state against an ordered rubric.
+     */
+    interface DecisionModelScoreQuestion {
+        /**
+         * Between 2 and 64 description strings in ascending score order. Indices start at
+         * zero.
+         */
+        criteria: Array<string>;
+        /**
+         * Required instructions describing what to decide about the shared state.
+         */
+        instructions: string | {
+            [key: string]: unknown;
+        } | Array<unknown>;
+        /**
+         * Question type.
+         */
+        type: 'score';
+    }
+}
+export declare namespace V1 {
+    export { type V1SystemoneResponse as V1SystemoneResponse, type V1SystemoneParams as V1SystemoneParams };
+}
+//# sourceMappingURL=v1.d.ts.map

package/resources/ai/typesafe/v1.d.ts.map

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

package/resources/ai/typesafe/v1.js

@@ -0,0 +1,72 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V1 = void 0;
+const resource_1 = require("../../../core/resource.js");
+/**
+ * Beta API for evaluating shared context with typed questions and structured answers using Flash or Pro.
+ */
+class V1 extends resource_1.APIResource {
+    /**
+     * **Beta API.** Choose telnyx/decision-flash for the lowest cost and latency, or
+     * telnyx/decision-pro for decisions that require long context, including inputs
+     * beyond Jev’s 32k per-decision limit. Omitted model defaults to
+     * telnyx/decision-flash.
+     *
+     * Evaluate shared context using named choice, noul (yes/no), and score questions.
+     * Returns TypeSafe System One-compatible answer shapes, the selected public model
+     * alias, and token usage. See the
+     * [decision model guide](https://developers.telnyx.com/docs/inference/decision-models)
+     * for examples and compatibility limits.
+     *
+     * The supported request subset requires instructions for every question, string
+     * descriptions for criteria (or null for choice descriptions), 1–64 questions, and
+     * 2–64 options for choice and score questions. The model field accepts only
+     * telnyx/decision-flash or telnyx/decision-pro. Unsupported model values and
+     * unknown fields are rejected. The endpoint is synchronous and does not stream.
+     *
+     * Use the TypeSafe Python SDK with base_url set to
+     * https://api.telnyx.com/v2/ai/typesafe and a Telnyx API key. The SDK appends
+     * /v1/systemone; explicitly set model to a supported Telnyx alias because its own
+     * default model is not supported. Compatibility covers this operation and the
+     * documented request subset; it does not include TypeSafe model listing. Scores
+     * describe relative preference, not calibrated correctness.
+     *
+     * @example
+     * ```ts
+     * const response = await client.ai.typesafe.v1.systemone({
+     *   questions: {
+     *     team: {
+     *       type: 'choice',
+     *       instructions:
+     *         'Choose the team that should handle this incident.',
+     *       criteria: {
+     *         billing: 'Payments and refunds',
+     *         technical_support:
+     *           'Service faults and technical problems',
+     *         sales: 'New purchases',
+     *       },
+     *     },
+     *     production_incident: {
+     *       type: 'noul',
+     *       instructions:
+     *         'Does the message describe an active production incident?',
+     *     },
+     *     urgency: {
+     *       type: 'score',
+     *       instructions: 'Rate operational urgency.',
+     *       criteria: ['Low', 'Normal', 'High', 'Critical'],
+     *     },
+     *   },
+     *   state:
+     *     'Our production calls are failing. Every customer is affected.',
+     *   model: 'telnyx/decision-flash',
+     * });
+     * ```
+     */
+    systemone(body, options) {
+        return this._client.post('/ai/typesafe/v1/systemone', { body, ...options });
+    }
+}
+exports.V1 = V1;
+//# sourceMappingURL=v1.js.map

package/resources/ai/typesafe/v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.js","sourceRoot":"","sources":["../../../src/resources/ai/typesafe/v1.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAIrD;;GAEG;AACH,MAAa,EAAG,SAAQ,sBAAW;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,SAAS,CAAC,IAAuB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF;AA7DD,gBA6DC"}