trpc-execution

Orchestrates ChainGraph flow executions via tRPC APIs with lifecycle management and real-time event streaming.

15|3|Updated Apr 29, 2025
One-click install
npx skills add https://github.com/chaingraphlabs/chaingraph --skill trpc-execution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trpc-execution
Source: https://github.com/chaingraphlabs/chaingraph/tree/main/.claude/skills/trpc-execution
Command: npx skills add https://github.com/chaingraphlabs/chaingraph --skill trpc-execution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ChainGraph requires a robust, scalable way to manage flow executions, including lifecycle operations and real-time event streaming, all through a consistent API surface.

Core Features & Use Cases

  • tRPC-based execution control: create, start, pause, resume, stop, and subscribe to execution events.
  • Signal-pattern synchronization: ensures the workflow begins only after the event stream is ready, preventing race conditions.
  • Dual deployment modes: API mode (external DBOS client) and Worker mode (local DBOS runtime) for flexible architectures.
  • Real-time event streaming: observe execution progress via event subscriptions integrated with the executor.

Quick Start

Create an execution for a flow with the create procedure, then start it with the returned executionId, and subscribe to execution events to monitor progress.

Frequently Asked Questions about trpc-execution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage workflow execution lifecycle with tRPC?

tRPC orchestrates ChainGraph flow executions by providing APIs for creation, lifecycle management, and real-time event streaming to ensure reliable synchronization between workflow start and event streams.

How does event streaming synchronization prevent race conditions in workflow execution?

Event streaming synchronization uses a signal-pattern to ensure the workflow begins only after the event stream is ready, effectively preventing race conditions during execution startup.

Can I deploy ChainGraph execution management in both API and Worker modes?

Yes, ChainGraph execution management supports dual deployment modes: API mode for external DBOS clients and Worker mode for local DBOS runtimes, enabling flexible architecture choices.

What is the best way to monitor real-time execution progress via tRPC?

The best way to monitor real-time execution progress via tRPC is to subscribe to execution events after starting a flow, observing progress through event subscriptions integrated with the executor.

Do I need DBOS to run ChainGraph flow executions?

Yes, DBOS is required to run ChainGraph flow executions, operating either as an external client in API mode or as a local runtime in Worker mode for reliable execution management.

How do I start a ChainGraph flow execution step by step?

To start a ChainGraph flow execution, create an execution using the create procedure, start it with the returned executionId, and subscribe to execution events to monitor real-time progress.