@pencil-agent/nano-pencil 2.0.0-beta.4 → 2.0.0-beta.7

package/dist/cli/args.js

@@ -1,307 +1,18 @@
-/**
- * [WHO]: Args, Mode, parseArgs(), printHelp()
- * [FROM]: Depends on agent-core, chalk, config.ts, core/tools
- * [TO]: Consumed by main.ts, core/model-resolver.ts
- * [HERE]: cli/args.ts - CLI argument parsing and help display
- */
-import { normalizeAgentLoopFramework, } from "@pencil-agent/agent-core";
-import chalk from "chalk";
-import { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR } from "../config.js";
-import { allTools } from "../core/tools/index.js";
-const VALID_THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
-export function isValidThinkingLevel(level) {
-    return VALID_THINKING_LEVELS.includes(level);
-}
-function parseAgentLoopFramework(value) {
-    const normalized = normalizeAgentLoopFramework(value);
-    if (normalized === "standard" || normalized === "weak-model-compatible") {
-        return normalized;
-    }
-    return undefined;
-}
-function parsePositiveIntegerOption(flag, value) {
-    const parsed = Number(value);
-    if (Number.isInteger(parsed) && parsed > 0)
-        return parsed;
-    console.error(chalk.yellow(`Warning: Invalid ${flag} value "${value}". Expected a positive integer.`));
-    return undefined;
-}
-function parseNonNegativeIntegerOption(flag, value) {
-    const parsed = Number(value);
-    if (Number.isInteger(parsed) && parsed >= 0)
-        return parsed;
-    console.error(chalk.yellow(`Warning: Invalid ${flag} value "${value}". Expected a non-negative integer.`));
-    return undefined;
-}
-function parseUnitIntervalOption(flag, value) {
-    const parsed = Number(value);
-    if (Number.isFinite(parsed) && parsed > 0 && parsed <= 1)
-        return parsed;
-    console.error(chalk.yellow(`Warning: Invalid ${flag} value "${value}". Expected a number in (0, 1].`));
-    return undefined;
-}
-function setLoopPolicyOption(result, key, value) {
-    result.loopPolicy = result.loopPolicy ?? {};
-    result.loopPolicy[key] = value;
-}
-export function parseArgs(args, extensionFlags) {
-    const result = {
-        messages: [],
-        fileArgs: [],
-        unknownFlags: new Map(),
-    };
-    const outputTokenBudget = {};
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === "--help" || arg === "-h") {
-            result.help = true;
-        }
-        else if (arg === "--version" || arg === "-v") {
-            result.version = true;
-        }
-        else if (arg === "--mode" && i + 1 < args.length) {
-            const mode = args[++i];
-            if (mode === "text" || mode === "json" || mode === "rpc") {
-                result.mode = mode;
-            }
-        }
-        else if (arg === "--continue" || arg === "-c") {
-            result.continue = true;
-        }
-        else if (arg === "--resume" || arg === "-r") {
-            result.resume = true;
-        }
-        else if (arg === "--provider" && i + 1 < args.length) {
-            result.provider = args[++i];
-        }
-        else if (arg === "--cwd" && i + 1 < args.length) {
-            result.cwd = 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 = args[++i];
-        }
-        else if (arg === "--no-session") {
-            result.noSession = true;
-        }
-        else if (arg === "--session" && i + 1 < args.length) {
-            result.session = 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") {
-            result.noTools = true;
-        }
-        else if (arg === "--tools" && i + 1 < args.length) {
-            const toolNames = args[++i].split(",").map((s) => s.trim());
-            const validTools = [];
-            for (const name of toolNames) {
-                if (name in allTools) {
-                    validTools.push(name);
-                }
-                else {
-                    console.error(chalk.yellow(`Warning: Unknown tool "${name}". Valid tools: ${Object.keys(allTools).join(", ")}`));
-                }
-            }
-            result.tools = validTools;
-        }
-        else if (arg === "--thinking" && i + 1 < args.length) {
-            const level = args[++i];
-            if (isValidThinkingLevel(level)) {
-                result.thinking = level;
-            }
-            else {
-                console.error(chalk.yellow(`Warning: Invalid thinking level "${level}". Valid values: ${VALID_THINKING_LEVELS.join(", ")}`));
-            }
-        }
-        else if (arg === "--print" || arg === "-p") {
-            result.print = true;
-        }
-        else if (arg === "--print-loop-result") {
-            result.printLoopResult = true;
-        }
-        else if (arg === "--fail-on-agent-error") {
-            result.failOnAgentError = true;
-        }
-        else if (arg === "--fail-on-tool-denial") {
-            result.failOnToolDenial = true;
-        }
-        else if (arg === "--agent-loop" && i + 1 < args.length) {
-            const framework = args[++i];
-            const normalized = parseAgentLoopFramework(framework);
-            if (normalized) {
-                result.agentLoopFramework = normalized;
-            }
-            else {
-                console.error(chalk.yellow(`Warning: Invalid agent loop framework "${framework}". Valid values: standard, weak-model-compatible.`));
-            }
-        }
-        else if (arg === "--max-turns-per-prompt" && i + 1 < args.length) {
-            const value = parsePositiveIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                setLoopPolicyOption(result, "maxTurnsPerPrompt", value);
-        }
-        else if (arg === "--max-tool-calls-per-prompt" && i + 1 < args.length) {
-            const value = parsePositiveIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                setLoopPolicyOption(result, "maxToolCallsPerPrompt", value);
-        }
-        else if (arg === "--max-tool-concurrency" && i + 1 < args.length) {
-            const value = parsePositiveIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                setLoopPolicyOption(result, "maxToolConcurrency", value);
-        }
-        else if (arg === "--max-tool-result-batch-size-chars" && i + 1 < args.length) {
-            const value = parsePositiveIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                setLoopPolicyOption(result, "maxToolResultBatchSizeChars", value);
-        }
-        else if (arg === "--output-token-budget" && i + 1 < args.length) {
-            const value = parsePositiveIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                outputTokenBudget.targetTokens = value;
-        }
-        else if (arg === "--output-token-budget-threshold" && i + 1 < args.length) {
-            const value = parseUnitIntervalOption(arg, args[++i]);
-            if (value !== undefined)
-                outputTokenBudget.thresholdPct = value;
-        }
-        else if (arg === "--output-token-budget-continuations" && i + 1 < args.length) {
-            const value = parseNonNegativeIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                outputTokenBudget.maxContinuations = value;
-        }
-        else if (arg === "--max-output-token-recovery-attempts" && i + 1 < args.length) {
-            const value = parseNonNegativeIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                setLoopPolicyOption(result, "maxOutputTokenRecoveryAttempts", value);
-        }
-        else if (arg === "--max-model-error-recovery-attempts" && i + 1 < args.length) {
-            const value = parseNonNegativeIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                setLoopPolicyOption(result, "maxModelErrorRecoveryAttempts", value);
-        }
-        else if (arg === "--max-stop-hook-continuations" && i + 1 < args.length) {
-            const value = parseNonNegativeIntegerOption(arg, args[++i]);
-            if (value !== undefined)
-                setLoopPolicyOption(result, "maxStopHookContinuations", value);
-        }
-        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 = true;
-        }
-        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 = true;
-        }
-        else if (arg === "--no-prompt-templates" || arg === "-np") {
-            result.noPromptTemplates = true;
-        }
-        else if (arg === "--no-themes") {
-            result.noThemes = true;
-        }
-        else if (arg === "--list-models") {
-            // Check if next arg is a search pattern (not a flag or file arg)
-            if (i + 1 < args.length && !args[i + 1].startsWith("-") && !args[i + 1].startsWith("@")) {
-                result.listModels = args[++i];
-            }
-            else {
-                result.listModels = true;
-            }
-        }
-        else if (arg === "--verbose") {
-            result.verbose = true;
-        }
-        else if (arg === "--offline") {
-            result.offline = true;
-        }
-        else if (arg === "--disable-soul") {
-            result.disableSoul = true;
-        }
-        else if (arg === "--no-mcp") {
-            result.noMcp = true;
-        }
-        else if (arg === "--acp") {
-            result.acp = true;
-        }
-        else if (arg === "--agent" && i + 1 < args.length) {
-            result.agent = args[++i];
-        }
-        else if (arg.startsWith("@")) {
-            result.fileArgs.push(arg.slice(1)); // Remove @ prefix
-        }
-        else if (arg.startsWith("--") && extensionFlags) {
-            // Check if it's an extension-registered flag
-            const flagName = arg.slice(2);
-            const extFlag = extensionFlags.get(flagName);
-            if (extFlag) {
-                if (extFlag.type === "boolean") {
-                    result.unknownFlags.set(flagName, true);
-                }
-                else if (extFlag.type === "string" && i + 1 < args.length) {
-                    result.unknownFlags.set(flagName, args[++i]);
-                }
-            }
-            // Unknown flags without extensionFlags are silently ignored (first pass)
-        }
-        else if (!arg.startsWith("-")) {
-            result.messages.push(arg);
-        }
-    }
-    if (outputTokenBudget.targetTokens !== undefined) {
-        setLoopPolicyOption(result, "outputTokenBudget", {
-            targetTokens: outputTokenBudget.targetTokens,
-            thresholdPct: outputTokenBudget.thresholdPct,
-            maxContinuations: outputTokenBudget.maxContinuations,
-        });
-    }
-    return result;
-}
-export function printHelp() {
-    console.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools
+var v=Object.defineProperty;var p=(e,l)=>v(e,"name",{value:l,configurable:!0});import{normalizeAgentLoopFramework as k}from"@pencil-agent/agent-core";import r from"chalk";import{APP_NAME as s,CONFIG_DIR_NAME as h,ENV_AGENT_DIR as g}from"../config.js";import{allTools as A}from"../core/tools/index.js";const I=["off","minimal","low","medium","high","xhigh"];function y(e){return I.includes(e)}p(y,"isValidThinkingLevel");function E(e){const l=k(e);if(l==="standard"||l==="weak-model-compatible")return l}p(E,"parseAgentLoopFramework");function c(e,l){const o=Number(l);if(Number.isInteger(o)&&o>0)return o;console.error(r.yellow(`Warning: Invalid ${e} value "${l}". Expected a positive integer.`))}p(c,"parsePositiveIntegerOption");function f(e,l){const o=Number(l);if(Number.isInteger(o)&&o>=0)return o;console.error(r.yellow(`Warning: Invalid ${e} value "${l}". Expected a non-negative integer.`))}p(f,"parseNonNegativeIntegerOption");function x(e,l){const o=Number(l);if(Number.isFinite(o)&&o>0&&o<=1)return o;console.error(r.yellow(`Warning: Invalid ${e} value "${l}". Expected a number in (0, 1].`))}p(x,"parseUnitIntervalOption");function d(e,l,o){e.loopPolicy=e.loopPolicy??{},e.loopPolicy[l]=o}p(d,"setLoopPolicyOption");function O(e,l){const o={messages:[],fileArgs:[],unknownFlags:new Map},m={};for(let n=0;n<e.length;n++){const t=e[n];if(t==="--help"||t==="-h")o.help=!0;else if(t==="--version"||t==="-v")o.version=!0;else if(t==="--mode"&&n+1<e.length){const i=e[++n];(i==="text"||i==="json"||i==="rpc")&&(o.mode=i)}else if(t==="--continue"||t==="-c")o.continue=!0;else if(t==="--resume"||t==="-r")o.resume=!0;else if(t==="--provider"&&n+1<e.length)o.provider=e[++n];else if(t==="--cwd"&&n+1<e.length)o.cwd=e[++n];else if(t==="--model"&&n+1<e.length)o.model=e[++n];else if(t==="--api-key"&&n+1<e.length)o.apiKey=e[++n];else if(t==="--system-prompt"&&n+1<e.length)o.systemPrompt=e[++n];else if(t==="--append-system-prompt"&&n+1<e.length)o.appendSystemPrompt=e[++n];else if(t==="--no-session")o.noSession=!0;else if(t==="--session"&&n+1<e.length)o.session=e[++n];else if(t==="--session-dir"&&n+1<e.length)o.sessionDir=e[++n];else if(t==="--models"&&n+1<e.length)o.models=e[++n].split(",").map(i=>i.trim());else if(t==="--no-tools")o.noTools=!0;else if(t==="--tools"&&n+1<e.length){const i=e[++n].split(",").map(u=>u.trim()),a=[];for(const u of i)u in A?a.push(u):console.error(r.yellow(`Warning: Unknown tool "${u}". Valid tools: ${Object.keys(A).join(", ")}`));o.tools=a}else if(t==="--thinking"&&n+1<e.length){const i=e[++n];y(i)?o.thinking=i:console.error(r.yellow(`Warning: Invalid thinking level "${i}". Valid values: ${I.join(", ")}`))}else if(t==="--print"||t==="-p")o.print=!0;else if(t==="--print-loop-result")o.printLoopResult=!0;else if(t==="--fail-on-agent-error")o.failOnAgentError=!0;else if(t==="--fail-on-tool-denial")o.failOnToolDenial=!0;else if(t==="--agent-loop"&&n+1<e.length){const i=e[++n],a=E(i);a?o.agentLoopFramework=a:console.error(r.yellow(`Warning: Invalid agent loop framework "${i}". Valid values: standard, weak-model-compatible.`))}else if(t==="--max-turns-per-prompt"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&d(o,"maxTurnsPerPrompt",i)}else if(t==="--max-tool-calls-per-prompt"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&d(o,"maxToolCallsPerPrompt",i)}else if(t==="--max-tool-concurrency"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&d(o,"maxToolConcurrency",i)}else if(t==="--max-tool-result-batch-size-chars"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&d(o,"maxToolResultBatchSizeChars",i)}else if(t==="--output-token-budget"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&(m.targetTokens=i)}else if(t==="--output-token-budget-threshold"&&n+1<e.length){const i=x(t,e[++n]);i!==void 0&&(m.thresholdPct=i)}else if(t==="--output-token-budget-continuations"&&n+1<e.length){const i=f(t,e[++n]);i!==void 0&&(m.maxContinuations=i)}else if(t==="--max-output-token-recovery-attempts"&&n+1<e.length){const i=f(t,e[++n]);i!==void 0&&d(o,"maxOutputTokenRecoveryAttempts",i)}else if(t==="--max-model-error-recovery-attempts"&&n+1<e.length){const i=f(t,e[++n]);i!==void 0&&d(o,"maxModelErrorRecoveryAttempts",i)}else if(t==="--max-stop-hook-continuations"&&n+1<e.length){const i=f(t,e[++n]);i!==void 0&&d(o,"maxStopHookContinuations",i)}else if(t==="--export"&&n+1<e.length)o.export=e[++n];else if((t==="--extension"||t==="-e")&&n+1<e.length)o.extensions=o.extensions??[],o.extensions.push(e[++n]);else if(t==="--no-extensions"||t==="-ne")o.noExtensions=!0;else if(t==="--skill"&&n+1<e.length)o.skills=o.skills??[],o.skills.push(e[++n]);else if(t==="--prompt-template"&&n+1<e.length)o.promptTemplates=o.promptTemplates??[],o.promptTemplates.push(e[++n]);else if(t==="--theme"&&n+1<e.length)o.themes=o.themes??[],o.themes.push(e[++n]);else if(t==="--no-skills"||t==="-ns")o.noSkills=!0;else if(t==="--no-prompt-templates"||t==="-np")o.noPromptTemplates=!0;else if(t==="--no-themes")o.noThemes=!0;else if(t==="--list-models")n+1<e.length&&!e[n+1].startsWith("-")&&!e[n+1].startsWith("@")?o.listModels=e[++n]:o.listModels=!0;else if(t==="--refresh-models")o.refreshModels=!0;else if(t==="--verbose")o.verbose=!0;else if(t==="--offline")o.offline=!0;else if(t==="--disable-soul")o.disableSoul=!0;else if(t==="--no-mcp")o.noMcp=!0;else if(t==="--acp")o.acp=!0;else if(t==="--agent"&&n+1<e.length)o.agent=e[++n];else if(t.startsWith("@"))o.fileArgs.push(t.slice(1));else if(t.startsWith("--")&&l){const i=t.slice(2),a=l.get(i);a&&(a.type==="boolean"?o.unknownFlags.set(i,!0):a.type==="string"&&n+1<e.length&&o.unknownFlags.set(i,e[++n]))}else t.startsWith("-")||o.messages.push(t)}return m.targetTokens!==void 0&&d(o,"outputTokenBudget",{targetTokens:m.targetTokens,thresholdPct:m.thresholdPct,maxContinuations:m.maxContinuations}),o}p(O,"parseArgs");function S(){console.log(`${r.bold(s)} - AI coding assistant with read, bash, edit, write tools
 
-${chalk.bold("Usage:")}
-  ${APP_NAME} [options] [@files...] [messages...]
+${r.bold("Usage:")}
+  ${s} [options] [@files...] [messages...]
 
-${chalk.bold("Commands:")}
-  ${APP_NAME} install <source> [-l]    Install extension source and add to settings
-  ${APP_NAME} remove <source> [-l]     Remove extension source from settings
-  ${APP_NAME} update [source]          Update installed extensions (skips pinned sources)
-  ${APP_NAME} list                     List installed extensions from settings
-  ${APP_NAME} config                   Open TUI to enable/disable package resources
-  ${APP_NAME} migrate                  Migrate data from legacy ~/.nanopencil to ~/.pencils
-  ${APP_NAME} <command> --help         Show help for commands
+${r.bold("Commands:")}
+  ${s} install <source> [-l]    Install extension source and add to settings
+  ${s} remove <source> [-l]     Remove extension source from settings
+  ${s} update [source]          Update installed extensions (skips pinned sources)
+  ${s} list                     List installed extensions from settings
+  ${s} config                   Open TUI to enable/disable package resources
+  ${s} migrate                  Migrate data from legacy ~/.nanopencil to ~/.pencils
+  ${s} <command> --help         Show help for commands
 
-${chalk.bold("Options:")}
+${r.bold("Options:")}
   --provider <name>              Provider name (default: google)
   --cwd <dir>                    Working directory to use for project-local discovery
   --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
@@ -345,6 +56,7 @@ ${chalk.bold("Options:")}
   --no-themes                    Disable theme discovery and loading
   --export <file>                Export session file to HTML and exit
   --list-models [search]         List available models (with optional fuzzy search)
+  --refresh-models               Refresh remote model lists via discovery (use with --list-models)
   --verbose                      Force verbose startup (overrides quietStartup setting)
   --offline                      Disable startup network operations (same as NANOPENCIL_OFFLINE=1)
   --disable-soul                 Disable Soul (AI personality evolution)
@@ -356,54 +68,54 @@ ${chalk.bold("Options:")}
 
 Extensions can register additional flags (e.g., --plan from plan-mode extension).
 
-${chalk.bold("Examples:")}
+${r.bold("Examples:")}
   # Interactive mode
-  ${APP_NAME}
+  ${s}
 
   # Interactive mode with initial prompt
-  ${APP_NAME} "List all .ts files in src/"
+  ${s} "List all .ts files in src/"
 
   # Include files in initial message
-  ${APP_NAME} @prompt.md @image.png "What color is the sky?"
+  ${s} @prompt.md @image.png "What color is the sky?"
 
   # Non-interactive mode (process and exit)
-  ${APP_NAME} -p "List all .ts files in src/"
+  ${s} -p "List all .ts files in src/"
 
   # Multiple messages (interactive)
-  ${APP_NAME} "Read package.json" "What dependencies do we have?"
+  ${s} "Read package.json" "What dependencies do we have?"
 
   # Continue previous session
-  ${APP_NAME} --continue "What did we discuss?"
+  ${s} --continue "What did we discuss?"
 
   # Use different model
-  ${APP_NAME} --provider openai --model gpt-4o-mini "Help me refactor this code"
+  ${s} --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"
+  ${s} --model openai/gpt-4o "Help me refactor this code"
 
   # Use model with thinking level shorthand
-  ${APP_NAME} --model sonnet:high "Solve this complex problem"
+  ${s} --model sonnet:high "Solve this complex problem"
 
   # Limit model cycling to specific models
-  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o
+  ${s} --models claude-sonnet,claude-haiku,gpt-4o
 
   # Limit to a specific provider with glob pattern
-  ${APP_NAME} --models "github-copilot/*"
+  ${s} --models "github-copilot/*"
 
   # Cycle models with fixed thinking levels
-  ${APP_NAME} --models sonnet:high,haiku:low
+  ${s} --models sonnet:high,haiku:low
 
   # Start with a specific thinking level
-  ${APP_NAME} --thinking high "Solve this complex problem"
+  ${s} --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/"
+  ${s} --tools read,grep,find,ls -p "Review the code in src/"
 
   # Export a session file to HTML
-  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl
-  ${APP_NAME} --export session.jsonl output.html
+  ${s} --export ~/${h}/agent/sessions/--path--/session.jsonl
+  ${s} --export session.jsonl output.html
 
-${chalk.bold("Environment Variables:")}
+${r.bold("Environment Variables:")}
   ANTHROPIC_API_KEY                - Anthropic Claude API key
   ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)
   OPENAI_API_KEY                   - OpenAI GPT API key
@@ -427,15 +139,15 @@ ${chalk.bold("Environment Variables:")}
   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)
-  ${`${APP_NAME.toUpperCase()}_CWD`.padEnd(32)} - Working directory override for project-local discovery
-  ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
+  ${`${s.toUpperCase()}_CWD`.padEnd(32)} - Working directory override for project-local discovery
+  ${g.padEnd(32)} - Session storage directory (default: ~/${h}/agent)
   NANOPENCIL_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
   NANOPENCIL_OFFLINE                       - Disable startup network operations when set to 1/true/yes
   NANOPENCIL_TOOLS_DOWNLOAD_TIMEOUT_MS     - Timeout in ms for downloading fd/ripgrep (default: 60000)
   NANOPENCIL_SHARE_VIEWER_URL              - Base URL for /share command (default: https://nanopencil.dev/session/)
   NANOPENCIL_AI_ANTIGRAVITY_VERSION        - Override Antigravity User-Agent version (e.g., 1.23.0)
 
-${chalk.bold("Available Tools (default: read, bash, edit, write):")}
+${r.bold("Available Tools (default: read, bash, edit, write):")}
   read   - Read file contents
   bash   - Execute bash commands
   edit   - Edit files with find/replace
@@ -443,5 +155,4 @@ ${chalk.bold("Available Tools (default: read, bash, edit, write):")}
   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)
-`);
-}
+`)}p(S,"printHelp");export{y as isValidThinkingLevel,O as parseArgs,S as printHelp};

package/dist/cli/config-selector.js

@@ -1,33 +1 @@
-/**
- * [WHO]: ConfigSelectorOptions, ConfigSelector, runConfigSelector()
- * [FROM]: Depends on tui, core/platform/config, modes/interactive/components
- * [TO]: Consumed by main.ts
- * [HERE]: cli/config-selector.ts - TUI config selector for `nanopencil config` command
- */
-import { ProcessTerminal, TUI } from "@pencil-agent/tui";
-import { ConfigSelectorComponent } from "../modes/interactive/components/config-selector.js";
-import { initTheme, stopThemeWatcher } from "../modes/interactive/theme/theme.js";
-/** Show TUI config selector and return when closed */
-export async function selectConfig(options) {
-    // Initialize theme before showing TUI
-    initTheme(options.settingsManager.getTheme(), true);
-    return new Promise((resolve) => {
-        const ui = new TUI(new ProcessTerminal());
-        let resolved = false;
-        const selector = new ConfigSelectorComponent(options.resolvedPaths, options.settingsManager, options.cwd, options.agentDir, () => {
-            if (!resolved) {
-                resolved = true;
-                ui.stop();
-                stopThemeWatcher();
-                resolve();
-            }
-        }, () => {
-            ui.stop();
-            stopThemeWatcher();
-            process.exit(0);
-        }, () => ui.requestRender());
-        ui.addChild(selector);
-        ui.setFocus(selector.getResourceList());
-        ui.start();
-    });
-}
+var c=Object.defineProperty;var o=(e,r)=>c(e,"name",{value:r,configurable:!0});import{ProcessTerminal as a,TUI as m}from"@pencil-agent/tui";import{ConfigSelectorComponent as g}from"../modes/interactive/components/config-selector.js";import{initTheme as l,stopThemeWatcher as i}from"../modes/interactive/theme/theme.js";async function p(e){return l(e.settingsManager.getTheme(),!0),new Promise(r=>{const t=new m(new a);let s=!1;const n=new g(e.resolvedPaths,e.settingsManager,e.cwd,e.agentDir,()=>{s||(s=!0,t.stop(),i(),r())},()=>{t.stop(),i(),process.exit(0)},()=>t.requestRender());t.addChild(n),t.setFocus(n.getResourceList()),t.start()})}o(p,"selectConfig");export{p as selectConfig};

package/dist/cli/file-processor.js

@@ -1,81 +1,6 @@
-/**
- * [WHO]: ProcessedFiles, processFileArguments()
- * [FROM]: Depends on node:fs/promises, ai, chalk, core/tools/path-utils, modes/utils
- * [TO]: Consumed by main.ts
- * [HERE]: cli/file-processor.ts - process @file CLI arguments into content
- */
-import { access, readFile, stat } from "node:fs/promises";
-import chalk from "chalk";
-import { resolve } from "path";
-import { resolveReadPath } from "../core/tools/path-utils.js";
-import { formatDimensionNote, resizeImage } from "../modes/utils/image-resize.js";
-import { detectSupportedImageMimeTypeFromFile } from "../utils/mime.js";
-/** Process @file arguments into text content and image attachments */
-export async function processFileArguments(fileArgs, options) {
-    const autoResizeImages = options?.autoResizeImages ?? true;
-    let text = "";
-    const images = [];
-    for (const fileArg of fileArgs) {
-        // Expand and resolve path (handles ~ expansion and macOS screenshot Unicode spaces)
-        const absolutePath = resolve(resolveReadPath(fileArg, process.cwd()));
-        // Check if file exists
-        try {
-            await access(absolutePath);
-        }
-        catch {
-            console.error(chalk.red(`Error: File not found: ${absolutePath}`));
-            process.exit(1);
-        }
-        // Check if file is empty
-        const stats = await stat(absolutePath);
-        if (stats.size === 0) {
-            // Skip empty files
-            continue;
-        }
-        const mimeType = await detectSupportedImageMimeTypeFromFile(absolutePath);
-        if (mimeType) {
-            // Handle image file
-            const content = await readFile(absolutePath);
-            const base64Content = content.toString("base64");
-            let attachment;
-            let dimensionNote;
-            if (autoResizeImages) {
-                const resized = await resizeImage({ type: "image", data: base64Content, mimeType });
-                dimensionNote = formatDimensionNote(resized);
-                attachment = {
-                    type: "image",
-                    mimeType: resized.mimeType,
-                    data: resized.data,
-                };
-            }
-            else {
-                attachment = {
-                    type: "image",
-                    mimeType,
-                    data: base64Content,
-                };
-            }
-            images.push(attachment);
-            // Add text reference to image with optional dimension note
-            if (dimensionNote) {
-                text += `<file name="${absolutePath}">${dimensionNote}</file>\n`;
-            }
-            else {
-                text += `<file name="${absolutePath}"></file>\n`;
-            }
-        }
-        else {
-            // Handle text file
-            try {
-                const content = await readFile(absolutePath, "utf-8");
-                text += `<file name="${absolutePath}">\n${content}\n</file>\n`;
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
-                console.error(chalk.red(`Error: Could not read file ${absolutePath}: ${message}`));
-                process.exit(1);
-            }
-        }
-    }
-    return { text, images };
-}
+var y=Object.defineProperty;var l=(a,s)=>y(a,"name",{value:s,configurable:!0});import{access as $,readFile as p,stat as h}from"node:fs/promises";import d from"chalk";import{resolve as w}from"path";import{resolveReadPath as z}from"../core/tools/path-utils.js";import{formatDimensionNote as F,resizeImage as x}from"../modes/utils/image-resize.js";import{detectSupportedImageMimeTypeFromFile as I}from"../utils/mime.js";async function N(a,s){const g=s?.autoResizeImages??!0;let o="";const f=[];for(const u of a){const e=w(z(u,process.cwd()));try{await $(e)}catch{console.error(d.red(`Error: File not found: ${e}`)),process.exit(1)}if((await h(e)).size===0)continue;const i=await I(e);if(i){const r=(await p(e)).toString("base64");let n,m;if(g){const c=await x({type:"image",data:r,mimeType:i});m=F(c),n={type:"image",mimeType:c.mimeType,data:c.data}}else n={type:"image",mimeType:i,data:r};f.push(n),m?o+=`<file name="${e}">${m}</file>
+`:o+=`<file name="${e}"></file>
+`}else try{const t=await p(e,"utf-8");o+=`<file name="${e}">
+${t}
+</file>
+`}catch(t){const r=t instanceof Error?t.message:String(t);console.error(d.red(`Error: Could not read file ${e}: ${r}`)),process.exit(1)}}return{text:o,images:f}}l(N,"processFileArguments");export{N as processFileArguments};

package/dist/cli/list-models.d.ts

@@ -1,5 +1,12 @@
 import type { ModelRegistry } from "../core/model-registry.js";
 /**
- * List available models, optionally filtered by search pattern
+ * List available models, optionally filtered by search pattern.
+ *
+ * @param modelRegistry  Model registry to query
+ * @param searchPattern  Optional fuzzy filter pattern
+ * @param options        Optional flags:
+ *   - `refresh`: run discovery before listing (fetches remote /models endpoints)
  */
-export declare function listModels(modelRegistry: ModelRegistry, searchPattern?: string): Promise<void>;
+export declare function listModels(modelRegistry: ModelRegistry, searchPattern?: string, options?: {
+    refresh?: boolean;
+}): Promise<void>;