@code-yeongyu/senpi 2026.8.24 → 2026.8.26

package/node_modules/@anthropic-ai/sdk/src/resources/beta/memory-stores/memories.ts

@@ -10,7 +10,7 @@ import { path } from '../../../internal/utils/path';
 
 export class Memories extends APIResource {
   /**
-   * CreateMemory
+   * Create a memory
    *
    * @example
    * ```ts
@@ -32,14 +32,14 @@ export class Memories extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
   }
 
   /**
-   * GetMemory
+   * Retrieve a memory
    *
    * @example
    * ```ts
@@ -60,14 +60,14 @@ export class Memories extends APIResource {
       query,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
   }
 
   /**
-   * UpdateMemory
+   * Update a memory
    *
    * @example
    * ```ts
@@ -89,14 +89,14 @@ export class Memories extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
   }
 
   /**
-   * ListMemories
+   * List memories
    *
    * @example
    * ```ts
@@ -121,7 +121,7 @@ export class Memories extends APIResource {
         query,
         ...options,
         headers: buildHeaders([
-          { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+          { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
           options?.headers,
         ]),
       },
@@ -129,7 +129,7 @@ export class Memories extends APIResource {
   }
 
   /**
-   * DeleteMemory
+   * Delete a memory
    *
    * @example
    * ```ts
@@ -150,7 +150,7 @@ export class Memories extends APIResource {
       query: { expected_content_sha256 },
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
@@ -165,13 +165,37 @@ export interface BetaManagedAgentsConflictError {
   message?: string;
 }
 
+/**
+ * Optimistic-concurrency precondition: the update applies only if the memory's
+ * stored `content_sha256` equals the supplied value. On mismatch, the request
+ * returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and
+ * retry against the fresh state. If the precondition fails but the stored state
+ * already exactly matches the requested `content` and `path`, the server returns
+ * 200 instead of 409.
+ */
 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';
@@ -191,11 +215,33 @@ export type BetaManagedAgentsError =
   | 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;
 
   /**
@@ -203,10 +249,25 @@ export interface BetaManagedAgentsMemory {
    */
   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';
@@ -216,9 +277,18 @@ export interface BetaManagedAgentsMemory {
    */
   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 {
@@ -237,31 +307,66 @@ export interface BetaManagedAgentsMemoryPreconditionFailedError {
   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';
 }
 
 /**
- * MemoryView enum
+ * 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 mismatch, the request
+ * returns `memory_precondition_failed_error` (HTTP 409); re-read the memory and
+ * retry against the fresh state. If the precondition fails but the stored state
+ * already exactly matches the requested `content` and `path`, the server returns
+ * 200 instead of 409.
+ */
 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
+   * 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
+   * 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;
 
@@ -305,17 +410,27 @@ export interface MemoryUpdateParams {
   view?: BetaManagedAgentsMemoryView;
 
   /**
-   * Body param
+   * 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
+   * 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
+   * Body param: Optimistic-concurrency precondition: the update applies only if the
+   * memory's stored `content_sha256` equals the supplied value. On mismatch, the
+   * request returns `memory_precondition_failed_error` (HTTP 409); re-read the
+   * memory and retry against the fresh state. If the precondition fails but the
+   * stored state already exactly matches the requested `content` and `path`, the
+   * server returns 200 instead of 409.
    */
   precondition?: BetaManagedAgentsPrecondition;
 
@@ -327,29 +442,24 @@ export interface MemoryUpdateParams {
 
 export interface MemoryListParams extends PageCursorParams {
   /**
-   * Query param: Query parameter for depth
+   * 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: Query parameter for order
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Query param: Query parameter for order_by
-   */
-  order_by?: string;
-
-  /**
-   * Query param: Optional path prefix filter (raw string-prefix match; include a
-   * trailing slash for directory-scoped lists). This value appears in request URLs.
-   * Do not include secrets or personally identifiable information.
+   * 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: Query parameter for view
+   * 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;
 

package/node_modules/@anthropic-ai/sdk/src/resources/beta/memory-stores/memory-stores.ts

@@ -30,6 +30,7 @@ import {
   BetaManagedAgentsMemoryVersion,
   BetaManagedAgentsMemoryVersionOperation,
   BetaManagedAgentsMemoryVersionsPageCursor,
+  BetaManagedAgentsServiceAccountActor,
   BetaManagedAgentsSessionActor,
   BetaManagedAgentsUserActor,
   MemoryVersionListParams,
@@ -48,7 +49,7 @@ export class MemoryStores extends APIResource {
   memoryVersions: MemoryVersionsAPI.MemoryVersions = new MemoryVersionsAPI.MemoryVersions(this._client);
 
   /**
-   * CreateMemoryStore
+   * Create a memory store
    *
    * @example
    * ```ts
@@ -65,14 +66,14 @@ export class MemoryStores extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
   }
 
   /**
-   * GetMemoryStore
+   * Retrieve a memory store
    *
    * @example
    * ```ts
@@ -91,14 +92,14 @@ export class MemoryStores extends APIResource {
     return this._client.get(path`/v1/memory_stores/${memoryStoreID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
   }
 
   /**
-   * UpdateMemoryStore
+   * Update a memory store
    *
    * @example
    * ```ts
@@ -116,14 +117,14 @@ export class MemoryStores extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
   }
 
   /**
-   * ListMemoryStores
+   * List memory stores
    *
    * @example
    * ```ts
@@ -142,14 +143,14 @@ export class MemoryStores extends APIResource {
       query,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
   }
 
   /**
-   * DeleteMemoryStore
+   * Delete a memory store
    *
    * @example
    * ```ts
@@ -166,14 +167,14 @@ export class MemoryStores extends APIResource {
     return this._client.delete(path`/v1/memory_stores/${memoryStoreID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
   }
 
   /**
-   * ArchiveMemoryStore
+   * Archive a memory store
    *
    * @example
    * ```ts
@@ -190,7 +191,7 @@ export class MemoryStores extends APIResource {
     return this._client.post(path`/v1/memory_stores/${memoryStoreID}/archive?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+        { 'anthropic-beta': [...(betas ?? []), 'agent-memory-2026-07-22'].toString() },
         options?.headers,
       ]),
     });
@@ -199,13 +200,30 @@ export class MemoryStores extends APIResource {
 
 export type BetaManagedAgentsMemoryStoresPageCursor = PageCursor<BetaManagedAgentsMemoryStore>;
 
+/**
+ * Confirmation that a `memory_store` was deleted.
+ */
 export interface BetaManagedAgentsDeletedMemoryStore {
+  /**
+   * ID of the deleted memory store (a `memstore_...` identifier). The store and all
+   * its memories and versions are no longer retrievable.
+   */
   id: string;
 
   type: 'memory_store_deleted';
 }
 
+/**
+ * A `memory_store`: a named container for agent memories, scoped to a workspace.
+ * Attach a store to a session via `resources[]` to mount it as a directory the
+ * agent can read and write.
+ */
 export interface BetaManagedAgentsMemoryStore {
+  /**
+   * Unique identifier for the memory store (a `memstore_...` tagged ID). Use this
+   * when attaching the store to a session, or in the `{memory_store_id}` path
+   * parameter of subsequent calls.
+   */
   id: string;
 
   /**
@@ -213,6 +231,10 @@ export interface BetaManagedAgentsMemoryStore {
    */
   created_at: string;
 
+  /**
+   * Human-readable name for the store. 1–255 characters. The store's mount-path slug
+   * under `/mnt/memory/` is derived from this name.
+   */
   name: string;
 
   type: 'memory_store';
@@ -227,24 +249,41 @@ export interface BetaManagedAgentsMemoryStore {
    */
   archived_at?: string | null;
 
+  /**
+   * Free-text description of what the store contains, up to 1024 characters.
+   * Included in the agent's system prompt when the store is attached, so word it to
+   * be useful to the agent. Empty string when unset.
+   */
   description?: string;
 
+  /**
+   * Arbitrary key-value tags for your own bookkeeping (such as the end user a store
+   * belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512 characters.
+   * Returned on retrieve/list but not filterable.
+   */
   metadata?: { [key: string]: string };
 }
 
 export interface MemoryStoreCreateParams {
   /**
-   * Body param
+   * Body param: Human-readable name for the store. Required; 1–255 characters; no
+   * control characters. The mount-path slug under `/mnt/memory/` is derived from
+   * this name (lowercased, non-alphanumeric runs collapsed to a hyphen). Names need
+   * not be unique within a workspace.
    */
   name: string;
 
   /**
-   * Body param
+   * Body param: Free-text description of what the store contains, up to 1024
+   * characters. Included in the agent's system prompt when the store is attached, so
+   * word it to be useful to the agent.
    */
   description?: string;
 
   /**
-   * Body param
+   * Body param: Arbitrary key-value tags for your own bookkeeping (such as the end
+   * user a store belongs to). Up to 16 pairs; keys 1–64 characters; values up to 512
+   * characters. Not visible to the agent.
    */
   metadata?: { [key: string]: string };
 
@@ -263,7 +302,8 @@ export interface MemoryStoreRetrieveParams {
 
 export interface MemoryStoreUpdateParams {
   /**
-   * Body param
+   * Body param: New description for the store, up to 1024 characters. Pass an empty
+   * string to clear it.
    */
   description?: string | null;
 
@@ -275,7 +315,9 @@ export interface MemoryStoreUpdateParams {
   metadata?: { [key: string]: string | null } | null;
 
   /**
-   * Body param
+   * Body param: New human-readable name for the store. 1–255 characters; no control
+   * characters. Renaming changes the slug used for the store's `mount_path` in
+   * sessions created after the update.
    */
   name?: string | null;
 
@@ -287,17 +329,20 @@ export interface MemoryStoreUpdateParams {
 
 export interface MemoryStoreListParams extends PageCursorParams {
   /**
-   * Query param: Return stores created at or after this time (inclusive).
+   * Query param: Return only stores whose `created_at` is at or after this time
+   * (inclusive). Sent on the wire as `created_at[gte]`.
    */
   'created_at[gte]'?: string;
 
   /**
-   * Query param: Return stores created at or before this time (inclusive).
+   * Query param: Return only stores whose `created_at` is at or before this time
+   * (inclusive). Sent on the wire as `created_at[lte]`.
    */
   'created_at[lte]'?: string;
 
   /**
-   * Query param: Query parameter for include_archived
+   * Query param: When `true`, archived stores are included in the results. Defaults
+   * to `false` (archived stores are excluded).
    */
   include_archived?: boolean;
 
@@ -364,6 +409,7 @@ export declare namespace MemoryStores {
     type BetaManagedAgentsAPIActor as BetaManagedAgentsAPIActor,
     type BetaManagedAgentsMemoryVersion as BetaManagedAgentsMemoryVersion,
     type BetaManagedAgentsMemoryVersionOperation as BetaManagedAgentsMemoryVersionOperation,
+    type BetaManagedAgentsServiceAccountActor as BetaManagedAgentsServiceAccountActor,
     type BetaManagedAgentsSessionActor as BetaManagedAgentsSessionActor,
     type BetaManagedAgentsUserActor as BetaManagedAgentsUserActor,
     type BetaManagedAgentsMemoryVersionsPageCursor as BetaManagedAgentsMemoryVersionsPageCursor,