@papr/memory 1.5.0 → 1.6.0

package/src/internal/detect-platform.ts

@@ -85,10 +85,10 @@ const getPlatformProperties = (): PlatformProperties => {
     return {
       'X-Stainless-Lang': 'js',
       'X-Stainless-Package-Version': VERSION,
-      'X-Stainless-OS': normalizePlatform((globalThis as any).process.platform),
-      'X-Stainless-Arch': normalizeArch((globalThis as any).process.arch),
+      'X-Stainless-OS': normalizePlatform((globalThis as any).process.platform ?? 'unknown'),
+      'X-Stainless-Arch': normalizeArch((globalThis as any).process.arch ?? 'unknown'),
       'X-Stainless-Runtime': 'node',
-      'X-Stainless-Runtime-Version': (globalThis as any).process.version,
+      'X-Stainless-Runtime-Version': (globalThis as any).process.version ?? 'unknown',
     };
   }
 

package/src/internal/shim-types.ts

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+/**
+ * Shims for types that we can't always rely on being available globally.
+ *
+ * Note: these only exist at the type-level, there is no corresponding runtime
+ * version for any of these symbols.
+ */
+
+type NeverToAny<T> = T extends never ? any : T;
+
+/** @ts-ignore */
+type _DOMReadableStream<R = any> = globalThis.ReadableStream<R>;
+
+/** @ts-ignore */
+type _NodeReadableStream<R = any> = import('stream/web').ReadableStream<R>;
+
+type _ConditionalNodeReadableStream<R = any> =
+  typeof globalThis extends { ReadableStream: any } ? never : _NodeReadableStream<R>;
+
+type _ReadableStream<R = any> = NeverToAny<
+  | ([0] extends [1 & _DOMReadableStream<R>] ? never : _DOMReadableStream<R>)
+  | ([0] extends [1 & _ConditionalNodeReadableStream<R>] ? never : _ConditionalNodeReadableStream<R>)
+>;
+
+export type { _ReadableStream as ReadableStream };

package/src/internal/shims.ts

@@ -7,8 +7,8 @@
  * messages in cases where an environment isn't fully supported.
  */
 
-import { type Fetch } from './builtin-types';
-import { type ReadableStream } from './shim-types';
+import type { Fetch } from './builtin-types';
+import type { ReadableStream } from './shim-types';
 
 export function getDefaultFetch(): Fetch {
   if (typeof fetch !== 'undefined') {

package/src/internal/uploads.ts

@@ -138,7 +138,7 @@ export const createForm = async <T = Record<string, unknown>>(
 
 // We check for Blob not File because Bun.File doesn't inherit from File,
 // but they both inherit from Blob and have a `name` property at runtime.
-const isNamedBlob = (value: object) => value instanceof Blob && 'name' in value;
+const isNamedBlob = (value: unknown) => value instanceof Blob && 'name' in value;
 
 const isUploadable = (value: unknown) =>
   typeof value === 'object' &&

package/src/resources/document.ts

@@ -1,38 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import { APIPromise } from '../core/api-promise';
-import { RequestOptions } from '../internal/request-options';
 
-export 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> {
-    const { post_objectId, skip_background_processing } = params ?? {};
-    return this._client.post('/v1/document', {
-      query: { post_objectId, skip_background_processing },
-      ...options,
-    });
-  }
-}
+export class Document extends APIResource {}
 
 /**
  * Response model for a single memory item in add_memory response
@@ -47,94 +17,6 @@ export interface AddMemoryItem {
   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 namespace DocumentUploadResponse {
-  /**
-   * Status and progress of the document upload
-   */
-  export 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,
-  };
+  export { type AddMemoryItem as AddMemoryItem };
 }

package/src/resources/index.ts

@@ -1,11 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  Document,
-  type AddMemoryItem,
-  type DocumentUploadResponse,
-  type DocumentUploadParams,
-} from './document';
+export { Document, type AddMemoryItem } from './document';
 export {
   Memory,
   type AddMemory,

package/src/resources/memory.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 MemoryAPI from './memory';
 import * as DocumentAPI from './document';
 import { APIPromise } from '../core/api-promise';
 import { buildHeaders } from '../internal/headers';
@@ -83,6 +84,7 @@ export class Memory extends APIResource {
    * const addMemoryResponse = await client.memory.add({
    *   content:
    *     'Meeting notes from the product planning session',
+   *   type: 'text',
    * });
    * ```
    */
@@ -114,9 +116,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 +168,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 +204,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 +223,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;
 }
 
 /**
@@ -266,9 +275,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;
+
+  'emoji tags'?: Array<string> | null;
+
+  'emotion tags'?: Array<string> | null;
+
+  external_user_id?: string | null;
+
+  external_user_read_access?: Array<string> | null;
 
-  'emotion tags'?: string | null;
+  external_user_write_access?: Array<string> | null;
 
   /**
    * Hierarchical structures to enable navigation from broad topics to specific ones
@@ -277,13 +298,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 +316,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 +340,7 @@ export interface RelationshipItem {
 
   relation_type: string;
 
-  metadata?: unknown;
+  metadata?: Record<string, unknown>;
 }
 
 export interface SearchResponse {
@@ -368,7 +395,7 @@ export namespace SearchResponse {
 
       user_id: string;
 
-      context?: string | null;
+      context?: Array<MemoryAPI.ContextItem> | null;
 
       conversation_id?: string;
 
@@ -376,6 +403,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 +419,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 +449,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 +517,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 +566,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 +609,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 +654,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 +701,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 +759,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 +816,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 +869,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 +914,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 +1000,11 @@ export namespace MemoryUpdateResponse {
     content?: string | null;
 
     memoryChunkIds?: Array<string> | null;
+
+    /**
+     * Metadata for memory request
+     */
+    metadata?: MemoryAPI.MemoryMetadata | null;
   }
 
   /**
@@ -1061,6 +1154,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 +1179,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 +1196,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 +1230,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 +1251,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

@@ -48,8 +48,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
@@ -97,7 +97,7 @@ export interface UserResponse {
 
   external_id?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: Record<string, unknown> | null;
 
   updated_at?: string | null;
 
@@ -167,7 +167,7 @@ export interface UserCreateParams {
 
   email?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: Record<string, unknown> | null;
 
   type?: UserType;
 }
@@ -177,7 +177,7 @@ export interface UserUpdateParams {
 
   external_id?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: Record<string, unknown> | null;
 
   type?: UserType | null;
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.5.0'; // x-release-please-version
+export const VERSION = '1.6.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.5.0";
+export declare const VERSION = "1.6.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.0'; // x-release-please-version
+exports.VERSION = '1.6.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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

package/src/internal/shim-types.d.ts

@@ -1,28 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-/**
- * Shims for types that we can't always rely on being available globally.
- *
- * Note: these only exist at the type-level, there is no corresponding runtime
- * version for any of these symbols.
- */
-
-/**
- * In order to properly access the global `NodeJS` type, if it's available, we
- * need to make use of declaration shadowing. Without this, any checks for the
- * presence of `NodeJS.ReadableStream` will fail.
- */
-declare namespace NodeJS {
-  interface ReadableStream {}
-}
-
-type HasProperties<T> = keyof T extends never ? false : true;
-
-// @ts-ignore
-type _ReadableStream<R = any> =
-  // @ts-ignore
-  HasProperties<NodeJS.ReadableStream> extends true ? NodeJS.ReadableStream<R> : ReadableStream<R>;
-
-// @ts-ignore
-declare const _ReadableStream: unknown extends typeof ReadableStream ? never : typeof ReadableStream;
-export { _ReadableStream as ReadableStream };