feat(memory): agent identity memory store attachments — API layer

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-e752e75a35d88b84870729ef94b0c32783172983420cbff1b204ca14375553f7.yml
-openapi_spec_hash: 34787afc1e1c84a643431a0f0eb352ae
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-2783b07289e9f71f07550497c5180824f3dbc92477b5d1d8a80fa6dce4e3b8b6.yml
+openapi_spec_hash: e1d4cff965beed1ec255bf387d55d940
 config_hash: 5a6e285f6e3a958a887b31b972a3f49c

src/resources/agent/agent_.ts

@@ -94,6 +94,12 @@ export interface AgentResponse {
    */
   created_at: string;
 
+  /**
+   * Memory stores attached to this agent. Always present; empty when no stores are
+   * attached.
+   */
+  memory_stores: Array<AgentResponse.MemoryStore>;
+
   /**
    * Name of the agent
    */
@@ -132,6 +138,26 @@ export interface AgentResponse {
 }
 
 export namespace AgentResponse {
+  /**
+   * Reference to a memory store to attach to an agent.
+   */
+  export interface MemoryStore {
+    /**
+     * Access level for the store.
+     */
+    access: 'read_write' | 'read_only';
+
+    /**
+     * Instructions for how the agent should use this memory store. Must not be empty.
+     */
+    instructions: string;
+
+    /**
+     * UID of the memory store.
+     */
+    uid: string;
+  }
+
   /**
    * Reference to a managed secret by name.
    */
@@ -159,6 +185,13 @@ export interface CreateAgentRequest {
    */
   description?: string | null;
 
+  /**
+   * Optional list of memory stores to attach to the agent. Each store must be
+   * team-owned by the same team as the agent. Duplicate UIDs within a single request
+   * are rejected.
+   */
+  memory_stores?: Array<CreateAgentRequest.MemoryStore>;
+
   /**
    * Optional list of secrets associated with the agent. Duplicate names within a
    * single request are rejected. Each entry is unioned into the run-time secret
@@ -177,6 +210,26 @@ export interface CreateAgentRequest {
 }
 
 export namespace CreateAgentRequest {
+  /**
+   * Reference to a memory store to attach to an agent.
+   */
+  export interface MemoryStore {
+    /**
+     * Access level for the store.
+     */
+    access: 'read_write' | 'read_only';
+
+    /**
+     * Instructions for how the agent should use this memory store. Must not be empty.
+     */
+    instructions: string;
+
+    /**
+     * UID of the memory store.
+     */
+    uid: string;
+  }
+
   /**
    * Reference to a managed secret by name.
    */
@@ -212,6 +265,12 @@ export interface UpdateAgentRequest {
    */
   description?: string | null;
 
+  /**
+   * Replacement list of memory stores. Omit to leave unchanged, pass an empty array
+   * to clear, or pass a non-empty array to replace.
+   */
+  memory_stores?: Array<UpdateAgentRequest.MemoryStore> | null;
+
   /**
    * The new name for the agent
    */
@@ -231,6 +290,26 @@ export interface UpdateAgentRequest {
 }
 
 export namespace UpdateAgentRequest {
+  /**
+   * Reference to a memory store to attach to an agent.
+   */
+  export interface MemoryStore {
+    /**
+     * Access level for the store.
+     */
+    access: 'read_write' | 'read_only';
+
+    /**
+     * Instructions for how the agent should use this memory store. Must not be empty.
+     */
+    instructions: string;
+
+    /**
+     * UID of the memory store.
+     */
+    uid: string;
+  }
+
   /**
    * Reference to a managed secret by name.
    */
@@ -258,6 +337,13 @@ export interface AgentCreateParams {
    */
   description?: string | null;
 
+  /**
+   * Optional list of memory stores to attach to the agent. Each store must be
+   * team-owned by the same team as the agent. Duplicate UIDs within a single request
+   * are rejected.
+   */
+  memory_stores?: Array<AgentCreateParams.MemoryStore>;
+
   /**
    * Optional list of secrets associated with the agent. Duplicate names within a
    * single request are rejected. Each entry is unioned into the run-time secret
@@ -276,6 +362,26 @@ export interface AgentCreateParams {
 }
 
 export namespace AgentCreateParams {
+  /**
+   * Reference to a memory store to attach to an agent.
+   */
+  export interface MemoryStore {
+    /**
+     * Access level for the store.
+     */
+    access: 'read_write' | 'read_only';
+
+    /**
+     * Instructions for how the agent should use this memory store. Must not be empty.
+     */
+    instructions: string;
+
+    /**
+     * UID of the memory store.
+     */
+    uid: string;
+  }
+
   /**
    * Reference to a managed secret by name.
    */
@@ -300,6 +406,12 @@ export interface AgentUpdateParams {
    */
   description?: string | null;
 
+  /**
+   * Replacement list of memory stores. Omit to leave unchanged, pass an empty array
+   * to clear, or pass a non-empty array to replace.
+   */
+  memory_stores?: Array<AgentUpdateParams.MemoryStore> | null;
+
   /**
    * The new name for the agent
    */
@@ -319,6 +431,26 @@ export interface AgentUpdateParams {
 }
 
 export namespace AgentUpdateParams {
+  /**
+   * Reference to a memory store to attach to an agent.
+   */
+  export interface MemoryStore {
+    /**
+     * Access level for the store.
+     */
+    access: 'read_write' | 'read_only';
+
+    /**
+     * Instructions for how the agent should use this memory store. Must not be empty.
+     */
+    instructions: string;
+
+    /**
+     * UID of the memory store.
+     */
+    uid: string;
+  }
+
   /**
    * Reference to a managed secret by name.
    */

tests/api-resources/agent/agent_.test.ts

@@ -26,6 +26,13 @@ describe('resource agent', () => {
       name: 'name',
       base_model: 'base_model',
       description: 'description',
+      memory_stores: [
+        {
+          access: 'read_write',
+          instructions: 'instructions',
+          uid: 'uid',
+        },
+      ],
       secrets: [{ name: 'name' }],
       skills: ['string'],
     });