telnyx 7.23.0 → 7.25.0

package/src/resources/ai/memory/namespaces/profiles/sources.ts

@@ -0,0 +1,226 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../../core/resource';
+import * as SourcesAPI from '../../../collections/sources';
+import { SourcesDefaultFlatPagination } from '../../../collections/sources';
+import { APIPromise } from '../../../../../core/api-promise';
+import {
+  DefaultFlatPagination,
+  type DefaultFlatPaginationParams,
+  PagePromise,
+} from '../../../../../core/pagination';
+import { RequestOptions } from '../../../../../internal/request-options';
+import { path } from '../../../../../internal/utils/path';
+
+/**
+ * What a profile stored, and what its memories came from.
+ */
+export class Sources extends APIResource {
+  /**
+   * Everything a profile has stored and extracts memories from: each ingested
+   * session, and each remembered fact, which has no session. Content is not listed;
+   * read one source for it. A source whose ingest is still queued is not here yet.
+   * Re-ingesting a session moves it to the front, so a listing paged while sessions
+   * are written can repeat or miss one at a page boundary. A `session_id` narrows
+   * the listing to the source that session was stored as: one source or none, and
+   * none -- an empty page, not a 404 -- for a session never ingested, still queued,
+   * or another profile's.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const source of client.ai.memory.namespaces.profiles.sources.list(
+   *   'profile_id',
+   *   { namespace: 'namespace' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    profileID: string,
+    params: SourceListParams,
+    options?: RequestOptions,
+  ): PagePromise<SourcesDefaultFlatPagination, SourcesAPI.Source> {
+    const { namespace, ...query } = params;
+    return this._client.getAPIList(
+      path`/ai/memory/namespaces/${namespace}/profiles/${profileID}/sources`,
+      DefaultFlatPagination<SourcesAPI.Source>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Deletes one source -- an ingested session or a remembered fact -- together with
+   * the memories derived from it. A memory derived from this source and others is
+   * deleted too, and derived again from what remains in the background. It answers
+   * only once the source is gone. A source that is not there -- never stored,
+   * another profile's, or already deleted -- answers 404, so on a `502` or a `504`
+   * repeat the identical request and read a 404 as done. An ingest of the same
+   * session that is still queued is not cancelled, and stores the session again when
+   * it runs. Nothing here can be undone.
+   *
+   * @example
+   * ```ts
+   * const source =
+   *   await client.ai.memory.namespaces.profiles.sources.delete(
+   *     'source_id',
+   *     { namespace: 'namespace', profile_id: 'profile_id' },
+   *   );
+   * ```
+   */
+  delete(
+    sourceID: string,
+    params: SourceDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<SourceDeleteResponse> {
+    const { namespace, profile_id } = params;
+    return this._client.delete(
+      path`/ai/memory/namespaces/${namespace}/profiles/${profile_id}/sources/${sourceID}`,
+      options,
+    );
+  }
+
+  /**
+   * One source and its content, as it was stored: an ingested session's payload or a
+   * remembered fact. A source whose ingest is still queued answers 404 until it has
+   * been stored.
+   *
+   * @example
+   * ```ts
+   * const source =
+   *   await client.ai.memory.namespaces.profiles.sources.retrieve(
+   *     'source_id',
+   *     { namespace: 'namespace', profile_id: 'profile_id' },
+   *   );
+   * ```
+   */
+  retrieve(
+    sourceID: string,
+    params: SourceRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<SourceRetrieveResponse> {
+    const { namespace, profile_id } = params;
+    return this._client.get(
+      path`/ai/memory/namespaces/${namespace}/profiles/${profile_id}/sources/${sourceID}`,
+      options,
+    );
+  }
+}
+
+export interface SourceRetrieveResponse {
+  data: SourceRetrieveResponse.Data;
+}
+
+export namespace SourceRetrieveResponse {
+  export interface Data {
+    /**
+     * Identifies one source within its profile: an ingested session, or one remembered
+     * fact. Returned by `ingest` and `remember` when the write is accepted.
+     * Re-ingesting a session keeps its source id.
+     */
+    id: string;
+
+    /**
+     * What was stored, in the shape it was sent: an ingested JSON body as JSON, a
+     * string body or a remembered fact as a string. A session ingested before formats
+     * were recorded is returned as the text it was stored as.
+     */
+    content: { [key: string]: unknown } | Array<unknown> | string | number | boolean;
+
+    /**
+     * Memories extracted from this source. A memory derived from several sources is
+     * not counted here.
+     */
+    memory_count: number;
+
+    /**
+     * The session this source was ingested as. Null for a remembered fact.
+     */
+    session_id: string | null;
+
+    /**
+     * When the source was first stored.
+     */
+    created_at?: string | null;
+
+    /**
+     * When the source was last written; re-ingesting moves it.
+     */
+    updated_at?: string | null;
+  }
+}
+
+export interface SourceDeleteResponse {
+  data: SourceDeleteResponse.Data;
+}
+
+export namespace SourceDeleteResponse {
+  export interface Data {
+    /**
+     * Memories the profile held and no longer does, counted before and after across
+     * the whole profile: it includes memories derived from this source together with
+     * others, and anything else the profile lost in between. A report rather than an
+     * audit. The status carries the outcome.
+     */
+    memories_deleted: number;
+
+    profile_id: string;
+
+    /**
+     * Identifies one source within its profile: an ingested session, or one remembered
+     * fact. Returned by `ingest` and `remember` when the write is accepted.
+     * Re-ingesting a session keeps its source id.
+     */
+    source_id: string;
+  }
+}
+
+export interface SourceListParams extends DefaultFlatPaginationParams {
+  /**
+   * Path param
+   */
+  namespace: string;
+
+  /**
+   * Query param: An ingested session, by the `session_id` it was ingested with.
+   * Narrows the request to the source that session was stored as.
+   */
+  session_id?: string | null;
+}
+
+export interface SourceDeleteParams {
+  /**
+   * The namespace. `default` exists for every organization.
+   */
+  namespace: string;
+
+  /**
+   * The profile: your identifier for the user, caller or agent this memory is about.
+   */
+  profile_id: string;
+}
+
+export interface SourceRetrieveParams {
+  /**
+   * The namespace. `default` exists for every organization.
+   */
+  namespace: string;
+
+  /**
+   * The profile: your identifier for the user, caller or agent this memory is about.
+   */
+  profile_id: string;
+}
+
+export declare namespace Sources {
+  export {
+    type SourceRetrieveResponse as SourceRetrieveResponse,
+    type SourceDeleteResponse as SourceDeleteResponse,
+    type SourceListParams as SourceListParams,
+    type SourceDeleteParams as SourceDeleteParams,
+    type SourceRetrieveParams as SourceRetrieveParams,
+  };
+}
+
+export { type SourcesDefaultFlatPagination };

package/src/resources/ai/memory/namespaces/profiles.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './profiles/index';

package/src/resources/ai/memory/namespaces/settings.ts

@@ -0,0 +1,129 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../core/resource';
+import { APIPromise } from '../../../../core/api-promise';
+import { RequestOptions } from '../../../../internal/request-options';
+import { path } from '../../../../internal/utils/path';
+
+/**
+ * How a namespace's summaries are written.
+ */
+export class Settings extends APIResource {
+  /**
+   * What is currently set for this namespace. `instructions: null` means none are
+   * set and summaries use the neutral default.
+   *
+   * @example
+   * ```ts
+   * const namespaceSettingsResponse =
+   *   await client.ai.memory.namespaces.settings.list(
+   *     'namespace',
+   *   );
+   * ```
+   */
+  list(namespace: string, options?: RequestOptions): APIPromise<NamespaceSettingsResponse> {
+    return this._client.get(path`/ai/memory/namespaces/${namespace}/settings`, options);
+  }
+
+  /**
+   * Only the fields you send are changed; anything omitted is left as it is, so `{}`
+   * changes nothing. Sending `instructions: null`, or an empty or whitespace-only
+   * string, clears them and returns summaries to the neutral default.
+   *
+   * Instructions are capped at 2000 characters. A longer note is refused rather than
+   * truncated, because a note cut mid-sentence is a worse steer than none. A change
+   * reaches each summary the next time that summary is regenerated, not immediately.
+   *
+   * @example
+   * ```ts
+   * const namespaceSettingsResponse =
+   *   await client.ai.memory.namespaces.settings.patchAll(
+   *     'namespace',
+   *     {
+   *       summary: {
+   *         instructions:
+   *           "Lead with the customer's plan tier. Keep it under 100 words.",
+   *       },
+   *     },
+   *   );
+   * ```
+   */
+  patchAll(
+    namespace: string,
+    body: SettingPatchAllParams,
+    options?: RequestOptions,
+  ): APIPromise<NamespaceSettingsResponse> {
+    return this._client.patch(path`/ai/memory/namespaces/${namespace}/settings`, { body, ...options });
+  }
+}
+
+export interface NamespaceSettingsResponse {
+  /**
+   * A namespace's settings, grouped by what they affect.
+   */
+  data: NamespaceSettingsResponse.Data;
+}
+
+export namespace NamespaceSettingsResponse {
+  /**
+   * A namespace's settings, grouped by what they affect.
+   */
+  export interface Data {
+    /**
+     * Settings that shape this namespace's summaries.
+     */
+    summary?: Data.Summary;
+  }
+
+  export namespace Data {
+    /**
+     * Settings that shape this namespace's summaries.
+     */
+    export interface Summary {
+      /**
+       * Free-form instructions that influence how this namespace's summaries are
+       * written, shared by every profile in the namespace. How you use them is up to you
+       * -- they steer the outcome, so try a phrasing and see how the summary comes out.
+       * Advisory: they steer the summary but never override or deny a profile's own
+       * facts, and they do not affect recall. Null or empty means none are set, and
+       * summaries use the neutral default. A change reaches each summary the next time
+       * it is regenerated.
+       */
+      instructions?: string | null;
+    }
+  }
+}
+
+export interface SettingPatchAllParams {
+  /**
+   * A partial update to a namespace's summary settings.
+   *
+   * Only the fields present in the request are changed; the rest are left as they
+   * are. Sending `instructions: null` (or empty) clears the instructions.
+   */
+  summary?: SettingPatchAllParams.Summary | null;
+}
+
+export namespace SettingPatchAllParams {
+  /**
+   * A partial update to a namespace's summary settings.
+   *
+   * Only the fields present in the request are changed; the rest are left as they
+   * are. Sending `instructions: null` (or empty) clears the instructions.
+   */
+  export interface Summary {
+    /**
+     * Replace the namespace's summary instructions. Null or empty clears them and
+     * returns to the neutral default. Omit the field to leave the current instructions
+     * unchanged.
+     */
+    instructions?: string | null;
+  }
+}
+
+export declare namespace Settings {
+  export {
+    type NamespaceSettingsResponse as NamespaceSettingsResponse,
+    type SettingPatchAllParams as SettingPatchAllParams,
+  };
+}

package/src/resources/ai/memory/namespaces.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './namespaces/index';

package/src/resources/ai/memory.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './memory/index';

package/src/resources/ai/openai/chat.ts

@@ -97,9 +97,14 @@ export interface ChatCreateCompletionParams {
   logprobs?: boolean;
 
   /**
-   * Maximum number of completion tokens the model should generate.
+   * Maximum number of completion (output) tokens the model may generate per request.
+   * Defaults to 8192 when omitted or `null`. Set a higher value to allow longer
+   * completions. The model's `max_completion_tokens` metadata (see
+   * `GET /ai/models`), when set, caps both the default and any larger explicit
+   * value. Reasoning models consume this budget across reasoning and answer tokens
+   * combined.
    */
-  max_tokens?: number;
+  max_tokens?: number | null;
 
   /**
    * This is an alternative to `top_p` that

package/src/resources/ai/tools.ts

@@ -60,11 +60,14 @@ export class Tools extends APIResource {
    *
    * @example
    * ```ts
-   * const tool = await client.ai.tools.delete('tool_id');
+   * await client.ai.tools.delete('tool_id');
    * ```
    */
-  delete(toolID: string, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.delete(path`/ai/tools/${toolID}`, options);
+  delete(toolID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/ai/tools/${toolID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
   }
 
   /**
@@ -181,8 +184,6 @@ export namespace UpdateDynamicVariablesToolParams {
   }
 }
 
-export type ToolDeleteResponse = unknown;
-
 export interface ToolListParams extends DefaultFlatPaginationParams {
   /**
    * Filter results by filter name.
@@ -300,7 +301,6 @@ export declare namespace Tools {
     type PayToolParams as PayToolParams,
     type SharedToolResponse as SharedToolResponse,
     type UpdateDynamicVariablesToolParams as UpdateDynamicVariablesToolParams,
-    type ToolDeleteResponse as ToolDeleteResponse,
     type SharedToolResponsesDefaultFlatPagination as SharedToolResponsesDefaultFlatPagination,
     type ToolListParams as ToolListParams,
     type ToolCreateParams as ToolCreateParams,

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

@@ -5,29 +5,33 @@ import { APIPromise } from '../../../core/api-promise';
 import { RequestOptions } from '../../../internal/request-options';
 
 /**
- * Beta API for evaluating shared context with typed questions and structured answers. Telnyx manages model selection.
+ * Beta API for evaluating shared context with typed questions and structured answers using Flash or Pro.
  */
 export class V1 extends APIResource {
   /**
-   * **Beta API.** Telnyx controls model selection.
+   * **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, an opaque compatibility
-   * identifier, and token usage. See the
+   * 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 SDK-supplied model value is
-   * ignored and cannot select a model. Other unknown fields are rejected. The
-   * endpoint is synchronous and does not stream.
+   * 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. Compatibility covers this operation and the documented request
-   * subset; it does not include TypeSafe model listing. Scores describe relative
-   * preference, not calibrated correctness.
+   * /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
@@ -57,6 +61,7 @@ export class V1 extends APIResource {
    *   },
    *   state:
    *     'Our production calls are failing. Every customer is affected.',
+   *   model: 'telnyx/decision-flash',
    * });
    * ```
    */
@@ -82,11 +87,10 @@ export interface V1SystemoneResponse {
   };
 
   /**
-   * Opaque Telnyx-controlled identifier retained for TypeSafe SDK response
-   * compatibility. It is not a selectable model name or a guarantee of a particular
-   * underlying model.
+   * Public model alias used to evaluate the request. Returns telnyx/decision-flash
+   * when model was omitted. The underlying model is managed by Telnyx.
    */
-  model: string;
+  model: 'telnyx/decision-flash' | 'telnyx/decision-pro';
 
   /**
    * Token usage for the completed evaluation.
@@ -208,6 +212,14 @@ export interface V1SystemoneParams {
    * 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 namespace V1SystemoneParams {