@tensflare/llamaindex

LlamaIndex middleware — automatically records query engine and retriever operations as Truss actions.

What is Truss?

Truss is an accountability layer for AI agents — it records every agent action as a cryptographically signed, tamper-evident audit trail. Learn more →

Overview

Wrap any LlamaIndex query engine or retriever to automatically compute SHA-256 hashes of queries and results, recording llamaindex_query and llamaindex_retrieve actions to the Truss API. Fail-open — operations proceed normally even if the API is unreachable.

Installation

npm install @tensflare/llamaindex

Quick start

import { TrussLlamaIndexMiddleware } from "@tensflare/llamaindex";

const truss = new TrussLlamaIndexMiddleware({
  apiUrl: "http://localhost:4000",
  apiKey: "tr_your_api_key",
  mandateId: "mnd_001",
});

// Wrap a query engine
const wrappedEngine = truss.wrapQueryEngine(myQueryEngine);

// Wrap a retriever
const wrappedRetriever = truss.wrapRetriever(myRetriever);

API

new TrussLlamaIndexMiddleware(options)

| Option | Type | Description | |---|---|---| | apiUrl | string | Truss API base URL | | apiKey | string | Truss API key | | mandateId | string | Mandate ID |

middleware.wrapQueryEngine(engine)

Wraps an object with a query(query: string): Promise<string> method. Records llamaindex_query actions.

middleware.wrapRetriever(retriever)

Wraps an object with a retrieve(query: string): Promise<unknown[]> method. Records llamaindex_retrieve actions.

Related packages

| Package | Description | |---|---| | @tensflare/sk | Semantic Kernel middleware (same pattern) | | @tensflare/openai | OpenAI Agents SDK middleware (same pattern) | | @tensflare/truss-sdk | TypeScript SDK | | @tensflare/tap | Core Zod schemas |

Development

npm install
npm run build
npm test

Contributing

Pull requests are welcome. Please see the contribution guidelines.

License

Apache 2.0 — see LICENSE.