@papr/memory 1.19.0 → 2.0.0

package/src/resources/memory.ts

@@ -97,8 +97,12 @@ export class Memory extends APIResource {
    * ```
    */
   add(params: MemoryAddParams, options?: RequestOptions): APIPromise<AddMemoryResponse> {
-    const { skip_background_processing, ...body } = params;
-    return this._client.post('/v1/memory', { query: { skip_background_processing }, body, ...options });
+    const { enable_holographic, format, skip_background_processing, ...body } = params;
+    return this._client.post('/v1/memory', {
+      query: { enable_holographic, format, skip_background_processing },
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -189,8 +193,12 @@ export class Memory extends APIResource {
    * const searchResponse = await client.memory.get('memory_id');
    * ```
    */
-  get(memoryID: string, options?: RequestOptions): APIPromise<SearchResponse> {
-    return this._client.get(path`/v1/memory/${memoryID}`, options);
+  get(
+    memoryID: string,
+    query: MemoryGetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SearchResponse> {
+    return this._client.get(path`/v1/memory/${memoryID}`, { query, ...options });
   }
 
   /**
@@ -202,6 +210,16 @@ export class Memory extends APIResource {
    *     - API Key in `X-API-Key` header
    *     - Session token in `X-Session-Token` header
    *
+   *     **Response Format Options**:
+   *     Choose between standard JSON or TOON (Token-Oriented Object Notation) format:
+   *     - **JSON (default)**: Standard JSON response format
+   *     - **TOON**: Optimized format achieving 30-60% token reduction for LLM contexts
+   *       - Use `response_format=toon` query parameter
+   *       - Returns `text/plain` with TOON-formatted content
+   *       - Ideal for LLM integrations to reduce API costs and latency
+   *       - Maintains semantic clarity while minimizing token usage
+   *       - Example: `/v1/memory/search?response_format=toon`
+   *
    *     **Custom Schema Support**:
    *     This endpoint supports both system-defined and custom user-defined node types:
    *     - **System nodes**: Memory, Person, Company, Project, Task, Insight, Meeting, Opportunity, Code
@@ -226,6 +244,7 @@ export class Memory extends APIResource {
    *     - Set `enable_agentic_graph: true` for intelligent, context-aware search that can understand ambiguous references
    *     - Use `max_memories: 15-20` for comprehensive memory coverage
    *     - Use `max_nodes: 10-15` for comprehensive graph entity relationships
+   *     - Use `response_format: toon` when integrating with LLMs to reduce token costs by 30-60%
    *
    *     **Agentic Graph Benefits:**
    *     When enabled, the system can understand vague references by first identifying specific entities from your memory graph, then performing targeted searches. For example:
@@ -253,9 +272,9 @@ export class Memory extends APIResource {
    * ```
    */
   search(params: MemorySearchParams, options?: RequestOptions): APIPromise<SearchResponse> {
-    const { max_memories, max_nodes, 'Accept-Encoding': acceptEncoding, ...body } = params;
+    const { max_memories, max_nodes, response_format, 'Accept-Encoding': acceptEncoding, ...body } = params;
     return this._client.post('/v1/memory/search', {
-      query: { max_memories, max_nodes },
+      query: { max_memories, max_nodes, response_format },
       body,
       ...options,
       headers: buildHeaders([
@@ -276,15 +295,61 @@ export interface AddMemory {
   content: string;
 
   /**
-   * Context can be conversation history or any relevant context for a memory item
+   * Conversation history context for this memory. Use for providing message history
+   * when adding a memory. Format: [{role: 'user'|'assistant', content: '...'}]
    */
   context?: Array<ContextItem> | null;
 
   /**
-   * Graph generation configuration
+   * Your application's user identifier. This is the primary way to identify users.
+   * Use this for your app's user IDs (e.g., 'user_alice_123', UUID, email). Papr
+   * will automatically resolve or create internal users as needed.
+   */
+  external_user_id?: string | null;
+
+  /**
+   * @deprecated Graph generation configuration
    */
   graph_generation?: GraphGeneration | null;
 
+  /**
+   * Shorthand DSL for node/edge constraints. Expands to
+   * memory_policy.node_constraints and edge_constraints. Formats: - String:
+   * 'Task:title' (semantic match on Task.title) - List: ['Task:title',
+   * 'Person:email'] (multiple constraints) - Dict: {'Task:title': {'set': {...}}}
+   * (with options) Syntax: - Node: 'Type:property', 'Type:prop=value' (exact),
+   * 'Type:prop~value' (semantic) - Edge: 'Source->EDGE->Target:property' (arrow
+   * syntax) - Via: 'Type.via(EDGE->Target:prop)' (relationship traversal) - Special:
+   * '$this', '$previous', '$context:N' Example:
+   * 'SecurityBehavior->MITIGATES->TacticDef:name' with {'create': 'never'}
+   */
+  link_to?: string | Array<string> | { [key: string]: unknown } | null;
+
+  /**
+   * Unified memory processing policy.
+   *
+   * This is the SINGLE source of truth for how a memory should be processed,
+   * combining graph generation control AND OMO (Open Memory Object) safety
+   * standards.
+   *
+   * **Graph Generation Modes:**
+   *
+   * - auto: LLM extracts entities freely (default)
+   * - manual: Developer provides exact nodes (no LLM extraction)
+   *
+   * **OMO Safety Standards:**
+   *
+   * - consent: How data owner allowed storage (explicit, implicit, terms, none)
+   * - risk: Safety assessment (none, sensitive, flagged)
+   * - acl: Access control list for read/write permissions
+   *
+   * **Schema Integration:**
+   *
+   * - schema_id: Reference a schema that may have its own default memory_policy
+   * - Schema-level policies are merged with request-level (request takes precedence)
+   */
+  memory_policy?: Shared.MemoryPolicy | null;
+
   /**
    * Metadata for memory request
    */
@@ -303,7 +368,10 @@ export interface AddMemory {
   organization_id?: string | null;
 
   /**
-   * Array of relationships that we can use in Graph DB (neo4J)
+   * @deprecated DEPRECATED: Use 'memory_policy' instead. Migration options: 1.
+   * Specific memory: relationships=[{source: '$this', target: 'mem_123', type:
+   * 'FOLLOWS'}] 2. Previous memory: link_to_previous_memory=True 3. Related
+   * memories: link_to_related_memories=3
    */
   relationships_json?: Array<RelationshipItem> | null;
 
@@ -311,6 +379,12 @@ export interface AddMemory {
    * Memory item type; defaults to 'text' if omitted
    */
   type?: MemoryType;
+
+  /**
+   * @deprecated DEPRECATED: Use 'external_user_id' instead. Internal Papr Parse user
+   * ID. Most developers should not use this field directly.
+   */
+  user_id?: string | null;
 }
 
 /**
@@ -356,11 +430,6 @@ export interface AutoGraphGeneration {
    * Force AI to use this specific schema instead of auto-selecting
    */
   schema_id?: string | null;
-
-  /**
-   * Limit AI to system + one user schema for consistency
-   */
-  simple_schema_mode?: boolean;
 }
 
 export namespace AutoGraphGeneration {
@@ -585,6 +654,12 @@ export namespace ManualGraphGeneration {
  * Metadata for memory request
  */
 export interface MemoryMetadata {
+  /**
+   * @deprecated DEPRECATED: Use 'memory_policy.acl' at request level instead.
+   * Format: {'read': [...], 'write': [...]}.
+   */
+  acl?: { [key: string]: Array<string> } | null;
+
   assistantMessage?: string | null;
 
   /**
@@ -593,6 +668,12 @@ export interface MemoryMetadata {
    */
   category?: 'preference' | 'task' | 'goal' | 'fact' | 'context' | 'skills' | 'learning' | null;
 
+  /**
+   * @deprecated DEPRECATED: Use 'memory_policy.consent' at request level instead.
+   * Values: 'explicit', 'implicit' (default), 'terms', 'none'.
+   */
+  consent?: string | null;
+
   conversationId?: string | null;
 
   /**
@@ -610,10 +691,22 @@ export interface MemoryMetadata {
 
   'emotion tags'?: Array<string> | null;
 
+  /**
+   * @deprecated DEPRECATED: Use 'external_user_id' at request level instead. This
+   * field will be removed in v2.
+   */
   external_user_id?: string | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
   external_user_read_access?: Array<string> | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
   external_user_write_access?: Array<string> | null;
 
   goalClassificationScores?: Array<number> | null;
@@ -621,14 +714,46 @@ export interface MemoryMetadata {
   /**
    * Hierarchical structures to enable navigation from broad topics to specific ones
    */
-  hierarchical_structures?: string | null;
+  hierarchical_structures?: string | Array<unknown> | null;
 
   location?: string | null;
 
+  /**
+   * @deprecated DEPRECATED: Use 'namespace_id' at request level instead. This field
+   * will be removed in v2.
+   */
   namespace_id?: string | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
+  namespace_read_access?: Array<string> | null;
+
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
+  namespace_write_access?: Array<string> | null;
+
+  /**
+   * @deprecated DEPRECATED: Use 'organization_id' at request level instead. This
+   * field will be removed in v2.
+   */
   organization_id?: string | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
+  organization_read_access?: Array<string> | null;
+
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
+  organization_write_access?: Array<string> | null;
+
   pageId?: string | null;
 
   post?: string | null;
@@ -639,13 +764,27 @@ export interface MemoryMetadata {
 
   relatedUseCases?: Array<string> | null;
 
+  /**
+   * @deprecated DEPRECATED: Use 'memory_policy.risk' at request level instead.
+   * Values: 'none' (default), 'sensitive', 'flagged'.
+   */
+  risk?: string | null;
+
   /**
    * Role of the message sender
    */
   role?: 'user' | 'assistant' | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
   role_read_access?: Array<string> | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
   role_write_access?: Array<string> | null;
 
   sessionId?: string | null;
@@ -665,18 +804,38 @@ export interface MemoryMetadata {
 
   useCaseClassificationScores?: Array<number> | null;
 
+  /**
+   * @deprecated DEPRECATED: Use 'external_user_id' at request level instead. This
+   * field will be removed in v2.
+   */
   user_id?: string | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
   user_read_access?: Array<string> | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
   user_write_access?: Array<string> | null;
 
   userMessage?: string | null;
 
   workspace_id?: string | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
   workspace_read_access?: Array<string> | null;
 
+  /**
+   * INTERNAL: Auto-populated for vector store filtering. Use memory_policy.acl
+   * instead.
+   */
   workspace_write_access?: Array<string> | null;
 
   [k: string]: unknown;
@@ -746,7 +905,7 @@ export namespace SearchResponse {
    * Return type for SearchResult
    */
   export interface Data {
-    memories: Array<Data.Memory>;
+    memories: Array<Shared.Memory>;
 
     nodes: Array<Data.Node>;
 
@@ -758,107 +917,6 @@ export namespace SearchResponse {
   }
 
   export namespace Data {
-    /**
-     * A memory item in the knowledge base
-     */
-    export interface Memory {
-      id: string;
-
-      acl: { [key: string]: { [key: string]: boolean } };
-
-      content: string;
-
-      type: string;
-
-      user_id: string;
-
-      /**
-       * Memory category based on role
-       */
-      category?: string | null;
-
-      context?: Array<MemoryAPI.ContextItem> | null;
-
-      conversation_id?: string;
-
-      created_at?: string | null;
-
-      current_step?: string | null;
-
-      customMetadata?: { [key: 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;
-
-      hierarchical_structures?: string;
-
-      location?: string | null;
-
-      metadata?: string | { [key: string]: unknown } | null;
-
-      /**
-       * Namespace ID this memory belongs to
-       */
-      namespace_id?: string | null;
-
-      /**
-       * Organization ID that owns this memory
-       */
-      organization_id?: string | null;
-
-      page?: string | null;
-
-      page_number?: number | null;
-
-      /**
-       * Role that generated this memory (user or assistant)
-       */
-      role?: string | null;
-
-      role_read_access?: Array<string> | null;
-
-      role_write_access?: Array<string> | null;
-
-      source_document_id?: string | null;
-
-      source_message_id?: string | null;
-
-      source_type?: string;
-
-      source_url?: string;
-
-      steps?: Array<string>;
-
-      tags?: Array<string>;
-
-      title?: string | null;
-
-      topics?: Array<string>;
-
-      total_pages?: number | null;
-
-      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;
-    }
-
     /**
      * Public-facing node structure - supports both system and custom schema nodes
      */
@@ -1003,6 +1061,49 @@ export interface MemoryUpdateParams {
    */
   context?: Array<ContextItem> | null;
 
+  /**
+   * Graph generation configuration
+   */
+  graph_generation?: GraphGeneration | null;
+
+  /**
+   * Shorthand DSL for node/edge constraints. Expands to
+   * memory_policy.node_constraints and edge_constraints. Formats: - String:
+   * 'Task:title' (semantic match on Task.title) - List: ['Task:title',
+   * 'Person:email'] (multiple constraints) - Dict: {'Task:title': {'set': {...}}}
+   * (with options) Syntax: - Node: 'Type:property', 'Type:prop=value' (exact),
+   * 'Type:prop~value' (semantic) - Edge: 'Source->EDGE->Target:property' (arrow
+   * syntax) - Via: 'Type.via(EDGE->Target:prop)' (relationship traversal) - Special:
+   * '$this', '$previous', '$context:N' Example:
+   * 'SecurityBehavior->MITIGATES->TacticDef:name' with {'create': 'never'}
+   */
+  link_to?: string | Array<string> | { [key: string]: unknown } | null;
+
+  /**
+   * Unified memory processing policy.
+   *
+   * This is the SINGLE source of truth for how a memory should be processed,
+   * combining graph generation control AND OMO (Open Memory Object) safety
+   * standards.
+   *
+   * **Graph Generation Modes:**
+   *
+   * - auto: LLM extracts entities freely (default)
+   * - manual: Developer provides exact nodes (no LLM extraction)
+   *
+   * **OMO Safety Standards:**
+   *
+   * - consent: How data owner allowed storage (explicit, implicit, terms, none)
+   * - risk: Safety assessment (none, sensitive, flagged)
+   * - acl: Access control list for read/write permissions
+   *
+   * **Schema Integration:**
+   *
+   * - schema_id: Reference a schema that may have its own default memory_policy
+   * - Schema-level policies are merged with request-level (request takes precedence)
+   */
+  memory_policy?: Shared.MemoryPolicy | null;
+
   /**
    * Metadata for memory request
    */
@@ -1044,22 +1145,80 @@ export interface MemoryAddParams {
    */
   content: string;
 
+  /**
+   * Query param: If True, applies holographic neural transforms and stores in
+   * holographic collection
+   */
+  enable_holographic?: boolean;
+
+  /**
+   * Query param: Response format. Use 'omo' for Open Memory Object standard format
+   * (portable across platforms).
+   */
+  format?: string | null;
+
   /**
    * Query param: If True, skips adding background tasks for processing
    */
   skip_background_processing?: boolean;
 
   /**
-   * Body param: Context can be conversation history or any relevant context for a
-   * memory item
+   * Body param: Conversation history context for this memory. Use for providing
+   * message history when adding a memory. Format: [{role: 'user'|'assistant',
+   * content: '...'}]
    */
   context?: Array<ContextItem> | null;
 
+  /**
+   * Body param: Your application's user identifier. This is the primary way to
+   * identify users. Use this for your app's user IDs (e.g., 'user_alice_123', UUID,
+   * email). Papr will automatically resolve or create internal users as needed.
+   */
+  external_user_id?: string | null;
+
   /**
    * Body param: Graph generation configuration
    */
   graph_generation?: GraphGeneration | null;
 
+  /**
+   * Body param: Shorthand DSL for node/edge constraints. Expands to
+   * memory_policy.node_constraints and edge_constraints. Formats: - String:
+   * 'Task:title' (semantic match on Task.title) - List: ['Task:title',
+   * 'Person:email'] (multiple constraints) - Dict: {'Task:title': {'set': {...}}}
+   * (with options) Syntax: - Node: 'Type:property', 'Type:prop=value' (exact),
+   * 'Type:prop~value' (semantic) - Edge: 'Source->EDGE->Target:property' (arrow
+   * syntax) - Via: 'Type.via(EDGE->Target:prop)' (relationship traversal) - Special:
+   * '$this', '$previous', '$context:N' Example:
+   * 'SecurityBehavior->MITIGATES->TacticDef:name' with {'create': 'never'}
+   */
+  link_to?: string | Array<string> | { [key: string]: unknown } | null;
+
+  /**
+   * Body param: Unified memory processing policy.
+   *
+   * This is the SINGLE source of truth for how a memory should be processed,
+   * combining graph generation control AND OMO (Open Memory Object) safety
+   * standards.
+   *
+   * **Graph Generation Modes:**
+   *
+   * - auto: LLM extracts entities freely (default)
+   * - manual: Developer provides exact nodes (no LLM extraction)
+   *
+   * **OMO Safety Standards:**
+   *
+   * - consent: How data owner allowed storage (explicit, implicit, terms, none)
+   * - risk: Safety assessment (none, sensitive, flagged)
+   * - acl: Access control list for read/write permissions
+   *
+   * **Schema Integration:**
+   *
+   * - schema_id: Reference a schema that may have its own default memory_policy
+   * - Schema-level policies are merged with request-level (request takes precedence)
+   */
+  memory_policy?: Shared.MemoryPolicy | null;
+
   /**
    * Body param: Metadata for memory request
    */
@@ -1078,7 +1237,10 @@ export interface MemoryAddParams {
   organization_id?: string | null;
 
   /**
-   * Body param: Array of relationships that we can use in Graph DB (neo4J)
+   * @deprecated Body param: DEPRECATED: Use 'memory_policy' instead. Migration
+   * options: 1. Specific memory: relationships=[{source: '$this', target: 'mem_123',
+   * type: 'FOLLOWS'}] 2. Previous memory: link_to_previous_memory=True 3. Related
+   * memories: link_to_related_memories=3
    */
   relationships_json?: Array<RelationshipItem> | null;
 
@@ -1086,6 +1248,12 @@ export interface MemoryAddParams {
    * Body param: Memory item type; defaults to 'text' if omitted
    */
   type?: MemoryType;
+
+  /**
+   * @deprecated Body param: DEPRECATED: Use 'external_user_id' instead. Internal
+   * Papr Parse user ID. Most developers should not use this field directly.
+   */
+  user_id?: string | null;
 }
 
 export interface MemoryAddBatchParams {
@@ -1105,8 +1273,9 @@ export interface MemoryAddBatchParams {
   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.
+   * Body param: Your application's user identifier for all memories in the batch.
+   * This is the primary way to identify users. Papr will automatically resolve or
+   * create internal users as needed.
    */
   external_user_id?: string | null;
 
@@ -1115,6 +1284,44 @@ export interface MemoryAddBatchParams {
    */
   graph_generation?: GraphGeneration | null;
 
+  /**
+   * Body param: Shorthand DSL for node/edge constraints. Expands to
+   * memory_policy.node_constraints and edge_constraints. Formats: - String:
+   * 'Task:title' (semantic match on Task.title) - List: ['Task:title',
+   * 'Person:email'] (multiple constraints) - Dict: {'Task:title': {'set': {...}}}
+   * (with options) Syntax: - Node: 'Type:property', 'Type:prop=value' (exact),
+   * 'Type:prop~value' (semantic) - Edge: 'Source->EDGE->Target:property' (arrow
+   * syntax) - Via: 'Type.via(EDGE->Target:prop)' (relationship traversal) - Special:
+   * '$this', '$previous', '$context:N' Example:
+   * 'SecurityBehavior->MITIGATES->TacticDef:name' with {'create': 'never'}
+   */
+  link_to?: string | Array<string> | { [key: string]: unknown } | null;
+
+  /**
+   * Body param: Unified memory processing policy.
+   *
+   * This is the SINGLE source of truth for how a memory should be processed,
+   * combining graph generation control AND OMO (Open Memory Object) safety
+   * standards.
+   *
+   * **Graph Generation Modes:**
+   *
+   * - auto: LLM extracts entities freely (default)
+   * - manual: Developer provides exact nodes (no LLM extraction)
+   *
+   * **OMO Safety Standards:**
+   *
+   * - consent: How data owner allowed storage (explicit, implicit, terms, none)
+   * - risk: Safety assessment (none, sensitive, flagged)
+   * - acl: Access control list for read/write permissions
+   *
+   * **Schema Integration:**
+   *
+   * - schema_id: Reference a schema that may have its own default memory_policy
+   * - Schema-level policies are merged with request-level (request takes precedence)
+   */
+  memory_policy?: Shared.MemoryPolicy | null;
+
   /**
    * Body param: Optional namespace ID for multi-tenant batch memory scoping. When
    * provided, all memories in the batch are associated with this namespace.
@@ -1128,8 +1335,8 @@ export interface MemoryAddBatchParams {
   organization_id?: string | null;
 
   /**
-   * Body param: Internal user ID for all memories in the batch. If not provided,
-   * developer's user ID will be used.
+   * @deprecated Body param: DEPRECATED: Use 'external_user_id' instead. Internal
+   * Papr Parse user ID.
    */
   user_id?: string | null;
 
@@ -1166,6 +1373,26 @@ export interface MemoryDeleteAllParams {
   user_id?: string | null;
 }
 
+export interface MemoryGetParams {
+  /**
+   * If true, return 404 if the memory has risk='flagged'. Filters out flagged
+   * content.
+   */
+  exclude_flagged?: boolean;
+
+  /**
+   * Maximum risk level allowed. Values: 'none', 'sensitive', 'flagged'. If memory
+   * exceeds this, return 404.
+   */
+  max_risk?: string | null;
+
+  /**
+   * If true, return 404 if the memory has consent='none'. Ensures only consented
+   * memories are returned.
+   */
+  require_consent?: boolean;
+}
+
 export interface MemorySearchParams {
   /**
    * Body param: Detailed search query describing what you're looking for. For best
@@ -1193,6 +1420,12 @@ export interface MemorySearchParams {
    */
   max_nodes?: number;
 
+  /**
+   * Query param: Response format: 'json' (default) or 'toon' (Token-Oriented Object
+   * Notation for 30-60% token reduction in LLM contexts)
+   */
+  response_format?: 'json' | 'toon';
+
   /**
    * Body param: HIGHLY RECOMMENDED: Enable agentic graph search for intelligent,
    * context-aware results. When enabled, the system can understand ambiguous
@@ -1207,12 +1440,22 @@ export interface MemorySearchParams {
   enable_agentic_graph?: boolean;
 
   /**
-   * 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.
+   * Body param: Your application's user identifier to filter search results. This is
+   * the primary way to identify users. Use this for your app's user IDs (e.g.,
+   * 'user_alice_123', UUID, email).
    */
   external_user_id?: string | null;
 
+  /**
+   * Body param: Configuration for holographic neural embedding transforms and H-COND
+   * scoring.
+   *
+   * Neural holographic embeddings use 13 brain-inspired frequency bands to encode
+   * hierarchical semantic metadata alongside the base embedding. H-COND (Holographic
+   * CONDitional) scoring uses phase alignment for improved relevance ranking.
+   */
+  holographic_config?: MemorySearchParams.HolographicConfig | null;
+
   /**
    * Body param: Metadata for memory request
    */
@@ -1224,6 +1467,14 @@ export interface MemorySearchParams {
    */
   namespace_id?: string | null;
 
+  /**
+   * Body param: Filter for Open Memory Object (OMO) safety standards in
+   * search/retrieval.
+   *
+   * Use this to filter search results by consent level and/or risk level.
+   */
+  omo_filter?: MemorySearchParams.OmoFilter | null;
+
   /**
    * Body param: Optional organization ID for multi-tenant search scoping. When
    * provided, search is scoped to memories within this organization.
@@ -1231,17 +1482,37 @@ export interface MemorySearchParams {
   organization_id?: string | 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
-   * (recommended approach). Only enable this if you're not using an LLM in your
-   * search pipeline and need additional result ranking.
+   * @deprecated Body param: DEPRECATED: Use 'reranking_config' instead. Whether to
+   * enable additional ranking of search results. Default is false because results
+   * are already ranked when using an LLM for search (recommended approach). Only
+   * enable this if you're not using an LLM in your search pipeline and need
+   * additional result ranking. Migration: Replace 'rank_results: true' with
+   * 'reranking_config: {reranking_enabled: true, reranking_provider: "cohere",
+   * reranking_model: "rerank-v3.5"}'
    */
   rank_results?: boolean;
 
   /**
-   * 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.
+   * Body param: Configuration for reranking memory search results
+   */
+  reranking_config?: MemorySearchParams.RerankingConfig | null;
+
+  /**
+   * Body param: Optional user-defined schema ID to use for this search. If provided,
+   * this schema (plus system schema) will be used for query generation. If not
+   * provided, system will automatically select relevant schema based on query
+   * content.
+   */
+  schema_id?: string | null;
+
+  /**
+   * Body param: Complete search override specification provided by developer
+   */
+  search_override?: MemorySearchParams.SearchOverride | null;
+
+  /**
+   * @deprecated Body param: DEPRECATED: Use 'external_user_id' instead. Internal
+   * Papr Parse user ID. Most developers should not use this field directly.
    */
   user_id?: string | null;
 
@@ -1251,6 +1522,186 @@ export interface MemorySearchParams {
   'Accept-Encoding'?: string;
 }
 
+export namespace MemorySearchParams {
+  /**
+   * Configuration for holographic neural embedding transforms and H-COND scoring.
+   *
+   * Neural holographic embeddings use 13 brain-inspired frequency bands to encode
+   * hierarchical semantic metadata alongside the base embedding. H-COND (Holographic
+   * CONDitional) scoring uses phase alignment for improved relevance ranking.
+   */
+  export interface HolographicConfig {
+    /**
+     * Whether to enable holographic embedding transforms
+     */
+    enabled?: boolean;
+
+    /**
+     * Maximum boost to add for high alignment (0.0-0.5)
+     */
+    hcond_boost_factor?: number;
+
+    /**
+     * Phase alignment threshold above which to apply boost (0.0-1.0)
+     */
+    hcond_boost_threshold?: number;
+
+    /**
+     * Maximum penalty for low alignment (0.0-0.5)
+     */
+    hcond_penalty_factor?: number;
+
+    /**
+     * Search mode: 'disabled' (off), 'integrated' (search transformed embeddings),
+     * 'post_search' (fetch then rerank with H-COND)
+     */
+    search_mode?: 'disabled' | 'integrated' | 'post_search';
+  }
+
+  /**
+   * Filter for Open Memory Object (OMO) safety standards in search/retrieval.
+   *
+   * Use this to filter search results by consent level and/or risk level.
+   */
+  export interface OmoFilter {
+    /**
+     * Explicitly exclude memories with these consent levels. Example:
+     * exclude_consent=['none'] filters out all memories without consent.
+     */
+    exclude_consent?: Array<'explicit' | 'implicit' | 'terms' | 'none'> | null;
+
+    /**
+     * If true, exclude all flagged content (risk == 'flagged'). Shorthand for
+     * exclude_risk=['flagged'].
+     */
+    exclude_flagged?: boolean;
+
+    /**
+     * Explicitly exclude memories with these risk levels. Example:
+     * exclude_risk=['flagged'] filters out all flagged content.
+     */
+    exclude_risk?: Array<'none' | 'sensitive' | 'flagged'> | null;
+
+    /**
+     * Post-ingest safety assessment of memory content.
+     *
+     * Aligned with Open Memory Object (OMO) standard.
+     */
+    max_risk?: 'none' | 'sensitive' | 'flagged' | null;
+
+    /**
+     * How the data owner allowed this memory to be stored/used.
+     *
+     * Aligned with Open Memory Object (OMO) standard.
+     */
+    min_consent?: 'explicit' | 'implicit' | 'terms' | 'none' | null;
+
+    /**
+     * If true, only return memories with explicit consent (consent != 'none').
+     * Shorthand for exclude_consent=['none'].
+     */
+    require_consent?: boolean;
+  }
+
+  /**
+   * Configuration for reranking memory search results
+   */
+  export interface RerankingConfig {
+    /**
+     * Whether to enable reranking of search results
+     */
+    reranking_enabled?: boolean;
+
+    /**
+     * Model to use for reranking. OpenAI (LLM): 'gpt-5-nano' (fast reasoning,
+     * default), 'gpt-5-mini' (better quality reasoning). Cohere (cross-encoder):
+     * 'rerank-v3.5' (latest), 'rerank-english-v3.0', 'rerank-multilingual-v3.0'
+     */
+    reranking_model?: string;
+
+    /**
+     * Reranking provider: 'openai' (better quality, slower) or 'cohere' (faster,
+     * optimized for reranking)
+     */
+    reranking_provider?: 'openai' | 'cohere';
+  }
+
+  /**
+   * Complete search override specification provided by developer
+   */
+  export interface SearchOverride {
+    /**
+     * Graph pattern to search for (source)-[relationship]->(target)
+     */
+    pattern: SearchOverride.Pattern;
+
+    /**
+     * Property filters to apply to the search pattern
+     */
+    filters?: Array<SearchOverride.Filter>;
+
+    /**
+     * Specific properties to return. If not specified, returns all properties.
+     */
+    return_properties?: Array<string> | null;
+  }
+
+  export namespace SearchOverride {
+    /**
+     * Graph pattern to search for (source)-[relationship]->(target)
+     */
+    export interface Pattern {
+      /**
+       * Relationship type (e.g., 'ASSOCIATED_WITH', 'WORKS_FOR'). Must match schema
+       * relationship types.
+       */
+      relationship_type: string;
+
+      /**
+       * Source node label (e.g., 'Memory', 'Person', 'Company'). Must match schema node
+       * types.
+       */
+      source_label: string;
+
+      /**
+       * Target node label (e.g., 'Person', 'Company', 'Project'). Must match schema node
+       * types.
+       */
+      target_label: string;
+
+      /**
+       * Relationship direction: '->' (outgoing), '<-' (incoming), or '-' (bidirectional)
+       */
+      direction?: string;
+    }
+
+    /**
+     * Property filters for search override
+     */
+    export interface Filter {
+      /**
+       * Node type to filter (e.g., 'Person', 'Memory', 'Company')
+       */
+      node_type: string;
+
+      /**
+       * Filter operator: 'CONTAINS', 'EQUALS', 'STARTS_WITH', 'IN'
+       */
+      operator: string;
+
+      /**
+       * Property name to filter on (e.g., 'name', 'content', 'role')
+       */
+      property_name: string;
+
+      /**
+       * Filter value(s). Use list for 'IN' operator.
+       */
+      value: string | Array<string> | number | boolean;
+    }
+  }
+}
+
 export declare namespace Memory {
   export {
     type AddMemory as AddMemory,
@@ -1272,6 +1723,7 @@ export declare namespace Memory {
     type MemoryAddParams as MemoryAddParams,
     type MemoryAddBatchParams as MemoryAddBatchParams,
     type MemoryDeleteAllParams as MemoryDeleteAllParams,
+    type MemoryGetParams as MemoryGetParams,
     type MemorySearchParams as MemorySearchParams,
   };
 }