@botconnector/bccli 0.4.9 → 0.4.11

package/dist/sdk.js

@@ -178,6 +178,7 @@ Options:
   -r, --resume                  pick a session to continue
       --allow-all               run all tools without asking for permission
       --allowed-tools <a,b>     tools allowed without asking: bash, edit, fetch
+      --fail-on-tool-error      with -p: exit 1 when any tool call fails (for CI)
   -w, --worktree <name>        run in git worktree ../<repo>.worktrees/<name> (created, or reused if it exists)
       --output-format <fmt>     text | json | stream-json for -p (machine-readable output)
       --permission-mode <mode>  default | acceptEdits | plan | allowAll
@@ -208,6 +209,7 @@ Opsi:
   -r, --resume                  pilih sesi untuk dilanjutkan
       --allow-all               jalankan semua alat tanpa minta izin
       --allowed-tools <a,b>     alat yang boleh tanpa izin: bash, edit, fetch
+      --fail-on-tool-error      dengan -p: keluar 1 bila ada tool gagal (untuk CI)
   -w, --worktree <name>        jalankan di git worktree ../<repo>.worktrees/<name> (dibuat, atau dipakai ulang jika ada)
       --output-format <fmt>     text | json | stream-json untuk -p (output mesin)
       --permission-mode <mode>  default | acceptEdits | plan | allowAll
@@ -225,6 +227,7 @@ Opsi:
   "usageCap.usd must be a number greater than 0.": "usageCap.usd harus angka lebih dari 0.",
   "usageCap.usd requires usageCap.prices (USD per 1M tokens).": "usageCap.usd memerlukan usageCap.prices (USD per 1 juta token).",
   'usageCap.prices["{key}"] must have numeric input and output (USD per 1M tokens).': 'usageCap.prices["{key}"] harus punya input dan output numerik (USD per 1 juta token).',
+  'usageCap.prices["{key}"].cachedInput must be a number >= 0 (USD per 1M tokens).': 'usageCap.prices["{key}"].cachedInput harus angka >= 0 (USD per 1 juta token).',
   "usageCap needs at least one of: tokens, usd.": "usageCap memerlukan setidaknya salah satu dari: tokens, usd.",
   'updateCheck must be "on" or "off".': 'updateCheck harus "on" atau "off".',
   "repoMap must be true or false.": "repoMap harus true atau false.",
@@ -266,6 +269,7 @@ Opsi:
   'npm removed the files of {name} but the config entry {entry} remains: {reason}. bccli will refuse to start while that entry is listed \u2014 fix the config error at {path}, then run "bccli plugins remove {name}" again (safe to repeat), or delete the entry manually.': 'npm sudah menghapus file {name} tetapi entry config {entry} tertinggal: {reason}. bccli menolak start selama entry itu terdaftar \u2014 perbaiki error config di {path}, lalu jalankan lagi "bccli plugins remove {name}" (aman diulang), atau hapus entry secara manual.',
   "Skipping malformed entry: {entry} \u2014 fix it manually in {path}.": "Melewatkan entry rusak: {entry} \u2014 perbaiki manual di {path}.",
   "No managed plugins to update.": "Tidak ada plugin terelola untuk diperbarui.",
+  "No plugins are installed. Install one with: bccli plugins install <spec>": "Belum ada plugin terpasang. Pasang dengan: bccli plugins install <spec>",
   "update requires a plugin name or no argument: bccli plugins update [name]": "update butuh nama plugin atau tanpa argumen: bccli plugins update [nama]",
   "{name} updated to latest.": "{name} diperbarui ke versi terbaru.",
   "Use either --key or --logout, not both.": "Pakai --key atau --logout, jangan keduanya.",
@@ -323,6 +327,13 @@ Opsi:
   "No API key for {id} yet. Run `bccli login` or set the env var {env}.": "API key untuk {id} belum ada. Jalankan `bccli login` atau set env {env}.",
   "Error from the provider: {message}": "Error dari provider: {message}",
   "Cannot connect to {url}: {error}": "Tidak bisa terhubung ke {url}: {error}",
+  "The API key was rejected. Check the key for this provider (bccli login) or its API key environment variable.": "Kunci API ditolak. Periksa kunci provider ini (bccli login) atau env var kuncinya.",
+  "Model or endpoint not found. Check the model name and the provider base URL.": "Model atau endpoint tidak ditemukan. Periksa nama model dan base URL provider.",
+  "Rate limit reached. Wait a moment, or switch model with /model.": "Batas laju tercapai. Tunggu sebentar, atau ganti model dengan /model.",
+  "The provider is having trouble. Try again, or switch model with /model.": "Penyedia sedang bermasalah. Coba lagi, atau ganti model dengan /model.",
+  "The provider did not respond within {seconds}s. Check the connection, then try again.": "Penyedia tidak merespons dalam {seconds} detik. Periksa koneksi, lalu coba lagi.",
+  "The provider stopped sending data for {seconds}s. The answer above may be incomplete; try again.": "Penyedia berhenti mengirim data selama {seconds} detik. Jawaban di atas mungkin tidak lengkap; coba lagi.",
+  "The response ended before it finished (no finish_reason or [DONE]). The answer above is incomplete; try again.": "Respons berakhir sebelum selesai (tanpa finish_reason atau [DONE]). Jawaban di atas tidak lengkap; coba lagi.",
   "{status} from {url}: {message}": "{status} dari {url}: {message}",
   "Request failed": "Permintaan gagal",
   "Connection closed before the response finished.": "Koneksi ditutup sebelum respons selesai.",
@@ -347,7 +358,8 @@ Opsi:
   "Usage: bccli mcp {action} <name>": "Pemakaian: bccli mcp {action} <nama>",
   "{name} removed.": "{name} dihapus.",
   "{name} installed ({url}).": "{name} terpasang ({url}).",
-  "{name} is not in the catalog. For another remote server use: bccli mcp add {name} --url <url>": "{name} tidak ada di katalog. Untuk server remote lain pakai: bccli mcp add {name} --url <url>",
+  "{name} installed (stdio: {command}).": "{name} terpasang (stdio: {command}).",
+  "{name} is not in the catalog. For another server use: bccli mcp add {name} --url <url> (HTTP) or bccli mcp add {name} --command <cmd> (stdio).": "{name} tidak ada di katalog. Untuk server lain pakai: bccli mcp add {name} --url <url> (HTTP) atau bccli mcp add {name} --command <cmd> (stdio).",
   "{name} installed. Active in the next bccli session.": "{name} terpasang. Aktif di sesi bccli berikutnya.",
   "control a browser (open pages, click, fill forms, screenshot)": "kontrol browser (buka halaman, klik, isi form, screenshot)",
   "up-to-date library documentation": "dokumentasi library terbaru",
@@ -401,6 +413,8 @@ Opsi:
   "API key: env {env} only (via key_env; a plaintext key in config.yaml is never written).": "API key: hanya env {env} (melalui key_env; key plaintext tidak pernah ditulis ke config.yaml).",
   "{target}: not managed by BCCLI yet.": "{target}: belum dikelola oleh BCCLI.",
   "{target}: the BotConnector integration was removed and the config restored.": "{target}: integrasi BotConnector dilepas dan config dipulihkan.",
+  '{target}: {path} changed after BCCLI connected it, so the old backup was not copied over it. Remove the BCCLI part (provider "botconnector" or the marked block) from that file by hand.': '{target}: {path} berubah setelah BCCLI menyambungkannya, jadi backup lama tidak ditimpa ke file itu. Hapus bagian BCCLI (provider "botconnector" atau blok bertanda) dari file tersebut secara manual.',
+  "{target}: the BotConnector integration was removed. {n} file(s) were left untouched (see above); delete the BCCLI entries in them by hand for a clean removal.": "{target}: integrasi BotConnector dilepas. {n} file tidak disentuh (lihat di atas); hapus entri BCCLI di dalamnya secara manual agar bersih.",
   "Custom commands:": "Perintah custom:",
   "Skills:": "Skill:",
   "shift+tab  switch permission mode    esc  cancel the turn": "shift+tab  ganti mode izin    esc  batalkan giliran",
@@ -606,6 +620,9 @@ function resolvedUsageCap(global) {
       if (!price || !nonNegative(price.input) || !nonNegative(price.output)) {
         throw new ConfigError(t('usageCap.prices["{key}"] must have numeric input and output (USD per 1M tokens).', { key }));
       }
+      if (price.cachedInput !== void 0 && !nonNegative(price.cachedInput)) {
+        throw new ConfigError(t('usageCap.prices["{key}"].cachedInput must be a number >= 0 (USD per 1M tokens).', { key }));
+      }
     }
   }
   if (tokens2 === void 0 && usd === void 0) throw new ConfigError(t("usageCap needs at least one of: tokens, usd."));
@@ -693,7 +710,7 @@ function loadConfig(cwd, env = process.env) {
   const project = readJsonConfig(join(cwd, ".bccli", "config.json"));
   const known = { ...DEFAULT_CONFIG.providers, ...global.providers };
   const fromProject = untrustedProviders(project, known);
-  const rawFallbacks = project.fallbackModels ?? global.fallbackModels;
+  const rawFallbacks = global.fallbackModels;
   const fallbackModels = Array.isArray(rawFallbacks) ? rawFallbacks.filter((m) => typeof m === "string" && m.includes("/")) : void 0;
   return {
     model: project.model ?? global.model ?? DEFAULT_CONFIG.model,
@@ -773,7 +790,9 @@ function resolveModel(config, modelRef, env = process.env) {
   if (!provider) {
     throw new ConfigError(t('Provider "{id}" is not in the config. Available: {list}', { id: providerId, list: Object.keys(config.providers).join(", ") }));
   }
-  const apiKey = readCredentials(env)[providerId] || (provider.apiKeyEnv ? env[provider.apiKeyEnv] : void 0) || void 0;
+  const untrusted = config.projectProviders?.includes(providerId) ?? false;
+  const stored = untrusted ? void 0 : readCredentials(env)[providerId];
+  const apiKey = stored || (provider.apiKeyEnv ? env[provider.apiKeyEnv] : void 0) || void 0;
   if (provider.apiKeyEnv && !apiKey) {
     throw new ConfigError(t("No API key for {id} yet. Run `bccli login` or set the env var {env}.", { id: providerId, env: provider.apiKeyEnv }));
   }
@@ -871,7 +890,7 @@ var Permissions = class {
   }
   /** Rules that "[a] allow for this session" would add; undefined when it must always be asked. */
   rulesFor(req) {
-    if (requiresSensitiveToolApproval(req) && (req.kind === "read" || process.env.BC_TOOL_POLICY_ENFORCE === "true"))
+    if (requiresSensitiveToolApproval(req) && (req.kind === "read" || req.kind === "edit" || process.env.BC_TOOL_POLICY_ENFORCE === "true"))
       return void 0;
     if (req.kind === "edit") return this.editInProject(req.target) ? ["edit(project)"] : void 0;
     if (req.kind === "fetch") {
@@ -893,7 +912,8 @@ var Permissions = class {
   }
   check(req) {
     if (this.mode === "plan" && req.kind !== "read") return "deny";
-    if (req.kind === "read" && this.mode !== "allowAll" && requiresSensitiveToolApproval(req)) return "ask";
+    if ((req.kind === "read" || req.kind === "edit") && this.mode !== "allowAll" && requiresSensitiveToolApproval(req))
+      return "ask";
     if (process.env.BC_TOOL_POLICY_ENFORCE === "true" && requiresSensitiveToolApproval(req)) return "ask";
     if (req.kind === "read") return "allow";
     if (this.mode === "allowAll") return "allow";
@@ -988,6 +1008,9 @@ function parseCliArgs(argv) {
       continue: { type: "boolean", short: "c" },
       resume: { type: "boolean", short: "r" },
       "allow-all": { type: "boolean" },
+      command: { type: "string" },
+      args: { type: "string" },
+      "fail-on-tool-error": { type: "boolean" },
       "allowed-tools": { type: "string" },
       worktree: { type: "string", short: "w" },
       "output-format": { type: "string" },
@@ -1061,6 +1084,7 @@ function parseCliArgs(argv) {
     continue: !!values.continue,
     resume: !!values.resume,
     allowAll: !!values["allow-all"],
+    failOnToolError: !!values["fail-on-tool-error"],
     allowedTools: (values["allowed-tools"] ?? "").split(",").map((s) => s.trim()).filter(Boolean),
     worktree: values.worktree,
     outputFormat,
@@ -1072,6 +1096,8 @@ function parseCliArgs(argv) {
     logout: !!values.logout,
     subArgs: ["models", "plugins", "gh-bot", "provider", "mcp", "connect", "disconnect", "integrations", "completion", "stats", "export", "import", "pr"].includes(command) ? rest : [],
     url: values.url,
+    stdioCommand: values.command,
+    stdioArgs: values.args,
     name: values.name,
     keyEnv: values["key-env"],
     values: values.value ?? [],
@@ -1160,6 +1186,17 @@ function outputReasoningSummary(items) {
   }).map((part) => part && typeof part === "object" && "text" in part && typeof part.text === "string" ? part.text : "").filter(Boolean).join("\n");
 }
 var retryable = (status) => status === 429 || status >= 500;
+function httpIdleMs() {
+  const raw = Number(process.env.BCCLI_HTTP_IDLE_TIMEOUT_MS);
+  return Number.isFinite(raw) && raw > 0 ? raw : 6e4;
+}
+function statusHint(status) {
+  if (status === 401 || status === 403) return t("The API key was rejected. Check the key for this provider (bccli login) or its API key environment variable.");
+  if (status === 404) return t("Model or endpoint not found. Check the model name and the provider base URL.");
+  if (status === 429) return t("Rate limit reached. Wait a moment, or switch model with /model.");
+  if (status >= 500) return t("The provider is having trouble. Try again, or switch model with /model.");
+  return void 0;
+}
 function detectRepetition(text) {
   const tail = text.slice(-600);
   for (let len = 1; len <= 12; len++) {
@@ -1202,7 +1239,7 @@ var toUsage = (u) => u ? {
   ...u.prompt_tokens_details?.cached_tokens != null ? { cachedInputTokens: u.prompt_tokens_details.cached_tokens } : {},
   ...u.prompt_tokens_details?.cache_write_tokens != null ? { cacheWriteTokens: u.prompt_tokens_details.cache_write_tokens } : {}
 } : void 0;
-async function readStream(res, onText, onThinking) {
+async function readStream(res, onText, onThinking, signal) {
   let text = "";
   let thinking = "";
   const splitter = new ThinkSplitter();
@@ -1219,6 +1256,7 @@ async function readStream(res, onText, onThinking) {
   };
   let usage;
   let finishReason;
+  let sawDone = false;
   const calls = [];
   const byIndex = /* @__PURE__ */ new Map();
   let current2;
@@ -1228,7 +1266,11 @@ async function readStream(res, onText, onThinking) {
   const handle = (line) => {
     if (!line.startsWith("data:")) return;
     const data = line.slice(5).trim();
-    if (!data || data === "[DONE]") return;
+    if (!data) return;
+    if (data === "[DONE]") {
+      sawDone = true;
+      return;
+    }
     let event;
     try {
       event = JSON.parse(data);
@@ -1257,18 +1299,45 @@ async function readStream(res, onText, onThinking) {
       if (tc.function?.arguments) target.arguments += tc.function.arguments;
     }
   };
-  for await (const chunk of res.body) {
-    buffer += decoder.decode(chunk, { stream: true });
-    let newline = buffer.indexOf("\n");
-    while (newline >= 0 && loopAt < 0) {
-      handle(buffer.slice(0, newline).trim());
-      buffer = buffer.slice(newline + 1);
-      newline = buffer.indexOf("\n");
+  const iterator = res.body[Symbol.asyncIterator]();
+  const idle = httpIdleMs();
+  const onAbort = () => void iterator.return?.();
+  if (signal?.aborted) onAbort();
+  else signal?.addEventListener("abort", onAbort);
+  try {
+    for (; ; ) {
+      let timer;
+      const stalled = new Promise((_, reject) => {
+        timer = setTimeout(
+          () => reject(new ProviderError(t("The provider stopped sending data for {seconds}s. The answer above may be incomplete; try again.", { seconds: String(Math.round(idle / 1e3)) }))),
+          idle
+        );
+      });
+      let step;
+      try {
+        step = await Promise.race([iterator.next(), stalled]);
+      } finally {
+        if (timer) clearTimeout(timer);
+      }
+      if (step.done) break;
+      buffer += decoder.decode(step.value, { stream: true });
+      let newline = buffer.indexOf("\n");
+      while (newline >= 0 && loopAt < 0) {
+        handle(buffer.slice(0, newline).trim());
+        buffer = buffer.slice(newline + 1);
+        newline = buffer.indexOf("\n");
+      }
+      if (loopAt >= 0) return { text: text.slice(0, loopAt), toolCalls: [], thinking: thinking || void 0, usage, finishReason: "repetition" };
     }
-    if (loopAt >= 0) return { text: text.slice(0, loopAt), toolCalls: [], thinking: thinking || void 0, usage, finishReason: "repetition" };
+  } finally {
+    signal?.removeEventListener("abort", onAbort);
+    void iterator.return?.();
   }
   handle(buffer.trim());
   emit(splitter.flush());
+  if (!sawDone && !finishReason) {
+    throw new ProviderError(t("The response ended before it finished (no finish_reason or [DONE]). The answer above is incomplete; try again."));
+  }
   const toolCalls = calls.map((call, index) => ({ ...call, id: call.id || `call_${index}` }));
   return { text, toolCalls, thinking: thinking || void 0, usage, finishReason };
 }
@@ -1479,7 +1548,7 @@ function hasPendingProgrammaticReplay(messages) {
   }
   return pending;
 }
-async function readResponsesStream(res, onText, onThinking) {
+async function readResponsesStream(res, onText, onThinking, signal) {
   let text = "";
   let thinking = "";
   let usage;
@@ -1581,17 +1650,28 @@ async function readResponsesStream(res, onText, onThinking) {
       );
     }
   };
-  for await (const chunk of res.body) {
-    buffer += decoder.decode(chunk, { stream: true });
-    let newline = buffer.indexOf("\n");
-    while (newline >= 0 && loopAt < 0) {
-      handle(buffer.slice(0, newline).trim());
-      buffer = buffer.slice(newline + 1);
-      newline = buffer.indexOf("\n");
-    }
-    if (loopAt >= 0) {
-      return { text: text.slice(0, loopAt), toolCalls: [], usage, finishReason: "repetition" };
+  const iterator = res.body[Symbol.asyncIterator]();
+  const onAbort = () => void iterator.return?.();
+  if (signal?.aborted) onAbort();
+  else signal?.addEventListener("abort", onAbort);
+  try {
+    for (; ; ) {
+      const step = await iterator.next();
+      if (step.done) break;
+      buffer += decoder.decode(step.value, { stream: true });
+      let newline = buffer.indexOf("\n");
+      while (newline >= 0 && loopAt < 0) {
+        handle(buffer.slice(0, newline).trim());
+        buffer = buffer.slice(newline + 1);
+        newline = buffer.indexOf("\n");
+      }
+      if (loopAt >= 0) {
+        return { text: text.slice(0, loopAt), toolCalls: [], usage, finishReason: "repetition" };
+      }
     }
+  } finally {
+    signal?.removeEventListener("abort", onAbort);
+    void iterator.return?.();
   }
   handle(buffer.trim());
   return {
@@ -1964,12 +2044,26 @@ function createProvider(options) {
         await sleep(delay, signal);
       }
       let res;
+      const idleAbort = new AbortController();
+      const forwardAbort = () => idleAbort.abort(signal?.reason);
+      if (signal?.aborted) forwardAbort();
+      else signal?.addEventListener("abort", forwardAbort);
+      const idle = httpIdleMs();
+      const headerTimer = setTimeout(() => idleAbort.abort(new Error("idle-timeout")), idle);
       try {
-        res = await doFetch(`${baseURL}${path}`, { method: "POST", headers, body: JSON.stringify(body), signal });
+        res = await doFetch(`${baseURL}${path}`, { method: "POST", headers, body: JSON.stringify(body), signal: idleAbort.signal });
       } catch (error) {
         if (signal?.aborted) throw error;
+        if (idleAbort.signal.aborted) {
+          throw new ProviderError(
+            t("The provider did not respond within {seconds}s. Check the connection, then try again.", { seconds: String(Math.round(idle / 1e3)) })
+          );
+        }
         lastError = new ProviderError(t("Cannot connect to {url}: {error}", { url: baseURL, error: error.message }));
         continue;
+      } finally {
+        clearTimeout(headerTimer);
+        signal?.removeEventListener("abort", forwardAbort);
       }
       if (res.ok) return res;
       const retryHeader = res.headers.get("retry-after");
@@ -1978,7 +2072,9 @@ function createProvider(options) {
         if (Number.isFinite(secs) && secs > 0 && secs <= 30) retryAfterWaitMs = Math.ceil(secs * 1e3);
       }
       const text = await res.text().catch(() => "");
-      lastError = new ProviderError(t("{status} from {url}: {message}", { status: res.status, url: baseURL, message: errorMessage(text) }), res.status);
+      const raw = t("{status} from {url}: {message}", { status: res.status, url: baseURL, message: errorMessage(text) });
+      const hint = statusHint(res.status);
+      lastError = new ProviderError(hint ? `${hint} (${raw})` : raw, res.status);
       const deterministicQuota429 = res.status === 429 && /"code"\s*:\s*"(?:luna_monthly_quota_exhausted|plan_allowance_exhausted)"/i.test(text);
       if (!retryable(res.status) || deterministicQuota429) throw lastError;
     }
@@ -2019,7 +2115,7 @@ function createProvider(options) {
         );
         if ((res2.headers.get("content-type") ?? "").includes("application/json")) return readResponsesJson(res2, onThinking);
         if (!res2.body) throw new ProviderError(t("Empty response from the provider"));
-        return readResponsesStream(res2, onText, onThinking);
+        return readResponsesStream(res2, onText, onThinking, signal);
       }
       const res = await post(
         "/chat/completions",
@@ -2028,7 +2124,7 @@ function createProvider(options) {
       );
       if ((res.headers.get("content-type") ?? "").includes("application/json")) return readJson(res, onText, onThinking);
       if (!res.body) throw new ProviderError(t("Empty response from the provider"));
-      return readStream(res, onText, onThinking);
+      return readStream(res, onText, onThinking, signal);
     },
     async listModels() {
       const res = await doFetch(`${baseURL}/models`, { headers });
@@ -2301,60 +2397,39 @@ function darwinProfile(cwd, network) {
     network ? "(allow network*)" : "(deny network*)"
   ].join("\n");
 }
+function bwrapArgv(cwd, network, command) {
+  return [
+    "bwrap",
+    "--ro-bind",
+    "/",
+    "/",
+    "--dev-bind",
+    "/dev",
+    "/dev",
+    "--proc",
+    "/proc",
+    "--bind",
+    cwd,
+    cwd,
+    "--tmpfs",
+    "/tmp",
+    "--die-with-parent",
+    ...network ? [] : ["--unshare-net"],
+    "--",
+    "/bin/bash",
+    "-c",
+    command
+  ];
+}
 function sandboxArgv(command, opts) {
   if (opts.platform === "darwin") {
     return ["sandbox-exec", "-p", darwinProfile(opts.cwd, opts.network), "/bin/bash", "-c", command];
   }
   if (opts.platform === "linux") {
-    return [
-      "bwrap",
-      "--ro-bind",
-      "/",
-      "/",
-      "--dev-bind",
-      "/dev",
-      "/dev",
-      "--proc",
-      "/proc",
-      "--bind",
-      opts.cwd,
-      opts.cwd,
-      "--tmpfs",
-      "/tmp",
-      "--die-with-parent",
-      ...opts.network ? [] : ["--unshare-net"],
-      "--",
-      "/bin/bash",
-      "-c",
-      command
-    ];
+    return bwrapArgv(opts.cwd, opts.network, command);
   }
   if (opts.platform === "win32" && (opts.wslBwrap || process.env.BCCLI_WIN32_WSL_SANDBOX === "1")) {
-    const wslCwd = winPathToWsl(opts.cwd);
-    return [
-      "wsl.exe",
-      "--",
-      "bwrap",
-      "--ro-bind",
-      "/",
-      "/",
-      "--dev-bind",
-      "/dev",
-      "/dev",
-      "--proc",
-      "/proc",
-      "--bind",
-      wslCwd,
-      wslCwd,
-      "--tmpfs",
-      "/tmp",
-      "--die-with-parent",
-      ...opts.network ? [] : ["--unshare-net"],
-      "--",
-      "/bin/bash",
-      "-c",
-      command
-    ];
+    return ["wsl.exe", "--", ...bwrapArgv(winPathToWsl(opts.cwd), opts.network, command)];
   }
   return void 0;
 }
@@ -2394,7 +2469,7 @@ function killAllCommands() {
 }
 var backgrounds = /* @__PURE__ */ new Map();
 var nextBackgroundId = 1;
-function startBackground(command, cwd, env, shell) {
+function startBackground(command, cwd, env, shell, maxRetained) {
   const child = spawnChild(command, cwd, env, shell);
   const task = {
     id: nextBackgroundId++,
@@ -2415,6 +2490,10 @@ function startBackground(command, cwd, env, shell) {
     if (child.pid !== void 0) killProcessTree(child.pid);
   };
   backgrounds.set(task.id, task);
+  for (const [id, other] of backgrounds) {
+    if (backgrounds.size <= maxRetained) break;
+    if (id !== task.id && other.status === "exited") backgrounds.delete(id);
+  }
   const onData = (data) => {
     let s = data;
     if (task.head.length < HALF) {
@@ -2613,6 +2692,7 @@ var SHELL_NOTE = {
 function createBashTool(options = {}) {
   const offline = options.networkPolicy === "offline";
   const sandbox = options.sandbox === true;
+  const maxRetained = options.maxRetainedTasks ?? 50;
   const platform = options.platform ?? process.platform;
   const shell = resolveShell({ platform, env: process.env, exists: existsSync3, ...options.shellDeps });
   const childEnv = offline ? offlineEnv() : void 0;
@@ -2659,7 +2739,7 @@ Network access is off (networkPolicy "offline"): internet commands such as curl,
       }
       if (input.background) {
         if (!input.command) return { output: 'The "command" argument is required to start a background task.', isError: true };
-        const task = startBackground(exec, ctx.cwd, childEnv, shell);
+        const task = startBackground(exec, ctx.cwd, childEnv, shell, maxRetained);
         return {
           output: `Background task #${task.id} started: ${input.command}
 Poll it with {task_id: ${task.id}}; stop it with {task_id: ${task.id}, kill: true}.`
@@ -3529,6 +3609,12 @@ async function readTextResult(input, buffer) {
   const lines = buffer.toString("utf8").split(/\r?\n/);
   const start = (input.offset ?? 1) - 1;
   const limit = input.limit ?? 2e3;
+  if (start >= lines.length) {
+    return {
+      output: `offset ${input.offset} is past the end of ${input.path} (${lines.length} line(s)); start at 1.`,
+      isError: true
+    };
+  }
   const requested = lines.slice(start, start + limit);
   const shown = [];
   let size = 0;
@@ -3610,7 +3696,9 @@ var writeTool = defineTool({
   target: (input) => input.path,
   async validate(input, ctx) {
     const abs = resolvePath(ctx.cwd, input.path);
-    return existsSync4(abs) && !ctx.readFiles.has(abs) ? `${input.path} already exists. Read it with read before overwriting it.` : void 0;
+    if (existsSync4(abs) && !ctx.readFiles.has(abs)) return `${input.path} already exists. Read it with read before overwriting it.`;
+    if (isFileModifiedSinceRead(ctx.readFiles, abs)) return `${input.path} has been modified since it was last read. Read it again before overwriting it.`;
+    return void 0;
   },
   async preview(input, ctx) {
     const abs = resolvePath(ctx.cwd, input.path);
@@ -3622,6 +3710,9 @@ var writeTool = defineTool({
     if (existsSync4(abs) && !ctx.readFiles.has(abs)) {
       return { output: `${input.path} already exists. Read it with read before overwriting it.`, isError: true };
     }
+    if (isFileModifiedSinceRead(ctx.readFiles, abs)) {
+      return { output: `${input.path} has been modified since it was last read. Read it again before overwriting it.`, isError: true };
+    }
     try {
       await ctx.checkpoint?.(abs);
       await mkdir(dirname4(abs), { recursive: true });
@@ -3731,7 +3822,9 @@ function budgetStatus(usage, cap, model) {
   if (cap.usd !== void 0) {
     const price = priceFor(cap, model);
     if (price) {
-      const usd = (usage.inputTokens * price.input + usage.outputTokens * price.output) / 1e6;
+      const cached = Math.max(0, Math.min(usage.cachedInputTokens ?? 0, usage.inputTokens));
+      const cachedRate = price.cachedInput ?? price.input;
+      const usd = ((usage.inputTokens - cached) * price.input + cached * cachedRate + usage.outputTokens * price.output) / 1e6;
       if (usd >= cap.usd) return { kind: "usd", used: usd, limit: cap.usd };
     }
   }
@@ -4921,7 +5014,7 @@ async function addProviderKey(providerId, key, deps) {
 // src/session.ts
 import { randomBytes as randomBytes2 } from "crypto";
 import { appendFileSync, existsSync as existsSync10, mkdirSync as mkdirSync4, readdirSync as readdirSync3, readFileSync as readFileSync7, rmSync as rmSync2, statSync as statSync7 } from "fs";
-import { basename as basename3, join as join10 } from "path";
+import { basename as basename3, dirname as dirname8, join as join10 } from "path";
 function projectDir(home, cwd) {
   const slug = cwd.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(-100) || "root";
   return join10(home, "sessions", slug);
@@ -4947,7 +5040,6 @@ var Session = class _Session {
   }
   static create(home, cwd, now = /* @__PURE__ */ new Date()) {
     const dir = projectDir(home, cwd);
-    mkdirSync4(dir, { recursive: true });
     const stamp = now.toISOString().replace(/[:.]/g, "-");
     return new _Session(join10(dir, `${stamp}-${randomBytes2(3).toString("hex")}.jsonl`));
   }
@@ -4964,6 +5056,7 @@ var Session = class _Session {
     return _Session.list(home, cwd)[0]?.session;
   }
   write(record) {
+    mkdirSync4(dirname8(this.file), { recursive: true });
     appendFileSync(this.file, `${JSON.stringify(record)}
 `);
   }
@@ -5996,6 +6089,15 @@ function loadPlugins(specs, opts) {
 
 // src/setup.ts
 var TOOL_RULES = { bash: "bash", edit: "edit", write: "edit", fetch: "fetch" };
+var pluginCache = /* @__PURE__ */ new Map();
+function loadPluginsOnce(specs, opts) {
+  const key = JSON.stringify({ specs, home: opts.home, cwd: opts.cwd });
+  const cached = pluginCache.get(key);
+  if (cached) return cached;
+  const loaded = loadPlugins(specs, opts);
+  pluginCache.set(key, loaded);
+  return loaded;
+}
 function lunaPtcAutoEnabled(env) {
   const value = String(env.BCCLI_LUNA_PTC ?? "").trim().toLowerCase();
   return !["0", "false", "off", "no"].includes(value);
@@ -6003,6 +6105,7 @@ function lunaPtcAutoEnabled(env) {
 function createRuntime(opts) {
   const env = opts.env ?? process.env;
   const home = bccliHome(env);
+  const persistSession = opts.persistSession !== false;
   let config = loadConfig(opts.cwd, env);
   let modelRef = opts.args.model ?? config.model;
   let reasoning = opts.args.reasoning ?? config.reasoning;
@@ -6091,7 +6194,7 @@ function createRuntime(opts) {
     createRepoMapTool()
   ];
   if (config.lsp?.servers.length) baseTools.push(createDiagnosticsTool(config.lsp.servers));
-  const plugins = loadPlugins(config.plugins ?? [], {
+  const plugins = loadPluginsOnce(config.plugins ?? [], {
     home,
     cwd: opts.cwd,
     env,
@@ -6129,9 +6232,15 @@ function createRuntime(opts) {
     usageCap: config.usageCap,
     budgetModel: modelRef,
     contextWindow: contextWindowFor(modelRef, env),
-    onMessage: (m) => session.append(m),
-    onUsage: (u) => session.appendUsage({ ...u, model: modelRef }),
-    onReset: () => session.reset(),
+    onMessage: (m) => {
+      if (persistSession) session.append(m);
+    },
+    onUsage: (u) => {
+      if (persistSession) session.appendUsage({ ...u, model: modelRef });
+    },
+    onReset: () => {
+      if (persistSession) session.reset();
+    },
     onTurnStart: () => {
       for (let i = turnMarks.length - 1; i >= 0 && turnMarks[i] > agent.messages.length; i--) {
         turnMarks.splice(i, 1);

package/dist/{serve-PKUTKQQT.js → serve-EIQHEUYD.js}

@@ -3,15 +3,15 @@ import {
   createFetchTool,
   createWebSearchTool,
   isPrivateHost
-} from "./chunk-WSSJH765.js";
+} from "./chunk-6KZIOICR.js";
 import "./chunk-PSO7R5AD.js";
 import {
   loadConfig,
   readCredentials
-} from "./chunk-DRJSANKH.js";
+} from "./chunk-C2FUGQJX.js";
 import {
   t
-} from "./chunk-XCVYR5BK.js";
+} from "./chunk-G5TG43R4.js";
 
 // src/mcpServer/serve.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/{serve-JYXPQAVY.js → serve-QYDBFTHC.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   createRuntime
-} from "./chunk-KREGVQ63.js";
+} from "./chunk-6BXW7DGQ.js";
 import "./chunk-OK2USAXX.js";
-import "./chunk-CSIQDFEF.js";
-import "./chunk-WSSJH765.js";
+import "./chunk-OAXD3X4R.js";
+import "./chunk-6KZIOICR.js";
 import "./chunk-PSO7R5AD.js";
 import {
   VERSION
-} from "./chunk-HCW67S5M.js";
+} from "./chunk-N6APAYSF.js";
 import {
   LOOPBACK_BIND,
   MAX_FRAME_BYTES,
@@ -17,25 +17,25 @@ import {
   parseClientFrame,
   randomToken,
   trustFence
-} from "./chunk-Z2ELYJ5O.js";
-import "./chunk-WFZKJY3R.js";
-import "./chunk-AWBEZY4D.js";
+} from "./chunk-WSZF2CTU.js";
+import "./chunk-YYTFJUO2.js";
+import "./chunk-JFYQCPXL.js";
 import {
   listAllModels
-} from "./chunk-HPYI7L4W.js";
-import "./chunk-62UTSCWF.js";
-import "./chunk-RRECJTOG.js";
+} from "./chunk-Y6AZGGH7.js";
+import "./chunk-X24APPXO.js";
+import "./chunk-IHQGXDSG.js";
 import {
   Session
-} from "./chunk-OETLWNGS.js";
-import "./chunk-EOJNFGOP.js";
-import "./chunk-EAR2C6TS.js";
-import "./chunk-2YG6L3YO.js";
+} from "./chunk-F54FDJBD.js";
+import "./chunk-OOOS5RCT.js";
+import "./chunk-XZ2TI5HV.js";
+import "./chunk-2DFY43RP.js";
 import {
   bccliHome,
   loadConfig
-} from "./chunk-DRJSANKH.js";
-import "./chunk-XCVYR5BK.js";
+} from "./chunk-C2FUGQJX.js";
+import "./chunk-G5TG43R4.js";
 
 // src/serve.ts
 import { randomBytes } from "crypto";