@papr/memory 1.19.0 → 2.0.0

package/resources/memory.d.mts

@@ -151,7 +151,7 @@ export declare class Memory extends APIResource {
      * const searchResponse = await client.memory.get('memory_id');
      * ```
      */
-    get(memoryID: string, options?: RequestOptions): APIPromise<SearchResponse>;
+    get(memoryID: string, query?: MemoryGetParams | null | undefined, options?: RequestOptions): APIPromise<SearchResponse>;
     /**
      * Search through memories with authentication required.
      *
@@ -161,6 +161,16 @@ export declare 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
@@ -185,6 +195,7 @@ export declare 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:
@@ -222,13 +233,58 @@ 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
      */
@@ -244,13 +300,21 @@ 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;
     /**
      * 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;
 }
 /**
  * Unified response model for add_memory API endpoint (success or error).
@@ -289,10 +353,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 declare namespace AutoGraphGeneration {
     /**
@@ -486,12 +546,24 @@ export declare 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;
     /**
      * Memory category based on role. For users: preference, task, goal, fact, context.
      * For assistants: skills, learning, task, goal, fact, context.
      */
     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;
     /**
      * ISO datetime when the memory was created
@@ -506,27 +578,80 @@ export interface MemoryMetadata {
     } | null;
     'emoji tags'?: Array<string> | null;
     '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;
     /**
      * 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;
     relatedGoals?: Array<string> | null;
     relatedSteps?: Array<string> | null;
     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;
     sourceType?: string | null;
@@ -538,12 +663,32 @@ export interface MemoryMetadata {
      */
     upload_id?: string | null;
     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;
 }
@@ -601,7 +746,7 @@ export declare namespace SearchResponse {
      * Return type for SearchResult
      */
     interface Data {
-        memories: Array<Data.Memory>;
+        memories: Array<Shared.Memory>;
         nodes: Array<Data.Node>;
         /**
          * List of UserGraphSchema IDs used in this response. Use GET /v1/schemas/{id} to
@@ -610,73 +755,6 @@ export declare namespace SearchResponse {
         schemas_used?: Array<string> | null;
     }
     namespace Data {
-        /**
-         * A memory item in the knowledge base
-         */
-        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
          */
@@ -790,6 +868,48 @@ export interface MemoryUpdateParams {
      * Updated context for the memory item
      */
     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
      */
@@ -824,19 +944,74 @@ export interface MemoryAddParams {
      * Body param: The content of the memory item you want to add to memory
      */
     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
      */
@@ -852,13 +1027,21 @@ 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;
     /**
      * 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 {
     /**
@@ -874,14 +1057,53 @@ 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;
     /**
      * 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: Optional namespace ID for multi-tenant batch memory scoping. When
      * provided, all memories in the batch are associated with this namespace.
@@ -893,8 +1115,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;
     /**
@@ -924,6 +1146,23 @@ 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
@@ -948,6 +1187,11 @@ export interface MemorySearchParams {
      * entity relationships. Default is 15 for optimal coverage.
      */
     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
@@ -961,11 +1205,20 @@ 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
      */
@@ -975,22 +1228,46 @@ export interface MemorySearchParams {
      * provided, search is scoped to memories within this namespace.
      */
     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.
      */
     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;
     /**
@@ -998,7 +1275,162 @@ export interface MemorySearchParams {
      */
     'Accept-Encoding'?: string;
 }
+export declare 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.
+     */
+    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.
+     */
+    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
+     */
+    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
+     */
+    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;
+    }
+    namespace SearchOverride {
+        /**
+         * Graph pattern to search for (source)-[relationship]->(target)
+         */
+        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
+         */
+        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, type AddMemoryResponse as AddMemoryResponse, type AutoGraphGeneration as AutoGraphGeneration, type BatchMemoryResponse as BatchMemoryResponse, type ContextItem as ContextItem, type GraphGeneration as GraphGeneration, type HTTPValidationError as HTTPValidationError, type ManualGraphGeneration as ManualGraphGeneration, type MemoryMetadata as MemoryMetadata, type MemoryType as MemoryType, type RelationshipItem as RelationshipItem, type SearchResponse as SearchResponse, type MemoryUpdateResponse as MemoryUpdateResponse, type MemoryDeleteResponse as MemoryDeleteResponse, type MemoryUpdateParams as MemoryUpdateParams, type MemoryDeleteParams as MemoryDeleteParams, type MemoryAddParams as MemoryAddParams, type MemoryAddBatchParams as MemoryAddBatchParams, type MemoryDeleteAllParams as MemoryDeleteAllParams, type MemorySearchParams as MemorySearchParams, };
+    export { type AddMemory as AddMemory, type AddMemoryResponse as AddMemoryResponse, type AutoGraphGeneration as AutoGraphGeneration, type BatchMemoryResponse as BatchMemoryResponse, type ContextItem as ContextItem, type GraphGeneration as GraphGeneration, type HTTPValidationError as HTTPValidationError, type ManualGraphGeneration as ManualGraphGeneration, type MemoryMetadata as MemoryMetadata, type MemoryType as MemoryType, type RelationshipItem as RelationshipItem, type SearchResponse as SearchResponse, type MemoryUpdateResponse as MemoryUpdateResponse, type MemoryDeleteResponse as MemoryDeleteResponse, type MemoryUpdateParams as MemoryUpdateParams, type MemoryDeleteParams as MemoryDeleteParams, type MemoryAddParams as MemoryAddParams, type MemoryAddBatchParams as MemoryAddBatchParams, type MemoryDeleteAllParams as MemoryDeleteAllParams, type MemoryGetParams as MemoryGetParams, type MemorySearchParams as MemorySearchParams, };
 }
 //# sourceMappingURL=memory.d.mts.map