@niadra/sdk 0.9.0 → 0.10.3

package/CHANGELOG.md

@@ -4,6 +4,77 @@ All notable changes to this package are documented here. The format follows [Kee
 
 ## [Unreleased]
 
+## [0.10.3] - 2026-10-03
+
+### Added
+
+- `keepWarm` (on by default): while a conversation or task is open (created and not ended) and the client was
+  used in the last 10 minutes, the client sends `GET /healthz` every 100 s when nothing else went out for 90 s,
+  one attempt with a 2-second budget, so the connection to the region stays open. A turn after a long pause no
+  longer pays TCP, TLS and often DNS again. The pings are not the client's use, the timer is `unref()`'d, and a
+  conversation nobody holds any more stops them. `keepWarm: false` never pings.
+
+## [0.10.2] - 2026-10-03
+
+### Changed
+
+- The client measures the round trip to the region once when it starts (`GET /healthz`, twice), not only for
+  voice, which also opens the connection the first read uses. `timeouts.context` and `timeouts.navigation` left
+  at their defaults take the measured round trip on top: from Sao Paulo (170 ms to us-east-2) every chat read
+  with the defaults ran out of time. A value you set stays a ceiling, and the client logs one warning when the
+  round trip plus 50 ms exceeds it. The voice budgets are unchanged, and their warnings now come only once the
+  client reads in voice. `voice: { probe: false }` measures nothing.
+
+## [0.10.1] - 2026-10-03
+
+### Added
+
+- `contextUse({ since, until, group_by, source_id, channel, view, experiment_group })`: the context-use report
+  (`GET /v1/context-use`) as `ContextUseReport`, with its buckets typed and the other blocks passing through.
+  A key of an `analyst` source with the `analytics` scope reads every source of the space.
+- `link({ person, organization, role })` and `endLink(linkId)`: a system of record that knows who works for whom
+  (a CRM, an HR system) links a person to the account or partner they act for, and ends the link, with a key
+  that has the `identity:link` scope instead of `admin`. `can_see_contacts` still needs `admin`. `Link` and
+  `LinkRequest` are the types.
+
+## [0.10.0] - 2026-10-03
+
+### Added
+
+- `open(id, { about })`: with the person bound in `subject`, also an item of the organization they act for that
+  their view shows (the pack's account block). `tools()` bound with `about` passes it, so the kit reaches what
+  the pack shows.
+- `about_unlinked` on `ContextResponse`, `SearchResponse` and `TimelineResponse`: `about` named an organization
+  with no active link to the subject, and the read went on with the subject's own memory. A conversation or a
+  task warns once through its `logger`.
+- `explain(error)`: an API refusal for a log line, with its code, detail and request id. A coordination check
+  takes the client's `logger`, and `HistoryItemKind` includes `system_event`.
+
+### Changed
+
+- An API error's `message` ends with the request id: `422 invalid_input: <detail> (request <id>)`.
+- `govIdHmac` and `orgRegistryHmac` take the document number itself; the space keeps only a keyed hash of it.
+- Idle connections are kept for `keepAliveMs` between turns, and a call that has to open a connection gets
+  `timeouts.connect` (1,000 ms by default) on top of its method's budget, once per cold period, so a first read
+  after idle no longer times out on the TLS handshake.
+- A coordination check the API refuses (400, 401, 403 or 422) is `invalid_request`, never `unchecked`: an
+  outbound contact is deferred and an inbound one allowed, and `strict` throws. Refusals of background writes
+  (the outbox, turn records) log the problem's detail and request id.
+- The tool definitions follow the server's: the timeline tool says it also lists the open items, facts,
+  patterns or objects `filters.item_kinds` names.
+
+## [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, g5 as TurnParams, f_ as TurnFrame } from './client-rmWhZJOx.cjs';
+import { a as ProofSource, A as AgentMemoryOption, b as Session, S as SessionResolver } from './shared-zaTBum17.cjs';
+export { P as Proof, c as attestationProof } from './shared-zaTBum17.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, g5 as TurnParams, f_ as TurnFrame } from './client-rmWhZJOx.js';
+import { a as ProofSource, A as AgentMemoryOption, b as Session, S as SessionResolver } from './shared-Cs7h5C4Y.js';
+export { P as Proof, c as attestationProof } from './shared-Cs7h5C4Y.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-C0XODsy9.cjs';
+import { S as SessionResolver } from './shared-zaTBum17.cjs';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-zaTBum17.cjs';
+import './client-rmWhZJOx.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-veMDudKV.js';
+import { S as SessionResolver } from './shared-Cs7h5C4Y.js';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-Cs7h5C4Y.js';
+import './client-rmWhZJOx.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-rmWhZJOx.cjs';
+import { W as WrapOptions } from './intercept-C0XODsy9.cjs';
+import { S as SessionResolver } from './shared-zaTBum17.cjs';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-zaTBum17.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-rmWhZJOx.js';
+import { W as WrapOptions } from './intercept-veMDudKV.js';
+import { S as SessionResolver } from './shared-Cs7h5C4Y.js';
+export { A as AgentMemoryOption, P as Proof, a as ProofSource, b as Session, c as attestationProof } from './shared-Cs7h5C4Y.js';
 
 /**
  * Niadra for Amazon Bedrock's Converse API (`@aws-sdk/client-bedrock-runtime`), as `wrap()` is for