@ai-agent-forge/agent-forge 0.85.0

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CLI argument parsing and help display\n */\n\nimport type { ThinkingLevel } from \"@agent-forge/agent-core\";\nimport chalk from \"chalk\";\nimport { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR, ENV_SESSION_DIR } from \"../config.ts\";\nimport type { HostLogLevel } from \"../core/logger.ts\";\nimport type { TuiMode } from \"../core/settings-manager.ts\";\n// TRACE_KINDS_V1 is a value import, but observability-types.ts has no runtime\n// edges (its two imports are type-only), so no import cycle can form here.\nimport { TRACE_KINDS_V1 } from \"../plugins/observability-types.ts\";\n\nexport type Mode = \"text\" | \"json\" | \"rpc\";\n\nexport interface Args {\n\tprovider?: string;\n\tmodel?: string;\n\tapiKey?: string;\n\tsystemPrompt?: string;\n\tappendSystemPrompt?: string[];\n\tthinking?: ThinkingLevel;\n\tcontinue?: boolean;\n\tresume?: boolean;\n\thelp?: boolean;\n\tversion?: boolean;\n\tmode?: Mode;\n\tname?: string;\n\tnoSession?: boolean;\n\tsession?: string;\n\tsessionId?: string;\n\tfork?: string;\n\tsessionDir?: string;\n\t/** Suite (方案) id for session workspace and context assembly. */\n\tsuite?: string;\n\t/** One-shot lifecycle action: create the user suite workspace (设计 §9). */\n\tsuiteCreate?: string;\n\t/** Companion of --suite-create: clone the source suite workspace. */\n\tcloneFrom?: string;\n\t/** One-shot lifecycle action: delete the user suite workspace (设计 §9). */\n\tsuiteDelete?: string;\n\t/** One-shot lifecycle action: reset a builtin suite to factory contents (设计 §9). */\n\tsuiteReset?: string;\n\t/** Serve the coding-agent session runtime over TCP on the given port. */\n\tserve?: number;\n\t/** Opt-in `--serve` workspace boundary: remote creates must resolve inside one of these roots (repeatable). */\n\tserveWorkspaceRoots?: string[];\n\t/**\n\t * Run as a headless subagent runner (D-045 pooled increment 2b): serve the\n\t * subagent-task command surface on stdio for a parent session's runner pool.\n\t */\n\tsubagentRunner?: boolean;\n\tmodels?: string[];\n\ttools?: string[];\n\texcludeTools?: string[];\n\tnoTools?: boolean;\n\tnoBuiltinTools?: boolean;\n\tnoPlugins?: boolean;\n\t/** Disable session trace collection: equivalent to SDK `traceEnabled: false`. */\n\tnoTrace?: boolean;\n\t/** Host log level. Overrides AGENT_FORGE_LOG_LEVEL; default \"info\". */\n\tlogLevel?: HostLogLevel;\n\t/** Explicit builtin plugin profile for this run. */\n\tpluginProfile?: string;\n\t/** Explicit plugin IDs selected for the profile. */\n\tplugins?: string[];\n\t/** Explicit plugin IDs disabled for the profile. */\n\tdisabledPlugins?: string[];\n\t/** Persistence scope for explicit plugin selection: global by default. */\n\tpluginSelectionScope?: \"global\" | \"project\";\n\tprint?: boolean;\n\texport?: string;\n\t/** View a session's trace file (session id, path, or empty for the most recent session). */\n\ttrace?: string;\n\t/** Structured records output for --trace (设计 §8 第 3 期). */\n\ttraceJson?: boolean;\n\t/** With --trace, show only records whose kind is in this whitelist (TRACE_KINDS_V1 members). */\n\ttraceKind?: string[];\n\t/** With --trace, show only the last N records (positive integer). */\n\ttraceLimit?: number;\n\tnoSkills?: boolean;\n\tskills?: string[];\n\tpromptTemplates?: string[];\n\tnoPromptTemplates?: boolean;\n\tthemes?: string[];\n\tuseTheme?: string;\n\tnoThemes?: boolean;\n\tnoContextFiles?: boolean;\n\tlistModels?: string | true;\n\toffline?: boolean;\n\ttuiMode?: TuiMode;\n\tverbose?: boolean;\n\tmessages: string[];\n\tfileArgs: string[];\n\tdiagnostics: Array<{ type: \"warning\" | \"error\"; message: string }>;\n}\n\nconst VALID_THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"] as const;\n\nconst VALID_LOG_LEVELS = [\"debug\", \"info\", \"warn\", \"error\"] as const;\n\nexport function isValidHostLogLevel(level: string): level is HostLogLevel {\n\treturn VALID_LOG_LEVELS.includes(level as HostLogLevel);\n}\n\n/** Single source of valid `--trace-kind` values: the TRACE_KINDS_V1 runtime mirror. */\nexport function isValidTraceKind(kind: string): boolean {\n\treturn (TRACE_KINDS_V1 as readonly string[]).includes(kind);\n}\n\n/** Keep CLI plugin selection bounded before it reaches profile resolution. */\nexport const MAX_PLUGIN_CLI_ID_CHARS = 128;\nexport const MAX_PLUGIN_CLI_IDS = 128;\n\nexport function isValidThinkingLevel(level: string): level is ThinkingLevel {\n\treturn VALID_THINKING_LEVELS.includes(level as ThinkingLevel);\n}\n\nexport function normalizeSessionName(value: string): string | undefined {\n\tconst name = value.trim();\n\treturn name.length > 0 ? name : undefined;\n}\n\nfunction parseBoundedPluginId(\n\targs: string[],\n\tindex: number,\n\tresult: Args,\n\toption: \"--plugin\" | \"--disable-plugin\",\n\tvalues: string[],\n): number {\n\tconst raw = args[index + 1];\n\tif (raw === undefined || raw.startsWith(\"-\")) {\n\t\tresult.diagnostics.push({ type: \"error\", message: `${option} requires a plugin id` });\n\t\treturn index;\n\t}\n\tconst value = raw.trim();\n\tif (value.length === 0) {\n\t\tresult.diagnostics.push({ type: \"error\", message: `${option} requires a non-empty plugin id` });\n\t\treturn index + 1;\n\t}\n\tif (value.length > MAX_PLUGIN_CLI_ID_CHARS) {\n\t\tresult.diagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `${option} plugin id must be at most ${MAX_PLUGIN_CLI_ID_CHARS} characters`,\n\t\t});\n\t\treturn index + 1;\n\t}\n\tif (values.length >= MAX_PLUGIN_CLI_IDS) {\n\t\tresult.diagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `${option} accepts at most ${MAX_PLUGIN_CLI_IDS} plugin ids`,\n\t\t});\n\t\treturn index + 1;\n\t}\n\tvalues.push(value);\n\treturn index + 1;\n}\n\nfunction parsePluginProfileValue(args: string[], index: number, result: Args, rawValue?: string): number {\n\tconst raw = rawValue ?? args[index + 1];\n\tif (raw === undefined || raw.startsWith(\"-\")) {\n\t\tresult.diagnostics.push({ type: \"error\", message: \"--plugin-profile requires a profile id\" });\n\t\treturn rawValue === undefined ? index : index;\n\t}\n\tconst value = raw.trim();\n\tif (value.length === 0) {\n\t\tresult.diagnostics.push({ type: \"error\", message: \"--plugin-profile requires a non-empty profile id\" });\n\t\treturn rawValue === undefined ? index + 1 : index;\n\t}\n\tif (value.length > MAX_PLUGIN_CLI_ID_CHARS) {\n\t\tresult.diagnostics.push({\n\t\t\ttype: \"error\",\n\t\t\tmessage: `--plugin-profile id must be at most ${MAX_PLUGIN_CLI_ID_CHARS} characters`,\n\t\t});\n\t\treturn rawValue === undefined ? index + 1 : index;\n\t}\n\tresult.pluginProfile = value;\n\treturn rawValue === undefined ? index + 1 : index;\n}\n\nexport function parseArgs(args: string[]): Args {\n\tconst result: Args = {\n\t\tmessages: [],\n\t\tfileArgs: [],\n\t\tdiagnostics: [],\n\t};\n\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i];\n\n\t\tif (arg === \"--\") {\n\t\t\tfor (const positionalArg of args.slice(i + 1)) {\n\t\t\t\tif (positionalArg.startsWith(\"@\")) {\n\t\t\t\t\tresult.fileArgs.push(positionalArg.slice(1));\n\t\t\t\t} else {\n\t\t\t\t\tresult.messages.push(positionalArg);\n\t\t\t\t}\n\t\t\t}\n\t\t\tbreak;\n\t\t} else if (arg === \"--help\" || arg === \"-h\") {\n\t\t\tresult.help = true;\n\t\t} else if (arg === \"--version\" || arg === \"-v\") {\n\t\t\tresult.version = true;\n\t\t} else if (arg === \"--mode\" && i + 1 < args.length) {\n\t\t\tconst mode = args[++i];\n\t\t\tif (mode === \"text\" || mode === \"json\" || mode === \"rpc\") {\n\t\t\t\tresult.mode = mode;\n\t\t\t}\n\t\t} else if (arg === \"--continue\" || arg === \"-c\") {\n\t\t\tresult.continue = true;\n\t\t} else if (arg === \"--resume\" || arg === \"-r\") {\n\t\t\tresult.resume = true;\n\t\t} else if (arg === \"--provider\" && i + 1 < args.length) {\n\t\t\tresult.provider = args[++i];\n\t\t} else if ((arg === \"--model\" || arg === \"-m\") && i + 1 < args.length) {\n\t\t\tresult.model = args[++i];\n\t\t} else if (arg === \"--api-key\" && i + 1 < args.length) {\n\t\t\tresult.apiKey = args[++i];\n\t\t} else if (arg === \"--system-prompt\" && i + 1 < args.length) {\n\t\t\tresult.systemPrompt = args[++i];\n\t\t} else if (arg === \"--append-system-prompt\" && i + 1 < args.length) {\n\t\t\tresult.appendSystemPrompt = result.appendSystemPrompt ?? [];\n\t\t\tresult.appendSystemPrompt.push(args[++i]);\n\t\t} else if (arg === \"--name\" || arg === \"-n\") {\n\t\t\tif (i + 1 < args.length) {\n\t\t\t\tresult.name = args[++i];\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--name requires a value\" });\n\t\t\t}\n\t\t} else if (arg === \"--no-session\") {\n\t\t\tresult.noSession = true;\n\t\t} else if (arg === \"--session\" && i + 1 < args.length) {\n\t\t\tresult.session = args[++i];\n\t\t} else if (arg === \"--session-id\" && i + 1 < args.length) {\n\t\t\tresult.sessionId = args[++i];\n\t\t} else if (arg === \"--fork\" && i + 1 < args.length) {\n\t\t\tresult.fork = args[++i];\n\t\t} else if (arg === \"--session-dir\" && i + 1 < args.length) {\n\t\t\tresult.sessionDir = args[++i];\n\t\t} else if (arg === \"--suite\") {\n\t\t\tconst id = args[i + 1];\n\t\t\tif (id !== undefined && !id.startsWith(\"-\")) {\n\t\t\t\tresult.suite = id;\n\t\t\t\ti++;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--suite requires a suite id\" });\n\t\t\t}\n\t\t} else if (arg === \"--suite-create\") {\n\t\t\tconst id = args[i + 1];\n\t\t\tif (id !== undefined && !id.startsWith(\"-\")) {\n\t\t\t\tresult.suiteCreate = id;\n\t\t\t\ti++;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--suite-create requires a suite id\" });\n\t\t\t}\n\t\t} else if (arg === \"--clone-from\") {\n\t\t\tconst id = args[i + 1];\n\t\t\tif (id !== undefined && !id.startsWith(\"-\")) {\n\t\t\t\tresult.cloneFrom = id;\n\t\t\t\ti++;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--clone-from requires a suite id\" });\n\t\t\t}\n\t\t} else if (arg === \"--suite-delete\") {\n\t\t\tconst id = args[i + 1];\n\t\t\tif (id !== undefined && !id.startsWith(\"-\")) {\n\t\t\t\tresult.suiteDelete = id;\n\t\t\t\ti++;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--suite-delete requires a suite id\" });\n\t\t\t}\n\t\t} else if (arg === \"--suite-reset\") {\n\t\t\tconst id = args[i + 1];\n\t\t\tif (id !== undefined && !id.startsWith(\"-\")) {\n\t\t\t\tresult.suiteReset = id;\n\t\t\t\ti++;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--suite-reset requires a suite id\" });\n\t\t\t}\n\t\t} else if (arg === \"--serve\") {\n\t\t\tconst raw = args[i + 1];\n\t\t\tconst port = raw !== undefined && /^\\d+$/.test(raw) ? Number(raw) : Number.NaN;\n\t\t\tif (Number.isInteger(port) && port <= 65535) {\n\t\t\t\tresult.serve = port;\n\t\t\t\ti++;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--serve requires a valid TCP port (0-65535)\" });\n\t\t\t\tif (raw !== undefined) i++;\n\t\t\t}\n\t\t} else if (arg === \"--subagent-runner\") {\n\t\t\tresult.subagentRunner = true;\n\t\t} else if (arg === \"--serve-workspace-root\") {\n\t\t\tconst dir = args[i + 1];\n\t\t\tif (dir === undefined || dir.startsWith(\"-\")) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--serve-workspace-root requires a directory\" });\n\t\t\t} else {\n\t\t\t\tresult.serveWorkspaceRoots = result.serveWorkspaceRoots ?? [];\n\t\t\t\tresult.serveWorkspaceRoots.push(dir);\n\t\t\t\ti++;\n\t\t\t}\n\t\t} else if (arg === \"--models\" && i + 1 < args.length) {\n\t\t\tresult.models = args[++i].split(\",\").map((s) => s.trim());\n\t\t} else if (arg === \"--no-tools\" || arg === \"-nt\") {\n\t\t\tresult.noTools = true;\n\t\t} else if (arg === \"--no-builtin-tools\" || arg === \"-nbt\") {\n\t\t\tresult.noBuiltinTools = true;\n\t\t} else if ((arg === \"--tools\" || arg === \"-t\") && i + 1 < args.length) {\n\t\t\tresult.tools = args[++i]\n\t\t\t\t.split(\",\")\n\t\t\t\t.map((s) => s.trim())\n\t\t\t\t.filter((name) => name.length > 0);\n\t\t} else if ((arg === \"--exclude-tools\" || arg === \"-xt\") && i + 1 < args.length) {\n\t\t\tresult.excludeTools = args[++i]\n\t\t\t\t.split(\",\")\n\t\t\t\t.map((s) => s.trim())\n\t\t\t\t.filter((name) => name.length > 0);\n\t\t} else if (arg === \"--thinking\" && i + 1 < args.length) {\n\t\t\tconst level = args[++i];\n\t\t\tif (isValidThinkingLevel(level)) {\n\t\t\t\tresult.thinking = level;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\tmessage: `Invalid thinking level \"${level}\". Valid values: ${VALID_THINKING_LEVELS.join(\", \")}`,\n\t\t\t\t});\n\t\t\t}\n\t\t} else if (arg === \"--print\" || arg === \"-p\") {\n\t\t\tresult.print = true;\n\t\t\tconst next = args[i + 1];\n\t\t\tif (next !== undefined && !next.startsWith(\"@\") && (!next.startsWith(\"-\") || next.startsWith(\"---\"))) {\n\t\t\t\tresult.messages.push(next);\n\t\t\t\ti++;\n\t\t\t}\n\t\t} else if (arg === \"--export\" && i + 1 < args.length) {\n\t\t\tresult.export = args[++i];\n\t\t} else if (arg === \"--trace\") {\n\t\t\t// View command: bare --trace targets the most recent session; a\n\t\t\t// following non-option token is the session id or trace/session path.\n\t\t\tconst next = args[i + 1];\n\t\t\tif (next !== undefined && !next.startsWith(\"-\")) {\n\t\t\t\tresult.trace = next;\n\t\t\t\ti++;\n\t\t\t} else {\n\t\t\t\tresult.trace = \"\";\n\t\t\t}\n\t\t} else if (arg === \"--trace-json\") {\n\t\t\tresult.traceJson = true;\n\t\t} else if (arg === \"--trace-kind\") {\n\t\t\tconst raw = args[i + 1];\n\t\t\tif (raw === undefined || raw.startsWith(\"-\")) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--trace-kind requires a comma-separated kind list\" });\n\t\t\t} else {\n\t\t\t\ti++;\n\t\t\t\tconst kinds = raw\n\t\t\t\t\t.split(\",\")\n\t\t\t\t\t.map((kind) => kind.trim())\n\t\t\t\t\t.filter((kind) => kind.length > 0);\n\t\t\t\tconst invalid = kinds.filter((kind) => !isValidTraceKind(kind));\n\t\t\t\tif (kinds.length === 0) {\n\t\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--trace-kind requires at least one trace kind\" });\n\t\t\t\t} else if (invalid.length > 0) {\n\t\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\t\ttype: \"error\",\n\t\t\t\t\t\tmessage: `Invalid trace kind(s) \"${invalid.join(\", \")}\". Valid values: ${TRACE_KINDS_V1.join(\", \")}`,\n\t\t\t\t\t});\n\t\t\t\t} else {\n\t\t\t\t\tresult.traceKind = kinds;\n\t\t\t\t}\n\t\t\t}\n\t\t} else if (arg === \"--trace-limit\") {\n\t\t\tconst raw = args[i + 1];\n\t\t\tif (raw === undefined || raw.startsWith(\"-\")) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--trace-limit requires a positive integer\" });\n\t\t\t} else {\n\t\t\t\ti++;\n\t\t\t\tconst limit = /^\\d+$/.test(raw) ? Number(raw) : Number.NaN;\n\t\t\t\tif (Number.isInteger(limit) && limit > 0) {\n\t\t\t\t\tresult.traceLimit = limit;\n\t\t\t\t} else {\n\t\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\t\ttype: \"error\",\n\t\t\t\t\t\tmessage: `Invalid trace limit \"${raw}\". Expected a positive integer`,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t} else if (arg === \"--no-plugins\" || arg === \"-np\") {\n\t\t\tresult.noPlugins = true;\n\t\t} else if (arg === \"--no-trace\") {\n\t\t\tresult.noTrace = true;\n\t\t} else if (arg === \"--log-level\") {\n\t\t\tconst level = args[i + 1];\n\t\t\tif (level === undefined || level.startsWith(\"-\")) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--log-level requires a level\" });\n\t\t\t} else if (!isValidHostLogLevel(level)) {\n\t\t\t\ti++;\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: `Invalid log level \"${level}\". Valid values: ${VALID_LOG_LEVELS.join(\", \")}`,\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tresult.logLevel = level;\n\t\t\t\ti++;\n\t\t\t}\n\t\t} else if (arg === \"--plugin-profile\") {\n\t\t\ti = parsePluginProfileValue(args, i, result);\n\t\t} else if (arg.startsWith(\"--plugin-profile=\")) {\n\t\t\tparsePluginProfileValue(args, i, result, arg.slice(\"--plugin-profile=\".length));\n\t\t} else if (arg === \"--plugin-scope\" || arg.startsWith(\"--plugin-scope=\")) {\n\t\t\tconst raw = arg === \"--plugin-scope\" ? args[i + 1] : arg.slice(\"--plugin-scope=\".length);\n\t\t\tif (arg === \"--plugin-scope\") i++;\n\t\t\tif (raw !== \"global\" && raw !== \"project\") {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--plugin-scope must be global or project\" });\n\t\t\t} else if (result.pluginSelectionScope !== undefined) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--plugin-scope may be specified only once\" });\n\t\t\t} else {\n\t\t\t\tresult.pluginSelectionScope = raw;\n\t\t\t}\n\t\t} else if (arg === \"--plugin\") {\n\t\t\tresult.plugins = result.plugins ?? [];\n\t\t\ti = parseBoundedPluginId(args, i, result, \"--plugin\", result.plugins);\n\t\t} else if (arg.startsWith(\"--plugin=\")) {\n\t\t\tresult.plugins = result.plugins ?? [];\n\t\t\tconst value = arg.slice(\"--plugin=\".length).trim();\n\t\t\tif (value.length === 0) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--plugin requires a non-empty plugin id\" });\n\t\t\t} else if (value.length > MAX_PLUGIN_CLI_ID_CHARS) {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: `--plugin plugin id must be at most ${MAX_PLUGIN_CLI_ID_CHARS} characters`,\n\t\t\t\t});\n\t\t\t} else if (result.plugins.length >= MAX_PLUGIN_CLI_IDS) {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: `--plugin accepts at most ${MAX_PLUGIN_CLI_IDS} plugin ids`,\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tresult.plugins.push(value);\n\t\t\t}\n\t\t} else if (arg === \"--disable-plugin\") {\n\t\t\tresult.disabledPlugins = result.disabledPlugins ?? [];\n\t\t\ti = parseBoundedPluginId(args, i, result, \"--disable-plugin\", result.disabledPlugins);\n\t\t} else if (arg.startsWith(\"--disable-plugin=\")) {\n\t\t\tresult.disabledPlugins = result.disabledPlugins ?? [];\n\t\t\tconst value = arg.slice(\"--disable-plugin=\".length).trim();\n\t\t\tif (value.length === 0) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--disable-plugin requires a non-empty plugin id\" });\n\t\t\t} else if (value.length > MAX_PLUGIN_CLI_ID_CHARS) {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: `--disable-plugin plugin id must be at most ${MAX_PLUGIN_CLI_ID_CHARS} characters`,\n\t\t\t\t});\n\t\t\t} else if (result.disabledPlugins.length >= MAX_PLUGIN_CLI_IDS) {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: `--disable-plugin accepts at most ${MAX_PLUGIN_CLI_IDS} plugin ids`,\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tresult.disabledPlugins.push(value);\n\t\t\t}\n\t\t} else if (arg === \"--skill\" && i + 1 < args.length) {\n\t\t\tresult.skills = result.skills ?? [];\n\t\t\tresult.skills.push(args[++i]);\n\t\t} else if (arg === \"--prompt-template\" && i + 1 < args.length) {\n\t\t\tresult.promptTemplates = result.promptTemplates ?? [];\n\t\t\tresult.promptTemplates.push(args[++i]);\n\t\t} else if (arg === \"--theme\" && i + 1 < args.length) {\n\t\t\tresult.themes = result.themes ?? [];\n\t\t\tresult.themes.push(args[++i]);\n\t\t} else if (arg === \"--use-theme\") {\n\t\t\tconst themeName = args[i + 1];\n\t\t\tif (themeName === undefined || themeName.startsWith(\"-\")) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--use-theme requires a theme name\" });\n\t\t\t} else {\n\t\t\t\tresult.useTheme = themeName;\n\t\t\t\ti++;\n\t\t\t}\n\t\t} else if (arg === \"--no-skills\" || arg === \"-ns\") {\n\t\t\tresult.noSkills = true;\n\t\t} else if (arg === \"--no-prompt-templates\" || arg === \"-np\") {\n\t\t\tresult.noPromptTemplates = true;\n\t\t} else if (arg === \"--no-themes\") {\n\t\t\tresult.noThemes = true;\n\t\t} else if (arg === \"--no-context-files\" || arg === \"-nc\") {\n\t\t\tresult.noContextFiles = true;\n\t\t} else if (arg === \"--list-models\") {\n\t\t\t// Check if next arg is a search pattern (not a flag or file arg)\n\t\t\tif (i + 1 < args.length && !args[i + 1].startsWith(\"-\") && !args[i + 1].startsWith(\"@\")) {\n\t\t\t\tresult.listModels = args[++i];\n\t\t\t} else {\n\t\t\t\tresult.listModels = true;\n\t\t\t}\n\t\t} else if (arg === \"--tui-mode\") {\n\t\t\tconst mode = args[i + 1];\n\t\t\tif (mode === \"regular\" || mode === \"fullscreen\") {\n\t\t\t\tresult.tuiMode = mode;\n\t\t\t\ti++;\n\t\t\t} else if (mode === undefined || mode.startsWith(\"-\")) {\n\t\t\t\tresult.diagnostics.push({ type: \"error\", message: \"--tui-mode requires regular or fullscreen\" });\n\t\t\t} else {\n\t\t\t\ti++;\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"error\",\n\t\t\t\t\tmessage: `Invalid TUI mode \"${mode}\". Valid values: regular, fullscreen`,\n\t\t\t\t});\n\t\t\t}\n\t\t} else if (arg === \"--verbose\") {\n\t\t\tresult.verbose = true;\n\t\t} else if (arg === \"--offline\") {\n\t\t\tresult.offline = true;\n\t\t} else if (arg.startsWith(\"@\")) {\n\t\t\tresult.fileArgs.push(arg.slice(1)); // Remove @ prefix\n\t\t} else if (arg.startsWith(\"--\")) {\n\t\t\t// Unknown long options are errors: extension-registered CLI flags no\n\t\t\t// longer exist, so there is nothing left that could claim them.\n\t\t\tresult.diagnostics.push({ type: \"error\", message: `Unknown option: ${arg.split(\"=\")[0]}` });\n\t\t\ti++;\n\t\t} else if (arg.startsWith(\"-\") && !arg.startsWith(\"--\")) {\n\t\t\tresult.diagnostics.push({ type: \"error\", message: `Unknown option: ${arg}` });\n\t\t} else if (!arg.startsWith(\"-\")) {\n\t\t\tresult.messages.push(arg);\n\t\t}\n\t}\n\n\treturn result;\n}\n\nexport function printHelp(): void {\n\tconsole.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools\n\n${chalk.bold(\"Usage:\")}\n  ${APP_NAME} [options] [--] [@files...] [messages...]\n\n${chalk.bold(\"Commands:\")}\n  ${APP_NAME} install <source> [-l]     Install extension source and add to settings\n  ${APP_NAME} remove <source> [-l]      Remove extension source from settings\n  ${APP_NAME} uninstall <source> [-l]   Alias for remove\n  ${APP_NAME} update [source|self|agent-forge]   Update Agent Forge, extensions, or model catalogs\n  ${APP_NAME} list                      List installed extensions from settings\n  ${APP_NAME} config [-l]               Open TUI to enable/disable package resources (Tab switches scope)\n  ${APP_NAME} auth <command>            Print credentials or check provider readiness\n  ${APP_NAME} <command> --help          Show help for install/remove/uninstall/update/list/config/auth\n\n${chalk.bold(\"Options:\")}\n  --provider <name>              Provider name (default: google)\n  --model <pattern>              Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\n  --api-key <key>                API key (defaults to env vars)\n  --system-prompt <text>         System prompt (default: coding assistant prompt)\n  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)\n  --mode <mode>                  Output mode: text (default), json, or rpc\n  --print, -p                    Non-interactive mode: process prompt and exit\n  --continue, -c                 Continue previous session\n  --resume, -r                   Select a session to resume\n  --session <path|id>            Use specific session file or partial UUID\n  --session-id <id>              Use exact project session ID, creating it if missing\n  --fork <path|id>               Fork specific session file or partial UUID into a new session\n  --session-dir <dir>            Directory for session storage and lookup\n  --suite <id>                   Suite (方案) for this run: assistant (default) or coding; new sessions only\n  --suite-create <id>            Create a user suite workspace and exit; add --clone-from <id> to copy one\n  --suite-delete <id>            Delete a user suite workspace (active session references refuse) and exit\n  --suite-reset <id>             Reset a builtin suite to factory contents (shows a diff) and exit\n  --serve <port>                 (Experimental, local trust only) Serve the coding-agent session runtime over the WebSocket gateway (default: 127.0.0.1; HTTP surface: /healthz plus token-protected artifact reads) and exit on SIGINT/SIGTERM\n                                 Durable journal: <agentDir>/remote-server-journal.jsonl (never the process cwd)\n  --serve-workspace-root <dir>   Opt-in --serve boundary: remote creates must run inside one of these roots (repeatable); without it any local directory is allowed\n  --subagent-runner              (Experimental) Run as a headless subagent runner: serve the subagent-task protocol on stdio for a parent session's runner pool (D-045)\n  --no-session                   Don't save session (ephemeral)\n  --name, -n <name>              Set session display name\n  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling\n                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching\n  --no-tools, -nt                Disable all tools by default (built-in and plugin)\n  --no-builtin-tools, -nbt       Disable built-in tools by default but keep plugin/custom tools enabled\n  --tools, -t <tools>            Comma-separated allowlist of tool names to enable\n                                 Applies to built-in, plugin, and custom tools\n  --exclude-tools, -xt <tools>   Comma-separated denylist of tool names to disable\n                                 Applies to built-in, plugin, and custom tools\n  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh, max\n  --no-plugins, -np               Disable capability plugin discovery (D-028 escape hatch)\n  --no-trace                      Disable session trace collection (no .trace.jsonl file is written)\n  --log-level <level>             Host log level: debug, info (default), warn, error\n  --plugin-profile <id>            Select a builtin capability plugin profile for this run\n  --plugin <id>                    Select a plugin within the profile (repeatable)\n  --disable-plugin <id>            Disable a plugin within the profile (repeatable)\n  --plugin-scope <scope>           Read the explicit selection from global or project storage\n  plugin catalog list             List installed/available ecosystem plugins (independent namespace)\n  --skill <path>                 Load a skill file or directory (can be used multiple times)\n  --no-skills, -ns               Disable skills discovery and loading\n  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)\n  --no-prompt-templates, -np     Disable prompt template discovery and loading\n  --theme <path>                 Load a theme file or directory (can be used multiple times)\n  --use-theme <name[/name]>      Set the initial interactive theme for this run\n  --no-themes                    Disable theme discovery and loading\n  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading\n  --export <file>                Export session file to HTML and exit\n  --trace <session>              View a session trace file as a text timeline and exit; <session> is a session id/prefix or trace/session file path, omit it for the most recent session\n  --trace-json                   With --trace, output the structured trace records as JSON instead of the text timeline\n  --trace-kind <k1,k2>           With --trace, show only records of these kinds (comma-separated); valid kinds: ${TRACE_KINDS_V1.join(\", \")}\n  --trace-limit <n>              With --trace, show only the last N records (positive integer)\n  --list-models [search]         List available models (with optional fuzzy search)\n  --verbose                      Force verbose startup (overrides quietStartup setting)\n  --tui-mode <mode>              TUI mode: regular (default) or fullscreen\n  --offline                      Disable startup network operations (same as AGENT_FORGE_OFFLINE=1)\n  --                             End option parsing; treat remaining arguments as messages/files\n  --help, -h                     Show this help\n  --version, -v                  Show version number\n\n${chalk.bold(\"Examples:\")}\n  # Print a provider API key for an external client\n  ${APP_NAME} auth print-api-key --provider openai\n\n  # Print an OAuth bearer token for an external client (refreshes if expired)\n  ${APP_NAME} auth print-bearer-token --provider openai-codex\n\n  # Interactive mode\n  ${APP_NAME}\n\n  # Interactive mode with initial prompt\n  ${APP_NAME} \"List all .ts files in src/\"\n\n  # Include files in initial message\n  ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\n\n  # Non-interactive mode (process and exit)\n  ${APP_NAME} -p \"List all .ts files in src/\"\n\n  # Prompt beginning with a dash\n  ${APP_NAME} -p -- \"- Summarize these points\"\n\n  # Multiple messages (interactive)\n  ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\n\n  # Continue previous session\n  ${APP_NAME} --continue \"What did we discuss?\"\n\n  # Start a named session\n  ${APP_NAME} --name \"Refactor auth module\"\n\n  # Use different model\n  ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n  # Use model with provider prefix (no --provider needed)\n  ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\n\n  # Use model with thinking level shorthand\n  ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\n\n  # Limit model cycling to specific models\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\n\n  # Limit to a specific provider with glob pattern\n  ${APP_NAME} --models \"github-copilot/*\"\n\n  # Cycle models with fixed thinking levels\n  ${APP_NAME} --models sonnet:high,haiku:low\n\n  # Start with a specific thinking level\n  ${APP_NAME} --thinking high \"Solve this complex problem\"\n\n  # Read-only mode (no file modifications possible)\n  ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\n\n  # Disable one tool while keeping the rest available\n  ${APP_NAME} --exclude-tools ask_question\n\n  # Export a session file to HTML\n  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\n  ${APP_NAME} --export session.jsonl output.html\n\n${chalk.bold(\"Environment Variables:\")}\n  ANTHROPIC_AUTH_TOKEN             - Anthropic bearer auth token\n  ANTHROPIC_API_KEY                - Anthropic Claude API key\n  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)\n  ANT_LING_API_KEY                 - Ant Ling API key\n  OPENAI_API_KEY                   - OpenAI GPT API key\n  AZURE_OPENAI_API_KEY             - Azure OpenAI API key\n  AZURE_OPENAI_BASE_URL            - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)\n  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)\n  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)\n  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)\n  DEEPSEEK_API_KEY                 - DeepSeek API key\n  NVIDIA_API_KEY                   - NVIDIA NIM API key\n  GEMINI_API_KEY                   - Google Gemini API key\n  GROQ_API_KEY                     - Groq API key\n  CEREBRAS_API_KEY                 - Cerebras API key\n  XAI_API_KEY                      - xAI Grok API key\n  FIREWORKS_API_KEY                - Fireworks API key\n  TOGETHER_API_KEY                 - Together AI API key\n  BASETEN_API_KEY                  - Baseten API key\n  OPENROUTER_API_KEY               - OpenRouter API key\n  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key\n  ZAI_API_KEY                      - ZAI Coding Plan API key (Global)\n  ZAI_CODING_CN_API_KEY            - ZAI Coding Plan API key (China)\n  MISTRAL_API_KEY                  - Mistral API key\n  MINIMAX_API_KEY                  - MiniMax API key\n  MOONSHOT_API_KEY                 - Moonshot AI API key\n  OPENCODE_API_KEY                 - OpenCode Zen/OpenCode Go API key\n  KIMI_API_KEY                     - Kimi For Coding API key\n  CLOUDFLARE_API_KEY               - Cloudflare API token (Workers AI and AI Gateway)\n  CLOUDFLARE_ACCOUNT_ID            - Cloudflare account id (required for both)\n  CLOUDFLARE_GATEWAY_ID            - Cloudflare AI Gateway slug (required for AI Gateway)\n  QWEN_TOKEN_PLAN_API_KEY          - Qwen Token Plan API key (international region)\n  QWEN_TOKEN_PLAN_CN_API_KEY       - Qwen Token Plan API key (China region)\n  XIAOMI_API_KEY                   - Xiaomi MiMo API key (api.xiaomimimo.com billing)\n  XIAOMI_TOKEN_PLAN_CN_API_KEY     - Xiaomi MiMo Token Plan API key (China region)\n  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - Xiaomi MiMo Token Plan API key (Amsterdam region)\n  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - Xiaomi MiMo Token Plan API key (Singapore region)\n  AWS_PROFILE                      - AWS profile for Amazon Bedrock\n  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock\n  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock\n  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)\n  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)\n  ${ENV_AGENT_DIR.padEnd(32)} - Config directory (default: ~/${CONFIG_DIR_NAME}/agent)\n  ${ENV_SESSION_DIR.padEnd(32)} - Session storage directory (overridden by --session-dir)\n  AGENT_FORGE_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)\n  AGENT_FORGE_OFFLINE                       - Disable startup network operations when set to 1/true/yes\n\n${chalk.bold(\"Built-in Tool Names:\")}\n  read       - Read file contents\n  bash       - Execute bash commands\n  powershell - Execute PowerShell commands on Windows\n  edit       - Edit files with find/replace\n  write      - Write files (creates/overwrites)\n  grep       - Search file contents (read-only, off by default)\n  find       - Find files by glob pattern (read-only, off by default)\n  ls         - List directory contents (read-only, off by default)\n`);\n}\n"]}