@qwen-code/qwen-code 0.24.4 → 0.24.5-nightly.20260924.ffea2d024e

package/bundled/agent-delegation/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: agent-delegation
+description: Reference for briefing a subagent or a fork — what to put in the prompt, what not to delegate, and a worked example. Load before writing a delegation prompt; the Agent tool's own description carries the launch rules and the background-agent rules.
+---
+
+# Delegation prompt reference
+
+Everything below is about _writing_ the prompt. Whether to delegate at all, how
+a background agent reports back, and the rules for running agents concurrently
+stay in the Agent tool's description — this reference does not repeat them.
+
+## Writing the prompt
+
+Brief the agent like a smart colleague: make the delegated task, boundaries, and expected output explicit. Regular subagents have not seen this conversation; forks inherit all or the selected recent window.
+
+- Explain what you're trying to accomplish and why.
+- Describe what you've already learned or ruled out.
+- Give enough context about the surrounding problem that the agent can make judgment calls rather than just following a narrow instruction.
+- If you need a short response, say so explicitly.
+- For lookups, provide the exact target. For investigations, provide the actual question rather than an over-prescribed sequence of steps.
+- Provide clear, detailed prompts so the agent can work autonomously and return exactly the information you need.
+- Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent.
+
+Terse command-style prompts produce shallow, generic work.
+
+**Never delegate understanding.** Do not write prompts like "based on your findings, fix the bug" or "based on the research, implement it." Those phrases push synthesis onto the agent instead of doing it yourself. Write prompts that prove you understood the task: include relevant file paths, constraints, what specifically needs to be learned or changed, and what is out of scope.
+
+**A custom subagent's own definition outranks your prompt.** When `subagent_type` names a subagent someone defined, that definition already fixes its scope, its tools and its output contract; your prompt adds task context, not a new contract. Asking one confined to a single file to search the repository does not widen it — the dispatch simply cannot succeed. If the contract is too narrow for what you need, the definition is what has to change, not the prompt.
+
+## Writing a fork prompt
+
+With the default full history, the prompt is a _directive_ — what to do, not what the situation is. When `fork_turns` limits history, include any older context the fork still needs. Be specific about scope: what's in, what's out, what another agent is handling.
+
+## Worked example
+
+<example_agent_descriptions>
+"test-runner": use this agent after you are done writing code to run tests
+</example_agent_descriptions>
+
+<example>
+user: "Please write a function that checks if a number is prime"
+assistant: I'm going to use the Write tool to write the following code:
+<code>
+function isPrime(n) {
+  if (n <= 1) return false
+  for (let i = 2; i * i <= n; i++) {
+    if (n % i === 0) return false
+  }
+  return true
+}
+</code>
+<commentary>
+Since a significant piece of code was written and the task was completed, now use the test-runner agent to run the tests
+</commentary>
+assistant: Uses the agent tool to launch the test-runner agent
+</example>

package/bundled/browser-use/SKILL.md

@@ -19,8 +19,11 @@ The SDK checks the actual connection and protocol instead of reading Chrome's
 extension preferences.
 
 If the extension does not connect, ask the user to open Chrome and check the
-extension in the intended profile. There is no store listing yet: build the
-extension from `packages/chrome-extension` in the Qwen Code repository (its
+extension in the intended profile. It installs from the Chrome Web Store:
+https://chromewebstore.google.com/detail/qwen-code/hdhmmjclhibojdddmancfgbkleahfaph
+
+If the store reports it is not available in the user's region, they can build
+it from `packages/chrome-extension` in the Qwen Code repository (its
 README) and load `dist/extension` through `chrome://extensions` (Developer mode
 → Load unpacked). After installation or enabling it, retry the connection.
 
@@ -53,14 +56,12 @@ Browser Use MCP server. Screenshot metadata requires `@qwen-code/node-repl-mcp`
 0.1.6 or later, so keep this exact pin.
 
 Qwen reports the absolute `Base directory for this skill` when loading this
-file. Use that directory as `<skill-base>`. Confirm that
-`<skill-base>/runtime/index.js` and
-`<skill-base>/runtime/node_modules/playwright-core/package.json` exist. If
-either is missing, stop and report an incomplete Browser Use runtime instead
-of installing dependencies into the workspace. Before the first Node REPL
-cell, call `node_repl_add_node_module_dir` once with the absolute
-`<skill-base>/runtime/node_modules` path. Import the bundled SDK, replacing the
-example skill base below with that absolute path:
+file. Use that directory as `<skill-base>`. The bundled SDK ships with its
+dependencies: import it directly, without installing packages or registering
+module directories, replacing the example skill base below with that absolute
+path. If the import reports a missing file or an incomplete runtime, stop and
+report an incomplete Browser Use runtime instead of installing dependencies
+into the workspace:
 
 ```js
 globalThis.browserAgent ??= await (

package/bundled/browser-use/runtime/index.js

@@ -971,6 +971,7 @@ var CHROME_NATIVE_HOST_NAME = "com.qwen.browser_use";
 var CHROME_NATIVE_HOST_REVISION = 2;
 var CHROME_EXTENSION_ID = "idkijaaipeeinemigojbjkmfmabokbdk";
 var CHROME_WEB_STORE_EXTENSION_ID = "hdhmmjclhibojdddmancfgbkleahfaph";
+var CHROME_WEB_STORE_URL = "https://chromewebstore.google.com/detail/qwen-code/" + CHROME_WEB_STORE_EXTENSION_ID;
 var CHROME_EXTENSION_IDS = [
   CHROME_EXTENSION_ID,
   CHROME_WEB_STORE_EXTENSION_ID
@@ -997,9 +998,9 @@ function defaultChromeBridgeSocketDirectory(uid, platform3 = process.platform, s
   const base = platform3 === "darwin" ? "/private/tmp" : "/tmp";
   return posix.join(base, `qwen-browser-use-${uid}`);
 }
-function statDirectory(path) {
+function statDirectory(path2) {
   try {
-    return statSync(path);
+    return statSync(path2);
   } catch {
     return void 0;
   }
@@ -1133,9 +1134,9 @@ async function removeDeadHost(record3, socketPath) {
   if (info?.isSocket() && info.uid === process.getuid())
     await unlink(socketPath).catch(() => void 0);
 }
-async function socketIsLive(path) {
+async function socketIsLive(path2) {
   return await new Promise((resolve3) => {
-    const socket = connect(path);
+    const socket = connect(path2);
     const timer = setTimeout(() => finish(false), 200);
     const finish = (live) => {
       clearTimeout(timer);
@@ -1380,7 +1381,7 @@ var ChromeExtensionTransport = class {
     } while (Date.now() < deadline);
     if (mismatch !== void 0) throw mismatch;
     throw disconnectedError(
-      `Qwen Chrome extension is not connected. Open Chrome and install or enable the Qwen extension in the profile you want to use (chrome://extensions), then retry. ${errorMessage(lastError)}`
+      `Qwen Chrome extension is not connected. Open Chrome and, in the profile you want to use, install the extension from ${CHROME_WEB_STORE_URL} or enable it at chrome://extensions, then retry. ${errorMessage(lastError)}`
     );
   }
   /**
@@ -1627,7 +1628,7 @@ function invalidArguments(method, error) {
     message: issue.message
   }));
   const summary = issues.slice(0, 3).map(
-    ({ path, message }) => `${path || "options"}: ${message}`.slice(0, 200)
+    ({ path: path2, message }) => `${path2 || "options"}: ${message}`.slice(0, 200)
   ).join("; ");
   const hint = method === "cua.keypress" || method === "dom_cua.keypress" ? ` Use ${method}({ keys: ["Enter"] }); a chord uses an array such as ["Control", "a"].` : method === "dom_cua.type" ? " Use dom_cua.click({ node_id }) followed by dom_cua.type({ text }) to type at the current focus." : "";
   return new BrowserRuntimeError(
@@ -1673,7 +1674,7 @@ function operationErrorMessage(error) {
 }
 
 // src/runtime.ts
-import { fileURLToPath } from "node:url";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/core/chrome-runtime-documentation.ts
 var DEFAULT_CHROME_DOCUMENTATION = `# Qwen Browser Use
@@ -1882,11 +1883,11 @@ async function describeChromeProfiles(options, instanceIds) {
         for (const file of await readdir2(storage).catch(() => []))
           files.push(join2(storage, file));
       }
-      for (const path of files) {
-        if (!/\.(log|ldb)$/.test(path)) continue;
-        const info = await stat2(path).catch(() => void 0);
+      for (const path2 of files) {
+        if (!/\.(log|ldb)$/.test(path2)) continue;
+        const info = await stat2(path2).catch(() => void 0);
         if (!info?.isFile() || info.size > MAX_STORAGE_FILE_BYTES) continue;
-        const bytes = await readFile2(path).catch(() => void 0);
+        const bytes = await readFile2(path2).catch(() => void 0);
         if (bytes === void 0) continue;
         for (const id2 of instanceIds) {
           if (described.has(id2) || !bytes.includes(id2)) continue;
@@ -1979,9 +1980,9 @@ function isOwnedManifest(contents, launcherPath) {
 function isOwnedLauncher(contents) {
   return contents.startsWith("#!/bin/sh\n" + LAUNCHER_MARKER + "\n");
 }
-async function readExistingFile(path) {
+async function readExistingFile(path2) {
   try {
-    return await readFile2(path, "utf8");
+    return await readFile2(path2, "utf8");
   } catch (error) {
     if (error.code === "ENOENT") return null;
     throw error;
@@ -2003,8 +2004,8 @@ async function atomicWrite(target, contents, mode, existingContents) {
     await rm(temporary, { force: true });
   }
 }
-async function pathExists(path, mode = constants.F_OK) {
-  return await access(path, mode).then(
+async function pathExists(path2, mode = constants.F_OK) {
+  return await access(path2, mode).then(
     () => true,
     () => false
   );
@@ -2497,8 +2498,8 @@ function getErrorMap() {
 
 // ../../node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path, errorMaps, issueData } = params;
-  const fullPath = [...path, ...issueData.path || []];
+  const { data, path: path2, errorMaps, issueData } = params;
+  const fullPath = [...path2, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -2614,11 +2615,11 @@ var errorUtil;
 
 // ../../node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path, key) {
+  constructor(parent, value, path2, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path;
+    this._path = path2;
     this._key = key;
   }
   get path() {
@@ -6864,12 +6865,12 @@ async function executeCuaOperation(method, args, tab) {
       });
       return null;
     case "cua.drag": {
-      const path = args.path;
+      const path2 = args.path;
       await withModifiers(page, args.keys, async () => {
-        await page.mouse.move(path[0]?.x ?? 0, path[0]?.y ?? 0);
+        await page.mouse.move(path2[0]?.x ?? 0, path2[0]?.y ?? 0);
         await page.mouse.down();
         try {
-          for (const point of path.slice(1))
+          for (const point of path2.slice(1))
             await page.mouse.move(point.x, point.y);
         } finally {
           await page.mouse.up().catch(() => void 0);
@@ -7609,9 +7610,47 @@ function regionMismatch(actual, width, height) {
 
 // src/playwright/playwright-session.ts
 import { randomUUID as randomUUID3 } from "node:crypto";
-import {
-  chromium
-} from "playwright-core";
+
+// src/playwright/playwright-core-loader.ts
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+function incompleteRuntime(detail) {
+  const runtimeDir = path.dirname(fileURLToPath(import.meta.url));
+  return new BrowserRuntimeError(
+    "OPERATION_FAILED",
+    `The Browser Use runtime in ${runtimeDir} is incomplete: ${detail}. Reinstall Qwen Code instead of installing packages into the workspace.`,
+    { runtimeDir }
+  );
+}
+function orIncomplete(step) {
+  try {
+    return step();
+  } catch (error) {
+    const reason = operationErrorMessage(error).split("\n", 1)[0];
+    throw incompleteRuntime(
+      `its bundled playwright-core could not be loaded (${reason})`
+    );
+  }
+}
+function loadPlaywrightCore() {
+  const manifestPath = orIncomplete(
+    () => createRequire(import.meta.url).resolve("playwright-core/package.json")
+  );
+  const packageRequire = createRequire(manifestPath);
+  const { version } = orIncomplete(
+    () => packageRequire(manifestPath)
+  );
+  if (version !== "1.62.1") {
+    throw incompleteRuntime(
+      `it resolved playwright-core ${String(version)} at ${path.dirname(manifestPath)} instead of its bundled 1.62.1`
+    );
+  }
+  return orIncomplete(
+    () => packageRequire("playwright-core")
+  );
+}
+var { chromium } = loadPlaywrightCore();
 
 // src/playwright/qwen-playwright-transport.ts
 import { platform as platform2 } from "node:os";
@@ -9126,23 +9165,23 @@ var PlaywrightRuntime = class {
     const paths = stringArray(value);
     let totalBytes = 0;
     const files = [];
-    for (const path of paths) {
-      if (!isAbsolute2(path))
+    for (const path2 of paths) {
+      if (!isAbsolute2(path2))
         throw new BrowserRuntimeError(
           "INVALID_ARGUMENT",
           "Upload paths must be absolute"
         );
-      const resolved = await realpath2(path).catch(() => void 0);
+      const resolved = await realpath2(path2).catch(() => void 0);
       if (resolved === void 0)
         throw new BrowserRuntimeError(
           "INVALID_ARGUMENT",
-          `Upload path does not exist: ${path}`
+          `Upload path does not exist: ${path2}`
         );
       const info = await stat3(resolved);
       if (!info.isFile())
         throw new BrowserRuntimeError(
           "INVALID_ARGUMENT",
-          `Upload path is not a file: ${path}`
+          `Upload path is not a file: ${path2}`
         );
       totalBytes += info.size;
       if (totalBytes > MAX_UPLOAD_BYTES)
@@ -9205,7 +9244,7 @@ async function createBrowserBackend() {
   if (!process.env["QWEN_BROWSER_USE_SOCKET_PATH"]?.trim() && !process.env["QWEN_BROWSER_USE_DISCOVERY_DIR"]?.trim() && (process.platform === "darwin" || process.platform === "linux")) {
     const options = {
       homeDir: nativeHostInstallHome(),
-      nativeHostPath: fileURLToPath(
+      nativeHostPath: fileURLToPath2(
         new URL("./native-host.js", import.meta.url)
       )
     };

package/bundled/browser-use/runtime/native-host.js

@@ -13,6 +13,7 @@ import { posix } from "node:path";
 var CHROME_BRIDGE_PROTOCOL_VERSION = 3;
 var CHROME_EXTENSION_ID = "idkijaaipeeinemigojbjkmfmabokbdk";
 var CHROME_WEB_STORE_EXTENSION_ID = "hdhmmjclhibojdddmancfgbkleahfaph";
+var CHROME_WEB_STORE_URL = "https://chromewebstore.google.com/detail/qwen-code/" + CHROME_WEB_STORE_EXTENSION_ID;
 var CHROME_EXTENSION_IDS = [
   CHROME_EXTENSION_ID,
   CHROME_WEB_STORE_EXTENSION_ID

package/bundled/browser-use/runtime/scripts/native-host-setup.js

@@ -27,6 +27,7 @@ var CHROME_NATIVE_HOST_NAME = "com.qwen.browser_use";
 var CHROME_NATIVE_HOST_REVISION = 2;
 var CHROME_EXTENSION_ID = "idkijaaipeeinemigojbjkmfmabokbdk";
 var CHROME_WEB_STORE_EXTENSION_ID = "hdhmmjclhibojdddmancfgbkleahfaph";
+var CHROME_WEB_STORE_URL = "https://chromewebstore.google.com/detail/qwen-code/" + CHROME_WEB_STORE_EXTENSION_ID;
 var CHROME_EXTENSION_IDS = [
   CHROME_EXTENSION_ID,
   CHROME_WEB_STORE_EXTENSION_ID