@memnexus-ai/typescript-sdk 1.75.5 → 1.76.0

package/dist/index.cjs

@@ -2430,7 +2430,7 @@ var MemoriesService = class extends BaseService {
      * @param topics - Comma-separated topic names. Memories must have at least one matching topic.
      * @param excludeTopics - Comma-separated topic names. Memories with any matching topic are excluded.
      * @param conversationId - Filter to memories belonging to the given conversation.
-     * @param scope - Filter by codeContext scope. Comma-separated key:value pairs (e.g. scope=product:memnexus,team:retrieval). Memories must match ALL specified scope pairs. Allowed keys, product, service, team, role — unknown keys return 400.
+     * @param scope - Filter by codeContext scope. Comma-separated key:value pairs (e.g. scope=product:memnexus,team:retrieval). Memories must match ALL specified scope pairs. Allowed keys, product, service, team, role — unknown keys, or input that yields no valid pairs, return 400.
      */
   async listMemories(options) {
     const request = new Request({
@@ -2698,7 +2698,7 @@ var MemoriesService = class extends BaseService {
      * @param claimsWeight - Weight for claims vector branch in hybrid search
      * @param includeFacets - Include facet aggregation (topics, memoryType, effectiveState) in response
      * @param embeddingProvider - Which embedding provider to use for query-time embedding generation and vector index lookup. `voyage` is the canonical name for the secondary provider (Voyage voyage-3.5, 1024d); `openai` is accepted as a legacy alias and now also resolves to Voyage after v1.66 P0-EMBED-SWAP. Falls back to ollama when the secondary provider is unavailable.
-     * @param scope - Filter by codeContext scope. Comma-separated key:value pairs (e.g. scope=product:memnexus,service:core-api). Memories must match ALL specified scope pairs. Allowed keys, product, service, team, role — unknown keys return 400.
+     * @param scope - Filter by codeContext scope. Comma-separated key:value pairs (e.g. scope=product:memnexus,service:core-api). Memories must match ALL specified scope pairs. Allowed keys, product, service, team, role — unknown keys, or input that yields no valid pairs, return 400.
      * @param taskId - Task-scoped retrieval: returns own-history first, fills remainder with cross-task results.
      * @param outcomeFilter - Filter by task outcome. Use 'resolved' to find successful approaches from past tasks.
      */
@@ -3357,6 +3357,27 @@ var MemoriesService = class extends BaseService {
   matching into a single call. Eliminates the 5+ round-trip pattern agents
   use today.
   
+  **Project scoping (optional).** Send `scope` as comma-separated
+  `key:value` pairs (allowed keys: `product`, `service`, `team`, `role`) —
+  the same format the list and search endpoints accept — to restrict the
+  briefing to one project. All pairs must match (AND), so each extra key
+  can only shrink the result set; send the fewest keys that identify the
+  project (`product:<project>` is the recommended default). An unknown
+  key, or a `scope` string that yields no valid `key:value` pair at all,
+  returns 400 — a scope request that cannot be honoured is never
+  silently downgraded to an unscoped briefing.
+  
+  When `scope` is set, memories that carry no `codeContext` at all are
+  excluded by default: a scoped request returns scoped content only. Send
+  `includeUnscoped: true` to also include unlabeled memories. Without
+  `scope` the flag is inert — accepted, no filter runs, and neither field
+  is echoed in `meta`. Omitting `scope` reproduces today's behavior exactly.
+  
+  Two sections cannot be scope-filtered and are named in
+  `meta.unfilteredSections` on any scoped request rather than being served
+  as if they had been filtered: `relatedPatterns` (Pattern nodes carry no
+  `codeContext`) and `commitContext` (an account-wide adoption count).
+  
      * @param body - Request body
      */
   async buildContext(body) {
@@ -7894,7 +7915,11 @@ var buildContextRequest = import_zod.z.object({
   /** 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()
+  recentHours: import_zod.z.number().min(1).max(720).optional(),
+  /** Comma-separated codeContext key:value pairs to filter by. Allowed keys: product, service, team, role. All pairs must match (AND), so each extra key can only shrink the result set — a key your memories do not consistently carry will silently empty the brief. Send the fewest keys that identify the project; product:<project> alone is the recommended default. An unknown key, or a string that yields no valid key:value pair at all, returns 400 rather than an unscoped brief. */
+  scope: import_zod.z.string().max(200).optional(),
+  /** When scope is set, whether to also return memories that carry no codeContext at all. Defaults to false when scope is set — a scoped request returns scoped content only. Send true to also include memories that carry no codeContext. Inert when scope is absent. */
+  includeUnscoped: import_zod.z.boolean().optional()
 });
 var buildContextActiveWork = import_zod.z.object({
   /** Conversation ID */
@@ -7954,6 +7979,12 @@ var buildContextMeta = import_zod.z.object({
   contextTerms: import_zod.z.array(import_zod.z.string()),
   /** Hours window used for recent activity */
   recentHours: import_zod.z.number(),
+  /** The parsed codeContext scope the request was filtered by. Present only when the request sent a scope. */
+  scope: import_zod.z.object({}).catchall(import_zod.z.string()).optional(),
+  /** The RESOLVED includeUnscoped value the request ran with — false when the caller sent scope and omitted the field. Present only when the request sent a scope; without scope the flag is inert and is not echoed. */
+  includeUnscoped: import_zod.z.boolean().optional(),
+  /** Sections the scope filter did not constrain, so a caller never has to assume a section was filtered when it was not. relatedPatterns cannot be scoped (Pattern nodes carry no codeContext and no path back to a source memory); commitContext is an account-wide adoption count by design. Present only when the request sent a scope. */
+  unfilteredSections: import_zod.z.array(import_zod.z.string()).optional(),
   /** Sections whose backing query exceeded the per-branch timeout and were returned empty. Present only when at least one branch timed out, so an empty section can otherwise be read as 'no data'. */
   timedOutSections: import_zod.z.array(import_zod.z.string()).optional()
 });