trebuchet

Use this agent when working with Trebuchet distributed actors, deploying to cloud platforms, implementing streaming state, or integrating with SwiftUI. This agent should be used proactively when analyzing Trebuchet code, answering Trebuchet-related questions, or helping with actor system design and deployment. The agent has deep expertise in the Trebuchet framework, AWS Lambda deployment, Fly.io deployment, and real-time state synchronization patterns. Examples: <example> Context: User asks about distributed actors user: "How do I create a distributed actor in Trebuchet?" assistant: "I'll use the Task tool to launch the trebuchet-expert agent to help you set up distributed actors." <commentary> The trebuchet-expert should handle questions about Trebuchet framework features and implementation. </commentary> </example> <example> Context: User wants to deploy actors user: "Deploy my actors to AWS Lambda" assistant: "I'll use the Task tool to launch the trebuchet-expert agent to guide the deployment process." <commentary> The trebuchet-expert handles cloud deployment workflows including AWS and Fly.io. </commentary> </example> <example> Context: User is implementing streaming user: "Add real-time state streaming to my actor" assistant: "I'll use the Task tool to launch the trebuchet-expert agent to implement streaming state with @StreamedState." <commentary> The trebuchet-expert specializes in @StreamedState and SwiftUI integration patterns. </commentary> </example>

AWS Lambda deployment with trebuchet CLI, DynamoDB state storage, CloudMap service discovery, WebSocket streaming via API Gateway, Lambda handler implementation, connection management, cost optimization, and production configuration. Use when deploying to AWS or implementing WebSocket realtime features.

Trebuchet CLI commands for initializing projects, deploying actors, checking status, local development, and infrastructure management. Use when users need to deploy, configure, or manage Trebuchet projects from the command line.

Serverless deployment architecture with CloudGateway, CloudProvider abstraction, ServiceRegistry, ActorStateStore, and local development setup. Use when users need to understand cloud deployment concepts or deploy actors to serverless platforms.

Best practices for defining distributed actors with @Trebuchet macro, method requirements, stateful actors, annotations, and error handling. Use when users need help structuring actors, managing state persistence, or understanding actor deployment configuration.

Installation, setup, and basic usage of Trebuchet distributed actors. Use when users need help starting a new Trebuchet project, creating their first actor, or understanding the fundamental server/client pattern.

Production-grade observability with structured logging, metrics collection (counters, gauges, histograms), distributed tracing, CloudWatch integration, and sensitive data redaction. Use when monitoring actors, debugging issues, or tracking performance in production.

Production-grade security with authentication (API keys, JWT), authorization (RBAC), rate limiting (token bucket, sliding window), request validation, and middleware integration. Use when securing actors, implementing access control, or preventing abuse.

Real-time state streaming with @StreamedState, @ObservedActor, stream resumption, filtering, and delta encoding. Use when users need automatic state synchronization, reactive UI updates, or bandwidth optimization for large state objects.

SwiftUI integration with observable connections, @RemoteActor property wrapper, connection state management, multi-server scenarios, and reconnection policies. Use when building reactive SwiftUI apps that connect to distributed actors with automatic reconnection and state updates.