@rine-network/mastra 0.3.0 → 0.6.0

package/dist/tool.d.ts

@@ -1,16 +1,18 @@
 /**
  * Shared `createTool` plumbing every rine tool reuses (no duplicated logic):
- * identity injection (I-1 lazy client + I-2 no-creds-in-schema) and the
- * try/catch → `formatError` wrapper (I-3 errors→strings, never a reject).
+ * identity injection (a lazily built client, and no credentials in any
+ * model-visible schema) and the try/catch → `formatError` wrapper that turns
+ * every error into a readable string instead of a rejected promise.
  *
  * A tool's per-tool body is just `(client, inputData) => string`; this helper
  * supplies the surrounding contract:
  *   1. read the acting agent + config-dir/api-url overrides from
  *      `ctx.requestContext` (NEVER `inputSchema`), falling back to the
  *      `rineToolkit(opts)` overrides closed over at factory time,
- *   2. lazily build/get the shared `AsyncRineClient` (I-1 — first call only),
+ *   2. lazily build/get the shared `AsyncRineClient` (first call only, so that
+ *      importing the package builds nothing),
  *   3. run the body, and on any thrown SDK error return `formatError(err)` so
- *      the tool RESOLVES a readable string and never rejects (I-3).
+ *      the tool RESOLVES a readable string and never rejects.
  *
  * `createTool` from `@mastra/core/tools` is invoked by each domain module; this
  * file only builds the `execute` closure and the shared option/ctx types.
@@ -22,11 +24,11 @@ import { type RineToolContext } from "./context.js";
 /**
  * Per-factory overrides threaded from `rineToolkit(opts)` / an individual
  * `createRine<X>Tool(opts)` call. A live `client` may be passed so every tool in
- * one `rineToolkit(...)` call shares ONE lazily-built client (AC-11); when
+ * one `rineToolkit(...)` call shares ONE lazily-built client; when
  * omitted, each tool resolves its own client lazily on first `execute`.
  */
 export interface RineToolOpts extends RineClientOpts {
-    /** A shared client to reuse (set by `rineToolkit` for AC-11). */
+    /** A shared client to reuse, set by `rineToolkit` so all its tools share one. */
     client?: AsyncRineClient;
 }
 /**
@@ -38,7 +40,7 @@ export interface RineToolOpts extends RineClientOpts {
  */
 export interface RinePaymentToolOpts extends RineToolOpts {
     /**
-     * D2 auto-pay default (default OFF). When true, `rine_pay` defaults to paying
+     * Auto-pay default (default OFF). When true, `rine_pay` defaults to paying
      * ONLY quotes at/below the policy's `autoPayThreshold`; a per-call `autoPay`
      * input still overrides it. Caps + deny-by-default + reserve-lock bound it
      * regardless.
@@ -57,7 +59,7 @@ export interface RinePaymentToolOpts extends RineToolOpts {
  * Resolve the effective `AsyncRineClient` for one `execute` call: prefer a
  * shared client from the toolkit, else build one from the ctx-injected identity
  * layered over the factory defaults. Lazy by construction — only runs inside
- * `execute` (I-1).
+ * `execute`, never at import or in a factory body.
  */
 export declare function resolveClient(opts: RineToolOpts, ctx: RineToolContext | undefined): AsyncRineClient;
 /**
@@ -69,7 +71,7 @@ export declare function resolveClient(opts: RineToolOpts, ctx: RineToolContext |
 export declare function resolveApiUrlFor(opts: RineToolOpts, ctx: RineToolContext | undefined): string;
 /**
  * The recipient union `client.send`/`sendAndWait` accept. The model supplies a
- * free-form `to` string (a `name@org` handle, a `#group@org` handle, or a UUID);
+ * free-form `to` string (a `name@org` handle, a `#logistics@acme.rine.network` handle, or a UUID);
  * the SDK normalizes + validates it at runtime, so this brands the string once,
  * in one documented place, rather than scattering casts.
  */
@@ -77,9 +79,10 @@ type Recipient = AgentHandle | AgentUuid | GroupHandle | GroupUuid;
 /** Brand a model-supplied recipient string for the SDK send surface. */
 export declare function asRecipient(to: string): Recipient;
 /**
- * I-2 layer (c): the belt-and-suspenders ciphertext redactor for `read` /
- * `check_inbox` (SPEC §2.2 / D-output). Layers (a) plaintext-only renderers and
- * (b) `outputSchema: z.string()` already guarantee the `execute` return is a
+ * The third and last defence against ciphertext reaching the model: a
+ * belt-and-suspenders redactor for `read` / `inbox` / `thread`. The first two —
+ * plaintext-only renderers, and `outputSchema: z.string()` so no structured
+ * field can carry an envelope — already guarantee the `execute` return is a
  * redacted string; this coerces ANY value to plain text content before it can
  * reach the model, so even a regression that returned a richer object containing
  * ciphertext could not surface it. Returns Mastra's default text-content shape.

package/dist/tools.d.ts

@@ -1,16 +1,17 @@
 /**
- * `rineToolkit(opts)` — the aggregator (SPEC §7). Returns a plain keyed
+ * `rineToolkit(opts)` — the aggregator. Returns a plain keyed
  * `Record<string, Tool>` (Mastra has no `BaseToolkit` class). The object KEY is
  * the model-facing tool name, so each entry is keyed by its `id`
  * (`toolName === id`). Drop the record straight into a Mastra `Agent`'s
  * `tools: {}` map.
  *
- * `include` curates the surface: `"all"` (14), one domain
+ * `include` curates the surface: `"all"` (25), one domain
  * (`"messaging"`/`"discovery"`/`"groups"`/`"payments"`), or an array union of
  * domains. The `"payments"` domain (`rine_pay`, `rine_fulfill`) moves funds —
- * bounded by the on-disk spend policy (deny-by-default) and D2 auto-pay OFF.
+ * bounded by the on-disk spend policy (deny-by-default) and by auto-pay, OFF
+ * unless the toolkit turns it on.
  *
- * AC-11 shared client: ONE lazily-built `AsyncRineClient` is created per
+ * Shared client: ONE lazily-built `AsyncRineClient` is created per
  * `rineToolkit(...)` call and threaded into every tool's `opts.client`, so all
  * tools share a client (and the warm OAuth token cache). Per-acting-agent
  * variants derive cheaply via `client.withAgent(...)` inside each `execute`.
@@ -28,7 +29,7 @@ export type RineToolDomain = "messaging" | "discovery" | "groups" | "payments";
  * OFF, marker ON) and a facilitator is only needed to `rine_fulfill`.
  */
 export interface RinePaymentsConfig {
-    /** D2 auto-pay default (default OFF). See {@link RinePaymentToolOpts.autoPay}. */
+    /** Auto-pay default (default OFF). See {@link RinePaymentToolOpts.autoPay}. */
     autoPay?: RinePaymentToolOpts["autoPay"];
     /** Facilitator for `rine_fulfill`. See {@link RinePaymentToolOpts.facilitator}. */
     facilitator?: RinePaymentToolOpts["facilitator"];

package/dist/types.d.ts

@@ -8,7 +8,7 @@
  * type-only re-derivations; runtime tool schemas are authored with the host
  * `zod` in `schemas.ts`.
  */
-import type { AgentProfileSchema, AgentSummarySchema, DecryptedMessageSchema, GroupReadSchema, InviteResultSchema, MessageReadSchema } from "@rine-network/sdk";
+import type { AgentProfileSchema, AgentSummarySchema, DecryptedMessageSchema, GroupReadSchema, InviteResultSchema, JoinRequestReadSchema, MessageReadSchema, VoteResponseSchema } from "@rine-network/sdk";
 /** Project a Zod schema's output type without importing the SDK's `z` instance. */
 type Infer<S> = S extends {
     _output: infer O;
@@ -19,4 +19,6 @@ export type GroupRead = Infer<typeof GroupReadSchema>;
 export type InviteResult = Infer<typeof InviteResultSchema>;
 export type AgentSummary = Infer<typeof AgentSummarySchema>;
 export type AgentProfile = Infer<typeof AgentProfileSchema>;
+export type JoinRequestRead = Infer<typeof JoinRequestReadSchema>;
+export type VoteResponse = Infer<typeof VoteResponseSchema>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rine-network/mastra",
-  "version": "0.3.0",
+  "version": "0.6.0",
   "description": "Native Mastra.ai tools for the rine network \u2014 E2E-encrypted (HPKE 1:1, MLS groups, PQ-hybrid) agent-to-agent messaging, discovery, and coordination as createTool tools, a toolkit aggregator, a lifecycle bridge, a Tier-3 workflow-resume bridge, and a setup CLI.",
   "author": "mmmbs <mmmbs@proton.me>",
   "license": "EUPL-1.2",
@@ -42,8 +42,8 @@
   },
   "dependencies": {
     "@libsql/client": "^0.15.0",
-    "@rine-network/core": "^0.11.0",
-    "@rine-network/sdk": "^0.8.0"
+    "@rine-network/core": "^0.14.0",
+    "@rine-network/sdk": "^0.11.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0 <2.0.0",