Merge pull request #39 from supermemoryai/release-please--branches--main--changes--next--components--supermemory

release: 3.9.0

Author: Dhravya

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.8.0"
+  ".": "3.9.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 18
+configured_endpoints: 19
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-ebd5e757d0e76cb83013e01a1e0bb3dba62beb83b2a2ffa28d148ea032e96fd0.yml
 openapi_spec_hash: f930474a6ad230545154244045cc602e
-config_hash: a478b24249ee4f53abfb5787ca4daf8b
+config_hash: ec08a36e60458b4d83e71798a8043484

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.9.0 (2025-11-26)
+
+Full Changelog: [v3.8.0...v3.9.0](https://github.com/supermemoryai/sdk-ts/compare/v3.8.0...v3.9.0)
+
+### Features
+
+* **api:** manual updates ([940b068](https://github.com/supermemoryai/sdk-ts/commit/940b06806de3d609bb0801cce104b22f7033299d))
+* **api:** manual updates ([ff15d92](https://github.com/supermemoryai/sdk-ts/commit/ff15d92b91ec2e7b6a199a2fd8d5370555e9b3b7))
+* **api:** manual updates ([d02b088](https://github.com/supermemoryai/sdk-ts/commit/d02b08837dc74c91a630e61ee70409bab098782c))
+* **api:** manual updates ([a31ae09](https://github.com/supermemoryai/sdk-ts/commit/a31ae09c27f09ed0b24536686c56d4b0386f38c1))
+* **api:** manual updates ([5ff6ed1](https://github.com/supermemoryai/sdk-ts/commit/5ff6ed14d0a676cbe13a9b90555635bb6f973a8e))
+* **api:** manual updates ([d4edc7f](https://github.com/supermemoryai/sdk-ts/commit/d4edc7f04328a5fcd7ffcc63ecc1df1f6075ceb1))
+* **api:** manual updates ([91034cb](https://github.com/supermemoryai/sdk-ts/commit/91034cb9935031ad5db877c67571e1f22cb4ed68))
+* **api:** manual updates ([c40f02f](https://github.com/supermemoryai/sdk-ts/commit/c40f02f508f51de9c9b364d4d04e2641012df541))
+* **api:** manual updates ([bea6e27](https://github.com/supermemoryai/sdk-ts/commit/bea6e278b1d55a26ff7bc0686648df215e339de5))
+
 ## 3.8.0 (2025-11-25)
 
 Full Changelog: [v3.7.0...v3.8.0](https://github.com/supermemoryai/sdk-ts/compare/v3.7.0...v3.8.0)

README.md

@@ -43,8 +43,8 @@ const client = new Supermemory({
   apiKey: process.env['SUPERMEMORY_API_KEY'], // This is the default and can be omitted
 });
 
-const params: Supermemory.MemoryAddParams = { content: 'content' };
-const response: Supermemory.MemoryAddResponse = await client.memories.add(params);
+const params: Supermemory.AddParams = { content: 'content' };
+const response: Supermemory.AddResponse = await client.add(params);
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
@@ -86,7 +86,7 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const response = await client.memories.add({ content: 'content' }).catch(async (err) => {
+const response = await client.add({ content: 'content' }).catch(async (err) => {
   if (err instanceof Supermemory.APIError) {
     console.log(err.status); // 400
     console.log(err.name); // BadRequestError
@@ -126,7 +126,7 @@ const client = new Supermemory({
 });
 
 // Or, configure per-request:
-await client.memories.add({ content: 'content' }, {
+await client.add({ content: 'content' }, {
   maxRetries: 5,
 });
 ```
@@ -143,7 +143,7 @@ const client = new Supermemory({
 });
 
 // Override per-request:
-await client.memories.add({ content: 'content' }, {
+await client.add({ content: 'content' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -166,11 +166,11 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 ```ts
 const client = new Supermemory();
 
-const response = await client.memories.add({ content: 'content' }).asResponse();
+const response = await client.add({ content: 'content' }).asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: response, response: raw } = await client.memories.add({ content: 'content' }).withResponse();
+const { data: response, response: raw } = await client.add({ content: 'content' }).withResponse();
 console.log(raw.headers.get('X-My-Header'));
 console.log(response.id);
 ```

api.md

@@ -1,9 +1,14 @@
-# Shared
+# Supermemory
 
 Types:
 
-- <code><a href="./src/resources/shared.ts">And</a></code>
-- <code><a href="./src/resources/shared.ts">Or</a></code>
+- <code><a href="./src/resources/top-level.ts">AddResponse</a></code>
+- <code><a href="./src/resources/top-level.ts">ProfileResponse</a></code>
+
+Methods:
+
+- <code title="post /v3/documents">client.<a href="./src/index.ts">add</a>({ ...params }) -> AddResponse</code>
+- <code title="post /v4/profile">client.<a href="./src/index.ts">profile</a>({ ...params }) -> ProfileResponse</code>
 
 # Memories
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "supermemory",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "description": "The official TypeScript library for the Supermemory API",
   "author": "Supermemory <[email protected]>",
   "types": "dist/index.d.ts",

src/client.ts

@@ -15,6 +15,8 @@ import { VERSION } from './version';
 import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
+import * as TopLevelAPI from './resources/top-level';
+import { AddParams, AddResponse, ProfileParams, ProfileResponse } from './resources/top-level';
 import { APIPromise } from './core/api-promise';
 import {
   ConnectionCreateParams,
@@ -253,6 +255,23 @@ export class Supermemory {
     return this.baseURL !== 'https://api.supermemory.ai';
   }
 
+  /**
+   * Add a document with any content type (text, url, file, etc.) and metadata
+   */
+  add(body: TopLevelAPI.AddParams, options?: RequestOptions): APIPromise<TopLevelAPI.AddResponse> {
+    return this.post('/v3/documents', { body, ...options });
+  }
+
+  /**
+   * Get user profile with optional search results
+   */
+  profile(
+    body: TopLevelAPI.ProfileParams,
+    options?: RequestOptions,
+  ): APIPromise<TopLevelAPI.ProfileResponse> {
+    return this.post('/v4/profile', { body, ...options });
+  }
+
   protected defaultQuery(): Record<string, string | undefined> | undefined {
     return this._options.defaultQuery;
   }
@@ -785,6 +804,13 @@ Supermemory.Connections = Connections;
 export declare namespace Supermemory {
   export type RequestOptions = Opts.RequestOptions;
 
+  export {
+    type AddResponse as AddResponse,
+    type ProfileResponse as ProfileResponse,
+    type AddParams as AddParams,
+    type ProfileParams as ProfileParams,
+  };
+
   export {
     Memories as Memories,
     type MemoryUpdateResponse as MemoryUpdateResponse,
@@ -845,7 +871,4 @@ export declare namespace Supermemory {
     type ConnectionImportParams as ConnectionImportParams,
     type ConnectionListDocumentsParams as ConnectionListDocumentsParams,
   };
-
-  export type And = API.And;
-  export type Or = API.Or;
 }

src/resources/documents.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import * as Shared from './shared';
 import { APIPromise } from '../core/api-promise';
 import { type Uploadable } from '../core/uploads';
 import { buildHeaders } from '../internal/headers';
@@ -415,7 +414,7 @@ export interface DocumentListParams {
   /**
    * Optional filters to apply to the search. Can be a JSON string or Query object.
    */
-  filters?: Shared.Or | Shared.And;
+  filters?: DocumentListParams.Or | DocumentListParams.And;
 
   /**
    * Whether to include the content field in the response. Warning: This can make
@@ -444,6 +443,22 @@ export interface DocumentListParams {
   sort?: 'createdAt' | 'updatedAt';
 }
 
+export namespace DocumentListParams {
+  /**
+   * OR
+   */
+  export interface Or {
+    OR: Array<unknown>;
+  }
+
+  /**
+   * AND
+   */
+  export interface And {
+    AND: Array<unknown>;
+  }
+}
+
 export interface DocumentAddParams {
   /**
    * The content to extract and process into a document. This can be a URL to a

src/resources/index.ts

@@ -1,6 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export * from './shared';
 export {
   Connections,
   type ConnectionCreateResponse,
@@ -57,3 +56,4 @@ export {
   type SettingGetResponse,
   type SettingUpdateParams,
 } from './settings';
+export { type AddResponse, type ProfileResponse, type AddParams, type ProfileParams } from './top-level';

src/resources/memories.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import * as Shared from './shared';
 import { APIPromise } from '../core/api-promise';
 import { type Uploadable } from '../core/uploads';
 import { buildHeaders } from '../internal/headers';
@@ -412,7 +411,7 @@ export interface MemoryListParams {
   /**
    * Optional filters to apply to the search. Can be a JSON string or Query object.
    */
-  filters?: Shared.Or | Shared.And;
+  filters?: MemoryListParams.Or | MemoryListParams.And;
 
   /**
    * Whether to include the content field in the response. Warning: This can make
@@ -441,6 +440,22 @@ export interface MemoryListParams {
   sort?: 'createdAt' | 'updatedAt';
 }
 
+export namespace MemoryListParams {
+  /**
+   * OR
+   */
+  export interface Or {
+    OR: Array<unknown>;
+  }
+
+  /**
+   * AND
+   */
+  export interface And {
+    AND: Array<unknown>;
+  }
+}
+
 export interface MemoryAddParams {
   /**
    * The content to extract and process into a document. This can be a URL to a