SDKs

SDKs · TypeScript

Overview

The @phrony/sdk client for Node.js — install, run agents and bundles, stream sessions, and register workers.

@phrony/sdk is the TypeScript client for the Phrony runtime. It targets Node.js 18+, uses @grpc/grpc-js, and maps proto bytes JSON fields through helpers so you work with ordinary JavaScript objects.

Topics

Install

Add @phrony/sdk and choose import paths.

Connect

Dial a runtime with RuntimeClient, Phrony, TLS, health checks, and address resolution.

Run agents & bundles

Phrony facade, PhronyAgent, and PhronyBundle — run agents and bundles with wait or fire-and-forget.

Interactive sessions

Stream sessions, handle events, user messages, and tool approvals.

Tool workers

Register tool handlers on the Work stream with Worker and WorkStream.

Runtime client

Unary RPCs for agent and bundle lifecycle, sessions, approvals, and catalog APIs.

Utilities

JSON bytes helpers, agent and bundle ref parsing, errors, constants, and proto types.