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

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

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.