feat(export): Add workflow export as standalone Python/FastAPI service

[aadamsx]

Summary

Adds the ability to export Sim Studio workflows as standalone, self-contained Python services that can be deployed independently via Docker, Railway, or any container platform.

Features

Multi-Provider LLM Support

• Anthropic: Claude 3/4 models (Opus, Sonnet, Haiku)
• OpenAI: GPT-4, GPT-4o, o1, o3 models
• Google: Gemini Pro, Gemini Flash models
• Automatic provider detection from model name
• Provider-specific API key environment variables

Supported Block Types

• Start/Trigger blocks
• Agent blocks (with multi-provider support)
• Function blocks (JavaScript transpiled to Python)
• Condition/Router blocks
• API blocks (HTTP requests)
• Loop blocks (for, forEach, while, doWhile)
• Variables blocks
• Response blocks

Export Validation

• Pre-export validation for unsupported block types
• Pre-export validation for unsupported providers
• Clear error messages shown to users via notification system
• Prevents silent failures with actionable feedback

Security

• No eval(): All condition evaluation uses safe AST-based parsing
• No shell=True: Commands executed without shell to prevent injection
• File operations sandboxed to WORKSPACE_DIR
• Shell operators rejected with clear error messages

Production Features

• FastAPI server with /execute, /health, /ready endpoints
• Rate limiting (configurable, default 60 req/min)
• Request size limits (configurable, default 10MB)
• Automatic retry with exponential backoff
• MCP tool support via official Python SDK
• Docker and docker-compose configuration
• Environment variable management (.env, .env.example)

UI Integration

• "Export as Service" context menu option
• Single workflow export only (no bulk)
• Error notifications via existing notification system
• Uses ref pattern to avoid stale closure issues

Files Changed

• apps/sim/app/api/workflows/[id]/export-service/route.ts - API endpoint
• apps/sim/app/api/workflows/[id]/export-service/route.test.ts - 13 unit tests
• apps/sim/app/workspace/.../hooks/use-export-service.ts - React hook
• apps/sim/app/workspace/.../context-menu/context-menu.tsx - UI menu
• apps/sim/app/workspace/.../workflow-item/workflow-item.tsx - UI wiring

Testing

cd apps/sim && bun run vitest run "export-service"
# 13 tests passing

Usage

1. Right-click workflow in sidebar
2. Select "Export as Service"
3. Extract ZIP and configure .env with API keys
4. Run: docker compose up or uvicorn main:app
5. Call: POST /execute with workflow inputs

[vercel]

@aadamsx is attempting to deploy a commit to the Sim Team on Vercel.

A member of the Team first needs to authorize it.

[greptile-apps]

Greptile Summary

This PR adds workflow export as standalone Python/FastAPI services. The implementation includes pre-export validation for unsupported block types and providers, JavaScript-to-Python transpilation, and comprehensive ZIP generation with all necessary runtime files.

Key Changes:

• API endpoint (route.ts) validates workflows, transpiles JS function blocks to Python, and generates deployable service ZIP with FastAPI server, executor, Docker config, and environment files
• React hook (use-export-service.ts) properly uses refs to avoid stale closures and integrates with notification system
• UI integration adds "Export as Service" to context menu for single workflow selection
• 13 comprehensive tests cover authentication, validation, provider detection, and error handling

Architecture:

• Follows established patterns: proper import aliases, hook structure with refs for stable dependencies, TSDoc documentation
• Security-conscious: no eval(), AST-based condition parsing, sandboxed file operations in exported Python code
• Good error handling with user-facing notifications for validation failures

Minor Observations:

• The 2799-line route file is very large and contains embedded Python code as template strings, which is appropriate for this use case but makes the file substantial

Confidence Score: 4/5

• This PR is safe to merge with minimal risk
• Well-tested feature with comprehensive validation, proper error handling, and security measures. The code follows project patterns and includes 13 passing tests. The large route file is justified by embedded Python templates. Minor score reduction only due to the complexity and size of the implementation.
• No files require special attention

Important Files Changed

Filename	Overview
apps/sim/app/api/workflows/[id]/export-service/route.ts	Adds API endpoint to export workflows as standalone Python/FastAPI services with validation, transpilation, and ZIP generation
apps/sim/app/workspace/[workspaceId]/w/hooks/use-export-service.ts	React hook for exporting workflows with proper ref usage to avoid stale closures, error handling, and notification integration
apps/sim/app/workspace/[workspaceId]/w/components/sidebar/components/workflow-list/components/workflow-item/workflow-item.tsx	Integrates export service hook with workflow item, wires up context menu handler for single workflow exports

Sequence Diagram

sequenceDiagram
    participant User
    participant UI as WorkflowItem
    participant Hook as useExportService
    participant API as /api/workflows/[id]/export-service
    participant DB as Database
    participant Validator as Workflow Validator
    participant Transpiler as JS→Python Transpiler
    participant ZipGen as ZIP Generator

    User->>UI: Right-click workflow
    UI->>UI: Show context menu
    User->>UI: Click "Export as Service"
    UI->>Hook: handleExportService()
    Hook->>Hook: Check isExportingRef
    Hook->>Hook: setIsExporting(true)
    
    Hook->>API: GET /api/workflows/{id}/export-service
    API->>API: Authenticate user/API key
    API->>DB: Query workflow by ID
    DB-->>API: Return workflow data
    API->>API: Fetch workflow state & variables
    
    API->>Validator: validateWorkflowForExport(state)
    Validator->>Validator: Check block types
    Validator->>Validator: Check provider support
    
    alt Has unsupported blocks/providers
        Validator-->>API: Return validation errors
        API-->>Hook: 400 with error details
        Hook->>Hook: addNotification(error)
        Hook->>Hook: setIsExporting(false)
        Hook-->>User: Show error notification
    else Validation passes
        Validator-->>API: Valid workflow
        API->>Transpiler: preTranspileWorkflow(state)
        Transpiler->>Transpiler: Convert JS blocks to Python
        Transpiler-->>API: Transpiled workflow
        
        API->>ZipGen: Generate service ZIP
        ZipGen->>ZipGen: Create workflow.json
        ZipGen->>ZipGen: Create .env with API keys
        ZipGen->>ZipGen: Add Python executor files
        ZipGen->>ZipGen: Add Dockerfile & docker-compose
        ZipGen->>ZipGen: Add README.md
        ZipGen-->>API: ZIP buffer
        
        API-->>Hook: 200 with ZIP file
        Hook->>Hook: Create blob & download link
        Hook->>Hook: Trigger browser download
        Hook->>Hook: setIsExporting(false)
        Hook->>Hook: onSuccess?.()
        Hook-->>User: Download workflow-service.zip
    end

Loading