telnyx 7.23.0 → 7.24.0

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

@@ -0,0 +1,161 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Profiles = void 0;
+const tslib_1 = require("../../../../../internal/tslib.js");
+const resource_1 = require("../../../../../core/resource.js");
+const MemoriesAPI = tslib_1.__importStar(require("./memories.js"));
+const memories_1 = require("./memories.js");
+const SourcesAPI = tslib_1.__importStar(require("./sources.js"));
+const sources_1 = require("./sources.js");
+const pagination_1 = require("../../../../../core/pagination.js");
+const path_1 = require("../../../../../internal/utils/path.js");
+class Profiles extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.memories = new MemoriesAPI.Memories(this._client);
+        this.sources = new SourcesAPI.Sources(this._client);
+    }
+    /**
+     * Profiles are never created, only written to, so this lists the ones that hold a
+     * memory. A profile whose first ingest is still running is not here yet. Ordered
+     * by memory count, largest first, so a profile written to while the listing is
+     * paged can move between pages and be repeated or missed.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const profileListResponse of client.ai.memory.namespaces.profiles.list(
+     *   'namespace',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(namespace, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/ai/memory/namespaces/${namespace}/profiles`, (pagination_1.DefaultFlatPagination), { query, ...options });
+    }
+    /**
+     * Delete everything held about one profile. A 2xx means none of its memories are
+     * left, and its summary goes with them. There is no undo.
+     *
+     * @example
+     * ```ts
+     * const profile =
+     *   await client.ai.memory.namespaces.profiles.delete(
+     *     'profile_id',
+     *     { namespace: 'namespace' },
+     *   );
+     * ```
+     */
+    delete(profileID, params, options) {
+        const { namespace } = params;
+        return this._client.delete((0, path_1.path) `/ai/memory/namespaces/${namespace}/profiles/${profileID}`, options);
+    }
+    /**
+     * Store a session. Facts are extracted from whatever you send — the body is taken
+     * as any JSON value and stored whole, so a framework's own transcript shape works
+     * unchanged. `messages` of `role`/`content` is the conventional shape, not a
+     * requirement. An empty object or a null body is refused. Carry a `session_id` to
+     * name the session: re-ingesting the same one replaces what it held. Omit it and a
+     * session is opened and returned. Extraction runs asynchronously — poll the
+     * returned operation.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.memory.namespaces.profiles.ingest(
+     *     'profile_id',
+     *     {
+     *       namespace: 'namespace',
+     *       body: { foo: 'bar' },
+     *     },
+     *   );
+     * ```
+     */
+    ingest(profileID, params, options) {
+        const { namespace, body, session_id } = params;
+        return this._client.post((0, path_1.path) `/ai/memory/namespaces/${namespace}/profiles/${profileID}/ingest`, {
+            query: { session_id },
+            body: body,
+            ...options,
+        });
+    }
+    /**
+     * Ranked memories for a question. Matching runs over the profile's memories and
+     * returns them in rank order with a relevance `score`; the score is null where the
+     * deployment's reranker is a passthrough, in which case order is the only signal.
+     * No model runs in this path — recall returns facts, it does not compose an
+     * answer.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.memory.namespaces.profiles.recall(
+     *     'profile_id',
+     *     {
+     *       namespace: 'namespace',
+     *       query: 'where do invoices go?',
+     *       top_k: 5,
+     *     },
+     *   );
+     * ```
+     */
+    recall(profileID, params, options) {
+        const { namespace, ...body } = params;
+        return this._client.post((0, path_1.path) `/ai/memory/namespaces/${namespace}/profiles/${profileID}/recall`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * For a fact the agent has already distilled: `text` is stored as given, with
+     * nothing extracted from it. Send a transcript to `ingest` instead. Remembering
+     * the same text again writes the same memory rather than a second copy of it, so a
+     * retry is safe. The write runs asynchronously -- poll the returned operation.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.memory.namespaces.profiles.remember(
+     *     'profile_id',
+     *     {
+     *       namespace: 'namespace',
+     *       text: 'Prefers window seats and flies out of ORD',
+     *     },
+     *   );
+     * ```
+     */
+    remember(profileID, params, options) {
+        const { namespace, ...body } = params;
+        return this._client.post((0, path_1.path) `/ai/memory/namespaces/${namespace}/profiles/${profileID}/remember`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * The whole profile as one card, precomputed, with no query. Built for the start
+     * of a session, where there is no question to ask yet.
+     *
+     * A summary is generated in the background. `is_stale` tells you newer memories
+     * have arrived since it was written; that is ordinary and the card is still
+     * usable.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.memory.namespaces.profiles.retrieveSummary(
+     *     'profile_id',
+     *     { namespace: 'namespace' },
+     *   );
+     * ```
+     */
+    retrieveSummary(profileID, params, options) {
+        const { namespace } = params;
+        return this._client.get((0, path_1.path) `/ai/memory/namespaces/${namespace}/profiles/${profileID}/summary`, options);
+    }
+}
+exports.Profiles = Profiles;
+Profiles.Memories = memories_1.Memories;
+Profiles.Sources = sources_1.Sources;
+//# sourceMappingURL=profiles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../../../src/resources/ai/memory/namespaces/profiles/profiles.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,8DAA2D;AAC3D,mEAA0C;AAC1C,4CAOoB;AACpB,iEAAwC;AACxC,0CAOmB;AAEnB,kEAIwC;AAExC,gEAA0D;AAE1D,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA6KrE,CAAC;IA3KC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CACF,SAAiB,EACjB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,yBAAyB,SAAS,WAAW,EACjD,CAAA,kCAA0C,CAAA,EAC1C,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,yBAAyB,SAAS,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,yBAAyB,SAAS,aAAa,SAAS,SAAS,EAAE;YAC9F,KAAK,EAAE,EAAE,UAAU,EAAE;YACrB,IAAI,EAAE,IAAI;YACV,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,yBAAyB,SAAS,aAAa,SAAS,SAAS,EAAE;YAC9F,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CACN,SAAiB,EACjB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,yBAAyB,SAAS,aAAa,SAAS,WAAW,EAAE;YAChG,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CACb,SAAiB,EACjB,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,yBAAyB,SAAS,aAAa,SAAS,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3G,CAAC;CACF;AA/KD,4BA+KC;AA8OD,QAAQ,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC7B,QAAQ,CAAC,OAAO,GAAG,iBAAO,CAAC"}

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

@@ -0,0 +1,156 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../../../core/resource.mjs";
+import * as MemoriesAPI from "./memories.mjs";
+import { Memories, } from "./memories.mjs";
+import * as SourcesAPI from "./sources.mjs";
+import { Sources, } from "./sources.mjs";
+import { DefaultFlatPagination, } from "../../../../../core/pagination.mjs";
+import { path } from "../../../../../internal/utils/path.mjs";
+export class Profiles extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.memories = new MemoriesAPI.Memories(this._client);
+        this.sources = new SourcesAPI.Sources(this._client);
+    }
+    /**
+     * Profiles are never created, only written to, so this lists the ones that hold a
+     * memory. A profile whose first ingest is still running is not here yet. Ordered
+     * by memory count, largest first, so a profile written to while the listing is
+     * paged can move between pages and be repeated or missed.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const profileListResponse of client.ai.memory.namespaces.profiles.list(
+     *   'namespace',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(namespace, query = {}, options) {
+        return this._client.getAPIList(path `/ai/memory/namespaces/${namespace}/profiles`, (DefaultFlatPagination), { query, ...options });
+    }
+    /**
+     * Delete everything held about one profile. A 2xx means none of its memories are
+     * left, and its summary goes with them. There is no undo.
+     *
+     * @example
+     * ```ts
+     * const profile =
+     *   await client.ai.memory.namespaces.profiles.delete(
+     *     'profile_id',
+     *     { namespace: 'namespace' },
+     *   );
+     * ```
+     */
+    delete(profileID, params, options) {
+        const { namespace } = params;
+        return this._client.delete(path `/ai/memory/namespaces/${namespace}/profiles/${profileID}`, options);
+    }
+    /**
+     * Store a session. Facts are extracted from whatever you send — the body is taken
+     * as any JSON value and stored whole, so a framework's own transcript shape works
+     * unchanged. `messages` of `role`/`content` is the conventional shape, not a
+     * requirement. An empty object or a null body is refused. Carry a `session_id` to
+     * name the session: re-ingesting the same one replaces what it held. Omit it and a
+     * session is opened and returned. Extraction runs asynchronously — poll the
+     * returned operation.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.memory.namespaces.profiles.ingest(
+     *     'profile_id',
+     *     {
+     *       namespace: 'namespace',
+     *       body: { foo: 'bar' },
+     *     },
+     *   );
+     * ```
+     */
+    ingest(profileID, params, options) {
+        const { namespace, body, session_id } = params;
+        return this._client.post(path `/ai/memory/namespaces/${namespace}/profiles/${profileID}/ingest`, {
+            query: { session_id },
+            body: body,
+            ...options,
+        });
+    }
+    /**
+     * Ranked memories for a question. Matching runs over the profile's memories and
+     * returns them in rank order with a relevance `score`; the score is null where the
+     * deployment's reranker is a passthrough, in which case order is the only signal.
+     * No model runs in this path — recall returns facts, it does not compose an
+     * answer.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.memory.namespaces.profiles.recall(
+     *     'profile_id',
+     *     {
+     *       namespace: 'namespace',
+     *       query: 'where do invoices go?',
+     *       top_k: 5,
+     *     },
+     *   );
+     * ```
+     */
+    recall(profileID, params, options) {
+        const { namespace, ...body } = params;
+        return this._client.post(path `/ai/memory/namespaces/${namespace}/profiles/${profileID}/recall`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * For a fact the agent has already distilled: `text` is stored as given, with
+     * nothing extracted from it. Send a transcript to `ingest` instead. Remembering
+     * the same text again writes the same memory rather than a second copy of it, so a
+     * retry is safe. The write runs asynchronously -- poll the returned operation.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.memory.namespaces.profiles.remember(
+     *     'profile_id',
+     *     {
+     *       namespace: 'namespace',
+     *       text: 'Prefers window seats and flies out of ORD',
+     *     },
+     *   );
+     * ```
+     */
+    remember(profileID, params, options) {
+        const { namespace, ...body } = params;
+        return this._client.post(path `/ai/memory/namespaces/${namespace}/profiles/${profileID}/remember`, {
+            body,
+            ...options,
+        });
+    }
+    /**
+     * The whole profile as one card, precomputed, with no query. Built for the start
+     * of a session, where there is no question to ask yet.
+     *
+     * A summary is generated in the background. `is_stale` tells you newer memories
+     * have arrived since it was written; that is ordinary and the card is still
+     * usable.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.ai.memory.namespaces.profiles.retrieveSummary(
+     *     'profile_id',
+     *     { namespace: 'namespace' },
+     *   );
+     * ```
+     */
+    retrieveSummary(profileID, params, options) {
+        const { namespace } = params;
+        return this._client.get(path `/ai/memory/namespaces/${namespace}/profiles/${profileID}/summary`, options);
+    }
+}
+Profiles.Memories = Memories;
+Profiles.Sources = Sources;
+//# sourceMappingURL=profiles.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.mjs","sourceRoot":"","sources":["../../../../../src/resources/ai/memory/namespaces/profiles/profiles.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,yCAAqC;AAC3D,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EACL,QAAQ,GAMT,uBAAmB;AACpB,OAAO,KAAK,UAAU,sBAAkB;AACxC,OAAO,EAML,OAAO,GACR,sBAAkB;AAEnB,OAAO,EACL,qBAAqB,GAGtB,2CAAuC;AAExC,OAAO,EAAE,IAAI,EAAE,+CAA2C;AAE1D,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA6KrE,CAAC;IA3KC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CACF,SAAiB,EACjB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,yBAAyB,SAAS,WAAW,EACjD,CAAA,qBAA0C,CAAA,EAC1C,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,yBAAyB,SAAS,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,yBAAyB,SAAS,aAAa,SAAS,SAAS,EAAE;YAC9F,KAAK,EAAE,EAAE,UAAU,EAAE;YACrB,IAAI,EAAE,IAAI;YACV,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,yBAAyB,SAAS,aAAa,SAAS,SAAS,EAAE;YAC9F,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CACN,SAAiB,EACjB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,yBAAyB,SAAS,aAAa,SAAS,WAAW,EAAE;YAChG,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CACb,SAAiB,EACjB,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,yBAAyB,SAAS,aAAa,SAAS,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3G,CAAC;CACF;AA8OD,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC7B,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC"}

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"}