librpc

librpc——用于微服务的 gRPC 框架。RpcServer 与 RpcClient 提供基础类。loadProto 可加载 Protocol Buffers 定义。createClientFactory 可构建类型化的服务客户端。hmacAuth 提供认证支持。createTracer 可启用分布式追踪。适用于服务间通信、gRPC 服务的构建，以及服务客户端的创建。

name: librpc description: > librpc - gRPC framework for microservices. RpcServer and RpcClient provide base classes. loadProto loads protobuf definitions. createClientFactory builds typed service clients. hmacAuth provides authentication support. createTracer enables distributed tracing. Use for inter-service communication, building gRPC services, and service client creation.

librpc Skill

When to Use

•Building gRPC service implementations
•Creating clients for inter-service calls
•Adding authentication to gRPC endpoints
•Implementing distributed tracing across services

Key Concepts

RpcServer: Base server class for gRPC services with middleware support.

RpcClient: Base client class with connection management and error handling.

createClientFactory: Factory that creates typed service clients with optional logging and tracing.

Usage Patterns

Pattern 1: Create service server

javascript

import { RpcServer, createService } from "@copilot-ld/librpc";

const service = createService(MyServiceImpl, proto);
const server = new RpcServer([service], config);
await server.start();

Pattern 2: Create service client

javascript

import { createClientFactory } from "@copilot-ld/librpc";

const factory = createClientFactory(logger, tracer);
const agentClient = factory.createAgentClient("localhost", 50051);
const response = await agentClient.request(message);

Integration

Used by all services for gRPC communication. Works with libtype for message types.