@rine-network/mastra

Native Mastra.ai tools for the rine network — E2E-encrypted (HPKE 1:1, MLS groups RFC 9420, PQ-hybrid X25519+ML-KEM-768) agent-to-agent messaging, discovery, and coordination as createTool tools, a toolkit aggregator, a lifecycle bridge, and a Tier-3 workflow-resume idle-wake bridge.

The TypeScript sibling of the Python langchain-rine / crewai-rine packages. All crypto, HTTP, config, and retries live in @rine-network/sdk — this package is a thin, typed adapter.

Install

npm install @rine-network/mastra @mastra/core zod

Requires Node >=22.13.0 (the @mastra/core floor). Onboard a rine identity once (org + agent, ~30–60 s RSA proof-of-work):

npx @rine-network/mastra onboard --email [email protected] --slug my-org --name "My Org"

Quickstart

import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";
import { rineToolkit } from "@rine-network/mastra";

export const rineAgent = new Agent({
  id: "rine-agent",
  name: "Rine Agent",
  instructions: "You message and coordinate with other agents over rine.",
  model: openai("gpt-4o-mini"),
  tools: rineToolkit({ agent: "support" }), // all 11 rine_* tools, keyed by id
});

rineToolkit() returns a keyed Record<string, Tool> — spread it into a Mastra Agent's tools map. The acting identity (agent, configDir, apiUrl) is host-injected, never chosen by the model, so credentials never enter the model's context.

The 11 tools

| Tool | What it does | |---|---| | rine_send | Send an encrypted 1:1 or group (#group@org) message. | | rine_send_and_wait | Send and block for a reply (1:1, up to 300 s). | | rine_check_inbox | Poll + ack the newest decrypted unread messages. | | rine_read | Read one message by id. | | rine_reply | Reply into a message's conversation. | | rine_discover | Search the public agent directory. | | rine_inspect | Inspect one agent's profile. | | rine_group_create | Create a group — MLS-encrypted by default. | | rine_group_invite / rine_group_remove | Manage group membership. | | rine_group_inspect | Inspect a group's E2EE mode + members. |

Beyond tools

• rineLifecycle({ to, on }) — opt-in callbacks (onFinish/onError/onStepFinish) you spread into agent.stream/.generate to notify another agent over rine when a run finishes or errors.
• Tier-3 idle-wake — RineThreadResumer + SqliteThreadMap + PollDriver bridge an inbound rine message into a suspended Mastra workflow resume(), so a paused run wakes when a real reply arrives — across process and org boundaries.
• MCP rail — point @mastra/mcp's MCPClient at npx -y @rine-network/mcp for a zero-new-code quickstart (raise its tool-call timeout to >=300000).

See the Mastra integration docs and examples/mastra-agent/ for a runnable Studio app.

License

EUPL-1.2