@maximem/synap-js-sdk 0.4.6 → 0.4.8

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { a as AnticipationCacheSnapshot } from './anticipation-cache-BMVF5sXb.cjs';
-export { b as ANY_SCOPE, A as AnticipationCache, c as AnticipationCacheOptions, B as BundleItem, C as ContextBundle, E as ExitReason, L as LookupParams, d as LookupResult, e as LookupTelemetry, S as SnapshotBundle, f as SnapshotItemPreview, g as SnapshotItemRecord } from './anticipation-cache-BMVF5sXb.cjs';
+import { a as AnticipationCacheSnapshot } from './anticipation-cache-C1rUEpaW.cjs';
+export { b as ANY_SCOPE, A as AnticipationCache, c as AnticipationCacheOptions, B as BundleItem, C as ContextBundle, E as ExitReason, L as LookupParams, d as LookupResult, e as LookupTelemetry, S as SnapshotBundle, f as SnapshotItemPreview, g as SnapshotItemRecord } from './anticipation-cache-C1rUEpaW.cjs';
 
 /**
  * AUTOGENERATED FROM synap/sdk/CONTRACT/endpoints.yaml -- DO NOT EDIT.
@@ -597,6 +597,21 @@ interface CreateMemoryOptions {
     documentCreatedAt?: string | Date | null;
     mode?: IngestMode | string;
     metadata?: Json;
+    /**
+     * The level this memory belongs to, named in full, one entry per level down
+     * to it: `{ customer: "acme", team: "payments", user: "dana" }`.
+     *
+     * Only needed by an account whose scope ladder has a level between its
+     * customer and its user levels. `user_id` and `customer_id` cannot say which
+     * one a write belongs to, so on such a ladder the server refuses the write
+     * rather than guessing: a wrong guess at or above the customer level crosses
+     * a tenant boundary.
+     *
+     * Omit it and nothing changes. Sending one to an account without nested
+     * scoping is an error rather than ignored, because a caller who asks to be
+     * narrowed and is ignored gets widened instead.
+     */
+    scope?: Record<string, string> | null;
 }
 /**
  * Mirrors Python's `CreateMemoryResponse`.
@@ -672,6 +687,21 @@ interface CreateFromFileOptions {
     documentType?: string;
     mode?: IngestMode | string;
     metadata?: Json;
+    /**
+     * The level this memory belongs to, named in full, one entry per level down
+     * to it: `{ customer: "acme", team: "payments", user: "dana" }`.
+     *
+     * Only needed by an account whose scope ladder has a level between its
+     * customer and its user levels. `user_id` and `customer_id` cannot say which
+     * one a write belongs to, so on such a ladder the server refuses the write
+     * rather than guessing: a wrong guess at or above the customer level crosses
+     * a tenant boundary.
+     *
+     * Omit it and nothing changes. Sending one to an account without nested
+     * scoping is an error rather than ignored, because a caller who asks to be
+     * narrowed and is ignored gets widened instead.
+     */
+    scope?: Record<string, string> | null;
 }
 interface UpdateMemoryOptions {
     memory_id?: string;
@@ -1409,8 +1439,15 @@ declare class SynapClient {
     shutdown(): Promise<void>;
 }
 
-/** Kept in sync with package.json by the release workflow. */
-declare const SDK_VERSION = "1.0.0-beta.0";
+/**
+ * Kept in sync with package.json by the release workflow, in the
+ * "Sync SDK_VERSION to the resolved version" step of publish-npm-js-sdk.yml.
+ *
+ * Until that step existed nothing kept it in sync, so this constant sat at
+ * 1.0.0-beta.0 while the package shipped 0.4.x, and every request's User-Agent
+ * and every telemetry event reported a version that was never released.
+ */
+declare const SDK_VERSION = "0.4.7";
 
 /**
  * Synap SDK error taxonomy.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as AnticipationCacheSnapshot } from './anticipation-cache-BMVF5sXb.js';
-export { b as ANY_SCOPE, A as AnticipationCache, c as AnticipationCacheOptions, B as BundleItem, C as ContextBundle, E as ExitReason, L as LookupParams, d as LookupResult, e as LookupTelemetry, S as SnapshotBundle, f as SnapshotItemPreview, g as SnapshotItemRecord } from './anticipation-cache-BMVF5sXb.js';
+import { a as AnticipationCacheSnapshot } from './anticipation-cache-C1rUEpaW.js';
+export { b as ANY_SCOPE, A as AnticipationCache, c as AnticipationCacheOptions, B as BundleItem, C as ContextBundle, E as ExitReason, L as LookupParams, d as LookupResult, e as LookupTelemetry, S as SnapshotBundle, f as SnapshotItemPreview, g as SnapshotItemRecord } from './anticipation-cache-C1rUEpaW.js';
 
 /**
  * AUTOGENERATED FROM synap/sdk/CONTRACT/endpoints.yaml -- DO NOT EDIT.
@@ -597,6 +597,21 @@ interface CreateMemoryOptions {
     documentCreatedAt?: string | Date | null;
     mode?: IngestMode | string;
     metadata?: Json;
+    /**
+     * The level this memory belongs to, named in full, one entry per level down
+     * to it: `{ customer: "acme", team: "payments", user: "dana" }`.
+     *
+     * Only needed by an account whose scope ladder has a level between its
+     * customer and its user levels. `user_id` and `customer_id` cannot say which
+     * one a write belongs to, so on such a ladder the server refuses the write
+     * rather than guessing: a wrong guess at or above the customer level crosses
+     * a tenant boundary.
+     *
+     * Omit it and nothing changes. Sending one to an account without nested
+     * scoping is an error rather than ignored, because a caller who asks to be
+     * narrowed and is ignored gets widened instead.
+     */
+    scope?: Record<string, string> | null;
 }
 /**
  * Mirrors Python's `CreateMemoryResponse`.
@@ -672,6 +687,21 @@ interface CreateFromFileOptions {
     documentType?: string;
     mode?: IngestMode | string;
     metadata?: Json;
+    /**
+     * The level this memory belongs to, named in full, one entry per level down
+     * to it: `{ customer: "acme", team: "payments", user: "dana" }`.
+     *
+     * Only needed by an account whose scope ladder has a level between its
+     * customer and its user levels. `user_id` and `customer_id` cannot say which
+     * one a write belongs to, so on such a ladder the server refuses the write
+     * rather than guessing: a wrong guess at or above the customer level crosses
+     * a tenant boundary.
+     *
+     * Omit it and nothing changes. Sending one to an account without nested
+     * scoping is an error rather than ignored, because a caller who asks to be
+     * narrowed and is ignored gets widened instead.
+     */
+    scope?: Record<string, string> | null;
 }
 interface UpdateMemoryOptions {
     memory_id?: string;
@@ -1409,8 +1439,15 @@ declare class SynapClient {
     shutdown(): Promise<void>;
 }
 
-/** Kept in sync with package.json by the release workflow. */
-declare const SDK_VERSION = "1.0.0-beta.0";
+/**
+ * Kept in sync with package.json by the release workflow, in the
+ * "Sync SDK_VERSION to the resolved version" step of publish-npm-js-sdk.yml.
+ *
+ * Until that step existed nothing kept it in sync, so this constant sat at
+ * 1.0.0-beta.0 while the package shipped 0.4.x, and every request's User-Agent
+ * and every telemetry event reported a version that was never released.
+ */
+declare const SDK_VERSION = "0.4.7";
 
 /**
  * Synap SDK error taxonomy.

package/dist/index.js

@@ -30,9 +30,10 @@ import {
   CONTRACT,
   THRESHOLDS,
   isRecallQuery,
+  rungKey,
   stem,
   tokenize
-} from "./chunk-6LDUDKHS.js";
+} from "./chunk-ODVOQOSO.js";
 import {
   getEnv
 } from "./chunk-QBCVMPGK.js";
@@ -853,6 +854,10 @@ function buildCreateBody(options) {
     ),
     user_id: either(o2, "user_id", "userId") ?? null,
     customer_id: either(o2, "customer_id", "customerId") ?? null,
+    // null, never `{}`. An empty path is not absence: the server treats one as
+    // an error, because a caller asking to be narrowed and being ignored gets
+    // widened instead.
+    scope: options.scope ?? null,
     mode,
     metadata: options.metadata ?? {}
   };
@@ -1201,7 +1206,8 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
         onFetched(
           response,
           id,
-          options.user_id ?? options.userId
+          options.user_id ?? options.userId,
+          options.scope_path ?? options.scopePath
         );
         return response;
       },
@@ -1396,7 +1402,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
       if (client !== null) {
         throw new ListeningAlreadyActiveError("Listening is already active on this instance");
       }
-      const { GrpcStreamClient } = await import("./stream-client-6V4FGKZ3.js");
+      const { GrpcStreamClient } = await import("./stream-client-2C5KIOWP.js");
       const onContext = options.on_context ?? options.onContext;
       const onDisconnect = options.on_disconnect ?? options.onDisconnect;
       const onReconnect = options.on_reconnect ?? options.onReconnect;
@@ -1490,7 +1496,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.0.0-beta.0";
+var SDK_VERSION = "0.4.7";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -1940,16 +1946,16 @@ function mergeUserSummary(response, bundle) {
 
 // src/context/anticipated.ts
 function scopeLookupParams(scope, params) {
-  const { searchQuery, entityId, customerId, clientId, conversationId } = params;
+  const { searchQuery, entityId, customerId, clientId, conversationId, scopeRung } = params;
   switch (scope) {
     case "conversation":
-      return { searchQuery, entityId, customerId, clientId, conversationId };
+      return { searchQuery, entityId, customerId, clientId, conversationId, scopeRung };
     case "user":
-      return { searchQuery, entityId, customerId, clientId };
+      return { searchQuery, entityId, customerId, clientId, scopeRung };
     case "customer":
-      return { searchQuery, entityId: null, customerId, clientId };
+      return { searchQuery, entityId: null, customerId, clientId, scopeRung };
     case "client":
-      return { searchQuery, entityId: null, customerId: null, clientId };
+      return { searchQuery, entityId: null, customerId: null, clientId, scopeRung };
   }
 }
 function buildAnticipationResponse(hit) {
@@ -1984,6 +1990,7 @@ function tryServeFromCache(cache, scope, params, maxItems) {
       customerId: scoped.customerId ?? null,
       clientId: scoped.clientId ?? null,
       conversationId: scoped.conversationId ?? null,
+      scopeRung: scoped.scopeRung ?? null,
       maxItems
     });
     if (hit === null) return { response: null, hit: null };
@@ -2496,7 +2503,15 @@ var SynapClient = class {
             entityId: o2["user_id"] ?? o2["userId"],
             customerId: o2["customer_id"] ?? o2["customerId"],
             clientId: this.#transport.currentCredentials().clientId || null,
-            conversationId: o2["conversation_id"] ?? o2["conversationId"]
+            conversationId: o2["conversation_id"] ?? o2["conversationId"],
+            // The rung this read is addressed to, in the same words the server
+            // stamped on the bundles it pushed. Without it the cache matched
+            // on entity and conversation alone, so a bundle prefetched for one
+            // rung answered a caller standing at another, entirely inside this
+            // process and invisible to every server log.
+            scopeRung: rungKey(
+              o2["scope_path"] ?? o2["scopePath"]
+            )
           },
           Number(o2["max_results"] ?? o2["maxResults"] ?? 10)
         );
@@ -2541,9 +2556,9 @@ var SynapClient = class {
       ({ conversationId, role, content, timestamp }) => {
         this.#shortTerm.appendTurn(conversationId, role, content, timestamp);
       },
-      (response, conversationId, userId) => {
+      (response, conversationId, userId, scopePath) => {
         overlayLocalRecentTurns(response, this.#shortTerm, conversationId, this.#stVerbatimOverlay);
-        this.#injectUserSummary(response, conversationId, userId);
+        this.#injectUserSummary(response, conversationId, userId, rungKey(scopePath));
       },
       {
         prompt: (conversationId, style) => this.#localPrompt(conversationId, style),
@@ -2908,11 +2923,11 @@ var SynapClient = class {
    * cannot be scoped, and an unscoped lookup is how user A's summary ends up in
    * user B's response.
    */
-  #injectUserSummary(response, conversationId, userId) {
+  #injectUserSummary(response, conversationId, userId, scopeRung) {
     this.#turns.increment(conversationId);
     if (userId === void 0 || userId === "") return;
     if (!this.#turns.shouldInject(conversationId)) return;
-    const summary = this.#anticipationCache.lookupUserSummary(userId);
+    const summary = this.#anticipationCache.lookupUserSummary(userId, scopeRung);
     if (summary === null) return;
     mergeUserSummary(response, summary);
   }