feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-5d883c307659b317ca9a27ffd4e98855210c7030167bc79f4727412266c8e53b.yml
-openapi_spec_hash: 4e5b35c97838082939b19a24d9472ffd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-f09b91ede978d3fd05810d3750fcc837f8baa6430fa1be9208ba3088ecaef7f4.yml
+openapi_spec_hash: 957d1e254f2f5933d0c22f3b310122e9
 config_hash: cde97ef3188581c5f4924c633ec33ddb

packages/mcp-server/src/local-docs-search.ts

@@ -194,6 +194,8 @@ export namespace DocumentListResponse {
      */
     customId: string | null;
 
+    filepath: string | null;
+
     /**
      * Optional metadata for the document. This is used to store additional information
      * about the document. You can use this to store any additional information you
@@ -394,6 +396,8 @@ export interface DocumentGetResponse {
    */
   customId: string | null;
 
+  filepath: string | null;
+
   /**
    * Optional metadata for the document. This is used to store additional information
    * about the document. You can use this to store any additional information you
@@ -600,6 +604,12 @@ export interface DocumentUpdateParams {
    */
   customId?: string;
 
+  /**
+   * Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
+   * by supermemoryfs to map documents to filesystem paths.
+   */
+  filepath?: string;
+
   /**
    * Optional metadata for the document. This is used to store additional information
    * about the document. You can use this to store any additional information you
@@ -624,6 +634,12 @@ export interface DocumentListParams {
    */
   containerTags?: Array<string>;
 
+  /**
+   * Filter documents by filepath. Exact match for full paths, prefix match if ending
+   * with /
+   */
+  filepath?: string;
+
   /**
    * Optional filters to apply to the search. Can be a JSON string or Query object.
    */
@@ -4090,6 +4106,12 @@ export interface DocumentAddParams {
    */
   entityContext?: string;
 
+  /**
+   * Optional file path for the document. Used by supermemoryfs to store the full
+   * path of the file.
+   */
+  filepath?: string;
+
   /**
    * Optional metadata for the document.
    */
@@ -4121,6 +4143,12 @@ export interface DocumentBatchAddParams {
 
   content?: null;
 
+  /**
+   * Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
+   * by supermemoryfs to map documents to filesystem paths.
+   */
+  filepath?: string;
+
   /**
    * Optional metadata for the document. This is used to store additional information
    * about the document. You can use this to store any additional information you
@@ -4171,6 +4199,12 @@ export namespace DocumentBatchAddParams {
      */
     customId?: string;
 
+    /**
+     * Optional file path for the document (e.g., '/documents/reports/file.pdf'). Used
+     * by supermemoryfs to map documents to filesystem paths.
+     */
+    filepath?: string;
+
     /**
      * Optional metadata for the document. This is used to store additional information
      * about the document. You can use this to store any additional information you
@@ -4195,6 +4229,12 @@ export interface DocumentDeleteBulkParams {
    */
   containerTags?: Array<string>;
 
+  /**
+   * Delete documents matching this filepath. Exact match for full paths, prefix
+   * match if ending with /
+   */
+  filepath?: string;
+
   /**
    * Array of document IDs to delete (max 100 at once)
    */
@@ -4219,6 +4259,12 @@ export interface DocumentUploadFileParams {
    */
   containerTags?: string;
 
+  /**
+   * Optional file path for the uploaded file (e.g., '/documents/reports/file.pdf').
+   * Used by supermemoryfs to map documents to filesystem paths.
+   */
+  filepath?: string;
+
   /**
    * Optional file type override to force specific processing behavior. Valid values:
    * text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,

src/resources/documents.ts

@@ -280,6 +280,11 @@ export namespace SearchMemoriesResponse {
      */
     documents?: Array<Result.Document>;
 
+    /**
+     * Filepath of the source document this memory or chunk came from
+     */
+    filepath?: string | null;
+
     /**
      * Indicates if this memory was created by aggregating multiple source memories
      */
@@ -466,6 +471,12 @@ export interface SearchDocumentsParams {
    */
   documentThreshold?: number;
 
+  /**
+   * Filter search results by filepath. Exact match for full paths, prefix match if
+   * ending with /
+   */
+  filepath?: string;
+
   /**
    * Optional filters to apply to the search. Can be a JSON string or Query object.
    */
@@ -3953,6 +3964,12 @@ export interface SearchExecuteParams {
    */
   documentThreshold?: number;
 
+  /**
+   * Filter search results by filepath. Exact match for full paths, prefix match if
+   * ending with /
+   */
+  filepath?: string;
+
   /**
    * Optional filters to apply to the search. Can be a JSON string or Query object.
    */
@@ -7418,6 +7435,12 @@ export interface SearchMemoriesParams {
    */
   containerTag?: string;
 
+  /**
+   * Filter search results by filepath. Exact match for full paths, prefix match if
+   * ending with /
+   */
+  filepath?: string;
+
   /**
    * Optional filters to apply to the search. Can be a JSON string or Query object.
    */

src/resources/search.ts

@@ -85,6 +85,12 @@ export interface AddParams {
    */
   entityContext?: string;
 
+  /**
+   * Optional file path for the document. Used by supermemoryfs to store the full
+   * path of the file.
+   */
+  filepath?: string;
+
   /**
    * Optional metadata for the document.
    */

src/resources/top-level.ts

@@ -64,6 +64,7 @@ describe('resource documents', () => {
       containerTags: ['string'],
       customId: 'customId',
       entityContext: 'entityContext',
+      filepath: 'filepath',
       metadata: { foo: 'string' },
       taskType: 'memory',
     });
@@ -92,6 +93,7 @@ describe('resource documents', () => {
           containerTag: 'user_123',
           containerTags: ['user_123', 'project_123'],
           customId: 'mem_abc123',
+          filepath: '/documents/reports/file.pdf',
           metadata: {
             category: 'technology',
             isPublic: true,
@@ -106,6 +108,7 @@ describe('resource documents', () => {
       containerTag: 'user_123',
       containerTags: ['user_123', 'project_123'],
       content: null,
+      filepath: '/documents/reports/file.pdf',
       metadata: {
         category: 'technology',
         isPublic: true,
@@ -174,6 +177,7 @@ describe('resource documents', () => {
       file: await toFile(Buffer.from('Example data'), 'README.md'),
       containerTag: 'user',
       containerTags: '["user_123", "project_123"]',
+      filepath: '/documents/reports/file.pdf',
       fileType: 'image',
       metadata: '{"category": "technology", "isPublic": true, "readingTime": 5}',
       mimeType: 'mimeType',

tests/api-resources/documents.test.ts

@@ -30,6 +30,7 @@ describe('resource search', () => {
       containerTags: ['user_123'],
       docId: 'docId',
       documentThreshold: 0,
+      filepath: '/docs/',
       filters: {
         OR: [
           {
@@ -73,6 +74,7 @@ describe('resource search', () => {
       containerTags: ['user_123'],
       docId: 'docId',
       documentThreshold: 0,
+      filepath: '/docs/',
       filters: {
         OR: [
           {
@@ -112,6 +114,7 @@ describe('resource search', () => {
       q: 'machine learning concepts',
       aggregate: false,
       containerTag: 'user_123',
+      filepath: '/docs/',
       filters: {
         OR: [
           {

tests/api-resources/search.test.ts

@@ -28,6 +28,7 @@ describe('top level methods', () => {
       containerTags: ['string'],
       customId: 'customId',
       entityContext: 'entityContext',
+      filepath: 'filepath',
       metadata: { foo: 'string' },
       taskType: 'memory',
     });