@tetral-ai/sdk 0.110.0-alpha.1

package/resources/beta/memory-stores/memories.d.ts

@@ -0,0 +1,368 @@
+import { APIResource } from "../../../core/resource.js";
+import * as BetaAPI from "../beta.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { PageCursor, type PageCursorParams, PagePromise } from "../../../core/pagination.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Memories extends APIResource {
+    /**
+     * Create a memory
+     *
+     * Creates a memory inside the explicit `{memory_store_id}` path. This public
+     * HTTP API is separate from the Runtime Memory Tool, which writes through the
+     * session/runtime path.
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.create(
+     *     'memory_store_id',
+     *     { content: 'content', path: 'xx' },
+     *   );
+     * ```
+     */
+    create(memoryStoreID: string, params: MemoryCreateParams, options?: RequestOptions): APIPromise<BetaManagedAgentsMemory>;
+    /**
+     * Retrieve a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.retrieve(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    retrieve(memoryID: string, params: MemoryRetrieveParams, options?: RequestOptions): APIPromise<BetaManagedAgentsMemory>;
+    /**
+     * Update a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.update(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    update(memoryID: string, params: MemoryUpdateParams, options?: RequestOptions): APIPromise<BetaManagedAgentsMemory>;
+    /**
+     * List memories
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsMemoryListItem of client.beta.memoryStores.memories.list(
+     *   'memory_store_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(memoryStoreID: string, params?: MemoryListParams | null | undefined, options?: RequestOptions): PagePromise<BetaManagedAgentsMemoryListItemsPageCursor, BetaManagedAgentsMemoryListItem>;
+    /**
+     * Delete a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeletedMemory =
+     *   await client.beta.memoryStores.memories.delete(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    delete(memoryID: string, params: MemoryDeleteParams, options?: RequestOptions): APIPromise<BetaManagedAgentsDeletedMemory>;
+}
+export type BetaManagedAgentsMemoryListItemsPageCursor = PageCursor<BetaManagedAgentsMemoryListItem>;
+export interface BetaManagedAgentsConflictError {
+    type: 'conflict_error';
+    message?: string;
+}
+/**
+ * Optimistic-concurrency precondition: the update applies only if the memory's
+ * stored `content_sha256` equals the supplied value. On Tetral mismatch, the
+ * backend returns the shared SDK-compatible `409 invalid_request_error`; re-read
+ * the memory and retry against the fresh state.
+ */
+export interface BetaManagedAgentsContentSha256Precondition {
+    type: 'content_sha256';
+    /**
+     * Expected `content_sha256` of the stored memory (64 lowercase hexadecimal
+     * characters). Typically the `content_sha256` returned by a prior read or list
+     * call. Because the server applies no content normalization, clients can also
+     * compute this locally as the SHA-256 of the UTF-8 content bytes.
+     */
+    content_sha256?: string;
+}
+/**
+ * Tombstone returned by
+ * [Delete a memory](/en/api/beta/memory_stores/memories/delete). The memory's
+ * version history persists and remains listable via
+ * [List memory versions](/en/api/beta/memory_stores/memory_versions/list) until
+ * the store itself is deleted.
+ */
+export interface BetaManagedAgentsDeletedMemory {
+    /**
+     * ID of the deleted memory (a `mem_...` value).
+     */
+    id: string;
+    type: 'memory_deleted';
+}
+/**
+ * Retained upstream compatibility error union. Tetral uses the shared SDK error
+ * envelope in this stage; memory write conflicts and precondition failures are
+ * surfaced as `409 invalid_request_error`.
+ */
+export type BetaManagedAgentsError = BetaAPI.BetaInvalidRequestError | BetaAPI.BetaAuthenticationError | BetaAPI.BetaBillingError | BetaAPI.BetaPermissionError | BetaAPI.BetaNotFoundError | BetaAPI.BetaRateLimitError | BetaAPI.BetaGatewayTimeoutError | BetaAPI.BetaAPIError | BetaAPI.BetaOverloadedError | BetaManagedAgentsMemoryPreconditionFailedError | BetaManagedAgentsMemoryPathConflictError | BetaManagedAgentsConflictError;
+/**
+ * A `memory` object: a single text document at a hierarchical path inside a memory
+ * store. The `content` field is populated when `view=full` and `null` when
+ * `view=basic`; the `content_size_bytes` and `content_sha256` fields are always
+ * populated so sync clients can diff without fetching content. Memories are
+ * addressed by their `mem_...` ID; the path is the create key and can be changed
+ * via update.
+ */
+export interface BetaManagedAgentsMemory {
+    /**
+     * Unique identifier for this memory (a `mem_...` value). Stable across renames;
+     * use this ID, not the path, to read, update, or delete the memory.
+     */
+    id: string;
+    /**
+     * Lowercase hex SHA-256 digest of the UTF-8 `content` bytes (64 characters). The
+     * server applies no normalization, so clients can compute the same hash locally
+     * for staleness checks and as the value for a `content_sha256` precondition on
+     * update. Always populated, regardless of `view`.
+     */
+    content_sha256: string;
+    /**
+     * Size of `content` in bytes (the UTF-8 plaintext length). Always populated,
+     * regardless of `view`.
+     */
+    content_size_bytes: number;
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    created_at: string;
+    /**
+     * ID of the memory store this memory belongs to (a `memstore_...` value).
+     */
+    memory_store_id: string;
+    /**
+     * ID of the `memory_version` representing this memory's current content (a
+     * `memver_...` value). This is the authoritative head pointer; `memory_version`
+     * objects do not carry an `is_latest` flag, so compare against this field instead.
+     * Enumerate the full history via
+     * [List memory versions](/en/api/beta/memory_stores/memory_versions/list).
+     */
+    memory_version_id: string;
+    /**
+     * Hierarchical path of the memory within the store, e.g. `/projects/foo/notes.md`.
+     * Always starts with `/`. Paths are case-sensitive and unique within a store.
+     * Maximum 1,024 bytes.
+     */
+    path: string;
+    type: 'memory';
+    /**
+     * A timestamp in RFC 3339 format
+     */
+    updated_at: string;
+    /**
+     * The memory's UTF-8 text content. Populated when `view=full`; `null` when
+     * `view=basic`. Maximum 100 kB (102,400 bytes).
+     */
+    content?: string | null;
+}
+/**
+ * One item in a [List memories](/en/api/beta/memory_stores/memories/list)
+ * response: either a `memory` object or, when `depth` is set, a `memory_prefix`
+ * rollup marker.
+ */
+export type BetaManagedAgentsMemoryListItem = BetaManagedAgentsMemory | BetaManagedAgentsMemoryPrefix;
+export interface BetaManagedAgentsMemoryPathConflictError {
+    /**
+     * Retained upstream compatibility marker. Tetral path conflicts use the shared
+     * `409 invalid_request_error` envelope in this stage.
+     */
+    type: 'memory_path_conflict_error';
+    conflicting_memory_id?: string;
+    conflicting_path?: string;
+    message?: string;
+}
+export interface BetaManagedAgentsMemoryPreconditionFailedError {
+    /**
+     * Retained upstream compatibility marker. Tetral precondition failures use the
+     * shared `409 invalid_request_error` envelope in this stage.
+     */
+    type: 'memory_precondition_failed_error';
+    message?: string;
+}
+/**
+ * A rolled-up directory marker returned by
+ * [List memories](/en/api/beta/memory_stores/memories/list) when `depth` is set.
+ * Indicates that one or more memories exist deeper than the requested depth under
+ * this prefix. This is a list-time rollup, not a stored resource; it has no ID and
+ * no lifecycle. Each prefix counts toward the page `limit` and interleaves with
+ * `memory` items in path order.
+ */
+export interface BetaManagedAgentsMemoryPrefix {
+    /**
+     * The rolled-up path prefix, including a trailing `/` (e.g. `/projects/foo/`).
+     * Pass this value as `path_prefix` on a subsequent list call to drill into the
+     * directory.
+     */
+    path: string;
+    type: 'memory_prefix';
+}
+/**
+ * Selects which projection of a `memory` or `memory_version` the server returns.
+ * `basic` returns the object with `content` set to `null`; `full` populates
+ * `content`. When omitted, the default is endpoint-specific: retrieve operations
+ * default to `full`; list, create, and update operations default to `basic`.
+ * Listing with `view=full` caps `limit` at 20.
+ */
+export type BetaManagedAgentsMemoryView = 'basic' | 'full';
+/**
+ * Optimistic-concurrency precondition: the update applies only if the memory's
+ * stored `content_sha256` equals the supplied value. On Tetral mismatch, the
+ * backend returns the shared SDK-compatible `409 invalid_request_error`; re-read
+ * the memory and retry against the fresh state.
+ */
+export interface BetaManagedAgentsPrecondition {
+    type: 'content_sha256';
+    /**
+     * Expected `content_sha256` of the stored memory (64 lowercase hexadecimal
+     * characters). Typically the `content_sha256` returned by a prior read or list
+     * call. Because the server applies no content normalization, clients can also
+     * compute this locally as the SHA-256 of the UTF-8 content bytes.
+     */
+    content_sha256?: string;
+}
+export interface MemoryCreateParams {
+    /**
+     * Body param: UTF-8 text content for the new memory. Maximum 100 kB (102,400
+     * bytes). Required; pass `""` explicitly to create an empty memory.
+     */
+    content: string | null;
+    /**
+     * Body param: Hierarchical path for the new memory, e.g. `/projects/foo/notes.md`.
+     * Must start with `/`, contain at least one non-empty segment, and be at most
+     * 1,024 bytes. Must not contain empty segments, `.` or `..` segments, control or
+     * format characters, and must be NFC-normalized. Paths are case-sensitive.
+     */
+    path: string;
+    /**
+     * Query param: Query parameter for view
+     */
+    view?: BetaManagedAgentsMemoryView;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.AnthropicBeta>;
+}
+export interface MemoryRetrieveParams {
+    /**
+     * Path param: Explicit Memory Store selector. The SDK does not infer a
+     * workspace default Memory Store.
+     */
+    memory_store_id: string;
+    /**
+     * Query param: Query parameter for view
+     */
+    view?: BetaManagedAgentsMemoryView;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.AnthropicBeta>;
+}
+export interface MemoryUpdateParams {
+    /**
+     * Path param: Explicit Memory Store selector. The SDK does not infer a
+     * workspace default Memory Store.
+     */
+    memory_store_id: string;
+    /**
+     * Query param: Query parameter for view
+     */
+    view?: BetaManagedAgentsMemoryView;
+    /**
+     * Body param: New UTF-8 text content for the memory. Maximum 100 kB (102,400
+     * bytes). Omit to leave the content unchanged (e.g., for a rename-only update).
+     */
+    content?: string | null;
+    /**
+     * Body param: New path for the memory (a rename). Must start with `/`, contain at
+     * least one non-empty segment, and be at most 1,024 bytes. Must not contain empty
+     * segments, `.` or `..` segments, control or format characters, and must be
+     * NFC-normalized. Paths are case-sensitive. The memory's `id` is preserved across
+     * renames. Omit to leave the path unchanged.
+     */
+    path?: string | null;
+    /**
+     * Body param: Optimistic-concurrency precondition: the update applies only if the
+     * memory's stored `content_sha256` equals the supplied value. On Tetral
+     * mismatch, the backend returns the shared SDK-compatible
+     * `409 invalid_request_error`; re-read the memory and retry against the fresh
+     * state.
+     */
+    precondition?: BetaManagedAgentsPrecondition;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.AnthropicBeta>;
+}
+export interface MemoryListParams extends PageCursorParams {
+    /**
+     * Query param: `0` (or omitted) returns all descendants below `path_prefix`
+     * (recursive). `1` returns immediate children only; deeper entries roll up as
+     * `memory_prefix` items. `depth=1` behaves like `ls`; omitting `depth` behaves
+     * like `find`.
+     */
+    depth?: number;
+    /**
+     * Query param: Optional path prefix filter. Must end with `/` (segment-aligned),
+     * e.g., `/notes/`. This value appears in request URLs. Do not include secrets or
+     * personally identifiable information.
+     */
+    path_prefix?: string;
+    /**
+     * Query param: Sort field for the listing. Tetral supports ordering by `path`,
+     * `created_at`, or `updated_at`.
+     */
+    order_by?: 'path' | 'created_at' | 'updated_at';
+    /**
+     * Query param: Sort direction.
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Query param: Which projection of each `memory` to return. Defaults to `basic`
+     * (content omitted). `full` populates `content` on each item and caps `limit` at
+     * 20; use this as the bulk-read path for export and sync.
+     */
+    view?: BetaManagedAgentsMemoryView;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.AnthropicBeta>;
+}
+export interface MemoryDeleteParams {
+    /**
+     * Path param: Explicit Memory Store selector. The SDK does not infer a
+     * workspace default Memory Store.
+     */
+    memory_store_id: string;
+    /**
+     * Query param: Query parameter for expected_content_sha256
+     */
+    expected_content_sha256?: string;
+    /**
+     * Header param: Optional header to specify the beta version(s) you want to use.
+     */
+    betas?: Array<BetaAPI.AnthropicBeta>;
+}
+export declare namespace Memories {
+    export { type BetaManagedAgentsConflictError as BetaManagedAgentsConflictError, type BetaManagedAgentsContentSha256Precondition as BetaManagedAgentsContentSha256Precondition, type BetaManagedAgentsDeletedMemory as BetaManagedAgentsDeletedMemory, type BetaManagedAgentsError as BetaManagedAgentsError, type BetaManagedAgentsMemory as BetaManagedAgentsMemory, type BetaManagedAgentsMemoryListItem as BetaManagedAgentsMemoryListItem, type BetaManagedAgentsMemoryPathConflictError as BetaManagedAgentsMemoryPathConflictError, type BetaManagedAgentsMemoryPreconditionFailedError as BetaManagedAgentsMemoryPreconditionFailedError, type BetaManagedAgentsMemoryPrefix as BetaManagedAgentsMemoryPrefix, type BetaManagedAgentsMemoryView as BetaManagedAgentsMemoryView, type BetaManagedAgentsPrecondition as BetaManagedAgentsPrecondition, type BetaManagedAgentsMemoryListItemsPageCursor as BetaManagedAgentsMemoryListItemsPageCursor, type MemoryCreateParams as MemoryCreateParams, type MemoryRetrieveParams as MemoryRetrieveParams, type MemoryUpdateParams as MemoryUpdateParams, type MemoryListParams as MemoryListParams, type MemoryDeleteParams as MemoryDeleteParams, };
+}
+//# sourceMappingURL=memories.d.ts.map

package/resources/beta/memory-stores/memories.d.ts.map

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

package/resources/beta/memory-stores/memories.js

@@ -0,0 +1,134 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Memories = void 0;
+const resource_1 = require("../../../core/resource.js");
+const pagination_1 = require("../../../core/pagination.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Memories extends resource_1.APIResource {
+    /**
+     * Create a memory
+     *
+     * Creates a memory inside the explicit `{memory_store_id}` path. This public
+     * HTTP API is separate from the Runtime Memory Tool, which writes through the
+     * session/runtime path.
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.create(
+     *     'memory_store_id',
+     *     { content: 'content', path: 'xx' },
+     *   );
+     * ```
+     */
+    create(memoryStoreID, params, options) {
+        const { view, betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/memory_stores/${memoryStoreID}/memories?beta=true`, {
+            query: { view },
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Retrieve a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.retrieve(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    retrieve(memoryID, params, options) {
+        const { memory_store_id, betas, ...query } = params;
+        return this._client.get((0, path_1.path) `/v1/memory_stores/${memory_store_id}/memories/${memoryID}?beta=true`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Update a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.update(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    update(memoryID, params, options) {
+        const { memory_store_id, view, betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/memory_stores/${memory_store_id}/memories/${memoryID}?beta=true`, {
+            query: { view },
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List memories
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsMemoryListItem of client.beta.memoryStores.memories.list(
+     *   'memory_store_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(memoryStoreID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/v1/memory_stores/${memoryStoreID}/memories?beta=true`, (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Delete a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeletedMemory =
+     *   await client.beta.memoryStores.memories.delete(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    delete(memoryID, params, options) {
+        const { memory_store_id, expected_content_sha256, betas } = params;
+        return this._client.delete((0, path_1.path) `/v1/memory_stores/${memory_store_id}/memories/${memoryID}?beta=true`, {
+            query: { expected_content_sha256 },
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Memories = Memories;
+//# sourceMappingURL=memories.js.map

package/resources/beta/memory-stores/memories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.js","sourceRoot":"","sources":["../../../src/resources/beta/memory-stores/memories.ts"],"names":[],"mappings":"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"}

package/resources/beta/memory-stores/memories.mjs

@@ -0,0 +1,130 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { PageCursor } from "../../../core/pagination.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+export class Memories extends APIResource {
+    /**
+     * Create a memory
+     *
+     * Creates a memory inside the explicit `{memory_store_id}` path. This public
+     * HTTP API is separate from the Runtime Memory Tool, which writes through the
+     * session/runtime path.
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.create(
+     *     'memory_store_id',
+     *     { content: 'content', path: 'xx' },
+     *   );
+     * ```
+     */
+    create(memoryStoreID, params, options) {
+        const { view, betas, ...body } = params;
+        return this._client.post(path `/v1/memory_stores/${memoryStoreID}/memories?beta=true`, {
+            query: { view },
+            body,
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Retrieve a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.retrieve(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    retrieve(memoryID, params, options) {
+        const { memory_store_id, betas, ...query } = params;
+        return this._client.get(path `/v1/memory_stores/${memory_store_id}/memories/${memoryID}?beta=true`, {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Update a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsMemory =
+     *   await client.beta.memoryStores.memories.update(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    update(memoryID, params, options) {
+        const { memory_store_id, view, betas, ...body } = params;
+        return this._client.post(path `/v1/memory_stores/${memory_store_id}/memories/${memoryID}?beta=true`, {
+            query: { view },
+            body,
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List memories
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaManagedAgentsMemoryListItem of client.beta.memoryStores.memories.list(
+     *   'memory_store_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(memoryStoreID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList(path `/v1/memory_stores/${memoryStoreID}/memories?beta=true`, (PageCursor), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Delete a memory
+     *
+     * @example
+     * ```ts
+     * const betaManagedAgentsDeletedMemory =
+     *   await client.beta.memoryStores.memories.delete(
+     *     'memory_id',
+     *     { memory_store_id: 'memory_store_id' },
+     *   );
+     * ```
+     */
+    delete(memoryID, params, options) {
+        const { memory_store_id, expected_content_sha256, betas } = params;
+        return this._client.delete(path `/v1/memory_stores/${memory_store_id}/memories/${memoryID}?beta=true`, {
+            query: { expected_content_sha256 },
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=memories.mjs.map

package/resources/beta/memory-stores/memories.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.mjs","sourceRoot":"","sources":["../../../src/resources/beta/memory-stores/memories.ts"],"names":[],"mappings":"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"}