@memnexus-ai/typescript-sdk 1.44.0 → 1.46.0

package/dist/index.cjs

@@ -49,6 +49,14 @@ __export(index_exports, {
   batchGetMemoriesRequest: () => batchGetMemoriesRequest,
   batchGetMemoriesResponse: () => batchGetMemoriesResponse,
   billingOverview: () => billingOverview,
+  buildContextActiveWork: () => buildContextActiveWork,
+  buildContextActivity: () => buildContextActivity,
+  buildContextFact: () => buildContextFact,
+  buildContextGotcha: () => buildContextGotcha,
+  buildContextMeta: () => buildContextMeta,
+  buildContextPattern: () => buildContextPattern,
+  buildContextRequest: () => buildContextRequest,
+  buildContextResponse: () => buildContextResponse,
   checkoutSessionResponse: () => checkoutSessionResponse,
   community: () => community,
   conversation: () => conversation,
@@ -1818,11 +1826,18 @@ var MonitoringService = class extends BaseService {
 // src/services/memories-service.ts
 var MemoriesService = class extends BaseService {
   /**
-   * Get memory by ID
-   * Retrieve a specific memory by its ID
-   * @param id - The memory ID
-   */
-  async getMemoryById(id) {
+     * Get memory by ID
+     * Retrieve a specific memory by its ID with configurable detail level.
+  
+  **Detail levels:**
+  - `minimal` — raw memory only, no extra queries
+  - `standard` (default) — adds userTopics, extractedTopics, entities, facts, relationships
+  - `full` — adds conversationContext (title, memoryCount, position) and relationship target previews
+  
+     * @param id - The memory ID
+     * @param detail - Detail level: minimal (raw memory), standard (default, + topics/entities/facts/relationships), full (+ conversation context and relationship previews)
+     */
+  async getMemoryById(id, options) {
     const request = new Request({
       baseUrl: this.config.baseUrl || "http://localhost:3000",
       method: "GET",
@@ -1846,6 +1861,18 @@ var MemoriesService = class extends BaseService {
       isOffset: false,
       isCursor: false
     });
+    if (options?.detail !== void 0) {
+      request.addQueryParam("detail", {
+        key: "detail",
+        value: options.detail,
+        explode: false,
+        encode: true,
+        style: "form",
+        isLimit: false,
+        isOffset: false,
+        isCursor: false
+      });
+    }
     return this.client.call(request);
   }
   /**
@@ -2609,6 +2636,34 @@ var MemoriesService = class extends BaseService {
     }
     return this.client.call(request);
   }
+  /**
+     * Build a context briefing
+     * Answers "What should I know before working on X?" by combining active work
+  detection, fact retrieval, gotcha detection, recent activity, and pattern
+  matching into a single call. Eliminates the 5+ round-trip pattern agents
+  use today.
+  
+     * @param body - Request body
+     */
+  async buildContext(body) {
+    const request = new Request({
+      baseUrl: this.config.baseUrl || "http://localhost:3000",
+      method: "POST",
+      path: "/api/memories/build-context",
+      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.
@@ -2645,11 +2700,12 @@ var MemoriesService = class extends BaseService {
   /**
      * Get a memory by name
      * Retrieve the current HEAD version of a named memory by its user-assigned name.
-  Returns the memory with topic breakdown and entities, same as GET /api/memories/{id}.
+  Supports the same detail levels as GET /api/memories/{id}.
   
      * @param name - Memory name (kebab-case, 2-64 chars)
+     * @param detail - Detail level: minimal (raw memory), standard (default, + topics/entities/facts/relationships), full (+ conversation context and relationship previews)
      */
-  async getMemoryByName(name) {
+  async getMemoryByName(name, options) {
     const request = new Request({
       baseUrl: this.config.baseUrl || "http://localhost:3000",
       method: "GET",
@@ -2673,6 +2729,18 @@ var MemoriesService = class extends BaseService {
       isOffset: false,
       isCursor: false
     });
+    if (options?.detail !== void 0) {
+      request.addQueryParam("detail", {
+        key: "detail",
+        value: options.detail,
+        explode: false,
+        encode: true,
+        style: "form",
+        isLimit: false,
+        isOffset: false,
+        isCursor: false
+      });
+    }
     return this.client.call(request);
   }
   /**
@@ -4948,7 +5016,9 @@ var namedMemoryHistoryResponse = import_zod.z.object({
 });
 var batchGetMemoriesRequest = import_zod.z.object({
   /** Array of memory IDs to retrieve */
-  ids: import_zod.z.array(import_zod.z.string().uuid()).min(1).max(100)
+  ids: import_zod.z.array(import_zod.z.string().uuid()).min(1).max(100),
+  /** Detail level for each memory. 'minimal' returns raw memory only (default, backward compatible). 'standard' adds topics, entities, facts, and relationships. */
+  detail: import_zod.z.enum(["minimal", "standard"]).optional()
 });
 var batchGetMemoriesMeta = import_zod.z.object({
   /** Number of IDs requested */
@@ -5828,6 +5898,87 @@ var digestResponse = import_zod.z.lazy(() => import_zod.z.object({
   /** Source memories used to generate the digest, for traceability */
   sources: import_zod.z.array(digestSource)
 }));
+var buildContextRequest = import_zod.z.object({
+  /** What you are about to work on */
+  context: import_zod.z.string().min(1).max(2e3),
+  /** File paths you will be touching */
+  files: import_zod.z.array(import_zod.z.string()).optional(),
+  /** How far back to look for recent activity (hours, default 24) */
+  recentHours: import_zod.z.number().min(1).max(720).optional()
+});
+var buildContextActiveWork = import_zod.z.object({
+  /** Conversation ID */
+  conversationId: import_zod.z.string(),
+  /** Conversation title */
+  title: import_zod.z.string().nullable(),
+  /** ISO 8601 timestamp of last activity */
+  lastActivity: import_zod.z.string(),
+  /** Most recent memory in this conversation */
+  lastMemory: import_zod.z.object({
+    /** Memory ID */
+    id: import_zod.z.string(),
+    /** Truncated content summary */
+    summary: import_zod.z.string()
+  })
+}).nullable();
+var buildContextFact = import_zod.z.object({
+  /** Fact subject */
+  subject: import_zod.z.string(),
+  /** Fact predicate */
+  predicate: import_zod.z.string(),
+  /** Fact object */
+  object: import_zod.z.string(),
+  /** Confidence score (0-1) */
+  confidence: import_zod.z.number(),
+  /** Memory this fact was extracted from */
+  sourceMemoryId: import_zod.z.string()
+});
+var buildContextGotcha = import_zod.z.object({
+  /** The gotcha fact text */
+  fact: import_zod.z.string(),
+  /** Number of distinct source memories mentioning this */
+  sourceCount: import_zod.z.number(),
+  /** Source memory IDs */
+  sourceMemories: import_zod.z.array(import_zod.z.string()),
+  /** ISO 8601 timestamp of most recent source */
+  lastSeen: import_zod.z.string()
+});
+var buildContextActivity = import_zod.z.object({
+  /** Memory ID */
+  id: import_zod.z.string(),
+  /** Truncated content summary (max 200 chars) */
+  summary: import_zod.z.string(),
+  /** ISO 8601 timestamp */
+  date: import_zod.z.string(),
+  /** Conversation ID */
+  conversationId: import_zod.z.string().nullable()
+});
+var buildContextPattern = import_zod.z.object({
+  /** Pattern description */
+  pattern: import_zod.z.string(),
+  /** Confidence score (0-1) */
+  confidence: import_zod.z.number()
+});
+var buildContextMeta = import_zod.z.object({
+  /** Search terms extracted from the context and files */
+  contextTerms: import_zod.z.array(import_zod.z.string()),
+  /** Hours window used for recent activity */
+  recentHours: import_zod.z.number()
+});
+var buildContextResponse = import_zod.z.lazy(() => import_zod.z.object({
+  /** Most relevant active conversation, or null if none found */
+  activeWork: buildContextActiveWork,
+  /** Facts related to the context terms */
+  relevantFacts: import_zod.z.array(buildContextFact),
+  /** Gotchas — facts appearing in 2+ source memories */
+  gotchas: import_zod.z.array(buildContextGotcha),
+  /** Recent relevant memories within the time window */
+  recentActivity: import_zod.z.array(buildContextActivity),
+  /** Behavioral patterns related to the context */
+  relatedPatterns: import_zod.z.array(buildContextPattern),
+  /** Request metadata for transparency */
+  meta: buildContextMeta
+}));
 
 // src/index.ts
 var Memnexus = class {
@@ -6004,6 +6155,14 @@ var index_default = Memnexus;
   batchGetMemoriesRequest,
   batchGetMemoriesResponse,
   billingOverview,
+  buildContextActiveWork,
+  buildContextActivity,
+  buildContextFact,
+  buildContextGotcha,
+  buildContextMeta,
+  buildContextPattern,
+  buildContextRequest,
+  buildContextResponse,
   checkoutSessionResponse,
   community,
   conversation,