feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/alchemyst-ai%2Falchemyst-ai-sdk-a172a1ab25e5f79a0b9c189123a168fc9b852105596af4c216a873c4bdd71924.yml
-openapi_spec_hash: f12704fa7448d06662d000d3b2b17c86
+configured_endpoints: 15
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/alchemyst-ai%2Falchemyst-ai-sdk-27588c5bd8fa58baa7b2e6deb77ec14fc3fe39915dd9e304843ab4a993a9fe84.yml
+openapi_spec_hash: 3e1789cdc48121d97f702ad12c77bfb3
 config_hash: 32e700129a8eaba38674e583e3d39e2b

api.md

@@ -43,11 +43,13 @@ Methods:
 Types:
 
 - <code><a href="./src/resources/v1/context/memory.ts">MemoryUpdateResponse</a></code>
+- <code><a href="./src/resources/v1/context/memory.ts">MemoryAddResponse</a></code>
 
 Methods:
 
 - <code title="post /api/v1/context/memory/update">client.v1.context.memory.<a href="./src/resources/v1/context/memory.ts">update</a>({ ...params }) -> MemoryUpdateResponse</code>
 - <code title="post /api/v1/context/memory/delete">client.v1.context.memory.<a href="./src/resources/v1/context/memory.ts">delete</a>({ ...params }) -> void</code>
+- <code title="post /api/v1/context/memory/add">client.v1.context.memory.<a href="./src/resources/v1/context/memory.ts">add</a>({ ...params }) -> MemoryAddResponse</code>
 
 ### AddAsync
 

src/resources/v1/context/context.ts

@@ -2,7 +2,14 @@
 
 import { APIResource } from '../../../core/resource';
 import * as MemoryAPI from './memory';
-import { Memory, MemoryDeleteParams, MemoryUpdateParams, MemoryUpdateResponse } from './memory';
+import {
+  Memory,
+  MemoryAddParams,
+  MemoryAddResponse,
+  MemoryDeleteParams,
+  MemoryUpdateParams,
+  MemoryUpdateResponse,
+} from './memory';
 import * as TracesAPI from './traces';
 import { TraceDeleteResponse, TraceListParams, TraceListResponse, Traces } from './traces';
 import * as ViewAPI from './view';
@@ -304,8 +311,10 @@ export declare namespace Context {
   export {
     Memory as Memory,
     type MemoryUpdateResponse as MemoryUpdateResponse,
+    type MemoryAddResponse as MemoryAddResponse,
     type MemoryUpdateParams as MemoryUpdateParams,
     type MemoryDeleteParams as MemoryDeleteParams,
+    type MemoryAddParams as MemoryAddParams,
   };
 
   export {

src/resources/v1/context/index.ts

@@ -18,8 +18,10 @@ export {
 export {
   Memory,
   type MemoryUpdateResponse,
+  type MemoryAddResponse,
   type MemoryUpdateParams,
   type MemoryDeleteParams,
+  type MemoryAddParams,
 } from './memory';
 export { Traces, type TraceListResponse, type TraceDeleteResponse, type TraceListParams } from './traces';
 export {

src/resources/v1/context/memory.ts

@@ -57,6 +57,26 @@ export class Memory extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * This endpoint adds memory (chat history) as context.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.context.memory.add({
+   *   contents: [
+   *     {
+   *       content:
+   *         'Customer asked about pricing for the Scale plan.',
+   *     },
+   *   ],
+   *   sessionId: 'support-thread-TCK-1234',
+   * });
+   * ```
+   */
+  add(body: MemoryAddParams, options?: RequestOptions): APIPromise<MemoryAddResponse> {
+    return this._client.post('/api/v1/context/memory/add', { body, ...options });
+  }
 }
 
 export interface MemoryUpdateResponse {
@@ -67,6 +87,14 @@ export interface MemoryUpdateResponse {
   updated_entries: number;
 }
 
+export interface MemoryAddResponse {
+  context_id: string;
+
+  success: boolean;
+
+  processed_documents?: number;
+}
+
 export interface MemoryUpdateParams {
   /**
    * Array of updated content objects
@@ -135,10 +163,73 @@ export interface MemoryDeleteParams {
   user_id?: string | null;
 }
 
+export interface MemoryAddParams {
+  /**
+   * Array of content objects. Each object must contain at least the 'content' field.
+   * Additional properties are allowed.
+   */
+  contents: Array<MemoryAddParams.Content>;
+
+  /**
+   * The ID of the session
+   */
+  sessionId: string;
+
+  /**
+   * Optional metadata for the memory context. Defaults to ["default"] if not
+   * provided.
+   */
+  metadata?: MemoryAddParams.Metadata;
+}
+
+export namespace MemoryAddParams {
+  export interface Content {
+    /**
+     * The content of the memory message
+     */
+    content: string;
+
+    /**
+     * Additional metadata for the message (optional)
+     */
+    metadata?: Content.Metadata;
+
+    [k: string]: unknown;
+  }
+
+  export namespace Content {
+    /**
+     * Additional metadata for the message (optional)
+     */
+    export interface Metadata {
+      /**
+       * Unique message ID
+       */
+      messageId?: string;
+    }
+  }
+
+  /**
+   * Optional metadata for the memory context. Defaults to ["default"] if not
+   * provided.
+   */
+  export interface Metadata {
+    /**
+     * Optional group names for the memory context. Defaults to ["default"] if not
+     * provided.
+     */
+    groupName?: Array<string>;
+
+    [k: string]: unknown;
+  }
+}
+
 export declare namespace Memory {
   export {
     type MemoryUpdateResponse as MemoryUpdateResponse,
+    type MemoryAddResponse as MemoryAddResponse,
     type MemoryUpdateParams as MemoryUpdateParams,
     type MemoryDeleteParams as MemoryDeleteParams,
+    type MemoryAddParams as MemoryAddParams,
   };
 }

tests/api-resources/v1/context/memory.test.ts

@@ -71,4 +71,33 @@ describe('resource memory', () => {
       user_id: 'user_id',
     });
   });
+
+  // Prism tests are disabled
+  test.skip('add: only required params', async () => {
+    const responsePromise = client.v1.context.memory.add({
+      contents: [{ content: 'Customer asked about pricing for the Scale plan.' }],
+      sessionId: 'support-thread-TCK-1234',
+    });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  // Prism tests are disabled
+  test.skip('add: required and optional params', async () => {
+    const response = await client.v1.context.memory.add({
+      contents: [
+        {
+          content: 'Customer asked about pricing for the Scale plan.',
+          metadata: { messageId: 'messageId' },
+        },
+      ],
+      sessionId: 'support-thread-TCK-1234',
+      metadata: { groupName: ['string'] },
+    });
+  });
 });