Breaking Changes

Version 0.71.2 (Current Release)

Configuration Changes

Execution Mode:

• STAQR_EXECUTION_MODE=SANDBOXED deprecated → Use SANDBOX_PROCESS instead
• STAQR_CODE_SANDBOX_TYPE deprecated → Use STAQR_EXECUTION_MODE

Redis & Queueing:

• STAQR_QUEUE_MODE deprecated → Use STAQR_REDIS_TYPE
• For Sentinel HA: Set STAQR_REDIS_TYPE=SENTINEL
• Separate workers now require Redis access (update firewall/network rules)

Worker Concurrency:

• STAQR_FLOW_WORKER_CONCURRENCY deprecated
• STAQR_SCHEDULED_WORKER_CONCURRENCY deprecated
• Use unified STAQR_WORKER_CONCURRENCY setting

Timeouts:

• STAQR_SANDBOX_RUN_TIME_SECONDS deprecated → Use STAQR_FLOW_TIMEOUT_SECONDS

Authentication & Multi-Tenancy

Roles (Seller Members):

• EXTERNAL_CUSTOMER role removed → Use OPERATOR role instead
• User invitation system required for new members
• Pending invitations from pre-0.28 versions removed

Sign-up Changes:

• SIGN_UP_ENABLED environment variable removed
• Use invitation API for adding users to sellers/platforms
• Existing users and platforms continue working

API Updates

Connections:

• AppConnection.name → Renamed to AppConnection.externalId
• Added new AppConnection.displayName field

Files:

• Trigger files now passed as file paths (stored in DB/S3)
• Previously: base64 encoded strings
• Action required: Paused flows from v0.29.0 or earlier may fail

Flow Engine:

• All branches converted to routers (no downgrade path)
• File storage subject to STAQR_MAX_FILE_SIZE_MB limit

Deprecated Features

Code Copilot:

• Removed in 0.71.0
• Will be reintroduced with enhanced capabilities in future release

Embedding SDK:

• embedding.dashboard.hideSidebar (v0.66) → Use embedding.dashboard.hideFlowsPageNavbar
• MCP management removed from SDK (v0.64)

AI Models:

• Replicate text models removed (v0.63)
• Use alternative providers: OpenAI, Anthropic, Azure OpenAI

Migration Guide

Step 1: Update environment variables

# Replace deprecated variables in .env
STAQR_EXECUTION_MODE=SANDBOX_PROCESS
STAQR_REDIS_TYPE=SENTINEL  # If using Sentinel
STAQR_WORKER_CONCURRENCY=10
STAQR_FLOW_TIMEOUT_SECONDS=600

Step 2: Update API integrations

// Update connection references
const connection = {
  externalId: "conn-123",    // Was: name
  displayName: "Production DB",  // New required field
  // ...
}

Step 3: Verify worker configuration

# Ensure workers can access Redis
docker exec worker-1 redis-cli -h redis-host ping
# Expected: PONG

Step 4: Test flows with file handling

• Verify paused flows resume correctly
• Check file size limits (STAQR_MAX_FILE_SIZE_MB)
• Validate S3/database storage capacity

Version Support

Version	Support Status	Notes
0.71.x	Current	Full support
0.70.x	Security fixes only	Upgrade recommended
< 0.70.0	Unsupported	Upgrade required

For upgrade assistance, consult the installation documentation or contact support.