@niadra/sdk 0.10.5 → 0.11.1

package/dist/google-genai.d.ts

@@ -1,7 +1,7 @@
-import { f as ModelUsage } from './client-DHPuVvHW.js';
-import { W as WrapOptions } from './intercept-CJWSHZk9.js';
-import { S as SessionResolver } from './shared-XhiKa4WA.js';
-export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-XhiKa4WA.js';
+import { f as ModelUsage } from './client-CdkRzWz6.js';
+import { W as WrapOptions } from './intercept-tVhq4GNK.js';
+import { S as SessionResolver } from './shared-SqZSrkls.js';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-SqZSrkls.js';
 
 /**
  * Niadra for the Google Gen AI SDK (`@google/genai`), as `wrap()` is for OpenAI.

package/dist/index.cjs

@@ -129,7 +129,7 @@ function explain(error) {
 var segment = (value) => encodeURIComponent(value);
 function correction(profileId, params) {
   const body = { profile_id: profileId, action: params.action };
-  if (params.fact_id) body.fact_id = params.fact_id.replace(/^fact:/, "");
+  if (params.fact_id) body.fact_id = params.fact_id;
   if (params.open_item_id) body.open_item_id = params.open_item_id;
   if (params.value) body.value = params.value;
   if (params.reason) body.reason = params.reason;
@@ -152,9 +152,9 @@ var Admin = class {
       () => this.port.read("GET", `/v1/profiles/${segment(profileId)}/memory`, void 0, options)
     );
   }
-  /** Every value a fact's slot held, oldest first, with who replaced whom. Takes `fact:<id>` or the bare id. */
+  /** Every value a fact's slot held, oldest first, with who replaced whom. Takes the fact's bare id. */
   factHistory(profileId, factId, options = {}) {
-    const fact = segment(factId.replace(/^fact:/, ""));
+    const fact = segment(factId);
     return this.port.send(
       () => this.port.read("GET", `/v1/profiles/${segment(profileId)}/facts/${fact}/history`, void 0, options)
     );
@@ -525,7 +525,7 @@ function internalRecord(span, ref, act) {
 }
 
 // src/version.ts
-var VERSION = "0.10.5";
+var VERSION = "0.11.1";
 
 // src/transport.ts
 var RETRYABLE_WRITE_STATUS = /* @__PURE__ */ new Set([408, 421, 429, 500, 502, 503, 504]);
@@ -3164,7 +3164,7 @@ function render(block, binding, call, mode = "advisory") {
   if (mode === "apply") {
     const disputed = new Set(conflicts2.map((c) => c.id));
     const allowed = /* @__PURE__ */ new Set([
-      ...hard.filter((h) => SAID.has(h.source) && (h.scope === "turn" || h.scope === "session") && !disputed.has(h.id)).map((h) => h.id),
+      ...hard.filter((h) => SAID.has(h.source) && (h.scope === "turn" || h.scope === "session" || h.scope === "object") && !disputed.has(h.id)).map((h) => h.id),
       ...attributes.filter((a) => a.source === "stated" || a.source === "correction").map((a) => a.id)
     ]);
     for (const [param, value] of suggested) {
@@ -7714,6 +7714,7 @@ var silentLogger = { debug: noop, warn: noop, error: noop };
 // src/options.ts
 var DEFAULT_TIMEOUTS = {
   context: 300,
+  contextFirst: 1e3,
   contextVoice: 200,
   contextVoiceStart: 1500,
   navigation: 600,
@@ -7989,7 +7990,7 @@ var TOOL_DEFINITIONS = [
     "type": "function",
     "function": {
       "name": "search_customer_history",
-      "description": "Search everything that already happened with this customer: past conversations, promises, agent actions, orders and invoices. Use it when the customer refers to something earlier or asks whether a problem happened before. Do not call it when the answer is already in the context block, including its 'Hist\xF3rico' line, which already counts recurrences. Returns short items with date, channel and outcome, plus a recurrence count. Open a conversation (`episode:`) or an object (`object:`) with open_history_item; the other items are complete as listed.",
+      "description": "Search everything that already happened with this customer: past conversations, promises, agent actions, orders and invoices. Use it when the customer refers to something earlier or asks whether a problem happened before. Do not call it when the answer is already in the context block, including its 'Hist\xF3rico' line, which already counts recurrences. Returns short items with date, channel and outcome, plus a recurrence count. Open a conversation (kind `episode`) or an object (kind `object`) by its id with open_history_item; the other items are complete as listed.",
       "parameters": {
         "type": "object",
         "properties": {
@@ -8129,13 +8130,13 @@ var TOOL_DEFINITIONS = [
     "type": "function",
     "function": {
       "name": "open_history_item",
-      "description": "Open one conversation (`episode:`) or business object (`object:`) returned by search_customer_history or get_customer_timeline: what was asked, what was promised and by whom, the outcome and what memory came from it. Actions, events, facts and promises are complete as listed and do not open. Use it only after a search or timeline pointed to the item.",
+      "description": "Open one conversation (kind `episode`) or business object (kind `object`) returned by search_customer_history or get_customer_timeline: what was asked, what was promised and by whom, the outcome and what memory came from it. Actions, events, facts and promises are complete as listed and do not open. Use it only after a search or timeline pointed to the item.",
       "parameters": {
         "type": "object",
         "properties": {
           "id": {
             "type": "string",
-            "description": "The item id, e.g. `episode:...`."
+            "description": "The item's `id`, as listed."
           }
         },
         "required": [
@@ -8524,6 +8525,7 @@ function rttWarnings(rttMs, timeouts) {
 }
 
 // src/client.ts
+var READ_KEYS_KEPT = 4096;
 function readEnv(name) {
   try {
     const env = globalThis.process?.env;
@@ -8551,6 +8553,8 @@ var Niadra = class _Niadra {
   voiceStarted = false;
   /** A probe is on its way: until it ends, default read budgets get `timeouts.connect` on top. */
   measuring = false;
+  /** The keys whose read answered in this client, oldest first: a first read gets `timeouts.contextFirst`. */
+  answeredReads = /* @__PURE__ */ new Map();
   voiceWarned = false;
   strict;
   /** Where the client reports what it swallows in fail-open mode. */
@@ -8737,14 +8741,28 @@ var Niadra = class _Niadra {
     if (this.content.registered && result2.state) result2.state = await this.content.fill(result2.state);
     return result2;
   }
-  readContext(core, params, request, options) {
-    const timeout = options.timeout ?? (request.view === "voice" ? this.timeouts.contextVoice : this.readBudget("context"));
+  async readContext(core, params, request, options) {
     const { query: own3, ...pinned2 } = request;
     const query = turnText(own3 ?? params.turn);
+    const readKey = cacheKey(pinned2);
+    const first = !this.answeredReads.has(readKey);
+    const timeout = options.timeout ?? (request.view === "voice" ? this.timeouts.contextVoice : this.readBudget("context", first));
     const voiceCache = this.voiceCache(core, pinned2, options.cache);
-    if (voiceCache) return this.voiceContext(core, voiceCache, pinned2, query, timeout, options);
-    if (query !== null) return this.turnContext(core, pinned2, query, timeout, options);
-    return this.pinnedContext(core, pinned2, timeout, options);
+    let result2;
+    if (voiceCache) result2 = await this.voiceContext(core, voiceCache, pinned2, query, timeout, options);
+    else if (query !== null) result2 = await this.turnContext(core, pinned2, query, timeout, options);
+    else result2 = await this.pinnedContext(core, pinned2, timeout, options);
+    if (result2.error === null) this.readAnswered(readKey);
+    return result2;
+  }
+  readAnswered(key2) {
+    this.answeredReads.delete(key2);
+    this.answeredReads.set(key2, true);
+    while (this.answeredReads.size > READ_KEYS_KEPT) {
+      const oldest = this.answeredReads.keys().next().value;
+      if (oldest === void 0) break;
+      this.answeredReads.delete(oldest);
+    }
   }
   /**
    * The SDK profile of this key's space: the features it turned on, the claim contract and the summarized
@@ -9152,7 +9170,9 @@ var Niadra = class _Niadra {
     const key2 = AgentMemoryCache.key(params);
     const fresh = cache?.fresh(key2);
     if (fresh) return blockResult(fresh, "cache");
-    const timeout = options.timeout ?? (params.view === "voice" ? this.timeouts.contextVoice : this.readBudget("context"));
+    const readKey = `agent-memory:${key2}`;
+    const first = !this.answeredReads.has(readKey);
+    const timeout = options.timeout ?? (params.view === "voice" ? this.timeouts.contextVoice : this.readBudget("context", first));
     const spec = this.readSpec("GET", "/v1/agent-memory/block", void 0, timeout, options);
     spec.query = {
       max_tokens: String(params.max_tokens ?? 300),
@@ -9163,6 +9183,7 @@ var Niadra = class _Niadra {
     if (etag) spec.headers = { ...options.headers, "if-none-match": etag };
     try {
       const response = await core.transport.request(spec);
+      this.readAnswered(readKey);
       cache?.store(key2, response.data);
       return blockResult(response.data, "network");
     } catch (error) {
@@ -9651,12 +9672,13 @@ var Niadra = class _Niadra {
    * to the region goes on top, so an agent far from the region (Sao Paulo, 170 ms from us-east-2) is not
    * timed out by the network; one the caller set is a ceiling.
    */
-  readBudget(name) {
+  readBudget(name, first = false) {
     if (!this.defaultReads.has(name)) return this.timeouts[name];
+    const base = first && name === "context" ? Math.max(this.timeouts.context, this.timeouts.contextFirst) : this.timeouts[name];
     const rtt = this.voice.rtt;
-    if (rtt !== null) return this.timeouts[name] + rtt;
+    if (rtt !== null) return base + rtt;
     const open = this.core?.transport.connectionOpen() ?? false;
-    return this.measuring && open ? this.timeouts[name] + this.timeouts.connect : this.timeouts[name];
+    return this.measuring && open ? base + this.timeouts.connect : base;
   }
   /** The client reads in voice: the voice budgets' warnings matter from now on. */
   startVoice(core) {