@maximem/synap-js-sdk 0.4.8 → 0.5.1

package/dist/errors-Bl3vY1eb.d.ts

@@ -0,0 +1,382 @@
+/**
+ * In-memory TTL cache for context bundles pushed over gRPC.
+ *
+ * Port of `maximem_synap/cache/anticipation_cache.py`.
+ *
+ * ## Why this is a faithful port and not a simplification
+ *
+ * `@maximem/synap-vercel-adk` already contains a native TS anticipation cache,
+ * and it is a simplification: a hardcoded 30-minute TTL, a plain BM25 threshold
+ * with no per-query derivation, and none of the gates below. Shipping that as
+ * the SDK's cache would mean two retrieval behaviors under one brand, which is
+ * gotcha G-C. Every gate here exists because a specific eval failed without it:
+ *
+ *  - **Recall bypass** runs BEFORE scoring. The measured false hit scored 2.86
+ *    at coverage 1.00, so no score-side gate could ever have caught it.
+ *  - **The novel-term gate** is suppressed below a 200-stem corpus, because at
+ *    cold start ordinary English trips it on nearly every query.
+ *  - **The per-query threshold** scales down for short queries, which otherwise
+ *    cannot reach the nominal score at all.
+ *  - **The coverage gate** catches a bundle that clears BM25 on one shared
+ *    token ("account") while lacking the asked-for fact.
+ *
+ * All thresholds come from the shared behavior contract.
+ */
+/** Sentinel scope that matches any requester. */
+declare const ANY_SCOPE = "_any";
+interface BundleItem {
+    item_id?: string;
+    content?: string;
+    [key: string]: unknown;
+}
+interface ContextBundle {
+    bundleId: string;
+    entityId?: string | null;
+    conversationId?: string | null;
+    itemsByType: Record<string, BundleItem[]>;
+    /** Server hint; may only SHORTEN the global TTL, never extend it. */
+    ttlHintSeconds?: number | null;
+    /** Which anticipation pattern produced this bundle. Diagnostics only. */
+    bundleType?: string | null;
+    /** The queries the server anticipated. Diagnostics only. */
+    searchQueries?: readonly string[] | null;
+    /**
+     * The scope rung the server retrieved this bundle at, as `rungKey` writes
+     * one. Absent from anything an older server sent, which reads as "named no
+     * rung" rather than as "matches anything".
+     */
+    scopeRung?: string | null;
+}
+interface LookupResult {
+    itemsByType: Record<string, BundleItem[]>;
+    bundleIds: string[];
+    score: number;
+    coverage: number;
+}
+interface LookupParams {
+    searchQuery?: readonly string[] | null;
+    entityId?: string | null;
+    customerId?: string | null;
+    clientId?: string | null;
+    conversationId?: string | null;
+    /**
+     * The rung this request names, from its `scope_path`. A SECOND, independent
+     * dimension and NOT another tier of the entity funnel: the funnel widens and
+     * the rung does not, because a rung is a boundary and a boundary that widens
+     * is not one.
+     */
+    scopeRung?: string | null;
+    maxItems?: number;
+}
+type ExitReason = 'empty' | 'recall_bypass' | 'no_query_tokens' | 'novel_term_gate' | 'empty_corpus' | 'no_items_above_threshold' | 'coverage_gate' | 'hit';
+interface LookupTelemetry {
+    searchQuery: string[];
+    entityId: string | null;
+    customerId: string | null;
+    clientId: string | null;
+    conversationId: string | null;
+    scopeRung: string | null;
+    scopeFilterAccepted: string[];
+    novelTermRatio: number | null;
+    bm25Threshold: number | null;
+    bm25QueryTokens: string[];
+    itemsPicked: unknown[];
+    itemsRejected: unknown[];
+    coverage: number | null;
+    hit: boolean;
+    exitReason: ExitReason;
+}
+interface SnapshotItemPreview {
+    type: string;
+    scope: string | null;
+    content: string;
+}
+interface SnapshotItemRecord {
+    bundle_id: string;
+    item_type: string;
+    tokens: string[];
+    content: string;
+}
+interface SnapshotBundle {
+    bundle_id: string;
+    entity_id: string;
+    conversation_id: string | null;
+    bundle_type: string | null;
+    search_queries: string[];
+    scope_counts: Record<string, number>;
+    total_items: number;
+    items: SnapshotItemPreview[];
+}
+interface AnticipationCacheSnapshot {
+    total_entries: number;
+    total_item_records: number;
+    scope_breakdown_overall: Record<string, number>;
+    corpus_vocab_size: number;
+    corpus_vocab_sample: string[];
+    item_records: SnapshotItemRecord[];
+    bundles: SnapshotBundle[];
+}
+interface AnticipationCacheOptions {
+    ttlSeconds?: number;
+    maxBundles?: number;
+    /** Injected in tests. Defaults to a monotonic clock. */
+    now?: () => number;
+    onLookup?: (telemetry: LookupTelemetry) => void;
+}
+declare class AnticipationCache {
+    #private;
+    private readonly ttlSeconds;
+    private readonly maxBundles;
+    private readonly now;
+    private readonly onLookup;
+    private entries;
+    private items;
+    private corpusVocab;
+    private bm25;
+    private bm25Dirty;
+    constructor(options?: AnticipationCacheOptions);
+    get size(): number;
+    get itemCount(): number;
+    store(bundle: ContextBundle): void;
+    lookup(params: LookupParams): LookupResult | null;
+    /**
+     * Drop this entity's bundles after a write, so the cache stops serving a
+     * pre-write view. Gated on the flag: this is the write-path hook.
+     */
+    invalidateEntity(entityId: string): number;
+    /**
+     * Unconditionally drop this entity's bundles. Backs `cache.clear_user` and
+     * `cache.clear_customer`, which are explicit user requests and so are not
+     * gated on the invalidate-on-write flag.
+     */
+    dropEntity(entityId: string): number;
+    /**
+     * A read-only diagnostic projection of the cache.
+     *
+     * Backs `client.anticipation_cache_snapshot()` and mirrors Python's shape
+     * key for key, including snake_case keys: this output gets logged, diffed
+     * and pasted into issues across both SDKs, so it is a wire format.
+     *
+     * Note the 140-character content previews. That is Python's literal, and it
+     * is deliberately NOT the 120 of `telemetry.content_preview_chars` from the
+     * contract, which caps lookup telemetry rather than this snapshot.
+     */
+    snapshot(): AnticipationCacheSnapshot;
+    /**
+     * The freshest `user_summary` bundle for this entity, or null.
+     *
+     * `entityId` is REQUIRED, and a missing one refuses the lookup rather than
+     * falling back to the freshest summary across all users. Python hardened this
+     * for exactly that reason: the permissive version could splice user A's
+     * summary into user B's response on the conversation-scope path.
+     */
+    lookupUserSummary(entityId: string | null | undefined, scopeRung?: string | null): Record<string, unknown> | null;
+    /**
+     * Drop every bundle belonging to one conversation.
+     *
+     * Backs the `compaction_update` signal on the Listen stream: a compaction
+     * rewrites the conversation's summary, so any bundle built from the previous
+     * state is stale and must not keep serving for the rest of its TTL.
+     *
+     * Unlike `dropEntity`, client-scope bundles are NOT spared: a bundle is only
+     * dropped here if it is bound to this specific conversation, and a shared
+     * client-scope bundle has no conversation id to match.
+     */
+    dropConversation(conversationId: string): number;
+    clear(): void;
+    private miss;
+    private fire;
+    private freshnessLookup;
+    /**
+     * The widened scope-match set for a request.
+     *
+     * A narrower-scope request also matches broader-scope bundles for the same
+     * customer or client. Falsy ids are dropped so an empty customer_id cannot
+     * accidentally match bundles keyed at "".
+     */
+    private buildAcceptedScope;
+    /**
+     * The rung is checked FIRST and it never widens. Everything else here widens
+     * deliberately: a user-scope request reaches customer-shared bundles, and a
+     * conversation-scope request reaches user-scope ones. A rung is the opposite
+     * kind of thing, so it is checked before the tiers and no amount of widening
+     * can put a cross-rung bundle back in.
+     */
+    private getValidBundleIds;
+    private effectiveTtl;
+    private evictExpired;
+    private dropBundle;
+}
+
+/**
+ * Synap SDK error taxonomy.
+ *
+ * Mirrors `maximem_synap/models/errors.py` 1:1, including the four
+ * backward-compatibility aliases at the bottom. If you add an error to one
+ * SDK, add it to the other in the same change.
+ *
+ * ## Why every error carries a `.code`
+ *
+ * This package ships dual ESM + CJS. A consumer whose dependency graph pulls
+ * in both formats gets *two* copies of every class in this file, and then:
+ *
+ *     try { ... } catch (e) { if (e instanceof SynapError) { ... } }
+ *
+ * silently evaluates to `false` against the copy from the other format. Error
+ * handling stops working and nothing throws to tell you. `.code` is a plain
+ * string, so it is immune. Prefer it at package boundaries:
+ *
+ *     if (isSynapError(e) && e.code === 'rate_limit') { ... }
+ *
+ * `Symbol.hasInstance` is also wired up on the base class, so `instanceof`
+ * works across realms too -- but `.code` is the documented contract.
+ */
+/** Stable, format-independent discriminators. Never renumber or reuse. */
+type SynapErrorCode = 'synap_error' | 'transient' | 'permanent' | 'network_timeout' | 'rate_limit' | 'insufficient_credits' | 'service_unavailable' | 'invalid_input' | 'invalid_instance_id' | 'invalid_conversation_id' | 'authentication' | 'context_not_found' | 'conflict' | 'transcript_conflict' | 'session_expired' | 'listening_already_active' | 'listening_not_active' | 'agent_unavailable';
+interface SynapErrorOptions {
+    correlationId?: string | null;
+    cause?: unknown;
+}
+declare class SynapError extends Error {
+    /**
+     * The single declaration site for each subclass's code.
+     *
+     * It is `static` rather than a class field on purpose. Under
+     * `useDefineForClassFields` (the default at our ES2022 target) a class field
+     * is an *instance* property, so it is invisible from the constructor object.
+     * `Symbol.hasInstance` below only has the constructor to work with, so a
+     * field would leave it unable to tell `AuthenticationError` from
+     * `RateLimitError` -- it would report every Synap error as an instance of
+     * every other one.
+     */
+    static readonly errorCode: SynapErrorCode;
+    /** True for errors where a retry may succeed. Static for the same reason. */
+    static readonly isTransient: boolean;
+    /** Own, enumerable, so logs and JSON.stringify include it. */
+    readonly code: SynapErrorCode;
+    readonly correlationId: string | null;
+    readonly transient: boolean;
+    constructor(message: string, options?: SynapErrorOptions);
+    static [Symbol.hasInstance](instance: unknown): boolean;
+}
+/** Type guard that works across ESM/CJS copies and realms. */
+declare function isSynapError(e: unknown): e is SynapError;
+declare class SynapTransientError extends SynapError {
+    static readonly errorCode: SynapErrorCode;
+    static readonly isTransient: boolean;
+}
+declare class SynapPermanentError extends SynapError {
+    static readonly errorCode: SynapErrorCode;
+    static readonly isTransient: boolean;
+}
+declare class NetworkTimeoutError extends SynapTransientError {
+    static readonly errorCode: SynapErrorCode;
+}
+/**
+ * Rate limit exceeded (HTTP 429, gRPC RESOURCE_EXHAUSTED).
+ *
+ * Also carries the two credit stops the server reports as 429, because both
+ * recover with time or a plan change rather than with a retry of this request:
+ * `reason: 'trial_limit_reached'` (the Trial cap is spent, see `upgradeUrl`)
+ * and `reason: 'subscription_inactive'` (a paid plan whose subscription is past
+ * due, unpaid or cancelled, see `manageUrl`). `reason` is null for an ordinary
+ * rate limit and against a server too old to send one.
+ */
+declare class RateLimitError extends SynapTransientError {
+    static readonly errorCode: SynapErrorCode;
+    readonly retryAfterSeconds: number | null;
+    /** Machine-readable cause, when the stop was a credit stop. */
+    readonly reason: string | null;
+    /** Where a Trial customer upgrades. Python calls this `upgrade_url`. */
+    readonly upgradeUrl: string | null;
+    /** Where billing is managed. Python calls this `manage_url`. */
+    readonly manageUrl: string | null;
+    constructor(message: string, options?: SynapErrorOptions & {
+        retryAfterSeconds?: number | null;
+        reason?: string | null;
+        upgradeUrl?: string | null;
+        manageUrl?: string | null;
+    });
+}
+declare class ServiceUnavailableError extends SynapTransientError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare class AgentUnavailableError extends SynapTransientError {
+    static readonly errorCode: SynapErrorCode;
+    constructor(message?: string, options?: SynapErrorOptions);
+}
+/**
+ * The caller's credit wallet cannot cover this request.
+ *
+ * HTTP 402, and gRPC RESOURCE_EXHAUSTED with credit-related trailing metadata.
+ * Permanent by design: retrying without topping up burns quota and never
+ * succeeds. This is the error behind "the agent forgot" reports where retrieval
+ * silently returns nothing.
+ */
+declare class InsufficientCreditsError extends SynapPermanentError {
+    static readonly errorCode: SynapErrorCode;
+    readonly balanceCredits: number | null;
+    readonly requiredCredits: number | null;
+    /** Where the balance can be viewed. Python calls this `recovery_url`. */
+    readonly recoveryUrl: string | null;
+    /** Where a redeem code can be entered. Python calls this `redeem_url`. */
+    readonly redeemUrl: string | null;
+    /**
+     * Machine-readable cause. `'overages_disabled'` means the plan is paid and
+     * the balance is spent, but the account has not allowed usage past zero, so
+     * the work stops until someone allows overages or adds credits. Null when an
+     * older server did not send one.
+     */
+    readonly reason: string | null;
+    /** Where that setting and billing are managed. Python calls this `manage_url`. */
+    readonly manageUrl: string | null;
+    constructor(message: string, options?: SynapErrorOptions & {
+        balanceCredits?: number | null;
+        requiredCredits?: number | null;
+        recoveryUrl?: string | null;
+        redeemUrl?: string | null;
+        reason?: string | null;
+        manageUrl?: string | null;
+    });
+}
+declare class InvalidInputError extends SynapPermanentError {
+    static readonly errorCode: SynapErrorCode;
+}
+/**
+ * Raised by `validateInstanceId` before any network call, matching Python's
+ * `utils/validators.py`. The message text is identical in both SDKs.
+ */
+declare class InvalidInstanceIdError extends InvalidInputError {
+    static readonly errorCode: SynapErrorCode;
+}
+/** See the note on InvalidInstanceIdError. Raised by `validateConversationId`. */
+declare class InvalidConversationIdError extends InvalidInputError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare class AuthenticationError extends SynapPermanentError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare class ContextNotFoundError extends SynapPermanentError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare class ConflictError extends SynapPermanentError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare class TranscriptConflictError extends ConflictError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare class SessionExpiredError extends SynapPermanentError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare class ListeningAlreadyActiveError extends SynapPermanentError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare class ListeningNotActiveError extends SynapPermanentError {
+    static readonly errorCode: SynapErrorCode;
+}
+declare const SDKError: typeof SynapError;
+declare const TransientError: typeof SynapTransientError;
+declare const PermanentError: typeof SynapPermanentError;
+declare const ConnectionError: typeof NetworkTimeoutError;
+
+export { AnticipationCache as A, type BundleItem as B, ConflictError as C, isSynapError as D, type ExitReason as E, InsufficientCreditsError as I, ListeningAlreadyActiveError as L, NetworkTimeoutError as N, PermanentError as P, RateLimitError as R, SynapError as S, TranscriptConflictError as T, type AnticipationCacheSnapshot as a, ANY_SCOPE as b, AgentUnavailableError as c, type AnticipationCacheOptions as d, AuthenticationError as e, ConnectionError as f, type ContextBundle as g, ContextNotFoundError as h, InvalidConversationIdError as i, InvalidInputError as j, InvalidInstanceIdError as k, ListeningNotActiveError as l, type LookupParams as m, type LookupResult as n, type LookupTelemetry as o, SDKError as p, ServiceUnavailableError as q, SessionExpiredError as r, type SnapshotBundle as s, type SnapshotItemPreview as t, type SnapshotItemRecord as u, type SynapErrorCode as v, type SynapErrorOptions as w, SynapPermanentError as x, SynapTransientError as y, TransientError as z };

package/dist/grpc/index.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunk2TVL5IPQcjs = require('../chunk-2TVL5IPQ.cjs');
 
+var _chunkIA2N5NUYcjs = require('../chunk-IA2N5NUY.cjs');
 
 
-var _chunk7CWBRHUOcjs = require('../chunk-7CWBRHUO.cjs');
+var _chunkT372OL3Qcjs = require('../chunk-T372OL3Q.cjs');
 
 // src/grpc/index.ts
 async function checkGrpcAvailability() {
@@ -32,20 +32,20 @@ async function checkGrpcAvailability() {
 }
 async function listen(options) {
   if (!options.conversationId) {
-    throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)("conversation_id is required to start a listening stream");
+    throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)("conversation_id is required to start a listening stream");
   }
   const availability = await checkGrpcAvailability();
   if (!availability.available) {
-    throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)(availability.detail);
+    throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)(availability.detail);
   }
   const [{ GrpcStreamClient: StreamClient }, { AnticipationCache }, { getEnv }] = await Promise.all([
-    Promise.resolve().then(() => _interopRequireWildcard(require("../stream-client-GPU37E6F.cjs"))),
+    Promise.resolve().then(() => _interopRequireWildcard(require("../stream-client-Y5JGSF2R.cjs"))),
     Promise.resolve().then(() => _interopRequireWildcard(require("../anticipation-cache-LRE3TLK4.cjs"))),
     Promise.resolve().then(() => _interopRequireWildcard(require("../env-55ULHNJZ.cjs")))
   ]);
   const apiKey = _nullishCoalesce(_nullishCoalesce(options.apiKey, () => ( getEnv("SYNAP_API_KEY"))), () => ( ""));
   if (apiKey === "") {
-    throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)(
+    throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)(
       "No Synap API key found. Set SYNAP_API_KEY or pass apiKey."
     );
   }
@@ -83,5 +83,5 @@ async function listen(options) {
 
 
 
-exports.GrpcStreamClient = _chunk7CWBRHUOcjs.GrpcStreamClient; exports.PROTO_SHA = _chunk7CWBRHUOcjs.PROTO_SHA; exports.checkGrpcAvailability = checkGrpcAvailability; exports.listen = listen;
+exports.GrpcStreamClient = _chunkIA2N5NUYcjs.GrpcStreamClient; exports.PROTO_SHA = _chunkIA2N5NUYcjs.PROTO_SHA; exports.checkGrpcAvailability = checkGrpcAvailability; exports.listen = listen;
 //# sourceMappingURL=index.cjs.map

package/dist/grpc/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/private/tmp/ndeep-main/synap/sdk/js/dist/grpc/index.cjs","../../src/grpc/index.ts"],"names":[],"mappings":"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","file":"/private/tmp/ndeep-main/synap/sdk/js/dist/grpc/index.cjs","sourcesContent":[null,"/**\n * gRPC anticipation stream: availability and loading.\n *\n * This is a SUBPATH export (`@maximem/synap-js-sdk/grpc`) and is never\n * imported by the main entry point. Three reasons, all of which have bitten\n * someone already:\n *\n *  1. `@grpc/grpc-js` plus its protos is roughly 5MB. HTTP-only and Edge users\n *     should not pay for it (gotcha G-Q).\n *  2. grpc-js is built on `node:http2`, `node:net` and `node:tls`. Merely\n *     importing it on Edge or Workers fails the *build*, not the call. Keeping\n *     it behind a subpath plus a lazy `import()` means importing the SDK on\n *     Edge stays safe.\n *  3. It is an `optionalDependency`, so it may legitimately be absent.\n *\n * ## Proto loading\n *\n * The stream is live. The proto ships as an INLINED JSON descriptor\n * (./descriptor.ts) loaded through `proto-loader.fromJSON`, not through\n * `loadSync(path)`. proto-loader's file-based path reads the `.proto` off disk\n * at runtime, which breaks under webpack/turbopack bundling and Vercel's `nft`\n * file tracing: at deploy time rather than at test time (gotcha G-P). Inlining\n * gets the same result as ts-proto codegen without a codegen toolchain.\n */\n\nimport { ListeningNotActiveError } from '../errors.js';\nexport { GrpcStreamClient } from './stream-client.js';\nexport type {\n  StreamState, StreamCredentials, StreamClientOptions, ConversationEventInput,\n} from './stream-client.js';\nexport { PROTO_SHA } from './descriptor.js';\n\nexport type GrpcAvailability =\n  | { available: true }\n  | { available: false; reason: 'not-node' | 'module-missing'; detail: string };\n\n/**\n * Whether a gRPC stream could run here.\n *\n * Deliberately does not throw: callers use this to decide whether to offer the\n * stream at all, and a hard failure at that point is unhelpful.\n */\nexport async function checkGrpcAvailability(): Promise<GrpcAvailability> {\n  const isNode =\n    typeof process !== 'undefined' &&\n    process.versions?.node !== undefined &&\n    typeof (globalThis as { EdgeRuntime?: unknown }).EdgeRuntime === 'undefined';\n\n  if (!isNode) {\n    return {\n      available: false,\n      reason: 'not-node',\n      detail:\n        'gRPC needs raw TCP and node:http2, which Edge runtimes and Workers do ' +\n        'not provide. HTTP context fetching works normally here; only the ' +\n        'anticipation stream is unavailable. Reaching Edge would require a ' +\n        'gRPC-Web or Connect endpoint on the server, which does not exist yet.',\n    };\n  }\n\n  try {\n    await import(/* @vite-ignore */ '@grpc/grpc-js');\n    return { available: true };\n  } catch (error) {\n    return {\n      available: false,\n      reason: 'module-missing',\n      detail:\n        '@grpc/grpc-js is an optional dependency and is not installed. Run ' +\n        '`npm install @grpc/grpc-js` to enable the anticipation stream. ' +\n        `(${(error as Error)?.message ?? String(error)})`,\n    };\n  }\n}\n\nexport interface ListenOptions {\n  conversationId: string;\n  userId?: string;\n  customerId?: string;\n  onBundle?: (bundle: unknown) => void;\n}\n\nexport interface ListeningSession {\n  stop(): Promise<void>;\n  readonly active: boolean;\n}\n\n/**\n * Start the anticipation stream directly, without a SynapClient.\n *\n * Most callers want `client.instance.listen()` instead, which shares the\n * client's credentials and anticipation cache. This exists for the case where\n * only the stream is wanted.\n *\n * **Opt-in, and off by default.** The removed wrapper called `listen()`\n * unconditionally during init, so every user had a stream whether they asked\n * for one or not. Making it opt-in is the right default, but it is not a\n * neutral change: fewer streams means fewer anticipation hits and therefore\n * MORE billed cloud fetches for existing users. That has to be announced\n * rather than discovered (gotcha G-Y).\n */\nexport async function listen(\n  options: ListenOptions & {\n    apiKey?: string;\n    clientId?: string;\n    instanceId?: string;\n    host?: string;\n    port?: number;\n    useTls?: boolean;\n  },\n): Promise<ListeningSession> {\n  if (!options.conversationId) {\n    // conversation_id is not a scope tier, but the stream genuinely requires\n    // one: it is what the server keys the anticipation session on.\n    throw new ListeningNotActiveError('conversation_id is required to start a listening stream');\n  }\n\n  const availability = await checkGrpcAvailability();\n  if (!availability.available) {\n    throw new ListeningNotActiveError(availability.detail);\n  }\n\n  const [{ GrpcStreamClient: StreamClient }, { AnticipationCache }, { getEnv }] = await Promise.all([\n    import('./stream-client.js'),\n    import('../context/anticipation-cache.js'),\n    import('../util/env.js'),\n  ]);\n\n  const apiKey = options.apiKey ?? getEnv('SYNAP_API_KEY') ?? '';\n  if (apiKey === '') {\n    throw new ListeningNotActiveError(\n      'No Synap API key found. Set SYNAP_API_KEY or pass apiKey.',\n    );\n  }\n\n  const cache = new AnticipationCache();\n  const client = new StreamClient(\n    {\n      apiKey,\n      clientId: options.clientId ?? getEnv('SYNAP_CLIENT_ID') ?? '',\n      instanceId: options.instanceId ?? getEnv('SYNAP_INSTANCE_ID') ?? '',\n    },\n    cache,\n    {\n      ...(options.host !== undefined ? { host: options.host } : {}),\n      ...(options.port !== undefined ? { port: options.port } : {}),\n      ...(options.useTls !== undefined ? { useTls: options.useTls } : {}),\n      ...(options.onBundle !== undefined ? { onContext: options.onBundle } : {}),\n    },\n  );\n  await client.connect();\n  client.sendSessionControl({\n    action: 'start',\n    conversation_id: options.conversationId,\n    ...(options.userId !== undefined ? { user_id: options.userId } : {}),\n    ...(options.customerId !== undefined ? { customer_id: options.customerId } : {}),\n  });\n\n  return {\n    stop: () => client.disconnect(),\n    get active() { return client.isConnected; },\n  };\n}\n"]}
+{"version":3,"sources":["/Users/scaler/maximem_synap/synap/sdk/js/dist/grpc/index.cjs","../../src/grpc/index.ts"],"names":[],"mappings":"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","file":"/Users/scaler/maximem_synap/synap/sdk/js/dist/grpc/index.cjs","sourcesContent":[null,"/**\n * gRPC anticipation stream: availability and loading.\n *\n * This is a SUBPATH export (`@maximem/synap-js-sdk/grpc`) and is never\n * imported by the main entry point. Three reasons, all of which have bitten\n * someone already:\n *\n *  1. `@grpc/grpc-js` plus its protos is roughly 5MB. HTTP-only and Edge users\n *     should not pay for it (gotcha G-Q).\n *  2. grpc-js is built on `node:http2`, `node:net` and `node:tls`. Merely\n *     importing it on Edge or Workers fails the *build*, not the call. Keeping\n *     it behind a subpath plus a lazy `import()` means importing the SDK on\n *     Edge stays safe.\n *  3. It is an `optionalDependency`, so it may legitimately be absent.\n *\n * ## Proto loading\n *\n * The stream is live. The proto ships as an INLINED JSON descriptor\n * (./descriptor.ts) loaded through `proto-loader.fromJSON`, not through\n * `loadSync(path)`. proto-loader's file-based path reads the `.proto` off disk\n * at runtime, which breaks under webpack/turbopack bundling and Vercel's `nft`\n * file tracing: at deploy time rather than at test time (gotcha G-P). Inlining\n * gets the same result as ts-proto codegen without a codegen toolchain.\n */\n\nimport { ListeningNotActiveError } from '../errors.js';\nexport { GrpcStreamClient } from './stream-client.js';\nexport type {\n  StreamState, StreamCredentials, StreamClientOptions, ConversationEventInput,\n} from './stream-client.js';\nexport { PROTO_SHA } from './descriptor.js';\n\nexport type GrpcAvailability =\n  | { available: true }\n  | { available: false; reason: 'not-node' | 'module-missing'; detail: string };\n\n/**\n * Whether a gRPC stream could run here.\n *\n * Deliberately does not throw: callers use this to decide whether to offer the\n * stream at all, and a hard failure at that point is unhelpful.\n */\nexport async function checkGrpcAvailability(): Promise<GrpcAvailability> {\n  const isNode =\n    typeof process !== 'undefined' &&\n    process.versions?.node !== undefined &&\n    typeof (globalThis as { EdgeRuntime?: unknown }).EdgeRuntime === 'undefined';\n\n  if (!isNode) {\n    return {\n      available: false,\n      reason: 'not-node',\n      detail:\n        'gRPC needs raw TCP and node:http2, which Edge runtimes and Workers do ' +\n        'not provide. HTTP context fetching works normally here; only the ' +\n        'anticipation stream is unavailable. Reaching Edge would require a ' +\n        'gRPC-Web or Connect endpoint on the server, which does not exist yet.',\n    };\n  }\n\n  try {\n    await import(/* @vite-ignore */ '@grpc/grpc-js');\n    return { available: true };\n  } catch (error) {\n    return {\n      available: false,\n      reason: 'module-missing',\n      detail:\n        '@grpc/grpc-js is an optional dependency and is not installed. Run ' +\n        '`npm install @grpc/grpc-js` to enable the anticipation stream. ' +\n        `(${(error as Error)?.message ?? String(error)})`,\n    };\n  }\n}\n\nexport interface ListenOptions {\n  conversationId: string;\n  userId?: string;\n  customerId?: string;\n  onBundle?: (bundle: unknown) => void;\n}\n\nexport interface ListeningSession {\n  stop(): Promise<void>;\n  readonly active: boolean;\n}\n\n/**\n * Start the anticipation stream directly, without a SynapClient.\n *\n * Most callers want `client.instance.listen()` instead, which shares the\n * client's credentials and anticipation cache. This exists for the case where\n * only the stream is wanted.\n *\n * **Opt-in, and off by default.** The removed wrapper called `listen()`\n * unconditionally during init, so every user had a stream whether they asked\n * for one or not. Making it opt-in is the right default, but it is not a\n * neutral change: fewer streams means fewer anticipation hits and therefore\n * MORE billed cloud fetches for existing users. That has to be announced\n * rather than discovered (gotcha G-Y).\n */\nexport async function listen(\n  options: ListenOptions & {\n    apiKey?: string;\n    clientId?: string;\n    instanceId?: string;\n    host?: string;\n    port?: number;\n    useTls?: boolean;\n  },\n): Promise<ListeningSession> {\n  if (!options.conversationId) {\n    // conversation_id is not a scope tier, but the stream genuinely requires\n    // one: it is what the server keys the anticipation session on.\n    throw new ListeningNotActiveError('conversation_id is required to start a listening stream');\n  }\n\n  const availability = await checkGrpcAvailability();\n  if (!availability.available) {\n    throw new ListeningNotActiveError(availability.detail);\n  }\n\n  const [{ GrpcStreamClient: StreamClient }, { AnticipationCache }, { getEnv }] = await Promise.all([\n    import('./stream-client.js'),\n    import('../context/anticipation-cache.js'),\n    import('../util/env.js'),\n  ]);\n\n  const apiKey = options.apiKey ?? getEnv('SYNAP_API_KEY') ?? '';\n  if (apiKey === '') {\n    throw new ListeningNotActiveError(\n      'No Synap API key found. Set SYNAP_API_KEY or pass apiKey.',\n    );\n  }\n\n  const cache = new AnticipationCache();\n  const client = new StreamClient(\n    {\n      apiKey,\n      clientId: options.clientId ?? getEnv('SYNAP_CLIENT_ID') ?? '',\n      instanceId: options.instanceId ?? getEnv('SYNAP_INSTANCE_ID') ?? '',\n    },\n    cache,\n    {\n      ...(options.host !== undefined ? { host: options.host } : {}),\n      ...(options.port !== undefined ? { port: options.port } : {}),\n      ...(options.useTls !== undefined ? { useTls: options.useTls } : {}),\n      ...(options.onBundle !== undefined ? { onContext: options.onBundle } : {}),\n    },\n  );\n  await client.connect();\n  client.sendSessionControl({\n    action: 'start',\n    conversation_id: options.conversationId,\n    ...(options.userId !== undefined ? { user_id: options.userId } : {}),\n    ...(options.customerId !== undefined ? { customer_id: options.customerId } : {}),\n  });\n\n  return {\n    stop: () => client.disconnect(),\n    get active() { return client.isConnected; },\n  };\n}\n"]}

package/dist/grpc/index.d.cts

@@ -1,4 +1,4 @@
-import { A as AnticipationCache } from '../anticipation-cache-C1rUEpaW.cjs';
+import { A as AnticipationCache, S as SynapError } from '../errors-Bl3vY1eb.cjs';
 
 /**
  * Bidirectional gRPC stream client for the Synap anticipation channel.
@@ -51,8 +51,24 @@ interface ConversationEventInput {
     tool_name?: string;
     /** proto: ConversationEvent.tool_args_json. Python sends json.dumps(tool_args). */
     tool_args_json?: string;
+    /**
+     * proto: ConversationEvent.tool_result_json. A result is not a message, so
+     * it does not ride in `content`; a string is sent as itself rather than as a
+     * quoted JSON string, matching Python.
+     */
+    tool_result_json?: string;
+    /** proto: ConversationEvent.tool_call_id. Ties a result to its call. */
+    tool_call_id?: string;
     search_queries?: string[];
     context_types?: string[];
+    /**
+     * proto: ConversationEvent.event_id. Minted here when absent, and the SAME
+     * id travels on every replay — that is what the server's dedupe matches, so
+     * a retry cannot double a turn.
+     */
+    event_id?: string;
+    /** proto: ConversationEvent.sent_at_ms. When we FIRST tried, not when it happened. */
+    sent_at_ms?: number;
 }
 declare class GrpcStreamClient {
     #private;
@@ -62,9 +78,33 @@ declare class GrpcStreamClient {
     constructor(credentials: StreamCredentials, cache: AnticipationCache, options?: StreamClientOptions);
     get currentState(): StreamState;
     get isConnected(): boolean;
+    /**
+     * The error that ended the stream, if one did.
+     *
+     * Set when the server refused the stream for credits, so an `onDisconnect`
+     * handler can read the balance, the reason and the URL to fix it. Null for an
+     * ordinary disconnect.
+     */
+    get lastError(): SynapError | null;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    /** Fire-and-forget: a dropped event must never fail the caller's turn. */
+    /**
+     * What this client could not get to the server.
+     *
+     * Every send path returns void, so a caller had no way to tell a delivered
+     * turn from a lost one. Mirrors Python's `undelivered()`.
+     */
+    undelivered(): {
+        queued: number;
+        unacknowledged: number;
+    };
+    /**
+     * Never fails the caller's turn, and no longer loses it either.
+     *
+     * A write that cannot go out is buffered and replayed on reconnect, and a
+     * write that does go out is held until the server acknowledges it. Before
+     * this, both cases ended at a silent `return`.
+     */
     sendConversationEvent(event: ConversationEventInput): void;
     sendSessionControl(input: {
         action: string;
@@ -82,14 +122,14 @@ declare class GrpcStreamClient {
  *
  * Source:    synap/proto/synap_service.proto
  * Generator: synap/sdk/scripts/gen_proto_descriptor.mjs
- * Proto SHA: a58c9b031b41530d
+ * Proto SHA: c1d834043608ad4f
  *
  * The proto is inlined as a JSON descriptor rather than loaded from disk so
  * that bundlers and Vercel file tracing cannot lose it. Regenerate with
  * `npm run sync-behavior` in synap/sdk/js.
  */
 /** sha256 (first 16 hex chars) of the proto this descriptor was built from. */
-declare const PROTO_SHA = "a58c9b031b41530d";
+declare const PROTO_SHA = "c1d834043608ad4f";
 
 /**
  * gRPC anticipation stream: availability and loading.

package/dist/grpc/index.d.ts

@@ -1,4 +1,4 @@
-import { A as AnticipationCache } from '../anticipation-cache-C1rUEpaW.js';
+import { A as AnticipationCache, S as SynapError } from '../errors-Bl3vY1eb.js';
 
 /**
  * Bidirectional gRPC stream client for the Synap anticipation channel.
@@ -51,8 +51,24 @@ interface ConversationEventInput {
     tool_name?: string;
     /** proto: ConversationEvent.tool_args_json. Python sends json.dumps(tool_args). */
     tool_args_json?: string;
+    /**
+     * proto: ConversationEvent.tool_result_json. A result is not a message, so
+     * it does not ride in `content`; a string is sent as itself rather than as a
+     * quoted JSON string, matching Python.
+     */
+    tool_result_json?: string;
+    /** proto: ConversationEvent.tool_call_id. Ties a result to its call. */
+    tool_call_id?: string;
     search_queries?: string[];
     context_types?: string[];
+    /**
+     * proto: ConversationEvent.event_id. Minted here when absent, and the SAME
+     * id travels on every replay — that is what the server's dedupe matches, so
+     * a retry cannot double a turn.
+     */
+    event_id?: string;
+    /** proto: ConversationEvent.sent_at_ms. When we FIRST tried, not when it happened. */
+    sent_at_ms?: number;
 }
 declare class GrpcStreamClient {
     #private;
@@ -62,9 +78,33 @@ declare class GrpcStreamClient {
     constructor(credentials: StreamCredentials, cache: AnticipationCache, options?: StreamClientOptions);
     get currentState(): StreamState;
     get isConnected(): boolean;
+    /**
+     * The error that ended the stream, if one did.
+     *
+     * Set when the server refused the stream for credits, so an `onDisconnect`
+     * handler can read the balance, the reason and the URL to fix it. Null for an
+     * ordinary disconnect.
+     */
+    get lastError(): SynapError | null;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    /** Fire-and-forget: a dropped event must never fail the caller's turn. */
+    /**
+     * What this client could not get to the server.
+     *
+     * Every send path returns void, so a caller had no way to tell a delivered
+     * turn from a lost one. Mirrors Python's `undelivered()`.
+     */
+    undelivered(): {
+        queued: number;
+        unacknowledged: number;
+    };
+    /**
+     * Never fails the caller's turn, and no longer loses it either.
+     *
+     * A write that cannot go out is buffered and replayed on reconnect, and a
+     * write that does go out is held until the server acknowledges it. Before
+     * this, both cases ended at a silent `return`.
+     */
     sendConversationEvent(event: ConversationEventInput): void;
     sendSessionControl(input: {
         action: string;
@@ -82,14 +122,14 @@ declare class GrpcStreamClient {
  *
  * Source:    synap/proto/synap_service.proto
  * Generator: synap/sdk/scripts/gen_proto_descriptor.mjs
- * Proto SHA: a58c9b031b41530d
+ * Proto SHA: c1d834043608ad4f
  *
  * The proto is inlined as a JSON descriptor rather than loaded from disk so
  * that bundlers and Vercel file tracing cannot lose it. Regenerate with
  * `npm run sync-behavior` in synap/sdk/js.
  */
 /** sha256 (first 16 hex chars) of the proto this descriptor was built from. */
-declare const PROTO_SHA = "a58c9b031b41530d";
+declare const PROTO_SHA = "c1d834043608ad4f";
 
 /**
  * gRPC anticipation stream: availability and loading.

package/dist/grpc/index.js

@@ -1,10 +1,10 @@
-import {
-  ListeningNotActiveError
-} from "../chunk-OCMM2Z5P.js";
 import {
   GrpcStreamClient,
   PROTO_SHA
-} from "../chunk-T5QQBJ6T.js";
+} from "../chunk-ASM2OIIG.js";
+import {
+  ListeningNotActiveError
+} from "../chunk-BWMPKLFG.js";
 
 // src/grpc/index.ts
 async function checkGrpcAvailability() {
@@ -39,7 +39,7 @@ async function listen(options) {
     throw new ListeningNotActiveError(availability.detail);
   }
   const [{ GrpcStreamClient: StreamClient }, { AnticipationCache }, { getEnv }] = await Promise.all([
-    import("../stream-client-2C5KIOWP.js"),
+    import("../stream-client-6OWRYOA4.js"),
     import("../anticipation-cache-WLU4NMD5.js"),
     import("../env-QCUKKW36.js")
   ]);