replicas-engine 0.1.221 → 0.1.223

package/dist/src/index.js

@@ -555,22 +555,19 @@ Docker is pre-installed in Replicas workspaces, but the daemon does **not** auto
 
 \`\`\`bash
 sudo service docker start
+until docker info >/dev/null 2>&1; do sleep 0.2; done
 \`\`\`
 
-After starting, verify the daemon is running:
-
-\`\`\`bash
-docker info
-\`\`\`
+\`service docker start\` returns before the socket is accepting connections, so immediate commands may fail without the poll.
 
 ## Important Notes
 
 - **Start once per session.** The daemon stays running until the workspace shuts down. You do not need to restart it between commands.
 - **Check before starting.** If you are unsure whether the daemon is already running, check first to avoid an unnecessary restart:
   \`\`\`bash
-  docker info > /dev/null 2>&1 || sudo service docker start
+  docker info >/dev/null 2>&1 || { sudo service docker start && until docker info >/dev/null 2>&1; do sleep 0.2; done; }
   \`\`\`
-- **Sudo is required** for starting the daemon, but regular \`docker\` commands run without sudo (the user is in the \`docker\` group).
+- **Sudo is only required for starting the daemon.** The workspace user is in the \`docker\` group, so regular \`docker\` commands work without sudo.
 `;
 var DOCKER_ABILITY = {
   label: "Docker",
@@ -710,8 +707,8 @@ gh pr review 123 --request-changes --body "Changes needed"
 GitHub does NOT have a public API for uploading images to PRs/issues. When you need to include images:
 - Do NOT use placeholder image URLs
 - Do NOT commit screenshots as files to the repository
-- Upload images to Imgur (or another external host) and use the returned URLs in your PR markdown
-- If you were triggered from Slack, also upload the images to the Slack thread so the user can see them directly
+- Use the \`replicas-agent\` skill to share the image
+- If you were triggered from Slack, also upload the image to the Slack thread so the user can see it directly
 `;
 var GITHUB_ABILITY = {
   label: "GitHub",
@@ -1159,10 +1156,9 @@ After (or alongside) the embeds, include a \`[View in Replicas](<deep-link>)\` h
 
 ### On external platforms (Slack, Linear, GitHub, etc.)
 
-Do **both** of these \u2014 neither alone is sufficient:
+Always include a \`[View in Replicas](<deep-link>)\` hyperlink \u2014 use the per-file deep link the CLI printed for that file (\`...?mode=media&media=<media-id>\`), so the recipient lands directly on that specific item.
 
-1. Upload the raw bytes via that platform's own upload API (Slack \`files.upload\`, Linear attachments, Imgur for GitHub PR/issue images, etc.) so the recipient actually sees the media.
-2. Include a \`[View in Replicas](<deep-link>)\` hyperlink \u2014 use the per-file deep link the CLI printed for that file (\`...?mode=media&media=<media-id>\`), so the recipient lands directly on that specific item.
+For platforms that support native uploads (Slack \`files.upload\`, Linear attachments, etc.), upload the raw bytes there too so the recipient sees the media inline in addition to the Replicas link. GitHub PRs/issues do not have a public upload API, so the \`View in Replicas\` link is the canonical way to share media there \u2014 do not commit screenshots to the repo and do not use placeholder URLs.
 
 Do **not** include the \`![filename](https://api.tryreplicas.com/...)\` markdown embed in external messages. It will render as a broken image / 401 for the recipient.
 
@@ -1208,7 +1204,7 @@ replicas media upload chart-a.svg chart-b.svg --kind image
 var MEDIA_ABILITY = {
   label: "Media",
   description: "Share screenshots, recordings, generated images, and audio clips.",
-  bullet: "- Sharing media (screenshots, screen recordings, generated diagrams, audio clips) \u2014 including in your Replicas chat reply and to external platforms",
+  bullet: "- Producing or showing the user any media \u2014 screenshots, screen recordings, generated images or diagrams, audio clips \u2014 including in your Replicas chat reply, PR descriptions/comments, and other external platforms",
   section: SECTION6,
   referenceFile: { name: "MEDIA.md", content: REFERENCE6 }
 };
@@ -1764,7 +1760,7 @@ function parseReplicasConfigString(content, filename) {
 }
 
 // ../shared/src/engine/environment.ts
-var DAYTONA_SNAPSHOT_ID = "27-05-2026-royal-york-v3";
+var DAYTONA_SNAPSHOT_ID = "27-05-2026-royal-york-v7";
 
 // ../shared/src/engine/types.ts
 var DEFAULT_CHAT_TITLES = {
@@ -1817,6 +1813,12 @@ function codexAuthEnvFromResponse(response) {
       return { OPENAI_API_KEY: response.apiKey, REPLICAS_CODEX_AUTH_METHOD: "api_key" };
   }
 }
+var CODEX_AUTH_ENV_KEYS_BY_METHOD = {
+  none: [],
+  oauth: ["REPLICAS_CODEX_AUTH_METHOD"],
+  api_key: ["OPENAI_API_KEY", "REPLICAS_CODEX_AUTH_METHOD"],
+  bedrock: []
+};
 
 // ../shared/src/routes/claude.ts
 var CLAUDE_AUTH_ENV_KEYS = [
@@ -1843,6 +1845,18 @@ function claudeAuthEnvFromResponse(response) {
       };
   }
 }
+var CLAUDE_AUTH_ENV_KEYS_BY_METHOD = {
+  none: [],
+  oauth: ["REPLICAS_CLAUDE_AUTH_METHOD"],
+  api_key: ["ANTHROPIC_API_KEY", "REPLICAS_CLAUDE_AUTH_METHOD"],
+  bedrock: [
+    "CLAUDE_CODE_USE_BEDROCK",
+    "AWS_ACCESS_KEY_ID",
+    "AWS_SECRET_ACCESS_KEY",
+    "AWS_REGION",
+    "REPLICAS_CLAUDE_AUTH_METHOD"
+  ]
+};
 
 // ../shared/src/routes/workspaces.ts
 var WORKSPACE_FILE_UPLOAD_MAX_SIZE_BYTES = 20 * 1024 * 1024;
@@ -2155,6 +2169,26 @@ var githubTokenManager = new GitHubTokenManager();
 // src/managers/claude-token-manager.ts
 import { promises as fs2 } from "fs";
 import path2 from "path";
+
+// src/managers/auth-env-transition.ts
+function applyAuthEnvTransition(params) {
+  const newOwned = new Set(params.authKeysByMethod[params.newMethod]);
+  const prevOwned = new Set(params.authKeysByMethod[params.prevMethod]);
+  for (const key of params.authKeys) {
+    const value = params.newEnvVars[key];
+    if (value !== void 0) {
+      for (const env of params.envs) {
+        env[key] = value;
+      }
+    } else if (prevOwned.has(key) && !newOwned.has(key)) {
+      for (const env of params.envs) {
+        delete env[key];
+      }
+    }
+  }
+}
+
+// src/managers/claude-token-manager.ts
 var ClaudeTokenManager = class extends BaseRefreshManager {
   constructor() {
     super("ClaudeTokenManager");
@@ -2222,34 +2256,14 @@ var ClaudeTokenManager = class extends BaseRefreshManager {
       await this.removeOauthCredentialsFile();
     }
     const envVars = claudeAuthEnvFromResponse(response);
-    for (const key of CLAUDE_AUTH_ENV_KEYS) {
-      switch (key) {
-        case "REPLICAS_CLAUDE_AUTH_METHOD":
-          ENGINE_ENV.REPLICAS_CLAUDE_AUTH_METHOD = envVars.REPLICAS_CLAUDE_AUTH_METHOD;
-          break;
-        case "ANTHROPIC_API_KEY":
-          ENGINE_ENV.ANTHROPIC_API_KEY = envVars.ANTHROPIC_API_KEY;
-          break;
-        case "CLAUDE_CODE_USE_BEDROCK":
-          ENGINE_ENV.CLAUDE_CODE_USE_BEDROCK = envVars.CLAUDE_CODE_USE_BEDROCK;
-          break;
-        case "AWS_ACCESS_KEY_ID":
-          ENGINE_ENV.AWS_ACCESS_KEY_ID = envVars.AWS_ACCESS_KEY_ID;
-          break;
-        case "AWS_SECRET_ACCESS_KEY":
-          ENGINE_ENV.AWS_SECRET_ACCESS_KEY = envVars.AWS_SECRET_ACCESS_KEY;
-          break;
-        case "AWS_REGION":
-          ENGINE_ENV.AWS_REGION = envVars.AWS_REGION;
-          break;
-      }
-      const value = envVars[key];
-      if (value !== void 0) {
-        process.env[key] = value;
-      } else {
-        delete process.env[key];
-      }
-    }
+    applyAuthEnvTransition({
+      prevMethod: ENGINE_ENV.REPLICAS_CLAUDE_AUTH_METHOD ?? "none",
+      newMethod: envVars.REPLICAS_CLAUDE_AUTH_METHOD ?? "none",
+      authKeys: CLAUDE_AUTH_ENV_KEYS,
+      authKeysByMethod: CLAUDE_AUTH_ENV_KEYS_BY_METHOD,
+      newEnvVars: envVars,
+      envs: [ENGINE_ENV, process.env]
+    });
   }
   async writeOauthCredentialsFile(credentials) {
     const workspaceHome = ENGINE_ENV.HOME_DIR;
@@ -2348,22 +2362,14 @@ var CodexTokenManager = class extends BaseRefreshManager {
       await this.removeOauthCredentialsFile();
     }
     const envVars = codexAuthEnvFromResponse(response);
-    for (const key of CODEX_AUTH_ENV_KEYS) {
-      switch (key) {
-        case "REPLICAS_CODEX_AUTH_METHOD":
-          ENGINE_ENV.REPLICAS_CODEX_AUTH_METHOD = envVars.REPLICAS_CODEX_AUTH_METHOD;
-          break;
-        case "OPENAI_API_KEY":
-          ENGINE_ENV.OPENAI_API_KEY = envVars.OPENAI_API_KEY;
-          break;
-      }
-      const value = envVars[key];
-      if (value !== void 0) {
-        process.env[key] = value;
-      } else {
-        delete process.env[key];
-      }
-    }
+    applyAuthEnvTransition({
+      prevMethod: ENGINE_ENV.REPLICAS_CODEX_AUTH_METHOD ?? "none",
+      newMethod: envVars.REPLICAS_CODEX_AUTH_METHOD ?? "none",
+      authKeys: CODEX_AUTH_ENV_KEYS,
+      authKeysByMethod: CODEX_AUTH_ENV_KEYS_BY_METHOD,
+      newEnvVars: envVars,
+      envs: [ENGINE_ENV, process.env]
+    });
   }
   async writeOauthCredentialsFile(credentials) {
     const workspaceHome = ENGINE_ENV.HOME_DIR;

package/package.json

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