@papr/memory 1.8.3 → 1.10.0

package/src/resources/memory.ts

@@ -167,6 +167,17 @@ 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.
    *
+   *     **HIGHLY RECOMMENDED SETTINGS FOR BEST RESULTS:**
+   *     - 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
+   *
+   *     **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:
+   *     - "customer feedback" → identifies your customers first, then finds their specific feedback
+   *     - "project issues" → identifies your projects first, then finds related issues
+   *     - "team meeting notes" → identifies your team members first, then finds meeting notes
+   *
    *     **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.
@@ -282,6 +293,8 @@ export interface ContextItem {
  * Metadata for memory request
  */
 export interface MemoryMetadata {
+  assistantMessage?: string | null;
+
   conversationId?: string | null;
 
   /**
@@ -305,6 +318,8 @@ export interface MemoryMetadata {
 
   external_user_write_access?: Array<string> | null;
 
+  goalClassificationScores?: Array<number> | null;
+
   /**
    * Hierarchical structures to enable navigation from broad topics to specific ones
    */
@@ -314,22 +329,38 @@ export interface MemoryMetadata {
 
   pageId?: string | null;
 
+  post?: string | null;
+
+  relatedGoals?: Array<string> | null;
+
+  relatedSteps?: Array<string> | null;
+
+  relatedUseCases?: Array<string> | null;
+
   role_read_access?: Array<string> | null;
 
   role_write_access?: Array<string> | null;
 
+  sessionId?: string | null;
+
   sourceType?: string | null;
 
   sourceUrl?: string | null;
 
+  stepClassificationScores?: Array<number> | null;
+
   topics?: Array<string> | null;
 
+  useCaseClassificationScores?: Array<number> | null;
+
   user_id?: string | null;
 
   user_read_access?: Array<string> | null;
 
   user_write_access?: Array<string> | null;
 
+  userMessage?: string | null;
+
   workspace_id?: string | null;
 
   workspace_read_access?: Array<string> | null;
@@ -348,13 +379,21 @@ export type MemoryType = 'text' | 'code_snippet' | 'document';
  * Relationship item for memory request
  */
 export interface RelationshipItem {
-  related_item_id: 'TextMemoryItem' | 'previous_memory_item_id';
+  relation_type: string;
 
-  related_item_type: 'TextMemoryItem';
+  metadata?: { [key: string]: unknown };
 
-  relation_type: string;
+  related_item_id?: string | null;
+
+  /**
+   * Legacy field - not used in processing
+   */
+  related_item_type?: string | null;
 
-  metadata?: unknown;
+  /**
+   * Enum for relationship types
+   */
+  relationship_type?: 'previous_memory_item_id' | 'all_previous_memory_items' | 'link_to_id' | null;
 }
 
 export interface SearchResponse {
@@ -378,6 +417,12 @@ export interface SearchResponse {
    */
   error?: string | null;
 
+  /**
+   * Unique identifier for this search query, maps to QueryLog objectId in Parse
+   * Server
+   */
+  search_id?: string | null;
+
   /**
    * 'success' or 'error'
    */
@@ -417,7 +462,7 @@ export namespace SearchResponse {
 
       current_step?: string | null;
 
-      customMetadata?: unknown | null;
+      customMetadata?: { [key: string]: unknown } | null;
 
       external_user_id?: string | null;
 
@@ -433,7 +478,7 @@ export namespace SearchResponse {
 
       location?: string | null;
 
-      metadata?: string | unknown | null;
+      metadata?: string | { [key: string]: unknown } | null;
 
       page?: string | null;
 
@@ -1066,6 +1111,8 @@ export namespace MemoryDeleteResponse {
     parse?: boolean;
 
     pinecone?: boolean;
+
+    qdrant?: boolean;
   }
 }
 
@@ -1230,25 +1277,39 @@ export interface MemorySearchParams {
   /**
    * Body param: Detailed search query describing what you're looking for. For best
    * results, write 2-3 sentences that include specific details, context, and time
-   * frame. For example: '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.'
+   * frame. Examples: '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.' 'What are the main issues
+   * and blockers in my current projects? Focus on technical challenges and timeline
+   * impacts.' 'Find insights about team collaboration and communication patterns
+   * from recent meetings and discussions.'
    */
   query: string;
 
   /**
-   * Query param: Maximum number of memories to return
+   * Query param: HIGHLY RECOMMENDED: Maximum number of memories to return. Use at
+   * least 15-20 for comprehensive results. Lower values (5-10) may miss relevant
+   * information. Default is 20 for optimal coverage.
    */
   max_memories?: number;
 
   /**
-   * Query param: Maximum number of neo nodes to return
+   * Query param: HIGHLY RECOMMENDED: Maximum number of neo nodes to return. Use at
+   * least 10-15 for comprehensive graph results. Lower values may miss important
+   * entity relationships. Default is 15 for optimal coverage.
    */
   max_nodes?: number;
 
   /**
-   * Body param: Whether to enable agentic graph search. Default is false (graph
-   * search is skipped). Set to true to use agentic graph search.
+   * Body param: HIGHLY RECOMMENDED: Enable agentic graph search for intelligent,
+   * context-aware results. When enabled, the system can understand ambiguous
+   * references by first identifying specific entities from your memory graph, then
+   * performing targeted searches. Examples: 'customer feedback' → identifies your
+   * customers first, then finds their specific feedback; 'project issues' →
+   * identifies your projects first, then finds related issues; 'team meeting notes'
+   * → identifies team members first, then finds meeting notes. This provides much
+   * more relevant and comprehensive results. Set to false only if you need faster,
+   * simpler keyword-based search.
    */
   enable_agentic_graph?: boolean;
 

package/src/resources/user.ts

@@ -118,7 +118,7 @@ export interface UserResponse {
 
   external_id?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: { [key: string]: unknown } | null;
 
   updated_at?: string | null;
 
@@ -212,7 +212,7 @@ export interface UserCreateParams {
 
   email?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: { [key: string]: unknown } | null;
 
   type?: UserType;
 }
@@ -222,7 +222,7 @@ export interface UserUpdateParams {
 
   external_id?: string | null;
 
-  metadata?: unknown | null;
+  metadata?: { [key: string]: unknown } | null;
 
   type?: UserType | null;
 }
@@ -257,7 +257,7 @@ export namespace UserCreateBatchParams {
 
     email?: string | null;
 
-    metadata?: unknown | null;
+    metadata?: { [key: string]: unknown } | null;
 
     type?: UserAPI.UserType;
   }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.8.3'; // x-release-please-version
+export const VERSION = '1.10.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.js

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

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}