> For the complete documentation index, see [llms.txt](https://dnotifier.gitbook.io/product-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dnotifier.gitbook.io/product-docs/appendix/glossary.md).

# Glossary

Definitions of terms used across DNotifier documentation and SDK APIs.

***

## A

### Agent

A named unit of AI logic created with `defineAgent` / `define_agent`. Classic agents provide a custom `run` function (`WorkflowContext`). Tool agents pass `tools` (local or MCP) and can run inside a workflow or via standalone `runAgent` / `run_agent`.

→ [Define an agent](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/define-agent.md) · [Tools & MCP](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/tools-and-mcp.md)

### appId

Your DNotifier application's public identifier, created in the dashboard. Passed to the SDK constructor. Paired with `secret` for authentication.

→ [Credentials & environment](https://dnotifier.gitbook.io/product-docs/getting-started/credentials.md)

### authToken

Bearer token returned after successful `connect()`. Used internally for WebSocket handshake and authenticated API calls. Available as `notifier.authToken` after connect.

→ [Connection & auth](https://dnotifier.gitbook.io/product-docs/reference/connection-auth.md)

***

## C

### Chunking

Splitting large outbound payloads into multiple frames sized to `messageSizeLimit`, then reassembling them on the receiver before `onMessage` fires.

→ [Large messages & chunking](https://dnotifier.gitbook.io/product-docs/realtime-communication/chunking.md)

### connect()

SDK method that authenticates with DNotifier and establishes readiness — opens a WebSocket for `ws` transport or marks the client authenticated for `http`.

→ [Connection lifecycle](https://dnotifier.gitbook.io/product-docs/realtime-communication/connection-lifecycle.md)

***

## D

### Directed messaging

DNotifier routes messages from a `senderId` to explicit `receiverId` or `receiverIds`. There is no anonymous broadcast or topic subscription model.

→ [Understanding messages](https://dnotifier.gitbook.io/product-docs/getting-started/understanding-messages.md)

### DNotifier

The main SDK client class. Manages transport, authentication, messaging, AI, knowledge base, and workflow execution.

→ [DNotifier class](https://dnotifier.gitbook.io/product-docs/reference/dnotifier-class.md)

### DNotifierMessage

Incoming message object passed to `onMessage`. Contains `metadata` (id, sender, timestamp, type) and `payload` (body accessors).

→ [Types & payloads](https://dnotifier.gitbook.io/product-docs/reference/types-and-payloads.md)

***

## E

### Embedding

The model that turns knowledge-base text into vectors. Omit it to use the subscription model. Pass `embedding` on a knowledge call, or save it on `serverConfig`.

→ [Vector stores and embeddings](https://dnotifier.gitbook.io/product-docs/ai/vector-stores.md)

### Endpoints

HTTP and WebSocket endpoints the SDK calls. Default production host: `api.dnotifier.com`. Optional WebSocket `url` override only when provided by DNotifier.

→ [Endpoints & custom URL](https://dnotifier.gitbook.io/product-docs/reference/endpoints.md)

### executionId

Unique identifier for a workflow run when `observability: true`. Returned from `runWorkflow` and visible in the workflow dashboard.

→ [Workflow observability](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/observability.md)

***

## F

### Framed packet

Binary wire format wrapping message metadata and payload. Handled internally by the SDK — application code uses `send()` and `onMessage`.

***

## H

### Handshake

Post-auth WebSocket step where the client sends the auth token to the realtime server before `onConnected` fires.

→ [Connection lifecycle](https://dnotifier.gitbook.io/product-docs/realtime-communication/connection-lifecycle.md)

### HTTP transport

Stateless transport (`transport: "http"`) for AI, RAG, knowledge-base APIs, and workflows. Does not deliver push messages to `onMessage`.

→ [Choose your transport](https://dnotifier.gitbook.io/product-docs/getting-started/choose-transport.md)

***

## K

### Knowledge base (RAG)

Indexed document store for semantic search. Manage with `addDocument`, `updateDocument`, `listDocuments`, `getDocument`, `deleteDocument`, and query with `search` or `useKnowledgeBase` in AI messages.

→ [Knowledge base overview](https://dnotifier.gitbook.io/product-docs/ai/knowledge-base-overview.md)

***

## M

### MCP

Model Context Protocol — connect external tool servers over HTTP with `notifier.mcp.connect`, discover tools, and pass them to a tool agent.

→ [Tools & MCP agents](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/tools-and-mcp.md)

### messageSizeLimit

Maximum message size in bytes from your plan. Also used as chunk size for large payloads. Available after `connect()` on the client instance and in `getPlanLimits()`.

→ [Plan limits & quotas](https://dnotifier.gitbook.io/product-docs/realtime-communication/plan-limits.md)

***

## O

### Observability

Workflow feature that records execution and step telemetry to the DNotifier dashboard when `observability: true` on a `Workflow` (or on a tool agent / `runAgent`).

→ [Workflow observability](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/observability.md) · [Tools & MCP](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/tools-and-mcp.md)

### onConnected

Callback fired when the client is authenticated and ready (WebSocket handshake complete for `ws`).

### onDisconnected

Callback fired when the WebSocket connection closes or the client disconnects.

### onMessage

Callback fired for each incoming realtime message (after chunk reassembly if applicable). Required for receiving chat and history responses.

***

## P

### Payload

Message body wrapper with `toJSON()`, `toString()`, `toBase64()`, and `raw()` accessors.

→ [Types & payloads](https://dnotifier.gitbook.io/product-docs/reference/types-and-payloads.md)

### Plan limits

Quotas returned at auth: message caps, AI requests/words, knowledge-base words, `aiEnabled`, user limits. Read with `getPlanLimits()`.

→ [Pricing & plans](https://dnotifier.gitbook.io/product-docs/platform-overview/pricing.md)

***

## R

### RAG

Retrieval-augmented generation — answering AI prompts using documents from your knowledge base via `search` or `useKnowledgeBase: true`.

→ [Build a RAG Q\&A bot](https://dnotifier.gitbook.io/product-docs/ai/example-rag-bot.md)

### runAgent / run\_agent

Standalone method to execute a tool agent outside a workflow (`notifier.runAgent` / `notifier.run_agent`). Inside workflows, keep using `ctx.runAgent(name)` / `ctx.run_agent(name)`.

→ [Tools & MCP agents](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/tools-and-mcp.md)

### receiverId / receiverIds

Target user ID(s) for an outbound message. Must match the connected `userId` of the recipient client(s).

### RPC send

HTTP endpoint for server-side message send (`rpcSendUrl`) — alternative to WebSocket `send()` in some server architectures.

***

## S

### saveHistory

Boolean flag on `send()` (default `true`). When true, the message is stored in chat history.

→ [Save history flag](https://dnotifier.gitbook.io/product-docs/chat/save-history.md)

### Tool (agent tool)

A callable capability registered with `notifier.tools.register` (local) or discovered via MCP. Tool agents can use these tools during a run.

→ [Tools & MCP agents](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/tools-and-mcp.md)

### secret

Private application key paired with `appId`. Must be kept confidential. Sent during `connect()` authentication.

→ [Security best practices](https://dnotifier.gitbook.io/product-docs/operations/security.md)

### senderId

User or service ID attributed as the message sender. Typically matches the connecting client's `userId` or a delegated service account.

### Semantic search

Vector similarity search over knowledge-base documents via `search({ query, limit, minSimilarity, ... })`.

→ [Semantic search](https://dnotifier.gitbook.io/product-docs/ai/semantic-search.md)

### serverConfig

Vector store and embedding used by knowledge calls on this client. A `vectorStore` or `embedding` on a single call overrides it. Python uses `server_config`.

→ [Vector stores and embeddings](https://dnotifier.gitbook.io/product-docs/ai/vector-stores.md)

### Session logging

When `logs: true`, AI sessions are reported to the DNotifier logs dashboard (start, completion, token usage).

→ [Session logging](https://dnotifier.gitbook.io/product-docs/ai/session-logging.md)

### sessionId

Durable thread id. On `sendAI`, continue a chat-style AI conversation. On `runAgent` / `runWorkflow`, keep agent memory and workflow state across turns (and enable resume / retry / replay).

→ [AI sessions](https://dnotifier.gitbook.io/product-docs/ai/sessions.md) · [Checkpoints, sessions & resume](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/checkpoints.md)

### Checkpoint

Saved snapshot of an agent or workflow run so you can continue later, retry after a failure, or replay an attempt for testing.

→ [Checkpoints, sessions & resume](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/checkpoints.md)

### Resume / retry / replay

Modes for continuing a session: **resume** picks up from the latest checkpoint, **retry** starts a new attempt from a failure without losing finished work, **replay** re-runs from a checkpoint for debugging.

→ [Checkpoints, sessions & resume](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/checkpoints.md)

***

## T

### Transport

Communication mode: `ws` (WebSocket, realtime) or `http` (request/response for AI/RAG/workflows).

→ [Transport method matrix](https://dnotifier.gitbook.io/product-docs/reference/transport-matrix.md)

***

## U

### userId

End-user or service identifier for the connecting client. Used in auth, routing, and per-user limits.

→ [Credentials & environment](https://dnotifier.gitbook.io/product-docs/getting-started/credentials.md)

***

## V

### Vector store

Where knowledge-base chunks are stored. The default is Postgres. `vectorStore.provider` can also be `pinecone`, `weaviate`, `qdrant`, `azure_search`, or `s3_vectors`.

→ [Vector stores and embeddings](https://dnotifier.gitbook.io/product-docs/ai/vector-stores.md)

***

## W

### WebSocketImpl

Constructor option (JavaScript / Node.js only) — pass the `ws` package class when using `transport: "ws"` in Node. Browsers omit this; Dart uses `web_socket_channel` internally.

→ [Node.js platform guide](https://dnotifier.gitbook.io/product-docs/platform-guides/nodejs.md)

### WebSocket transport

Persistent connection (`transport: "ws"`) for realtime send/receive and `onMessage` delivery.

### Workflow

Named multi-step pipeline with an `entry` function and registered agents. Executed via `runWorkflow`.

→ [Workflows overview](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/overview.md)

### WorkflowContext

Context object (`ctx`) passed to workflow `entry` and agent `run` functions. Provides `input`, `state`, `runAgent`, `sendAI`, `search`, document methods, and `recordStep`.

→ [WorkflowContext reference](https://dnotifier.gitbook.io/product-docs/workflows-and-agents/workflow-context.md)

### WorkflowError

Error type thrown for workflow validation failures and runtime errors in agent execution.

***

## Related

* [FAQ](https://dnotifier.gitbook.io/product-docs/operations/faq.md)
* [Support & links](https://dnotifier.gitbook.io/product-docs/appendix/support.md)
