Saalt Bridge

The Bridge is the TypeScript SDK that plugins use to communicate with a Saalt server. It wraps the Saalt Admin API into a typed, ergonomic client so plugin code never has to deal with raw HTTP.

Installation

npm install @open-agent-kit/bridge

What it does

When a plugin runs, it receives a signed JWT and the server URL. Passing those two values to createBridge returns a ready-to-use client:

import { createBridge } from "@open-agent-kit/bridge";

const bridge = createBridge({ token, serverUrl });

The bridge exposes the following namespaces:

| Namespace | What it gives you | |---|---| | bridge.llm | Generate text, structured objects, images, or full conversation responses via the configured LLM | | bridge.files | Upload, retrieve, and parse files (PDFs, images, Office documents) — including OCR and model-powered extraction | | bridge.knowledge | List knowledge documents and trigger sync operations | | bridge.conversation | Look up conversation history | | bridge.data.config | Read and write plugin-level configuration | | bridge.data.pluginData | Persistent key/value storage scoped to the plugin | | bridge.user | Retrieve information about the current user |

All calls are authenticated automatically using the token provided at construction time.

Learn more

• saalt.ai