@ashx-j/lunr-dev 0.2.13-dev.8.1 → 0.2.19-dev.10.1

package/dist/node-runtime/chunk-CH6OL6P2.js

@@ -0,0 +1,295 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  getAgentDir
+} from "./chunk-PCIGF2XK.js";
+
+// packages/coding-agent/dist/core/keybindings.js
+import { TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager } from "@ashx-j/lunr-tui";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+var KEYBINDINGS = {
+  ...TUI_KEYBINDINGS,
+  "app.interrupt": { defaultKeys: "escape", description: "Cancel or abort" },
+  "app.clear": { defaultKeys: "ctrl+c", description: "Clear editor" },
+  "app.exit": { defaultKeys: "ctrl+d", description: "Exit when editor is empty" },
+  "app.suspend": {
+    defaultKeys: process.platform === "win32" ? [] : "ctrl+z",
+    description: "Suspend to background"
+  },
+  "app.thinking.cycle": {
+    defaultKeys: "ctrl+t",
+    description: "Cycle thinking level"
+  },
+  "app.mode.cycle": {
+    defaultKeys: "shift+tab",
+    description: "Cycle permission mode"
+  },
+  "app.model.cycleForward": {
+    defaultKeys: "ctrl+p",
+    description: "Cycle to next model"
+  },
+  "app.model.cycleBackward": {
+    defaultKeys: "shift+ctrl+p",
+    description: "Cycle to previous model"
+  },
+  "app.model.select": { defaultKeys: "ctrl+l", description: "Open model selector" },
+  "app.tools.expand": { defaultKeys: [], description: "Toggle tool output (unbound; click a card instead)" },
+  "app.chat.pageUp": {
+    defaultKeys: ["shift+pageUp", "ctrl+up"],
+    description: "Scroll chat up"
+  },
+  "app.chat.pageDown": {
+    defaultKeys: ["shift+pageDown", "ctrl+down"],
+    description: "Scroll chat down"
+  },
+  "app.thinking.toggle": {
+    defaultKeys: [],
+    description: "Toggle thinking blocks"
+  },
+  "app.session.toggleNamedFilter": {
+    defaultKeys: "ctrl+n",
+    description: "Toggle named session filter"
+  },
+  "app.editor.external": {
+    defaultKeys: "ctrl+g",
+    description: "Open external editor"
+  },
+  "app.message.copy": {
+    defaultKeys: "ctrl+x",
+    description: "Copy message to clipboard"
+  },
+  "app.message.followUp": {
+    defaultKeys: "alt+enter",
+    description: "Queue follow-up message"
+  },
+  "app.message.dequeue": {
+    defaultKeys: "alt+up",
+    description: "Restore queued messages"
+  },
+  "app.clipboard.pasteImage": {
+    defaultKeys: process.platform === "win32" ? "alt+v" : "ctrl+v",
+    description: "Paste image from clipboard (text fallback)"
+  },
+  "app.session.new": { defaultKeys: [], description: "Start a new session" },
+  "app.session.tree": { defaultKeys: [], description: "Open session tree" },
+  "app.session.fork": { defaultKeys: [], description: "Fork current session" },
+  "app.session.resume": { defaultKeys: [], description: "Resume a session" },
+  "app.tree.foldOrUp": {
+    defaultKeys: process.platform === "darwin" ? ["alt+left", "ctrl+left"] : ["ctrl+left", "alt+left"],
+    description: "Fold tree branch or move up"
+  },
+  "app.tree.unfoldOrDown": {
+    defaultKeys: process.platform === "darwin" ? ["alt+right", "ctrl+right"] : ["ctrl+right", "alt+right"],
+    description: "Unfold tree branch or move down"
+  },
+  "app.tree.editLabel": {
+    defaultKeys: "shift+l",
+    description: "Edit tree label"
+  },
+  "app.tree.toggleLabelTimestamp": {
+    defaultKeys: "shift+t",
+    description: "Toggle tree label timestamps"
+  },
+  "app.session.togglePath": {
+    defaultKeys: "ctrl+p",
+    description: "Toggle session path display"
+  },
+  "app.session.toggleSort": {
+    defaultKeys: "ctrl+s",
+    description: "Toggle session sort mode"
+  },
+  "app.session.rename": {
+    defaultKeys: "ctrl+r",
+    description: "Rename session"
+  },
+  "app.session.delete": {
+    defaultKeys: "ctrl+d",
+    description: "Delete session"
+  },
+  "app.session.deleteNoninvasive": {
+    defaultKeys: "ctrl+backspace",
+    description: "Delete session when query is empty"
+  },
+  "app.models.save": {
+    defaultKeys: "ctrl+s",
+    description: "Save model selection"
+  },
+  "app.models.enableAll": {
+    defaultKeys: "ctrl+a",
+    description: "Enable all models"
+  },
+  "app.models.clearAll": {
+    defaultKeys: "ctrl+x",
+    description: "Clear all models"
+  },
+  "app.models.toggleProvider": {
+    defaultKeys: "ctrl+p",
+    description: "Toggle all models for provider"
+  },
+  "app.models.reorderUp": {
+    defaultKeys: "alt+up",
+    description: "Move model up in order"
+  },
+  "app.models.reorderDown": {
+    defaultKeys: "alt+down",
+    description: "Move model down in order"
+  },
+  "app.tree.filter.default": {
+    defaultKeys: "ctrl+d",
+    description: "Tree filter: default view"
+  },
+  "app.tree.filter.noTools": {
+    defaultKeys: "ctrl+t",
+    description: "Tree filter: hide tool results"
+  },
+  "app.tree.filter.userOnly": {
+    defaultKeys: "ctrl+u",
+    description: "Tree filter: user messages only"
+  },
+  "app.tree.filter.labeledOnly": {
+    defaultKeys: "ctrl+l",
+    description: "Tree filter: labeled entries only"
+  },
+  "app.tree.filter.all": {
+    defaultKeys: "ctrl+a",
+    description: "Tree filter: show all entries"
+  },
+  "app.tree.filter.cycleForward": {
+    defaultKeys: "ctrl+o",
+    description: "Tree filter: cycle forward"
+  },
+  "app.tree.filter.cycleBackward": {
+    defaultKeys: "shift+ctrl+o",
+    description: "Tree filter: cycle backward"
+  }
+}, KEYBINDING_NAME_MIGRATIONS = {
+  cursorUp: "tui.editor.cursorUp",
+  cursorDown: "tui.editor.cursorDown",
+  cursorLeft: "tui.editor.cursorLeft",
+  cursorRight: "tui.editor.cursorRight",
+  cursorWordLeft: "tui.editor.cursorWordLeft",
+  cursorWordRight: "tui.editor.cursorWordRight",
+  cursorLineStart: "tui.editor.cursorLineStart",
+  cursorLineEnd: "tui.editor.cursorLineEnd",
+  jumpForward: "tui.editor.jumpForward",
+  jumpBackward: "tui.editor.jumpBackward",
+  pageUp: "tui.editor.pageUp",
+  pageDown: "tui.editor.pageDown",
+  deleteCharBackward: "tui.editor.deleteCharBackward",
+  deleteCharForward: "tui.editor.deleteCharForward",
+  deleteWordBackward: "tui.editor.deleteWordBackward",
+  deleteWordForward: "tui.editor.deleteWordForward",
+  deleteToLineStart: "tui.editor.deleteToLineStart",
+  deleteToLineEnd: "tui.editor.deleteToLineEnd",
+  yank: "tui.editor.yank",
+  yankPop: "tui.editor.yankPop",
+  undo: "tui.editor.undo",
+  newLine: "tui.input.newLine",
+  submit: "tui.input.submit",
+  tab: "tui.input.tab",
+  copy: "tui.input.copy",
+  selectUp: "tui.select.up",
+  selectDown: "tui.select.down",
+  selectPageUp: "tui.select.pageUp",
+  selectPageDown: "tui.select.pageDown",
+  selectConfirm: "tui.select.confirm",
+  selectCancel: "tui.select.cancel",
+  interrupt: "app.interrupt",
+  clear: "app.clear",
+  exit: "app.exit",
+  suspend: "app.suspend",
+  cycleThinkingLevel: "app.thinking.cycle",
+  cyclePermissionMode: "app.mode.cycle",
+  cycleModelForward: "app.model.cycleForward",
+  cycleModelBackward: "app.model.cycleBackward",
+  selectModel: "app.model.select",
+  expandTools: "app.tools.expand",
+  toggleThinking: "app.thinking.toggle",
+  toggleSessionNamedFilter: "app.session.toggleNamedFilter",
+  externalEditor: "app.editor.external",
+  followUp: "app.message.followUp",
+  dequeue: "app.message.dequeue",
+  pasteImage: "app.clipboard.pasteImage",
+  newSession: "app.session.new",
+  tree: "app.session.tree",
+  fork: "app.session.fork",
+  resume: "app.session.resume",
+  treeFoldOrUp: "app.tree.foldOrUp",
+  treeUnfoldOrDown: "app.tree.unfoldOrDown",
+  treeEditLabel: "app.tree.editLabel",
+  treeToggleLabelTimestamp: "app.tree.toggleLabelTimestamp",
+  toggleSessionPath: "app.session.togglePath",
+  toggleSessionSort: "app.session.toggleSort",
+  renameSession: "app.session.rename",
+  deleteSession: "app.session.delete",
+  deleteSessionNoninvasive: "app.session.deleteNoninvasive"
+};
+function isLegacyKeybindingName(key) {
+  return key in KEYBINDING_NAME_MIGRATIONS;
+}
+function toKeybindingsConfig(value) {
+  let config = {};
+  for (let [key, binding] of Object.entries(value)) {
+    if (typeof binding == "string") {
+      config[key] = binding;
+      continue;
+    }
+    Array.isArray(binding) && binding.every((entry) => typeof entry == "string") && (config[key] = binding);
+  }
+  return config;
+}
+function migrateKeybindingsConfig(rawConfig) {
+  let config = {}, migrated = !1;
+  for (let [key, value] of Object.entries(rawConfig)) {
+    let nextKey = isLegacyKeybindingName(key) ? KEYBINDING_NAME_MIGRATIONS[key] : key;
+    if (nextKey !== key && (migrated = !0), key !== nextKey && Object.hasOwn(rawConfig, nextKey)) {
+      migrated = !0;
+      continue;
+    }
+    config[nextKey] = value;
+  }
+  return { config: orderKeybindingsConfig(config), migrated };
+}
+function orderKeybindingsConfig(config) {
+  let ordered = {};
+  for (let keybinding of Object.keys(KEYBINDINGS))
+    Object.hasOwn(config, keybinding) && (ordered[keybinding] = config[keybinding]);
+  let extras = Object.keys(config).filter((key) => !Object.hasOwn(ordered, key)).sort();
+  for (let key of extras)
+    ordered[key] = config[key];
+  return ordered;
+}
+function loadRawConfig(path) {
+  if (existsSync(path))
+    try {
+      let parsed = JSON.parse(readFileSync(path, "utf-8"));
+      return typeof parsed != "object" || parsed === null ? void 0 : parsed;
+    } catch {
+      return;
+    }
+}
+var KeybindingsManager = class _KeybindingsManager extends TuiKeybindingsManager {
+  configPath;
+  constructor(userBindings = {}, configPath) {
+    super(KEYBINDINGS, userBindings), this.configPath = configPath;
+  }
+  static create(agentDir = getAgentDir()) {
+    let configPath = join(agentDir, "keybindings.json"), userBindings = _KeybindingsManager.loadFromFile(configPath);
+    return new _KeybindingsManager(userBindings, configPath);
+  }
+  reload() {
+    this.configPath && this.setUserBindings(_KeybindingsManager.loadFromFile(this.configPath));
+  }
+  getEffectiveConfig() {
+    return this.getResolvedBindings();
+  }
+  static loadFromFile(path) {
+    let rawConfig = loadRawConfig(path);
+    return rawConfig ? toKeybindingsConfig(migrateKeybindingsConfig(rawConfig).config) : {};
+  }
+};
+
+export {
+  migrateKeybindingsConfig,
+  KeybindingsManager
+};

package/dist/node-runtime/chunk-CJECDQKP.js

@@ -0,0 +1,19 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+
+// packages/coding-agent/dist/core/cron/fire-guard.js
+var fireDepth = 0;
+function beginCronFire() {
+  fireDepth += 1;
+}
+function endCronFire() {
+  fireDepth > 0 && (fireDepth -= 1);
+}
+function isCronFire() {
+  return fireDepth > 0;
+}
+
+export {
+  beginCronFire,
+  endCronFire,
+  isCronFire
+};

package/dist/node-runtime/chunk-DAPBPCBP.js

@@ -0,0 +1,53 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+
+// packages/coding-agent/dist/builtin-extensions/pi-web-access/activity.js
+var ActivityMonitor = class {
+  entries = [];
+  maxEntries = 10;
+  listeners = /* @__PURE__ */ new Set();
+  rateLimitInfo = { used: 0, max: 10, oldestTimestamp: null, windowMs: 6e4 };
+  nextId = 1;
+  logStart(partial) {
+    let id = `act-${this.nextId++}`, entry = {
+      ...partial,
+      id,
+      startTime: Date.now(),
+      status: null
+    };
+    return this.entries.push(entry), this.entries.length > this.maxEntries && this.entries.shift(), this.notify(), id;
+  }
+  logComplete(id, status) {
+    let entry = this.entries.find((e) => e.id === id);
+    entry && (entry.endTime = Date.now(), entry.status = status, this.notify());
+  }
+  logError(id, error) {
+    let entry = this.entries.find((e) => e.id === id);
+    entry && (entry.endTime = Date.now(), entry.error = error, this.notify());
+  }
+  getEntries() {
+    return this.entries;
+  }
+  getRateLimitInfo() {
+    return this.rateLimitInfo;
+  }
+  updateRateLimit(info) {
+    this.rateLimitInfo = info, this.notify();
+  }
+  onUpdate(callback) {
+    return this.listeners.add(callback), () => this.listeners.delete(callback);
+  }
+  clear() {
+    this.entries = [], this.rateLimitInfo = { used: 0, max: 10, oldestTimestamp: null, windowMs: 6e4 }, this.notify();
+  }
+  notify() {
+    for (let cb of this.listeners)
+      try {
+        cb();
+      } catch {
+      }
+  }
+}, activityMonitor = new ActivityMonitor();
+
+export {
+  activityMonitor
+};

package/dist/node-runtime/chunk-DDGMHUOW.js

@@ -0,0 +1,305 @@
+import { createRequire as __lunrRequire } from "node:module"; const require = __lunrRequire(import.meta.url);
+import {
+  APP_NAME,
+  CONFIG_DIR_NAME,
+  ENV_AGENT_DIR,
+  ENV_SESSION_DIR
+} from "./chunk-PCIGF2XK.js";
+
+// packages/coding-agent/dist/cli/args.js
+import chalk from "chalk";
+var VALID_THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+function isValidThinkingLevel(level) {
+  return VALID_THINKING_LEVELS.includes(level);
+}
+function parseArgs(args) {
+  let result = {
+    messages: [],
+    fileArgs: [],
+    unknownFlags: /* @__PURE__ */ new Map(),
+    diagnostics: []
+  };
+  for (let i = 0; i < args.length; i++) {
+    let arg = args[i];
+    if (arg === "--help" || arg === "-h")
+      result.help = !0;
+    else if (arg === "--version" || arg === "-v")
+      result.version = !0;
+    else if (arg === "--mode" && i + 1 < args.length) {
+      let mode = args[++i];
+      (mode === "text" || mode === "json" || mode === "rpc") && (result.mode = mode);
+    } else if (arg === "--continue" || arg === "-c")
+      result.continue = !0;
+    else if (arg === "--resume" || arg === "-r")
+      result.resume = !0;
+    else if (arg === "--provider" && i + 1 < args.length)
+      result.provider = args[++i];
+    else if (arg === "--model" && i + 1 < args.length)
+      result.model = args[++i];
+    else if (arg === "--api-key" && i + 1 < args.length)
+      result.apiKey = args[++i];
+    else if (arg === "--system-prompt" && i + 1 < args.length)
+      result.systemPrompt = args[++i];
+    else if (arg === "--append-system-prompt" && i + 1 < args.length)
+      result.appendSystemPrompt = result.appendSystemPrompt ?? [], result.appendSystemPrompt.push(args[++i]);
+    else if (arg === "--name" || arg === "-n")
+      i + 1 < args.length ? result.name = args[++i] : result.diagnostics.push({ type: "error", message: "--name requires a value" });
+    else if (arg === "--no-session")
+      result.noSession = !0;
+    else if (arg === "--session" && i + 1 < args.length)
+      result.session = args[++i];
+    else if (arg === "--session-id" && i + 1 < args.length)
+      result.sessionId = args[++i];
+    else if (arg === "--fork" && i + 1 < args.length)
+      result.fork = args[++i];
+    else if (arg === "--session-dir" && i + 1 < args.length)
+      result.sessionDir = args[++i];
+    else if (arg === "--models" && i + 1 < args.length)
+      result.models = args[++i].split(",").map((s) => s.trim());
+    else if (arg === "--no-tools" || arg === "-nt")
+      result.noTools = !0;
+    else if (arg === "--no-builtin-tools" || arg === "-nbt")
+      result.noBuiltinTools = !0;
+    else if ((arg === "--tools" || arg === "-t") && i + 1 < args.length)
+      result.tools = args[++i].split(",").map((s) => s.trim()).filter((name) => name.length > 0);
+    else if ((arg === "--exclude-tools" || arg === "-xt") && i + 1 < args.length)
+      result.excludeTools = args[++i].split(",").map((s) => s.trim()).filter((name) => name.length > 0);
+    else if (arg === "--thinking" && i + 1 < args.length) {
+      let level = args[++i];
+      isValidThinkingLevel(level) ? result.thinking = level : result.diagnostics.push({
+        type: "warning",
+        message: `Invalid thinking level "${level}". Valid values: ${VALID_THINKING_LEVELS.join(", ")}`
+      });
+    } else if (arg === "--print" || arg === "-p") {
+      result.print = !0;
+      let next = args[i + 1];
+      next !== void 0 && !next.startsWith("@") && (!next.startsWith("-") || next.startsWith("---")) && (result.messages.push(next), i++);
+    } else if (arg === "--export" && i + 1 < args.length)
+      result.export = args[++i];
+    else if ((arg === "--extension" || arg === "-e") && i + 1 < args.length)
+      result.extensions = result.extensions ?? [], result.extensions.push(args[++i]);
+    else if (arg === "--no-extensions" || arg === "-ne")
+      result.noExtensions = !0;
+    else if (arg === "--skill" && i + 1 < args.length)
+      result.skills = result.skills ?? [], result.skills.push(args[++i]);
+    else if (arg === "--prompt-template" && i + 1 < args.length)
+      result.promptTemplates = result.promptTemplates ?? [], result.promptTemplates.push(args[++i]);
+    else if (arg === "--theme" && i + 1 < args.length)
+      result.themes = result.themes ?? [], result.themes.push(args[++i]);
+    else if (arg === "--no-skills" || arg === "-ns")
+      result.noSkills = !0;
+    else if (arg === "--no-prompt-templates" || arg === "-np")
+      result.noPromptTemplates = !0;
+    else if (arg === "--no-themes")
+      result.noThemes = !0;
+    else if (arg === "--no-context-files" || arg === "-nc")
+      result.noContextFiles = !0;
+    else if (arg === "--list-models")
+      i + 1 < args.length && !args[i + 1].startsWith("-") && !args[i + 1].startsWith("@") ? result.listModels = args[++i] : result.listModels = !0;
+    else if (arg === "--verbose")
+      result.verbose = !0;
+    else if (arg === "--approve" || arg === "-a")
+      result.projectTrustOverride = !0;
+    else if (arg === "--no-approve" || arg === "-na")
+      result.projectTrustOverride = !1;
+    else if (arg === "--offline")
+      result.offline = !0;
+    else if (arg.startsWith("@"))
+      result.fileArgs.push(arg.slice(1));
+    else if (arg.startsWith("--")) {
+      let eqIndex = arg.indexOf("=");
+      if (eqIndex !== -1)
+        result.unknownFlags.set(arg.slice(2, eqIndex), arg.slice(eqIndex + 1));
+      else {
+        let flagName = arg.slice(2), next = args[i + 1];
+        next !== void 0 && !next.startsWith("-") && !next.startsWith("@") ? (result.unknownFlags.set(flagName, next), i++) : result.unknownFlags.set(flagName, !0);
+      }
+    } else arg.startsWith("-") && !arg.startsWith("--") ? result.diagnostics.push({ type: "error", message: `Unknown option: ${arg}` }) : arg.startsWith("-") || result.messages.push(arg);
+  }
+  return result;
+}
+function printHelp(extensionFlags) {
+  let extensionFlagsText = extensionFlags && extensionFlags.length > 0 ? `
+${chalk.bold("Extension CLI Flags:")}
+${extensionFlags.map((flag) => {
+    let value = flag.type === "string" ? " <value>" : "", description = flag.description ?? `Registered by ${flag.extensionPath}`;
+    return `  --${flag.name}${value}`.padEnd(30) + description;
+  }).join(`
+`)}
+` : "";
+  console.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools
+
+${chalk.bold("Usage:")}
+  ${APP_NAME} [options] [@files...] [messages...]
+
+${chalk.bold("Commands:")}
+  ${APP_NAME} setup                      First-run / reconfigure optional features
+  ${APP_NAME} features [list|enable|disable]
+  ${APP_NAME} uninstall                  Remove this ${APP_NAME} install (keeps agent dir unless --purge)
+  ${APP_NAME} uninstall <source> [-l]    Remove an extension package (alias for remove)
+  ${APP_NAME} install <source> [-l]      Install extension source and add to settings
+  ${APP_NAME} remove <source> [-l]       Remove extension source from settings
+  ${APP_NAME} list                       List installed extensions from settings
+  ${APP_NAME} config [-l]                Open TUI to enable/disable package resources (Tab switches scope)
+  ${APP_NAME} gateway [\u2026]                Chat gateway daemon (requires chat-platforms feature)
+  ${APP_NAME} <command> --help           Show help for install/remove/uninstall/list/config
+
+${chalk.bold("Options:")}
+  --provider <name>              Provider name (default: google)
+  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
+  --api-key <key>                API key (defaults to env vars)
+  --system-prompt <text>         System prompt (default: coding assistant prompt)
+  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)
+  --mode <mode>                  Output mode: text (default), json, or rpc
+  --print, -p                    Non-interactive mode: process prompt and exit
+  --continue, -c                 Continue previous session
+  --resume, -r                   Select a session to resume
+  --session <path|id>            Use specific session file or partial UUID
+  --session-id <id>              Use exact project session ID, creating it if missing
+  --fork <path|id>               Fork specific session file or partial UUID into a new session
+  --session-dir <dir>            Directory for session storage and lookup
+  --no-session                   Don't save session (ephemeral)
+  --name, -n <name>              Set session display name
+  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling
+                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching
+  --no-tools, -nt                Disable all tools by default (built-in and extension)
+  --no-builtin-tools, -nbt       Disable built-in tools by default but keep extension/custom tools enabled
+  --tools, -t <tools>            Comma-separated allowlist of tool names to enable
+                                 Applies to built-in, extension, and custom tools
+  --exclude-tools, -xt <tools>   Comma-separated denylist of tool names to disable
+                                 Applies to built-in, extension, and custom tools
+  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh, max
+  --extension, -e <path>         Load an extension file (can be used multiple times)
+  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)
+  --skill <path>                 Load a skill file or directory (can be used multiple times)
+  --no-skills, -ns               Disable skills discovery and loading
+  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
+  --no-prompt-templates, -np     Disable prompt template discovery and loading
+  --theme <path>                 Load a theme file or directory (can be used multiple times)
+  --no-themes                    Disable theme discovery and loading
+  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading
+  --export <file>                Export session file to HTML and exit
+  --list-models [search]         List available models (with optional fuzzy search)
+  --verbose                      Force verbose startup (overrides quietStartup setting)
+  --approve, -a                  Trust project-local files for this run
+  --no-approve, -na              Ignore project-local files for this run
+  --offline                      Disable startup network operations (same as PI_OFFLINE=1)
+  --help, -h                     Show this help
+  --version, -v                  Show version number
+
+Extensions can register additional flags (e.g., --plan from plan-mode extension).${extensionFlagsText}
+
+${chalk.bold("Examples:")}
+  # Interactive mode
+  ${APP_NAME}
+
+  # Interactive mode with initial prompt
+  ${APP_NAME} "List all .ts files in src/"
+
+  # Include files in initial message
+  ${APP_NAME} @prompt.md @image.png "What color is the sky?"
+
+  # Non-interactive mode (process and exit)
+  ${APP_NAME} -p "List all .ts files in src/"
+
+  # Multiple messages (interactive)
+  ${APP_NAME} "Read package.json" "What dependencies do we have?"
+
+  # Continue previous session
+  ${APP_NAME} --continue "What did we discuss?"
+
+  # Start a named session
+  ${APP_NAME} --name "Refactor auth module"
+
+  # Use different model
+  ${APP_NAME} --provider openai --model gpt-4o-mini "Help me refactor this code"
+
+  # Use model with provider prefix (no --provider needed)
+  ${APP_NAME} --model openai/gpt-4o "Help me refactor this code"
+
+  # Use model with thinking level shorthand
+  ${APP_NAME} --model sonnet:high "Solve this complex problem"
+
+  # Limit model cycling to specific models
+  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o
+
+  # Limit to a specific provider with glob pattern
+  ${APP_NAME} --models "github-copilot/*"
+
+  # Cycle models with fixed thinking levels
+  ${APP_NAME} --models sonnet:high,haiku:low
+
+  # Start with a specific thinking level
+  ${APP_NAME} --thinking high "Solve this complex problem"
+
+  # Read-only mode (no file modifications possible)
+  ${APP_NAME} --tools read,grep,find,ls -p "Review the code in src/"
+
+  # Disable one tool while keeping the rest available
+  ${APP_NAME} --exclude-tools ask_question
+
+  # Export a session file to HTML
+  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl
+  ${APP_NAME} --export session.jsonl output.html
+
+${chalk.bold("Environment Variables:")}
+  ANTHROPIC_API_KEY                - Anthropic Claude API key
+  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)
+  ANT_LING_API_KEY                 - Ant Ling API key
+  OPENAI_API_KEY                   - OpenAI GPT API key
+  AZURE_OPENAI_API_KEY             - Azure OpenAI API key
+  AZURE_OPENAI_BASE_URL            - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)
+  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)
+  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)
+  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)
+  DEEPSEEK_API_KEY                 - DeepSeek API key
+  NVIDIA_API_KEY                   - NVIDIA NIM API key
+  GEMINI_API_KEY                   - Google Gemini API key
+  GROQ_API_KEY                     - Groq API key
+  CEREBRAS_API_KEY                 - Cerebras API key
+  XAI_API_KEY                      - xAI Grok API key
+  FIREWORKS_API_KEY                - Fireworks API key
+  TOGETHER_API_KEY                 - Together AI API key
+  OPENROUTER_API_KEY               - OpenRouter API key
+  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key
+  ZAI_API_KEY                      - ZAI Coding Plan API key (Global)
+  ZAI_CODING_CN_API_KEY            - ZAI Coding Plan API key (China)
+  MISTRAL_API_KEY                  - Mistral API key
+  MINIMAX_API_KEY                  - MiniMax API key
+  MOONSHOT_API_KEY                 - Moonshot AI API key
+  OPENCODE_API_KEY                 - OpenCode Zen/OpenCode Go API key
+  KIMI_API_KEY                     - Kimi For Coding API key
+  CLOUDFLARE_API_KEY               - Cloudflare API token (Workers AI and AI Gateway)
+  CLOUDFLARE_ACCOUNT_ID            - Cloudflare account id (required for both)
+  CLOUDFLARE_GATEWAY_ID            - Cloudflare AI Gateway slug (required for AI Gateway)
+  XIAOMI_API_KEY                   - Xiaomi MiMo API key (api.xiaomimimo.com billing)
+  XIAOMI_TOKEN_PLAN_CN_API_KEY     - Xiaomi MiMo Token Plan API key (China region)
+  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - Xiaomi MiMo Token Plan API key (Amsterdam region)
+  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - Xiaomi MiMo Token Plan API key (Singapore region)
+  AWS_PROFILE                      - AWS profile for Amazon Bedrock
+  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
+  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
+  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
+  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
+  ${ENV_AGENT_DIR.padEnd(32)} - Config directory (default: ~/${CONFIG_DIR_NAME}/agent)
+  ${ENV_SESSION_DIR.padEnd(32)} - Session storage directory (overridden by --session-dir)
+  PI_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
+  PI_OFFLINE                       - Disable startup network operations when set to 1/true/yes
+  PI_SHARE_VIEWER_URL              - Base URL for /share command (default: https://pi.dev/session/)
+
+${chalk.bold("Built-in Tool Names:")}
+  read   - Read file contents
+  bash   - Execute bash commands
+  edit   - Edit files with find/replace
+  write  - Write files (creates/overwrites)
+  grep   - Search file contents (read-only, off by default)
+  find   - Find files by glob pattern (read-only, off by default)
+  ls     - List directory contents (read-only, off by default)
+`);
+}
+
+export {
+  isValidThinkingLevel,
+  parseArgs,
+  printHelp
+};