telnyx 7.22.0 → 7.23.0

package/resources/ai/typesafe/v1.mjs

@@ -0,0 +1,63 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+/**
+ * Beta API for evaluating shared context with typed questions and structured answers. Telnyx manages model selection.
+ */
+export class V1 extends APIResource {
+    /**
+     * **Beta API.** Telnyx controls model selection.
+     *
+     * Evaluate shared context using named choice, noul (yes/no), and score questions.
+     * Returns TypeSafe System One-compatible answer shapes, an opaque compatibility
+     * identifier, 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 SDK-supplied model value is
+     * ignored and cannot select a model. Other 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. 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.',
+     * });
+     * ```
+     */
+    systemone(body, options) {
+        return this._client.post('/ai/typesafe/v1/systemone', { body, ...options });
+    }
+}
+//# sourceMappingURL=v1.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v1.mjs","sourceRoot":"","sources":["../../../src/resources/ai/typesafe/v1.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAIrD;;GAEG;AACH,MAAM,OAAO,EAAG,SAAQ,WAAW;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;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"}

package/resources/ai/typesafe.d.mts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"typesafe.d.mts","sourceRoot":"","sources":["../../src/resources/ai/typesafe.ts"],"names":[],"mappings":"AAEA,qCAAiC"}

package/resources/ai/typesafe.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"typesafe.d.ts","sourceRoot":"","sources":["../../src/resources/ai/typesafe.ts"],"names":[],"mappings":"AAEA,oCAAiC"}

package/resources/ai/typesafe.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("./typesafe/index.js"), exports);
+//# sourceMappingURL=typesafe.js.map

package/resources/ai/typesafe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesafe.js","sourceRoot":"","sources":["../../src/resources/ai/typesafe.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAAiC"}

package/resources/ai/typesafe.mjs

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

package/resources/ai/typesafe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesafe.mjs","sourceRoot":"","sources":["../../src/resources/ai/typesafe.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,qCAAiC"}

package/resources/bot-challenge.d.mts

@@ -0,0 +1,80 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+export declare class BotChallenge extends APIResource {
+    /**
+     * Generates a reverse-CAPTCHA challenge used to gate the bot signup flow. A random
+     * active problem is selected from the pool; math problems are returned obfuscated
+     * (case randomization, symbol injection, spacing noise) with an unobfuscated
+     * rounding instruction appended, while string and binary problems are returned
+     * as-is. The response contains a single-use nonce, the problem text, and the
+     * current terms-and-conditions and privacy-policy URLs, which must be echoed back
+     * on the signup request. Challenges expire after a short window (10 minutes by
+     * default) and can only be answered once. This endpoint is public and
+     * unauthenticated.
+     *
+     * @example
+     * ```ts
+     * const botChallenge = await client.botChallenge.create({
+     *   llm_model_name: 'claude-opus-4',
+     *   llm_parameter_count: '175B',
+     *   llm_quantization: 'int8',
+     * });
+     * ```
+     */
+    create(body?: BotChallengeCreateParams | null | undefined, options?: RequestOptions): APIPromise<BotChallengeCreateResponse>;
+}
+export interface BotChallengeCreateResponse {
+    data: BotChallengeCreateResponse.Data;
+}
+export declare namespace BotChallengeCreateResponse {
+    interface Data {
+        /**
+         * Type of challenge.
+         */
+        challenge_type: 'math' | 'string' | 'binary';
+        /**
+         * Single-use challenge identifier. Submit it as `bot_challenge_nonce` on the
+         * signup request.
+         */
+        nonce: string;
+        /**
+         * Current privacy-policy URL. Echo this back on the signup request.
+         */
+        privacy_policy_url: string;
+        /**
+         * Problem text to solve. Math problems are obfuscated and end with an unobfuscated
+         * rounding instruction; string and binary problems are returned as-is.
+         */
+        problem: string;
+        /**
+         * Current terms-and-conditions URL. Echo this back on the signup request.
+         */
+        terms_and_conditions_url: string;
+        /**
+         * Decimal places expected in the answer. Present only for math challenges.
+         */
+        precision?: number;
+    }
+}
+export interface BotChallengeCreateParams {
+    /**
+     * Name of the LLM the client is using.
+     */
+    llm_model_name?: string;
+    /**
+     * Parameter count of the client LLM.
+     */
+    llm_parameter_count?: string;
+    /**
+     * Quantization of the client LLM.
+     */
+    llm_quantization?: string;
+}
+export declare namespace BotChallenge {
+    export { type BotChallengeCreateResponse as BotChallengeCreateResponse, type BotChallengeCreateParams as BotChallengeCreateParams, };
+}
+//# sourceMappingURL=bot-challenge.d.mts.map

package/resources/bot-challenge.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-challenge.d.mts","sourceRoot":"","sources":["../src/resources/bot-challenge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAE7D;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACJ,IAAI,GAAE,wBAAwB,GAAG,IAAI,GAAG,SAAc,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,0BAA0B,CAAC;CAG1C;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,0BAA0B,CAAC,IAAI,CAAC;CACvC;AAED,yBAAiB,0BAA0B,CAAC;IAC1C,UAAiB,IAAI;QACnB;;WAEG;QACH,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAE7C;;;WAGG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,kBAAkB,EAAE,MAAM,CAAC;QAE3B;;;WAGG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,wBAAwB,EAAE,MAAM,CAAC;QAEjC;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/bot-challenge.d.ts

@@ -0,0 +1,80 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+export declare class BotChallenge extends APIResource {
+    /**
+     * Generates a reverse-CAPTCHA challenge used to gate the bot signup flow. A random
+     * active problem is selected from the pool; math problems are returned obfuscated
+     * (case randomization, symbol injection, spacing noise) with an unobfuscated
+     * rounding instruction appended, while string and binary problems are returned
+     * as-is. The response contains a single-use nonce, the problem text, and the
+     * current terms-and-conditions and privacy-policy URLs, which must be echoed back
+     * on the signup request. Challenges expire after a short window (10 minutes by
+     * default) and can only be answered once. This endpoint is public and
+     * unauthenticated.
+     *
+     * @example
+     * ```ts
+     * const botChallenge = await client.botChallenge.create({
+     *   llm_model_name: 'claude-opus-4',
+     *   llm_parameter_count: '175B',
+     *   llm_quantization: 'int8',
+     * });
+     * ```
+     */
+    create(body?: BotChallengeCreateParams | null | undefined, options?: RequestOptions): APIPromise<BotChallengeCreateResponse>;
+}
+export interface BotChallengeCreateResponse {
+    data: BotChallengeCreateResponse.Data;
+}
+export declare namespace BotChallengeCreateResponse {
+    interface Data {
+        /**
+         * Type of challenge.
+         */
+        challenge_type: 'math' | 'string' | 'binary';
+        /**
+         * Single-use challenge identifier. Submit it as `bot_challenge_nonce` on the
+         * signup request.
+         */
+        nonce: string;
+        /**
+         * Current privacy-policy URL. Echo this back on the signup request.
+         */
+        privacy_policy_url: string;
+        /**
+         * Problem text to solve. Math problems are obfuscated and end with an unobfuscated
+         * rounding instruction; string and binary problems are returned as-is.
+         */
+        problem: string;
+        /**
+         * Current terms-and-conditions URL. Echo this back on the signup request.
+         */
+        terms_and_conditions_url: string;
+        /**
+         * Decimal places expected in the answer. Present only for math challenges.
+         */
+        precision?: number;
+    }
+}
+export interface BotChallengeCreateParams {
+    /**
+     * Name of the LLM the client is using.
+     */
+    llm_model_name?: string;
+    /**
+     * Parameter count of the client LLM.
+     */
+    llm_parameter_count?: string;
+    /**
+     * Quantization of the client LLM.
+     */
+    llm_quantization?: string;
+}
+export declare namespace BotChallenge {
+    export { type BotChallengeCreateResponse as BotChallengeCreateResponse, type BotChallengeCreateParams as BotChallengeCreateParams, };
+}
+//# sourceMappingURL=bot-challenge.d.ts.map

package/resources/bot-challenge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-challenge.d.ts","sourceRoot":"","sources":["../src/resources/bot-challenge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAE7D;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACJ,IAAI,GAAE,wBAAwB,GAAG,IAAI,GAAG,SAAc,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,0BAA0B,CAAC;CAG1C;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,0BAA0B,CAAC,IAAI,CAAC;CACvC;AAED,yBAAiB,0BAA0B,CAAC;IAC1C,UAAiB,IAAI;QACnB;;WAEG;QACH,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAE7C;;;WAGG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,kBAAkB,EAAE,MAAM,CAAC;QAE3B;;;WAGG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,wBAAwB,EAAE,MAAM,CAAC;QAEjC;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/bot-challenge.js

@@ -0,0 +1,35 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotChallenge = void 0;
+const resource_1 = require("../core/resource.js");
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+class BotChallenge extends resource_1.APIResource {
+    /**
+     * Generates a reverse-CAPTCHA challenge used to gate the bot signup flow. A random
+     * active problem is selected from the pool; math problems are returned obfuscated
+     * (case randomization, symbol injection, spacing noise) with an unobfuscated
+     * rounding instruction appended, while string and binary problems are returned
+     * as-is. The response contains a single-use nonce, the problem text, and the
+     * current terms-and-conditions and privacy-policy URLs, which must be echoed back
+     * on the signup request. Challenges expire after a short window (10 minutes by
+     * default) and can only be answered once. This endpoint is public and
+     * unauthenticated.
+     *
+     * @example
+     * ```ts
+     * const botChallenge = await client.botChallenge.create({
+     *   llm_model_name: 'claude-opus-4',
+     *   llm_parameter_count: '175B',
+     *   llm_quantization: 'int8',
+     * });
+     * ```
+     */
+    create(body = {}, options) {
+        return this._client.post('/v2/bot_challenge', { body, ...options });
+    }
+}
+exports.BotChallenge = BotChallenge;
+//# sourceMappingURL=bot-challenge.js.map

package/resources/bot-challenge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-challenge.js","sourceRoot":"","sources":["../src/resources/bot-challenge.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C;;GAEG;AACH,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACJ,OAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AA3BD,oCA2BC"}

package/resources/bot-challenge.mjs

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+export class BotChallenge extends APIResource {
+    /**
+     * Generates a reverse-CAPTCHA challenge used to gate the bot signup flow. A random
+     * active problem is selected from the pool; math problems are returned obfuscated
+     * (case randomization, symbol injection, spacing noise) with an unobfuscated
+     * rounding instruction appended, while string and binary problems are returned
+     * as-is. The response contains a single-use nonce, the problem text, and the
+     * current terms-and-conditions and privacy-policy URLs, which must be echoed back
+     * on the signup request. Challenges expire after a short window (10 minutes by
+     * default) and can only be answered once. This endpoint is public and
+     * unauthenticated.
+     *
+     * @example
+     * ```ts
+     * const botChallenge = await client.botChallenge.create({
+     *   llm_model_name: 'claude-opus-4',
+     *   llm_parameter_count: '175B',
+     *   llm_quantization: 'int8',
+     * });
+     * ```
+     */
+    create(body = {}, options) {
+        return this._client.post('/v2/bot_challenge', { body, ...options });
+    }
+}
+//# sourceMappingURL=bot-challenge.mjs.map

package/resources/bot-challenge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-challenge.mjs","sourceRoot":"","sources":["../src/resources/bot-challenge.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACJ,OAAoD,EAAE,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}

package/resources/bot-sessions.d.mts

@@ -0,0 +1,49 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+export declare class BotSessions extends APIResource {
+    /**
+     * Consumes the one-time portal redirect (magic link) token emailed during bot
+     * signup and returns an API session. The token is a UUIDv7 that encodes its
+     * creation time; it expires after a configurable validity window (15 minutes by
+     * default) and is cleared on first use. Although the action creates a session, the
+     * route uses the GET verb because it is opened from an email link. On first use
+     * the account is also initialized. For bot signup (freemium) accounts the response
+     * is a minimal envelope containing only the `api_v2_token`; accounts that are
+     * permitted to use magic links but are not freemium accounts may instead receive
+     * an extended session payload when additional steps (such as two-factor
+     * authentication or identity verification) are required. This endpoint is public;
+     * the magic link token in the query string is the credential.
+     */
+    list(query: BotSessionListParams, options?: RequestOptions): APIPromise<BotSessionListResponse>;
+}
+export interface BotSessionListResponse {
+    data: BotSessionListResponse.Data;
+}
+export declare namespace BotSessionListResponse {
+    interface Data {
+        /**
+         * API v2 session token for the signed-in user. Use it as a bearer token on
+         * authenticated endpoints.
+         */
+        api_v2_token: string;
+    }
+}
+export interface BotSessionListParams {
+    /**
+     * Email address associated with the magic link token.
+     */
+    email: string;
+    /**
+     * Single-use portal redirect (magic link) token, a UUIDv7 sent to the account
+     * owner's email.
+     */
+    portal_redirect_token: string;
+}
+export declare namespace BotSessions {
+    export { type BotSessionListResponse as BotSessionListResponse, type BotSessionListParams as BotSessionListParams, };
+}
+//# sourceMappingURL=bot-sessions.d.mts.map

package/resources/bot-sessions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-sessions.d.mts","sourceRoot":"","sources":["../src/resources/bot-sessions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAE7D;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGhG;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;CACnC;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,IAAI;QACnB;;;WAGG;QACH,YAAY,EAAE,MAAM,CAAC;KACtB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/bot-sessions.d.ts

@@ -0,0 +1,49 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+export declare class BotSessions extends APIResource {
+    /**
+     * Consumes the one-time portal redirect (magic link) token emailed during bot
+     * signup and returns an API session. The token is a UUIDv7 that encodes its
+     * creation time; it expires after a configurable validity window (15 minutes by
+     * default) and is cleared on first use. Although the action creates a session, the
+     * route uses the GET verb because it is opened from an email link. On first use
+     * the account is also initialized. For bot signup (freemium) accounts the response
+     * is a minimal envelope containing only the `api_v2_token`; accounts that are
+     * permitted to use magic links but are not freemium accounts may instead receive
+     * an extended session payload when additional steps (such as two-factor
+     * authentication or identity verification) are required. This endpoint is public;
+     * the magic link token in the query string is the credential.
+     */
+    list(query: BotSessionListParams, options?: RequestOptions): APIPromise<BotSessionListResponse>;
+}
+export interface BotSessionListResponse {
+    data: BotSessionListResponse.Data;
+}
+export declare namespace BotSessionListResponse {
+    interface Data {
+        /**
+         * API v2 session token for the signed-in user. Use it as a bearer token on
+         * authenticated endpoints.
+         */
+        api_v2_token: string;
+    }
+}
+export interface BotSessionListParams {
+    /**
+     * Email address associated with the magic link token.
+     */
+    email: string;
+    /**
+     * Single-use portal redirect (magic link) token, a UUIDv7 sent to the account
+     * owner's email.
+     */
+    portal_redirect_token: string;
+}
+export declare namespace BotSessions {
+    export { type BotSessionListResponse as BotSessionListResponse, type BotSessionListParams as BotSessionListParams, };
+}
+//# sourceMappingURL=bot-sessions.d.ts.map

package/resources/bot-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-sessions.d.ts","sourceRoot":"","sources":["../src/resources/bot-sessions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAE7D;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGhG;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;CACnC;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,IAAI;QACnB;;;WAGG;QACH,YAAY,EAAE,MAAM,CAAC;KACtB;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/bot-sessions.js

@@ -0,0 +1,28 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotSessions = void 0;
+const resource_1 = require("../core/resource.js");
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+class BotSessions extends resource_1.APIResource {
+    /**
+     * Consumes the one-time portal redirect (magic link) token emailed during bot
+     * signup and returns an API session. The token is a UUIDv7 that encodes its
+     * creation time; it expires after a configurable validity window (15 minutes by
+     * default) and is cleared on first use. Although the action creates a session, the
+     * route uses the GET verb because it is opened from an email link. On first use
+     * the account is also initialized. For bot signup (freemium) accounts the response
+     * is a minimal envelope containing only the `api_v2_token`; accounts that are
+     * permitted to use magic links but are not freemium accounts may instead receive
+     * an extended session payload when additional steps (such as two-factor
+     * authentication or identity verification) are required. This endpoint is public;
+     * the magic link token in the query string is the credential.
+     */
+    list(query, options) {
+        return this._client.get('/v2/bot_sessions', { query, ...options });
+    }
+}
+exports.BotSessions = BotSessions;
+//# sourceMappingURL=bot-sessions.js.map

package/resources/bot-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-sessions.js","sourceRoot":"","sources":["../src/resources/bot-sessions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C;;GAEG;AACH,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,KAA2B,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AAjBD,kCAiBC"}

package/resources/bot-sessions.mjs

@@ -0,0 +1,24 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+export class BotSessions extends APIResource {
+    /**
+     * Consumes the one-time portal redirect (magic link) token emailed during bot
+     * signup and returns an API session. The token is a UUIDv7 that encodes its
+     * creation time; it expires after a configurable validity window (15 minutes by
+     * default) and is cleared on first use. Although the action creates a session, the
+     * route uses the GET verb because it is opened from an email link. On first use
+     * the account is also initialized. For bot signup (freemium) accounts the response
+     * is a minimal envelope containing only the `api_v2_token`; accounts that are
+     * permitted to use magic links but are not freemium accounts may instead receive
+     * an extended session payload when additional steps (such as two-factor
+     * authentication or identity verification) are required. This endpoint is public;
+     * the magic link token in the query string is the credential.
+     */
+    list(query, options) {
+        return this._client.get('/v2/bot_sessions', { query, ...options });
+    }
+}
+//# sourceMappingURL=bot-sessions.mjs.map

package/resources/bot-sessions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-sessions.mjs","sourceRoot":"","sources":["../src/resources/bot-sessions.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,KAA2B,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;CACF"}

package/resources/bot-signup.d.mts

@@ -0,0 +1,114 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA challenge designed to be easy for LLMs and hard for humans, registers an account, and signs in by consuming a magic link emailed to the account owner. All endpoints are public and unauthenticated; signup endpoints are additionally gated by the freemium feature flags and per-country availability.
+ */
+export declare class BotSignup extends APIResource {
+    /**
+     * Creates a freemium Telnyx account through the agentic signup flow. The request
+     * must carry a valid answer to a previously issued bot challenge
+     * (`bot_challenge_nonce` and `bot_challenge_answer`), accept the terms of service,
+     * and echo the exact terms-and-conditions and privacy-policy URLs returned by the
+     * challenge endpoint. When EU consent enforcement is enabled,
+     * `terms_of_service_eu` and `terms_and_conditions_eu_url` are also required. On
+     * success a one-time sign-in (magic) link is emailed to the address provided; if
+     * the email address belongs to an existing account, a sign-in link is sent instead
+     * of creating a duplicate account. `email` may only be omitted when
+     * placeholder-email registration is enabled server-side. This endpoint is public
+     * and unauthenticated, gated by the freemium feature flags and per-country
+     * availability, and subject to per-IP and per-domain registration limits.
+     *
+     * @example
+     * ```ts
+     * const successResponse = await client.botSignup.create({
+     *   bot_challenge_answer: '35',
+     *   bot_challenge_nonce:
+     *     'c6feda4e-6501-4db9-a21f-665e5b4ce2ba',
+     *   privacy_policy_url: 'https://telnyx.com/privacy-policy',
+     *   terms_and_conditions_url:
+     *     'https://telnyx.com/terms-and-conditions-of-service',
+     *   terms_of_service: true,
+     *   email: 'agent-owner@example.com',
+     * });
+     * ```
+     */
+    create(body: BotSignupCreateParams, options?: RequestOptions): APIPromise<SuccessResponse>;
+    /**
+     * Resends the one-time sign-in (magic) link for an eligible bot signup account.
+     * Eligibility (account exists, was registered through bot signup, is active, and
+     * has not exceeded the resend limit or rate window) is evaluated server-side; the
+     * response is intentionally uniform and does not reveal whether the account exists
+     * or whether a link was actually sent. This endpoint is public and
+     * unauthenticated, gated by the freemium feature flags and per-country
+     * availability.
+     *
+     * @example
+     * ```ts
+     * const successResponse =
+     *   await client.botSignup.resendMagicLink({
+     *     email: 'agent-owner@example.com',
+     *   });
+     * ```
+     */
+    resendMagicLink(body: BotSignupResendMagicLinkParams, options?: RequestOptions): APIPromise<SuccessResponse>;
+}
+/**
+ * Status envelope used by the signup and magic-link flows.
+ */
+export interface SuccessResponse {
+    /**
+     * Human-readable status message.
+     */
+    message: string;
+    /**
+     * Whether the request was accepted.
+     */
+    success: boolean;
+}
+export interface BotSignupCreateParams {
+    /**
+     * Answer to the issued bot challenge.
+     */
+    bot_challenge_answer: string;
+    /**
+     * Nonce from a previously issued bot challenge.
+     */
+    bot_challenge_nonce: string;
+    /**
+     * Must exactly match the privacy-policy URL returned by the challenge endpoint.
+     */
+    privacy_policy_url: string;
+    /**
+     * Must exactly match the terms-and-conditions URL returned by the challenge
+     * endpoint.
+     */
+    terms_and_conditions_url: string;
+    /**
+     * Must be true to accept the terms of service.
+     */
+    terms_of_service: true;
+    /**
+     * Email address for the new account. The magic link is sent here. May only be
+     * omitted when placeholder-email registration is enabled server-side.
+     */
+    email?: string;
+    /**
+     * EU terms-and-conditions URL. Required when EU consent enforcement is enabled.
+     */
+    terms_and_conditions_eu_url?: string;
+    /**
+     * EU terms-of-service acceptance. Required when EU consent enforcement is enabled.
+     */
+    terms_of_service_eu?: true;
+}
+export interface BotSignupResendMagicLinkParams {
+    /**
+     * Email address of the bot signup account to resend the magic link to.
+     */
+    email: string;
+}
+export declare namespace BotSignup {
+    export { type SuccessResponse as SuccessResponse, type BotSignupCreateParams as BotSignupCreateParams, type BotSignupResendMagicLinkParams as BotSignupResendMagicLinkParams, };
+}
+//# sourceMappingURL=bot-signup.d.mts.map

package/resources/bot-signup.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-signup.d.mts","sourceRoot":"","sources":["../src/resources/bot-signup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAE7D;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,eAAe,CAAC;IAI1F;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CACb,IAAI,EAAE,8BAA8B,EACpC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,eAAe,CAAC;CAG/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,gBAAgB,EAAE,IAAI,CAAC;IAEvB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,mBAAmB,CAAC,EAAE,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,8BAA8B,IAAI,8BAA8B,GACtE,CAAC;CACH"}