@niadra/sdk 0.11.0 → 0.11.2

package/dist/{client-CG257pe3.d.cts → client-C0FxHZgk.d.cts}

@@ -9,7 +9,7 @@ type Speaker = "customer" | "ai_agent" | "human_agent" | "system";
 /** `internal` events (notes between agents, system traces) never reach a customer-facing view. */
 type Visibility = "public" | "internal";
 /** Subjects are people by default; accounts and partners are organizations. */
-type SubjectKind = "person" | "account" | "partner";
+type SubjectKind = "person" | "account" | "partner" | "staff";
 /**
  * How a handle identifies a subject. Scoped types (`wa_bsuid`, `system_id`, `gov_id_hmac`,
  * `org_registry_hmac`) need `scope` so the same value in two namespaces never collides.
@@ -6512,6 +6512,14 @@ interface Timeouts {
      * people's turns.
      */
     contextVoice: number;
+    /**
+     * The default budget of the first read of a conversation, task or object in this client, before the round
+     * trip: the API compiles its pack on that read. One right after a customer's first message took 410 ms on
+     * the server (05/10/2026: resolving the customer 153 ms, the pack 120 ms), more than `context`, and the
+     * agent answered without memory. Later reads of the same key find the pack compiled. Only when `context`
+     * is left at its default.
+     */
+    contextFirst: number;
     /**
      * The first read of a voice call, made while the phone rings or the inbound webhook runs
      * (`begin()`, `ready()`). A cold connection costs three round trips (TCP, TLS, the request)
@@ -6862,6 +6870,8 @@ declare class Niadra {
     private voiceStarted;
     /** A probe is on its way: until it ends, default read budgets get `timeouts.connect` on top. */
     private measuring;
+    /** The keys whose read answered in this client, oldest first: a first read gets `timeouts.contextFirst`. */
+    private readonly answeredReads;
     private voiceWarned;
     private readonly strict;
     /** Where the client reports what it swallows in fail-open mode. */
@@ -6922,6 +6932,7 @@ declare class Niadra {
      */
     context(params: ContextParams, options?: ContextOptions): Promise<ContextResult>;
     private readContext;
+    private readAnswered;
     /**
      * The SDK profile of this key's space: the features it turned on, the claim contract and the summarized
      * type registry, from the local cache, read again once `valid_for_s` has passed. When Niadra does not

package/dist/{client-CG257pe3.d.ts → client-C0FxHZgk.d.ts}

@@ -9,7 +9,7 @@ type Speaker = "customer" | "ai_agent" | "human_agent" | "system";
 /** `internal` events (notes between agents, system traces) never reach a customer-facing view. */
 type Visibility = "public" | "internal";
 /** Subjects are people by default; accounts and partners are organizations. */
-type SubjectKind = "person" | "account" | "partner";
+type SubjectKind = "person" | "account" | "partner" | "staff";
 /**
  * How a handle identifies a subject. Scoped types (`wa_bsuid`, `system_id`, `gov_id_hmac`,
  * `org_registry_hmac`) need `scope` so the same value in two namespaces never collides.
@@ -6512,6 +6512,14 @@ interface Timeouts {
      * people's turns.
      */
     contextVoice: number;
+    /**
+     * The default budget of the first read of a conversation, task or object in this client, before the round
+     * trip: the API compiles its pack on that read. One right after a customer's first message took 410 ms on
+     * the server (05/10/2026: resolving the customer 153 ms, the pack 120 ms), more than `context`, and the
+     * agent answered without memory. Later reads of the same key find the pack compiled. Only when `context`
+     * is left at its default.
+     */
+    contextFirst: number;
     /**
      * The first read of a voice call, made while the phone rings or the inbound webhook runs
      * (`begin()`, `ready()`). A cold connection costs three round trips (TCP, TLS, the request)
@@ -6862,6 +6870,8 @@ declare class Niadra {
     private voiceStarted;
     /** A probe is on its way: until it ends, default read budgets get `timeouts.connect` on top. */
     private measuring;
+    /** The keys whose read answered in this client, oldest first: a first read gets `timeouts.contextFirst`. */
+    private readonly answeredReads;
     private voiceWarned;
     private readonly strict;
     /** Where the client reports what it swallows in fail-open mode. */
@@ -6922,6 +6932,7 @@ declare class Niadra {
      */
     context(params: ContextParams, options?: ContextOptions): Promise<ContextResult>;
     private readContext;
+    private readAnswered;
     /**
      * The SDK profile of this key's space: the features it turned on, the claim contract and the summarized
      * type registry, from the local cache, read again once `valid_for_s` has passed. When Niadra does not

package/dist/cloudflare-agents.d.cts

@@ -1,8 +1,8 @@
 import { ToolSet } from 'ai';
-import { c as Niadra, g as Handle, g8 as TurnOptions, f as ModelUsage } from './client-CG257pe3.cjs';
+import { c as Niadra, g as Handle, g8 as TurnOptions, f as ModelUsage } from './client-C0FxHZgk.cjs';
 import { NiadraMiddleware } from './ai-sdk.cjs';
-import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared-Dmo7pRV5.cjs';
-export { P as Proof, c as attestationProof } from './shared-Dmo7pRV5.cjs';
+import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared-BgH4GypR.cjs';
+export { P as Proof, c as attestationProof } from './shared-BgH4GypR.cjs';
 
 /**
  * Niadra for the Cloudflare Agents SDK (`agents` 0.x): one helper per `Agent` instance (a Durable

package/dist/cloudflare-agents.d.ts

@@ -1,8 +1,8 @@
 import { ToolSet } from 'ai';
-import { c as Niadra, g as Handle, g8 as TurnOptions, f as ModelUsage } from './client-CG257pe3.js';
+import { c as Niadra, g as Handle, g8 as TurnOptions, f as ModelUsage } from './client-C0FxHZgk.js';
 import { NiadraMiddleware } from './ai-sdk.js';
-import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared--OTV6MgP.js';
-export { P as Proof, c as attestationProof } from './shared--OTV6MgP.js';
+import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared-DNEUVdMh.js';
+export { P as Proof, c as attestationProof } from './shared-DNEUVdMh.js';
 
 /**
  * Niadra for the Cloudflare Agents SDK (`agents` 0.x): one helper per `Agent` instance (a Durable

package/dist/elevenlabs.d.cts

@@ -1,8 +1,8 @@
-import { c as Niadra, g as Handle } from './client-CG257pe3.cjs';
-import { P as Proof, A as AgentMemoryOption } from './shared-Dmo7pRV5.cjs';
-export { c as attestationProof } from './shared-Dmo7pRV5.cjs';
-import { H as HeadersLike, W as WebhookResponse, C as CallStore } from './webhook-CPc6wZKf.cjs';
-export { a as CallRecord, m as memoryCallStore } from './webhook-CPc6wZKf.cjs';
+import { c as Niadra, g as Handle } from './client-C0FxHZgk.cjs';
+import { P as Proof, A as AgentMemoryOption } from './shared-BgH4GypR.cjs';
+export { c as attestationProof } from './shared-BgH4GypR.cjs';
+import { H as HeadersLike, W as WebhookResponse, C as CallStore } from './webhook-JVLjLq-R.cjs';
+export { a as CallRecord, m as memoryCallStore } from './webhook-JVLjLq-R.cjs';
 
 /**
  * Niadra for the ElevenLabs Agents Platform, on the server side: a phone call reaches ElevenLabs,

package/dist/elevenlabs.d.ts

@@ -1,8 +1,8 @@
-import { c as Niadra, g as Handle } from './client-CG257pe3.js';
-import { P as Proof, A as AgentMemoryOption } from './shared--OTV6MgP.js';
-export { c as attestationProof } from './shared--OTV6MgP.js';
-import { H as HeadersLike, W as WebhookResponse, C as CallStore } from './webhook-Bcgl38Nz.js';
-export { a as CallRecord, m as memoryCallStore } from './webhook-Bcgl38Nz.js';
+import { c as Niadra, g as Handle } from './client-C0FxHZgk.js';
+import { P as Proof, A as AgentMemoryOption } from './shared-DNEUVdMh.js';
+export { c as attestationProof } from './shared-DNEUVdMh.js';
+import { H as HeadersLike, W as WebhookResponse, C as CallStore } from './webhook-CmjN8aRy.js';
+export { a as CallRecord, m as memoryCallStore } from './webhook-CmjN8aRy.js';
 
 /**
  * Niadra for the ElevenLabs Agents Platform, on the server side: a phone call reaches ElevenLabs,

package/dist/genkit.d.cts

@@ -1,8 +1,8 @@
 import { ModelMiddleware } from 'genkit/model';
 import { ToolAction } from 'genkit/tool';
-import { f as ModelUsage } from './client-CG257pe3.cjs';
-import { a as ProofSource, A as AgentMemoryOption, S as SessionResolver, b as Session } from './shared-Dmo7pRV5.cjs';
-export { P as Proof, c as attestationProof } from './shared-Dmo7pRV5.cjs';
+import { f as ModelUsage } from './client-C0FxHZgk.cjs';
+import { a as ProofSource, A as AgentMemoryOption, S as SessionResolver, b as Session } from './shared-BgH4GypR.cjs';
+export { P as Proof, c as attestationProof } from './shared-BgH4GypR.cjs';
 
 /**
  * Niadra for Genkit (`genkit` 1.x, Firebase Genkit for JavaScript): a model middleware for

package/dist/genkit.d.ts

@@ -1,8 +1,8 @@
 import { ModelMiddleware } from 'genkit/model';
 import { ToolAction } from 'genkit/tool';
-import { f as ModelUsage } from './client-CG257pe3.js';
-import { a as ProofSource, A as AgentMemoryOption, S as SessionResolver, b as Session } from './shared--OTV6MgP.js';
-export { P as Proof, c as attestationProof } from './shared--OTV6MgP.js';
+import { f as ModelUsage } from './client-C0FxHZgk.js';
+import { a as ProofSource, A as AgentMemoryOption, S as SessionResolver, b as Session } from './shared-DNEUVdMh.js';
+export { P as Proof, c as attestationProof } from './shared-DNEUVdMh.js';
 
 /**
  * Niadra for Genkit (`genkit` 1.x, Firebase Genkit for JavaScript): a model middleware for

package/dist/google-adk.d.cts

@@ -1,7 +1,7 @@
 import { Context, LlmRequest, LlmResponse, BaseTool, ReadonlyContext } from '@google/adk';
-import { f as ModelUsage } from './client-CG257pe3.cjs';
-import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared-Dmo7pRV5.cjs';
-export { P as Proof, c as attestationProof } from './shared-Dmo7pRV5.cjs';
+import { f as ModelUsage } from './client-C0FxHZgk.cjs';
+import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared-BgH4GypR.cjs';
+export { P as Proof, c as attestationProof } from './shared-BgH4GypR.cjs';
 
 /**
  * Niadra for the Agent Development Kit for TypeScript (`@google/adk` 2.x): model callbacks and the

package/dist/google-adk.d.ts

@@ -1,7 +1,7 @@
 import { Context, LlmRequest, LlmResponse, BaseTool, ReadonlyContext } from '@google/adk';
-import { f as ModelUsage } from './client-CG257pe3.js';
-import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared--OTV6MgP.js';
-export { P as Proof, c as attestationProof } from './shared--OTV6MgP.js';
+import { f as ModelUsage } from './client-C0FxHZgk.js';
+import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared-DNEUVdMh.js';
+export { P as Proof, c as attestationProof } from './shared-DNEUVdMh.js';
 
 /**
  * Niadra for the Agent Development Kit for TypeScript (`@google/adk` 2.x): model callbacks and the

package/dist/google-genai.d.cts

@@ -1,7 +1,7 @@
-import { f as ModelUsage } from './client-CG257pe3.cjs';
-import { W as WrapOptions } from './intercept-CvbXtKsU.cjs';
-import { S as SessionResolver } from './shared-Dmo7pRV5.cjs';
-export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-Dmo7pRV5.cjs';
+import { f as ModelUsage } from './client-C0FxHZgk.cjs';
+import { W as WrapOptions } from './intercept--jszljK3.cjs';
+import { S as SessionResolver } from './shared-BgH4GypR.cjs';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-BgH4GypR.cjs';
 
 /**
  * Niadra for the Google Gen AI SDK (`@google/genai`), as `wrap()` is for OpenAI.

package/dist/google-genai.d.ts

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

package/dist/index.cjs

@@ -525,7 +525,7 @@ function internalRecord(span, ref, act) {
 }
 
 // src/version.ts
-var VERSION = "0.11.0";
+var VERSION = "0.11.2";
 
 // src/transport.ts
 var RETRYABLE_WRITE_STATUS = /* @__PURE__ */ new Set([408, 421, 429, 500, 502, 503, 504]);
@@ -5780,6 +5780,13 @@ var handles = {
   appUserId: (value, options) => build("app_user_id", value, void 0, options),
   /** The id of a person or organization in a system of record; `system` names that system, such as `crm`. */
   systemId: (value, system, options) => build("system_id", value, system, options),
+  /**
+   * Someone who works for your company, by the id one of your systems gives them: `staff("U-17", "hr")`.
+   * A conversation with staff is internal: the agent reads what your team may read, and what the person says
+   * is your company's word. A conversation with anyone else is customer-facing, whatever the key. Only a
+   * system id names staff: a phone or an e-mail always names a customer.
+   */
+  staff: (value, system) => build("system_id", value, system, { subjectKind: "staff" }),
   /**
    * A person's national document, such as a CPF: `govIdHmac("529.982.247-25", "BR")`. Send the number
    * itself, never a hash of it: the server checks its check digits, then keeps only a keyed hash with your
@@ -7714,6 +7721,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,
@@ -8524,6 +8532,7 @@ function rttWarnings(rttMs, timeouts) {
 }
 
 // src/client.ts
+var READ_KEYS_KEPT = 4096;
 function readEnv(name) {
   try {
     const env = globalThis.process?.env;
@@ -8551,6 +8560,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 +8748,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 +9177,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 +9190,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 +9679,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) {