replicas-engine 0.1.439 → 0.1.441

package/dist/src/index.js

@@ -506,7 +506,7 @@ var WORKSPACE_SIZES = ["small", "large"];
 var INVALID_WORKSPACE_SIZE_ERROR = `Invalid size: must be one of ${WORKSPACE_SIZES.join(", ")}`;
 
 // ../shared/src/e2b.ts
-var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-15-v4";
+var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-16-v1";
 
 // ../shared/src/runtime-env.ts
 function shellQuotePosix(value) {
@@ -1968,24 +1968,18 @@ When you run services on ports \u2014 such as a web app, API server, or database
 
 ## Running Services for Preview
 
-Services must run as detached background processes so they survive after your command session ends. Do not leave them attached to a foreground terminal.
+Always start services with \`replicas service start\` (see \`REPLICAS.md\`, "Long-running services"). It daemonizes the process so it survives your turn ending and workspace sleep/wake \u2014 a service left attached to your shell or backgrounded with \`&\`/\`nohup\` dies when the workspace sleeps, leaving the preview broken for the user.
 
-Some potential methods:
 \`\`\`bash
-# Start a detached service with logging
-setsid -f bash -lc 'cd /path/to/app && exec yarn dev >> /tmp/app.log 2>&1'
-
-# For daemons like Docker
-nohup dockerd > /tmp/dockerd.log 2>&1 &
+replicas service start web "yarn dev" --cwd /path/to/app
 \`\`\`
 
 After starting a service:
-1. Verify the process is running: \`pgrep -af 'yarn dev'\`
-2. Check logs for readiness: \`tail -f /tmp/app.log\`
-3. Confirm it's actually serving: \`curl -s http://localhost:3000\` (or appropriate health check)
-4. Only create the preview after the service is healthy
+1. Check logs for readiness: \`replicas service logs web\`
+2. Confirm it's actually serving: \`curl -s http://localhost:3000\` (or appropriate health check)
+3. Only create the preview after the service is healthy
 
-If a prior detached process exists on the same port, stop it before restarting.
+\`replicas service start\` on the same name restarts the service, so you never need to hunt down stale processes on the port.
 
 ## Creating Previews
 
@@ -2058,7 +2052,8 @@ Use this when:
 - The user asks you to create, edit, run, or delete an automation
 - The user asks you to manage environments, environment variables, or environment files
 - The user asks "what envs / repos / automations do I have?"
-- The user asks you to scaffold a \`replicas.json\` / \`replicas.yaml\` in a repo`;
+- The user asks you to scaffold a \`replicas.json\` / \`replicas.yaml\` in a repo
+- You need to run a long-lived service (dev server, daemon) \u2014 always use \`replicas service start\` so it survives workspace sleep/wake`;
 var REFERENCE10 = `# Replicas (in-workspace CLI)
 
 This guide covers how to take action *with* Replicas itself from inside a Replicas workspace \u2014 managing automations, environments (and their variables/files), repos, previews, and the user's \`replicas.json\` config \u2014 using the pre-installed \`replicas\` CLI.
@@ -2094,6 +2089,7 @@ In agent mode the CLI hides commands that don't make sense for in-workspace agen
 | \`replicas environment ...\` | Manage environments, env vars, env files |
 | \`replicas automation ...\` | Manage automations (cron + GitHub/GitLab event triggers) |
 | \`replicas preview ...\` | Register / list preview URLs (covered in \`PREVIEWS.md\`) |
+| \`replicas service ...\` | Run long-lived services detached so they survive workspace sleep/wake (see below) |
 | \`replicas media ...\` | Upload screenshots, videos, audio (covered in \`MEDIA.md\`) |
 | \`replicas slack thread ...\` | Attach or switch Slack thread routing (covered in \`SLACK.md\`) |
 
@@ -2235,6 +2231,24 @@ replicas automation edit <id> \\
 
 \`replicas automation edit <id>\` with no flags drops into interactive mode.
 
+## Long-running services
+
+**Always use \`replicas service start\` to run anything that should keep running after your current command or turn ends** \u2014 dev servers, backend APIs, databases, daemons, watchers. Never leave them attached to your shell, and never rely on plain \`&\`, \`nohup\`, or your own backgrounding: processes started inside your session are torn down when your turn ends and the workspace goes to sleep, so the user finds them dead after waking the workspace. \`replicas service start\` daemonizes the process into its own session, which survives workspace sleep/wake.
+
+\`\`\`bash
+replicas service start <name> "<command>"        # start (or restart) a named service
+replicas service start web "bun run dev" --cwd ~/workspaces/app
+replicas service list                            # names, pids, running/stopped
+replicas service logs <name> [-n 100]            # tail the service log
+replicas service stop <name>                     # stop the whole process group
+\`\`\`
+
+Notes:
+- Quote the command if it contains shell operators: \`replicas service start web "cd app && bun dev"\`.
+- \`start\` on an existing name restarts it (the old process group is stopped first). It fails fast and prints the log tail if the service dies within the first second.
+- Logs stream to \`~/.replicas/services/<name>.log\`.
+- After starting, verify the service is actually healthy (check \`logs\`, then \`curl\` its port) before telling the user it's up or creating a preview for it.
+
 ## Repositories
 
 Read-only listing of repos connected to the org. Use when the user asks "what repos can I use?", or to validate a \`--repository\` value before passing it to \`environment create\` / \`automation create\`:
@@ -8563,7 +8577,7 @@ var DEFAULT_CODEX_ARGS = ["app-server", "--listen", "stdio://"];
 var MIN_CODEX_CLI_VERSION = "0.144.0";
 var CODEX_UPGRADE_TIMEOUT_MS = 12e4;
 var codexCliVersionEnsured = null;
-var ENGINE_PACKAGE_VERSION = "0.1.439";
+var ENGINE_PACKAGE_VERSION = "0.1.441";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.439",
+  "version": "0.1.441",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",