@botconnector/bccli 0.4.0-beta.9 → 0.4.1

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-HPPFDAPB.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+import {
+  t
+} from "./chunk-UZWJQF67.js";
+
+// src/completion.ts
+var SHELLS = ["bash", "zsh", "fish", "powershell"];
+function isCompletionShell(value) {
+  return SHELLS.includes(value);
+}
+var COMMANDS = [
+  "completion",
+  "stats",
+  "export",
+  "import",
+  "pr",
+  "login",
+  "models",
+  "update",
+  "acp",
+  "serve",
+  "plugins",
+  "gh-bot",
+  "provider",
+  "mcp",
+  "connect",
+  "disconnect",
+  "integrations"
+];
+var FLAGS = [
+  "-p",
+  "--print",
+  "-m",
+  "--model",
+  "--reasoning",
+  "-c",
+  "--continue",
+  "-r",
+  "--resume",
+  "--allow-all",
+  "--allowed-tools",
+  "-w",
+  "--worktree",
+  "--output-format",
+  "--permission-mode",
+  "--lang",
+  "-v",
+  "--version",
+  "-h",
+  "--help"
+];
+var WORDS = [...COMMANDS, ...FLAGS].join(" ");
+function bashScript() {
+  return `# bccli bash completion \u2014 add to your shell rc:
+#   bccli completion bash > ~/.local/share/bash-completion/completions/bccli
+_bccli_complete() {
+  local cur
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  COMPREPLY=( $(compgen -W "${WORDS}" -- "$cur") )
+}
+complete -F _bccli_complete bccli
+`;
+}
+function zshScript() {
+  return `# bccli zsh completion \u2014 add to your shell rc:
+#   bccli completion zsh > "\${fpath[1]}/_bccli"
+#compdef bccli
+_bccli() {
+  local -a words_list
+  words_list=(${WORDS})
+  _describe 'command' words_list
+}
+compdef _bccli bccli
+`;
+}
+function fishScript() {
+  const lines = [
+    "# bccli fish completion \u2014 add to your config:",
+    "#   bccli completion fish > ~/.config/fish/completions/bccli.fish",
+    `# flags: ${FLAGS.join(" ")}`
+  ];
+  for (const w of COMMANDS) lines.push(`complete -c bccli -f -a '${w}'`);
+  for (const f of FLAGS) lines.push(`complete -c bccli -l '${f.replace(/^-+/, "")}'`);
+  return `${lines.join("\n")}
+`;
+}
+function powershellScript() {
+  return `# bccli powershell completion \u2014 add to your profile:
+#   bccli completion powershell >> $PROFILE
+Register-ArgumentCompleter -Native -CommandName bccli -ScriptBlock {
+  param($wordToComplete, $commandAst, $cursorPosition)
+  $words = '${WORDS}' -split ' '
+  $words | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+  }
+}
+`;
+}
+function completionScript(shell) {
+  switch (shell) {
+    case "bash":
+      return bashScript();
+    case "zsh":
+      return zshScript();
+    case "fish":
+      return fishScript();
+    case "powershell":
+      return powershellScript();
+  }
+}
+function runCompletionCommand(args, deps) {
+  const shell = (args.subArgs[0] ?? "").trim();
+  if (!shell || !isCompletionShell(shell)) {
+    deps.err?.(t("usage: bccli completion <{shells}>", { shells: SHELLS.join(", ") }));
+    return 1;
+  }
+  for (const line of completionScript(shell).split("\n")) deps.out(line);
+  return 0;
+}
+export {
+  SHELLS,
+  completionScript,
+  isCompletionShell,
+  runCompletionCommand
+};

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-YUNKPCNB.js → config-DIDLDONU.js}

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import {
   addGlobalServer,
+  expandEnvVars,
   globalMcpPath,
   projectMcpPath,
   projectTrust,
@@ -8,10 +9,12 @@ import {
   removeGlobalServer,
   serversToStart,
   setProjectTrust
-} from "./chunk-BFZXRKW5.js";
-import "./chunk-2MGINW4O.js";
+} from "./chunk-24JN75FZ.js";
+import "./chunk-FLQPE4S5.js";
+import "./chunk-UZWJQF67.js";
 export {
   addGlobalServer,
+  expandEnvVars,
   globalMcpPath,
   projectMcpPath,
   projectTrust,

package/dist/config-IU76CPK2.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import {
+  ConfigError,
+  DEFAULT_MAX_STEPS,
+  bccliHome,
+  globalConfigPath,
+  loadConfig,
+  quarantineCorruptFile,
+  readCredentials,
+  readGlobalPlugins,
+  readJsonConfig,
+  removeCredential,
+  resolveModel,
+  saveCredential,
+  updateGlobalConfig,
+  writeFileAtomic
+} from "./chunk-FLQPE4S5.js";
+import "./chunk-UZWJQF67.js";
+export {
+  ConfigError,
+  DEFAULT_MAX_STEPS,
+  bccliHome,
+  globalConfigPath,
+  loadConfig,
+  quarantineCorruptFile,
+  readCredentials,
+  readGlobalPlugins,
+  readJsonConfig,
+  removeCredential,
+  resolveModel,
+  saveCredential,
+  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;

package/dist/extensions.d.ts

@@ -0,0 +1,34 @@
+export interface SkillDef {
+    name: string;
+    description: string;
+    dir: string;
+    file: string;
+}
+export interface CommandDef {
+    name: string;
+    description?: string;
+    argumentHint?: string;
+    body: string;
+}
+export interface AgentDef {
+    name: string;
+    description: string;
+    tools?: string[];
+    model?: string;
+    prompt: string;
+    maxSteps?: number;
+    /** Run this agent concurrently with sibling task calls even when its tools can write. */
+    parallel?: boolean;
+}
+export interface ExtensionRoots {
+    cwd: string;
+    home: string;
+    userHome: string;
+}
+export declare function parseFrontmatter(text: string): {
+    data: Record<string, string | string[]>;
+    body: string;
+};
+export declare function loadSkills(r: ExtensionRoots): SkillDef[];
+export declare function loadCommands(r: ExtensionRoots): CommandDef[];
+export declare function loadAgentDefs(r: ExtensionRoots): AgentDef[];