Genkit

niadraMiddleware(session) is a model middleware for Genkit’s generate({ use }) (Firebase Genkit for JavaScript), and niadraTools(session) returns the kit as Genkit tools. TypeScript only.

Install

npm install @niadra/sdk genkit   # genkit 1.42 or newer, below 2, as an optional peer dependency

The integration ships with @niadra/sdk 0.3.0, ready on main and on npm when it is published; until then the npm package is 0.1.1.

The five primitives

Primitive	How the adapter wires it
Context	The middleware runs around every model call of the request, the steps of a tool loop included: the pack (after the agent’s own notes, with `agentMemory`) joins your system message as a text part (a new one when there is none; several providers read one system message only) and the `turn_block` joins the last user message as a text part
Turns	The user’s newest message is recorded once; the answer is the agent’s turn, with Genkit’s usage (`inputTokens` and `cachedContentTokens`) when you name the `model` in the options, because a model middleware does not see the model’s name. Steps that only request tools record nothing
Tools	`niadraTools(session)`: unregistered Genkit tools (each request carries the ones bound to its own customer), with the kit’s JSON Schemas
Verification	`verify` in the middleware options, recorded once before the first context
Handoff	`session.handoff()` where your flow transfers

Minimal example

import { genkit } from "genkit";
import { googleAI } from "@genkit-ai/google-genai";
import { Niadra, handles } from "@niadra/sdk";
import { niadraMiddleware, niadraTools } from "@niadra/sdk/genkit";

const niadra = new Niadra();
const ai = genkit({ plugins: [googleAI()] });

const convo = niadra.conversation({ subject: handles.appUserId(user.id), channel: "web_chat", conversation_id: chatId });
const { text } = await ai.generate({
  model: googleAI.model("gemini-2.5-flash"),
  system: "You are Acme's support agent.",
  messages: history,
  prompt: "Where is my replacement?",
  tools: niadraTools(convo),
  use: [niadraMiddleware(convo, { model: "googleai/gemini-2.5-flash" })],
});

Agent memory

niadraMiddleware(convo, { agentMemory: true }) and niadraTools(convo, { agentMemory: true }) put the agent’s own notes before the customer’s context and add the two tools. See Agent memory.

Limits

The middleware takes a conversation, a task or a function that finds the one each call belongs to; when it returns null, the call passes through untouched.
Without model in the options, the agent’s turn is recorded without usage.
Nothing here stops the call: with Niadra slow or down, the request goes to the model as it came.
Tested against genkit 1.42.0 with Genkit’s own test model, tool loop included, and Niadra on the emulator.

Get started

Voice

Channels

Agent frameworks

Model SDKs

Automation platforms

MCP clients

Install

The five primitives

Minimal example

Agent memory

Limits

Next steps

Google GenAI

History navigation

​Install

​The five primitives

​Minimal example

​Agent memory

​Limits

​Next steps

Google GenAI

History navigation

Install

The five primitives

Minimal example

Agent memory

Limits

Next steps