@easynet-run/node 0.27.14

package/README.md

@@ -0,0 +1,135 @@
+<p align="center">
+  <a href="https://github.com/EasyRemote"><img src="https://avatars.githubusercontent.com/u/213722898?s=200&v=4" width="200" height="200" alt="EasyRemote"></a>
+</p>
+
+<h1 align="center">@easynet-run/node</h1>
+
+<p align="center">
+  Node.js SDK for <strong>EasyNet Axon</strong> — the Capability Control Plane for agent-native distributed execution.
+</p>
+
+<p align="center">
+  <a href='https://github.com/EasyRemote/EasyNet-Axon'><img src='https://img.shields.io/badge/EasyNet-Axon-00d9ff?style=for-the-badge&labelColor=0f172a'></a>
+  <a href='https://github.com/EasyRemote/EasyNet-Axon/blob/main/LICENSE'><img src='https://img.shields.io/badge/License-Apache_2.0-f97316?style=for-the-badge&labelColor=0f172a'></a>
+</p>
+<p align="center">
+  <img src='https://img.shields.io/badge/Node.js-20+-339933?style=for-the-badge&logo=node.js&logoColor=white&labelColor=0f172a'>
+  <img src='https://img.shields.io/badge/Platform-macOS_|_Linux_|_Windows-22c55e?style=for-the-badge&labelColor=0f172a'>
+</p>
+
+---
+
+## What is this?
+
+This is the Node.js surface for **Axon**, a protocol-level control plane that treats agent capabilities as first-class network objects. Every ability you expose carries its own schema, trust posture, scheduling contract, and tenant isolation rules — enforced atomically at invocation time.
+
+Axon collapses tenant isolation, rate limiting, policy evaluation, node selection, concurrency admission, and circuit breaking into a **single atomic decision** against the same state snapshot. No race window between policy check and routing.
+
+The SDK ships a native Dendrite bridge binary (loaded via `koffi`) that provides protocol-complete Axon gRPC calls without gRPC codegen in JavaScript.
+
+## Install
+
+```bash
+npm install @easynet-run/node
+```
+
+## Quick Start
+
+### Expose an ability
+
+```ts
+import { ability, serve } from "@easynet-run/node";
+
+ability("easynet:///r/org/reg/agent.quote-bot/abilities/order.quote@1?tenant_id=tenant-test")
+  .handle(async ({ sku, qty = 1 }) => ({ sku, price: 19.9 * qty }))
+  .expose();
+
+await serve("agent.quote-bot");
+```
+
+### Invoke an ability
+
+```ts
+import { client } from "@easynet-run/node";
+
+const res = await client()
+  .tenant("tenant-test")
+  .ability("easynet:///r/org/reg/agent.quote-bot/abilities/order.quote@1?tenant_id=tenant-test")
+  .call({ sku: "A1", qty: 2 });
+```
+
+`call()` returns business payload (`result_json`). Use `callAny()` or `callRaw()` for stream/media-oriented non-object payloads.
+
+### Bootstrap a local runtime behind NAT
+
+```ts
+import { startServer } from "@easynet-run/node";
+
+const srv = await startServer(undefined, {
+  hub: "axon://hub.easynet.run:50084",
+  hubTenant: "tenant-test",
+  hubLabel: "alice-macbook",
+});
+```
+
+No public IP required — the local runtime connects outbound to the Hub and receives federated invocations over that channel.
+
+## Sub-exports
+
+| Path | Purpose |
+|---|---|
+| `@easynet-run/node/presets/remote-control` | Remote device orchestration presets |
+| `@easynet-run/node/mcp` | MCP stdio server and tool provider |
+| `@easynet-run/node/tool-adapter` | Ability → LLM tool schema conversion |
+
+## Capabilities
+
+### Core Protocol
+
+- **Fluent builders** — `.tenant()` → `.principal()` → `.ability()` → `.call()` are immutable and chainable.
+- **Native Dendrite bridge** — `DendriteBridge` loads the platform C ABI via koffi; all Axon gRPC shapes (unary, server-stream, client-stream, bidi-stream) available without gRPC codegen.
+- **Subject binding** — `.principal(...)` scopes invocation to a subject identity with automatic URI visibility mapping.
+
+### Ability Lifecycle
+
+Full lifecycle management — not just invocation:
+
+- `createAbility()` / `exportAbility()` — define and register abilities with schemas
+- `deployToNode()` — install + activate on target nodes
+- `listAbilities()` / `invokeAbility()` / `uninstallAbility()`
+- `discoverNodes()` / `executeCommand()` / `disconnectDevice()` / `drainDevice()`
+- `buildDeployPackage()` / `deployPackage()` — packaging and deployment workflows
+
+### MCP & A2A Protocols
+
+- **MCP server** — `StdioMcpServer` hosts JSON-RPC 2.0 tool endpoints over stdio.
+- **MCP operations** — deploy, list, call, and update MCP tools on remote nodes.
+- **A2A agent protocol** — inter-agent discovery and task dispatch.
+- **Tool adapter** — `AbilityToolAdapter` converts abilities to OpenAI/Anthropic/generic tool definitions; supports local handler registration with zero network overhead.
+
+### Voice & Media Signaling
+
+First-class voice call lifecycle and transport negotiation (19+ FFI bindings):
+
+- Call management: create, join, leave, end, watch events, report metrics
+- Transport sessions: create, set description, add ICE candidates, refresh lease
+- Media path updates and codec negotiation
+
+### Federation
+
+- `startServer()` spawns a local Axon runtime and joins the Hub — all traffic is outbound.
+- Federated node discovery and cross-network invocation dispatch.
+
+### Remote Control & Orchestration
+
+- Subprocess template building, descriptor parsing, orchestrator factory.
+- Ability dispatch workflows with bundle reading and media persistence.
+- Deploy trace lifecycle tracking (`Phase` → `PhaseReceipt`).
+
+## License
+
+Apache-2.0 — see [LICENSE](https://github.com/EasyRemote/EasyNet-Axon/blob/main/LICENSE).
+
+## Author
+
+[Silan Hu](https://github.com/Qingbolan) · [silan.hu@u.nus.edu](mailto:silan.hu@u.nus.edu)

package/native/dendrite-bridge-manifest.json

@@ -0,0 +1,38 @@
+{
+  "dendrite_bridge_version": "0.27.14",
+  "target": "x86_64-unknown-linux-gnu",
+  "os": "linux",
+  "arch": "x86_64",
+  "library": {
+    "path": "native/libaxon_dendrite_bridge.so",
+    "sha256": "48d24b376d4c233a4d836f01ad6ede4dd38677a63fd6b687eeabc6a387ee910b"
+  },
+  "header": {
+    "path": "native/include/axon_dendrite_bridge.h",
+    "sha256": "b54e9ce0898c95276e5a2f5752cf7c09255ab04d0ff6c50b1da86f194faf6b75"
+  },
+  "protocol_coverage": {
+    "rpc_shapes": ["unary", "server_stream", "client_stream", "bidi_stream"],
+    "path_contract": "caller provides canonical gRPC path, e.g. /axon.v1.Invocation/Invoke",
+    "request_encoding": "base64(protobuf-bytes)",
+    "response_encoding": "base64(protobuf-bytes)"
+  },
+  "ffi_exports": [
+    "axon_dendrite_client_open_json",
+    "axon_dendrite_client_close_json",
+    "axon_dendrite_unary_call_json",
+    "axon_dendrite_server_stream_call_json",
+    "axon_dendrite_client_stream_call_json",
+    "axon_dendrite_bidi_stream_call_json",
+    "axon_dendrite_invoke_ability_json",
+    "axon_dendrite_list_nodes_json",
+    "axon_dendrite_deploy_mcp_list_dir_json",
+    "axon_dendrite_list_mcp_tools_json",
+    "axon_dendrite_call_mcp_tool_json",
+    "axon_dendrite_uninstall_capability_json",
+    "axon_dendrite_update_mcp_list_dir_json",
+    "axon_dendrite_protocol_coverage_json",
+    "axon_dendrite_string_free"
+  ],
+  "generated_at_utc": "2026-03-19T17:45:33Z"
+}

package/native/dendrite-bridge.json

@@ -0,0 +1,15 @@
+{
+  "language": "node",
+  "dendrite_bridge_version": "0.27.14",
+  "target": "x86_64-unknown-linux-gnu",
+  "dendrite_manifest_path": "native/dendrite-bridge-manifest.json",
+  "dendrite_library_path": "native/libaxon_dendrite_bridge.so",
+  "dendrite_header_path": "native/include/axon_dendrite_bridge.h",
+  "call_contract": {
+    "unary": "axon_dendrite_unary_call_json",
+    "server_stream": "axon_dendrite_server_stream_call_json",
+    "client_stream": "axon_dendrite_client_stream_call_json",
+    "bidi_stream": "axon_dendrite_bidi_stream_call_json",
+    "ability_invoke": "axon_dendrite_invoke_ability_json"
+  }
+}

package/native/include/axon_dendrite_bridge.h

@@ -0,0 +1,460 @@
+// EasyNet Axon for AgentNet
+// =========================
+//
+// File: core/runtime-rs/dendrite-bridge/include/axon_dendrite_bridge.h
+// Description: C ABI header for Axon Dendrite bridge exported functions.
+//
+// Protocol Responsibility:
+// - Declares stable FFI entrypoints for invoke/control operations exposed to non-Rust SDKs.
+// - Defines ownership and transfer boundaries for bridge handles, buffers, and error payloads.
+//
+// Implementation Approach:
+// - Uses C-compatible primitive and pointer types to preserve ABI portability.
+// - Pairs allocation-returning calls with explicit free APIs to avoid cross-runtime leaks.
+//
+// Usage Contract:
+// - Consumers must release bridge resources only through exported cleanup functions.
+// - Header declarations must remain synchronized with src/ffi_exports.rs symbols.
+//
+// Architectural Position:
+// - Lowest-level native boundary contract beneath language-specific SDK facades.
+// - Protects protocol semantics from ABI drift across Go/Node/Python/Java integrations.
+//
+// Author: Silan.Hu
+// Email: silan.hu@u.nus.edu
+// Copyright (c) 2026-2027 easynet. All rights reserved.
+
+#ifndef AXON_DENDRITE_BRIDGE_H
+#define AXON_DENDRITE_BRIDGE_H
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// Creates a client handle.
+// input JSON:
+// {"endpoint":"http://127.0.0.1:50051","connect_timeout_ms":5000}
+// output JSON:
+// {"ok":true,"handle":1}
+// {"ok":false,"error":"..."}
+char *axon_dendrite_client_open_json(const char *config_json);
+
+// Releases a client handle.
+// output JSON: {"ok":true,"removed":true}
+char *axon_dendrite_client_close_json(uint64_t handle);
+
+// Calls any unary gRPC method.
+// input JSON:
+// {
+//   "path":"/axon.v1.Invocation/Invoke",
+//   "request_base64":"...",
+//   "metadata":{"x-foo":"bar"},
+//   "timeout_ms":10000
+// }
+// output JSON:
+// {
+//   "ok":true,
+//   "path":"/axon.v1.Invocation/Invoke",
+//   "response_base64":"...",
+//   "response_bytes":123
+// }
+char *axon_dendrite_unary_call_json(uint64_t handle, const char *request_json);
+
+// Calls any server-streaming gRPC method.
+// input JSON fields are same as unary + optional "max_chunks".
+// output JSON:
+// {
+//   "ok":true,
+//   "path":"/axon.v1.Invocation/WatchInvocation",
+//   "chunk_count":3,
+//   "chunks_base64":["...","...","..."],
+//   "truncated":false
+// }
+char *axon_dendrite_server_stream_call_json(uint64_t handle,
+                                            const char *request_json);
+
+// Calls any client-streaming gRPC method.
+// input JSON:
+// {
+//   "path":"/axon.v1.PayloadTransfer/UploadPayload",
+//   "request_chunks_base64":["...","..."],
+//   "metadata":{"x-foo":"bar"},
+//   "timeout_ms":10000,
+//   "max_request_chunks":4096
+// }
+// output JSON:
+// {
+//   "ok":true,
+//   "path":"/axon.v1.PayloadTransfer/UploadPayload",
+//   "response_base64":"...",
+//   "response_bytes":123
+// }
+char *axon_dendrite_client_stream_call_json(uint64_t handle,
+                                            const char *request_json);
+
+// Calls any bidi-stream gRPC method.
+// input JSON:
+// {
+//   "path":"/axon.v1.Stream/OpenStream",
+//   "request_chunks_base64":["...","..."],
+//   "metadata":{"x-foo":"bar"},
+//   "timeout_ms":10000,
+//   "max_request_chunks":4096,
+//   "max_response_chunks":4096
+// }
+// output JSON:
+// {
+//   "ok":true,
+//   "path":"/axon.v1.Stream/OpenStream",
+//   "chunk_count":2,
+//   "chunks_base64":["...","..."],
+//   "truncated":false
+// }
+char *axon_dendrite_bidi_stream_call_json(uint64_t handle,
+                                          const char *request_json);
+
+// Native helper for EasyNet ability call (Invocation/Invoke):
+// input JSON:
+// {
+//   "tenant_id":"tenant-test",
+//   "resource_uri":"easynet:///r/org/reg/agent.quote-bot/abilities/order.quote@1?tenant_id=tenant-test",
+//   "payload_json":{"sku":"A1","qty":2},
+//   "timeout_ms":30000
+// }
+// output JSON includes decoded invoke metadata and result payload fields:
+// {
+//   "ok":true,
+//   "state":1,
+//   "result_content_type":"application/json",
+//   "result_base64":"...",
+//   "result_json":{"price":39.8}
+// }
+char *axon_dendrite_invoke_ability_json(uint64_t handle,
+                                        const char *request_json);
+
+// Returns protocol catalog JSON generated from core/proto/axon/v1/*.proto.
+// output JSON:
+// {
+//   "ok":true,
+//   "count":123,
+//   "rpcs":[
+//     {"service":"ControlPlane","rpc":"Heartbeat","path":"/axon.v1.ControlPlane/Heartbeat","shape":"unary","proto":"control.proto"}
+//   ]
+// }
+char *axon_dendrite_protocol_catalog_json(void);
+
+// Generic protocol helper: invoke any cataloged RPC by path or service/rpc.
+// input JSON:
+// {
+//   "service":"ControlPlane",
+//   "rpc":"Heartbeat",
+//   "path":"/axon.v1.ControlPlane/Heartbeat",
+//   "request_base64":"...",
+//   "request_chunks_base64":["..."],
+//   "metadata":{"x-foo":"bar"},
+//   "timeout_ms":1000,
+//   "max_chunks":64,
+//   "max_request_chunks":64,
+//   "max_response_chunks":64
+// }
+char *axon_dendrite_invoke_protocol_json(uint64_t handle,
+                                         const char *request_json);
+
+// Control helper: list nodes for a tenant.
+// input JSON:
+// {"tenant_id":"tenant-test","owner_id":"user.alice"}
+char *axon_dendrite_list_nodes_json(uint64_t handle, const char *request_json);
+
+// Control helper: register a node in tenant scope.
+// input JSON:
+// {"tenant_id":"tenant-test","node_id":"node-a","display_name":"Node A"}
+char *axon_dendrite_register_node_json(uint64_t handle,
+                                       const char *request_json);
+
+// Control helper: send heartbeat for a node.
+// input JSON:
+// {"tenant_id":"tenant-test","node_id":"node-a"}
+char *axon_dendrite_heartbeat_json(uint64_t handle, const char *request_json);
+
+// Capability helper: publish package metadata into registry.
+// input JSON:
+// {
+//   "tenant_id":"tenant-test",
+//   "package_id":"pkg.desktop_camera",
+//   "capability_name":"desktop_camera",
+//   "version":"1.0.0",
+//   "digest":"sha256:desktop-camera",
+//   "signature_base64":"__AXON_EPHEMERAL_DO_NOT_USE_IN_PROD__",
+//   "metadata":{"a2a.skill_id":"take_photo"}
+// }
+char *axon_dendrite_publish_capability_json(uint64_t handle,
+                                            const char *request_json);
+
+// Capability helper: install package on node.
+// input JSON:
+// {"tenant_id":"tenant-test","node_id":"node-a","package_id":"pkg.desktop_camera","version":"1.0.0","digest":"sha256:desktop-camera"}
+char *axon_dendrite_install_capability_json(uint64_t handle,
+                                            const char *request_json);
+
+// Capability helper: activate install on node.
+// input JSON:
+// {"tenant_id":"tenant-test","node_id":"node-a","install_id":"install-..."}
+char *axon_dendrite_activate_capability_json(uint64_t handle,
+                                             const char *request_json);
+
+// A2A helper: list agents.
+// input JSON:
+// {"tenant_id":"tenant-test","tags":["camera"],"owner_id":"","limit":100}
+char *axon_dendrite_list_a2a_agents_json(uint64_t handle,
+                                         const char *request_json);
+
+// A2A helper: get card for a node.
+// input JSON:
+// {"tenant_id":"tenant-test","node_id":"desktop-sandbox-01"}
+char *axon_dendrite_get_a2a_agent_card_json(uint64_t handle,
+                                            const char *request_json);
+
+// A2A helper: send task to target agent.
+// input JSON:
+// {
+//   "tenant_id":"tenant-test",
+//   "target_agent_id":"desktop-sandbox-01",
+//   "skill_id":"take_photo",
+//   "input_json":{"camera_id":"front"}
+// }
+char *axon_dendrite_send_a2a_task_json(uint64_t handle,
+                                       const char *request_json);
+
+// Control helper: publish/install/activate and call a selected-node MCP
+// list-dir tool. input JSON:
+// {
+//   "tenant_id":"tenant-test",
+//   "node_id":"node-alice",
+//   "target_path":"/client",
+//   "command_template":"docker exec {node_id} /usr/local/bin/easynet-list-dir-json {path}",
+//   "signature_base64":"__AXON_EPHEMERAL_DO_NOT_USE_IN_PROD__"
+// }
+char *axon_dendrite_deploy_mcp_list_dir_json(uint64_t handle,
+                                             const char *request_json);
+
+// Control helper: list MCP tools.
+// input JSON:
+// {"tenant_id":"tenant-test","name_pattern":"list_*","node_id":"node-alice","tags":["fs"]}
+char *axon_dendrite_list_mcp_tools_json(uint64_t handle,
+                                        const char *request_json);
+
+// Control helper: call MCP tool.
+// input JSON:
+// {"tenant_id":"tenant-test","tool_name":"list_current_dir_node-alice","target_node_id":"node-alice","arguments_json":{}}
+char *axon_dendrite_call_mcp_tool_json(uint64_t handle,
+                                       const char *request_json);
+
+// Control helper: deactivate (optional) and uninstall installed capability.
+// input JSON:
+// {
+//   "tenant_id":"tenant-test",
+//   "node_id":"node-alice",
+//   "install_id":"install-...",
+//   "deactivate_first":true,
+//   "deactivate_reason":"server-managed-uninstall",
+//   "force":false
+// }
+char *axon_dendrite_uninstall_capability_json(uint64_t handle,
+                                              const char *request_json);
+
+// Control helper: optional old-install cleanup + deploy latest MCP list-dir
+// package. input JSON:
+// {
+//   "tenant_id":"tenant-test",
+//   "node_id":"node-alice",
+//   "existing_install_id":"install-...",
+//   "deactivate_old":true,
+//   "uninstall_old":true,
+//   "force_uninstall":false,
+//   "target_path":"/client",
+//   "command_template":"docker exec {node_id} /usr/local/bin/easynet-list-dir-json {path}",
+//   "version":"1.0.1"
+// }
+char *axon_dendrite_update_mcp_list_dir_json(uint64_t handle,
+                                             const char *request_json);
+
+// Control helper: deregister (disconnect) a node.
+// Request: {"tenant_id":"...", "node_id":"...", "reason":"..."}
+char *axon_dendrite_deregister_node_json(uint64_t handle,
+                                         const char *request_json);
+
+// Control helper: drain a node — stop accepting new invocations while
+// finishing in-flight ones.
+// Request: {"tenant_id":"...", "node_id":"...", "reason":"..."}
+char *axon_dendrite_drain_node_json(uint64_t handle,
+                                    const char *request_json);
+
+// Voice helper: create call.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","display_name":"support","participant_limit":2}
+char *axon_dendrite_voice_create_call_json(uint64_t handle,
+                                           const char *request_json);
+
+// Voice helper: get call.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1"}
+char *axon_dendrite_voice_get_call_json(uint64_t handle,
+                                        const char *request_json);
+
+// Voice helper: join call.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","participant_id":"agent-a","node_id":"node-a","transport":2}
+char *axon_dendrite_voice_join_call_json(uint64_t handle,
+                                         const char *request_json);
+
+// Voice helper: leave call.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","participant_id":"agent-a","reason":"left"}
+char *axon_dendrite_voice_leave_call_json(uint64_t handle,
+                                          const char *request_json);
+
+// Voice helper: update media path.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","participant_id":"agent-a","transport":2,"stream_session_id":"vts-1","muted":false}
+char *axon_dendrite_voice_update_media_path_json(uint64_t handle,
+                                                 const char *request_json);
+
+// Voice helper: report metrics.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","participant_id":"agent-a","metrics":{"rtt_ms":120.0,"jitter_ms":15.0,"packet_loss_ratio":0.01}}
+char *axon_dendrite_voice_report_call_metrics_json(uint64_t handle,
+                                                   const char *request_json);
+
+// Voice helper: end call.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","end_reason":1,"detail":"caller_end"}
+char *axon_dendrite_voice_end_call_json(uint64_t handle,
+                                        const char *request_json);
+
+// Voice helper: watch call events.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","from_sequence":0,"max_events":128,"timeout_ms":1500}
+char *axon_dendrite_voice_watch_call_events_json(uint64_t handle,
+                                                 const char *request_json);
+
+// Voice transport helper: create session.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","participant_id":"agent-a","transport":2,"requested_ttl_seconds":60}
+char *axon_dendrite_voice_create_transport_session_json(uint64_t handle,
+                                                        const char *request_json);
+
+// Voice transport helper: get session.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","transport_session_id":"vts-1"}
+char *axon_dendrite_voice_get_transport_session_json(uint64_t handle,
+                                                     const char *request_json);
+
+// Voice transport helper: set description.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","transport_session_id":"vts-1","side":2,"description":{"sdp_type":3,"sdp":"v=0..."}}
+char *axon_dendrite_voice_set_transport_description_json(uint64_t handle,
+                                                         const char *request_json);
+
+// Voice transport helper: add candidate.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","transport_session_id":"vts-1","side":2,"candidate":{"candidate":"candidate:1 ..."}}
+char *axon_dendrite_voice_add_transport_candidate_json(uint64_t handle,
+                                                       const char *request_json);
+
+// Voice transport helper: refresh lease.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","transport_session_id":"vts-1","requested_ttl_seconds":120}
+char *axon_dendrite_voice_refresh_transport_lease_json(uint64_t handle,
+                                                       const char *request_json);
+
+// Voice transport helper: end session.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","transport_session_id":"vts-1","failed":false,"reason":"completed"}
+char *axon_dendrite_voice_end_transport_session_json(uint64_t handle,
+                                                     const char *request_json);
+
+// Voice transport helper: watch events.
+// input JSON:
+// {"tenant_id":"tenant-test","call_id":"call-1","transport_session_id":"vts-1","from_sequence":0,"max_events":128,"timeout_ms":1500}
+char *axon_dendrite_voice_watch_transport_events_json(uint64_t handle,
+                                                      const char *request_json);
+
+// ---------------------------------------------------------------------------
+// Incremental streaming API (pull model)
+// ---------------------------------------------------------------------------
+
+// Opens a server-streaming gRPC call and returns a stream handle for
+// incremental chunk retrieval via stream_next.
+// input JSON:
+// {
+//   "path":"/axon.v1.Invocation/WatchInvocation",
+//   "request_base64":"...",
+//   "metadata":{"x-foo":"bar"},
+//   "timeout_ms":10000,
+//   "chunk_timeout_ms":30000,
+//   "chunk_buffer_size":64
+// }
+// output JSON:
+// {"ok":true,"stream_handle":1,"path":"/axon.v1.Invocation/WatchInvocation"}
+char *axon_dendrite_server_stream_open_json(uint64_t handle,
+                                            const char *request_json);
+
+// Pulls the next chunk from an open stream (server-stream or bidi-stream).
+// input JSON (optional):
+// {"timeout_ms":30000}
+// output JSON (chunk available):
+// {"ok":true,"done":false,"chunk_base64":"...","chunk_bytes":123}
+// output JSON (stream completed):
+// {"ok":true,"done":true}
+// output JSON (timeout, stream still open):
+// {"ok":true,"done":false,"timeout":true}
+char *axon_dendrite_stream_next_json(uint64_t stream_handle,
+                                     const char *request_json);
+
+// Closes an open stream handle, aborting the background task if still running.
+// output JSON: {"ok":true,"removed":true}
+char *axon_dendrite_stream_close_json(uint64_t stream_handle);
+
+// Opens a bidi-streaming gRPC call. Returns a stream handle for both
+// sending request chunks (via bidi_stream_send) and receiving response
+// chunks (via stream_next).
+// input JSON:
+// {
+//   "path":"/axon.v1.Stream/OpenStream",
+//   "request_base64":"...",
+//   "request_chunks_base64":["..."],
+//   "metadata":{"x-foo":"bar"},
+//   "timeout_ms":10000,
+//   "chunk_timeout_ms":30000,
+//   "chunk_buffer_size":64,
+//   "request_buffer_size":64
+// }
+// output JSON:
+// {"ok":true,"stream_handle":1,"path":"/axon.v1.Stream/OpenStream"}
+char *axon_dendrite_bidi_stream_open_json(uint64_t handle,
+                                          const char *request_json);
+
+// Sends a request chunk on an open bidi-stream.
+// input JSON:
+// {"chunk_base64":"..."}
+// or to close the request side while continuing to receive:
+// {"done":true}
+// output JSON when sending a chunk: {"ok":true,"sent":true}
+// output JSON when closing the request side:
+// {"ok":true,"sent":false,"done":true,"request_stream_closed":true}
+char *axon_dendrite_bidi_stream_send_json(uint64_t stream_handle,
+                                          const char *request_json);
+
+// Returns protocol coverage descriptor JSON.
+char *axon_dendrite_protocol_coverage_json(void);
+
+// Frees memory returned by bridge APIs.
+void axon_dendrite_string_free(char *s);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // AXON_DENDRITE_BRIDGE_H