Relay SDK

Resolve Action Cards into governed receipts before execution

@neurarelay/sdk@0.1.0 is published on npm for Action Card decision receipts

Open SDK example Open Action Card example Open Workspace

First SDK path

Install, resolve, inspect, then execute in your system

Install

Install the current package

Resolve

Send card before acting

Inspect

Store receipt and trace refs

Execute

Honor the receipt before acting

Install

Install public package from npm

Run the current SDK example

Run

current SDK

REPO=neurarelay/relay-action-card
git clone https://github.com/$REPO.git
cd relay-action-card
npm install
npm run example:sdk
npm run example:sdk:authority-routing
npm run example:sdk:a2a
npm run verify:sdk-stable-consumer

Resolve

Return governed decision before execution

Keep direct Relay primary; adapters stay protected

Resolve call

TypeScript

const { createNeuraRelaySdk } =
  await import("@neurarelay/sdk");

const relay = createNeuraRelaySdk({
  baseUrl: "https://www.neurarelay.com"
});

const result = await relay.resolve.resolve({
  action_card: actionCard
});

const receipt = result.decision_receipt;

console.log(receipt?.decision);
console.log(receipt?.trace_ref);

Authority routing

Route authority receipts by trust

Hold demo refs until Registry trust is ready

Routing

stable

npm run \
  example:sdk:authority-routing
npm run \
  verify:sdk-authority-routing

const ready =
  receipt.decision === "proceed" &&
  receipt.authority_context?.source ===
    "registry_reference_packet";

const verified =
  receipt.authority_context
    ?.registry_validation_status === "ready";

const route = ready && verified
  ? "ready_for_developer_owned_execution"
  : "hold_for_registry_backed_authority";

A2A

Discover publicly with controlled execution

Send messages only with controlled access

Protected A2A

optional

npm run example:sdk:a2a

RELAY_A2A_ACCESS_TOKEN=... \
  npm run example:sdk:a2a

npm run verify:a2a-authenticated-client

SDK surfaces

Core package with optional protected adapter helpers

Core client

Action Card to governed Decision Receipt

A2A helper

Read metadata; call protected A2A with controlled access

MCP helper

Call protected Relay MCP tools with Workspace access

Trust refs

Use Agent Passport refs without private payload exposure

Boundaries

The SDK packages the mechanism, not public trust issuance

Current package

Use npm latest for receipt proof

No token issuance

The SDK does not create public API keys, MCP tokens, or A2A tokens

No execution

Relay returns decisions and refs; your product keeps downstream execution

Public proof stays in GitHub

The public example now includes a runnable npm SDK path

Open SDK example