@maximem/synap-js-sdk 0.4.0 → 0.4.2

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { a as AnticipationCacheSnapshot } from './anticipation-cache-BgkqcTPJ.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-BgkqcTPJ.cjs';
+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';
 
 /**
  * AUTOGENERATED FROM synap/sdk/CONTRACT/endpoints.yaml -- DO NOT EDIT.
@@ -714,6 +714,16 @@ type WriteInvalidator = (ids: {
     customerId?: string | undefined;
 }) => void;
 
+/**
+ * Scope-aware context fetching.
+ *
+ * Scopes are client > customer > user. `conversation_id` is NOT a tier: it
+ * groups turns within a scope. Passing it narrows an existing scope rather
+ * than selecting a different one.
+ */
+
+type Scope = 'user' | 'customer' | 'client' | 'conversation';
+
 /** User namespace. Mirrors `UserInterface` in the Python SDK. */
 
 interface UserNamespace {
@@ -846,6 +856,12 @@ interface InstanceNamespace {
 /** @internal Shared with the conversation namespace so both use one stream. */
 interface InstanceInternals {
     onCompactionUpdate(conversationId: string, bundle: Record<string, unknown>): void;
+    /** Set by the client so a compaction can prune the locally buffered tail. */
+    setCompactionApplier(apply: (bundle: Record<string, unknown>) => void): void;
+    /** Learning-loop event, fired after a fetch is served from the cache. */
+    sendContextUsed(event: Record<string, unknown>): void;
+    /** Audit event, fired after every fetch resolves. */
+    sendContextAssembled(event: Record<string, unknown>): void;
     setCompactionDispatcher(dispatch: (conversationId: string, bundle: Record<string, unknown>) => void): void;
     isListening(): boolean;
 }
@@ -979,6 +995,14 @@ interface SynapClientOptions {
      */
     heartbeat?: boolean;
     fetchImpl?: typeof fetch;
+    /**
+     * Bypass the process registry and build a genuinely separate client.
+     *
+     * Underscored because it mirrors Python's `_force_new` and is not part of the
+     * everyday surface. Needed in tests, and for the rare case of deliberately
+     * running two clients on one identity with separate caches.
+     */
+    _force_new?: boolean;
 }
 interface ScopedContext {
     context: {
@@ -1310,16 +1334,6 @@ declare const TransientError: typeof SynapTransientError;
 declare const PermanentError: typeof SynapPermanentError;
 declare const ConnectionError: typeof NetworkTimeoutError;
 
-/**
- * Scope-aware context fetching.
- *
- * Scopes are client > customer > user. `conversation_id` is NOT a tier: it
- * groups turns within a scope. Passing it narrows an existing scope rather
- * than selecting a different one.
- */
-
-type Scope = 'user' | 'customer' | 'client' | 'conversation';
-
 /**
  * BM25 scorer for the anticipation cache.
  *

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as AnticipationCacheSnapshot } from './anticipation-cache-BgkqcTPJ.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-BgkqcTPJ.js';
+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';
 
 /**
  * AUTOGENERATED FROM synap/sdk/CONTRACT/endpoints.yaml -- DO NOT EDIT.
@@ -714,6 +714,16 @@ type WriteInvalidator = (ids: {
     customerId?: string | undefined;
 }) => void;
 
+/**
+ * Scope-aware context fetching.
+ *
+ * Scopes are client > customer > user. `conversation_id` is NOT a tier: it
+ * groups turns within a scope. Passing it narrows an existing scope rather
+ * than selecting a different one.
+ */
+
+type Scope = 'user' | 'customer' | 'client' | 'conversation';
+
 /** User namespace. Mirrors `UserInterface` in the Python SDK. */
 
 interface UserNamespace {
@@ -846,6 +856,12 @@ interface InstanceNamespace {
 /** @internal Shared with the conversation namespace so both use one stream. */
 interface InstanceInternals {
     onCompactionUpdate(conversationId: string, bundle: Record<string, unknown>): void;
+    /** Set by the client so a compaction can prune the locally buffered tail. */
+    setCompactionApplier(apply: (bundle: Record<string, unknown>) => void): void;
+    /** Learning-loop event, fired after a fetch is served from the cache. */
+    sendContextUsed(event: Record<string, unknown>): void;
+    /** Audit event, fired after every fetch resolves. */
+    sendContextAssembled(event: Record<string, unknown>): void;
     setCompactionDispatcher(dispatch: (conversationId: string, bundle: Record<string, unknown>) => void): void;
     isListening(): boolean;
 }
@@ -979,6 +995,14 @@ interface SynapClientOptions {
      */
     heartbeat?: boolean;
     fetchImpl?: typeof fetch;
+    /**
+     * Bypass the process registry and build a genuinely separate client.
+     *
+     * Underscored because it mirrors Python's `_force_new` and is not part of the
+     * everyday surface. Needed in tests, and for the rare case of deliberately
+     * running two clients on one identity with separate caches.
+     */
+    _force_new?: boolean;
 }
 interface ScopedContext {
     context: {
@@ -1310,16 +1334,6 @@ declare const TransientError: typeof SynapTransientError;
 declare const PermanentError: typeof SynapPermanentError;
 declare const ConnectionError: typeof NetworkTimeoutError;
 
-/**
- * Scope-aware context fetching.
- *
- * Scopes are client > customer > user. `conversation_id` is NOT a tier: it
- * groups turns within a scope. Passing it narrows an existing scope rather
- * than selecting a different one.
- */
-
-type Scope = 'user' | 'customer' | 'client' | 'conversation';
-
 /**
  * BM25 scorer for the anticipation cache.
  *