telnyx 7.23.0 → 7.25.0

package/resources/ai/memory/namespaces/profiles/sources.d.mts

@@ -0,0 +1,163 @@
+import { APIResource } from "../../../../../core/resource.mjs";
+import * as SourcesAPI from "../../../collections/sources.mjs";
+import { SourcesDefaultFlatPagination } from "../../../collections/sources.mjs";
+import { APIPromise } from "../../../../../core/api-promise.mjs";
+import { type DefaultFlatPaginationParams, PagePromise } from "../../../../../core/pagination.mjs";
+import { RequestOptions } from "../../../../../internal/request-options.mjs";
+/**
+ * What a profile stored, and what its memories came from.
+ */
+export declare 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+}
+export interface SourceRetrieveResponse {
+    data: SourceRetrieveResponse.Data;
+}
+export declare namespace SourceRetrieveResponse {
+    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 declare namespace SourceDeleteResponse {
+    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 };
+//# sourceMappingURL=sources.d.mts.map

package/resources/ai/memory/namespaces/profiles/sources.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.mts","sourceRoot":"","sources":["../../../../../src/resources/ai/memory/namespaces/profiles/sources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,yCAAqC;AAC3D,OAAO,KAAK,UAAU,yCAAqC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,yCAAqC;AAC5E,OAAO,EAAE,UAAU,EAAE,4CAAwC;AAC7D,OAAO,EAEL,KAAK,2BAA2B,EAChC,WAAW,EACZ,2CAAuC;AACxC,OAAO,EAAE,cAAc,EAAE,oDAAgD;AAGzE;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,4BAA4B,EAAE,UAAU,CAAC,MAAM,CAAC;IAS/D;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oBAAoB,CAAC;IAQnC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;CAOtC;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;CACnC;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,IAAI;QACnB;;;;WAIG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;;;WAIG;QACH,OAAO,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAEjF;;;WAGG;QACH,YAAY,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAE1B;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC;CACjC;AAED,yBAAiB,oBAAoB,CAAC;IACpC,UAAiB,IAAI;QACnB;;;;;WAKG;QACH,gBAAgB,EAAE,MAAM,CAAC;QAEzB,UAAU,EAAE,MAAM,CAAC;QAEnB;;;;WAIG;QACH,SAAS,EAAE,MAAM,CAAC;KACnB;CACF;AAED,MAAM,WAAW,gBAAiB,SAAQ,2BAA2B;IACnE;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH;AAED,OAAO,EAAE,KAAK,4BAA4B,EAAE,CAAC"}

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

@@ -0,0 +1,163 @@
+import { APIResource } from "../../../../../core/resource.js";
+import * as SourcesAPI from "../../../collections/sources.js";
+import { SourcesDefaultFlatPagination } from "../../../collections/sources.js";
+import { APIPromise } from "../../../../../core/api-promise.js";
+import { type DefaultFlatPaginationParams, PagePromise } from "../../../../../core/pagination.js";
+import { RequestOptions } from "../../../../../internal/request-options.js";
+/**
+ * What a profile stored, and what its memories came from.
+ */
+export declare 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+}
+export interface SourceRetrieveResponse {
+    data: SourceRetrieveResponse.Data;
+}
+export declare namespace SourceRetrieveResponse {
+    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 declare namespace SourceDeleteResponse {
+    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 };
+//# sourceMappingURL=sources.d.ts.map

package/resources/ai/memory/namespaces/profiles/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../../../../src/resources/ai/memory/namespaces/profiles/sources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,wCAAqC;AAC3D,OAAO,KAAK,UAAU,wCAAqC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,wCAAqC;AAC5E,OAAO,EAAE,UAAU,EAAE,2CAAwC;AAC7D,OAAO,EAEL,KAAK,2BAA2B,EAChC,WAAW,EACZ,0CAAuC;AACxC,OAAO,EAAE,cAAc,EAAE,mDAAgD;AAGzE;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,4BAA4B,EAAE,UAAU,CAAC,MAAM,CAAC;IAS/D;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oBAAoB,CAAC;IAQnC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;CAOtC;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;CACnC;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,IAAI;QACnB;;;;WAIG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;;;WAIG;QACH,OAAO,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAEjF;;;WAGG;QACH,YAAY,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAE1B;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC;CACjC;AAED,yBAAiB,oBAAoB,CAAC;IACpC,UAAiB,IAAI;QACnB;;;;;WAKG;QACH,gBAAgB,EAAE,MAAM,CAAC;QAEzB,UAAU,EAAE,MAAM,CAAC;QAEnB;;;;WAIG;QACH,SAAS,EAAE,MAAM,CAAC;KACnB;CACF;AAED,MAAM,WAAW,gBAAiB,SAAQ,2BAA2B;IACnE;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH;AAED,OAAO,EAAE,KAAK,4BAA4B,EAAE,CAAC"}

package/resources/ai/memory/namespaces/profiles/sources.js

@@ -0,0 +1,80 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sources = void 0;
+const resource_1 = require("../../../../../core/resource.js");
+const pagination_1 = require("../../../../../core/pagination.js");
+const path_1 = require("../../../../../internal/utils/path.js");
+/**
+ * What a profile stored, and what its memories came from.
+ */
+class Sources extends resource_1.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, params, options) {
+        const { namespace, ...query } = params;
+        return this._client.getAPIList((0, path_1.path) `/ai/memory/namespaces/${namespace}/profiles/${profileID}/sources`, (pagination_1.DefaultFlatPagination), { 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, params, options) {
+        const { namespace, profile_id } = params;
+        return this._client.delete((0, path_1.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, params, options) {
+        const { namespace, profile_id } = params;
+        return this._client.get((0, path_1.path) `/ai/memory/namespaces/${namespace}/profiles/${profile_id}/sources/${sourceID}`, options);
+    }
+}
+exports.Sources = Sources;
+//# sourceMappingURL=sources.js.map

package/resources/ai/memory/namespaces/profiles/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../../../../src/resources/ai/memory/namespaces/profiles/sources.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAA2D;AAI3D,kEAIwC;AAExC,gEAA0D;AAE1D;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CACF,SAAiB,EACjB,MAAwB,EACxB,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,yBAAyB,SAAS,aAAa,SAAS,UAAU,EACtE,CAAA,kCAAwC,CAAA,EACxC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CACxB,IAAA,WAAI,EAAA,yBAAyB,SAAS,aAAa,UAAU,YAAY,QAAQ,EAAE,EACnF,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,QAAgB,EAChB,MAA4B,EAC5B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CACrB,IAAA,WAAI,EAAA,yBAAyB,SAAS,aAAa,UAAU,YAAY,QAAQ,EAAE,EACnF,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AA3FD,0BA2FC"}

package/resources/ai/memory/namespaces/profiles/sources.mjs

@@ -0,0 +1,76 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../../../core/resource.mjs";
+import { DefaultFlatPagination, } from "../../../../../core/pagination.mjs";
+import { path } from "../../../../../internal/utils/path.mjs";
+/**
+ * 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, params, options) {
+        const { namespace, ...query } = params;
+        return this._client.getAPIList(path `/ai/memory/namespaces/${namespace}/profiles/${profileID}/sources`, (DefaultFlatPagination), { 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, params, options) {
+        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, params, options) {
+        const { namespace, profile_id } = params;
+        return this._client.get(path `/ai/memory/namespaces/${namespace}/profiles/${profile_id}/sources/${sourceID}`, options);
+    }
+}
+//# sourceMappingURL=sources.mjs.map

package/resources/ai/memory/namespaces/profiles/sources.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.mjs","sourceRoot":"","sources":["../../../../../src/resources/ai/memory/namespaces/profiles/sources.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,yCAAqC;AAI3D,OAAO,EACL,qBAAqB,GAGtB,2CAAuC;AAExC,OAAO,EAAE,IAAI,EAAE,+CAA2C;AAE1D;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CACF,SAAiB,EACjB,MAAwB,EACxB,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,yBAAyB,SAAS,aAAa,SAAS,UAAU,EACtE,CAAA,qBAAwC,CAAA,EACxC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CACxB,IAAI,CAAA,yBAAyB,SAAS,aAAa,UAAU,YAAY,QAAQ,EAAE,EACnF,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,QAAgB,EAChB,MAA4B,EAC5B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CACrB,IAAI,CAAA,yBAAyB,SAAS,aAAa,UAAU,YAAY,QAAQ,EAAE,EACnF,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/resources/ai/memory/namespaces/profiles.d.mts

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

package/resources/ai/memory/namespaces/profiles.d.mts.map

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

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

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

package/resources/ai/memory/namespaces/profiles.d.ts.map

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

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

package/resources/ai/memory/namespaces/profiles.js.map

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

package/resources/ai/memory/namespaces/profiles.mjs

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

package/resources/ai/memory/namespaces/profiles.mjs.map

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

package/resources/ai/memory/namespaces/settings.d.mts

@@ -0,0 +1,108 @@
+import { APIResource } from "../../../../core/resource.mjs";
+import { APIPromise } from "../../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../../internal/request-options.mjs";
+/**
+ * How a namespace's summaries are written.
+ */
+export declare 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>;
+    /**
+     * 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>;
+}
+export interface NamespaceSettingsResponse {
+    /**
+     * A namespace's settings, grouped by what they affect.
+     */
+    data: NamespaceSettingsResponse.Data;
+}
+export declare namespace NamespaceSettingsResponse {
+    /**
+     * A namespace's settings, grouped by what they affect.
+     */
+    interface Data {
+        /**
+         * Settings that shape this namespace's summaries.
+         */
+        summary?: Data.Summary;
+    }
+    namespace Data {
+        /**
+         * Settings that shape this namespace's summaries.
+         */
+        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 declare 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.
+     */
+    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, };
+}
+//# sourceMappingURL=settings.d.mts.map

package/resources/ai/memory/namespaces/settings.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.mts","sourceRoot":"","sources":["../../../../src/resources/ai/memory/namespaces/settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,sCAAkC;AACxD,OAAO,EAAE,UAAU,EAAE,yCAAqC;AAC1D,OAAO,EAAE,cAAc,EAAE,iDAA6C;AAGtE;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,yBAAyB,CAAC;IAIxF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,qBAAqB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAGzC;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;CACtC;AAED,yBAAiB,yBAAyB,CAAC;IACzC;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC;KACxB;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,OAAO;YACtB;;;;;;;;eAQG;YACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAC9B;KACF;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC,OAAO,GAAG,IAAI,CAAC;CAChD;AAED,yBAAiB,qBAAqB,CAAC;IACrC;;;;;OAKG;IACH,UAAiB,OAAO;QACtB;;;;WAIG;QACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}