@botconnector/bccli 0.4.0 → 0.4.1

package/dist/{chunk-7F3IWBPQ.js → chunk-MFHCQQEN.js}

@@ -1,8 +1,12 @@
 #!/usr/bin/env node
+import {
+  quarantineCorruptFile,
+  writeFileAtomic
+} from "./chunk-FLQPE4S5.js";
 
 // src/mcp/oauth.ts
 import { spawn } from "child_process";
-import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync } from "fs";
 import { createServer } from "http";
 import { dirname, join } from "path";
 import { auth } from "@modelcontextprotocol/sdk/client/auth.js";
@@ -12,16 +16,16 @@ function readStore(home) {
   if (!existsSync(path)) return {};
   try {
     return JSON.parse(readFileSync(path, "utf8"));
-  } catch {
+  } catch (error) {
+    quarantineCorruptFile(path, error);
     return {};
   }
 }
 function writeStore(home, store) {
   const path = oauthStorePath(home);
   mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, `${JSON.stringify(store, null, 2)}
-`, { mode: 384 });
-  chmodSync(path, 384);
+  writeFileAtomic(path, `${JSON.stringify(store, null, 2)}
+`, 384);
 }
 function hasStoredTokens(home, serverUrl) {
   return Boolean(readStore(home)[serverUrl]?.tokens);
@@ -34,9 +38,15 @@ function clearTokens(home, serverUrl) {
   writeStore(home, store);
   return true;
 }
-function defaultOpen(url) {
-  const target = url.href;
-  const child = process.platform === "win32" ? spawn("cmd", ["/c", "start", "", target], { detached: true, stdio: "ignore" }) : spawn(process.platform === "darwin" ? "open" : "xdg-open", [target], { detached: true, stdio: "ignore" });
+function openCommand(url, platform) {
+  if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+  if (platform === "win32") return { command: "rundll32.exe", args: ["url.dll,FileProtocolHandler", url.href] };
+  return { command: platform === "darwin" ? "open" : "xdg-open", args: [url.href] };
+}
+function defaultOpen(url, deps = {}) {
+  const plan = openCommand(url, deps.platform ?? process.platform);
+  if (!plan) return;
+  const child = (deps.spawn ?? spawn)(plan.command, plan.args, { detached: true, stdio: "ignore" });
   child.unref();
   child.on("error", () => {
   });

package/dist/{chunk-O7M3TGIW.js → chunk-MHIYLXJC.js}

@@ -20,8 +20,43 @@ function isAlwaysAsk(segment) {
   }
   return false;
 }
+var RUNNER_COMMANDS = /* @__PURE__ */ new Set([
+  "npm",
+  "npx",
+  "pnpm",
+  "pnpx",
+  "yarn",
+  "bun",
+  "bunx",
+  "deno",
+  "node",
+  "tsx",
+  "ts-node",
+  "python",
+  "python3",
+  "py",
+  "uv",
+  "uvx",
+  "pip",
+  "pip3",
+  "pipx",
+  "pytest",
+  "make",
+  "cargo",
+  "go",
+  "dotnet",
+  "java",
+  "ruby",
+  "bundle",
+  "rake",
+  "gradle",
+  "mvn",
+  "php",
+  "composer"
+]);
 function commandKey(segment) {
   const words = segment.trim().split(/\s+/);
+  if (RUNNER_COMMANDS.has(words[0] ?? "") && words[2] && !words[2].startsWith("-")) return words.slice(0, 3).join(" ");
   return words[1] ? `${words[0]} ${words[1]}` : words[0];
 }
 function requiresSensitiveToolApproval(req) {

package/dist/{chunk-TVALKHFB.js → chunk-PZRKU4UM.js}

@@ -20,7 +20,7 @@ import {
   parseFrontmatter,
   runHooks,
   validateGlobPattern
-} from "./chunk-M7CALSP3.js";
+} from "./chunk-BGXNR74O.js";
 import {
   createWebSearchTool,
   fetchTool
@@ -30,38 +30,38 @@ import {
 } from "./chunk-PSO7R5AD.js";
 import {
   Permissions
-} from "./chunk-O7M3TGIW.js";
+} from "./chunk-MHIYLXJC.js";
 import {
   addProviderKey
-} from "./chunk-JL5ZCSP2.js";
+} from "./chunk-GN4W3T6E.js";
 import {
   listAllModels
-} from "./chunk-XBO5GACQ.js";
+} from "./chunk-75BECX4F.js";
 import {
   providerName
-} from "./chunk-SPRNLS7K.js";
+} from "./chunk-JHPGOAXU.js";
 import {
   FileOAuthProvider,
   hasStoredTokens
-} from "./chunk-7F3IWBPQ.js";
+} from "./chunk-MFHCQQEN.js";
 import {
   Session
-} from "./chunk-QDQU6VY2.js";
+} from "./chunk-BC7UXFE4.js";
 import {
   completionAssistantMessage,
   createProvider,
   hasPendingProgrammaticReplay,
   imageUserMessage
-} from "./chunk-PUN4HMAG.js";
+} from "./chunk-WNACAUDK.js";
 import {
   expandEnvVars
-} from "./chunk-L7QI6JN2.js";
+} from "./chunk-24JN75FZ.js";
 import {
   ConfigError,
   bccliHome,
   loadConfig,
   resolveModel
-} from "./chunk-LACUWBWS.js";
+} from "./chunk-FLQPE4S5.js";
 import {
   t
 } from "./chunk-UZWJQF67.js";

package/dist/{chunk-TLPFQIS2.js → chunk-R5RE46CW.js}

@@ -2,10 +2,10 @@
 import {
   runCommand,
   runHooks
-} from "./chunk-M7CALSP3.js";
+} from "./chunk-BGXNR74O.js";
 import {
   ConfigError
-} from "./chunk-LACUWBWS.js";
+} from "./chunk-FLQPE4S5.js";
 import {
   t
 } from "./chunk-UZWJQF67.js";

package/dist/{chunk-BQ2IGPBR.js → chunk-WI22M2ID.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ConfigError
-} from "./chunk-LACUWBWS.js";
+} from "./chunk-FLQPE4S5.js";
 import {
   t
 } from "./chunk-UZWJQF67.js";

package/dist/{chunk-PUN4HMAG.js → chunk-WNACAUDK.js}

@@ -749,7 +749,7 @@ function createProvider(options) {
   const isBotConnectorCloud = /^https:\/\/api\.botconnector\.id\/v1\/?$/.test(baseURL) && apiKey?.startsWith("bc_live_");
   if (isBotConnectorCloud) {
     headers["x-botconnector-client"] = "bccli";
-    headers["x-botconnector-client-version"] = "0.4.0";
+    headers["x-botconnector-client-version"] = "0.4.1";
   }
   const useNativeResponses = isBotConnectorCloud && providerId === "bc-cloud" && model === "gpt-6-luna";
   const useResponsesWebSocket = useNativeResponses && Boolean(apiKey) && (fetchOverride === void 0 || responsesWebSocketFactory !== void 0);
@@ -780,7 +780,7 @@ function createProvider(options) {
         baseURL: baseURL.replace(/\/+$/, ""),
         defaultHeaders: {
           "x-botconnector-client": "bccli",
-          "x-botconnector-client-version": "0.4.0"
+          "x-botconnector-client-version": "0.4.1"
         }
       });
       lunaWs = responsesWebSocketFactory ? responsesWebSocketFactory(client) : new ResponsesWS(client, { reconnect: null });
@@ -843,8 +843,13 @@ function createProvider(options) {
       } catch (error) {
         const err = error instanceof ProviderError ? error : new ProviderError(error.message);
         const lostPrevious = err.code === "previous_response_not_found";
+        const handshakeStatus = /unexpected server response:\s*(\d{3})\b/i.exec(err.message);
+        const handshakeRejected = Boolean(handshakeStatus && Number(handshakeStatus[1]) >= 400);
         const connectionLost = /websocket|connection closed|socket|network/i.test(err.message) || err.code === "websocket_connection_limit_reached";
         resetLunaWebSocket();
+        if (!emittedText && !signal?.aborted && handshakeRejected) {
+          throw new ProviderError(err.message, Number(handshakeStatus?.[1]), "bc_ws_http_fallback");
+        }
         if (attempt === 0 && !emittedText && !signal?.aborted && (plan.incremental || lostPrevious || connectionLost)) {
           continue;
         }
@@ -871,7 +876,8 @@ function createProvider(options) {
       if (res.ok) return res;
       const text = await res.text().catch(() => "");
       lastError = new ProviderError(t("{status} from {url}: {message}", { status: res.status, url: baseURL, message: errorMessage(text) }), res.status);
-      if (!retryable(res.status)) throw lastError;
+      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;
     }
     throw lastError ?? new ProviderError(t("Request failed"));
   }

package/dist/{chunk-KEMYIGCP.js → chunk-XV7ZVL4J.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   MODE_ORDER
-} from "./chunk-O7M3TGIW.js";
+} from "./chunk-MHIYLXJC.js";
 import {
   REASONING_LEVELS,
   isReasoningLevel
 } from "./chunk-BLOYFIAD.js";
 import {
   ConfigError
-} from "./chunk-LACUWBWS.js";
+} from "./chunk-FLQPE4S5.js";
 import {
   parseLang,
   t

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -2,42 +2,42 @@
 import {
   resolveWorktree,
   runPrint
-} from "./chunk-TLPFQIS2.js";
+} from "./chunk-R5RE46CW.js";
 import {
   createRuntime
-} from "./chunk-TVALKHFB.js";
+} from "./chunk-PZRKU4UM.js";
 import "./chunk-QZKLZELZ.js";
-import "./chunk-M7CALSP3.js";
+import "./chunk-BGXNR74O.js";
 import "./chunk-45SDLMTV.js";
 import "./chunk-PSO7R5AD.js";
 import {
   VERSION
-} from "./chunk-6M5X2KZE.js";
+} from "./chunk-BKGFA2PT.js";
 import {
   helpText,
   parseCliArgs
-} from "./chunk-KEMYIGCP.js";
-import "./chunk-O7M3TGIW.js";
-import "./chunk-JL5ZCSP2.js";
-import "./chunk-XBO5GACQ.js";
+} from "./chunk-XV7ZVL4J.js";
+import "./chunk-MHIYLXJC.js";
+import "./chunk-GN4W3T6E.js";
+import "./chunk-75BECX4F.js";
 import {
   readGlobalConfigFile
-} from "./chunk-SPRNLS7K.js";
+} from "./chunk-JHPGOAXU.js";
 import {
   defaultLoginDeps,
   runLogin
-} from "./chunk-BNA74HPN.js";
-import "./chunk-7F3IWBPQ.js";
+} from "./chunk-BXQQCUAC.js";
+import "./chunk-MFHCQQEN.js";
 import {
   pruneSessions
-} from "./chunk-QDQU6VY2.js";
-import "./chunk-PUN4HMAG.js";
+} from "./chunk-BC7UXFE4.js";
+import "./chunk-WNACAUDK.js";
 import "./chunk-BLOYFIAD.js";
-import "./chunk-L7QI6JN2.js";
+import "./chunk-24JN75FZ.js";
 import {
   ConfigError,
   setTheme
-} from "./chunk-LACUWBWS.js";
+} from "./chunk-FLQPE4S5.js";
 import {
   resolveLanguage,
   setLanguage,
@@ -84,17 +84,17 @@ async function main() {
   if (args.worktree) cwd = (await resolveWorktree(cwd, args.worktree)).path;
   if (args.command === "login") return runLogin(args.loginProvider ?? "bc-cloud", cwd, args, defaultLoginDeps());
   if (args.command === "mcp") {
-    const { runMcpCommand } = await import("./mcpCli-QUV5SD64.js");
-    const { readSecret } = await import("./login-SYIQP46J.js");
+    const { runMcpCommand } = await import("./mcpCli-SNBDUWJN.js");
+    const { readSecret } = await import("./login-FP3BB44A.js");
     return runMcpCommand(args, { env: process.env, cwd, out: (s) => console.log(s), err: (s) => console.error(s), readSecret });
   }
   if (args.command === "provider") {
-    const { runProviderCommand } = await import("./providerCli-FAOZHOKW.js");
-    const { readSecret } = await import("./login-SYIQP46J.js");
+    const { runProviderCommand } = await import("./providerCli-NMUFXAAS.js");
+    const { readSecret } = await import("./login-FP3BB44A.js");
     return runProviderCommand(args, { env: process.env, cwd, out: (s) => console.log(s), err: (s) => console.error(s), readSecret });
   }
   if (args.command === "connect" || args.command === "disconnect" || args.command === "integrations") {
-    const { runIntegrationCommand } = await import("./integrationCli-P75R2VSC.js");
+    const { runIntegrationCommand } = await import("./integrationCli-Q2YPDTPG.js");
     return runIntegrationCommand(args, {
       env: process.env,
       cwd,
@@ -104,23 +104,22 @@ async function main() {
     });
   }
   if (args.command === "models") {
-    const { runModelsCommand } = await import("./modelsCli-TRRB5LX4.js");
+    const { runModelsCommand } = await import("./modelsCli-CZ2HNGKR.js");
     return runModelsCommand(args, { env: process.env, cwd, out: (s) => console.log(s), err: (s) => console.error(s), fetch: globalThis.fetch });
   }
   if (args.command === "update") {
-    const { runUpdateCommand } = await import("./update-K5IQ2MYR.js");
+    const { runUpdateCommand } = await import("./update-TZ2G6KQ3.js");
     return runUpdateCommand({ env: process.env });
   }
   if (args.command === "acp") {
-    const { runtimeAgent, runAcp } = await import("./acp-ATIL4JOZ.js");
+    const { runtimeAgent, runAcp } = await import("./acp-3PHBAI64.js");
     await runAcp(process.stdin, process.stdout, { cwd, newAgent: (c) => runtimeAgent(c, args.allowAll) });
     return 0;
   }
   if (args.command === "serve") {
-    const { startServe } = await import("./serve-JG7RLIUD.js");
+    const { serveBanner, startServe } = await import("./serve-X2ZV4S5U.js");
     const handle = await startServe({ port: args.port, host: args.host, token: args.token, cwd, env: process.env });
-    process.stderr.write(`bccli serve ${handle.url} \u2014 Authorization: Bearer ${handle.token}
-`);
+    process.stderr.write(serveBanner(handle, { token: args.token }));
     await new Promise((resolve) => {
       const stop = () => {
         void handle.close().finally(resolve);
@@ -131,8 +130,8 @@ async function main() {
     return 0;
   }
   if (args.command === "plugins") {
-    const { runPluginsCommand } = await import("./pluginsCli-GNW4TPVV.js");
-    const { readGlobalPlugins, updateGlobalConfig } = await import("./config-RZ5JONMX.js");
+    const { runPluginsCommand } = await import("./pluginsCli-LPIUUDWB.js");
+    const { readGlobalPlugins, updateGlobalConfig } = await import("./config-IU76CPK2.js");
     const { runNpmSync } = await import("./npmRunner-LU43GM3W.js");
     return runPluginsCommand(args, {
       out: (s) => console.log(s),
@@ -146,7 +145,7 @@ async function main() {
     });
   }
   if (args.command === "gh-bot") {
-    const { runGhBotCommand } = await import("./ghBotCli-IBCZIWT5.js");
+    const { runGhBotCommand } = await import("./ghBotCli-E3VPHNZY.js");
     return runGhBotCommand(args, { env: process.env, cwd, out: (s) => console.log(s), err: (s) => console.error(s) });
   }
   if (args.command === "completion") {
@@ -155,15 +154,15 @@ async function main() {
   }
   if (args.command === "stats") {
     const { runStatsCommand } = await import("./statsCli-CF3R7ATL.js");
-    const { bccliHome } = await import("./config-RZ5JONMX.js");
+    const { bccliHome } = await import("./config-IU76CPK2.js");
     return runStatsCommand(
       { subArgs: args.subArgs, home: bccliHome(process.env), cwd, days: args.days, tools: args.tools, models: args.models, project: args.project },
       { out: (s) => console.log(s), err: (s) => console.error(s) }
     );
   }
   if (args.command === "export" || args.command === "import") {
-    const { runExportCommand, runImportCommand } = await import("./transferCli-TK2GSVRK.js");
-    const { bccliHome } = await import("./config-RZ5JONMX.js");
+    const { runExportCommand, runImportCommand } = await import("./transferCli-YUFPI6AH.js");
+    const { bccliHome } = await import("./config-IU76CPK2.js");
     const deps = { subArgs: args.subArgs, home: bccliHome(process.env), cwd };
     const io = { out: (s) => console.log(s), err: (s) => console.error(s) };
     return args.command === "export" ? runExportCommand(deps, io) : runImportCommand(deps, io);
@@ -183,7 +182,7 @@ async function main() {
   }
   if (args.print) {
     if (!args.prompt) throw new ConfigError(t('-p mode needs a task, e.g. bccli -p "explain this repo"'));
-    const { serversToStart } = await import("./config-COPNMMV6.js");
+    const { serversToStart } = await import("./config-DIDLDONU.js");
     const plan = serversToStart(rt.home, cwd);
     for (const s of plan.needTrust) {
       console.error(t('Project MCP server "{name}" skipped (not approved yet; run interactive bccli once to approve it).', { name: s.name }));
@@ -199,13 +198,13 @@ async function main() {
   let updateMessage;
   if (rt.config.updateCheck !== "off" && !process.env.BCCLI_NO_UPDATE_CHECK) {
     try {
-      const { checkForUpdate } = await import("./update-K5IQ2MYR.js");
+      const { checkForUpdate } = await import("./update-TZ2G6KQ3.js");
       const update = await checkForUpdate({ home: rt.home, fetch: globalThis.fetch, now: /* @__PURE__ */ new Date() });
       updateMessage = update;
     } catch {
     }
   }
-  const { startInteractive } = await import("./ui-B3CJ6TGE.js");
+  const { startInteractive } = await import("./ui-IVIFNUCC.js");
   return startInteractive(rt, { initialPrompt: args.prompt, resume: args.resume, version: VERSION, updateMessage });
 }
 main().then(

package/dist/clipboardImage.d.ts

@@ -0,0 +1,17 @@
+export interface GrabDeps {
+    platform: NodeJS.Platform;
+    tmpdir: string;
+    now: Date;
+    run?(cmd: string, args: string[]): Promise<{
+        code: number;
+        output: string;
+    }>;
+}
+export declare function clipboardTarget(tmpdir: string, now: Date): string;
+/** Terminals cannot transmit images, so each platform's clipboard tool saves a PNG we can point the model at. */
+export declare function clipboardCommand(platform: NodeJS.Platform, target: string): {
+    cmd: string;
+    args: string[];
+} | undefined;
+/** Returns the saved PNG path, or undefined when the clipboard holds no image / the platform is unsupported. */
+export declare function grabClipboardImage(deps: GrabDeps): Promise<string | undefined>;

package/dist/commands.d.ts

@@ -0,0 +1,16 @@
+import type { CommandDef } from './extensions';
+/** Descriptions are English keys; wrap them in t() when showing them. */
+export declare const SLASH_COMMANDS: {
+    name: string;
+    description: string;
+}[];
+export declare function parseSlash(text: string): {
+    name: string;
+    args: string;
+} | undefined;
+export declare function expandCommand(def: CommandDef, args: string): string;
+/**
+ * /pr: the model runs gh itself (installed on PATH), so this is a prompt, not a fetch.
+ * Empty selector = the PR of the current branch, falling back to a branch diff.
+ */
+export declare function prReviewPrompt(selector: string): string;

package/dist/completion.d.ts

@@ -0,0 +1,14 @@
+import type { CliArgs } from './args';
+export declare const SHELLS: readonly ['bash', 'zsh', 'fish', 'powershell'];
+export type CompletionShell = (typeof SHELLS)[number];
+export declare function isCompletionShell(value: string): value is CompletionShell;
+/** Completion script for a supported shell (bash, zsh, fish, powershell). */
+export declare function completionScript(shell: CompletionShell): string;
+export interface CompletionDeps {
+    out(line: string): void;
+    err?(line: string): void;
+}
+/**
+ * `bccli completion <bash|zsh|fish|powershell>` — print a completion script to stdout.
+ */
+export declare function runCompletionCommand(args: Pick<CliArgs, 'subArgs'>, deps: CompletionDeps): number;

package/dist/{config-COPNMMV6.js → config-DIDLDONU.js}

@@ -9,8 +9,8 @@ import {
   removeGlobalServer,
   serversToStart,
   setProjectTrust
-} from "./chunk-L7QI6JN2.js";
-import "./chunk-LACUWBWS.js";
+} from "./chunk-24JN75FZ.js";
+import "./chunk-FLQPE4S5.js";
 import "./chunk-UZWJQF67.js";
 export {
   addGlobalServer,

package/dist/{config-RZ5JONMX.js → config-IU76CPK2.js}

@@ -5,14 +5,16 @@ import {
   bccliHome,
   globalConfigPath,
   loadConfig,
+  quarantineCorruptFile,
   readCredentials,
   readGlobalPlugins,
   readJsonConfig,
   removeCredential,
   resolveModel,
   saveCredential,
-  updateGlobalConfig
-} from "./chunk-LACUWBWS.js";
+  updateGlobalConfig,
+  writeFileAtomic
+} from "./chunk-FLQPE4S5.js";
 import "./chunk-UZWJQF67.js";
 export {
   ConfigError,
@@ -20,11 +22,13 @@ export {
   bccliHome,
   globalConfigPath,
   loadConfig,
+  quarantineCorruptFile,
   readCredentials,
   readGlobalPlugins,
   readJsonConfig,
   removeCredential,
   resolveModel,
   saveCredential,
-  updateGlobalConfig
+  updateGlobalConfig,
+  writeFileAtomic
 };

package/dist/config.d.ts

@@ -0,0 +1,97 @@
+import type { ReasoningLevel } from './reasoning';
+import type { HooksConfig } from './hooks';
+import { type Keybind, type KeybindAction } from './keybinds';
+import type { LspServer } from './lsp';
+import type { UsageCap } from './budget';
+import type { Lang } from './i18n';
+export type PermissionMode = 'default' | 'acceptEdits' | 'plan' | 'allowAll';
+export interface ProviderConfig {
+    baseURL: string;
+    apiKeyEnv?: string;
+    name?: string;
+}
+export interface Config {
+    model: string;
+    permissionMode: PermissionMode;
+    reasoning: ReasoningLevel;
+    /** Show provider-supplied reasoning summaries in the TUI. Global setting only. */
+    thinkingVisible?: boolean;
+    /** Delete saved sessions older than this many days at startup. Omitted, null or 0 keeps them until you delete them (the default). Global setting only. */
+    sessionRetentionDays?: number | null;
+    /** Click the Thinking block to expand/collapse it. Off by default: it needs terminal mouse reporting, which blocks drag-to-copy. Global setting only; ctrl+t works either way. */
+    thinkingClickCollapse?: boolean;
+    /** Tool-call step cap per turn. Omitted, null or 0 means unlimited (the default); a positive number opts into a cap. */
+    maxSteps?: number | null;
+    /** Interface language; only the global config is read for it. */
+    language?: Lang;
+    /** Tool/session hooks; only the global config is read — the project file is untrusted and must never execute code. */
+    hooks?: HooksConfig;
+    /** Attach images read from disk as vision parts. Only the global config is read; default true. */
+    vision?: boolean;
+    /** Bash network gate: "offline" blocks known internet commands. Only the global config is read. */
+    networkPolicy?: 'allow' | 'offline';
+    /** JS plugin specs, loaded at boot. Only the global config is read — the project file must never execute code. */
+    plugins?: string[];
+    /** Resolved TUI key bindings; only the global config is read (a cloned project must not rebind your keys). */
+    keybinds: Record<KeybindAction, Keybind>;
+    /** Commands run after a turn that edited files (aider --test-cmd style). Only the global config is read. */
+    verifyCommands: string[];
+    /** Per-session token/USD budget; the agent stops calling the model once it is exceeded. Only the global config is read. */
+    usageCap?: UsageCap;
+    /** Daily npm registry check with a notice when a newer bccli exists. Only the global config is read; default "on". */
+    updateCheck?: 'on' | 'off';
+    /** Include a repo map (files + top-level symbols) in the system prompt. Only the global config is read; default false. */
+    repoMap: boolean;
+    /** Color theme name. Only the global config is read; default "default". */
+    theme: string;
+    /** Prompt editing style. Only the global config is read; default "emacs". */
+    editor: 'emacs' | 'vim';
+    /** Run bash commands inside the OS sandbox (macOS sandbox-exec / Linux bwrap). Only the global config is read; default "off". */
+    sandbox: 'off' | 'on';
+    /** LSP servers used by the diagnostics tool. Only the global config is read (it spawns commands). */
+    lsp?: {
+        servers: LspServer[];
+    };
+    providers: Record<string, ProviderConfig>;
+    allow: string[];
+    /** Provider ids that came from the (untrusted) project config. */
+    projectProviders?: string[];
+}
+export interface ResolvedModel {
+    providerId: string;
+    model: string;
+    baseURL: string;
+    apiKey?: string;
+}
+export declare class ConfigError extends Error {
+}
+/**
+ * Default cap on tool-call steps per turn for the main agent: none, like Claude Code, Codex and
+ * OpenCode (its `steps` is unset = unlimited). The turn runs until the model stops or the user
+ * presses Esc. Set maxSteps in the global config to a positive number to opt into a safety cap
+ * (the "type continue" notice then appears when it is reached).
+ */
+export declare const DEFAULT_MAX_STEPS: number | null;
+export declare function bccliHome(env?: NodeJS.ProcessEnv): string;
+export declare function readJsonConfig(path: string): Partial<Config>;
+export declare function loadConfig(cwd: string, env?: NodeJS.ProcessEnv): Config;
+export declare function globalConfigPath(env?: NodeJS.ProcessEnv): string;
+export declare function readGlobalPlugins(env?: NodeJS.ProcessEnv): string[];
+export declare function writeFileAtomic(path: string, data: string, mode?: number): void;
+/**
+ * A corrupt JSON file must never be silently treated as empty: the next write would
+ * wipe whatever the user had. Move it aside in place (timestamped, same folder) so
+ * the data stays recoverable, and warn on stderr. Returns the backup path.
+ */
+export declare function quarantineCorruptFile(path: string, error: unknown): string | undefined;
+/**
+ * Read-modify-write of the global config.json. `mutate` throwing aborts before
+ * any write; the write itself is atomic (tmp + rename in the same directory),
+ * so a failed run never leaves a truncated or half-updated config.
+ */
+export declare function updateGlobalConfig(env: NodeJS.ProcessEnv, mutate: (cfg: Record<string, unknown>) => void): void;
+export declare function readCredentials(env?: NodeJS.ProcessEnv): Record<string, string>;
+export declare function saveCredential(providerId: string, key: string, env?: NodeJS.ProcessEnv): void;
+export declare function resolveModel(config: Config, modelRef: string, env?: NodeJS.ProcessEnv): ResolvedModel;
+/** Returns false when there was no stored key to remove. */
+export declare function removeCredential(providerId: string, env?: NodeJS.ProcessEnv): boolean;

package/dist/context.d.ts

@@ -0,0 +1,13 @@
+import type { SkillDef } from './extensions';
+/** Instruction files in load order: global BCCLI.md, then AGENTS.md/BCCLI.md from the filesystem root down to cwd. */
+export declare function instructionPaths(cwd: string, home: string): string[];
+export declare function loadInstructions(cwd: string, home: string): string;
+export declare function buildSystemPrompt(opts: {
+    cwd: string;
+    home: string;
+    model: string;
+    date?: string;
+    platform?: string;
+    skills?: SkillDef[];
+    repoMap?: string;
+}): string;

package/dist/contextWindow.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_CONTEXT_WINDOW = 128000;
+/** Resolves the context window for a `provider/model` ref; `BCCLI_CONTEXT_WINDOW` overrides everything. */
+export declare function contextWindowFor(modelRef: string, env?: NodeJS.ProcessEnv): number;

package/dist/diff.d.ts

@@ -0,0 +1,7 @@
+export interface DiffLine {
+    kind: 'add' | 'del' | 'ctx';
+    line: number;
+    text: string;
+}
+export declare function diffLines(oldText: string, newText: string): DiffLine[];
+export declare function formatDiff(lines: DiffLine[]): string;

package/dist/exit.d.ts

@@ -0,0 +1,9 @@
+export declare const EXIT_GRACE_MS = 1000;
+export interface ExitDeps {
+    setExitCode: (code: number) => void;
+    exit: (code: number) => void;
+    setTimer: (fn: () => void, ms: number) => {
+        unref: () => void;
+    };
+}
+export declare function settleExit(code: number, deps?: Partial<ExitDeps>): void;