@maximem/synap-js-sdk 0.4.8 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/anticipation-cache-LRE3TLK4.cjs.map +1 -1
- package/dist/{chunk-T5QQBJ6T.js → chunk-ASM2OIIG.js} +292 -7
- package/dist/chunk-ASM2OIIG.js.map +1 -0
- package/dist/{chunk-OCMM2Z5P.js → chunk-BWMPKLFG.js} +40 -2
- package/dist/chunk-BWMPKLFG.js.map +1 -0
- package/dist/{chunk-7CWBRHUO.cjs → chunk-IA2N5NUY.cjs} +302 -17
- package/dist/chunk-IA2N5NUY.cjs.map +1 -0
- package/dist/{chunk-2TVL5IPQ.cjs → chunk-T372OL3Q.cjs} +41 -3
- package/dist/chunk-T372OL3Q.cjs.map +1 -0
- package/dist/chunk-T6U5PVAD.cjs.map +1 -1
- package/dist/chunk-ZKOJDUN4.cjs.map +1 -1
- package/dist/env-55ULHNJZ.cjs.map +1 -1
- package/dist/errors-Bl3vY1eb.d.cts +382 -0
- package/dist/errors-Bl3vY1eb.d.ts +382 -0
- package/dist/grpc/index.cjs +7 -7
- package/dist/grpc/index.cjs.map +1 -1
- package/dist/grpc/index.d.cts +44 -4
- package/dist/grpc/index.d.ts +44 -4
- package/dist/grpc/index.js +5 -5
- package/dist/index.cjs +278 -161
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +97 -148
- package/dist/index.d.ts +97 -148
- package/dist/index.js +171 -54
- package/dist/index.js.map +1 -1
- package/dist/stream-client-6OWRYOA4.js +16 -0
- package/dist/stream-client-Y5JGSF2R.cjs +16 -0
- package/dist/stream-client-Y5JGSF2R.cjs.map +1 -0
- package/package.json +1 -1
- package/dist/anticipation-cache-C1rUEpaW.d.cts +0 -211
- package/dist/anticipation-cache-C1rUEpaW.d.ts +0 -211
- package/dist/chunk-2TVL5IPQ.cjs.map +0 -1
- package/dist/chunk-7CWBRHUO.cjs.map +0 -1
- package/dist/chunk-OCMM2Z5P.js.map +0 -1
- package/dist/chunk-T5QQBJ6T.js.map +0 -1
- package/dist/stream-client-2C5KIOWP.js +0 -7
- package/dist/stream-client-GPU37E6F.cjs +0 -7
- package/dist/stream-client-GPU37E6F.cjs.map +0 -1
- /package/dist/{stream-client-2C5KIOWP.js.map → stream-client-6OWRYOA4.js.map} +0 -0
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import {
|
|
2
|
+
CREDIT_ABORT_DETAILS,
|
|
3
|
+
CREDIT_STOP_REASONS,
|
|
4
|
+
GrpcStreamClient,
|
|
5
|
+
creditErrorFromRpc,
|
|
6
|
+
isCreditStop
|
|
7
|
+
} from "./chunk-ASM2OIIG.js";
|
|
8
|
+
import "./chunk-BWMPKLFG.js";
|
|
9
|
+
export {
|
|
10
|
+
CREDIT_ABORT_DETAILS,
|
|
11
|
+
CREDIT_STOP_REASONS,
|
|
12
|
+
GrpcStreamClient,
|
|
13
|
+
creditErrorFromRpc,
|
|
14
|
+
isCreditStop
|
|
15
|
+
};
|
|
16
|
+
//# sourceMappingURL=stream-client-6OWRYOA4.js.map
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
"use strict";Object.defineProperty(exports, "__esModule", {value: true});
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
var _chunkIA2N5NUYcjs = require('./chunk-IA2N5NUY.cjs');
|
|
8
|
+
require('./chunk-T372OL3Q.cjs');
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
exports.CREDIT_ABORT_DETAILS = _chunkIA2N5NUYcjs.CREDIT_ABORT_DETAILS; exports.CREDIT_STOP_REASONS = _chunkIA2N5NUYcjs.CREDIT_STOP_REASONS; exports.GrpcStreamClient = _chunkIA2N5NUYcjs.GrpcStreamClient; exports.creditErrorFromRpc = _chunkIA2N5NUYcjs.creditErrorFromRpc; exports.isCreditStop = _chunkIA2N5NUYcjs.isCreditStop;
|
|
16
|
+
//# sourceMappingURL=stream-client-Y5JGSF2R.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["/Users/scaler/maximem_synap/synap/sdk/js/dist/stream-client-Y5JGSF2R.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACF,oUAAC","file":"/Users/scaler/maximem_synap/synap/sdk/js/dist/stream-client-Y5JGSF2R.cjs"}
|
package/package.json
CHANGED
|
@@ -1,211 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* In-memory TTL cache for context bundles pushed over gRPC.
|
|
3
|
-
*
|
|
4
|
-
* Port of `maximem_synap/cache/anticipation_cache.py`.
|
|
5
|
-
*
|
|
6
|
-
* ## Why this is a faithful port and not a simplification
|
|
7
|
-
*
|
|
8
|
-
* `@maximem/synap-vercel-adk` already contains a native TS anticipation cache,
|
|
9
|
-
* and it is a simplification: a hardcoded 30-minute TTL, a plain BM25 threshold
|
|
10
|
-
* with no per-query derivation, and none of the gates below. Shipping that as
|
|
11
|
-
* the SDK's cache would mean two retrieval behaviors under one brand, which is
|
|
12
|
-
* gotcha G-C. Every gate here exists because a specific eval failed without it:
|
|
13
|
-
*
|
|
14
|
-
* - **Recall bypass** runs BEFORE scoring. The measured false hit scored 2.86
|
|
15
|
-
* at coverage 1.00, so no score-side gate could ever have caught it.
|
|
16
|
-
* - **The novel-term gate** is suppressed below a 200-stem corpus, because at
|
|
17
|
-
* cold start ordinary English trips it on nearly every query.
|
|
18
|
-
* - **The per-query threshold** scales down for short queries, which otherwise
|
|
19
|
-
* cannot reach the nominal score at all.
|
|
20
|
-
* - **The coverage gate** catches a bundle that clears BM25 on one shared
|
|
21
|
-
* token ("account") while lacking the asked-for fact.
|
|
22
|
-
*
|
|
23
|
-
* All thresholds come from the shared behavior contract.
|
|
24
|
-
*/
|
|
25
|
-
/** Sentinel scope that matches any requester. */
|
|
26
|
-
declare const ANY_SCOPE = "_any";
|
|
27
|
-
interface BundleItem {
|
|
28
|
-
item_id?: string;
|
|
29
|
-
content?: string;
|
|
30
|
-
[key: string]: unknown;
|
|
31
|
-
}
|
|
32
|
-
interface ContextBundle {
|
|
33
|
-
bundleId: string;
|
|
34
|
-
entityId?: string | null;
|
|
35
|
-
conversationId?: string | null;
|
|
36
|
-
itemsByType: Record<string, BundleItem[]>;
|
|
37
|
-
/** Server hint; may only SHORTEN the global TTL, never extend it. */
|
|
38
|
-
ttlHintSeconds?: number | null;
|
|
39
|
-
/** Which anticipation pattern produced this bundle. Diagnostics only. */
|
|
40
|
-
bundleType?: string | null;
|
|
41
|
-
/** The queries the server anticipated. Diagnostics only. */
|
|
42
|
-
searchQueries?: readonly string[] | null;
|
|
43
|
-
/**
|
|
44
|
-
* The scope rung the server retrieved this bundle at, as `rungKey` writes
|
|
45
|
-
* one. Absent from anything an older server sent, which reads as "named no
|
|
46
|
-
* rung" rather than as "matches anything".
|
|
47
|
-
*/
|
|
48
|
-
scopeRung?: string | null;
|
|
49
|
-
}
|
|
50
|
-
interface LookupResult {
|
|
51
|
-
itemsByType: Record<string, BundleItem[]>;
|
|
52
|
-
bundleIds: string[];
|
|
53
|
-
score: number;
|
|
54
|
-
coverage: number;
|
|
55
|
-
}
|
|
56
|
-
interface LookupParams {
|
|
57
|
-
searchQuery?: readonly string[] | null;
|
|
58
|
-
entityId?: string | null;
|
|
59
|
-
customerId?: string | null;
|
|
60
|
-
clientId?: string | null;
|
|
61
|
-
conversationId?: string | null;
|
|
62
|
-
/**
|
|
63
|
-
* The rung this request names, from its `scope_path`. A SECOND, independent
|
|
64
|
-
* dimension and NOT another tier of the entity funnel: the funnel widens and
|
|
65
|
-
* the rung does not, because a rung is a boundary and a boundary that widens
|
|
66
|
-
* is not one.
|
|
67
|
-
*/
|
|
68
|
-
scopeRung?: string | null;
|
|
69
|
-
maxItems?: number;
|
|
70
|
-
}
|
|
71
|
-
type ExitReason = 'empty' | 'recall_bypass' | 'no_query_tokens' | 'novel_term_gate' | 'empty_corpus' | 'no_items_above_threshold' | 'coverage_gate' | 'hit';
|
|
72
|
-
interface LookupTelemetry {
|
|
73
|
-
searchQuery: string[];
|
|
74
|
-
entityId: string | null;
|
|
75
|
-
customerId: string | null;
|
|
76
|
-
clientId: string | null;
|
|
77
|
-
conversationId: string | null;
|
|
78
|
-
scopeRung: string | null;
|
|
79
|
-
scopeFilterAccepted: string[];
|
|
80
|
-
novelTermRatio: number | null;
|
|
81
|
-
bm25Threshold: number | null;
|
|
82
|
-
bm25QueryTokens: string[];
|
|
83
|
-
itemsPicked: unknown[];
|
|
84
|
-
itemsRejected: unknown[];
|
|
85
|
-
coverage: number | null;
|
|
86
|
-
hit: boolean;
|
|
87
|
-
exitReason: ExitReason;
|
|
88
|
-
}
|
|
89
|
-
interface SnapshotItemPreview {
|
|
90
|
-
type: string;
|
|
91
|
-
scope: string | null;
|
|
92
|
-
content: string;
|
|
93
|
-
}
|
|
94
|
-
interface SnapshotItemRecord {
|
|
95
|
-
bundle_id: string;
|
|
96
|
-
item_type: string;
|
|
97
|
-
tokens: string[];
|
|
98
|
-
content: string;
|
|
99
|
-
}
|
|
100
|
-
interface SnapshotBundle {
|
|
101
|
-
bundle_id: string;
|
|
102
|
-
entity_id: string;
|
|
103
|
-
conversation_id: string | null;
|
|
104
|
-
bundle_type: string | null;
|
|
105
|
-
search_queries: string[];
|
|
106
|
-
scope_counts: Record<string, number>;
|
|
107
|
-
total_items: number;
|
|
108
|
-
items: SnapshotItemPreview[];
|
|
109
|
-
}
|
|
110
|
-
interface AnticipationCacheSnapshot {
|
|
111
|
-
total_entries: number;
|
|
112
|
-
total_item_records: number;
|
|
113
|
-
scope_breakdown_overall: Record<string, number>;
|
|
114
|
-
corpus_vocab_size: number;
|
|
115
|
-
corpus_vocab_sample: string[];
|
|
116
|
-
item_records: SnapshotItemRecord[];
|
|
117
|
-
bundles: SnapshotBundle[];
|
|
118
|
-
}
|
|
119
|
-
interface AnticipationCacheOptions {
|
|
120
|
-
ttlSeconds?: number;
|
|
121
|
-
maxBundles?: number;
|
|
122
|
-
/** Injected in tests. Defaults to a monotonic clock. */
|
|
123
|
-
now?: () => number;
|
|
124
|
-
onLookup?: (telemetry: LookupTelemetry) => void;
|
|
125
|
-
}
|
|
126
|
-
declare class AnticipationCache {
|
|
127
|
-
#private;
|
|
128
|
-
private readonly ttlSeconds;
|
|
129
|
-
private readonly maxBundles;
|
|
130
|
-
private readonly now;
|
|
131
|
-
private readonly onLookup;
|
|
132
|
-
private entries;
|
|
133
|
-
private items;
|
|
134
|
-
private corpusVocab;
|
|
135
|
-
private bm25;
|
|
136
|
-
private bm25Dirty;
|
|
137
|
-
constructor(options?: AnticipationCacheOptions);
|
|
138
|
-
get size(): number;
|
|
139
|
-
get itemCount(): number;
|
|
140
|
-
store(bundle: ContextBundle): void;
|
|
141
|
-
lookup(params: LookupParams): LookupResult | null;
|
|
142
|
-
/**
|
|
143
|
-
* Drop this entity's bundles after a write, so the cache stops serving a
|
|
144
|
-
* pre-write view. Gated on the flag: this is the write-path hook.
|
|
145
|
-
*/
|
|
146
|
-
invalidateEntity(entityId: string): number;
|
|
147
|
-
/**
|
|
148
|
-
* Unconditionally drop this entity's bundles. Backs `cache.clear_user` and
|
|
149
|
-
* `cache.clear_customer`, which are explicit user requests and so are not
|
|
150
|
-
* gated on the invalidate-on-write flag.
|
|
151
|
-
*/
|
|
152
|
-
dropEntity(entityId: string): number;
|
|
153
|
-
/**
|
|
154
|
-
* A read-only diagnostic projection of the cache.
|
|
155
|
-
*
|
|
156
|
-
* Backs `client.anticipation_cache_snapshot()` and mirrors Python's shape
|
|
157
|
-
* key for key, including snake_case keys: this output gets logged, diffed
|
|
158
|
-
* and pasted into issues across both SDKs, so it is a wire format.
|
|
159
|
-
*
|
|
160
|
-
* Note the 140-character content previews. That is Python's literal, and it
|
|
161
|
-
* is deliberately NOT the 120 of `telemetry.content_preview_chars` from the
|
|
162
|
-
* contract, which caps lookup telemetry rather than this snapshot.
|
|
163
|
-
*/
|
|
164
|
-
snapshot(): AnticipationCacheSnapshot;
|
|
165
|
-
/**
|
|
166
|
-
* The freshest `user_summary` bundle for this entity, or null.
|
|
167
|
-
*
|
|
168
|
-
* `entityId` is REQUIRED, and a missing one refuses the lookup rather than
|
|
169
|
-
* falling back to the freshest summary across all users. Python hardened this
|
|
170
|
-
* for exactly that reason: the permissive version could splice user A's
|
|
171
|
-
* summary into user B's response on the conversation-scope path.
|
|
172
|
-
*/
|
|
173
|
-
lookupUserSummary(entityId: string | null | undefined, scopeRung?: string | null): Record<string, unknown> | null;
|
|
174
|
-
/**
|
|
175
|
-
* Drop every bundle belonging to one conversation.
|
|
176
|
-
*
|
|
177
|
-
* Backs the `compaction_update` signal on the Listen stream: a compaction
|
|
178
|
-
* rewrites the conversation's summary, so any bundle built from the previous
|
|
179
|
-
* state is stale and must not keep serving for the rest of its TTL.
|
|
180
|
-
*
|
|
181
|
-
* Unlike `dropEntity`, client-scope bundles are NOT spared: a bundle is only
|
|
182
|
-
* dropped here if it is bound to this specific conversation, and a shared
|
|
183
|
-
* client-scope bundle has no conversation id to match.
|
|
184
|
-
*/
|
|
185
|
-
dropConversation(conversationId: string): number;
|
|
186
|
-
clear(): void;
|
|
187
|
-
private miss;
|
|
188
|
-
private fire;
|
|
189
|
-
private freshnessLookup;
|
|
190
|
-
/**
|
|
191
|
-
* The widened scope-match set for a request.
|
|
192
|
-
*
|
|
193
|
-
* A narrower-scope request also matches broader-scope bundles for the same
|
|
194
|
-
* customer or client. Falsy ids are dropped so an empty customer_id cannot
|
|
195
|
-
* accidentally match bundles keyed at "".
|
|
196
|
-
*/
|
|
197
|
-
private buildAcceptedScope;
|
|
198
|
-
/**
|
|
199
|
-
* The rung is checked FIRST and it never widens. Everything else here widens
|
|
200
|
-
* deliberately: a user-scope request reaches customer-shared bundles, and a
|
|
201
|
-
* conversation-scope request reaches user-scope ones. A rung is the opposite
|
|
202
|
-
* kind of thing, so it is checked before the tiers and no amount of widening
|
|
203
|
-
* can put a cross-rung bundle back in.
|
|
204
|
-
*/
|
|
205
|
-
private getValidBundleIds;
|
|
206
|
-
private effectiveTtl;
|
|
207
|
-
private evictExpired;
|
|
208
|
-
private dropBundle;
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
export { AnticipationCache as A, type BundleItem as B, type ContextBundle as C, type ExitReason as E, type LookupParams as L, type SnapshotBundle as S, type AnticipationCacheSnapshot as a, ANY_SCOPE as b, type AnticipationCacheOptions as c, type LookupResult as d, type LookupTelemetry as e, type SnapshotItemPreview as f, type SnapshotItemRecord as g };
|
|
@@ -1,211 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* In-memory TTL cache for context bundles pushed over gRPC.
|
|
3
|
-
*
|
|
4
|
-
* Port of `maximem_synap/cache/anticipation_cache.py`.
|
|
5
|
-
*
|
|
6
|
-
* ## Why this is a faithful port and not a simplification
|
|
7
|
-
*
|
|
8
|
-
* `@maximem/synap-vercel-adk` already contains a native TS anticipation cache,
|
|
9
|
-
* and it is a simplification: a hardcoded 30-minute TTL, a plain BM25 threshold
|
|
10
|
-
* with no per-query derivation, and none of the gates below. Shipping that as
|
|
11
|
-
* the SDK's cache would mean two retrieval behaviors under one brand, which is
|
|
12
|
-
* gotcha G-C. Every gate here exists because a specific eval failed without it:
|
|
13
|
-
*
|
|
14
|
-
* - **Recall bypass** runs BEFORE scoring. The measured false hit scored 2.86
|
|
15
|
-
* at coverage 1.00, so no score-side gate could ever have caught it.
|
|
16
|
-
* - **The novel-term gate** is suppressed below a 200-stem corpus, because at
|
|
17
|
-
* cold start ordinary English trips it on nearly every query.
|
|
18
|
-
* - **The per-query threshold** scales down for short queries, which otherwise
|
|
19
|
-
* cannot reach the nominal score at all.
|
|
20
|
-
* - **The coverage gate** catches a bundle that clears BM25 on one shared
|
|
21
|
-
* token ("account") while lacking the asked-for fact.
|
|
22
|
-
*
|
|
23
|
-
* All thresholds come from the shared behavior contract.
|
|
24
|
-
*/
|
|
25
|
-
/** Sentinel scope that matches any requester. */
|
|
26
|
-
declare const ANY_SCOPE = "_any";
|
|
27
|
-
interface BundleItem {
|
|
28
|
-
item_id?: string;
|
|
29
|
-
content?: string;
|
|
30
|
-
[key: string]: unknown;
|
|
31
|
-
}
|
|
32
|
-
interface ContextBundle {
|
|
33
|
-
bundleId: string;
|
|
34
|
-
entityId?: string | null;
|
|
35
|
-
conversationId?: string | null;
|
|
36
|
-
itemsByType: Record<string, BundleItem[]>;
|
|
37
|
-
/** Server hint; may only SHORTEN the global TTL, never extend it. */
|
|
38
|
-
ttlHintSeconds?: number | null;
|
|
39
|
-
/** Which anticipation pattern produced this bundle. Diagnostics only. */
|
|
40
|
-
bundleType?: string | null;
|
|
41
|
-
/** The queries the server anticipated. Diagnostics only. */
|
|
42
|
-
searchQueries?: readonly string[] | null;
|
|
43
|
-
/**
|
|
44
|
-
* The scope rung the server retrieved this bundle at, as `rungKey` writes
|
|
45
|
-
* one. Absent from anything an older server sent, which reads as "named no
|
|
46
|
-
* rung" rather than as "matches anything".
|
|
47
|
-
*/
|
|
48
|
-
scopeRung?: string | null;
|
|
49
|
-
}
|
|
50
|
-
interface LookupResult {
|
|
51
|
-
itemsByType: Record<string, BundleItem[]>;
|
|
52
|
-
bundleIds: string[];
|
|
53
|
-
score: number;
|
|
54
|
-
coverage: number;
|
|
55
|
-
}
|
|
56
|
-
interface LookupParams {
|
|
57
|
-
searchQuery?: readonly string[] | null;
|
|
58
|
-
entityId?: string | null;
|
|
59
|
-
customerId?: string | null;
|
|
60
|
-
clientId?: string | null;
|
|
61
|
-
conversationId?: string | null;
|
|
62
|
-
/**
|
|
63
|
-
* The rung this request names, from its `scope_path`. A SECOND, independent
|
|
64
|
-
* dimension and NOT another tier of the entity funnel: the funnel widens and
|
|
65
|
-
* the rung does not, because a rung is a boundary and a boundary that widens
|
|
66
|
-
* is not one.
|
|
67
|
-
*/
|
|
68
|
-
scopeRung?: string | null;
|
|
69
|
-
maxItems?: number;
|
|
70
|
-
}
|
|
71
|
-
type ExitReason = 'empty' | 'recall_bypass' | 'no_query_tokens' | 'novel_term_gate' | 'empty_corpus' | 'no_items_above_threshold' | 'coverage_gate' | 'hit';
|
|
72
|
-
interface LookupTelemetry {
|
|
73
|
-
searchQuery: string[];
|
|
74
|
-
entityId: string | null;
|
|
75
|
-
customerId: string | null;
|
|
76
|
-
clientId: string | null;
|
|
77
|
-
conversationId: string | null;
|
|
78
|
-
scopeRung: string | null;
|
|
79
|
-
scopeFilterAccepted: string[];
|
|
80
|
-
novelTermRatio: number | null;
|
|
81
|
-
bm25Threshold: number | null;
|
|
82
|
-
bm25QueryTokens: string[];
|
|
83
|
-
itemsPicked: unknown[];
|
|
84
|
-
itemsRejected: unknown[];
|
|
85
|
-
coverage: number | null;
|
|
86
|
-
hit: boolean;
|
|
87
|
-
exitReason: ExitReason;
|
|
88
|
-
}
|
|
89
|
-
interface SnapshotItemPreview {
|
|
90
|
-
type: string;
|
|
91
|
-
scope: string | null;
|
|
92
|
-
content: string;
|
|
93
|
-
}
|
|
94
|
-
interface SnapshotItemRecord {
|
|
95
|
-
bundle_id: string;
|
|
96
|
-
item_type: string;
|
|
97
|
-
tokens: string[];
|
|
98
|
-
content: string;
|
|
99
|
-
}
|
|
100
|
-
interface SnapshotBundle {
|
|
101
|
-
bundle_id: string;
|
|
102
|
-
entity_id: string;
|
|
103
|
-
conversation_id: string | null;
|
|
104
|
-
bundle_type: string | null;
|
|
105
|
-
search_queries: string[];
|
|
106
|
-
scope_counts: Record<string, number>;
|
|
107
|
-
total_items: number;
|
|
108
|
-
items: SnapshotItemPreview[];
|
|
109
|
-
}
|
|
110
|
-
interface AnticipationCacheSnapshot {
|
|
111
|
-
total_entries: number;
|
|
112
|
-
total_item_records: number;
|
|
113
|
-
scope_breakdown_overall: Record<string, number>;
|
|
114
|
-
corpus_vocab_size: number;
|
|
115
|
-
corpus_vocab_sample: string[];
|
|
116
|
-
item_records: SnapshotItemRecord[];
|
|
117
|
-
bundles: SnapshotBundle[];
|
|
118
|
-
}
|
|
119
|
-
interface AnticipationCacheOptions {
|
|
120
|
-
ttlSeconds?: number;
|
|
121
|
-
maxBundles?: number;
|
|
122
|
-
/** Injected in tests. Defaults to a monotonic clock. */
|
|
123
|
-
now?: () => number;
|
|
124
|
-
onLookup?: (telemetry: LookupTelemetry) => void;
|
|
125
|
-
}
|
|
126
|
-
declare class AnticipationCache {
|
|
127
|
-
#private;
|
|
128
|
-
private readonly ttlSeconds;
|
|
129
|
-
private readonly maxBundles;
|
|
130
|
-
private readonly now;
|
|
131
|
-
private readonly onLookup;
|
|
132
|
-
private entries;
|
|
133
|
-
private items;
|
|
134
|
-
private corpusVocab;
|
|
135
|
-
private bm25;
|
|
136
|
-
private bm25Dirty;
|
|
137
|
-
constructor(options?: AnticipationCacheOptions);
|
|
138
|
-
get size(): number;
|
|
139
|
-
get itemCount(): number;
|
|
140
|
-
store(bundle: ContextBundle): void;
|
|
141
|
-
lookup(params: LookupParams): LookupResult | null;
|
|
142
|
-
/**
|
|
143
|
-
* Drop this entity's bundles after a write, so the cache stops serving a
|
|
144
|
-
* pre-write view. Gated on the flag: this is the write-path hook.
|
|
145
|
-
*/
|
|
146
|
-
invalidateEntity(entityId: string): number;
|
|
147
|
-
/**
|
|
148
|
-
* Unconditionally drop this entity's bundles. Backs `cache.clear_user` and
|
|
149
|
-
* `cache.clear_customer`, which are explicit user requests and so are not
|
|
150
|
-
* gated on the invalidate-on-write flag.
|
|
151
|
-
*/
|
|
152
|
-
dropEntity(entityId: string): number;
|
|
153
|
-
/**
|
|
154
|
-
* A read-only diagnostic projection of the cache.
|
|
155
|
-
*
|
|
156
|
-
* Backs `client.anticipation_cache_snapshot()` and mirrors Python's shape
|
|
157
|
-
* key for key, including snake_case keys: this output gets logged, diffed
|
|
158
|
-
* and pasted into issues across both SDKs, so it is a wire format.
|
|
159
|
-
*
|
|
160
|
-
* Note the 140-character content previews. That is Python's literal, and it
|
|
161
|
-
* is deliberately NOT the 120 of `telemetry.content_preview_chars` from the
|
|
162
|
-
* contract, which caps lookup telemetry rather than this snapshot.
|
|
163
|
-
*/
|
|
164
|
-
snapshot(): AnticipationCacheSnapshot;
|
|
165
|
-
/**
|
|
166
|
-
* The freshest `user_summary` bundle for this entity, or null.
|
|
167
|
-
*
|
|
168
|
-
* `entityId` is REQUIRED, and a missing one refuses the lookup rather than
|
|
169
|
-
* falling back to the freshest summary across all users. Python hardened this
|
|
170
|
-
* for exactly that reason: the permissive version could splice user A's
|
|
171
|
-
* summary into user B's response on the conversation-scope path.
|
|
172
|
-
*/
|
|
173
|
-
lookupUserSummary(entityId: string | null | undefined, scopeRung?: string | null): Record<string, unknown> | null;
|
|
174
|
-
/**
|
|
175
|
-
* Drop every bundle belonging to one conversation.
|
|
176
|
-
*
|
|
177
|
-
* Backs the `compaction_update` signal on the Listen stream: a compaction
|
|
178
|
-
* rewrites the conversation's summary, so any bundle built from the previous
|
|
179
|
-
* state is stale and must not keep serving for the rest of its TTL.
|
|
180
|
-
*
|
|
181
|
-
* Unlike `dropEntity`, client-scope bundles are NOT spared: a bundle is only
|
|
182
|
-
* dropped here if it is bound to this specific conversation, and a shared
|
|
183
|
-
* client-scope bundle has no conversation id to match.
|
|
184
|
-
*/
|
|
185
|
-
dropConversation(conversationId: string): number;
|
|
186
|
-
clear(): void;
|
|
187
|
-
private miss;
|
|
188
|
-
private fire;
|
|
189
|
-
private freshnessLookup;
|
|
190
|
-
/**
|
|
191
|
-
* The widened scope-match set for a request.
|
|
192
|
-
*
|
|
193
|
-
* A narrower-scope request also matches broader-scope bundles for the same
|
|
194
|
-
* customer or client. Falsy ids are dropped so an empty customer_id cannot
|
|
195
|
-
* accidentally match bundles keyed at "".
|
|
196
|
-
*/
|
|
197
|
-
private buildAcceptedScope;
|
|
198
|
-
/**
|
|
199
|
-
* The rung is checked FIRST and it never widens. Everything else here widens
|
|
200
|
-
* deliberately: a user-scope request reaches customer-shared bundles, and a
|
|
201
|
-
* conversation-scope request reaches user-scope ones. A rung is the opposite
|
|
202
|
-
* kind of thing, so it is checked before the tiers and no amount of widening
|
|
203
|
-
* can put a cross-rung bundle back in.
|
|
204
|
-
*/
|
|
205
|
-
private getValidBundleIds;
|
|
206
|
-
private effectiveTtl;
|
|
207
|
-
private evictExpired;
|
|
208
|
-
private dropBundle;
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
export { AnticipationCache as A, type BundleItem as B, type ContextBundle as C, type ExitReason as E, type LookupParams as L, type SnapshotBundle as S, type AnticipationCacheSnapshot as a, ANY_SCOPE as b, type AnticipationCacheOptions as c, type LookupResult as d, type LookupTelemetry as e, type SnapshotItemPreview as f, type SnapshotItemRecord as g };
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["/private/tmp/ndeep-main/synap/sdk/js/dist/chunk-2TVL5IPQ.cjs","../src/errors.ts"],"names":[],"mappings":"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","file":"/private/tmp/ndeep-main/synap/sdk/js/dist/chunk-2TVL5IPQ.cjs","sourcesContent":[null,"/**\n * Synap SDK error taxonomy.\n *\n * Mirrors `maximem_synap/models/errors.py` 1:1, including the four\n * backward-compatibility aliases at the bottom. If you add an error to one\n * SDK, add it to the other in the same change.\n *\n * ## Why every error carries a `.code`\n *\n * This package ships dual ESM + CJS. A consumer whose dependency graph pulls\n * in both formats gets *two* copies of every class in this file, and then:\n *\n * try { ... } catch (e) { if (e instanceof SynapError) { ... } }\n *\n * silently evaluates to `false` against the copy from the other format. Error\n * handling stops working and nothing throws to tell you. `.code` is a plain\n * string, so it is immune. Prefer it at package boundaries:\n *\n * if (isSynapError(e) && e.code === 'rate_limit') { ... }\n *\n * `Symbol.hasInstance` is also wired up on the base class, so `instanceof`\n * works across realms too -- but `.code` is the documented contract.\n */\n\n/** Stable, format-independent discriminators. Never renumber or reuse. */\nexport type SynapErrorCode =\n | 'synap_error'\n | 'transient'\n | 'permanent'\n | 'network_timeout'\n | 'rate_limit'\n | 'insufficient_credits'\n | 'service_unavailable'\n | 'invalid_input'\n | 'invalid_instance_id'\n | 'invalid_conversation_id'\n | 'authentication'\n | 'context_not_found'\n | 'conflict'\n | 'transcript_conflict'\n | 'session_expired'\n | 'listening_already_active'\n | 'listening_not_active'\n | 'agent_unavailable';\n\nconst BRAND = Symbol.for('@maximem/synap-js-sdk.SynapError');\n\nexport interface SynapErrorOptions {\n correlationId?: string | null;\n cause?: unknown;\n}\n\nexport class SynapError extends Error {\n /**\n * The single declaration site for each subclass's code.\n *\n * It is `static` rather than a class field on purpose. Under\n * `useDefineForClassFields` (the default at our ES2022 target) a class field\n * is an *instance* property, so it is invisible from the constructor object.\n * `Symbol.hasInstance` below only has the constructor to work with, so a\n * field would leave it unable to tell `AuthenticationError` from\n * `RateLimitError` -- it would report every Synap error as an instance of\n * every other one.\n */\n static readonly errorCode: SynapErrorCode = 'synap_error';\n /** True for errors where a retry may succeed. Static for the same reason. */\n static readonly isTransient: boolean = false;\n\n /** Own, enumerable, so logs and JSON.stringify include it. */\n readonly code: SynapErrorCode;\n readonly correlationId: string | null;\n readonly transient: boolean;\n\n constructor(message: string, options: SynapErrorOptions = {}) {\n super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n const ctor = new.target as typeof SynapError;\n this.name = new.target.name;\n this.code = ctor.errorCode;\n this.transient = ctor.isTransient;\n this.correlationId = options.correlationId ?? null;\n Object.defineProperty(this, BRAND, { value: true, enumerable: false });\n // Without this, subclassing a built-in under a downlevel target breaks the\n // prototype chain and `instanceof` fails even within a single copy.\n Object.setPrototypeOf(this, new.target.prototype);\n }\n\n static override [Symbol.hasInstance](instance: unknown): boolean {\n if (instance === null || typeof instance !== 'object') return false;\n // Cross-realm / dual-format tolerant: identify by brand, then narrow by the\n // subclass's own code so `e instanceof RateLimitError` stays meaningful.\n if (!(BRAND in instance)) return false;\n const expected = (this as unknown as { errorCode?: SynapErrorCode }).errorCode;\n // Called on something that is not one of our classes: fall back to the brand.\n if (expected === undefined) return true;\n // Everything branded descends from the root.\n if (expected === 'synap_error') return true;\n const actual = (instance as { code?: string }).code;\n return actual === expected || descendsFrom(actual, expected);\n }\n}\n\n/** Type guard that works across ESM/CJS copies and realms. */\nexport function isSynapError(e: unknown): e is SynapError {\n return typeof e === 'object' && e !== null && BRAND in e;\n}\n\nexport class SynapTransientError extends SynapError {\n static override readonly errorCode: SynapErrorCode = 'transient';\n static override readonly isTransient: boolean = true;\n}\n\nexport class SynapPermanentError extends SynapError {\n static override readonly errorCode: SynapErrorCode = 'permanent';\n static override readonly isTransient: boolean = false;\n}\n\n// ─── Transient ────────────────────────────────────────────────────────────────\n\nexport class NetworkTimeoutError extends SynapTransientError {\n static override readonly errorCode: SynapErrorCode = 'network_timeout';\n}\n\nexport class RateLimitError extends SynapTransientError {\n static override readonly errorCode: SynapErrorCode = 'rate_limit';\n readonly retryAfterSeconds: number | null;\n\n constructor(\n message: string,\n options: SynapErrorOptions & { retryAfterSeconds?: number | null } = {},\n ) {\n super(message, options);\n this.retryAfterSeconds = options.retryAfterSeconds ?? null;\n }\n}\n\nexport class ServiceUnavailableError extends SynapTransientError {\n static override readonly errorCode: SynapErrorCode = 'service_unavailable';\n}\n\nexport class AgentUnavailableError extends SynapTransientError {\n static override readonly errorCode: SynapErrorCode = 'agent_unavailable';\n constructor(message = 'Agent unavailable', options: SynapErrorOptions = {}) {\n super(message, options);\n }\n}\n\n// ─── Permanent ────────────────────────────────────────────────────────────────\n\n/**\n * The caller's credit wallet cannot cover this request.\n *\n * HTTP 402, and gRPC RESOURCE_EXHAUSTED with credit-related trailing metadata.\n * Permanent by design: retrying without topping up burns quota and never\n * succeeds. This is the error behind \"the agent forgot\" reports where retrieval\n * silently returns nothing.\n */\nexport class InsufficientCreditsError extends SynapPermanentError {\n static override readonly errorCode: SynapErrorCode = 'insufficient_credits';\n readonly balanceCredits: number | null;\n readonly requiredCredits: number | null;\n /** Where the balance can be viewed. Python calls this `recovery_url`. */\n readonly recoveryUrl: string | null;\n /** Where a redeem code can be entered. Python calls this `redeem_url`. */\n readonly redeemUrl: string | null;\n\n constructor(\n message: string,\n options: SynapErrorOptions & {\n balanceCredits?: number | null;\n requiredCredits?: number | null;\n recoveryUrl?: string | null;\n redeemUrl?: string | null;\n } = {},\n ) {\n super(message, options);\n this.balanceCredits = options.balanceCredits ?? null;\n this.requiredCredits = options.requiredCredits ?? null;\n this.recoveryUrl = options.recoveryUrl ?? null;\n this.redeemUrl = options.redeemUrl ?? null;\n }\n}\n\nexport class InvalidInputError extends SynapPermanentError {\n static override readonly errorCode: SynapErrorCode = 'invalid_input';\n}\n\n/**\n * Raised by `validateInstanceId` before any network call, matching Python's\n * `utils/validators.py`. The message text is identical in both SDKs.\n */\nexport class InvalidInstanceIdError extends InvalidInputError {\n static override readonly errorCode: SynapErrorCode = 'invalid_instance_id';\n}\n\n/** See the note on InvalidInstanceIdError. Raised by `validateConversationId`. */\nexport class InvalidConversationIdError extends InvalidInputError {\n static override readonly errorCode: SynapErrorCode = 'invalid_conversation_id';\n}\n\nexport class AuthenticationError extends SynapPermanentError {\n static override readonly errorCode: SynapErrorCode = 'authentication';\n}\n\nexport class ContextNotFoundError extends SynapPermanentError {\n static override readonly errorCode: SynapErrorCode = 'context_not_found';\n}\n\nexport class ConflictError extends SynapPermanentError {\n static override readonly errorCode: SynapErrorCode = 'conflict';\n}\n\nexport class TranscriptConflictError extends ConflictError {\n static override readonly errorCode: SynapErrorCode = 'transcript_conflict';\n}\n\nexport class SessionExpiredError extends SynapPermanentError {\n static override readonly errorCode: SynapErrorCode = 'session_expired';\n}\n\nexport class ListeningAlreadyActiveError extends SynapPermanentError {\n static override readonly errorCode: SynapErrorCode = 'listening_already_active';\n}\n\nexport class ListeningNotActiveError extends SynapPermanentError {\n static override readonly errorCode: SynapErrorCode = 'listening_not_active';\n}\n\n// ─── Hierarchy metadata (drives the cross-copy instanceof above) ──────────────\n\nconst PARENT: Partial<Record<SynapErrorCode, SynapErrorCode>> = {\n transient: 'synap_error',\n permanent: 'synap_error',\n network_timeout: 'transient',\n rate_limit: 'transient',\n service_unavailable: 'transient',\n agent_unavailable: 'transient',\n insufficient_credits: 'permanent',\n invalid_input: 'permanent',\n invalid_instance_id: 'invalid_input',\n invalid_conversation_id: 'invalid_input',\n authentication: 'permanent',\n context_not_found: 'permanent',\n conflict: 'permanent',\n transcript_conflict: 'conflict',\n session_expired: 'permanent',\n listening_already_active: 'permanent',\n listening_not_active: 'permanent',\n};\n\nfunction descendsFrom(actual: string | undefined, expected: string): boolean {\n let cur = actual as SynapErrorCode | undefined;\n const seen = new Set<string>();\n while (cur && !seen.has(cur)) {\n seen.add(cur);\n if (cur === expected) return true;\n cur = PARENT[cur];\n }\n return false;\n}\n\n// ─── Backward-compatibility aliases (mirrors the tail of errors.py) ──────────\n// `ConnectionError` deliberately shadows the global in a module scope. Python\n// does the same thing; keeping the name means ported code reads identically.\n\nexport const SDKError = SynapError;\nexport const TransientError = SynapTransientError;\nexport const PermanentError = SynapPermanentError;\nexport const ConnectionError = NetworkTimeoutError;\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["/private/tmp/ndeep-main/synap/sdk/js/dist/chunk-7CWBRHUO.cjs","../src/grpc/descriptor.ts","../src/grpc/stream-client.ts"],"names":[],"mappings":"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","file":"/private/tmp/ndeep-main/synap/sdk/js/dist/chunk-7CWBRHUO.cjs","sourcesContent":[null,"/**\n * GENERATED FILE. Do not edit by hand.\n *\n * Source: synap/proto/synap_service.proto\n * Generator: synap/sdk/scripts/gen_proto_descriptor.mjs\n * Proto SHA: a58c9b031b41530d\n *\n * The proto is inlined as a JSON descriptor rather than loaded from disk so\n * that bundlers and Vercel file tracing cannot lose it. Regenerate with\n * `npm run sync-behavior` in synap/sdk/js.\n */\n\n/** sha256 (first 16 hex chars) of the proto this descriptor was built from. */\nexport const PROTO_SHA = 'a58c9b031b41530d';\n\nexport const SYNAP_PROTO_DESCRIPTOR = {\n \"nested\": {\n \"synap\": {\n \"nested\": {\n \"v1\": {\n \"nested\": {\n \"SynapService\": {\n \"methods\": {\n \"Listen\": {\n \"requestType\": \"StreamEvent\",\n \"requestStream\": true,\n \"responseType\": \"StreamResponse\",\n \"responseStream\": true\n },\n \"IngestTelemetry\": {\n \"requestType\": \"TelemetryEvent\",\n \"requestStream\": true,\n \"responseType\": \"TelemetryAck\"\n }\n }\n },\n \"StreamEvent\": {\n \"oneofs\": {\n \"payload\": {\n \"oneof\": [\n \"conversation_event\",\n \"heartbeat_ping\",\n \"session_control\",\n \"context_used\",\n \"context_assembled\"\n ]\n }\n },\n \"fields\": {\n \"conversation_event\": {\n \"type\": \"ConversationEvent\",\n \"id\": 1\n },\n \"heartbeat_ping\": {\n \"type\": \"HeartbeatPing\",\n \"id\": 2\n },\n \"session_control\": {\n \"type\": \"SessionControl\",\n \"id\": 3\n },\n \"context_used\": {\n \"type\": \"ContextUsedEvent\",\n \"id\": 4\n },\n \"context_assembled\": {\n \"type\": \"ContextAssembledEvent\",\n \"id\": 5\n }\n }\n },\n \"ContextUsedEvent\": {\n \"fields\": {\n \"bundle_id\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"conversation_id\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"user_id\": {\n \"type\": \"string\",\n \"id\": 3\n },\n \"customer_id\": {\n \"type\": \"string\",\n \"id\": 4\n },\n \"served_item_ids\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 5\n },\n \"timestamp_ms\": {\n \"type\": \"int64\",\n \"id\": 6\n },\n \"scope\": {\n \"type\": \"string\",\n \"id\": 7\n },\n \"source_bundle_ids\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 8\n }\n }\n },\n \"ContextAssembledEvent\": {\n \"fields\": {\n \"correlation_id\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"conversation_id\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"user_id\": {\n \"type\": \"string\",\n \"id\": 3\n },\n \"customer_id\": {\n \"type\": \"string\",\n \"id\": 4\n },\n \"final_item_ids\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 5\n },\n \"final_total_tokens\": {\n \"type\": \"int32\",\n \"id\": 6\n },\n \"compaction_id\": {\n \"type\": \"string\",\n \"id\": 7\n },\n \"recent_turn_count\": {\n \"type\": \"int32\",\n \"id\": 8\n },\n \"compaction_end_timestamp\": {\n \"type\": \"string\",\n \"id\": 9\n },\n \"assembly_source\": {\n \"type\": \"string\",\n \"id\": 10\n },\n \"assembly_duration_ms\": {\n \"type\": \"int32\",\n \"id\": 11\n },\n \"cache_hit\": {\n \"type\": \"bool\",\n \"id\": 12\n },\n \"timestamp_ms\": {\n \"type\": \"int64\",\n \"id\": 13\n },\n \"sdk_version\": {\n \"type\": \"string\",\n \"id\": 14\n }\n }\n },\n \"ConversationEvent\": {\n \"fields\": {\n \"event_type\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"conversation_id\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"user_id\": {\n \"type\": \"string\",\n \"id\": 3\n },\n \"role\": {\n \"type\": \"string\",\n \"id\": 4\n },\n \"content\": {\n \"type\": \"string\",\n \"id\": 5\n },\n \"customer_id\": {\n \"type\": \"string\",\n \"id\": 6\n },\n \"session_id\": {\n \"type\": \"string\",\n \"id\": 7\n },\n \"metadata\": {\n \"keyType\": \"string\",\n \"type\": \"string\",\n \"id\": 8\n },\n \"timestamp_ms\": {\n \"type\": \"int64\",\n \"id\": 9\n },\n \"tool_name\": {\n \"type\": \"string\",\n \"id\": 10\n },\n \"tool_args_json\": {\n \"type\": \"string\",\n \"id\": 11\n },\n \"search_queries\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 12\n },\n \"context_types\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 13\n },\n \"scope\": {\n \"keyType\": \"string\",\n \"type\": \"string\",\n \"id\": 14\n }\n }\n },\n \"HeartbeatPing\": {\n \"fields\": {\n \"timestamp_ms\": {\n \"type\": \"int64\",\n \"id\": 1\n }\n }\n },\n \"SessionControl\": {\n \"fields\": {\n \"action\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"session_id\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"conversation_id\": {\n \"type\": \"string\",\n \"id\": 3\n },\n \"user_id\": {\n \"type\": \"string\",\n \"id\": 4\n },\n \"customer_id\": {\n \"type\": \"string\",\n \"id\": 5\n }\n }\n },\n \"StreamResponse\": {\n \"oneofs\": {\n \"payload\": {\n \"oneof\": [\n \"context_bundle\",\n \"heartbeat_pong\",\n \"signal\"\n ]\n }\n },\n \"fields\": {\n \"context_bundle\": {\n \"type\": \"ContextBundleProto\",\n \"id\": 1\n },\n \"heartbeat_pong\": {\n \"type\": \"HeartbeatPong\",\n \"id\": 2\n },\n \"signal\": {\n \"type\": \"StreamSignal\",\n \"id\": 3\n }\n }\n },\n \"HeartbeatPong\": {\n \"fields\": {\n \"timestamp_ms\": {\n \"type\": \"int64\",\n \"id\": 1\n }\n }\n },\n \"StreamSignal\": {\n \"fields\": {\n \"signal_type\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"reason\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"metadata\": {\n \"keyType\": \"string\",\n \"type\": \"string\",\n \"id\": 3\n }\n }\n },\n \"ContextBundleProto\": {\n \"fields\": {\n \"bundle_id\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"decision_id\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"items_by_type\": {\n \"keyType\": \"string\",\n \"type\": \"ContextItemList\",\n \"id\": 3\n },\n \"total_tokens\": {\n \"type\": \"int32\",\n \"id\": 4\n },\n \"token_budget\": {\n \"type\": \"int32\",\n \"id\": 5\n },\n \"budget_exceeded\": {\n \"type\": \"bool\",\n \"id\": 6\n },\n \"retrieval_mode\": {\n \"type\": \"string\",\n \"id\": 7\n },\n \"sources_queried\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 8\n },\n \"degradation_level\": {\n \"type\": \"string\",\n \"id\": 9\n },\n \"warnings\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 10\n },\n \"created_at\": {\n \"type\": \"string\",\n \"id\": 11\n },\n \"retrieval_time_ms\": {\n \"type\": \"int32\",\n \"id\": 12\n },\n \"cache_hit\": {\n \"type\": \"bool\",\n \"id\": 13\n },\n \"search_queries\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 14\n },\n \"anticipation_user_id\": {\n \"type\": \"string\",\n \"id\": 15\n },\n \"anticipation_customer_id\": {\n \"type\": \"string\",\n \"id\": 16\n },\n \"anticipation_conversation_id\": {\n \"type\": \"string\",\n \"id\": 17\n },\n \"search_keywords\": {\n \"rule\": \"repeated\",\n \"type\": \"string\",\n \"id\": 18\n },\n \"bundle_type\": {\n \"type\": \"string\",\n \"id\": 19\n },\n \"conversation_context\": {\n \"type\": \"ConversationContextProto\",\n \"id\": 20\n },\n \"bundle_confidence\": {\n \"type\": \"float\",\n \"id\": 21\n },\n \"origin_pattern_id\": {\n \"type\": \"string\",\n \"id\": 22\n },\n \"ttl_hint_seconds\": {\n \"type\": \"int32\",\n \"id\": 23\n },\n \"anticipation_scope_rung\": {\n \"type\": \"string\",\n \"id\": 24\n }\n }\n },\n \"ConversationContextProto\": {\n \"fields\": {\n \"summary\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"current_state_json\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"key_extractions_json\": {\n \"type\": \"string\",\n \"id\": 3\n },\n \"recent_turns\": {\n \"rule\": \"repeated\",\n \"type\": \"RecentTurnProto\",\n \"id\": 4\n },\n \"compaction_id\": {\n \"type\": \"string\",\n \"id\": 5\n },\n \"compacted_at\": {\n \"type\": \"string\",\n \"id\": 6\n },\n \"conversation_id\": {\n \"type\": \"string\",\n \"id\": 7\n }\n }\n },\n \"RecentTurnProto\": {\n \"fields\": {\n \"role\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"content\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"timestamp\": {\n \"type\": \"string\",\n \"id\": 3\n }\n }\n },\n \"ContextItemList\": {\n \"fields\": {\n \"items\": {\n \"rule\": \"repeated\",\n \"type\": \"ContextItemProto\",\n \"id\": 1\n }\n }\n },\n \"ContextItemProto\": {\n \"fields\": {\n \"item_id\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"content\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"context_type\": {\n \"type\": \"string\",\n \"id\": 3\n },\n \"source\": {\n \"type\": \"string\",\n \"id\": 4\n },\n \"similarity_score\": {\n \"type\": \"float\",\n \"id\": 5\n },\n \"relevance_score\": {\n \"type\": \"float\",\n \"id\": 6\n },\n \"confidence\": {\n \"type\": \"float\",\n \"id\": 7\n },\n \"scope\": {\n \"type\": \"string\",\n \"id\": 8\n },\n \"entity_id\": {\n \"type\": \"string\",\n \"id\": 9\n },\n \"created_at\": {\n \"type\": \"string\",\n \"id\": 10\n },\n \"event_date\": {\n \"type\": \"string\",\n \"id\": 11\n },\n \"valid_until\": {\n \"type\": \"string\",\n \"id\": 12\n },\n \"temporal_category\": {\n \"type\": \"string\",\n \"id\": 13\n },\n \"temporal_confidence\": {\n \"type\": \"float\",\n \"id\": 14\n }\n }\n },\n \"TelemetryEvent\": {\n \"fields\": {\n \"event_type\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"instance_id\": {\n \"type\": \"string\",\n \"id\": 2\n },\n \"client_id\": {\n \"type\": \"string\",\n \"id\": 3\n },\n \"correlation_id\": {\n \"type\": \"string\",\n \"id\": 4\n },\n \"timestamp_ms\": {\n \"type\": \"int64\",\n \"id\": 5\n },\n \"latency_ms\": {\n \"type\": \"int32\",\n \"id\": 6\n },\n \"status\": {\n \"type\": \"string\",\n \"id\": 7\n },\n \"error_code\": {\n \"type\": \"string\",\n \"id\": 8\n },\n \"scope\": {\n \"type\": \"string\",\n \"id\": 9\n },\n \"cache_status\": {\n \"type\": \"string\",\n \"id\": 10\n },\n \"attempt\": {\n \"type\": \"int32\",\n \"id\": 11\n },\n \"http_method\": {\n \"type\": \"string\",\n \"id\": 12\n },\n \"http_path\": {\n \"type\": \"string\",\n \"id\": 13\n },\n \"http_status_code\": {\n \"type\": \"int32\",\n \"id\": 14\n },\n \"metadata\": {\n \"keyType\": \"string\",\n \"type\": \"string\",\n \"id\": 15\n },\n \"sdk_version\": {\n \"type\": \"string\",\n \"id\": 16\n },\n \"batch_id\": {\n \"type\": \"string\",\n \"id\": 17\n }\n }\n },\n \"TelemetryAck\": {\n \"fields\": {\n \"status\": {\n \"type\": \"string\",\n \"id\": 1\n },\n \"events_received\": {\n \"type\": \"int32\",\n \"id\": 2\n }\n }\n }\n }\n }\n }\n }\n }\n} as const;\n","/**\n * Bidirectional gRPC stream client for the Synap anticipation channel.\n *\n * Mirrors Python's `GRPCTransport` and the synap-vercel-adk client:\n * - `/synap.v1.SynapService/Listen`, StreamEvent in, StreamResponse out\n * - Auth via `authorization: Bearer <key>` plus `x-client-id` / `x-instance-id`\n * - 30s heartbeat, exponential-backoff reconnect\n * - Server pushes ContextBundleProto, which lands in the AnticipationCache\n *\n * Node-only, and reached exclusively through a lazy `import()` so that merely\n * importing the SDK on Edge or in a Worker stays safe. grpc-js is built on\n * `node:http2`/`node:net`/`node:tls`; a static import fails the BUILD there.\n *\n * The proto arrives as an inlined descriptor (see ./descriptor.ts) rather than\n * being read from disk, so bundlers and Vercel file tracing cannot lose it.\n */\n\nimport type { AnticipationCache } from '../context/anticipation-cache.js';\nimport { SYNAP_PROTO_DESCRIPTOR } from './descriptor.js';\n\nexport type StreamState =\n | 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'closed';\n\n/**\n * The ONLY bundle type the cache refuses.\n *\n * NOTE: this deliberately differs from the synap-vercel-adk stream client,\n * which caches an allowlist of `anticipation` and `user_summary` and drops\n * compaction updates. Python's `_handle_anticipated_bundle` stores everything\n * except `reactive`, and Python is the reference implementation, so an\n * allowlist here would silently cache less than the pip SDK does.\n *\n * Reactive bundles are excluded because they answer a fetch that already\n * happened; caching one serves a stale answer to a different question.\n */\nconst UNCACHEABLE_BUNDLE_TYPE = 'reactive';\n\n// Mirrors the Python GRPCTransport constants.\nconst MAX_RECONNECT_ATTEMPTS = 10;\nconst BACKOFF_BASE_MS = 1_000;\nconst BACKOFF_MAX_MS = 30_000;\nconst HEARTBEAT_INTERVAL_MS = 30_000;\nconst HEARTBEAT_TIMEOUT_MS = 10_000;\nconst MAX_MISSED_HEARTBEATS = 3;\n/** The server may only SHORTEN the SDK default, never extend it past this floor. */\nconst MIN_TTL_SECONDS = 60;\n\nexport interface StreamCredentials {\n apiKey: string;\n clientId: string;\n instanceId: string;\n}\n\nexport interface StreamClientOptions {\n host?: string;\n port?: number;\n useTls?: boolean;\n /** Injected in tests so reconnect backoff does not make the suite slow. */\n sleep?: (ms: number) => Promise<void>;\n /** How long to wait for the channel to become ready. Default 10s. */\n connectTimeoutMs?: number;\n onStateChange?: (state: StreamState) => void;\n /** Fires for every bundle, before the cache filter. Backs `listen({onContext})`. */\n onContext?: (bundle: Record<string, unknown>) => void;\n /** Fires only for `compaction_update` bundles. Backs the compaction subscriptions. */\n onCompactionUpdate?: (conversationId: string, bundle: Record<string, unknown>) => void;\n}\n\ninterface DuplexCall {\n write: (msg: unknown) => void;\n on: (event: string, handler: (arg?: unknown) => void) => void;\n end: () => void;\n}\n\nexport interface ConversationEventInput {\n event_type: string;\n conversation_id?: string;\n user_id?: string;\n customer_id?: string;\n role?: string;\n content?: string;\n session_id?: string;\n metadata?: Record<string, string>;\n timestamp_ms?: number;\n /** proto: ConversationEvent.tool_name */\n tool_name?: string;\n /** proto: ConversationEvent.tool_args_json. Python sends json.dumps(tool_args). */\n tool_args_json?: string;\n search_queries?: string[];\n context_types?: string[];\n}\n\nexport class GrpcStreamClient {\n readonly host: string;\n readonly port: number;\n readonly useTls: boolean;\n\n #state: StreamState = 'disconnected';\n #call: DuplexCall | null = null;\n #reconnectAttempts = 0;\n #lastPongAt = 0;\n #missedHeartbeats = 0;\n #heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n #shutdownRequested = false;\n\n #grpc: typeof import('@grpc/grpc-js') | null = null;\n #ServiceStub: (new (target: string, creds: unknown, opts: unknown) => Record<string, unknown>) | null = null;\n\n readonly #credentials: StreamCredentials;\n readonly #cache: AnticipationCache;\n readonly #options: StreamClientOptions;\n readonly #sleep: (ms: number) => Promise<void>;\n readonly #connectTimeoutMs: number;\n\n constructor(\n credentials: StreamCredentials,\n cache: AnticipationCache,\n options: StreamClientOptions = {},\n ) {\n this.#credentials = credentials;\n this.#cache = cache;\n this.#options = options;\n this.host = options.host ?? 'synap-cloud-prod.maximem.ai';\n this.port = options.port ?? 443;\n this.useTls = options.useTls ?? true;\n this.#sleep = options.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));\n this.#connectTimeoutMs = options.connectTimeoutMs ?? 10_000;\n }\n\n get currentState(): StreamState { return this.#state; }\n get isConnected(): boolean { return this.#state === 'connected'; }\n\n async connect(): Promise<void> {\n await this.#loadGrpc();\n this.#shutdownRequested = false;\n await this.#establish();\n this.#startHeartbeat();\n }\n\n async disconnect(): Promise<void> {\n this.#shutdownRequested = true;\n this.#stopHeartbeat();\n this.#closeCall();\n this.#setState('closed');\n }\n\n /** Fire-and-forget: a dropped event must never fail the caller's turn. */\n sendConversationEvent(event: ConversationEventInput): void {\n this.#write({ conversation_event: { ...event } });\n }\n\n sendSessionControl(input: {\n action: string;\n session_id?: string;\n conversation_id?: string;\n user_id?: string;\n customer_id?: string;\n }): void {\n this.#write({ session_control: { ...input } });\n }\n\n sendContextUsed(event: Record<string, unknown>): void {\n this.#write({ context_used: { ...event } });\n }\n\n sendContextAssembled(event: Record<string, unknown>): void {\n this.#write({ context_assembled: { ...event } });\n }\n\n #write(msg: unknown): void {\n if (!this.isConnected || this.#call === null) return;\n try {\n this.#call.write(msg);\n } catch {\n // Non-fatal. These are telemetry and control events; losing one is\n // strictly better than surfacing a stream hiccup to the caller.\n }\n }\n\n async #loadGrpc(): Promise<void> {\n if (this.#grpc !== null) return;\n const [grpcMod, protoMod] = await Promise.all([\n import(/* @vite-ignore */ '@grpc/grpc-js'),\n import(/* @vite-ignore */ '@grpc/proto-loader'),\n ]);\n this.#grpc = grpcMod;\n\n // `fromJSON`, not `loadSync`: no path, no disk read, nothing for a bundler\n // to fail to trace. `keepCase` keeps the snake_case field names the server\n // and the Python SDK both use.\n const pkgDef = protoMod.fromJSON(\n SYNAP_PROTO_DESCRIPTOR as unknown as Parameters<typeof protoMod.fromJSON>[0],\n { keepCase: true, longs: Number, enums: String, defaults: true, oneofs: true },\n );\n const pkg = grpcMod.loadPackageDefinition(pkgDef) as unknown as {\n synap: { v1: { SynapService: new (t: string, c: unknown, o: unknown) => Record<string, unknown> } };\n };\n this.#ServiceStub = pkg.synap.v1.SynapService;\n }\n\n async #establish(): Promise<void> {\n this.#setState('connecting');\n const grpc = this.#grpc;\n const Stub = this.#ServiceStub;\n if (grpc === null || Stub === null) throw new Error('gRPC not loaded');\n\n const channelCreds = this.useTls\n ? grpc.credentials.createSsl()\n : grpc.credentials.createInsecure();\n\n const stub = new Stub(`${this.host}:${this.port}`, channelCreds, {\n 'grpc.keepalive_time_ms': 30_000,\n 'grpc.keepalive_timeout_ms': 10_000,\n 'grpc.keepalive_permit_without_calls': 1,\n });\n\n // Wait for the channel before reporting success.\n //\n // grpc-js connects LAZILY: constructing the stub and creating the call both\n // return immediately, and a bad host surfaces later through the call's\n // 'error' event. Without this, `await listen()` resolved against an\n // unreachable port, `is_listening` read true for a stream that never\n // connected, and `send_message()` then dropped every event silently,\n // because sends are deliberately fire-and-forget. Failing loudly here is\n // the difference between a clear error and an agent that looks like it has\n // no memory.\n await new Promise<void>((resolve, reject) => {\n const deadline = new Date(Date.now() + this.#connectTimeoutMs);\n const waitForReady = (stub as unknown as {\n waitForReady?: (d: Date, cb: (e?: Error) => void) => void;\n }).waitForReady;\n if (typeof waitForReady !== 'function') {\n // Older grpc-js, or a stub that does not expose it. Fall back to the\n // lazy behaviour rather than failing outright.\n resolve();\n return;\n }\n waitForReady.call(stub, deadline, (error?: Error) => {\n if (error) reject(error);\n else resolve();\n });\n });\n\n const metadata = new grpc.Metadata();\n metadata.add('authorization', `Bearer ${this.#credentials.apiKey}`);\n metadata.add('x-client-id', this.#credentials.clientId);\n metadata.add('x-instance-id', this.#credentials.instanceId);\n\n const call = (stub['Listen'] as (m: unknown) => DuplexCall)(metadata);\n call.on('data', (msg) => this.#handleMessage(msg as Record<string, unknown>));\n call.on('error', (err) => { void this.#handleDisconnect(`error: ${String(err)}`); });\n call.on('end', () => { void this.#handleDisconnect('server_close'); });\n\n this.#call = call;\n this.#setState('connected');\n this.#reconnectAttempts = 0;\n this.#lastPongAt = Date.now();\n }\n\n #handleMessage(msg: Record<string, unknown>): void {\n if (msg['context_bundle']) {\n this.#handleBundle(msg['context_bundle'] as Record<string, unknown>);\n return;\n }\n if (msg['heartbeat_pong']) {\n this.#lastPongAt = Date.now();\n this.#missedHeartbeats = 0;\n return;\n }\n const signal = msg['signal'] as { signal_type?: string } | undefined;\n if (signal?.signal_type === 'closing') {\n void this.#handleDisconnect('server_signal_closing');\n }\n }\n\n #handleBundle(bundle: Record<string, unknown>): void {\n const bundleType = String(bundle['bundle_type'] ?? '') || 'anticipation';\n const conversationId = String(bundle['anticipation_conversation_id'] ?? '');\n\n if (bundleType !== UNCACHEABLE_BUNDLE_TYPE) this.#store(bundle, bundleType, conversationId);\n\n if (bundleType === 'compaction_update' && conversationId !== '') {\n // Python also deletes this conversation's `compacted_full` /\n // `compacted_context` entries from its separate CacheManager. This SDK\n // has no such cache, and calling dropConversation() here would delete\n // the bundle just stored above, so there is nothing to invalidate.\n this.#options.onCompactionUpdate?.(conversationId, bundle);\n }\n\n // Fires for every type, after storing, matching Python's ordering.\n this.#options.onContext?.(bundle);\n }\n\n #store(bundle: Record<string, unknown>, bundleType: string, conversationId: string): void {\n const itemsByType: Record<string, Array<Record<string, unknown>>> = {};\n for (const [type, list] of Object.entries(bundle['items_by_type'] ?? {})) {\n const items = (list as { items?: Array<Record<string, unknown>> })?.items;\n itemsByType[type] = items ?? [];\n }\n\n const ttlHint = Number(bundle['ttl_hint_seconds'] ?? 0);\n this.#cache.store({\n bundleId: String(bundle['bundle_id'] ?? ''),\n // The cache keys on ONE entity. User id wins when present, so a bundle\n // pushed for a user cannot be served to a different user in the same\n // customer; falling back to customer id keeps org-scope bundles usable.\n entityId:\n String(bundle['anticipation_user_id'] ?? '') ||\n String(bundle['anticipation_customer_id'] ?? '') ||\n null,\n conversationId: conversationId || null,\n // The rung the server retrieved this bundle at. Absent from anything an\n // older server sent, and absent reads as \"named no rung\" rather than as\n // \"matches anything\".\n scopeRung: String(bundle['anticipation_scope_rung'] ?? '') || null,\n itemsByType,\n // 0 means \"use the SDK default\"; anything else is floored at 60s.\n ttlHintSeconds: ttlHint > 0 ? Math.max(ttlHint, MIN_TTL_SECONDS) : null,\n bundleType,\n searchQueries: [\n ...((bundle['search_queries'] as string[] | undefined) ?? []),\n ...((bundle['search_keywords'] as string[] | undefined) ?? []),\n ],\n });\n }\n\n async #handleDisconnect(_reason: string): Promise<void> {\n if (this.#shutdownRequested) return;\n\n this.#closeCall();\n this.#setState('reconnecting');\n\n if (this.#reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {\n this.#setState('disconnected');\n return;\n }\n\n // Jittered exponential backoff. The jitter matters with many SDK instances\n // behind one deploy: without it they all retry in lockstep.\n const delay = Math.min(\n BACKOFF_BASE_MS * 2 ** this.#reconnectAttempts + Math.random() * 1_000,\n BACKOFF_MAX_MS,\n );\n this.#reconnectAttempts += 1;\n\n await this.#sleep(delay);\n if (this.#shutdownRequested) return;\n try {\n await this.#establish();\n } catch {\n void this.#handleDisconnect('reconnect_failed');\n }\n }\n\n #startHeartbeat(): void {\n this.#heartbeatTimer = setInterval(() => {\n if (!this.isConnected || this.#call === null) return;\n const now = Date.now();\n\n if (now - this.#lastPongAt > HEARTBEAT_TIMEOUT_MS) {\n this.#missedHeartbeats += 1;\n if (this.#missedHeartbeats >= MAX_MISSED_HEARTBEATS) {\n void this.#handleDisconnect('heartbeat_timeout');\n return;\n }\n }\n try {\n this.#call.write({ heartbeat_ping: { timestamp_ms: now } });\n } catch {\n void this.#handleDisconnect('heartbeat_write_error');\n }\n }, HEARTBEAT_INTERVAL_MS);\n // Never hold the process open on the heartbeat alone: a CLI that finishes\n // its work should exit, not hang for 30s.\n this.#heartbeatTimer.unref?.();\n }\n\n #stopHeartbeat(): void {\n if (this.#heartbeatTimer !== null) {\n clearInterval(this.#heartbeatTimer);\n this.#heartbeatTimer = null;\n }\n }\n\n #closeCall(): void {\n try {\n this.#call?.end();\n } catch {\n /* already torn down */\n }\n this.#call = null;\n }\n\n #setState(state: StreamState): void {\n this.#state = state;\n this.#options.onStateChange?.(state);\n }\n}\n"]}
|