Temporal Cloud Integration

Temporal Cloud is the backbone of Steadybase's workflow execution. All durable workflows — from client onboarding to Drew Coordinator — run on Temporal Cloud.

What Temporal Cloud Provides

Durable Execution — Workflows survive crashes, retries, and restarts
State Persistence — Workflow state is maintained across long-running operations
Signal/Query Model — Human-in-the-loop via signals, state inspection via queries
Full Observability — Every workflow execution has a complete event history
SOC 2 Type II — Temporal Cloud is SOC 2 certified

Setup

1. Create a Temporal Cloud Account

2. Generate mTLS Certificates

Temporal Cloud uses mutual TLS for authentication:

# Generate a CA certificate and key
openssl req -new -x509 -days 365 -keyout ca.key -out ca.pem
 
# Generate a client certificate
openssl req -new -keyout client.key -out client.csr
openssl x509 -req -in client.csr -CA ca.pem -CAkey ca.key -CAcreateserial -out client.pem -days 365

Upload the CA certificate to your Temporal Cloud namespace.

3. Configure Environment Variables

# Temporal Cloud connection
TEMPORAL_ADDRESS=us-west-2.aws.api.temporal.io:7233
TEMPORAL_NAMESPACE=your-namespace.xxxxx
TEMPORAL_TASK_QUEUE=steadybase-gtm
 
# mTLS certificates (Base64-encoded or file paths)
TEMPORAL_TLS_CERT=/path/to/client.pem
TEMPORAL_TLS_KEY=/path/to/client.key
 
# Or as Base64
TEMPORAL_TLS_CERT=LS0tLS1CRUdJTi...
TEMPORAL_TLS_KEY=LS0tLS1CRUdJTi...

4. Start the Worker

The Temporal worker process polls the task queue and executes workflow/activity code:

npm run worker

Connection Code

import { Connection, Client } from '@temporalio/client';
 
const connection = await Connection.connect({
  address: process.env.TEMPORAL_ADDRESS,
  tls: {
    clientCertPair: {
      crt: Buffer.from(process.env.TEMPORAL_TLS_CERT, 'base64'),
      key: Buffer.from(process.env.TEMPORAL_TLS_KEY, 'base64'),
    },
  },
});
 
const client = new Client({
  connection,
  namespace: process.env.TEMPORAL_NAMESPACE,
});

Registered Workflows

Workflow	Task Queue	Description
`clientOnboarding`	`steadybase-gtm`	5-step client onboarding
`leadQualification`	`steadybase-gtm`	Lead scoring and routing
`contentGeneration`	`steadybase-gtm`	Content creation with memory
`ticketResolution`	`steadybase-gtm`	Ticket analysis + SLA tracking
`memoryStore`	`steadybase-gtm`	Long-running durable KV store
`drewCoordinator`	`steadybase-gtm`	9-step multi-agent orchestration

Namespace Details

Setting	Value
Namespace	`quickstart-steadybase`
Region	us-west-2
Authentication	mTLS (client certificate)
Task Queue	`steadybase-gtm`
Retention	Configured per namespace in Temporal Cloud

If Temporal Cloud is not configured (missing TEMPORAL_ADDRESS), Steadybase falls back to demo mode with simulated workers and workflows. This allows exploring the UI and API without a Temporal Cloud connection.

Temporal Cloud