@papr/memory 1.5.1 → 1.7.0

package/src/resources/memory.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import * as DocumentAPI from './document';
+import * as MemoryAPI from './memory';
 import { APIPromise } from '../core/api-promise';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
@@ -83,6 +83,7 @@ export class Memory extends APIResource {
    * const addMemoryResponse = await client.memory.add({
    *   content:
    *     'Meeting notes from the product planning session',
+   *   type: 'text',
    * });
    * ```
    */
@@ -114,9 +115,11 @@ export class Memory extends APIResource {
    *     {
    *       content:
    *         'Meeting notes from the product planning session',
+   *       type: 'text',
    *     },
    *     {
    *       content: 'Follow-up tasks from the planning meeting',
+   *       type: 'text',
    *     },
    *   ],
    * });
@@ -164,11 +167,16 @@ export class Memory extends APIResource {
    *
    *     The API supports response compression for improved performance. Responses larger than 1KB will be automatically compressed when this header is present.
    *
+   *     **User Resolution Precedence:**
+   *     - If both user_id and external_user_id are provided, user_id takes precedence.
+   *     - If only external_user_id is provided, it will be resolved to the internal user.
+   *     - If neither is provided, the authenticated user is used.
+   *
    * @example
    * ```ts
    * const searchResponse = await client.memory.search({
    *   query:
-   *     'Find recurring customer complaints about API performance from the last month. Focus on issues where customers specifically mentioned timeout errors or slow response times in their conversations.',
+   *     "Find recurring customer complaints about API performance from the last month. Focus on issues that multiple customers have mentioned and any specific feature requests or workflow improvements they've suggested.",
    * });
    * ```
    */
@@ -195,6 +203,11 @@ export interface AddMemory {
    */
   content: string;
 
+  /**
+   * Valid memory types
+   */
+  type: MemoryType;
+
   /**
    * Context can be conversation history or any relevant context for a memory item
    */
@@ -209,11 +222,6 @@ export interface AddMemory {
    * Array of relationships that we can use in Graph DB (neo4J)
    */
   relationships_json?: Array<RelationshipItem> | null;
-
-  /**
-   * Content type of the memory item
-   */
-  type?: MemoryType;
 }
 
 /**
@@ -228,7 +236,7 @@ export interface AddMemoryResponse {
   /**
    * List of memory items if successful
    */
-  data?: Array<DocumentAPI.AddMemoryItem> | null;
+  data?: Array<AddMemoryResponse.Data> | null;
 
   /**
    * Additional error details or context
@@ -246,6 +254,21 @@ export interface AddMemoryResponse {
   status?: string;
 }
 
+export namespace AddMemoryResponse {
+  /**
+   * Response model for a single memory item in add_memory response
+   */
+  export interface Data {
+    createdAt: string;
+
+    memoryId: string;
+
+    objectId: string;
+
+    memoryChunkIds?: Array<string>;
+  }
+}
+
 /**
  * Context item for memory request
  */
@@ -266,9 +289,21 @@ export interface MemoryMetadata {
    */
   createdAt?: string | null;
 
-  'emoji tags'?: string | null;
+  /**
+   * Optional object for arbitrary custom metadata fields. Only string, number,
+   * boolean, or list of strings allowed. Nested dicts are not allowed.
+   */
+  customMetadata?: Record<string, string | number | boolean | Array<string>> | null;
 
-  'emotion tags'?: string | null;
+  'emoji tags'?: Array<string> | null;
+
+  'emotion tags'?: Array<string> | null;
+
+  external_user_id?: string | null;
+
+  external_user_read_access?: Array<string> | null;
+
+  external_user_write_access?: Array<string> | null;
 
   /**
    * Hierarchical structures to enable navigation from broad topics to specific ones
@@ -277,13 +312,17 @@ export interface MemoryMetadata {
 
   location?: string | null;
 
+  pageId?: string | null;
+
   role_read_access?: Array<string> | null;
 
   role_write_access?: Array<string> | null;
 
+  sourceType?: string | null;
+
   sourceUrl?: string | null;
 
-  topics?: string | null;
+  topics?: Array<string> | null;
 
   user_id?: string | null;
 
@@ -291,6 +330,8 @@ export interface MemoryMetadata {
 
   user_write_access?: Array<string> | null;
 
+  workspace_id?: string | null;
+
   workspace_read_access?: Array<string> | null;
 
   workspace_write_access?: Array<string> | null;
@@ -313,7 +354,7 @@ export interface RelationshipItem {
 
   relation_type: string;
 
-  metadata?: unknown;
+  metadata?: Record<string, unknown>;
 }
 
 export interface SearchResponse {
@@ -368,7 +409,7 @@ export namespace SearchResponse {
 
       user_id: string;
 
-      context?: string | null;
+      context?: Array<MemoryAPI.ContextItem> | null;
 
       conversation_id?: string;
 
@@ -376,6 +417,14 @@ export namespace SearchResponse {
 
       current_step?: string | null;
 
+      customMetadata?: Record<string, unknown> | null;
+
+      external_user_id?: string | null;
+
+      external_user_read_access?: Array<string> | null;
+
+      external_user_write_access?: Array<string> | null;
+
       file_url?: string | null;
 
       filename?: string | null;
@@ -384,12 +433,16 @@ export namespace SearchResponse {
 
       location?: string | null;
 
-      metadata?: string | unknown | null;
+      metadata?: string | Record<string, unknown> | null;
 
       page?: string | null;
 
       page_number?: number | null;
 
+      role_read_access?: Array<string> | null;
+
+      role_write_access?: Array<string> | null;
+
       source_document_id?: string | null;
 
       source_message_id?: string | null;
@@ -410,8 +463,16 @@ export namespace SearchResponse {
 
       updated_at?: string | null;
 
+      user_read_access?: Array<string> | null;
+
+      user_write_access?: Array<string> | null;
+
       workspace_id?: string | null;
 
+      workspace_read_access?: Array<string> | null;
+
+      workspace_write_access?: Array<string> | null;
+
       [k: string]: unknown;
     }
 
@@ -470,6 +531,10 @@ export namespace SearchResponse {
 
         emoji_tags?: Array<string> | null;
 
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         hierarchical_structures?: string | null;
 
         pageId?: string | null;
@@ -515,6 +580,10 @@ export namespace SearchResponse {
 
         createdAt?: string | null;
 
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         pageId?: string | null;
 
         role_read_access?: Array<string> | null;
@@ -554,6 +623,10 @@ export namespace SearchResponse {
 
         createdAt?: string | null;
 
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         pageId?: string | null;
 
         role_read_access?: Array<string> | null;
@@ -595,6 +668,10 @@ export namespace SearchResponse {
 
         createdAt?: string | null;
 
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         pageId?: string | null;
 
         role_read_access?: Array<string> | null;
@@ -638,6 +715,15 @@ export namespace SearchResponse {
 
         createdAt?: string | null;
 
+        /**
+         * Due date for the task in ISO 8601 format
+         */
+        date?: string | null;
+
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         pageId?: string | null;
 
         role_read_access?: Array<string> | null;
@@ -687,6 +773,10 @@ export namespace SearchResponse {
 
         createdAt?: string | null;
 
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         pageId?: string | null;
 
         role_read_access?: Array<string> | null;
@@ -740,6 +830,10 @@ export namespace SearchResponse {
 
         createdAt?: string | null;
 
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         pageId?: string | null;
 
         role_read_access?: Array<string> | null;
@@ -789,6 +883,10 @@ export namespace SearchResponse {
 
         createdAt?: string | null;
 
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         pageId?: string | null;
 
         role_read_access?: Array<string> | null;
@@ -830,6 +928,10 @@ export namespace SearchResponse {
 
         createdAt?: string | null;
 
+        external_user_read_access?: Array<string> | null;
+
+        external_user_write_access?: Array<string> | null;
+
         pageId?: string | null;
 
         role_read_access?: Array<string> | null;
@@ -912,6 +1014,11 @@ export namespace MemoryUpdateResponse {
     content?: string | null;
 
     memoryChunkIds?: Array<string> | null;
+
+    /**
+     * Metadata for memory request
+     */
+    metadata?: MemoryAPI.MemoryMetadata | null;
   }
 
   /**
@@ -1061,6 +1168,11 @@ export interface MemoryAddParams {
    */
   content: string;
 
+  /**
+   * Body param: Valid memory types
+   */
+  type: MemoryType;
+
   /**
    * Query param: If True, skips adding background tasks for processing
    */
@@ -1081,11 +1193,6 @@ export interface MemoryAddParams {
    * Body param: Array of relationships that we can use in Graph DB (neo4J)
    */
   relationships_json?: Array<RelationshipItem> | null;
-
-  /**
-   * Body param: Content type of the memory item
-   */
-  type?: MemoryType;
 }
 
 export interface MemoryAddBatchParams {
@@ -1103,6 +1210,18 @@ export interface MemoryAddBatchParams {
    * Body param: Number of items to process in parallel
    */
   batch_size?: number | null;
+
+  /**
+   * Body param: External user ID for all memories in the batch. If provided and
+   * user_id is not, will be resolved to internal user ID.
+   */
+  external_user_id?: string | null;
+
+  /**
+   * Body param: Internal user ID for all memories in the batch. If not provided,
+   * developer's user ID will be used.
+   */
+  user_id?: string | null;
 }
 
 export interface MemorySearchParams {
@@ -1125,6 +1244,18 @@ export interface MemorySearchParams {
    */
   max_nodes?: number;
 
+  /**
+   * Body param: Optional external user ID to filter search results by a specific
+   * external user. If both user_id and external_user_id are provided, user_id takes
+   * precedence.
+   */
+  external_user_id?: string | null;
+
+  /**
+   * Body param: Metadata for memory request
+   */
+  metadata?: MemoryMetadata | null;
+
   /**
    * Body param: Whether to enable additional ranking of search results. Default is
    * false because results are already ranked when using an LLM for search
@@ -1134,8 +1265,9 @@ export interface MemorySearchParams {
   rank_results?: boolean;
 
   /**
-   * Body param: Optional user ID to filter search results by a specific user. If not
-   * provided, results are not filtered by user.
+   * Body param: Optional internal user ID to filter search results by a specific
+   * user. If not provided, results are not filtered by user. If both user_id and
+   * external_user_id are provided, user_id takes precedence.
    */
   user_id?: string | null;
 

package/src/resources/user.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as UserAPI from './user';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
@@ -48,8 +49,8 @@ export class User extends APIResource {
   }
 
   /**
-   * Delete user association with developer and the user itself by user_id
-   * (\_User.objectId)
+   * Delete user association with developer and the user itself by , assume external
+   * user_id is provided, and resolve to internal user_id (\_User.objectId)
    *
    * @example
    * ```ts
@@ -60,6 +61,21 @@ export class User extends APIResource {
     return this._client.delete(path`/v1/user/${userID}`, options);
   }
 
+  /**
+   * Create multiple users or link existing users to developer, and add each to the
+   * developer's workspace (if one exists).
+   *
+   * @example
+   * ```ts
+   * const response = await client.user.createBatch({
+   *   users: [{ external_id: 'user123' }],
+   * });
+   * ```
+   */
+  createBatch(body: UserCreateBatchParams, options?: RequestOptions): APIPromise<UserCreateBatchResponse> {
+    return this._client.post('/v1/user/batch', { body, ...options });
+  }
+
   /**
    * Get user details by user_id (\_User.objectId) and developer association
    *
@@ -97,7 +113,7 @@ export interface UserResponse {
 
   external_id?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: Record<string, unknown> | null;
 
   updated_at?: string | null;
 
@@ -162,12 +178,36 @@ export interface UserDeleteResponse {
   user_id?: string | null;
 }
 
+export interface UserCreateBatchResponse {
+  /**
+   * HTTP status code
+   */
+  code: number;
+
+  /**
+   * 'success' or 'error'
+   */
+  status: string;
+
+  data?: Array<UserResponse> | null;
+
+  details?: unknown;
+
+  error?: string | null;
+
+  page?: number | null;
+
+  page_size?: number | null;
+
+  total?: number | null;
+}
+
 export interface UserCreateParams {
   external_id: string;
 
   email?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: Record<string, unknown> | null;
 
   type?: UserType;
 }
@@ -177,7 +217,7 @@ export interface UserUpdateParams {
 
   external_id?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: Record<string, unknown> | null;
 
   type?: UserType | null;
 }
@@ -192,14 +232,35 @@ export interface UserListParams {
   page_size?: number;
 }
 
+export interface UserCreateBatchParams {
+  users: Array<UserCreateBatchParams.User>;
+}
+
+export namespace UserCreateBatchParams {
+  /**
+   * Request model for creating a user
+   */
+  export interface User {
+    external_id: string;
+
+    email?: string | null;
+
+    metadata?: Record<string, unknown> | null;
+
+    type?: UserAPI.UserType;
+  }
+}
+
 export declare namespace User {
   export {
     type UserResponse as UserResponse,
     type UserType as UserType,
     type UserListResponse as UserListResponse,
     type UserDeleteResponse as UserDeleteResponse,
+    type UserCreateBatchResponse as UserCreateBatchResponse,
     type UserCreateParams as UserCreateParams,
     type UserUpdateParams as UserUpdateParams,
     type UserListParams as UserListParams,
+    type UserCreateBatchParams as UserCreateBatchParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.5.1'; // x-release-please-version
+export const VERSION = '1.7.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.5.1";
+export declare const VERSION = "1.7.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.5.1";
+export declare const VERSION = "1.7.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.5.1'; // x-release-please-version
+exports.VERSION = '1.7.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.5.1'; // x-release-please-version
+export const VERSION = '1.7.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map

package/resources/document.d.mts

@@ -1,103 +0,0 @@
-import { APIResource } from "../core/resource.mjs";
-import { APIPromise } from "../core/api-promise.mjs";
-import { RequestOptions } from "../internal/request-options.mjs";
-export declare class Document extends APIResource {
-    /**
-     * Upload a document (PDF/HTML/TXT) to be processed and added to memory.
-     *
-     *     **Authentication Required**:
-     *     One of the following authentication methods must be used:
-     *     - Bearer token in `Authorization` header
-     *     - API Key in `X-API-Key` header
-     *     - Session token in `X-Session-Token` header
-     *
-     *     **Required Headers**:
-     *     - Content-Type: multipart/form-data
-     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
-     *
-     *     **Form Data**:
-     *     - file: The document file to upload (PDF/HTML/TXT)
-     *     - metadata: (optional) JSON string containing additional metadata
-     */
-    upload(params?: DocumentUploadParams | null | undefined, options?: RequestOptions): APIPromise<DocumentUploadResponse>;
-}
-/**
- * Response model for a single memory item in add_memory response
- */
-export interface AddMemoryItem {
-    createdAt: string;
-    memoryId: string;
-    objectId: string;
-    memoryChunkIds?: Array<string>;
-}
-export interface DocumentUploadResponse {
-    /**
-     * Status and progress of the document upload
-     */
-    document_status: DocumentUploadResponse.DocumentStatus;
-    /**
-     * HTTP status code
-     */
-    code?: number;
-    /**
-     * Additional error details or context
-     */
-    details?: unknown;
-    /**
-     * Error message if failed
-     */
-    error?: string | null;
-    /**
-     * For backward compatibility
-     */
-    memories?: Array<AddMemoryItem> | null;
-    /**
-     * List of memory items created from the document
-     */
-    memory_items?: Array<AddMemoryItem>;
-    /**
-     * Human-readable status message
-     */
-    message?: string | null;
-    /**
-     * 'success', 'processing', 'error', etc.
-     */
-    status?: string;
-}
-export declare namespace DocumentUploadResponse {
-    /**
-     * Status and progress of the document upload
-     */
-    interface DocumentStatus {
-        /**
-         * 0.0 to 1.0 for percentage
-         */
-        progress: number;
-        current_filename?: string | null;
-        current_page?: number | null;
-        /**
-         * Error message if failed
-         */
-        error?: string | null;
-        /**
-         * Processing status type
-         */
-        status_type?: 'processing' | 'completed' | 'failed' | 'not_found' | 'queued' | 'cancelled' | null;
-        total_pages?: number | null;
-        upload_id?: string | null;
-    }
-}
-export interface DocumentUploadParams {
-    /**
-     * Optional Post objectId for updating status
-     */
-    post_objectId?: string | null;
-    /**
-     * If True, skips adding background tasks for processing
-     */
-    skip_background_processing?: boolean;
-}
-export declare namespace Document {
-    export { type AddMemoryItem as AddMemoryItem, type DocumentUploadResponse as DocumentUploadResponse, type DocumentUploadParams as DocumentUploadParams, };
-}
-//# sourceMappingURL=document.d.mts.map

package/resources/document.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"document.d.mts","sourceRoot":"","sources":["../src/resources/document.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,MAAM,GAAE,oBAAoB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;CAOtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,CAAC;IAEjB,QAAQ,EAAE,MAAM,CAAC;IAEjB,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,eAAe,EAAE,sBAAsB,CAAC,cAAc,CAAC;IAEvD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yBAAiB,sBAAsB,CAAC;IACtC;;OAEG;IACH,UAAiB,cAAc;QAC7B;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE7B;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEtB;;WAEG;QACH,WAAW,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,IAAI,CAAC;QAElG,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}