@niadra/sdk 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this package are documented here. The format follows [Kee
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-10-02
+
+### Changed
+
+- The canonical phone of the suppression list follows the revised rules of the suppression spec (3.1 and 3.4): Mexico's and Argentina's mobile prefixes, an 11-digit North American number, a carrier code, `(0)`, `tel:` and direction marks. The key the SDK computes for an opted-out contact matches the server's again.
+
+### Added
+
+- A route or field the API deprecates answers with the `Deprecation`, `Sunset` and `Link` headers; the
+  client logs one warning per deprecated route per process through its `logger`, with the two dates and the
+  migration note, never the path.
+
 ## [0.9.0] - 2026-09-30
 
 ### Added

package/README.md

@@ -77,6 +77,45 @@ ESM and CommonJS builds with full type definitions; it only needs `fetch`.
 | `objectState()`, `objectTimeline()` | a business object (an order, an invoice, a ticket) as the systems of record reported it |
 | `feedback()` | a correction of what Niadra derived, audited like any other event |
 
+## Benchmark
+
+Niadra and ten other memory systems for agents (thirteen configurations) were measured on the same dataset, in the same AWS region
+(us-east-2), with the same agent and the same judge for every system. The script, the dataset and every
+result file are in this repository, under [`benchmarks/`](https://github.com/ainiadra/niadra-sdk-python/tree/main/benchmarks),
+so anyone can run it again. The full page, with every metric and where Niadra does not lead, is at
+[niadra.com/benchmark](https://niadra.com/benchmark).
+
+Combined run of 01/10/2026 ([`2026-09-30-abb516`](https://github.com/ainiadra/niadra-sdk-python/tree/main/benchmarks/results/2026-09-30-abb516)),
+cross-channel accuracy on the same 165 valid cases, judged by the same model:
+
+| System | Accuracy | Model spend per 1,000 conversations |
+|---|---|---|
+| **Niadra** (3 repetitions) | **98.7%** | **US$ 0.36** |
+| Hindsight | 86.7% | US$ 6.10 |
+| Amazon Bedrock AgentCore Memory (3 repetitions) | 80% | US$ 7.50 (AWS public price, its models included) |
+| Honcho (dialectic) | 79.4% | US$ 6.92 |
+| Mem0 open source (3 repetitions) | 77.6% | US$ 1.88 |
+| Memobase | 77% | US$ 4.13 |
+| Supermemory local | 71.6% | US$ 5.78 |
+| Cognee | 70.3% | US$ 6.95 |
+| LangMem | 66.7% | US$ 3.70 |
+| Graphiti | 52.8% | US$ 18.72 |
+| MemOS | 51.6% | US$ 3.70 |
+
+With a different user id on each channel (agents from different vendors), Mem0 open source drops to
+28.5%, AgentCore Memory to 27.9%, and Niadra stays at 98.7%. Sensitive values reaching an unverified
+conversation: Niadra 0 of 32; Mem0 and AgentCore Memory 32 of 32.
+
+Typed state ([`typed/2026-09-30-b59a5d`](https://github.com/ainiadra/niadra-sdk-python/tree/main/benchmarks/results/typed/2026-09-30-b59a5d)):
+with the state and constraints blocks, 84.9% correct [78, 90] against 36.6% without them; declared
+constraints respected went from 0% to 94.4%, and what changed since the customer last saw it from 0% to
+100%, with no extra tokens on a turn that asks for no block.
+
+Where Niadra does not lead in that run: ingest acknowledgement against systems that write in the
+background, opening a single history item, history search p95 against LangMem by a few ms, and tokens per
+turn against readers that return answer text. The benchmark is produced by Niadra; that is why every input
+and output is public.
+
 ## Questions people ask
 
 **How do I give my AI agent memory of past conversations on other channels?** Record the turns
@@ -798,7 +837,7 @@ Include `requestId` when you contact support.
 
 ```sh
 pnpm install
-pnpm check     # typecheck, lint, tests (the integrations with their frameworks' real types)
+pnpm check     # typecheck, lint, tests (the integrations with their frameworks' real types), audit of the runtime dependencies
 pnpm build     # ESM and CommonJS into dist/, one entry per integration
 pnpm runtimes  # the build on Deno, Bun, workerd and the Edge Runtime
 pnpm --filter "./packages/*" check   # the n8n and Flowise nodes

package/dist/ai-sdk.d.cts

@@ -1,7 +1,7 @@
 import { ToolSet } from 'ai';
-import { f as ModelUsage, fZ as TurnParams, fS as TurnFrame } from './client-B_ip8T2o.cjs';
-import { a as ProofSource, A as AgentMemoryOption, b as Session, S as SessionResolver } from './shared-DEkF2Y_z.cjs';
-export { P as Proof, c as attestationProof } from './shared-DEkF2Y_z.cjs';
+import { f as ModelUsage, fZ as TurnParams, fS as TurnFrame } from './client-CWMxmJHs.cjs';
+import { a as ProofSource, A as AgentMemoryOption, b as Session, S as SessionResolver } from './shared-Cq8mz-7m.cjs';
+export { P as Proof, c as attestationProof } from './shared-Cq8mz-7m.cjs';
 
 /**
  * Niadra for the Vercel AI SDK (`ai` 5, 6 and 7), the idiomatic way: a language model middleware

package/dist/ai-sdk.d.ts

@@ -1,7 +1,7 @@
 import { ToolSet } from 'ai';
-import { f as ModelUsage, fZ as TurnParams, fS as TurnFrame } from './client-B_ip8T2o.js';
-import { a as ProofSource, A as AgentMemoryOption, b as Session, S as SessionResolver } from './shared-BLkAbvuf.js';
-export { P as Proof, c as attestationProof } from './shared-BLkAbvuf.js';
+import { f as ModelUsage, fZ as TurnParams, fS as TurnFrame } from './client-CWMxmJHs.js';
+import { a as ProofSource, A as AgentMemoryOption, b as Session, S as SessionResolver } from './shared-B4Ef2Wpg.js';
+export { P as Proof, c as attestationProof } from './shared-B4Ef2Wpg.js';
 
 /**
  * Niadra for the Vercel AI SDK (`ai` 5, 6 and 7), the idiomatic way: a language model middleware

package/dist/anthropic.d.cts

@@ -1,7 +1,7 @@
-import { W as WrapOptions } from './intercept-CxmBLfoj.cjs';
-import { S as SessionResolver } from './shared-DEkF2Y_z.cjs';
-export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-DEkF2Y_z.cjs';
-import './client-B_ip8T2o.cjs';
+import { W as WrapOptions } from './intercept-CGngQI8B.cjs';
+import { S as SessionResolver } from './shared-Cq8mz-7m.cjs';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-Cq8mz-7m.cjs';
+import './client-CWMxmJHs.cjs';
 
 /**
  * Niadra for the Anthropic TypeScript SDK (`@anthropic-ai/sdk`), as `wrap()` is for OpenAI.

package/dist/anthropic.d.ts

@@ -1,7 +1,7 @@
-import { W as WrapOptions } from './intercept-CBaPK_-k.js';
-import { S as SessionResolver } from './shared-BLkAbvuf.js';
-export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-BLkAbvuf.js';
-import './client-B_ip8T2o.js';
+import { W as WrapOptions } from './intercept-Bv0nLpSw.js';
+import { S as SessionResolver } from './shared-B4Ef2Wpg.js';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-B4Ef2Wpg.js';
+import './client-CWMxmJHs.js';
 
 /**
  * Niadra for the Anthropic TypeScript SDK (`@anthropic-ai/sdk`), as `wrap()` is for OpenAI.

package/dist/bedrock.d.cts

@@ -1,7 +1,7 @@
-import { f as ModelUsage } from './client-B_ip8T2o.cjs';
-import { W as WrapOptions } from './intercept-CxmBLfoj.cjs';
-import { S as SessionResolver } from './shared-DEkF2Y_z.cjs';
-export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-DEkF2Y_z.cjs';
+import { f as ModelUsage } from './client-CWMxmJHs.cjs';
+import { W as WrapOptions } from './intercept-CGngQI8B.cjs';
+import { S as SessionResolver } from './shared-Cq8mz-7m.cjs';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-Cq8mz-7m.cjs';
 
 /**
  * Niadra for Amazon Bedrock's Converse API (`@aws-sdk/client-bedrock-runtime`), as `wrap()` is for

package/dist/bedrock.d.ts

@@ -1,7 +1,7 @@
-import { f as ModelUsage } from './client-B_ip8T2o.js';
-import { W as WrapOptions } from './intercept-CBaPK_-k.js';
-import { S as SessionResolver } from './shared-BLkAbvuf.js';
-export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-BLkAbvuf.js';
+import { f as ModelUsage } from './client-CWMxmJHs.js';
+import { W as WrapOptions } from './intercept-Bv0nLpSw.js';
+import { S as SessionResolver } from './shared-B4Ef2Wpg.js';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-B4Ef2Wpg.js';
 
 /**
  * Niadra for Amazon Bedrock's Converse API (`@aws-sdk/client-bedrock-runtime`), as `wrap()` is for

package/dist/cli.js

@@ -503,7 +503,7 @@ function internalRecord(span, ref, act) {
 }
 
 // src/version.ts
-var VERSION = "0.9.0";
+var VERSION = "0.9.1";
 
 // src/transport.ts
 var RETRYABLE_WRITE_STATUS = /* @__PURE__ */ new Set([408, 421, 429, 500, 502, 503, 504]);
@@ -597,6 +597,7 @@ var Transport = class {
     } catch (error) {
       throw deadline.explain(error);
     }
+    warnIfDeprecated(this.config.logger, init.method ?? "GET", url, response.headers);
     const requestId = response.headers.get("x-request-id");
     let payload;
     try {
@@ -666,6 +667,29 @@ var Deadline = class {
     return new NiadraConnectionError(`connection failed: ${message}`, { cause: error });
   }
 };
+var VERSIONING_DOCS = "https://docs.niadra.com/en/security/api-versioning";
+var DEPRECATION_LINK = /<([^>]*)>[^,]*;\s*rel="?deprecation"?/gi;
+var deprecationsSeen = /* @__PURE__ */ new Set();
+function warnIfDeprecated(logger, method, url, headers) {
+  const since = headers.get("deprecation");
+  if (since === null) return;
+  const links = [...(headers.get("link") ?? "").matchAll(DEPRECATION_LINK)].map((match) => match[1] ?? "");
+  const key2 = `${method} ${links.join(" ") || (url.split("?")[0] ?? url)}`;
+  if (deprecationsSeen.has(key2)) return;
+  deprecationsSeen.add(key2);
+  const sunset = headers.get("sunset");
+  logger.warn(
+    `the API deprecated a ${method} route this client calls, since ${deprecatedSince(since)}; it stops answering on ${sunset === null ? "a date not announced yet" : sunsetDay(sunset)}. See ${links.join(", ") || VERSIONING_DOCS}`
+  );
+}
+function deprecatedSince(value) {
+  const seconds = Number(value.trim().replace(/^@/, ""));
+  return Number.isInteger(seconds) ? new Date(seconds * 1e3).toISOString().slice(0, 10) : value;
+}
+function sunsetDay(value) {
+  const time = Date.parse(value);
+  return Number.isNaN(time) ? value : new Date(time).toISOString().slice(0, 10);
+}
 async function readBody(response) {
   const text2 = await response.text();
   if (text2.length === 0) return null;
@@ -4376,26 +4400,42 @@ async function suppressionKey(salt, canonical) {
   const key2 = await subtle.importKey("raw", saltBytes(salt), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
   return toBase64url(new Uint8Array(await subtle.sign("HMAC", key2, new TextEncoder().encode(canonical))));
 }
+var AREA_CODES = new Set(
+  "11 12 13 14 15 16 17 18 19 21 22 24 27 28 31 32 33 34 35 37 38 41 42 43 44 45 46 47 48 49 51 53 54 55 61 62 63 64 65 66 67 68 69 71 73 74 75 77 79 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 97 98 99".split(" ")
+);
+var FORMAT_CHARACTERS = new RegExp("\\p{Cf}", "gu");
 function phone(value) {
-  const raw = value.trim().replace(SEPARATORS2, "");
-  const international = raw.startsWith("+") || raw.startsWith("00");
+  let text2 = value.normalize("NFKC").replace(FORMAT_CHARACTERS, "").trim();
+  if (text2.slice(0, 4).toLowerCase() === "tel:") text2 = text2.slice(4);
+  const international = text2.startsWith("+") || text2.startsWith("00");
+  if (international) text2 = text2.replaceAll("(0)", "");
+  const raw = text2.replace(SEPARATORS2, "");
   let digits = raw.startsWith("+") ? raw.slice(1) : international ? raw.slice(2) : raw;
   if (!DIGITS2.test(digits)) throw new NiadraDestinationError("invalid_handle");
-  const national = digits.replace(/^0+/, "");
-  if (!international && (national.length === 10 || national.length === 11) && isArea(national.slice(0, 2))) {
-    digits = `55${national}`;
+  if (!international) {
+    const national = digits.replace(/^0+/, "");
+    if (isBrazilianNational(national)) {
+      digits = `55${national}`;
+    } else if (digits.startsWith("0") && (national.length === 12 || national.length === 13)) {
+      if (isBrazilianNational(national.slice(2))) digits = `55${national.slice(2)}`;
+    }
   }
   if (digits.length < 8 || digits.length > 15 || digits.startsWith("0")) {
     throw new NiadraDestinationError("invalid_handle");
   }
   const rest = digits.slice(2);
-  if (digits.startsWith("55") && rest.length === 10 && isArea(rest.slice(0, 2)) && "6789".includes(rest.charAt(2))) {
+  if (digits.startsWith("55") && rest.length === 10 && AREA_CODES.has(rest.slice(0, 2)) && "6789".includes(rest.charAt(2))) {
     digits = `55${rest.slice(0, 2)}9${rest.slice(2)}`;
   }
+  if (digits.length === 13 && (digits.startsWith("521") || digits.startsWith("549"))) {
+    digits = digits.slice(0, 2) + digits.slice(3);
+  }
   return `phone:+${digits}`;
 }
-function isArea(code) {
-  return /^[1-9]{2}$/.test(code);
+function isBrazilianNational(national) {
+  if (!AREA_CODES.has(national.slice(0, 2))) return false;
+  if (national.length === 10) return "23456789".includes(national.charAt(2));
+  return national.length === 11 && national.charAt(2) === "9";
 }
 function saltBytes(salt) {
   const bytes = fromBase64url(salt);
@@ -8456,7 +8496,8 @@ var Niadra = class _Niadra {
       baseURL,
       apiKey,
       fetch: fetchImpl,
-      defaultHeaders: options.defaultHeaders ?? {}
+      defaultHeaders: options.defaultHeaders ?? {},
+      logger: this.logger
     });
     const queueOptions = { ...DEFAULT_QUEUE, ...options.queue };
     queueOptions.maxBatchSize = Math.min(queueOptions.maxBatchSize, 499);