feat: Lago billing, i18n (ru/de), and universal-integrator tool generator

.devcontainer/README.md

@@ -43,7 +43,7 @@ sim-start  # Runs both app and socket server using concurrently
 
 **Build errors**: Rebuild the container with `F1` → "Dev Containers: Rebuild Container"
 
-**Port conflicts**: Ensure ports 3000, 3002, and 5432 are available
+**Port conflicts**: Ensure ports 3000 (app), 3002 (realtime), 3003 (docs), and 5432 (postgres) are available
 
 **Container runtime issues**: Verify Docker Desktop or Podman Desktop is running
 

.devcontainer/devcontainer.json

@@ -29,7 +29,7 @@
     }
   },
 
-  "forwardPorts": [3000, 3002, 5432],
+  "forwardPorts": [3000, 3002, 3003, 5432],
 
   "postCreateCommand": "bash -c 'bash .devcontainer/post-create.sh || true'",
 

.devcontainer/docker-compose.yml

@@ -11,26 +11,20 @@ services:
       resources:
         limits:
           memory: 8G
+    # Secrets and app config come from apps/sim/.env (single source of truth).
+    # Only container-network/infra values are set here.
     environment:
       - NODE_ENV=development
       - DATABASE_URL=postgresql://postgres:postgres@db:5432/simstudio
-      - BETTER_AUTH_URL=http://localhost:3000
-      - NEXT_PUBLIC_APP_URL=http://localhost:3000
-      - BETTER_AUTH_SECRET=${BETTER_AUTH_SECRET:-your_auth_secret_here}
-      - ENCRYPTION_KEY=${ENCRYPTION_KEY:-your_encryption_key_here}
-      - COPILOT_API_KEY=${COPILOT_API_KEY}
-      - SIM_AGENT_API_URL=${SIM_AGENT_API_URL}
-      - OLLAMA_URL=${OLLAMA_URL:-http://localhost:11434}
-      - NEXT_PUBLIC_SOCKET_URL=${NEXT_PUBLIC_SOCKET_URL:-}
       - BUN_INSTALL_CACHE_DIR=/home/bun/.bun/cache
     depends_on:
       db:
         condition: service_healthy
       migrations:
         condition: service_completed_successfully
     ports:
-      - "3000:3000"
-      - "3001:3001"
+      - "12000:3000"
+      - "12009:3003"
     working_dir: /workspace
 
   realtime:
@@ -45,17 +39,15 @@ services:
       resources:
         limits:
           memory: 1G
+    # Secrets and app config come from apps/realtime/.env (single source of truth).
     environment:
       - NODE_ENV=development
       - DATABASE_URL=postgresql://postgres:postgres@db:5432/simstudio
-      - BETTER_AUTH_URL=http://localhost:3000
-      - NEXT_PUBLIC_APP_URL=http://localhost:3000
-      - BETTER_AUTH_SECRET=${BETTER_AUTH_SECRET:-your_auth_secret_here}
     depends_on:
       db:
         condition: service_healthy
     ports:
-      - "3002:3002"
+      - "12001:3002"
     working_dir: /workspace
 
   migrations:
@@ -80,7 +72,7 @@ services:
       - POSTGRES_PASSWORD=postgres
       - POSTGRES_DB=simstudio
     ports:
-      - "${POSTGRES_PORT:-5432}:5432"
+      - "${POSTGRES_PORT:-12002}:5432"
     healthcheck:
       test: ["CMD-SHELL", "pg_isready -U postgres"]
       interval: 5s

.editorconfig

@@ -0,0 +1,19 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+max_line_length = 100
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.mdx]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

.env.saas.example

@@ -0,0 +1,42 @@
+# Sim SaaS — AAC Billing Lago stack (/Users/aac/aac-billing/lago)
+# Quick start: ./scripts/lago/setup-saas-env.sh
+
+# --- Core ---
+DATABASE_URL=postgresql://postgres:postgres@localhost:12002/simstudio
+BETTER_AUTH_SECRET=replace-with-openssl-rand-hex-32
+BETTER_AUTH_URL=http://localhost:12000
+NEXT_PUBLIC_APP_URL=http://localhost:12000
+NEXT_PUBLIC_SOCKET_URL=http://localhost:12001
+ENCRYPTION_KEY=replace-with-openssl-rand-hex-32
+INTERNAL_API_SECRET=replace-with-openssl-rand-hex-32
+API_ENCRYPTION_KEY=replace-with-openssl-rand-hex-32
+REDIS_URL=redis://localhost:6379
+
+# --- SaaS billing (AAC Billing Lago — aacworkflow org) ---
+BILLING_ENABLED=true
+NEXT_PUBLIC_BILLING_ENABLED=true
+BILLING_PROVIDER=lago
+NEXT_PUBLIC_BILLING_PROVIDER=lago
+
+# AAC Billing Lago API (docker in ~/aac-billing/lago, port 6100)
+LAGO_API_URL=http://localhost:6100
+LAGO_API_KEY=cfdbe9a0-0fa6-4d7b-961c-8d66f26c9e3a
+LAGO_PRODUCT_SLUG=aacworkflow
+LAGO_WEBHOOK_SECRET=
+
+LAGO_BILLABLE_METRIC_CODE=llm_cost
+LAGO_PLAN_FREE=aacworkflow_free
+LAGO_PLAN_PRO_6000=sim_pro_6000
+LAGO_PLAN_PRO_25000=sim_pro_25000
+LAGO_PLAN_TEAM_6000=sim_team_6000
+LAGO_PLAN_TEAM_25000=sim_team_25000
+LAGO_PLAN_ENTERPRISE=sim_enterprise
+
+FREE_TIER_COST_LIMIT=5
+
+PLATFORM_ADMIN_EMAILS=info@aacflow.io
+
+# Lago UI: http://localhost:6001 (login: aachibilyaev@gmail.com / LagoAdmin2026!)
+# Tier plans: LAGO_API_KEY=... ./scripts/lago/bootstrap-plans.sh
+# Webhook in Lago admin: POST http://localhost:12000/api/billing/lago/webhook
+# Prerequisite: cd ~/aac-billing/lago && docker compose up -d

.github/CONTRIBUTING.md

@@ -147,7 +147,7 @@ The easiest way to run Sim locally is using our NPM package:
 npx simstudio
 ```
 
-After running this command, open [http://localhost:3000/](http://localhost:3000/) in your browser.
+After running this command, open [http://localhost:12000/](http://localhost:12000/) in your browser.
 
 #### Options
 
@@ -169,7 +169,7 @@ cd sim
 docker compose -f docker-compose.prod.yml up -d
 ```
 
-Access the application at [http://localhost:3000/](http://localhost:3000/)
+Access the application at [http://localhost:12000/](http://localhost:12000/)
 
 #### Using Local Models
 
@@ -290,8 +290,8 @@ If you prefer not to use Docker or Dev Containers. **All commands run from the r
 
    This launches both apps with coloured prefixes:
 
-   - `[App]` — Next.js on `http://localhost:3000`
-   - `[Realtime]` — Socket.IO on `http://localhost:3002`
+   - `[App]` — Next.js on `http://localhost:12000`
+   - `[Realtime]` — Socket.IO on `http://localhost:12001`
 
    Or run them separately:
 
@@ -322,7 +322,7 @@ When working on email templates, you can preview them using a local email previe
 
 2. **Access the Preview:**
 
-   - Open `http://localhost:3000` in your browser.
+   - Open `http://localhost:12000` in your browser.
    - You'll see a list of all email templates.
    - Click on any template to view and test it with various parameters.
 

.github/workflows/test-build.yml

@@ -154,7 +154,7 @@ jobs:
         env:
           NODE_OPTIONS: '--no-warnings --max-old-space-size=8192'
           NEXT_PUBLIC_APP_URL: 'https://www.sim.ai'
-          DATABASE_URL: 'postgresql://postgres:postgres@localhost:5432/simstudio'
+          DATABASE_URL: 'postgresql://postgres:postgres@localhost:12002/simstudio'
           ENCRYPTION_KEY: '7cf672e460e430c1fba707575c2b0e2ad5a99dddf9b7b7e3b5646e630861db1c' # dummy key for CI only
           TURBO_CACHE_DIR: .turbo
         run: bun run test
@@ -238,7 +238,7 @@ jobs:
         env:
           NODE_OPTIONS: '--no-warnings --max-old-space-size=8192'
           NEXT_PUBLIC_APP_URL: 'https://www.sim.ai'
-          DATABASE_URL: 'postgresql://postgres:postgres@localhost:5432/simstudio'
+          DATABASE_URL: 'postgresql://postgres:postgres@localhost:12002/simstudio'
           STRIPE_SECRET_KEY: 'dummy_key_for_ci_only'
           STRIPE_WEBHOOK_SECRET: 'dummy_secret_for_ci_only'
           RESEND_API_KEY: 'dummy_key_for_ci_only'

.gitignore

@@ -22,7 +22,9 @@ package-lock.json
 # next.js
 /.next/
 /apps/**/out/
+/apps/**/.next
 /apps/**/.next/
+/apps/**/.next.slowfs.old/
 /apps/**/build
 
 # production
@@ -42,6 +44,9 @@ dump.rdb
 # env files
 .env
 *.env
+.env.*
+!.env.example
+!.env.*.example
 .env.local
 .env.development
 .env.test
@@ -78,8 +83,12 @@ start-collector.sh
 # Turborepo
 .turbo
 
-# VSCode
-.vscode
+# VSCode / Cursor workspace defaults (commit shared config; ignore local overrides)
+.vscode/*
+!.vscode/settings.json
+!.vscode/extensions.json
+!.vscode/tasks.json
+!.vscode/launch.json
 
 # IntelliJ
 .idea
@@ -88,11 +97,29 @@ start-collector.sh
 helm/sim/test
 i18n.cache
 
-## Claude Code
+## Claude Code (ignore local state; commands/rules/skills stay tracked)
+.claude.json
+.claude/.credentials.json
+.claude/settings.json
 .claude/launch.json
+.claude/history.jsonl
 .claude/worktrees/
+.claude/backups/
+.claude/cache/
+.claude/file-history/
+.claude/plugins/
+.claude/projects/
 .claude/scheduled_tasks.lock
+.deepseek/
 .deepsec/
+.leankg/
+.omo/
+
+# Local caches & machine-specific dirs
+.bun/
+.cache/
+.config/
+.local/
 
 # Personal Cursor Skills
 .cursor/skills/ask-sim/

.omo/run-continuation/ses_0f5aec08dffezresGQUDF34QFR.json

@@ -0,0 +1,10 @@
+{
+  "sessionID": "ses_0f5aec08dffezresGQUDF34QFR",
+  "updatedAt": "2026-06-27T18:25:34.683Z",
+  "sources": {
+    "background-task": {
+      "state": "idle",
+      "updatedAt": "2026-06-27T18:25:34.683Z"
+    }
+  }
+}

.vscode/extensions.json

@@ -0,0 +1,17 @@
+{
+  "recommendations": [
+    "anysphere.remote-containers",
+    "ms-azuretools.vscode-containers",
+    "biomejs.biome",
+    "oven.bun-vscode",
+    "bradlc.vscode-tailwindcss",
+    "mikestead.dotenv",
+    "dsznajder.es7-react-js-snippets",
+    "vitest.explorer"
+  ],
+  "unwantedRecommendations": [
+    "esbenp.prettier-vscode",
+    "ms-vscode-remote.remote-containers",
+    "ms-azuretools.vscode-docker"
+  ]
+}

.vscode/launch.json

@@ -0,0 +1,42 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Sim: Next.js dev",
+      "type": "node",
+      "request": "launch",
+      "runtimeExecutable": "bun",
+      "runtimeArgs": ["run", "dev"],
+      "cwd": "${workspaceFolder}/apps/sim",
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"]
+    },
+    {
+      "name": "Realtime: dev server",
+      "type": "node",
+      "request": "launch",
+      "runtimeExecutable": "bun",
+      "runtimeArgs": ["run", "dev"],
+      "cwd": "${workspaceFolder}/apps/realtime",
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"]
+    },
+    {
+      "name": "Vitest: current file",
+      "type": "node",
+      "request": "launch",
+      "runtimeExecutable": "bun",
+      "runtimeArgs": ["x", "vitest", "run", "${relativeFile}"],
+      "cwd": "${workspaceFolder}/apps/sim",
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"]
+    }
+  ],
+  "compounds": [
+    {
+      "name": "Sim + Realtime",
+      "configurations": ["Sim: Next.js dev", "Realtime: dev server"],
+      "stopAll": true
+    }
+  ]
+}