@qwen-code/qwen-code 0.22.2 → 0.22.3-nightly.20260831.3a0c4c6108

package/chunks/chunk-4VQBQLIZ.js

@@ -0,0 +1,293 @@
+// Force strict mode and setup for ESM
+"use strict";
+import {
+  init_esbuild_shims
+} from "./chunk-5O2XNYP6.js";
+import {
+  __name
+} from "./chunk-J2S4EL5Y.js";
+
+// packages/cli/src/commands/review/lib/remote-match.ts
+init_esbuild_shims();
+function normalizeSegment(value) {
+  const v = value.toLowerCase();
+  return v.endsWith(".git") ? v.slice(0, -4) : v;
+}
+__name(normalizeSegment, "normalizeSegment");
+var AONE_HOSTS = /* @__PURE__ */ new Set(["code.alibaba-inc.com", "gitlab.alibaba-inc.com"]);
+function normalizeHostSpelling(host) {
+  return host.toLowerCase().replace(/:\d+$/, "").replace(/\.$/, "");
+}
+__name(normalizeHostSpelling, "normalizeHostSpelling");
+function hostsEquivalent(a, b) {
+  const na = normalizeHostSpelling(a);
+  const nb = normalizeHostSpelling(b);
+  if (na === nb) return true;
+  return AONE_HOSTS.has(na) && AONE_HOSTS.has(nb);
+}
+__name(hostsEquivalent, "hostsEquivalent");
+function isAoneCanonicalHost(host) {
+  if (!host) return false;
+  return AONE_HOSTS.has(normalizeHostSpelling(host));
+}
+__name(isAoneCanonicalHost, "isAoneCanonicalHost");
+function isAoneHostFamily(host) {
+  if (!host) return false;
+  const h = host.toLowerCase().replace(/:\d+$/, "").replace(/\.$/, "");
+  return h === "gitlab.alibaba-inc.com" || h === "code.alibaba-inc.com" || h.endsWith(".alibaba-inc.com");
+}
+__name(isAoneHostFamily, "isAoneHostFamily");
+function parseRemoteUrl(raw) {
+  const url = raw.trim();
+  if (url === "") return null;
+  let host;
+  let pathPart;
+  const schemeIdx = url.indexOf("://");
+  if (schemeIdx !== -1) {
+    let parsed;
+    try {
+      parsed = new URL(url);
+    } catch {
+      return null;
+    }
+    if (parsed.hostname === "") return null;
+    host = parsed.hostname;
+    pathPart = parsed.pathname;
+  } else {
+    const colonIdx = url.indexOf(":");
+    const slashIdx = url.indexOf("/");
+    if (colonIdx === -1 || slashIdx === -1 || colonIdx > slashIdx) {
+      return null;
+    }
+    host = url.slice(0, colonIdx);
+    const atIdx = host.lastIndexOf("@");
+    if (atIdx !== -1) host = host.slice(atIdx + 1);
+    pathPart = url.slice(colonIdx + 1);
+  }
+  const segments = pathPart.split("/").map((s) => s.trim()).filter((s) => s !== "");
+  if (segments.length < 2) return null;
+  if (host === "") return null;
+  return {
+    host: host.toLowerCase(),
+    owner: normalizeSegment(segments[segments.length - 2]),
+    repo: normalizeSegment(segments[segments.length - 1]),
+    groupPath: segments.map(normalizeSegment).join("/")
+  };
+}
+__name(parseRemoteUrl, "parseRemoteUrl");
+function matchRemotes(remoteVOutput, { owner, repo, host = "github.com", groupPath }) {
+  const wantOwner = normalizeSegment(owner);
+  const wantRepo = normalizeSegment(repo);
+  const wantPath = groupPath ? groupPath.split("/").filter(Boolean).map(normalizeSegment) : void 0;
+  const wantHost = normalizeSegment(host.replace(/:\d+$/, ""));
+  const matched = [];
+  for (const line of remoteVOutput.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed === "" || !/\(fetch\)(\s+\[[^\]]*\])?$/.test(trimmed)) {
+      continue;
+    }
+    const nameMatch = trimmed.match(
+      /^(\S+)\s+(.*)\s+\(fetch\)(\s+\[[^\]]*\])?$/
+    );
+    if (!nameMatch) continue;
+    const identity = parseRemoteUrl(nameMatch[2]);
+    if (identity === null) continue;
+    if (!hostsEquivalent(identity.host, wantHost)) continue;
+    const remotePath = identity.groupPath.split("/");
+    const sameRepo = wantPath !== void 0 ? wantPath.length === remotePath.length && wantPath.every((seg, i) => seg === remotePath[i]) : identity.owner === wantOwner && identity.repo === wantRepo;
+    if (sameRepo) {
+      matched.push(nameMatch[1]);
+    }
+  }
+  return { matched };
+}
+__name(matchRemotes, "matchRemotes");
+
+// packages/cli/src/commands/review/lib/platform/aone-client.ts
+init_esbuild_shims();
+import { execFileSync } from "node:child_process";
+var A1_BINARY = "a1";
+var MAX_RETRIES = 2;
+var BASE_DELAY_MS = 3e3;
+var A1_TIMEOUT_MS = 12e4;
+var TRANSIENT_RE = /(HTTP\s?5\d\d|temporarily unavailable|connection (reset|timed? ?out)|ECONNRESET|network is unreachable)/i;
+function sleepSync(ms) {
+  const sab = new SharedArrayBuffer(4);
+  Atomics.wait(new Int32Array(sab), 0, 0, ms);
+}
+__name(sleepSync, "sleepSync");
+function execA1(args, retry) {
+  for (let attempt = 0; ; attempt++) {
+    try {
+      return execFileSync(A1_BINARY, args, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        maxBuffer: 64 * 1024 * 1024,
+        timeout: A1_TIMEOUT_MS
+      }).toString().replace(/\r\n/g, "\n").trim();
+    } catch (err) {
+      const e = err;
+      const rebuilt = new Error(
+        [
+          e.message ?? "",
+          e.stdout?.toString() ?? "",
+          e.stderr?.toString() ?? ""
+        ].join("\n")
+      );
+      if (retry && attempt < MAX_RETRIES && TRANSIENT_RE.test(rebuilt.message)) {
+        const delay = BASE_DELAY_MS * (attempt + 1);
+        process.stderr.write(
+          `a1 transient error (attempt ${attempt + 1}/${MAX_RETRIES}), retrying in ${delay}ms\u2026
+`
+        );
+        sleepSync(delay);
+        continue;
+      }
+      throw err;
+    }
+  }
+}
+__name(execA1, "execA1");
+function a1(...args) {
+  return execA1(args, true);
+}
+__name(a1, "a1");
+function a1Once(...args) {
+  return execA1(args, false);
+}
+__name(a1Once, "a1Once");
+function a1Json(...args) {
+  return JSON.parse(a1(...args, "--format", "json"));
+}
+__name(a1Json, "a1Json");
+function a1JsonOnce(...args) {
+  const raw = a1Once(...args, "--format", "json");
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+}
+__name(a1JsonOnce, "a1JsonOnce");
+var A1_MIN_VERSION = "0.1.90";
+function parseA1Version(out) {
+  const m = /version[^\d]*(\d+)\.(\d+)\.(\d+)/i.exec(out) ?? /(\d+)\.(\d+)\.(\d+)/.exec(out);
+  return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : void 0;
+}
+__name(parseA1Version, "parseA1Version");
+function a1VersionAtLeast(version, floor) {
+  for (let i = 0; i < 3; i++) {
+    if (version[i] !== floor[i]) return version[i] > floor[i];
+  }
+  return true;
+}
+__name(a1VersionAtLeast, "a1VersionAtLeast");
+function execErrorCause(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const lines = message.split("\n").map((l) => l.trim());
+  const candidates = /^(Command failed:|spawnSync |spawn )/.test(message) ? lines.slice(1) : lines;
+  return candidates.find(Boolean) ?? "";
+}
+__name(execErrorCause, "execErrorCause");
+function aoneWhoamiAccount() {
+  let out;
+  try {
+    out = a1Json("auth", "whoami");
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      throw new Error("a1 auth whoami returned an unexpected shape");
+    }
+    throw err;
+  }
+  if (out === null || typeof out.account !== "string" || out.account.trim() === "") {
+    throw new Error("a1 auth whoami returned no account");
+  }
+  return out.account;
+}
+__name(aoneWhoamiAccount, "aoneWhoamiAccount");
+function ensureAoneAuthenticated() {
+  let versionOut;
+  try {
+    versionOut = a1("--version");
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT" || code === "EACCES" || code === "ENOEXEC") {
+      throw new Error(
+        "a1 CLI not found on PATH or not executable \u2014 install the `a1` CLI first."
+      );
+    }
+    if (err.signal) {
+      process.stderr.write(
+        `WARNING: the a1 version probe timed out or was killed (check the network / a1 install) \u2014 the review provider requires a1 >= ${A1_MIN_VERSION}; continuing without a floor ruling.
+`
+      );
+    } else {
+      const why = execErrorCause(err);
+      process.stderr.write(
+        `WARNING: the a1 version probe failed` + (why ? ` (${JSON.stringify(why.slice(0, 80))})` : "") + ` \u2014 the review provider requires a1 >= ${A1_MIN_VERSION}; continuing without a floor ruling.
+`
+      );
+    }
+  }
+  if (versionOut !== void 0) {
+    const floor = parseA1Version(A1_MIN_VERSION);
+    const version = parseA1Version(versionOut);
+    if (version === void 0) {
+      process.stderr.write(
+        `WARNING: could not read the a1 version from ${JSON.stringify(versionOut.slice(0, 80))} \u2014 the review provider requires a1 >= ${A1_MIN_VERSION}; continuing.
+`
+      );
+    } else if (!a1VersionAtLeast(version, floor)) {
+      throw new Error(
+        `a1 ${version.join(".")} is older than the ${A1_MIN_VERSION} this review provider requires \u2014 it depends on the comment-create flags and stable \`--format json\` output introduced there. Upgrade the a1 CLI (https://code.alibaba-inc.com/aone/a1) and retry.`
+      );
+    }
+  }
+  let raw;
+  try {
+    raw = a1("auth", "whoami", "--format", "json");
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      throw new Error("a1 CLI not found on PATH \u2014 install the `a1` CLI first.");
+    }
+    const e = err;
+    if (e.signal) {
+      throw new Error(
+        "a1 auth check timed out or was killed \u2014 check the network / a1 install."
+      );
+    }
+    const cause = execErrorCause(err);
+    throw new Error(
+      `a1 auth check failed` + (cause ? ` \u2014 ${cause}` : "") + ` (if you have not logged in, run \`a1 auth login\`)`
+    );
+  }
+  try {
+    const out = JSON.parse(raw);
+    return typeof out.account === "string" ? out.account.trim() : "";
+  } catch {
+    return "";
+  }
+}
+__name(ensureAoneAuthenticated, "ensureAoneAuthenticated");
+
+export {
+  hostsEquivalent,
+  isAoneCanonicalHost,
+  isAoneHostFamily,
+  parseRemoteUrl,
+  matchRemotes,
+  a1Once,
+  a1Json,
+  a1JsonOnce,
+  A1_MIN_VERSION,
+  parseA1Version,
+  a1VersionAtLeast,
+  execErrorCause,
+  aoneWhoamiAccount,
+  ensureAoneAuthenticated
+};
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/chunks/{chunk-4JWNNLPT.js → chunk-5FGWVPCM.js}

@@ -2,7 +2,7 @@
 "use strict";
 import {
   performStandaloneUpdate
-} from "./chunk-QP4C6WCE.js";
+} from "./chunk-NGKLMNWN.js";
 import {
   updateEventEmitter
 } from "./chunk-YAF2MQZ6.js";
@@ -11,15 +11,15 @@ import {
 } from "./chunk-2AUM35J5.js";
 import {
   t
-} from "./chunk-LDP5OD6N.js";
+} from "./chunk-EU2B4P3D.js";
 import {
   getHomebrewLatestVersion,
   getInstallationInfo,
   resolveUpdateCommand
-} from "./chunk-V2NDP3I4.js";
+} from "./chunk-7XL4WRXM.js";
 import {
   createDebugLogger
-} from "./chunk-UHQFIS7N.js";
+} from "./chunk-EAHOJF6V.js";
 import {
   init_esbuild_shims
 } from "./chunk-5O2XNYP6.js";

package/chunks/{chunk-ZFKOCECU.js → chunk-5ICKESC3.js}

@@ -3,11 +3,11 @@
 import {
   TURN_INTERRUPTION_HISTORY_TAIL_COUNT,
   detectTurnInterruption
-} from "./chunk-KUX5D6DK.js";
+} from "./chunk-NT7LXVV5.js";
 import {
   SessionService,
   buildApiHistoryFromConversation
-} from "./chunk-TGWAQ5RB.js";
+} from "./chunk-ZBDYI7VM.js";
 import {
   init_esbuild_shims
 } from "./chunk-5O2XNYP6.js";

package/chunks/{chunk-3I6UTTDX.js → chunk-67AY5D3M.js}

@@ -5,7 +5,7 @@ import {
   getErrorMessage,
   isAbortError,
   isNodeError
-} from "./chunk-UHQFIS7N.js";
+} from "./chunk-EAHOJF6V.js";
 import {
   init_esbuild_shims
 } from "./chunk-5O2XNYP6.js";
@@ -5748,39 +5748,39 @@ var DEFAULT_CONTEXT_FILENAME = "QWEN.md";
 var AGENT_CONTEXT_FILENAME = "AGENTS.md";
 var LOCAL_CONTEXT_FILENAME = "QWEN.local.md";
 var MEMORY_SECTION_HEADER = "## Qwen Added Memories";
-var currentGeminiMdFilename = [
+var currentMemoryFilename = [
   DEFAULT_CONTEXT_FILENAME,
   AGENT_CONTEXT_FILENAME
 ];
-function setGeminiMdFilename(newFilename) {
+function setMemoryFilename(newFilename) {
   if (Array.isArray(newFilename)) {
     if (newFilename.length > 0) {
-      currentGeminiMdFilename = newFilename.map((name) => name.trim());
+      currentMemoryFilename = newFilename.map((name) => name.trim());
     }
   } else if (newFilename && newFilename.trim() !== "") {
-    currentGeminiMdFilename = newFilename.trim();
+    currentMemoryFilename = newFilename.trim();
   }
 }
-__name(setGeminiMdFilename, "setGeminiMdFilename");
-function getCurrentGeminiMdFilename() {
-  if (Array.isArray(currentGeminiMdFilename)) {
-    for (const entry of currentGeminiMdFilename) {
+__name(setMemoryFilename, "setMemoryFilename");
+function getCurrentMemoryFilename() {
+  if (Array.isArray(currentMemoryFilename)) {
+    for (const entry of currentMemoryFilename) {
       if (typeof entry === "string" && entry.trim() !== "") {
         return entry.trim();
       }
     }
     return DEFAULT_CONTEXT_FILENAME;
   }
-  return currentGeminiMdFilename;
+  return currentMemoryFilename;
 }
-__name(getCurrentGeminiMdFilename, "getCurrentGeminiMdFilename");
-function getAllGeminiMdFilenames() {
-  if (Array.isArray(currentGeminiMdFilename)) {
-    return currentGeminiMdFilename;
+__name(getCurrentMemoryFilename, "getCurrentMemoryFilename");
+function getAllMemoryFilenames() {
+  if (Array.isArray(currentMemoryFilename)) {
+    return currentMemoryFilename;
   }
-  return [currentGeminiMdFilename];
+  return [currentMemoryFilename];
 }
-__name(getAllGeminiMdFilenames, "getAllGeminiMdFilenames");
+__name(getAllMemoryFilenames, "getAllMemoryFilenames");
 
 // packages/core/src/utils/pdf.ts
 init_esbuild_shims();
@@ -7486,7 +7486,7 @@ var FileExclusions = class {
       patterns.push(...DEFAULT_FILE_EXCLUDES);
     }
     if (includeDynamicPatterns) {
-      for (const filename of getAllGeminiMdFilenames()) {
+      for (const filename of getAllMemoryFilenames()) {
         patterns.push(`**/${filename}`);
       }
     }
@@ -9457,9 +9457,9 @@ export {
   loadIconvLite,
   LOCAL_CONTEXT_FILENAME,
   MEMORY_SECTION_HEADER,
-  setGeminiMdFilename,
-  getCurrentGeminiMdFilename,
-  getAllGeminiMdFilenames,
+  setMemoryFilename,
+  getCurrentMemoryFilename,
+  getAllMemoryFilenames,
   FileExclusions,
   getCachedEncodingForBuffer,
   getSystemEncoding,

package/chunks/chunk-6HUXPLB5.js

@@ -0,0 +1,110 @@
+// Force strict mode and setup for ESM
+"use strict";
+import {
+  init_esbuild_shims
+} from "./chunk-5O2XNYP6.js";
+import {
+  __name
+} from "./chunk-J2S4EL5Y.js";
+
+// packages/core/src/utils/no-follow-open.ts
+init_esbuild_shims();
+import fs from "node:fs";
+
+// packages/core/src/utils/file-identity.ts
+init_esbuild_shims();
+function hasVerifiableInode(ino) {
+  return Number(ino) !== 0;
+}
+__name(hasVerifiableInode, "hasVerifiableInode");
+
+// packages/core/src/utils/no-follow-open.ts
+var UNVERIFIABLE_IDENTITY_CODE = "EUNVERIFIABLE";
+function isUnverifiableIdentityError(error) {
+  return typeof error === "object" && error !== null && error.code === UNVERIFIABLE_IDENTITY_CODE;
+}
+__name(isUnverifiableIdentityError, "isUnverifiableIdentityError");
+function noFollowRejection(filePath, reason, code = "ELOOP") {
+  const error = new Error(
+    `Refusing to open '${filePath}' without a no-follow guarantee: ${reason}`
+  );
+  error.code = code;
+  return error;
+}
+__name(noFollowRejection, "noFollowRejection");
+function assertSameIdentity(filePath, before, after) {
+  if (!hasVerifiableInode(before.ino)) {
+    throw noFollowRejection(
+      filePath,
+      "the filesystem reports inode 0, so the opened file cannot be proven identical to the one that was checked",
+      UNVERIFIABLE_IDENTITY_CODE
+    );
+  }
+  if (before.dev !== after.dev || before.ino !== after.ino) {
+    throw noFollowRejection(
+      filePath,
+      "the file identity changed between the pre-open check and the open (possible symlink race)"
+    );
+  }
+}
+__name(assertSameIdentity, "assertSameIdentity");
+function getNoFollowFlag() {
+  return fs.constants?.O_NOFOLLOW;
+}
+__name(getNoFollowFlag, "getNoFollowFlag");
+function openSyncNoFollow(filePath) {
+  const baseFlags = fs.constants?.O_RDONLY ?? 0;
+  const noFollowFlag = getNoFollowFlag();
+  if (typeof noFollowFlag === "number") {
+    return fs.openSync(filePath, baseFlags | noFollowFlag);
+  }
+  const before = fs.lstatSync(filePath);
+  if (before.isSymbolicLink()) {
+    throw noFollowRejection(filePath, "the path is a symlink");
+  }
+  const fd = fs.openSync(filePath, baseFlags);
+  try {
+    assertSameIdentity(filePath, before, fs.fstatSync(fd));
+  } catch (error) {
+    try {
+      fs.closeSync(fd);
+    } catch {
+    }
+    throw error;
+  }
+  return fd;
+}
+__name(openSyncNoFollow, "openSyncNoFollow");
+async function openNoFollow(filePath) {
+  const baseFlags = fs.constants?.O_RDONLY ?? 0;
+  const noFollowFlag = getNoFollowFlag();
+  if (typeof noFollowFlag === "number") {
+    return fs.promises.open(filePath, baseFlags | noFollowFlag);
+  }
+  const before = await fs.promises.lstat(filePath);
+  if (before.isSymbolicLink()) {
+    throw noFollowRejection(filePath, "the path is a symlink");
+  }
+  const handle = await fs.promises.open(filePath, baseFlags);
+  try {
+    assertSameIdentity(filePath, before, await handle.stat());
+  } catch (error) {
+    await handle.close().catch(() => {
+    });
+    throw error;
+  }
+  return handle;
+}
+__name(openNoFollow, "openNoFollow");
+
+export {
+  hasVerifiableInode,
+  isUnverifiableIdentityError,
+  openSyncNoFollow,
+  openNoFollow
+};
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/chunks/{chunk-BRVWYMKV.js → chunk-6MBXY6WM.js}

@@ -2,7 +2,7 @@
 "use strict";
 import {
   writeStderrLine
-} from "./chunk-KGJGEEVR.js";
+} from "./chunk-7FA2II6K.js";
 import {
   init_esbuild_shims
 } from "./chunk-5O2XNYP6.js";

package/chunks/{chunk-6LFTG244.js → chunk-6NWPR2EB.js}

@@ -6,11 +6,12 @@ import {
   OFFICE_DOCUMENT_EXTENSIONS,
   hasControlCharacter,
   hasUnsafeDisplayPayload,
+  pathHasSkippedDirectoryComponent,
   toCanonicalWorkspaceArtifactPath
-} from "./chunk-6IUNAPLR.js";
+} from "./chunk-W4BDHLRT.js";
 import {
   checkTeamMemorySecrets
-} from "./chunk-VTHREBQM.js";
+} from "./chunk-UKYXYWI2.js";
 import {
   CommitAttributionService,
   FileEncoding,
@@ -19,27 +20,27 @@ import {
   detectLineEnding,
   getDiffStat,
   needsUtf8Bom
-} from "./chunk-TGWAQ5RB.js";
+} from "./chunk-ZBDYI7VM.js";
 import {
   FileOperationEvent,
   getLanguageFromFilePath,
   logFileOperation
-} from "./chunk-L2M46FP5.js";
+} from "./chunk-FXUSWLBF.js";
 import {
   fileExists,
   getSpecificMimeType
-} from "./chunk-3I6UTTDX.js";
+} from "./chunk-67AY5D3M.js";
 import {
   isAnyAutoMemPath,
   isTeamAutoMemPath
-} from "./chunk-6PJOTWAN.js";
+} from "./chunk-HT5S5TRQ.js";
 import {
   BaseDeclarativeTool,
   BaseToolInvocation,
   StructuredToolError,
   ToolDisplayNames,
   ToolNames
-} from "./chunk-UTLCH2FK.js";
+} from "./chunk-LYSZVCCD.js";
 import {
   createDebugLogger,
   getErrorMessage,
@@ -47,7 +48,7 @@ import {
   makeRelative,
   shortenPath,
   unescapePath
-} from "./chunk-UHQFIS7N.js";
+} from "./chunk-EAHOJF6V.js";
 import {
   init_esbuild_shims
 } from "./chunk-5O2XNYP6.js";
@@ -376,7 +377,7 @@ var WriteFileToolInvocation = class extends BaseToolInvocation {
           `User modified the \`content\` to be: ${content}`
         );
       }
-      const artifact = buildWorkspaceArtifactMetadata(
+      const artifact = this.params.record_as_artifact === false ? null : buildWorkspaceArtifactMetadata(
         this.config,
         file_path,
         postWriteSizeBytes
@@ -498,6 +499,9 @@ function resolveRecordedWorkspaceFile(config, filePath) {
   if (!workspacePath) {
     return null;
   }
+  if (pathHasSkippedDirectoryComponent(workspacePath)) {
+    return null;
+  }
   return { filePath: resolvedFile, workspacePath };
 }
 __name(resolveRecordedWorkspaceFile, "resolveRecordedWorkspaceFile");
@@ -512,6 +516,8 @@ var WriteFileTool = class _WriteFileTool extends BaseDeclarativeTool {
       ToolDisplayNames.WRITE_FILE,
       `Writes content to a specified file in the local filesystem. A request to create or generate a file does not establish that the target path is new. Unless the target's absence or current text contents have already been established in this session, you MUST use the ${ToolNames.READ_FILE} tool first; if the file does not exist, then create it. With prior-read enforcement enabled, blind overwrites are rejected. The file_path argument MUST be an absolute path. Always construct it by combining the project root with the file's relative path (e.g. project root '/path/to/project/' + relative 'foo/bar.txt' = '/path/to/project/foo/bar.txt'). If the user provides a relative path, resolve it against the project root first.
 
+Artifact-like files such as HTML, PDF, images, notebooks, and office documents are automatically registered as session artifacts. Intermediate files that exist only to produce another artifact \u2014 for example HTML written solely to print a PDF \u2014 must set record_as_artifact=false, or be written under .qwen/tmp/ so they are not registered. Delete those intermediates when done.
+
 The user has the ability to modify \`content\`. If modified, this will be stated in the response.`,
       "edit" /* Edit */,
       {
@@ -523,6 +529,10 @@ The user has the ability to modify \`content\`. If modified, this will be stated
           content: {
             description: "The content to write to the file.",
             type: "string"
+          },
+          record_as_artifact: {
+            description: "Set false for intermediate files that should not appear as session artifacts, such as HTML used only to print a PDF. Defaults to true for artifact-like extensions.",
+            type: "boolean"
           }
         },
         required: ["file_path", "content"],