@memnexus-ai/typescript-sdk 1.31.0 → 1.31.2

package/dist/index.js

@@ -2315,6 +2315,46 @@ var MemoriesService = class extends BaseService {
     }
     return this.client.call(request);
   }
+  /**
+     * Generate memory digest
+     * Synthesizes a comprehensive, structured briefing from all relevant memories
+  on a topic. Instead of multiple search rounds, one call returns a complete digest.
+  
+  **Formats:**
+  - `structured` (default): Sections with headers, bullet points, key decisions
+  - `narrative`: Chronological prose narrative
+  - `timeline`: Dated event list
+  - `status-report`: Done/In Progress/Blocked grouping
+  
+  **Pipeline:**
+  1. Gather: High-limit search + conversation expansion
+  2. Organize: Group by conversation, status, timeline
+  3. Synthesize: LLM generates formatted digest
+  
+  Requires an LLM provider to be configured (EXTRACTION_ENABLED=true).
+  Returns 503 if the LLM provider is unavailable and 3+ memories are found.
+  
+     * @param body - Request body
+     */
+  async generateMemoryDigest(body) {
+    const request = new Request({
+      baseUrl: this.config.baseUrl || "http://localhost:3000",
+      method: "POST",
+      path: "/api/memories/digest",
+      config: this.config,
+      retry: {
+        attempts: 3,
+        delayMs: 150,
+        maxDelayMs: 5e3,
+        jitterMs: 50,
+        backoffFactor: 2
+      }
+    });
+    if (body !== void 0) {
+      request.addBody(body);
+    }
+    return this.client.call(request);
+  }
   /**
      * Get version history for a named memory
      * Returns the full version chain for a named memory, ordered newest-first.
@@ -5045,7 +5085,7 @@ var user = z.object({
   plan: z.enum(["free", "pro", "enterprise"]),
   memoryLimit: z.number(),
   retentionDays: z.number().nullable(),
-  deletionStatus: z.enum(["none", "pending_deletion", "deleted"]),
+  deletionStatus: z.enum(["none", "pending_deletion", "deleting", "deleted"]),
   deletionScheduledFor: z.string().datetime().nullable(),
   createdAt: z.string().datetime(),
   updatedAt: z.string().datetime()
@@ -5196,6 +5236,60 @@ var listPaymentMethodsResponse = z.lazy(() => z.object({
   /** List of payment methods */
   data: z.array(paymentMethod)
 }));
+var digestRequest = z.object({
+  /** The topic or subject to generate a digest for */
+  query: z.string().min(1),
+  /** Time window filter (e.g., "7d", "24h", "2w", "30m"). Only considers memories within this window. */
+  recent: z.string().optional(),
+  /** Filter to memories with these topics */
+  topics: z.array(z.string()).optional(),
+  /** Limit to specific conversation IDs */
+  conversationIds: z.array(z.string()).optional(),
+  /** Output format: "structured" (sections with headers), "narrative" (chronological prose), "timeline" (dated event list), "status-report" (done/in-progress/blocked) */
+  format: z.enum(["structured", "narrative", "timeline", "status-report"]).optional(),
+  /** Maximum number of memories to consider (1-500, default 100) */
+  maxSources: z.number().min(1).max(500).optional(),
+  /** Whether to include source memory IDs in the response */
+  includeMemoryIds: z.boolean().optional()
+});
+var digestTimeRange = z.object({
+  /** Earliest memory timestamp in the digest sources */
+  earliest: z.string().datetime(),
+  /** Latest memory timestamp in the digest sources */
+  latest: z.string().datetime()
+}).nullable();
+var digestMetadata = z.lazy(() => z.object({
+  /** The query used to generate the digest */
+  query: z.string(),
+  /** Total number of memories gathered (search + expansion) before synthesis */
+  sourcesConsidered: z.number().min(0),
+  /** Number of memories fed into the synthesis step */
+  sourcesUsed: z.number().min(0),
+  /** Number of distinct conversations the sources come from */
+  conversationsSpanned: z.number().min(0),
+  /** Time range of the source memories (null if no sources found) */
+  timeRange: digestTimeRange,
+  /** Output format used for this digest */
+  format: z.enum(["structured", "narrative", "timeline", "status-report"]),
+  /** ISO 8601 timestamp when the digest was generated */
+  generatedAt: z.string().datetime()
+}));
+var digestSource = z.object({
+  /** Source memory ID */
+  memoryId: z.string(),
+  /** Relevance score (0-1) for this source memory */
+  relevance: z.number().min(0).max(1),
+  /** Conversation ID this memory belongs to */
+  conversation: z.string().optional()
+});
+var digestResponse = z.lazy(() => z.object({
+  /** The generated digest content (markdown formatted) */
+  digest: z.string(),
+  /** Generation metadata including source statistics */
+  metadata: digestMetadata,
+  /** Source memories used to generate the digest, for traceability */
+  sources: z.array(digestSource)
+}));
 
 // src/index.ts
 var Memnexus = class {
@@ -5378,6 +5472,11 @@ export {
   createNarrativeRequest,
   createPortalSessionRequest,
   index_default as default,
+  digestMetadata,
+  digestRequest,
+  digestResponse,
+  digestSource,
+  digestTimeRange,
   entity,
   entityNode,
   error,