@niadra/sdk 0.9.1 → 0.10.3

package/CHANGELOG.md

@@ -4,6 +4,65 @@ 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

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-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';
+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-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';
+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-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';
+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-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';
+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-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';
+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-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';
+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