replicas-engine 0.1.1244 → 0.1.1245

package/dist/src/{asp-host-3QBTHLYA.js → asp-host-AUWG4TM5.js}

@@ -8,12 +8,12 @@ import {
   listRunningCodexModels,
   restartCodexAspHost,
   restartCodexAspHostIfRunning
-} from "./chunk-RI5L7T76.js";
-import "./chunk-3VZEWLC4.js";
-import "./chunk-5XM7CFGT.js";
-import "./chunk-5HXCXUAQ.js";
+} from "./chunk-KE2AWRDG.js";
+import "./chunk-B2IU3EA4.js";
+import "./chunk-HJJ7VRXK.js";
+import "./chunk-N4MLANHG.js";
 import "./chunk-UZSNFLDQ.js";
-import "./chunk-XQ5WSXBS.js";
+import "./chunk-BITFRIB7.js";
 import "./chunk-VEQXQN22.js";
 export {
   CODEX_ULTRAFAST_SERVICE_TIER,

package/dist/src/{chunk-I27O3MHS.js → chunk-2VFSDNB4.js}

@@ -3,7 +3,7 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   AspClient
-} from "./chunk-5XM7CFGT.js";
+} from "./chunk-HJJ7VRXK.js";
 import {
   ASTER_BASE_URL,
   ASTER_PROVIDER,
@@ -13,7 +13,7 @@ import {
   isRecord,
   readOllamaAuthEnv,
   readOpenAICompatibleAuthEnv
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 
 // src/managers/codex-asp/notification-dispatch.ts
 var TURN_STARTED_METHOD = "turn/started";

package/dist/src/{chunk-3VZEWLC4.js → chunk-B2IU3EA4.js}

@@ -4,7 +4,7 @@ const require = __createRequire(import.meta.url);
 import {
   SUBPROCESS_MAX_BUFFER,
   execFileAsync
-} from "./chunk-5HXCXUAQ.js";
+} from "./chunk-N4MLANHG.js";
 import {
   isRecord as isRecord2
 } from "./chunk-UZSNFLDQ.js";
@@ -18,7 +18,7 @@ import {
   isValidAgentProvider,
   parsePosixEnvFile,
   readReplicasRuntimeEnv
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 
 // src/runtime-env-loader.ts
 import { readFileSync } from "fs";

package/dist/src/{chunk-XQ5WSXBS.js → chunk-BITFRIB7.js}

@@ -2549,7 +2549,7 @@ The CLI is the canonical surface. Chat transcripts that show \`DISPLAY=:99 xdoto
 \`\`\`bash
 # DO
 replicas computer key Return
-replicas computer observe /tmp/state.png
+replicas computer observe /tmp/state.jpg
 
 # DON'T
 DISPLAY=:99 xdotool key Return
@@ -2568,11 +2568,10 @@ replicas computer info
 replicas computer launch chrome https://news.ycombinator.com
 
 # 3) Capture the settled viewport and native accessibility tree together.
-replicas computer browser-state /tmp/state.png --full
+replicas computer browser-state /tmp/state.jpg --full
 
 # 4) Batch actions that use refs from the same state, then capture the semantic diff.
 replicas computer browser-batch '[{"action":"fill","ref":17,"value":"hello"},{"action":"click","ref":42}]'
-replicas computer browser-state /tmp/after-click.png
 
 # 5) (Optional) Record a screencap to share back.
 replicas computer record start /tmp/demo.mp4 --fps 60
@@ -2594,34 +2593,39 @@ If invoked very early in the workspace lifecycle, \`info\` will poll briefly whi
 Checks and repairs the desktop bridge, then prints which desktop services are running and the active preview URL (if any). Useful for debugging when a tool call seems to be doing nothing.
 
 ### \`replicas computer screenshot <path> [--raw] [--grid [px]]\`
-Captures the current desktop to a PNG at the given path.
+Captures the current desktop to the given path. The extension picks the format; \`.jpg\` captures several times faster than \`.png\`.
 
 Use \`--raw\` for a 1:1 desktop capture with no branding, padding, or rounded corners. Use \`--grid\` for the same 1:1 capture plus a coordinate grid; the optional value sets grid spacing in pixels and defaults to 100. Use the default branded screenshot only when you plan to share the image with \`replicas media upload\`.
 
-### \`replicas computer observe <path> [--raw] [--grid [px]] [--timeout MS] [--stable-ms MS] [--poll-ms MS]\`
+### \`replicas computer observe <path> [--grid [px]] [--timeout MS] [--stable-ms MS] [--poll-ms MS]\`
 Waits briefly for the screen to stop changing, saves a 1:1 screenshot, and prints JSON with screen dimensions, whether the screen stabilized, frame/change counts, mouse location, active window title, and visible window titles.
 
-Use this instead of hand-written \`sleep && screenshot\` loops after clicks, navigation, typing, or page loads. By default it saves a 100px coordinate-grid screenshot and waits up to 3s for 600ms of visual stability. Pass \`--raw\` if you need an unannotated 1:1 screenshot.
+Use this instead of hand-written \`sleep && screenshot\` loops after clicks, navigation, typing, or page loads. It waits up to 3s for 600ms of visual stability. Use a \`.jpg\` path for the fastest capture. \`--grid\` overlays a coordinate grid.
 
-### \`replicas computer browser-state <path> [--full] [--timeout MS] [--stable-ms MS]\`
-Waits for the selected Chrome page to settle, saves its viewport screenshot, and prints a compact native Chrome accessibility tree in the same coordinate space. Actionable nodes have DOM-backed refs such as \`[ref=42] button "Save"\`; the tree includes accessible roles, names, values, states, visible bounds, and iframe content.
+### \`replicas computer browser-state [path] [--full] [--timeout MS] [--stable-ms MS]\`
+Waits until the selected Chrome page has been quiet for 500ms (immediately if it already has), then prints a compact native Chrome accessibility tree. Pass a path to also save a viewport screenshot in the same coordinate space. Nodes other than text have DOM-backed refs such as \`[ref=42] button "Save"\` or \`[ref=7] region "Done"\`; elements that only look clickable (a pointer cursor and no accessible role) appear as \`clickable\`. The tree includes accessible roles, names, values, states, visible bounds, and iframe content.
 
 The first call returns a full tree. Later calls for the same target and document return semantic changes; navigation or reload forces a new full tree. Pass \`--full\` to reset the baseline. Refs are valid for the current document.
 
+Every browser action below (\`browser-click\`, \`browser-fill\`, \`browser-drag\`, \`browser-scroll\`, \`browser-key\`, \`browser-type\`, \`browser-batch\`) waits for the page to settle and ends its output with an \`observation\`: the same tree changes \`browser-state\` would print, including refs for new elements. Read it instead of calling \`browser-state\` again.
+
 ### \`replicas computer browser [--snapshot]\`
 Lists Chrome tabs. \`--snapshot\` returns the compatibility accessibility snapshot. Use \`browser-state\` for the primary action/observe loop.
 
 ### \`replicas computer browser-batch '<actions-json>'\`
-Runs up to 100 ordered browser actions through one Chrome session and stops at the first failure. Supported actions are \`click\`, \`fill\`, \`key\`, \`type\`, \`scroll\`, and \`wait\`. Prefer this when several actions use refs from the same \`browser-state\`; it avoids repeated process, tab-selection, and connection setup. Do not carry refs across navigation\u2014capture fresh state and start a new batch.
+Runs up to 100 ordered browser actions through one Chrome session and stops at the first failure. Supported actions are \`click\`, \`fill\`, \`drag\` (\`{"action":"drag","ref":3,"toRef":9}\`), \`key\`, \`type\`, \`scroll\`, and \`wait\`. Prefer this when several actions use refs from the same state; it avoids repeated process, tab-selection, and connection setup. The observation after the batch (or after a failure) carries the refs for the next step. Do not carry refs across navigation.
 
 ### \`replicas computer browser-click --ref ID [--button left|middle|right] [--double]\`
 Scrolls the referenced node into view and sends trusted Chrome mouse input at its current visible bounds. Prefer refs from \`browser-state\`. \`browser-click <text> [--exact] [--index N]\` remains a fallback when no fresh ref is available.
 
 ### \`replicas computer browser-fill --ref ID <value>\`
-Focuses the referenced field, fills it with trusted Chrome input, and verifies the resulting value. Select controls use their semantic option value. \`browser-fill <field> <value> [--exact] [--index N]\` remains a text-matching fallback.
+Focuses the referenced field, fills it with trusted Chrome input, and verifies the resulting value. Selects take an option's value or label; range sliders and number, date, time and color inputs take their value directly (\`browser-fill --ref 12 75\` sets a slider to 75). \`browser-fill <field> <value> [--exact] [--index N]\` remains a text-matching fallback.
+
+### \`replicas computer browser-drag --ref ID --to-ref ID\`
+Drags one element onto another with trusted mouse input, including HTML5 drag-and-drop. Both refs come from the latest state and should be visible together.
 
-### \`replicas computer browser-scroll <up|down|left|right> [--ref ID] [--amount PX]\`
-Sends trusted wheel input at a referenced element or the center of the viewport.
+### \`replicas computer browser-scroll <up|down|left|right> [--ref ID] [--amount PX] [--until TEXT] [--timeout MS]\`
+Sends trusted wheel input at a referenced element. Without \`--ref\` it scrolls the page, or the largest visible scrollable panel when the page itself does not scroll. \`--until <text>\` keeps scrolling, letting lazy-loaded content arrive, until the text is on the page, then centers it; it fails if the content ends or \`--timeout\` (default 10000) passes first. Use it instead of scrolling in a loop.
 
 ### \`replicas computer browser-key <combo>\` / \`browser-type <text>\`
 Sends trusted keyboard input to the focused element in the selected Chrome target. Prefer \`browser-fill\` when setting a known field value.
@@ -2679,28 +2683,27 @@ For Chrome, use the native accessibility state before interpreting pixels or gue
 
 \`\`\`bash
 replicas computer launch chrome https://example.com
-replicas computer browser-state /tmp/before.png --full --target-id <page-id>
+replicas computer browser-state --full --target-id <page-id>
 replicas computer browser-batch '[{"action":"fill","ref":17,"value":"hello"},{"action":"click","ref":23}]' --target-id <page-id>
-replicas computer browser-state /tmp/after.png --target-id <page-id>
 \`\`\`
 
-Read the screenshot and tree as one state. Batch ordered actions whose refs all come from that state, then inspect the next semantic diff. A batch is fail-fast and validates each ref against the cached document. Split at navigation or whenever a later action depends on newly rendered refs. Fall back to \`observe\` plus desktop coordinates for canvas content, browser chrome, non-Chrome apps, or controls missing from the accessibility tree.
+Batch ordered actions whose refs all come from the latest state, then read the observation the batch prints: it is the next semantic diff. A batch is fail-fast and validates each ref against the cached document. Split at navigation or whenever a later action depends on newly rendered refs. Pass a screenshot path to \`browser-state\` when the tree alone is ambiguous (icons, colors, canvas). Fall back to \`observe\` plus desktop coordinates for canvas content, browser chrome, non-Chrome apps, or controls missing from the accessibility tree.
 
 ### Typing into an address bar
 \`\`\`bash
 replicas computer launch chrome
-replicas computer observe /tmp/browser-open.png
+replicas computer observe /tmp/browser-open.jpg
 replicas computer key ctrl+l
 replicas computer type "https://example.com"
 replicas computer key Return
-replicas computer browser-state /tmp/loaded.png --full
+replicas computer browser-state --full
 replicas computer browser-fill --ref 17 "replicas"
 replicas computer browser-click --ref 23 --title "Example"
 replicas computer browser-wait "Example Domain" --mode title --title "Example"
 \`\`\`
 
 ### Coordinates from screenshots
-The display is 1920\xD71080 by default. For click planning, use \`observe\`, \`screenshot --raw\`, or \`screenshot --grid\`; those pixels map 1:1 to click coordinates. If the grid/raw screenshot shows a button at pixel (520, 700), click \`replicas computer click 520 700\`. The default screenshot is branded for sharing and has padding around the desktop, so do not use it for coordinates.
+The display is 1920\xD71080 by default. For click planning, use \`observe\`, \`screenshot --raw\`, or \`screenshot --grid\`; those pixels map 1:1 to click coordinates. If the screenshot shows a button at pixel (520, 700), click \`replicas computer click 520 700\`. The default screenshot is branded for sharing and has padding around the desktop, so do not use it for coordinates.
 
 Use percentages for broad, layout-relative targets when exact pixels are unnecessary: \`replicas computer click 50% 50%\` clicks the center of the screen, and \`replicas computer move 95% 5%\` moves near the top-right.
 
@@ -2725,7 +2728,7 @@ Then embed the printed \`![\u2026](\u2026)\` lines in your chat reply and follow
 - **"Computer-use daemon is unavailable"**: the package-managed systemd service did not start. Check \`systemctl status replicas-computer.service\` and its journal.
 - **"Desktop services script missing"**: workspace image is older than this skill. Tell the user - nothing you can do from the CLI side.
 - **\`xdotool ... failed: Can't open display\`**: Xvfb didn't come up. \`replicas computer status\` will show which service is dead and auto-repair the desktop bridge.
-- **Browser doesn't appear after \`launch chrome\`**: run \`replicas computer observe /tmp/state.png\`. Chrome cold-start on the virtual display takes ~500ms but bigger pages take longer.
+- **Browser doesn't appear after \`launch chrome\`**: run \`replicas computer observe /tmp/state.jpg\`. Chrome cold-start on the virtual display takes ~500ms but bigger pages take longer.
 - **Live preview shows static / black screen**: the browser may have crashed. \`replicas computer status\` should show no Chrome process - re-launch.
 - **\`replicas computer info\` errors with "not registered"**: engine couldn't register the preview at startup (transient monolith error, or warming mode). Re-running the engine usually fixes it. Until it's registered, the Desktop tab will show a placeholder.
 

package/dist/src/{chunk-OAB342UB.js → chunk-G5LEEPN7.js}

@@ -5,14 +5,14 @@ import {
   getOriginDefaultBranch,
   monolithRequest,
   runGitCommand
-} from "./chunk-3VZEWLC4.js";
+} from "./chunk-B2IU3EA4.js";
 import {
   extractCommandProtectionCommandText,
   findCommandProtectionGitLookups,
   findGitCommitSignals,
   findPrMergeSignals,
   parseCommandProtectionRequest
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 
 // src/services/command-protection-service.ts
 import { readFile, stat } from "fs/promises";

package/dist/src/{chunk-5XM7CFGT.js → chunk-HJJ7VRXK.js}

@@ -3,10 +3,10 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   execFileAsync
-} from "./chunk-5HXCXUAQ.js";
+} from "./chunk-N4MLANHG.js";
 import {
   isVersionBelow
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 
 // src/utils/codex-agent-env.ts
 function buildCodexAgentEnv(source = process.env) {
@@ -240,7 +240,7 @@ function getCodexModelProvider(method) {
   if (method === "foundry") return "azure";
   return method === "ollama" || method === "openai-compatible" ? "replicas_openai_compatible" : "openai";
 }
-var ENGINE_PACKAGE_VERSION = "0.1.1244";
+var ENGINE_PACKAGE_VERSION = "0.1.1245";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";

package/dist/src/{chunk-RI5L7T76.js → chunk-KE2AWRDG.js}

@@ -10,15 +10,15 @@ import {
   resolveDiffBase,
   runGitCommand,
   setAgentCredentialSnapshot
-} from "./chunk-3VZEWLC4.js";
+} from "./chunk-B2IU3EA4.js";
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-5XM7CFGT.js";
+} from "./chunk-HJJ7VRXK.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execFileAsync
-} from "./chunk-5HXCXUAQ.js";
+} from "./chunk-N4MLANHG.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
@@ -55,7 +55,7 @@ import {
   resolveOpenAICompatibleModelsUrl,
   splitMothershipInstructions,
   withTimeout
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 
 // src/managers/codex-token-manager.ts
 import { promises as fs } from "fs";
@@ -291,7 +291,7 @@ var CodexTokenManager = class extends BaseRefreshManager {
     await this.applyCredentialUpdate(++this.credentialGeneration, async () => {
       await this.applyCredentialsResponse(data);
       setAgentCredentialSnapshot("codex", data);
-      const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-3QBTHLYA.js");
+      const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-AUWG4TM5.js");
       await restartCodexAspHostIfRunning2();
     });
     await this.start(true);
@@ -313,7 +313,7 @@ var CodexTokenManager = class extends BaseRefreshManager {
       const accountChanged = ENGINE_ENV.REPLICAS_AGENT_CREDENTIALS.codex?.credentialId !== data.credentialId;
       await this.applyCredentialsResponse(data);
       if (restartOnChange && (accountChanged || CODEX_AUTH_ENV_KEYS.some((key, index) => process.env[key] !== previousEnv[index]))) {
-        const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-3QBTHLYA.js");
+        const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-AUWG4TM5.js");
         await restartCodexAspHostIfRunning2();
       }
       setAgentCredentialSnapshot("codex", data);

package/dist/src/{chunk-D3LFCDCW.js → chunk-M3IIIYS7.js}

@@ -5,7 +5,7 @@ import {
   extractCommandProtectionCommandText,
   isRecord,
   parseCodeHostPrUrl
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 
 // src/services/published-pull-request-urls.ts
 function publishedPullRequestUrls(result) {

package/dist/src/{chunk-5HXCXUAQ.js → chunk-N4MLANHG.js}

@@ -3,7 +3,7 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   HOOK_EXEC_MAX_BUFFER_BYTES
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 
 // src/utils/exec.ts
 import { exec, execFile } from "child_process";

package/dist/src/command-protection-hook.js

@@ -3,13 +3,13 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   evaluateCommandProtection
-} from "./chunk-OAB342UB.js";
-import "./chunk-3VZEWLC4.js";
-import "./chunk-5HXCXUAQ.js";
+} from "./chunk-G5LEEPN7.js";
+import "./chunk-B2IU3EA4.js";
+import "./chunk-N4MLANHG.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
-import "./chunk-XQ5WSXBS.js";
+import "./chunk-BITFRIB7.js";
 import "./chunk-VEQXQN22.js";
 
 // src/command-protection-hook.ts

package/dist/src/headless-agent.js

@@ -13,12 +13,12 @@ import {
   recoverCompletedTurn,
   spawnMuseMsp,
   startMuseSession
-} from "./chunk-I27O3MHS.js";
+} from "./chunk-2VFSDNB4.js";
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-5XM7CFGT.js";
-import "./chunk-5HXCXUAQ.js";
+} from "./chunk-HJJ7VRXK.js";
+import "./chunk-N4MLANHG.js";
 import {
   AGENT,
   OPENCODE_GO_PROVIDER,
@@ -28,7 +28,7 @@ import {
   headlessAgentUsagePath,
   isRecord,
   withTimeout
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 import "./chunk-VEQXQN22.js";
 
 // src/headless-agent.ts

package/dist/src/index.js

@@ -27,7 +27,7 @@ import {
   evaluateCommandProtection,
   extractToolCommand,
   reportCommandProtectionBlock
-} from "./chunk-OAB342UB.js";
+} from "./chunk-G5LEEPN7.js";
 import {
   ACCOUNT_RATE_LIMITS_UPDATED_METHOD,
   AGENT_MESSAGE_DELTA_METHOD,
@@ -64,10 +64,10 @@ import {
   spawnMuseMsp,
   startMuseSession,
   uuidV7
-} from "./chunk-I27O3MHS.js";
+} from "./chunk-2VFSDNB4.js";
 import {
   publishedPullRequestUrls
-} from "./chunk-D3LFCDCW.js";
+} from "./chunk-M3IIIYS7.js";
 import {
   ACCOUNT_RATE_LIMITS_READ_METHOD,
   AsyncLock,
@@ -140,7 +140,7 @@ import {
   timestampFromSeconds,
   upsertCredentialFileLines,
   writeSecureCredentialFile
-} from "./chunk-RI5L7T76.js";
+} from "./chunk-KE2AWRDG.js";
 import {
   ENGINE_ENV,
   monolithRequest,
@@ -149,15 +149,15 @@ import {
   reloadEngineEnv,
   resolveDiffBase,
   setAgentCredentialSnapshot
-} from "./chunk-3VZEWLC4.js";
+} from "./chunk-B2IU3EA4.js";
 import {
   getCodexModelProvider
-} from "./chunk-5XM7CFGT.js";
+} from "./chunk-HJJ7VRXK.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execAsync,
   execFileAsync
-} from "./chunk-5HXCXUAQ.js";
+} from "./chunk-N4MLANHG.js";
 import {
   isRecord as isRecord2
 } from "./chunk-UZSNFLDQ.js";
@@ -395,7 +395,7 @@ import {
   workspaceTokenRequestSchema,
   workspaceTokenResponseSchema,
   wrapInTag
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 import {
   cloneMcpConfig,
   ensureCompatibilityImports,

package/dist/src/post-tool-pr-hook.js

@@ -3,13 +3,13 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   publishedPullRequestUrls
-} from "./chunk-D3LFCDCW.js";
+} from "./chunk-M3IIIYS7.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
 import {
   shouldRefreshPullRequests
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 import "./chunk-VEQXQN22.js";
 
 // src/services/post-tool-pr-notifier.ts

package/dist/src/subagent-mcp.js

@@ -11,7 +11,7 @@ import {
   spawnSubagentRequestSchema,
   subagentResponseSchema,
   waitSubagentRequestSchema
-} from "./chunk-XQ5WSXBS.js";
+} from "./chunk-BITFRIB7.js";
 import "./chunk-VEQXQN22.js";
 
 // src/subagent-mcp.ts

package/package.json

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