@niadra/sdk 0.1.1 → 0.7.0

package/dist/strands.cjs

@@ -0,0 +1,352 @@
+'use strict';
+
+var sdk = require('@strands-agents/sdk');
+
+// src/integrations/strands.ts
+function providerOf(model, usage) {
+  const slash = model.indexOf("/");
+  if (slash > 0) return model.slice(0, slash).trim().toLowerCase();
+  const name = model.trim().toLowerCase();
+  if (name.startsWith("claude") || `.${name}`.includes(".anthropic.")) return "anthropic";
+  if (name.startsWith("gemini")) return "google";
+  return "openai";
+}
+
+// src/context.ts
+function emptyResult(error) {
+  return { text: "", suffix: "", variables: {}, pack: null, source: "none", response: null, error, constraints: null, state: null, coordination: null };
+}
+
+// src/integrations/shared.ts
+var ATTESTED = { A: "V2", B: "V1", C: "V1" };
+function attestationProof(attestation) {
+  if (!attestation) return null;
+  const value = attestation.trim().toUpperCase();
+  if (value.includes("FAILED") || value.startsWith("NO-")) return null;
+  const letter = value.length === 1 ? value : /PASSED-([ABC])$/.exec(value)?.[1];
+  const level = letter ? ATTESTED[letter] : void 0;
+  return level ? { method: "network_attestation", level } : null;
+}
+function resolveSession(source) {
+  if (typeof source !== "function") return source;
+  try {
+    return source() ?? null;
+  } catch {
+    return null;
+  }
+}
+function isConversation(session) {
+  return "customer" in session && typeof session.customer === "function";
+}
+function errorName(error) {
+  return error instanceof Error ? error.name : typeof error;
+}
+var Bridge = class {
+  constructor(session, proof, memory = false) {
+    this.session = session;
+    this.proof = proof;
+    this.memory = memory;
+  }
+  session;
+  proof;
+  memory;
+  proving = null;
+  /** `begin()` started the first read of a call: the first `context()` waits for it with `ready()`. */
+  begun = false;
+  opened = false;
+  /**
+   * The context and, when enabled, the agent's notes, read side by side within the same budget.
+   * Never rejects.
+   */
+  async read(options = {}) {
+    const memoryParams = this.memory === false ? null : this.memory === true ? {} : withoutWrite(this.memory);
+    const [context, memory] = await Promise.all([
+      this.context(options),
+      memoryParams ? this.agentMemory(memoryParams, options) : Promise.resolve("")
+    ]);
+    return { context, memory, prefix: [memory, context.text].filter(Boolean).join("\n\n"), suffix: context.suffix };
+  }
+  get logger() {
+    return this.session.logger;
+  }
+  /**
+   * Starts the first read of a call now, in the background, after the proof when one was given (the
+   * pack depends on the level it proves): at call start, so the read runs while the call is set up.
+   * The first `context()` then waits for it within `timeouts.contextVoiceStart`. Never throws.
+   */
+  begin() {
+    const session = this.session;
+    if (!isConversation(session)) return;
+    const start = () => {
+      this.safe("start the first read", () => {
+        this.begun = session.begin();
+      });
+    };
+    if (this.proof === void 0 || this.proof === null) start();
+    else void this.verifyOnce().then(start);
+  }
+  /** Verifies once (when a proof was given), then reads the context. Never rejects. */
+  async context(options = {}) {
+    await this.verifyOnce();
+    try {
+      const session = this.session;
+      if (this.begun && !this.opened && isConversation(session)) {
+        this.opened = true;
+        await session.ready(options.timeout === void 0 ? {} : { timeout: options.timeout });
+      }
+      return await this.session.context(options);
+    } catch (error) {
+      this.logger.warn(`could not read context (${errorName(error)})`);
+      return emptyResult(null);
+    }
+  }
+  /** Records that `context` went into the prompt, unless it was empty for a reason other than the holdout. */
+  injected(context) {
+    if (!context.text && !context.suffix && context.response?.path !== "holdout") return;
+    this.safe("mark the injection", () => {
+      this.session.markInjected(context);
+    });
+  }
+  customer(text, options = {}) {
+    const session = this.session;
+    if (!text.trim() || !isConversation(session)) return;
+    this.safe("record the customer's turn", () => session.customer(text, options));
+  }
+  /** Sends the customer's turn so far, while they speak. In the background; never throws. */
+  prefetch(text) {
+    const session = this.session;
+    if (!text.trim() || !isConversation(session)) return;
+    this.safe("prefetch the turn", () => session.prefetch(text));
+  }
+  agent(text, options = {}) {
+    if (!text.trim()) return;
+    this.safe("record the agent's turn", () => this.session.agent(text, options));
+  }
+  /** Records a transfer. Tasks have no transfer; the call is ignored for them. */
+  async handoff(target, reason) {
+    const session = this.session;
+    if (!isConversation(session)) return;
+    try {
+      await session.handoff(reason ? { target, reason } : { target });
+    } catch (error) {
+      this.logger.warn(`could not record the handoff (${errorName(error)})`);
+    }
+  }
+  async end() {
+    try {
+      await this.session.end();
+    } catch (error) {
+      this.logger.warn(`could not end the session (${errorName(error)})`);
+    }
+  }
+  /** The navigation kit as plain specs (with the agent's memory tools when enabled), or none for a task about an object only. */
+  tools() {
+    let bound;
+    try {
+      const memory = this.memory;
+      bound = this.session.tools(memory === false ? {} : { agentMemory: true, writeAgentMemory: memory !== true && memory.write === true });
+    } catch (error) {
+      this.logger.warn(`could not build the tools (${errorName(error)})`);
+      return [];
+    }
+    return bound ? toolSpecs(bound) : [];
+  }
+  async agentMemory(params, options) {
+    try {
+      const result = await this.session.agentMemory(params, options.timeout === void 0 ? {} : { timeout: options.timeout });
+      return result.text;
+    } catch (error) {
+      this.logger.warn(`could not read the agent's memory (${errorName(error)})`);
+      return "";
+    }
+  }
+  async verifyOnce() {
+    if (this.proof === void 0 || this.proof === null) return;
+    this.proving ??= this.runVerify();
+    await this.proving;
+  }
+  async runVerify() {
+    try {
+      const source = this.proof;
+      const proof = typeof source === "function" ? await source() : source;
+      if (!proof) return;
+      await this.session.verify(proof);
+    } catch (error) {
+      this.logger.warn(`could not record the verification (${errorName(error)})`);
+    }
+  }
+  safe(what, run) {
+    try {
+      run();
+    } catch (error) {
+      this.logger.warn(`could not ${what} (${errorName(error)})`);
+    }
+  }
+};
+function withoutWrite(option) {
+  const { write: _, ...params } = option;
+  return params;
+}
+function toolSpecs(bound) {
+  return bound.definitions.map(({ function: definition }) => ({
+    name: definition.name,
+    description: definition.description,
+    parameters: definition.parameters,
+    execute: (args) => bound.call(definition.name, args)
+  }));
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function count(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+}
+
+// src/integrations/strands.ts
+var MODELS = {
+  BedrockModel: { provider: "bedrock", cacheApart: true },
+  AnthropicModel: { provider: "anthropic", cacheApart: true },
+  OpenAIModel: { provider: "openai", cacheApart: false },
+  GoogleModel: { provider: "google", cacheApart: false }
+};
+var NiadraPlugin = class {
+  constructor(session, options = {}) {
+    this.session = session;
+    this.options = options;
+  }
+  session;
+  options;
+  name = "niadra";
+  states = /* @__PURE__ */ new WeakMap();
+  initAgent(agent) {
+    agent.addMiddleware(sdk.InvokeModelStage.Input, (context) => this.prepare(agent, context));
+    agent.addMiddleware(sdk.InvokeModelStage.Output, (result) => {
+      this.record(agent, result);
+      return result;
+    });
+  }
+  /** The kit bound to a fixed session; none when the session is found per call. */
+  getTools() {
+    return typeof this.session === "function" ? [] : niadraTools(this.session, this.options.agentMemory === void 0 ? {} : { agentMemory: this.options.agentMemory });
+  }
+  stateOf(agent) {
+    const choice = this.session;
+    const session = typeof choice === "function" ? resolveSession(() => choice(agent)) : choice;
+    if (!session) return null;
+    let state = this.states.get(session);
+    if (!state) {
+      state = { bridge: new Bridge(session, this.options.verify, this.options.agentMemory), seen: /* @__PURE__ */ new Set(), model: null };
+      this.states.set(session, state);
+    }
+    return state;
+  }
+  async prepare(agent, context) {
+    const state = this.stateOf(agent);
+    if (!state) return context;
+    try {
+      const known = MODELS[context.model.constructor.name];
+      const name = context.model.modelId ?? "";
+      state.model = name ? { provider: known?.provider ?? providerOf(name), name, cacheApart: known?.cacheApart ?? false } : null;
+      const messages = [...context.messages];
+      const last = lastUserText(messages);
+      if ((this.options.recordCustomer ?? true) && last >= 0) {
+        const text = textOf(messages[last]);
+        const key = `${String(last)}:${text}`;
+        if (!state.seen.has(key)) {
+          state.seen.add(key);
+          state.bridge.customer(text);
+        }
+      }
+      const read = await state.bridge.read();
+      state.bridge.injected(read.context);
+      let trailing = context.dynamicTrailingBlocks ?? 0;
+      const target = messages[last];
+      if (read.suffix && target) {
+        const separator = target.content.length > 0 ? "\n\n" : "";
+        messages[last] = new sdk.Message({
+          role: target.role,
+          content: [...target.content, new sdk.TextBlock(`${separator}${read.suffix}`)],
+          trackingId: target.trackingId,
+          ...target.metadata === void 0 ? {} : { metadata: target.metadata }
+        });
+        if (last === messages.length - 1) trailing += 1;
+      }
+      return {
+        ...context,
+        messages,
+        dynamicTrailingBlocks: trailing,
+        ...read.prefix ? { systemPrompt: withPrefix(context.systemPrompt, read.prefix) } : {}
+      };
+    } catch (error) {
+      state.bridge.logger.warn(`could not inject context (${errorName(error)})`);
+      return context;
+    }
+  }
+  record(agent, { result }) {
+    if (!(this.options.recordAgent ?? true)) return;
+    const state = this.stateOf(agent);
+    if (!state) return;
+    try {
+      if (result.stopReason === "toolUse" || result.message.content.some((block) => block.type === "toolUseBlock")) return;
+      const text = textOf(result.message);
+      if (!text) return;
+      const usage = state.model ? strandsUsage(result.metadata?.usage, state.model.provider, state.model.name, state.model.cacheApart) : null;
+      state.bridge.agent(text, usage ? { usage } : {});
+    } catch (error) {
+      state.bridge.logger.warn(`could not record the agent's answer (${errorName(error)})`);
+    }
+  }
+};
+function niadraTools(session, options = {}) {
+  return new Bridge(session, void 0, options.agentMemory).tools().map(
+    (spec) => sdk.tool({
+      name: spec.name,
+      description: spec.description,
+      inputSchema: spec.parameters,
+      callback: async (input) => parsed(await spec.execute(isRecord(input) ? input : {}))
+    })
+  );
+}
+function strandsUsage(usage, provider, model, cacheApart) {
+  if (!isRecord(usage)) return null;
+  const input = count(usage.inputTokens);
+  if (input === null || !model) return null;
+  const read = count(usage.cacheReadInputTokens) ?? 0;
+  const written = count(usage.cacheWriteInputTokens) ?? 0;
+  const prompt = cacheApart ? input + read + written : Math.max(input, read + written);
+  return { provider, model, prompt_tokens: prompt, cached_tokens: read, cache_write_tokens: written };
+}
+function withPrefix(system, prefix) {
+  if (system === void 0 || system === "") return prefix;
+  if (typeof system === "string") return `${system}
+
+${prefix}`;
+  return [...system, new sdk.TextBlock(prefix)];
+}
+function lastUserText(messages) {
+  for (let index = messages.length - 1; index >= 0; index--) {
+    const message = messages[index];
+    if (message?.role !== "user") continue;
+    if (message.content.some((block) => block.type === "toolResultBlock")) return -1;
+    return textOf(message) ? index : -1;
+  }
+  return -1;
+}
+function textOf(message) {
+  if (!message) return "";
+  return message.content.map((block) => block.type === "textBlock" ? block.text : "").filter(Boolean).join("\n");
+}
+function parsed(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+exports.NiadraPlugin = NiadraPlugin;
+exports.attestationProof = attestationProof;
+exports.niadraTools = niadraTools;
+exports.strandsUsage = strandsUsage;
+//# sourceMappingURL=strands.cjs.map
+//# sourceMappingURL=strands.cjs.map

package/dist/strands.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/usage.ts","../src/context.ts","../src/integrations/shared.ts","../src/integrations/strands.ts"],"names":["InvokeModelStage","Message","TextBlock","tool"],"mappings":"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","file":"strands.cjs","sourcesContent":["/**\n * Reads what a model provider reported for one call: every input token, the ones read from the\n * provider's prompt cache and the ones written to it.\n *\n * Two shapes are understood, from the response or its `usage` (plain objects or class instances):\n *\n * - OpenAI chat completions and compatible gateways: `usage.prompt_tokens` (cached tokens included)\n *   and `usage.prompt_tokens_details.cached_tokens`; the Responses API's `input_tokens` with\n *   `input_tokens_details.cached_tokens` too. Gateways that pass Anthropic's cache fields through\n *   (`cache_read_input_tokens`, `cache_creation_input_tokens`) are read as well.\n * - Anthropic messages: `usage.input_tokens` counts only the uncached rest, so the prompt is\n *   `input_tokens + cache_read_input_tokens + cache_creation_input_tokens`.\n *\n * Nothing here throws: a response without usage gives `null`.\n */\n\nimport type { ModelUsage } from \"./types/events.js\";\n\ntype Bag = Record<PropertyKey, unknown>;\n\nconst PROVIDER = /^[a-z0-9][a-z0-9_.-]{0,63}$/;\nconst MODEL = /^[A-Za-z0-9][A-Za-z0-9_.:/@-]{0,127}$/;\n\nfunction get(value: unknown, name: string): unknown {\n  return (typeof value === \"object\" || typeof value === \"function\") && value !== null\n    ? (value as Bag)[name]\n    : undefined;\n}\n\nfunction count(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isInteger(value) && value >= 0 ? value : null;\n}\n\n/** `prompt_tokens`, `cached_tokens` and `cache_write_tokens` from a provider's usage, or `null`. */\nexport function tokenCounts(\n  usage: unknown,\n): Pick<ModelUsage, \"prompt_tokens\" | \"cached_tokens\" | \"cache_write_tokens\"> | null {\n  const read = count(get(usage, \"cache_read_input_tokens\")) ?? 0;\n  const written = count(get(usage, \"cache_creation_input_tokens\")) ?? 0;\n  let prompt = count(get(usage, \"prompt_tokens\"));\n  let cached: number;\n  if (prompt !== null) {\n    const reported = count(get(get(usage, \"prompt_tokens_details\"), \"cached_tokens\"));\n    cached = reported !== null && reported > 0 ? reported : read;\n  } else {\n    const inputs = count(get(usage, \"input_tokens\"));\n    if (inputs === null) return null;\n    const details = get(usage, \"input_tokens_details\");\n    if (details !== undefined && details !== null) {\n      // The Responses API counts cached tokens inside `input_tokens`, as chat completions do.\n      prompt = inputs;\n      cached = count(get(details, \"cached_tokens\")) ?? 0;\n    } else {\n      prompt = inputs + read + written;\n      cached = read;\n    }\n  }\n  // A gateway can report a cache that does not fit its own prompt count; the prompt is at least that.\n  return { prompt_tokens: Math.max(prompt, cached + written), cached_tokens: cached, cache_write_tokens: written };\n}\n\n/**\n * Who served the call: the router prefix of `vendor/model` names, else what the name or the usage\n * shape says, else `openai` (the client `wrap()` takes).\n */\nexport function providerOf(model: string, usage?: unknown): string {\n  const slash = model.indexOf(\"/\");\n  if (slash > 0) return model.slice(0, slash).trim().toLowerCase();\n  const name = model.trim().toLowerCase();\n  if (name.startsWith(\"claude\") || `.${name}`.includes(\".anthropic.\")) return \"anthropic\";\n  if (name.startsWith(\"gemini\")) return \"google\";\n  if (get(usage, \"prompt_tokens\") === undefined && get(usage, \"cache_read_input_tokens\") !== undefined) {\n    return \"anthropic\";\n  }\n  return \"openai\";\n}\n\n/**\n * The usage of an OpenAI or Anthropic response (or of its bare `usage`, with `options.model`), for\n * the agent's turn: `convo.agent(text, { usage: modelUsage(response) })`. `null` without usage.\n */\nexport function modelUsage(\n  response: unknown,\n  options: { provider?: string; model?: string } = {},\n): ModelUsage | null {\n  try {\n    let usage = get(response, \"usage\");\n    if (usage === undefined || usage === null || typeof usage !== \"object\") usage = response;\n    const counts = tokenCounts(usage);\n    const name = options.model ?? get(response, \"model\");\n    if (!counts || typeof name !== \"string\" || !MODEL.test(name)) return null;\n    const provider = (options.provider ?? providerOf(name, usage)).toLowerCase();\n    if (!PROVIDER.test(provider)) return null;\n    return { provider, model: name, ...counts };\n  } catch {\n    return null;\n  }\n}\n\n/** A `ModelUsage` as given, or read from a provider's response; `null` when neither works. */\nexport function asModelUsage(value: unknown): ModelUsage | null {\n  if (value === undefined || value === null) return null;\n  if (isModelUsage(value)) return value;\n  return modelUsage(value);\n}\n\n/** A `ModelUsage` the server accepts as it is; anything else is read like a provider's usage. */\nfunction isModelUsage(value: unknown): value is ModelUsage {\n  const provider = get(value, \"provider\");\n  const model = get(value, \"model\");\n  const prompt = count(get(value, \"prompt_tokens\"));\n  const cached = get(value, \"cached_tokens\") === undefined ? 0 : count(get(value, \"cached_tokens\"));\n  const written = get(value, \"cache_write_tokens\") === undefined ? 0 : count(get(value, \"cache_write_tokens\"));\n  return (\n    typeof provider === \"string\" &&\n    PROVIDER.test(provider) &&\n    typeof model === \"string\" &&\n    MODEL.test(model) &&\n    prompt !== null &&\n    cached !== null &&\n    written !== null &&\n    cached + written <= prompt\n  );\n}\n","import { NiadraValidationError } from \"./errors.js\";\nimport { includeText } from \"./constraints/text.js\";\nimport type { NiadraError } from \"./errors.js\";\nimport { toObjectRef } from \"./handles.js\";\nimport type { Handle, ObjectRef } from \"./types/common.js\";\nimport type {\n  ContextFormat,\n  ContextPack,\n  ContextRequest,\n  ContextResponse,\n  CoordinationBlock,\n  Include,\n  LiveTurn,\n  PrefetchRequest,\n  TargetModel,\n} from \"./types/context.js\";\nimport type { ConstraintsBlock } from \"./types/signals.js\";\nimport type { StateView } from \"./types/state.js\";\nimport type { Verification, View } from \"./types/vocabulary.js\";\n\n/** Arguments of `context()`. Pass exactly one of `subject` or `object`. */\nexport interface ContextParams {\n  /** The customer, by any handle the server knows. */\n  subject?: Handle;\n  /** A business object, such as an invoice, when the task is about the object rather than a person. */\n  object?: ObjectRef | string;\n  /** The account or partner the person acts for. Requires an active link between the two. */\n  about?: Handle;\n  /** Defaults to `chat`. */\n  view?: View;\n  /**\n   * The level proven in this conversation. The server may answer with a lower effective level\n   * when the source's ceiling is lower; see `response.verification`.\n   */\n  verification?: Verification;\n  /** Enables the per-conversation cache and the server's pinning of the pack. */\n  conversation_id?: string;\n  /** For internal agents: the task plays the role of the conversation. */\n  task_id?: string;\n  /**\n   * Other words than the turn to pick this read's slots by. Up to 2,000 characters. Wins over\n   * `turn`, and like it never changes the pack.\n   */\n  query?: string;\n  /**\n   * The customer's last turn; a conversation passes it for you. It goes as `query` and the answer\n   * adds `slots`, what the turn selected from memory, in `suffix`, while the pack stays the\n   * conversation's pinned one (and is cached as without it).\n   */\n  turn?: string | null;\n  /** Ask only for what changed since this source last read the subject. */\n  delta?: boolean;\n  /** The model that will read the pack, so the server can size it for that model's prompt cache. */\n  target?: TargetModel;\n  /** `json` also returns the pack as typed sections in `pack` (`context-pack.v1`). Defaults to `text`. */\n  format?: ContextFormat;\n  /**\n   * Adds `why` to each of `pack.slots`, naming the retrieval channels that\n   * ranked it, the fused score, the weights version and, for a derived line, the rule behind it.\n   * Requires `format: \"json\"`. It changes nothing else: the pinned text, the slots chosen and the\n   * receipt are the same bytes with or without it.\n   */\n  explain?: boolean;\n  /**\n   * Blocks read in the same round trip: `[\"constraints\"]` returns the subject's constraints block, `[\"state\"]`\n   * the state of their objects. Each only where the space turned its feature on; a block the space does not\n   * serve is left out and not asked again for a while, and the read goes on. The blocks are cached with the\n   * pack, so a read that fails serves the last good ones too.\n   */\n  include?: Include[];\n}\n\n/** Arguments of `prefetch()`: who the turn is about, as in `context()`, and the turn so far. */\nexport interface PrefetchParams {\n  subject?: Handle;\n  object?: ObjectRef | string;\n  about?: Handle;\n  /** Defaults to `voice`, where partial transcripts come from. */\n  view?: View;\n  verification?: Verification;\n  conversation_id?: string;\n  task_id?: string;\n  /** The partial transcript of the customer's turn. */\n  text: string;\n}\n\n/** Per-call options shared by every read method. */\nexport interface RequestOptions {\n  /** Overrides the method's default time budget, in milliseconds. */\n  timeout?: number | undefined;\n  /** Cancels the wait. A request shared with other callers keeps running for them. */\n  signal?: AbortSignal | undefined;\n  /** Extra headers, such as a W3C `traceparent`. */\n  headers?: Record<string, string> | undefined;\n}\n\nexport interface ContextOptions extends RequestOptions {\n  /** Pass `false` to skip the per-conversation cache for this call. */\n  cache?: boolean | undefined;\n  /** For `conversation.context()` and `task.context()`: blocks read in the same round trip. */\n  include?: Include[] | undefined;\n  /** For `conversation.context()` and `task.context()`: `json` also returns `pack`. */\n  format?: ContextFormat | undefined;\n  /**\n   * For `conversation.context()` and `task.context()`: adds `why` to each of `pack.slots`.\n   * Requires `format: \"json\"`.\n   */\n  explain?: boolean | undefined;\n}\n\n/**\n * Where a `context()` result came from.\n *\n * - `network`: a response the server just sent (or confirmed unchanged).\n * - `cache`: a pack younger than the cache TTL; no request was made.\n * - `stale`: an older pack returned at once while a background request refreshes it.\n * - `fallback`: the request failed and this is the last good pack for the conversation.\n * - `none`: nothing was available; `text` is empty and `error` says why.\n */\nexport type ContextSource = \"network\" | \"cache\" | \"stale\" | \"fallback\" | \"none\";\n\n/** What `context()` resolves to. Always usable: on failure `text` is an empty string. */\nexport interface ContextResult {\n  /** The pack, ready for the system prompt. Empty when there is nothing to inject. */\n  text: string;\n  /**\n   * The parts that change turn by turn and belong at the end of the prompt, after the\n   * conversation: the live turns from other channels, this turn's slots (what the customer's last\n   * turn selected from memory), the blocks asked for by `include` (the state view, the constraints) and the\n   * delta, in that order, as the API places them. Empty when there are none.\n   */\n  suffix: string;\n  /** Named values from the pack, for templates that place them individually. */\n  variables: Record<string, string>;\n  /** The pack as typed sections, when read with `format: \"json\"`; otherwise `null`. */\n  pack: ContextPack | null;\n  source: ContextSource;\n  /** The response this result was built from; `null` when `source` is `none`. */\n  response: ContextResponse | null;\n  /** What went wrong, when `source` is `fallback` or `none`. */\n  error: NiadraError | null;\n  /** With `include: [\"constraints\"]`: the subject's constraints block. */\n  constraints?: ConstraintsBlock | null;\n  /** With `include: [\"state\"]`: the state of the subject's objects. */\n  state?: StateView | null;\n  /** With `include: [\"coordination\"]`: what coordination knows of the subject. */\n  coordination?: CoordinationBlock | null;\n}\n\nconst VIEW = /^(voice|chat|brief|full|custom|account|partner|task:[a-z0-9_]{1,40})$/;\nconst MAX_QUERY = 2000;\n\n/** Validates the arguments and builds the wire request, without `known_etag`. */\nexport function buildContextRequest(params: ContextParams): ContextRequest {\n  if ((params.subject === undefined) === (params.object === undefined)) {\n    throw new NiadraValidationError(\"pass exactly one of `subject` or `object`\");\n  }\n  if (params.conversation_id && params.task_id) {\n    throw new NiadraValidationError(\"pass `conversation_id` or `task_id`, not both\");\n  }\n  if (params.view !== undefined && !VIEW.test(params.view)) {\n    throw new NiadraValidationError(\"unknown view; task views look like `task:billing`\");\n  }\n  if (params.query !== undefined && params.query.length > MAX_QUERY) {\n    throw new NiadraValidationError(`query is longer than ${MAX_QUERY} characters`);\n  }\n\n  const request: ContextRequest = { view: params.view ?? \"chat\" };\n  if (params.subject) request.subject = params.subject;\n  if (params.object !== undefined) request.object = toObjectRef(params.object);\n  if (params.about) request.about = params.about;\n  if (params.verification) request.verification = params.verification;\n  if (params.conversation_id) request.conversation_id = params.conversation_id;\n  if (params.task_id) request.task_id = params.task_id;\n  if (params.query) request.query = params.query;\n  if (params.delta) request.delta = true;\n  if (params.target) request.target = params.target;\n  const format: string = params.format ?? \"text\";\n  if (format !== \"text\" && format !== \"json\") throw new NiadraValidationError(\"format is `text` or `json`\");\n  if (format === \"json\") request.format = \"json\";\n  if (params.explain) {\n    if (format !== \"json\") throw new NiadraValidationError('explain requires format: \"json\"');\n    request.explain = true;\n  }\n  if (params.include?.length) request.include = [...new Set(params.include)];\n  return request;\n}\n\n/** Validates the arguments of `prefetch()` and builds the wire request. */\nexport function buildPrefetchRequest(params: PrefetchParams): PrefetchRequest {\n  if ((params.subject === undefined) === (params.object === undefined)) {\n    throw new NiadraValidationError(\"pass exactly one of `subject` or `object`\");\n  }\n  if (params.conversation_id && params.task_id) {\n    throw new NiadraValidationError(\"pass `conversation_id` or `task_id`, not both\");\n  }\n  if (params.view !== undefined && !VIEW.test(params.view)) {\n    throw new NiadraValidationError(\"unknown view; task views look like `task:billing`\");\n  }\n  const text = params.text.trim();\n  if (!text || text.length > MAX_QUERY) throw new NiadraValidationError(`text must be 1 to ${MAX_QUERY} characters`);\n  const request: PrefetchRequest = { view: params.view ?? \"voice\", query: text };\n  if (params.subject) request.subject = params.subject;\n  if (params.object !== undefined) request.object = toObjectRef(params.object);\n  if (params.about) request.about = params.about;\n  if (params.verification) request.verification = params.verification;\n  if (params.conversation_id) request.conversation_id = params.conversation_id;\n  if (params.task_id) request.task_id = params.task_id;\n  return request;\n}\n\n/** Packs are only cached inside a conversation or task, the unit the server pins them to. */\nexport function cacheScope(request: Pick<ContextRequest, \"conversation_id\" | \"task_id\">): string | null {\n  if (request.conversation_id) return `conversation:${request.conversation_id}`;\n  if (request.task_id) return `task:${request.task_id}`;\n  return null;\n}\n\n/**\n * Every field that changes what the server would compile goes into the key, in a fixed order.\n * `delta` does not: a plain read and a delta read of one conversation get the same pinned\n * bytes, so they share one entry.\n */\nexport function cacheKey(request: ContextRequest): string {\n  return JSON.stringify([\n    request.subject ?? null,\n    request.object ?? null,\n    request.about ?? null,\n    request.view ?? \"chat\",\n    request.verification ?? \"V0\",\n    request.conversation_id ?? null,\n    request.task_id ?? null,\n    request.query ?? null,\n    request.target ?? null,\n    request.format ?? \"text\",\n    request.explain ?? false,\n    request.include ?? null,\n  ]);\n}\n\n/**\n * Applies a `not_modified` answer to the cached pack: the pinned text and its metadata stay,\n * while the parts outside the pin (live turns, delta, coverage, timing) come from the new answer.\n */\nexport function mergeNotModified(cached: ContextResponse, fresh: ContextResponse): ContextResponse {\n  return {\n    ...fresh,\n    not_modified: false,\n    text: cached.text ?? null,\n    variables: cached.variables,\n    version: cached.version,\n    etag: cached.etag,\n    manifest_hash: cached.manifest_hash ?? null,\n    withheld: cached.withheld,\n    cache: cached.cache ?? null,\n    pack: cached.pack ?? null,\n    // The blocks sit outside the pinned pack: a fresh block wins, and a missing one keeps the cached.\n    constraints: fresh.constraints ?? cached.constraints ?? null,\n    state: fresh.state ?? cached.state ?? null,\n    coordination: fresh.coordination ?? cached.coordination ?? null,\n  };\n}\n\nexport function resultFrom(\n  response: ContextResponse,\n  source: ContextSource,\n  error: NiadraError | null = null,\n): ContextResult {\n  // A conversation in the control group gets an empty pack on purpose; it is not an error.\n  const holdout = response.path === \"holdout\";\n  const text = holdout ? \"\" : (response.text ?? \"\");\n  const pack = holdout ? null : (response.pack ?? null);\n  const blocks = {\n    constraints: response.constraints ?? null,\n    state: response.state ?? null,\n    coordination: response.coordination ?? null,\n  };\n  return { text, suffix: renderSuffix(response), variables: response.variables, pack, source, response, error, ...blocks };\n}\n\nexport function emptyResult(error: NiadraError | null): ContextResult {\n  return { text: \"\", suffix: \"\", variables: {}, pack: null, source: \"none\", response: null, error, constraints: null, state: null, coordination: null };\n}\n\n/**\n * Renders the live turns, the slots and the delta for the end of the prompt, in that order. Kept\n * outside the pinned pack so that the prompt prefix stays byte-identical across turns and the\n * model provider's prompt cache keeps hitting. Returns an empty string when there is nothing to add.\n */\nexport function renderSuffix(response: ContextResponse): string {\n  if (response.path === \"holdout\") return \"\";\n  const included = includeText(response.text, response.state, response.constraints);\n  return [renderLive(response), response.slots ?? \"\", included, response.delta ?? \"\"].filter(Boolean).join(\"\\n\\n\");\n}\n\n/**\n * Renders the live turns (recent turns from other channels that the pack has not absorbed\n * yet) as one tagged block, or an empty string when there are none. `complete=\"false\"` tells\n * the model the list may be missing turns because the server could not read all of them.\n */\nexport function renderLive(response: ContextResponse): string {\n  if (response.path === \"holdout\" || response.live.length === 0) return \"\";\n  const complete = response.live_complete ? \"\" : ' complete=\"false\"';\n  const lines = response.live.map(renderLiveTurn).join(\"\\n\");\n  return `<live_turns source=\"niadra\"${complete}>\\n${lines}\\n</live_turns>`;\n}\n\nfunction renderLiveTurn(turn: LiveTurn): string {\n  return `[${utcSeconds(turn.at)}] ${turn.channel} · ${turn.speaker}: ${turn.text}`;\n}\n\n/** The same timestamp form in every SDK, whatever precision or offset the server sent. */\nfunction utcSeconds(at: string): string {\n  const ms = Date.parse(at);\n  return Number.isNaN(ms) ? at : `${new Date(ms).toISOString().slice(0, 19)}Z`;\n}\n","/**\n * What every framework adapter shares: the five primitives (context before the model call, the\n * turns, the tools, the verification and the handoff) wired the same way, and fail-open.\n *\n * Nothing here throws into the framework: a failed read gives an empty context, a failed write\n * is logged without content, and the agent keeps working without memory.\n */\n\nimport { recordedTool } from \"../capture/tool.js\";\nimport type { Played } from \"../replay/playback.js\";\nimport type { AgentMemoryParams } from \"../agent-memory.js\";\nimport type { TurnParams } from \"../agent-session.js\";\nimport type { CallCapture, TurnFrame } from \"../capture/frame.js\";\nimport type { ContextOptions, ContextResult } from \"../context.js\";\nimport { emptyResult } from \"../context.js\";\nimport type { Conversation, TurnOptions } from \"../conversation.js\";\nimport type { Logger } from \"../logger.js\";\nimport type { Task } from \"../task.js\";\nimport type { BoundTools } from \"../tools.js\";\nimport type { Handle } from \"../types/common.js\";\nimport type { Verification, VerifyMethod } from \"../types/vocabulary.js\";\n\n/** A customer conversation or an internal agent's task. */\nexport type Session = Conversation | Task;\n\n/** A session, or a function that finds the one the current call belongs to (`null` passes the call through). */\nexport type SessionResolver<S extends Session = Session> = S | (() => S | null | undefined);\n\n/** What the framework proved about the person, recorded with `verify()` before the first context read. */\nexport interface Proof {\n  method: VerifyMethod;\n  level: Verification;\n  /** Defaults to the session's subject. */\n  handle?: Handle;\n}\n\n/** A proof, or a function that reads it from the framework when the first context is needed. */\nexport type ProofSource =\n  | Proof\n  | null\n  | undefined\n  | (() => Proof | null | undefined | PromiseLike<Proof | null | undefined>);\n\n/**\n * The agent's own working notes: `true` puts the block before the customer's context and offers\n * `search_agent_memory`; `{ write: true }` also offers `remember` (for a key with the\n * `agent_memory:write` scope); the other fields go to `agentMemory()`.\n */\nexport type AgentMemoryOption = boolean | (AgentMemoryParams & { write?: boolean });\n\n/** What goes into the prompt for one model call. */\nexport interface Read {\n  context: ContextResult;\n  /** The agent's own notes, or an empty string. */\n  memory: string;\n  /** What goes after the instructions: the notes, then the customer's pack. */\n  prefix: string;\n  /** What goes at the end: live turns, the turn's slots and deltas. */\n  suffix: string;\n}\n\n/** A tool as every framework needs it: the name, the text for the model, the JSON Schema and the call. */\ninterface ToolSpec {\n  name: string;\n  description: string;\n  /** JSON Schema of the arguments. None of them names the customer. */\n  parameters: Record<string, unknown>;\n  /** Runs the call and returns the text for the model. Never rejects in fail-open mode. */\n  execute(args: string | Record<string, unknown>): Promise<string>;\n}\n\nconst ATTESTED: Record<string, Verification> = { A: \"V2\", B: \"V1\", C: \"V1\" };\n\n/**\n * The proof a carrier's STIR/SHAKEN attestation gives a phone call: `A` proves V2, `B` and `C`\n * prove V1, anything else proves nothing (`null`). Accepts the bare letter or the forms carriers\n * and platforms send, such as Twilio's `TN-Validation-Passed-A`.\n */\nexport function attestationProof(attestation: string | null | undefined): Proof | null {\n  if (!attestation) return null;\n  const value = attestation.trim().toUpperCase();\n  if (value.includes(\"FAILED\") || value.startsWith(\"NO-\")) return null;\n  const letter = value.length === 1 ? value : /PASSED-([ABC])$/.exec(value)?.[1];\n  const level = letter ? ATTESTED[letter] : undefined;\n  return level ? { method: \"network_attestation\", level } : null;\n}\n\nexport function resolveSession<S extends Session>(source: SessionResolver<S>): S | null {\n  if (typeof source !== \"function\") return source;\n  try {\n    return source() ?? null;\n  } catch {\n    return null;\n  }\n}\n\nfunction isConversation(session: Session): session is Conversation {\n  return \"customer\" in session && typeof session.customer === \"function\";\n}\n\n/** A phone number as an E.164 handle, or `null` when it does not look like one. */\nexport function phoneHandle(value: string | null | undefined): Handle | null {\n  const raw = value?.trim().replace(/^tel:/i, \"\").replace(/[\\s().-]/g, \"\");\n  if (!raw) return null;\n  const e164 = raw.startsWith(\"+\") ? raw : `+${raw}`;\n  return /^\\+[1-9]\\d{6,14}$/.test(e164) ? { type: \"phone_e164\", value: e164 } : null;\n}\n\nexport function errorName(error: unknown): string {\n  return error instanceof Error ? error.name : typeof error;\n}\n\n/**\n * One session as an adapter drives it. Keeps the verification to a single call made before the\n * first context read, and turns every failure into a log line.\n */\nexport class Bridge {\n  private proving: Promise<void> | null = null;\n  /** `begin()` started the first read of a call: the first `context()` waits for it with `ready()`. */\n  private begun = false;\n  private opened = false;\n\n  constructor(\n    readonly session: Session,\n    private readonly proof?: ProofSource,\n    private readonly memory: AgentMemoryOption = false,\n  ) {}\n\n  /**\n   * The context and, when enabled, the agent's notes, read side by side within the same budget.\n   * Never rejects.\n   */\n  async read(options: ContextOptions = {}): Promise<Read> {\n    const memoryParams = this.memory === false ? null : this.memory === true ? {} : withoutWrite(this.memory);\n    const [context, memory] = await Promise.all([\n      this.context(options),\n      memoryParams ? this.agentMemory(memoryParams, options) : Promise.resolve(\"\"),\n    ]);\n    return { context, memory, prefix: [memory, context.text].filter(Boolean).join(\"\\n\\n\"), suffix: context.suffix };\n  }\n\n  get logger(): Logger {\n    return this.session.logger;\n  }\n\n  /**\n   * Starts the first read of a call now, in the background, after the proof when one was given (the\n   * pack depends on the level it proves): at call start, so the read runs while the call is set up.\n   * The first `context()` then waits for it within `timeouts.contextVoiceStart`. Never throws.\n   */\n  begin(): void {\n    const session = this.session;\n    if (!isConversation(session)) return;\n    const start = (): void => {\n      this.safe(\"start the first read\", () => {\n        // False off the voice read path (a chat view, the cache off): reads go on as before.\n        this.begun = session.begin();\n      });\n    };\n    if (this.proof === undefined || this.proof === null) start();\n    else void this.verifyOnce().then(start);\n  }\n\n  /** Verifies once (when a proof was given), then reads the context. Never rejects. */\n  async context(options: ContextOptions = {}): Promise<ContextResult> {\n    await this.verifyOnce();\n    try {\n      const session = this.session;\n      if (this.begun && !this.opened && isConversation(session)) {\n        this.opened = true;\n        // The call's first read, begun at call start: waited for within its own, longer budget.\n        await session.ready(options.timeout === undefined ? {} : { timeout: options.timeout });\n      }\n      return await this.session.context(options);\n    } catch (error) {\n      this.logger.warn(`could not read context (${errorName(error)})`);\n      return emptyResult(null);\n    }\n  }\n\n  /** Records that `context` went into the prompt, unless it was empty for a reason other than the holdout. */\n  injected(context: ContextResult): void {\n    if (!context.text && !context.suffix && context.response?.path !== \"holdout\") return;\n    this.safe(\"mark the injection\", () => {\n      this.session.markInjected(context);\n    });\n  }\n\n  customer(text: string, options: TurnOptions = {}): void {\n    const session = this.session;\n    if (!text.trim() || !isConversation(session)) return;\n    this.safe(\"record the customer's turn\", () => session.customer(text, options));\n  }\n\n  /** Sends the customer's turn so far, while they speak. In the background; never throws. */\n  prefetch(text: string): void {\n    const session = this.session;\n    if (!text.trim() || !isConversation(session)) return;\n    this.safe(\"prefetch the turn\", () => session.prefetch(text));\n  }\n\n  agent(text: string, options: TurnOptions = {}): void {\n    if (!text.trim()) return;\n    this.safe(\"record the agent's turn\", () => this.session.agent(text, options));\n  }\n\n  /** Records a transfer. Tasks have no transfer; the call is ignored for them. */\n  async handoff(target: \"agent\" | \"human\", reason?: string): Promise<void> {\n    const session = this.session;\n    if (!isConversation(session)) return;\n    try {\n      await session.handoff(reason ? { target, reason } : { target });\n    } catch (error) {\n      this.logger.warn(`could not record the handoff (${errorName(error)})`);\n    }\n  }\n\n  async end(): Promise<void> {\n    try {\n      await this.session.end();\n    } catch (error) {\n      this.logger.warn(`could not end the session (${errorName(error)})`);\n    }\n  }\n\n  /** The navigation kit as plain specs (with the agent's memory tools when enabled), or none for a task about an object only. */\n  tools(): ToolSpec[] {\n    let bound: BoundTools | null;\n    try {\n      const memory = this.memory;\n      bound = this.session.tools(memory === false ? {} : { agentMemory: true, writeAgentMemory: memory !== true && memory.write === true });\n    } catch (error) {\n      this.logger.warn(`could not build the tools (${errorName(error)})`);\n      return [];\n    }\n    return bound ? toolSpecs(bound) : [];\n  }\n\n  private async agentMemory(params: AgentMemoryParams, options: ContextOptions): Promise<string> {\n    try {\n      const result = await this.session.agentMemory(params, options.timeout === undefined ? {} : { timeout: options.timeout });\n      return result.text;\n    } catch (error) {\n      this.logger.warn(`could not read the agent's memory (${errorName(error)})`);\n      return \"\";\n    }\n  }\n\n  private async verifyOnce(): Promise<void> {\n    if (this.proof === undefined || this.proof === null) return;\n    this.proving ??= this.runVerify();\n    await this.proving;\n  }\n\n  private async runVerify(): Promise<void> {\n    try {\n      const source = this.proof;\n      const proof = typeof source === \"function\" ? await source() : source;\n      if (!proof) return;\n      await this.session.verify(proof);\n    } catch (error) {\n      this.logger.warn(`could not record the verification (${errorName(error)})`);\n    }\n  }\n\n  private safe(what: string, run: () => unknown): void {\n    try {\n      run();\n    } catch (error) {\n      this.logger.warn(`could not ${what} (${errorName(error)})`);\n    }\n  }\n}\n\nfunction withoutWrite(option: AgentMemoryParams & { write?: boolean }): AgentMemoryParams {\n  const { write: _, ...params } = option;\n  return params;\n}\n\n/** The bound kit as specs. The customer stays inside `bound`; no parameter names them. */\nfunction toolSpecs(bound: BoundTools): ToolSpec[] {\n  return bound.definitions.map(({ function: definition }) => ({\n    name: definition.name,\n    description: definition.description,\n    parameters: definition.parameters,\n    execute: (args) => bound.call(definition.name, args),\n  }));\n}\n\n/** The text of a message content in the shapes model APIs use: a string, or a list of text parts. */\nexport function textOf(content: unknown): string {\n  if (typeof content === \"string\") return content;\n  if (!Array.isArray(content)) return \"\";\n  const parts: string[] = [];\n  for (const part of content as unknown[]) {\n    if (typeof part === \"string\") parts.push(part);\n    else if (isRecord(part) && typeof part.text === \"string\" && (part.type === undefined || part.type === \"text\")) {\n      parts.push(part.text);\n    }\n  }\n  return parts.join(\"\");\n}\n\nexport function isRecord(value: unknown): value is Record<PropertyKey, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\n/** A non-negative integer, or `null`. */\nexport function count(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isInteger(value) && value >= 0 ? value : null;\n}\n\n/**\n * The turn records an adapter keeps from its framework's callbacks, keyed by the framework's own ids (a\n * run, a request, a tool call id). A run starting while the session has a turn in progress (yours, from\n * `conversation.turn()`, or a replay's) records into it; otherwise the adapter opens its own turn and closes\n * it when the run ends. A tool call recorded here is taken over by a `tool()` wrapper running inside it, so\n * the call is recorded once. Every method does nothing when turns are off and never throws.\n */\nexport class TurnHooks {\n  /** Runs held open at most; past it the oldest run's turn closes, incomplete (a run whose end never came). */\n  static readonly MAX_OPEN = 100;\n  private readonly frames = new Map<string, { frame: TurnFrame; own: boolean }>();\n  private readonly calls = new Map<string, CallCapture>();\n\n  constructor(\n    readonly adapter: string,\n    readonly enabled: boolean,\n  ) {}\n\n  /** The turn of the run `key`: the session's turn in progress, or a new one of its own. */\n  open(session: Session, key: string, params: TurnParams = {}): TurnFrame | undefined {\n    if (!this.enabled) return undefined;\n    const held = this.frames.get(key);\n    if (held !== undefined) return held.frame;\n    try {\n      const active = session.activeTurn();\n      if (active !== undefined && !this.owns(active)) {\n        this.frames.set(key, { frame: active, own: false });\n        return active;\n      }\n      const frame = session.openTurn({ ...params, adapter: this.adapter });\n      this.frames.set(key, { frame, own: true });\n      if (this.frames.size > TurnHooks.MAX_OPEN) {\n        const [oldest] = this.frames.keys();\n        if (oldest !== undefined) {\n          this.frames.get(oldest)?.frame.incomplete();\n          this.close(oldest);\n        }\n      }\n      return frame;\n    } catch (error) {\n      session.logger.warn(`could not open the turn (${errorName(error)})`);\n      return undefined;\n    }\n  }\n\n  /** The turn of `key`, else the session's turn in progress. */\n  frame(session: Session, key?: string): TurnFrame | undefined {\n    if (!this.enabled) return undefined;\n    const held = key === undefined ? undefined : this.frames.get(key);\n    const frame = held?.frame ?? session.activeTurn();\n    return frame === undefined || frame.closed ? undefined : frame;\n  }\n\n  has(key: string): boolean {\n    return this.frames.has(key);\n  }\n\n  private owns(frame: TurnFrame): boolean {\n    for (const held of this.frames.values()) if (held.own && held.frame === frame) return true;\n    return false;\n  }\n\n  /** Ends the run `key`: a turn the adapter opened closes; the calls it left open failed. */\n  close(key: string, error?: unknown): void {\n    const held = this.frames.get(key);\n    if (held === undefined) return;\n    this.frames.delete(key);\n    for (const [callKey, call] of this.calls) {\n      if (call.frame !== held.frame) continue;\n      this.calls.delete(callKey);\n      if (held.own) call.failed(error ?? \"error\");\n    }\n    if (held.own) held.frame.close(error);\n  }\n\n  /** A tool call starting, keyed by `callKey`; `callId` is the provider's id of the call, when there is one. */\n  toolStart(session: Session, callKey: string, name: string, args: unknown, options: { frameKey?: string; callId?: string | null } = {}): void {\n    const frame = this.frame(session, options.frameKey);\n    if (frame === undefined) return;\n    try {\n      this.calls.set(callKey, frame.toolCall(name, args, { callId: options.callId ?? null, adoptable: true }));\n    } catch {\n      frame.incomplete();\n    }\n  }\n\n  /**\n   * In a replay, how a framework tool the adapter stands in for answers: the recorded result of a call with the\n   * same arguments, or empty (a divergence), never the live tool. `null` outside a replay, and for a function\n   * wrapped with `tool()`, which answers itself.\n   */\n  replayed(session: Session, name: string, args: unknown, fn?: unknown, frameKey?: string): Played | null {\n    const frame = this.enabled ? this.frame(session, frameKey) : session.activeTurn();\n    if (frame?.playback == null || (fn !== undefined && recordedTool(fn) !== null)) return null;\n    return frame.playback.answer(name, args, false);\n  }\n\n  toolEnd(callKey: string, result?: unknown, error?: unknown): void {\n    const call = this.calls.get(callKey);\n    if (call === undefined) return;\n    this.calls.delete(callKey);\n    try {\n      if (error !== undefined) call.failed(error);\n      else call.result(result);\n    } catch {\n      call.frame.incomplete();\n    }\n  }\n\n  /** A model call that ended, with its tokens when the framework reported them. */\n  model(\n    session: Session,\n    model: string | null | undefined,\n    tokens: { in?: number | null; out?: number | null; cached?: number | null } = {},\n    frameKey?: string,\n  ): void {\n    const frame = this.frame(session, frameKey);\n    if (frame === undefined) return;\n    try {\n      frame.modelCall(model, { tokensIn: tokens.in ?? null, tokensOut: tokens.out ?? null, tokensCached: tokens.cached ?? 0 });\n    } catch {\n      frame.incomplete();\n    }\n  }\n}\n","/**\n * Niadra for Strands Agents for TypeScript (`@strands-agents/sdk` 1.x, AWS): a plugin with the\n * customer's context before every model call and the navigation kit as tools.\n *\n * `new NiadraPlugin(session)` goes in `plugins` of the `Agent`:\n *\n * - an input middleware of `InvokeModelStage` records the customer's newest message once, adds the\n *   agent's notes and the customer's pack after your system prompt, and folds the suffix (deltas\n *   and live turns) into the last user message, the way Strands' own context injector does. It\n *   changes only what goes to the model: nothing of it lands in `agent.messages`.\n * - an output middleware records the final answer with the model's usage (prompt cache reads and\n *   writes included); tool-use turns record nothing.\n * - `getTools()` gives the kit as Strands tools bound to the customer, with the canonical schemas.\n *\n * Fail-open: when Niadra is slow or down, the model gets the messages as they came.\n *\n * @example\n * import { Agent, BedrockModel } from \"@strands-agents/sdk\";\n * import { NiadraPlugin } from \"@niadra/sdk/strands\";\n *\n * const convo = niadra.conversation({ subject: handles.appUserId(user.id), channel: \"web_chat\", conversation_id: chatId });\n * const support = new Agent({\n *   model: new BedrockModel({ modelId: \"us.anthropic.claude-sonnet-4-5-20250929-v1:0\" }),\n *   systemPrompt: \"You are Acme's support agent.\",\n *   plugins: [new NiadraPlugin(convo)],\n * });\n * const result = await support.invoke(\"Where is my replacement?\");\n */\n\nimport { InvokeModelStage, Message, TextBlock, tool } from \"@strands-agents/sdk\";\nimport type { InvokableTool, InvokeModelContext, InvokeModelResult, JSONValue, LocalAgent, Plugin, SystemPrompt } from \"@strands-agents/sdk\";\nimport type { ModelUsage } from \"../types/events.js\";\nimport { providerOf } from \"../usage.js\";\nimport { Bridge, count, errorName, isRecord, resolveSession } from \"./shared.js\";\nimport type { AgentMemoryOption, ProofSource, Session } from \"./shared.js\";\n\nexport { attestationProof } from \"./shared.js\";\nexport type { AgentMemoryOption, Proof, ProofSource, Session } from \"./shared.js\";\n\nexport interface NiadraPluginOptions {\n  /** What your app proved about the user, recorded once before the first context read. */\n  verify?: ProofSource;\n  /** Records the newest user message as the customer's turn. Defaults to `true`. */\n  recordCustomer?: boolean;\n  /** Records the final answer as the agent's turn. Defaults to `true`. */\n  recordAgent?: boolean;\n  /** Puts the agent's own notes before the customer's context, and adds its memory tools. */\n  agentMemory?: AgentMemoryOption;\n}\n\n/** Strands' model classes, the provider each serves, and whether its `inputTokens` leaves the cached tokens out. */\nconst MODELS: Record<string, { provider: string; cacheApart: boolean }> = {\n  BedrockModel: { provider: \"bedrock\", cacheApart: true },\n  AnthropicModel: { provider: \"anthropic\", cacheApart: true },\n  OpenAIModel: { provider: \"openai\", cacheApart: false },\n  GoogleModel: { provider: \"google\", cacheApart: false },\n};\n\ninterface State {\n  bridge: Bridge;\n  seen: Set<string>;\n  model: { provider: string; name: string; cacheApart: boolean } | null;\n}\n\n/**\n * The Niadra plugin for one agent. Takes the conversation or task (Strands agents usually live for\n * one conversation), or a function of the agent that finds it per model call.\n */\nexport class NiadraPlugin implements Plugin {\n  readonly name = \"niadra\";\n  private readonly states = new WeakMap<Session, State>();\n\n  constructor(\n    private readonly session: Session | ((agent: LocalAgent) => Session | null | undefined),\n    private readonly options: NiadraPluginOptions = {},\n  ) {}\n\n  initAgent(agent: LocalAgent): void {\n    agent.addMiddleware(InvokeModelStage.Input, (context: InvokeModelContext) => this.prepare(agent, context));\n    agent.addMiddleware(InvokeModelStage.Output, (result: InvokeModelResult) => {\n      this.record(agent, result);\n      return result;\n    });\n  }\n\n  /** The kit bound to a fixed session; none when the session is found per call. */\n  getTools(): InvokableTool<unknown, JSONValue>[] {\n    return typeof this.session === \"function\" ? [] : niadraTools(this.session, this.options.agentMemory === undefined ? {} : { agentMemory: this.options.agentMemory });\n  }\n\n  private stateOf(agent: LocalAgent): State | null {\n    const choice = this.session;\n    const session = typeof choice === \"function\" ? resolveSession(() => choice(agent)) : choice;\n    if (!session) return null;\n    let state = this.states.get(session);\n    if (!state) {\n      state = { bridge: new Bridge(session, this.options.verify, this.options.agentMemory), seen: new Set(), model: null };\n      this.states.set(session, state);\n    }\n    return state;\n  }\n\n  private async prepare(agent: LocalAgent, context: InvokeModelContext): Promise<InvokeModelContext> {\n    const state = this.stateOf(agent);\n    if (!state) return context;\n    try {\n      const known = MODELS[context.model.constructor.name];\n      const name = context.model.modelId ?? \"\";\n      state.model = name ? { provider: known?.provider ?? providerOf(name), name, cacheApart: known?.cacheApart ?? false } : null;\n      const messages = [...context.messages];\n      const last = lastUserText(messages);\n      if ((this.options.recordCustomer ?? true) && last >= 0) {\n        const text = textOf(messages[last]);\n        const key = `${String(last)}:${text}`;\n        if (!state.seen.has(key)) {\n          state.seen.add(key);\n          state.bridge.customer(text);\n        }\n      }\n      const read = await state.bridge.read();\n      state.bridge.injected(read.context);\n      let trailing = context.dynamicTrailingBlocks ?? 0;\n      const target = messages[last];\n      if (read.suffix && target) {\n        const separator = target.content.length > 0 ? \"\\n\\n\" : \"\";\n        messages[last] = new Message({\n          role: target.role,\n          content: [...target.content, new TextBlock(`${separator}${read.suffix}`)],\n          trackingId: target.trackingId,\n          ...(target.metadata === undefined ? {} : { metadata: target.metadata }),\n        });\n        // The pack's cache point stays before what changes on every call.\n        if (last === messages.length - 1) trailing += 1;\n      }\n      return {\n        ...context,\n        messages,\n        dynamicTrailingBlocks: trailing,\n        ...(read.prefix ? { systemPrompt: withPrefix(context.systemPrompt, read.prefix) } : {}),\n      };\n    } catch (error) {\n      state.bridge.logger.warn(`could not inject context (${errorName(error)})`);\n      return context;\n    }\n  }\n\n  private record(agent: LocalAgent, { result }: InvokeModelResult): void {\n    if (!(this.options.recordAgent ?? true)) return;\n    const state = this.stateOf(agent);\n    if (!state) return;\n    try {\n      if (result.stopReason === \"toolUse\" || result.message.content.some((block) => block.type === \"toolUseBlock\")) return;\n      const text = textOf(result.message);\n      if (!text) return;\n      const usage = state.model ? strandsUsage(result.metadata?.usage, state.model.provider, state.model.name, state.model.cacheApart) : null;\n      state.bridge.agent(text, usage ? { usage } : {});\n    } catch (error) {\n      state.bridge.logger.warn(`could not record the agent's answer (${errorName(error)})`);\n    }\n  }\n}\n\n/** The navigation kit as Strands tools, bound to the session's customer, with the canonical JSON Schemas. */\nexport function niadraTools(session: Session, options: { agentMemory?: AgentMemoryOption } = {}): InvokableTool<unknown, JSONValue>[] {\n  return new Bridge(session, undefined, options.agentMemory).tools().map((spec) =>\n    tool({\n      name: spec.name,\n      description: spec.description,\n      inputSchema: spec.parameters as never,\n      callback: async (input: unknown) => parsed(await spec.execute(isRecord(input) ? input : {})),\n    }),\n  );\n}\n\n/**\n * Strands' usage as a `ModelUsage`. Bedrock and Anthropic count the cached tokens apart from\n * `inputTokens`; the other providers count them inside it.\n */\nexport function strandsUsage(usage: unknown, provider: string, model: string, cacheApart: boolean): ModelUsage | null {\n  if (!isRecord(usage)) return null;\n  const input = count(usage.inputTokens);\n  if (input === null || !model) return null;\n  const read = count(usage.cacheReadInputTokens) ?? 0;\n  const written = count(usage.cacheWriteInputTokens) ?? 0;\n  const prompt = cacheApart ? input + read + written : Math.max(input, read + written);\n  return { provider, model, prompt_tokens: prompt, cached_tokens: read, cache_write_tokens: written };\n}\n\nfunction withPrefix(system: SystemPrompt | undefined, prefix: string): SystemPrompt {\n  if (system === undefined || system === \"\") return prefix;\n  if (typeof system === \"string\") return `${system}\\n\\n${prefix}`;\n  return [...system, new TextBlock(prefix)];\n}\n\n/** The last user message with text and no tool result, or -1. */\nfunction lastUserText(messages: readonly Message[]): number {\n  for (let index = messages.length - 1; index >= 0; index--) {\n    const message = messages[index];\n    if (message?.role !== \"user\") continue;\n    if (message.content.some((block) => block.type === \"toolResultBlock\")) return -1;\n    return textOf(message) ? index : -1;\n  }\n  return -1;\n}\n\nfunction textOf(message: Message | undefined): string {\n  if (!message) return \"\";\n  return message.content\n    .map((block) => (block.type === \"textBlock\" ? block.text : \"\"))\n    .filter(Boolean)\n    .join(\"\\n\");\n}\n\nfunction parsed(text: string): JSONValue {\n  try {\n    return JSON.parse(text) as JSONValue;\n  } catch {\n    return text;\n  }\n}\n"]}

package/dist/strands.d.cts

@@ -0,0 +1,72 @@
+import { Plugin, LocalAgent, InvokableTool, JSONValue } from '@strands-agents/sdk';
+import { g as ModelUsage } from './client-DsIxZxZk.cjs';
+import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared-DTPWVlWm.cjs';
+export { P as Proof, c as attestationProof } from './shared-DTPWVlWm.cjs';
+
+/**
+ * Niadra for Strands Agents for TypeScript (`@strands-agents/sdk` 1.x, AWS): a plugin with the
+ * customer's context before every model call and the navigation kit as tools.
+ *
+ * `new NiadraPlugin(session)` goes in `plugins` of the `Agent`:
+ *
+ * - an input middleware of `InvokeModelStage` records the customer's newest message once, adds the
+ *   agent's notes and the customer's pack after your system prompt, and folds the suffix (deltas
+ *   and live turns) into the last user message, the way Strands' own context injector does. It
+ *   changes only what goes to the model: nothing of it lands in `agent.messages`.
+ * - an output middleware records the final answer with the model's usage (prompt cache reads and
+ *   writes included); tool-use turns record nothing.
+ * - `getTools()` gives the kit as Strands tools bound to the customer, with the canonical schemas.
+ *
+ * Fail-open: when Niadra is slow or down, the model gets the messages as they came.
+ *
+ * @example
+ * import { Agent, BedrockModel } from "@strands-agents/sdk";
+ * import { NiadraPlugin } from "@niadra/sdk/strands";
+ *
+ * const convo = niadra.conversation({ subject: handles.appUserId(user.id), channel: "web_chat", conversation_id: chatId });
+ * const support = new Agent({
+ *   model: new BedrockModel({ modelId: "us.anthropic.claude-sonnet-4-5-20250929-v1:0" }),
+ *   systemPrompt: "You are Acme's support agent.",
+ *   plugins: [new NiadraPlugin(convo)],
+ * });
+ * const result = await support.invoke("Where is my replacement?");
+ */
+
+interface NiadraPluginOptions {
+    /** What your app proved about the user, recorded once before the first context read. */
+    verify?: ProofSource;
+    /** Records the newest user message as the customer's turn. Defaults to `true`. */
+    recordCustomer?: boolean;
+    /** Records the final answer as the agent's turn. Defaults to `true`. */
+    recordAgent?: boolean;
+    /** Puts the agent's own notes before the customer's context, and adds its memory tools. */
+    agentMemory?: AgentMemoryOption;
+}
+/**
+ * The Niadra plugin for one agent. Takes the conversation or task (Strands agents usually live for
+ * one conversation), or a function of the agent that finds it per model call.
+ */
+declare class NiadraPlugin implements Plugin {
+    private readonly session;
+    private readonly options;
+    readonly name = "niadra";
+    private readonly states;
+    constructor(session: Session | ((agent: LocalAgent) => Session | null | undefined), options?: NiadraPluginOptions);
+    initAgent(agent: LocalAgent): void;
+    /** The kit bound to a fixed session; none when the session is found per call. */
+    getTools(): InvokableTool<unknown, JSONValue>[];
+    private stateOf;
+    private prepare;
+    private record;
+}
+/** The navigation kit as Strands tools, bound to the session's customer, with the canonical JSON Schemas. */
+declare function niadraTools(session: Session, options?: {
+    agentMemory?: AgentMemoryOption;
+}): InvokableTool<unknown, JSONValue>[];
+/**
+ * Strands' usage as a `ModelUsage`. Bedrock and Anthropic count the cached tokens apart from
+ * `inputTokens`; the other providers count them inside it.
+ */
+declare function strandsUsage(usage: unknown, provider: string, model: string, cacheApart: boolean): ModelUsage | null;
+
+export { AgentMemoryOption, NiadraPlugin, type NiadraPluginOptions, ProofSource, Session, niadraTools, strandsUsage };

package/dist/strands.d.ts

@@ -0,0 +1,72 @@
+import { Plugin, LocalAgent, InvokableTool, JSONValue } from '@strands-agents/sdk';
+import { g as ModelUsage } from './client-DsIxZxZk.js';
+import { b as Session, a as ProofSource, A as AgentMemoryOption } from './shared-Bb5B59Bu.js';
+export { P as Proof, c as attestationProof } from './shared-Bb5B59Bu.js';
+
+/**
+ * Niadra for Strands Agents for TypeScript (`@strands-agents/sdk` 1.x, AWS): a plugin with the
+ * customer's context before every model call and the navigation kit as tools.
+ *
+ * `new NiadraPlugin(session)` goes in `plugins` of the `Agent`:
+ *
+ * - an input middleware of `InvokeModelStage` records the customer's newest message once, adds the
+ *   agent's notes and the customer's pack after your system prompt, and folds the suffix (deltas
+ *   and live turns) into the last user message, the way Strands' own context injector does. It
+ *   changes only what goes to the model: nothing of it lands in `agent.messages`.
+ * - an output middleware records the final answer with the model's usage (prompt cache reads and
+ *   writes included); tool-use turns record nothing.
+ * - `getTools()` gives the kit as Strands tools bound to the customer, with the canonical schemas.
+ *
+ * Fail-open: when Niadra is slow or down, the model gets the messages as they came.
+ *
+ * @example
+ * import { Agent, BedrockModel } from "@strands-agents/sdk";
+ * import { NiadraPlugin } from "@niadra/sdk/strands";
+ *
+ * const convo = niadra.conversation({ subject: handles.appUserId(user.id), channel: "web_chat", conversation_id: chatId });
+ * const support = new Agent({
+ *   model: new BedrockModel({ modelId: "us.anthropic.claude-sonnet-4-5-20250929-v1:0" }),
+ *   systemPrompt: "You are Acme's support agent.",
+ *   plugins: [new NiadraPlugin(convo)],
+ * });
+ * const result = await support.invoke("Where is my replacement?");
+ */
+
+interface NiadraPluginOptions {
+    /** What your app proved about the user, recorded once before the first context read. */
+    verify?: ProofSource;
+    /** Records the newest user message as the customer's turn. Defaults to `true`. */
+    recordCustomer?: boolean;
+    /** Records the final answer as the agent's turn. Defaults to `true`. */
+    recordAgent?: boolean;
+    /** Puts the agent's own notes before the customer's context, and adds its memory tools. */
+    agentMemory?: AgentMemoryOption;
+}
+/**
+ * The Niadra plugin for one agent. Takes the conversation or task (Strands agents usually live for
+ * one conversation), or a function of the agent that finds it per model call.
+ */
+declare class NiadraPlugin implements Plugin {
+    private readonly session;
+    private readonly options;
+    readonly name = "niadra";
+    private readonly states;
+    constructor(session: Session | ((agent: LocalAgent) => Session | null | undefined), options?: NiadraPluginOptions);
+    initAgent(agent: LocalAgent): void;
+    /** The kit bound to a fixed session; none when the session is found per call. */
+    getTools(): InvokableTool<unknown, JSONValue>[];
+    private stateOf;
+    private prepare;
+    private record;
+}
+/** The navigation kit as Strands tools, bound to the session's customer, with the canonical JSON Schemas. */
+declare function niadraTools(session: Session, options?: {
+    agentMemory?: AgentMemoryOption;
+}): InvokableTool<unknown, JSONValue>[];
+/**
+ * Strands' usage as a `ModelUsage`. Bedrock and Anthropic count the cached tokens apart from
+ * `inputTokens`; the other providers count them inside it.
+ */
+declare function strandsUsage(usage: unknown, provider: string, model: string, cacheApart: boolean): ModelUsage | null;
+
+export { AgentMemoryOption, NiadraPlugin, type NiadraPluginOptions, ProofSource, Session, niadraTools, strandsUsage };